PutBucketDataAccelerator - Object Storage Service

Anda dapat memanggil operasi PutBucketDataAccelerator untuk membuat atau mengubah konfigurasi akselerator OSS.

Catatan penggunaan

API akselerator OSS hanya dapat dipanggil dalam lingkungan jaringan internal di wilayah yang sama dengan OSS. Anda harus menggunakan nama domain akselerator yang sesuai. Sebagai contoh, Anda dapat menggunakan Instance ECS di wilayah Ulanqab, yang merupakan wilayah yang sama dengan OSS, untuk mengoperasikan akselerator OSS menggunakan API. Tabel berikut mencantumkan zona yang didukung dan 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`
Singapore	`ap-southeast-1c`	`ap-southeast-1c-internal.oss-data-acc.aliyuncs.com`

Izin

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

API	Aksi	Deskripsi
PutBucketDataAccelerator	`oss:PutBucketDataAccelerator`	Membuat akselerator bucket atau mengubah konfigurasinya.

Sintaks permintaan

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>

Header permintaan

Operasi ini menggunakan header permintaan umum. Untuk informasi 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.

Body permintaan

Nama	Tipe	Diperlukan	Contoh	Deskripsi
DataAcceleratorConfiguration	Kontainer	Ya	T/A	Kontainer untuk konfigurasi akselerator Node anak: `AvailableZone` `Quota` `AcceleratePaths` Node induk: Tidak ada
AvailableZone	string	Ya	`cn-wulanchabu-b`	Zona akselerator. Zona yang saat ini didukung: `cn-beijing-h` (Beijing) `cn-shanghai-g` (Shanghai) `cn-shenzhen-c` (Shenzhen) `cn-hangzhou-j` (Hangzhou) `cn-wulanchabu-b` (Ulanqab) `ap-southeast-1c` (Singapore)
Quota	Bilangan bulat positif	Ya	100	Kapasitas akselerator dalam GB. Kapasitas akselerator tidak dapat dimodifikasi lagi dalam satu jam setelah pembuatan atau modifikasi.
AcceleratePaths	Kontainer	Ya	T/A	Kontainer untuk konfigurasi kebijakan akselerasi Node anak: `DefaultCachePolicy` `Path` Node induk: `DataAcceleratorConfiguration`
Path	Kontainer	Tidak	T/A	Kontainer untuk konfigurasi jalur akselerasi Node anak: `Name` `CachePolicy` Node induk: `AcceleratePaths`
Name	string	Ya	`test/dir/`	Awalan jalur akselerasi yang ditentukan Node anak: Tidak ada Node induk: `Path`
CachePolicy	string	Ya	`sync-warmup`, `write-back`	Kebijakan akselerasi untuk jalur tersebut. Kebijakan akselerasi yang tersedia: `sync-warmup` (pemanasan sinkron saat menulis) `write-back` (pemanasan saat membaca) Node anak: Tidak ada Node induk: `Path`
DefaultCachePolicy	string	Ya	`sync-warmup`, `write-back`	Kebijakan akselerasi default untuk seluruh bucket. Kebijakan ini hanya berlaku jika tidak ada Path yang dikonfigurasi. Kebijakan akselerasi yang tersedia: `sync-warmup` (pemanasan sinkron saat menulis) `write-back` (pemanasan saat membaca) Node anak: Tidak ada Node induk: `AcceleratePaths`

Header respons

Operasi ini menggunakan header respons umum. Untuk informasi lebih lanjut, lihat Header Respons Umum.

Contoh

Membuat Akselerator OSS

Contoh Permintaan

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>

Contoh Respons

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

Kode kesalahan

Kode kesalahan	Kode status HTTP	Deskripsi
TooManyAccelerationPolicyPaths	400	Terlalu banyak jalur akselerasi yang dikonfigurasi.
InvalidCachePathPolicy	400	Kebijakan akselerasi tidak valid.
InvalidQuota	400	Kapasitas akselerator tidak valid.
DataAcceleratorQuotaFrozen	403	Kapasitas akselerator terkunci dan tidak dapat dimodifikasi.
DataAcceleratorAvailableZoneNotSupported	400	Akselerator tidak dapat dibuat di zona ini.