すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:PutBucketArchiveDirectRead

最終更新日:Jun 03, 2025

バケットのアーカイブオブジェクトのリアルタイムアクセスを有効または無効にします。

使用上の注意

  • バケットのアーカイブオブジェクトのリアルタイムアクセスを有効にするには、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

バケットのアーカイブオブジェクトのリアルタイムアクセスを有効にするかどうかを指定します。有効な値:

  • true

  • false

レスポンスヘッダー

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」をご参照ください。