バケットのアーカイブオブジェクトのリアルタイムアクセスを有効または無効にします。
使用上の注意
バケットのアーカイブオブジェクトのリアルタイムアクセスを有効にするには、
oss:PutBucketArchiveDirectRead権限が必要です。詳細については、「RAM ユーザーにカスタムポリシーをアタッチする」をご参照ください。各リージョンには、独自の Object Storage Service (OSS) エンドポイントがあります。リージョンとエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。
バケットのアーカイブオブジェクトのリアルタイムアクセスを有効にした後、バケット内で解凍されていないアーカイブオブジェクトにアクセスすると、アクセスしたアーカイブデータのサイズ (RetrievalDataArchiveDirect) に基づいてアーカイブデータ取得料金が課金されます。バケット内で解凍されたアーカイブオブジェクトにアクセスする場合、アーカイブデータ取得料金は発生しません。詳細については、「データ処理料金」をご参照ください。
リクエスト構文
PUT /?bucketArchiveDirectRead HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Authorization: SignatureValue
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
<?xml version="1.0" encoding="UTF-8"?>
<ArchiveDirectReadConfiguration>
<Enabled>true</Enabled>
</ArchiveDirectReadConfiguration>リクエストヘッダー
PutBucketArchiveDirectRead リクエストのすべてのヘッダーは、共通のリクエストヘッダーです。詳細については、「共通の HTTP ヘッダー」をご参照ください。
リクエスト要素
要素 | タイプ | 必須 | 例 | 説明 |
ArchiveDirectReadConfiguration | コンテナー | はい | 該当なし | アーカイブオブジェクトのリアルタイムアクセスの構成を格納するコンテナー。 |
Enabled | ブール値 | はい | true | バケットのアーカイブオブジェクトのリアルタイムアクセスを有効にするかどうかを指定します。有効な値:
|
レスポンスヘッダー
PutBucketArchiveDirectRead リクエストへのレスポンスのすべてのヘッダーは、共通のレスポンスヘッダーです。共通のレスポンスヘッダーの詳細については、「共通の HTTP ヘッダー」をご参照ください。
例
リクエストの例
PUT /?bucketArchiveDirectRead HTTP/1.1 Date: Mon, 24 Apr 2023 15:56:37 GMT Content-Length: 60 Content-Type: application/xml Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e Host: oss-example.oss-cn-hangzhou.aliyuncs.com <?xml version="1.0" encoding="UTF-8"?> <ArchiveDirectReadConfiguration> <Enabled>true</Enabled> </ArchiveDirectReadConfiguration>レスポンスの例
HTTP/1.1 200 OK x-oss-request-id: 534B371674E88A4D8906**** Date: Mon, 24 Apr 2023 15:56:37 GMT Content-Length: 60 Connection: keep-alive Server: AliyunOSS
ossutil
PutBucketArchiveDirectRead 操作に対応する ossutil コマンドについては、「put-bucket-archive-direct-read」をご参照ください。