Object Storage Service:put-bucket-request-payment

Notes d'utilisation

• Par défaut, un compte Alibaba Cloud est autorisé à activer le mode « paiement par le demandeur » sur un bucket. Pour effectuer cette opération via un utilisateur RAM ou le Security Token Service (STS), vous devez disposer de l'autorisation oss:PutBucketRequestPayment. Pour plus d'informations, consultez la rubrique Attacher une stratégie personnalisée à un utilisateur RAM.

• Lorsque le mode « paiement par le demandeur » est activé sur un bucket, les utilisateurs anonymes ne peuvent pas y accéder. Les demandeurs doivent fournir des informations d'authentification afin qu'OSS puisse les identifier et leur facturer les frais de requête et de trafic. Si un demandeur utilise un utilisateur RAM, c'est le compte Alibaba Cloud propriétaire de cet utilisateur RAM qui est facturé pour les requêtes et le trafic généré.

• Si le mode « paiement par le demandeur » est activé, les demandeurs doivent inclure l'en-tête x-oss-request-payer:requester dans leurs requêtes POST, GET ou HEAD pour confirmer qu'ils assument les coûts liés aux requêtes et aux données téléchargées. Sans cet en-tête, l'authentification des requêtes échoue. Le propriétaire du bucket n'a pas besoin d'inclure cet en-tête ; il reste redevable des frais de requête et de trafic lorsqu'il accède à son propre bucket.

Syntaxe de la commande

ossutil api put-bucket-request-payment --bucket value --request-payment-configuration value [flags]

--request-payment-configuration

L'option --request-payment-configuration accepte les formats XML et JSON. Si la valeur commence par le préfixe file://, la configuration est lue depuis un fichier.

• Format XML :

  <RequestPaymentConfiguration>
    <Payer>string</Payer>
  </RequestPaymentConfiguration>

• Format JSON :

  {
    "Payer": "string"
  }

Exemples

Activez le mode « paiement par le demandeur » pour un bucket nommé examplebucket.

• Créez un fichier de configuration nommé request-payment-configuration.xml et ajoutez-y le code suivant :

  <?xml version="1.0" encoding="UTF-8"?>
  <RequestPaymentConfiguration>
    <Payer>Requester</Payer>
  </RequestPaymentConfiguration>

  Exemple de commande :

  ossutil api put-bucket-request-payment --bucket examplebucket --request-payment-configuration file://request-payment-configuration.xml

• Créez un fichier de configuration nommé request-payment-configuration.json et ajoutez-y le code suivant :

  {
    "Payer": "Requester"
  }

  Exemple de commande :

  ossutil api put-bucket-request-payment --bucket examplebucket --request-payment-configuration file://request-payment-configuration.json

• Configurez les paramètres directement dans la commande au format JSON :

  ossutil api put-bucket-request-payment --bucket examplebucket --request-payment-configuration "{\"Payer\":\"Requester\"}"