The POST Object restore
API allows you to send a request to restore an ARCHIVE/DEEP ARCHIVE object so that you can read it. The restored readable object is a temporary copy, for which you can set the readable status and the time to delete it through the Days
parameter. If the time has elapsed and you haven't initiated a copy or extension operation, the temporary object will be automatically deleted. Temporary objects are only copies of the archived objects which always exist. For more information on the ARCHIVE storage class, see Overview.
Note:The QPS of the
POST Object restore
API is limited to 100.
If versioning is enabled, you can use the versionId
parameter in your request to specify the ID of the version to be restored. If this parameter is not specified, the latest version will be restored.
POST /<ObjectKey>?restore HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Content-Type: application/xml
Content-Length: Content Length
Content-MD5: MD5
Authorization: Auth String
[Request Body]
Note:
- Host: <BucketName-APPID>.cos.<Region>.myqcloud.com, where <BucketName-APPID> is the bucket name followed by the
APPID
, such asexamplebucket-1250000000
(see Bucket Overview > Basic Information and Bucket Overview > Bucket Naming Conventions), and <Region> is a COS region (see Regions and Access Endpoints).- Authorization: Auth String (for more information, see Request Signature).
Field | Description | Type | Required |
---|---|---|---|
versionId | Specifies the version ID of the versioning-enabled object to restore. If this parameter is not specified, the latest version will be restored. | string | No |
This API only uses common request headers. For more information, see Common Request Headers.
Submit application/xml request data, including specific parameters of the restoration operation.
<RestoreRequest>
<Days>number</Days>
<CASJobParameters>
<Tier>Enum</Tier>
</CASJobParameters>
</RestoreRequest>
The nodes are as described below:
Node Name (Keyword) | Parent Node | Description | Type | Required |
---|---|---|---|---|
RestoreRequest | None | Contains all the request information of POST Object restore . |
Container | Yes |
RestoreRequest
has the following sub-nodes:
Node Name (Keyword) | Parent Node | Description | Type | Required |
---|---|---|---|---|
Days | RestoreRequest | Specifies the validity period (in days) of the restored temporary copy. | number | Yes |
CASJobParameters | RestoreRequest | Restoration job parameter. | Container | Yes |
CASJobParameters
has the following sub-nodes:
Node Name (Keyword) | Parent Node | Description | Type | Required |
---|---|---|---|---|
Tier | RestoreRequest.CASJobParameters | Specifies the restoration mode. The following three restoration modes are available for ARCHIVE objects: The following two restoration modes are available for DEEP ARCHIVE objects: |
Enum | Yes |
This API only returns common response headers. For more information, see Common Response Headers.
The response body of this API is empty.
This API returns common error responses and error codes. For more information, see Error Codes.
POST /exampleobject?restore HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Fri, 27 Dec 2019 08:19:29 GMT
Content-Type: application/xml
Content-Length: 121
Content-MD5: Nr7RAnRMgrplFvD8bt5+0w==
Authorization: q-sign-algorithm=sha1&q-ak=AKID8A0fBVtYFrNm02oY1g1JQQF0c3JO****&q-sign-time=1577434769;1577441969&q-key-time=1577434769;1577441969&q-header-list=content-length;content-md5;content-type;date;host&q-url-param-list=restore&q-signature=ed3ee8ca63689dbff4be1533fddc17c0b4d8****
Connection: close
<RestoreRequest>
<Days>1</Days>
<CASJobParameters>
<Tier>Expedited</Tier>
</CASJobParameters>
</RestoreRequest>
HTTP/1.1 202 Accepted
Content-Length: 0
Connection: close
Date: Fri, 27 Dec 2019 08:19:29 GMT
Server: tencent-cos
x-cos-request-id: NWUwNWJlOTFfMjljOTBiMDlfMTQ2MmNfNzAw****
POST /exampleobject?restore&versionId=MTg0NDUxNjQ1NjM4OTkzNzY3NDk HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Mon, 20 Jan 2020 08:43:40 GMT
Content-Type: application/xml
Content-Length: 121
Content-MD5: Nr7RAnRMgrplFvD8bt5+0w==
Authorization: q-sign-algorithm=sha1&q-ak=AKID8A0fBVtYFrNm02oY1g1JQQF0c3JO****&q-sign-time=1579509820;1579517020&q-key-time=1579509820;1579517020&q-header-list=content-length;content-md5;content-type;date;host&q-url-param-list=restore;versionid&q-signature=f92b1c6753c452bed9ade49739ddb81a0a47****
Connection: close
<RestoreRequest>
<Days>1</Days>
<CASJobParameters>
<Tier>Expedited</Tier>
</CASJobParameters>
</RestoreRequest>
HTTP/1.1 202 Accepted
Content-Length: 0
Connection: close
Date: Mon, 20 Jan 2020 08:43:41 GMT
Server: tencent-cos
x-cos-request-id: NWUyNTY4M2NfZTNjODJhMDlfMWZkM2VfNWZm****
Apakah halaman ini membantu?