Help Center/ Object Storage Service/ API Reference/ Bucket APIs/ Direct Reading/ Deleting the Direct Reading Policy of Archive Objects in a Bucket
Updated on 2026-04-16 GMT+08:00
View PDF
Share

Deleting the Direct Reading Policy of Archive Objects in a Bucket

Functions

If direct reading of Archive objects is configured for a bucket, you can delete the direct reading configurations of Archive objects. After the deletion, Archive objects in the bucket cannot be read directly. For more information about direct reading of Archive data, see Direct Reading.

Authorization Information

To call this API, you must be the bucket owner or have the permission to delete the direct reading policy of Archive objects in a bucket. You are advised to use IAM or bucket policies for authorization. For details about OBS authorization methods, see Differences Between OBS Permissions Control Methods.

  • If you use IAM for authorization, you need to use either role/policy-based authorization or identity policy-based authorization and configure the required permissions:
    • If you use role/policy-based authorization (IAM v3 APIs in the old IAM version), you need to grant the obs:bucket:DeleteDirectColdAccessConfiguration permission. For details, see Creating a Custom IAM Policy.
    • If you use identity policy-based authorization (IAM v5 APIs in the new IAM version), you need to grant the obs:bucket:deleteDirectColdAccessConfiguration permission, as shown in the following table. For details, see Creating a Custom IAM Identity Policy.

      Action

      Access Level

      Resource Type (*: Required)

      Condition Key

      Alias

      Dependencies

      obs:bucket:deleteDirectColdAccessConfiguration

      Write

      bucket *

      -

      -

      -
      • obs:EpochTime
      • obs:SourceIp
      • obs:TlsVersion
      • obs:CustomDomain
  • If you use bucket policies for authorization, you need to grant the obs:bucket:DeleteDirectColdAccessConfiguration permission. For details, see Creating a Custom Bucket Policy.

Request Syntax

The following is an example request. Replace BucketName with your bucket name and RegionID with the ID of the region where your bucket resides. You can obtain the region ID by referring to Supported Regions.

DELETE /?directcoldaccess HTTP/1.1 
Host: BucketName.obs.RegionID.myhuaweicloud.com 
Date: GMT Date
Authorization: SignatureValue

Description of the OBS request structure

  • An OBS request consists of the request method, request URI, request headers, and request body. The following figure shows an example of a request for creating a bucket. The bucket name is configured in the Host header, and the signature information is configured in the Authorization header. For details about how to calculate the signature, see Using an Authorization Header. For more information, see Constructing a Request.

URI Parameters

Table 1 URI parameters

Parameter

Mandatory

Type

Description

/?directcoldaccess

Yes

String

Definition

An identifier that marks this API as related to the direct reading of Archive data.

Constraints

When calculating the signature, add /BucketName/?directcoldaccess to CanonicalizedResource. For details, see Using an Authorization Header.

Range

/?directcoldaccess

Default Value

N/A

Request Headers

This request uses common headers. For details, see Table 3.

Request Body

This request contains no request body parameters.

Response Syntax

HTTP/1.1 status_code
Date: GMT Date
Content-Type: text/xml

Description of the OBS response structure

  • An OBS response consists of a response status code, response headers, and the response body. The following figure shows an example of a response for obtaining the bucket's ACL configuration.

Response Headers

This response uses common headers. For details, see Table 1.

Response Body

The response of this API does not contain a response body.

Error Responses

No special error responses are returned. For details about error responses, see Table 2.

Sample Request

1
2
3
4
5
6
 
DELETE /?directcoldaccess HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: Tue, 30 Apr 2019 03:04:48 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:5DGAS7SBbMC1YTC4tNXY57Zl2Fo=

References

  • For more information about direct reading of Archive data, see Direct Reading.
  • For details about the billing items involved in API operations, see Billing Items.
Parent Topic: Direct Reading