Setting the Direct Reading Policy for Archive Objects in a Bucket
Functions
The direct reading function means that you can directly perform operations on Archive objects without restoring them.
By default, the direct reading is disabled on a bucket.
You can use this API to enable or disable the direct reading for a bucket.
- When direct reading is enabled on a bucket:
- You can directly perform operations on the Archive objects in the bucket regardless of whether they have been restored.
- If the Archive objects are not restored, your operations on them will be charged separately.
- When direct reading is disabled on a bucket:
- You need to restore the Archive objects in the bucket before you can operate them.
To perform this operation, you must have the PutDirectColdAccessConfiguration permission. By default, only the bucket owner can perform this operation. The bucket owner can grant the permission to other users by configuring the bucket policy or user policy.
Request Syntax
1 2 3 4 5 6 7 8 9 10 |
PUT /?directcoldaccess HTTP/1.1 Host: examplebucket.obs.region.myhuaweicloud.eu Date: date Authorization: authorization Content-SHA256: SHA256 Content-Length: length <DirectColdAccessConfiguration> <Status>status</Status> </DirectColdAccessConfiguration> |
Request Parameters
This request contains no message parameters.
Request Headers
Table 1 lists the request header.
Request Elements
This request contains elements to configure the direct reading status in XML format for Archive objects. Table 2 lists the request elements.
Element |
Description |
Mandatory |
---|---|---|
DirectColdAccessConfiguration |
Root node for the configuration of the direct reading for Archive objects. Parent: none |
Yes |
Status |
Direct reading status of Archive objects in a bucket. Type: string Parent: DirectColdAccessConfiguration Value options: Enabled, Disabled |
Yes |
Response Syntax
1 2 3 4 |
HTTP/1.1 status_code Date: date Content-Length: length |
Response Headers
The response to the request uses common headers. For details, see Table 1.
Response Elements
This response contains no elements.
Error Responses
No special error responses are returned. For details about error responses, see Table 2.
Sample Request
1 2 3 4 5 6 7 8 9 10 11 |
PUT /?directcoldaccess HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.region.myhuaweicloud.eu Date: Fri, 26 Apr 2019 07:37:36 GMT Authorization: OBS H4IPJX0TQTHTHEBQQCEC:sc2PM13Wlfcoc/YZLK0MwsI2Zpo= Content-SHA256: ogX9qClMrVJUBiUSIKDFM0qO41jJM0I5SCN55/OtMyI= Content-Length: 92 <DirectColdAccessConfiguration> <Status>Enabled</Status> </DirectColdAccessConfiguration> |
Sample Response
1 2 3 4 5 6 |
HTTP/1.1 200 OK Server: OBS x-obs-request-id: 0000016A58940244809DEF00122E6802 x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCStOlo1yxthHHo2GlS3WGgt1ekAIh3Vy Date: Fri, 26 Apr 2019 07:37:36 GMT Content-Length: 0 |
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.