Tüm Ürünler
Search
Belge Merkezi

Object Storage Service:PutBucketRequestPayment

Son Güncelleme:Oct 01, 2026

Bir paket için istek başına ödeme özelliğini yapılandırmak üzere bu işlemi çağırabilirsiniz.

Kullanım notları

Bir paket için istek başına ödeme özelliğini yapılandırırken aşağıdaki hususlara dikkat edin:

  • Anonim kullanıcıların erişimi reddedilir

    Bir paket için istek başına ödeme özelliğini etkinleştirirseniz anonim kullanıcıların pakete erişmesine izin verilmez. İstekte bulunanların, OSS'nin kimliklerini doğrulayabilmesi ve istekler ile trafik için ücretlendirebilmesi amacıyla OSS'ye kimlik doğrulama bilgileri sağlaması gerekir.

    İstekte bulunan bir Alibaba Cloud hesabının RAM rolünü üstlenerek veri talep ederse OSS, bu istekte bulunan tarafından gönderilen istekler ve oluşan trafik için söz konusu Alibaba Cloud hesabından ücret tahsil eder.

  • İstekte bulunanlar istekte x-oss-request-payer üstbilgisini belirtmelidir

    Bir paket için istek başına ödeme özelliğini etkinleştirirseniz istekte bulunanların POST, GET veya HEAD isteklerinde x-oss-request-payer:requester üstbilgisini belirtmesi gerekir. Bu üstbilgi, istekte bulunanların istekler ve indirilen veriler için ücretlendirileceklerini anladığını gösterir. İstek başına ödeme özelliği etkinleştirilmiş bir pakete gönderilen isteklerde istekte bulunan x-oss-request-payer üstbilgisini belirtmezse istekler kimlik doğrulamadan geçemez.

    Paket sahiplerinin kendi paketlerine erişmek için gönderdikleri isteklerde x-oss-request-payer üstbilgisini belirtmesine gerek yoktur. Bu durumda paket sahipleri, kendi gönderdikleri istekler ve bu isteklerden kaynaklanan trafik için ücretlendirilir.

İstek yapısı

PUT /?requestPayment HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Host: BucketName.oss.aliyuncs.com
Authorization: SignatureValue 
<?xml version="1.0" encoding="UTF-8"?>
<RequestPaymentConfiguration>
  <Payer>Requester</Payer>
</RequestPaymentConfiguration>

İstek üstbilgileri

PutBucketRequestPayment istekleri yalnızca ortak istek üstbilgilerini içerir. Daha fazla bilgi için bkz. Ortak istek üstbilgileri.

İstek öğeleri

Öğe

Tür

Gerekli

Açıklama

RequestPaymentConfiguration

Konteyner

Evet

İstek başına ödeme yapılandırmalarını depolayan konteyner.

Alt düğüm: Payer

Payer

Dize

Evet

İstek ve trafik ücretlerinin ödeyicisi.

Geçerli değerler:

  • BucketOwner: istek ve trafik ücretleri paket sahibi tarafından ödenir.

  • Requester: istek ve trafik ücretleri istekte bulunan tarafından ödenir.

Üst düğüm: RequestPaymentConfiguration

Yanıt üstbilgileri

PutBucketRequestPayment isteklerine verilen yanıtlar yalnızca ortak yanıt üstbilgilerini içerir. Daha fazla bilgi için bkz. Ortak yanıt üstbilgileri.

Örnekler

Örnek istek

PUT /?requestPayment
Content-Length: 83
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 17 Apr 2025 01:33:47 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
<RequestPaymentConfiguration>
  <Payer>Requester</Payer>
</RequestPaymentConfiguration>

Örnek yanıt

200 (OK)
content-length: 0
x-oss-request-id: 5D3663FBB007B79097FC****
date: Tue, 23 Jul 2019 01:33:47 GMT

OSS SDK'ları

PutBucketRequestPayment işlemini çağırmak için aşağıdaki programlama dillerine yönelik OSS SDK'larını kullanabilirsiniz:

ossutil

PutBucketRequestPayment işlemine karşılık gelen ossutil komutu hakkında bilgi için bkz. put-bucket-request-payment.

Hata kodları


Hata kodu


HTTP durum kodu


Açıklama


NoSuchBucket


404


Belirtilen paket mevcut olmadığı için hata iletisi döndürüldü.