Object Storage Service:PutBucketRequestPayment

Notas de uso

Tenga en cuenta los puntos a continuación al configurar el pago por solicitante para un bucket:

• Se rechaza el acceso de usuarios anónimos

  Si habilita el pago por solicitante en un bucket, los usuarios anónimos no podrán acceder a él. Los solicitantes deben proporcionar información de autenticación a OSS para que el servicio pueda identificarlos y cobrarles las solicitudes y el tráfico generado.

  Si un solicitante asume un rol de RAM de una cuenta de Alibaba Cloud para solicitar datos, OSS cobrará a dicha cuenta las solicitudes enviadas por el solicitante y el tráfico generado.

• Los solicitantes deben especificar el encabezado x-oss-request-payer en la solicitud

  Si habilita el pago por solicitante en un bucket, los solicitantes deben especificar el encabezado x-oss-request-payer:requester en las solicitudes POST, GET o HEAD. Este encabezado indica que los solicitantes aceptan que se les cobrarán las solicitudes y los datos descargados. Si un solicitante no especifica el encabezado x-oss-request-payer en las solicitudes enviadas a un bucket con pago por solicitante habilitado, las solicitudes no superarán la autenticación.

  Los propietarios del bucket no necesitan especificar el encabezado x-oss-request-payer en las solicitudes para acceder a sus propios buckets. En este caso, se cobra a los propietarios del bucket las solicitudes que envían y el tráfico generado por dichas solicitudes.

Estructura de la solicitud

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>

Encabezados de solicitud

Las solicitudes PutBucketRequestPayment solo contienen encabezados de solicitud comunes. Para obtener más información, consulte Common request headers.

Elementos de solicitud

Encabezados de respuesta

Las respuestas a las solicitudes PutBucketRequestPayment solo contienen encabezados de respuesta comunes. Para obtener más información, consulte Common response headers.

Ejemplos

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>

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

SDK de OSS

ossutil

Para obtener información sobre el comando de ossutil correspondiente a la operación PutBucketRequestPayment, consulte put-bucket-request-payment.

Códigos de error