GetBucketDataAccelerator でアクセラレータ情報をクエリ - OSS

GetBucketDataAccelerator 操作を呼び出して 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	アクション	説明
GetBucketDataAccelerator	`oss:GetBucketDataAccelerator`	バケットアクセラレータ情報を表示します。

リクエスト構文

GET /?dataAccelerator=&x-oss-datalake-cache-available-zone=cn-wulanchabu-b&verbose= 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

リクエストヘッダー

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

リクエストパラメーター

名前	タイプ	必須	例	説明
dataAccelerator	文字列	はい	なし	OSS アクセラレータ API 操作の識別子パラメーター。このパラメーターには任意の値を設定できます。
x-oss-datalake-cache-available-zone	文字列	いいえ	`cn-wulanchabu-b`	このパラメーターが存在する場合、特定のゾーンのアクセラレータ情報を表示するように指定します。それ以外の場合は、バケットのすべてのアクセラレータ情報が返されます。
verbose	文字列	いいえ	なし	このパラメーターが存在する場合、すべてのアクセラレーションパス情報を表示するように指定します。それ以外の場合は、アクセラレーションパス情報なしで基本的なアクセラレータ情報のみが返されます。このパラメーターには任意の値を設定できます。

応答ヘッダー

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

応答要素

名前	タイプ	例	説明
DataAccelerator	コンテナー	なし	バケットに構成されたアクセラレータ情報を格納するコンテナー。子ノード: `Name` `Bucket` `BasicInfomation` 親ノード: なし
Name	文字列	`mybucket_data-acc`	アクセラレータの名前。子ノード: なし親ノード: `DataAccelerator`
BucketName	文字列	`mybucket`	バケットの名前。子ノード: なし親ノード: `DataAccelerator`
BasicInfomation	コンテナー	なし	特定のアクセラレータに関する情報を格納するコンテナー。子ノード: `AvailableZone` `Quota` `AcceleratePaths` `CreationDate` `QuotaFrozenUntil` 親ノード: `DataAccelerator`
Quota	正の整数	100	アクセラレータの容量。子ノード: なし親ノード: `BasicInfomation`
AvailableZone	文字列	`cn-wulanchabu-b`	アクセラレータのゾーン。子ノード: なし親ノード: `BasicInfomation`
CreationDate	正の整数	`123456789123`	アクセラレータが作成されたときのタイムスタンプ。子ノード: なし親ノード: `BasicInfomation`
QuotaFrozenUntil	正の整数	`123456789123`	アクセラレータのクォータが凍結解除されるタイムスタンプ。このタイムスタンプより前にクォータを変更することはできません。子ノード: なし親ノード: `BasicInfomation`
AcceleratePaths	コンテナー	なし	アクセラレーションポリシー構成を格納するコンテナー。子ノード: `DefaultCachePolicy` `Path` 親ノード: `BasicInfomation`
Path	コンテナー	なし	アクセラレーションパス構成を格納するコンテナー。子ノード: `CachePolicy` `Name` 親ノード: `AcceleratePaths`
Name	文字列	`test/dir/`	指定されたアクセラレーションパスのプレフィックス。子ノード: なし親ノード: `Path`
CachePolicy	文字列	`sync-warmup`, `write-back`	パスのアクセラレーションポリシー。値は次のいずれかのパラメーターである必要があります。そうでない場合、アクセラレーションポリシーは有効になりません。 `sync-warmup` (書き込み中の同期ウォームアップ) `write-back` (読み取り中のウォームアップ) 子ノード: なし親ノード: `Path`
DefaultCachePolicy	文字列	`sync-warmup`, `write-back`	バケット全体のアクセラレーションポリシー。値は次のいずれかのパラメーターである必要があります。 `sync-warmup` (書き込み中の同期ウォームアップ) `write-back` (読み取り中のウォームアップ) 子ノード: なし親ノード: `AcceleratePaths`

例

中国 (ウランチャブ) リージョン内のターゲットバケットの OSS アクセラレータ構成情報をクエリします。

リクエストの例

GET /?dataAccelerator=&x-oss-datalake-cache-available-zone=cn-wulanchabu-b&verbose= HTTP/1.1
Date: Sun, 05 Sep 2021 23:00:00 GMT
Content-Length: 556
Authorization: OSS4-HMAC-SHA256 Credential=****
Host: http://BUCKETNAME.cn-wulanchabu-b-internal.oss-data-acc.aliyuncs.com

レスポンスの例

HTTP/1.1 200 OK
Server: AliyunOSS
Date: Fri, 27 Jun 2025 02:57:27 GMT
Content-Type: application/xml
Content-Length: 459
Connection: keep-alive
x-oss-request-id: 685E08978AB8A63836D81586

<?xml version="1.0" encoding="UTF-8"?>
<DataAccelerator>
  <Name>mybucket_data-acc</Name>
  <BucketName>mybucket</BucketName>
  <BasicInfomation>
    <Quota>200</Quota>
    <AvailableZone>cn-wulanchabu-b</AvailableZone>
    <AcceleratePaths>
      <Path>
        <Name>AccelerationPath</Name>
        <CachePolicy>sync-warmup</CachePolicy>
      </Path>
      <DefaultCachePolicy>write-back</DefaultCachePolicy>
    </AcceleratePaths>
    <CreationDate>1751013420658</CreationDate>
    <QuotaFrozenUntil>1751017020624</QuotaFrozenUntil>
  </BasicInfomation>
</DataAccelerator>

エラーコード

エラーコード	HTTP ステータスコード	説明
DataAcceleratorNotFound	404	現在のバケットではアクセラレータが有効になっていません。
NoSuchConfiguration	404	現在のバケットでは、対応するゾーンでアクセラレータが有効になっていません。