tencent cloud

PrevNext

Feedback

search by keyword

Recent Pages

Documentation
Cloud Object Storage
    Documentation
    Download PDF

    POST Object restore

    Last updated: 2024-11-08 10:55:51
    Download PDF

      Feature Description

      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.
      

      Versioning

      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.

      Request

      Sample request

      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 as examplebucket-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).

      Request parameters

      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

      Request headers

      This API only uses common request headers. For more information, see Common Request Headers.

      Request body

      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:
      Expedited: Restores an object within 1–5 minutes.
      Standard: Restores an object within 3–5 hours.
      Bulk: Restores an object within 5–12 hours.
      The following two restoration modes are available for DEEP ARCHIVE objects:
      Standard: Restores an object within 12–24 hours.
      Bulk: Restores an object within 24–48 hours.
      Enum
      Yes

      Response

      Response headers

      This API only returns common response headers. For more information, see Common Response Headers.

      Response body

      The response body of this API is empty.

      Error codes

      This API returns common error responses and error codes. For more information, see Error Codes.

      Samples

      Sample 1: Simple use case (with versioning disabled)

      Request

      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>

      Response

      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****

      Sample 2: Restoring an object on a specific version (with versioning enabled)

      Request

      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>

      Response

      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****
      
      Contact Us

      Contact our sales team or business advisors to help your business.

      Contact Us
      Technical Support

      Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

      Submit a Ticket
      7x24 Phone Support
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      Privacy PolicyLegalCookie Policy