GetBucketDataAccelerator - Object Storage Service

Gunakan operasi GetBucketDataAccelerator untuk memeriksa informasi akselerator OSS.

Catatan penggunaan

API akselerator OSS hanya dapat diakses melalui jaringan internal dalam wilayah yang sama dengan OSS. Anda harus menggunakan nama domain akselerator yang sesuai. Sebagai contoh, Anda dapat menggunakan instance ECS di wilayah Ulanqab, yang berada dalam wilayah yang sama dengan OSS, untuk mengelola akselerator OSS melalui API. Tabel berikut mencantumkan zona yang didukung beserta nama domain akselerator OSS yang sesuai untuk setiap wilayah.

Wilayah	Zona	Nama domain akselerator OSS
Beijing	`cn-beijing-h`	`cn-beijing-h-internal.oss-data-acc.aliyuncs.com`
Shanghai	`cn-shanghai-g`	`cn-shanghai-g-internal.oss-data-acc.aliyuncs.com`
Shenzhen	`cn-shenzhen-c`	`cn-shenzhen-c-internal.oss-data-acc.aliyuncs.com`
Hangzhou	`cn-hangzhou-j`	`cn-hangzhou-j-internal.oss-data-acc.aliyuncs.com`
Ulanqab	`cn-wulanchabu-b`	`cn-wulanchabu-b-internal.oss-data-acc.aliyuncs.com`
Singapura	`ap-southeast-1c`	`ap-southeast-1c-internal.oss-data-acc.aliyuncs.com`

Izin

Secara default, Akun Alibaba Cloud memiliki izin penuh. Namun, Pengguna RAM atau Peran RAM di bawah Akun Alibaba Cloud tidak memiliki izin apa pun secara default. Administrator Akun Alibaba Cloud harus memberikan izin operasi melalui Kebijakan RAM atau Kebijakan Bucket.

API	Aksi	Deskripsi
GetBucketDataAccelerator	`oss:GetBucketDataAccelerator`	Melihat informasi akselerator bucket.

Sintaks permintaan

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

Header permintaan

Operasi ini menggunakan header permintaan umum. Untuk detail lebih lanjut, lihat Header Permintaan Umum.

Parameter permintaan

Nama	Tipe	Diperlukan	Contoh	Deskripsi
dataAccelerator	string	Ya	Tidak ada	Parameter pengenal untuk operasi API akselerator OSS. Parameter ini dapat memiliki nilai apa saja.
x-oss-datalake-cache-available-zone	string	Tidak	`cn-wulanchabu-b`	Jika parameter ini ada, itu menentukan untuk melihat informasi akselerator untuk zona tertentu. Jika tidak, semua informasi akselerator untuk bucket dikembalikan.
verbose	string	Tidak	Tidak ada	Jika parameter ini ada, itu menentukan untuk melihat semua informasi jalur akselerasi. Jika tidak, hanya informasi dasar akselerator yang dikembalikan tanpa informasi jalur akselerasi. Parameter ini dapat memiliki nilai apa saja.

Header tanggapan

Operasi ini menggunakan header tanggapan umum. Untuk informasi lebih lanjut, lihat Header Tanggapan Umum.

Elemen tanggapan

Nama	Tipe	Contoh	Deskripsi
DataAccelerator	kontainer	Tidak ada	Kontainer yang menyimpan informasi akselerator yang dikonfigurasi untuk bucket. Node anak: `Name` `Bucket` `BasicInfomation` Node induk: tidak ada
Name	string	`mybucket_data-acc`	Nama akselerator. Node anak: tidak ada Node induk: `DataAccelerator`
BucketName	string	`mybucket`	Nama bucket. Node anak: tidak ada Node induk: `DataAccelerator`
BasicInfomation	kontainer	Tidak ada	Kontainer yang menyimpan informasi tentang akselerator tertentu. Node anak: `AvailableZone` `Quota` `AcceleratePaths` `CreationDate` `QuotaFrozenUntil` Node induk: `DataAccelerator`
Quota	bilangan bulat positif	100	Kapasitas akselerator. Node anak: tidak ada Node induk: `BasicInfomation`
AvailableZone	string	`cn-wulanchabu-b`	Zona akselerator. Node anak: tidak ada Node induk: `BasicInfomation`
CreationDate	bilangan bulat positif	`123456789123`	Timestamp saat akselerator dibuat. Node anak: tidak ada Node induk: `BasicInfomation`
QuotaFrozenUntil	bilangan bulat positif	`123456789123`	Timestamp saat kuota akselerator akan dibuka kembali. Kuota tidak dapat dimodifikasi sebelum timestamp ini. Node anak: tidak ada Node induk: `BasicInfomation`
AcceleratePaths	kontainer	Tidak ada	Kontainer yang menyimpan konfigurasi kebijakan akselerasi. Node anak: `DefaultCachePolicy` `Path` Node induk: `BasicInfomation`
Path	kontainer	Tidak ada	Kontainer yang menyimpan konfigurasi jalur akselerasi. Node anak: `CachePolicy` `Name` Node induk: `AcceleratePaths`
Name	string	`test/dir/`	Awalan jalur akselerasi yang ditentukan. Node anak: tidak ada Node induk: `Path`
CachePolicy	string	`sync-warmup`, `write-back`	Kebijakan akselerasi untuk jalur tersebut. Nilai harus salah satu dari parameter berikut, jika tidak kebijakan akselerasi tidak akan berlaku. `sync-warmup` (pemanasan sinkron selama penulisan) `write-back` (pemanasan selama pembacaan) Node anak: tidak ada Node induk: `Path`
DefaultCachePolicy	string	`sync-warmup`, `write-back`	Kebijakan akselerasi untuk seluruh bucket. Nilai harus salah satu dari parameter berikut. `sync-warmup` (pemanasan sinkron selama penulisan) `write-back` (pemanasan selama pembacaan) Node anak: tidak ada Node induk: `AcceleratePaths`

Contoh

Memeriksa informasi konfigurasi akselerator OSS untuk bucket target di wilayah China (Ulanqab).

Contoh Permintaan

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

Contoh Tanggapan

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>

Kode kesalahan

Kode kesalahan	Kode status HTTP	Deskripsi
DataAcceleratorNotFound	404	Bucket saat ini tidak memiliki akselerator yang diaktifkan.
NoSuchConfiguration	404	Bucket saat ini tidak memiliki akselerator yang diaktifkan di zona yang sesuai.