PutBucketDataAccelerator - Object Storage Service - Alibaba Cloud ドキュメントセンター

PutBucketDataAccelerator 操作を呼び出して、OSS アクセラレータを作成するか、その構成を変更できます。

使用上の注意

OSS アクセラレータ API は、OSS と同じリージョン内の内部ネットワーク環境でのみ呼び出すことができます。対応するアクセラレータドメイン名を使用する必要があります。たとえば、OSS と同じリージョンであるウランチャブリージョンの ECS インスタンスを使用して、API を使用して OSS アクセラレータを操作できます。次の表に、各リージョンでサポートされているゾーンと対応する OSS アクセラレータドメイン名を示します。

リージョン	ゾーン	OSS アクセラレータドメイン名
北京	`cn-beijing-h`	`cn-beijing-h-internal.oss-data-acc.aliyuncs.com`
上海	`cn-shanghai-g`	`cn-shanghai-g-internal.oss-data-acc.aliyuncs.com`
深セン	`cn-shenzhen-c`	`cn-shenzhen-c-internal.oss-data-acc.aliyuncs.com`
杭州	`cn-hangzhou-j`	`cn-hangzhou-j-internal.oss-data-acc.aliyuncs.com`
ウランチャブ	`cn-wulanchabu-b`	`cn-wulanchabu-b-internal.oss-data-acc.aliyuncs.com`
シンガポール	`ap-southeast-1c`	`ap-southeast-1c-internal.oss-data-acc.aliyuncs.com`

権限

デフォルトでは、Alibaba Cloud アカウントは完全な権限を持っています。Alibaba Cloud アカウント下の RAM ユーザーまたは RAM ロールは、デフォルトでは何の権限も持っていません。Alibaba Cloud アカウントまたはアカウント管理者は、RAM ポリシーまたはバケットポリシーを通じて操作権限を付与する必要があります。

API	アクション	説明
PutBucketDataAccelerator	`oss:PutBucketDataAccelerator`	バケットアクセラレータを作成するか、その構成を変更します。

リクエスト構文

PUT /?dataAccelerator HTTP/1.1
Date: GMT Date
Content-Length：ContentLength
Content-Type: application/xml
Authorization: SignatureValue 
Host: BUCKETNAME.cn-wulanchabu-b-internal.oss-data-acc.aliyuncs.com

<DataAcceleratorConfiguration>
  <AvailableZone>cn-wulanchabu-b</AvailableZone>
  <Quota>200</Quota>
  <AcceleratePaths>
    <DefaultCachePolicy>write-back</DefaultCachePolicy>
    <Path>
      <Name>AccelerationPath</Name>
      <CachePolicy>sync-warmup</CachePolicy>
    </Path>
  </AcceleratePaths>
</DataAcceleratorConfiguration>

リクエストヘッダー

この操作では、共通のリクエストヘッダーを使用します。詳細については、「共通リクエストヘッダー」をご参照ください。

リクエストパラメーター

名前	タイプ	必須	例	説明
dataAccelerator	文字列	はい	なし	OSS アクセラレータ API 操作の識別子パラメーター。このパラメーターには任意の値を設定できます。

リクエスト本文

名前	タイプ	必須	例	説明
DataAcceleratorConfiguration	コンテナー	はい	N/A	アクセラレータ構成のコンテナー子ノード: `AvailableZone` `Quota` `AcceleratePaths` 親ノード: なし
AvailableZone	文字列	はい	`cn-wulanchabu-b`	アクセラレータのゾーン。現在サポートされているゾーン: `cn-beijing-h` (北京) `cn-shanghai-g` (上海) `cn-shenzhen-c` (深セン) `cn-hangzhou-j` (杭州) `cn-wulanchabu-b` (ウランチャブ) `ap-southeast-1c` (シンガポール)
Quota	正の整数	はい	100	アクセラレータの容量 (GB)。アクセラレータの容量は、作成または変更後 1 時間以内は再度変更できません。
AcceleratePaths	コンテナー	はい	N/A	アクセラレーションポリシー構成のコンテナー子ノード: `DefaultCachePolicy` `Path` 親ノード: `DataAcceleratorConfiguration`
Path	コンテナー	いいえ	N/A	アクセラレーションパス構成のコンテナー子ノード: `Name` `CachePolicy` 親ノード: `AcceleratePaths`
Name	文字列	はい	`test/dir/`	指定されたアクセラレーションパスのプレフィックス子ノード: なし親ノード: `Path`
CachePolicy	文字列	はい	`sync-warmup`, `write-back`	パスのアクセラレーションポリシー。利用可能なアクセラレーションポリシー: `sync-warmup` (書き込み時の同期ウォームアップ) `write-back` (読み取り時のウォームアップ) 子ノード: なし親ノード: `Path`
DefaultCachePolicy	文字列	はい	`sync-warmup`, `write-back`	バケット全体のデフォルトのアクセラレーションポリシー。このポリシーは、Path が構成されていない場合にのみ有効になります。利用可能なアクセラレーションポリシー: `sync-warmup` (書き込み時の同期ウォームアップ) `write-back` (読み取り時のウォームアップ) 子ノード: なし親ノード: `AcceleratePaths`

レスポンスヘッダー

この操作では、共通のレスポンスヘッダーを使用します。詳細については、「共通レスポンスヘッダー」をご参照ください。

例

OSS アクセラレータの作成

リクエストの例

PUT /?dataAccelerator= HTTP/1.1
Date: Sun, 05 Sep 2021 23:00:00 GMT
Content-Length: 556
Content-Type: application/xml
Authorization: OSS4-HMAC-SHA256 Credential=****
Host: http://BUCKETNAME.cn-wulanchabu-b-internal.oss-data-acc.aliyuncs.com

<DataAcceleratorConfiguration>
  <AvailableZone>cn-wulanchabu-b</AvailableZone>
  <Quota>200</Quota>
  <AcceleratePaths>
    <DefaultCachePolicy>write-back</DefaultCachePolicy>
    <Path>
      <Name>AccelerationPath</Name>
      <CachePolicy>sync-warmup</CachePolicy>
    </Path>
  </AcceleratePaths>
</DataAcceleratorConfiguration>

レスポンスの例

HTTP/1.1 200 OK
Server: AliyunOSS
Date: Fri, 27 Jun 2025 02:19:45 GMT
Content-Length: 0
Connection: keep-alive
x-oss-request-id: 685DFFC18AB8A63132C65285

エラーコード

エラーコード	HTTP ステータスコード	説明
TooManyAccelerationPolicyPaths	400	設定されているアクセラレーションパスが多すぎます。
InvalidCachePathPolicy	400	アクセラレーションポリシーが無効です。
InvalidQuota	400	アクセラレータの容量が無効です。
DataAcceleratorQuotaFrozen	403	アクセラレータの容量はロックされており、変更できません。
DataAcceleratorAvailableZoneNotSupported	400	このゾーンではアクセラレータを作成できません。