Object Storage Service:GetBucketInventory

Notes d'utilisation

Par défaut, un compte Alibaba Cloud est autorisé à consulter la configuration d'inventaire spécifiée d'un compartiment. Pour appeler cette opération en tant qu'utilisateur RAM (Resource Access Management) ou via le service STS (Security Token Service), vous devez disposer de l'autorisation oss:GetBucketInventory.

Syntaxe de la requête

GET /?inventory&inventoryId=inventoryId HTTP/1.1

Paramètres de la requête

Éléments de la réponse

Le tableau suivant décrit les éléments renvoyés dans la réponse. Certains éléments s'appliquent uniquement à des configurations d'inventaire spécifiques. Par exemple, DayOfMonth s'applique uniquement lorsque Frequency est défini sur Monthly, et AutoDelete s'applique uniquement lorsque Frequency est défini sur Once. Les éléments spécifiques aux inventaires incrémentiels sont décrits dans la sous-section suivante.

Champs d'enregistrement de l'inventaire incrémentiel

Les champs suivants décrivent les enregistrements présents dans un fichier d'inventaire incrémentiel :

• SequenceNumber : numéro de série de l'enregistrement. Le SequenceNumber de chaque enregistrement est unique. Les enregistrements d'un même objet dans un même compartiment peuvent être triés par SequenceNumber ; les enregistrements triés suivent généralement l'ordre chronologique.

• RecordType : type d'événement. Valeurs possibles :

  • CREATE : toutes les opérations de téléchargement effectuées sous le préfixe sélectionné, telles que Put, Post, Append, MultipartUpload et Copy.

  • UPDATE_METADATA : toutes les mises à jour de métadonnées sous le préfixe sélectionné.

  • DELETE : toutes les opérations de suppression d'objets sous le préfixe sélectionné, telles que DeleteObject et DeleteMultipleObjects, la génération d'un marqueur de suppression après l'activation du versioning et la suppression basée sur le cycle de vie. Les suppressions incluent la création d'un marqueur de suppression et la suppression définitive. Pour une suppression définitive, l'enregistrement ne conserve que les champs principaux Bucket, Key, SequenceNumber, RecordType, RecordTimestamp et VersionId ; toutes les autres colonnes sont nulles.

• RecordTimestamp : horodatage de l'enregistrement, exprimé en temps universel coordonné (UTC) et précis à la milliseconde près. Exemple : 2024-08-25 18:08:01.024.

• Requester : ID Alibaba Cloud ou ID principal du demandeur.

• RequestId : identifiant unique de la requête.

• SourceIp : adresse IP source du demandeur.

• Key : nom encodé en URL de l'objet dans le compartiment.

• VersionId : ID de version de l'objet. Ce champ apparaît uniquement lorsque la règle d'inventaire configurée exporte toutes les versions.

  • Si le versioning n'est pas activé sur le compartiment pour lequel la règle d'inventaire est configurée, ce champ est vide.

  • Si le versioning est activé sur le compartiment pour lequel la règle d'inventaire est configurée, ce champ affiche le VersionId de l'objet.

• IsDeleteMarker : indique si la version de l'objet est un marqueur de suppression. Ce champ apparaît uniquement lorsque la règle d'inventaire configurée exporte toutes les versions.

  • Si le versioning n'est pas activé sur le compartiment pour lequel la règle d'inventaire est configurée, ce champ prend par défaut la valeur false.

  • Si le versioning est activé sur le compartiment pour lequel la règle d'inventaire est configurée, ce champ prend la valeur true lorsque l'objet est un marqueur de suppression, et false lorsque l'objet n'est pas un marqueur de suppression.

• Size : taille de l'objet.

• StorageClass : classe de stockage de l'objet.

• LastModifiedDate : date de dernière modification de l'objet.

• ETag : ETag de l'objet. Un ETag est créé lors de la génération de l'objet et identifie son contenu.

  • Pour un objet créé à l'aide de l'opération PutObject, l'ETag correspond au hachage MD5 de son contenu.

  • Pour un objet créé à l'aide d'autres méthodes, l'ETag est une valeur unique générée selon certaines règles de calcul et ne correspond pas au hachage MD5 de son contenu.

• IsMultipartUploaded : indique si l'objet a été téléchargé via un téléchargement multipartie.

• ObjectType : type de l'objet.

• ObjectAcl : liste de contrôle d'accès de l'objet.

• Crc64 : valeur CRC-64 de l'objet.

• EncryptionStatus : indique si l'objet est chiffré.

Exemples

• Exemple de requête

GET /?inventory&inventoryId=report1 HTTP/1.1

• Exemple de réponse

HTTP/1.1 200 OK
  x-oss-request-id: 56594298207FB304438516F9
  Date: Mon, 31 Oct 2016 12:00:00 GMT
  Server: AliyunOSS
  Content-Length: length

  <?xml version="1.0" encoding="UTF-8"?>
  <InventoryConfiguration>
     <Id>report1</Id>
     <IsEnabled>true</IsEnabled>
     <Destination>
        <OSSBucketDestination>
           <Format>CSV</Format>
           <AccountId>1000000000000000</AccountId>
           <RoleArn>acs:ram::1000000000000000:role/AliyunOSSRole</RoleArn>
           <Bucket>acs:oss:::bucket_0001</Bucket>
           <Prefix>prefix1</Prefix>
           <Encryption>
              <SSE-OSS/>
           </Encryption>
        </OSSBucketDestination>
     </Destination>
     <Schedule>
        <Frequency>Daily</Frequency>
     </Schedule>
     <Filter>
       <Prefix>myprefix/</Prefix>
     </Filter>
     <IncludedObjectVersions>All</IncludedObjectVersions>
     <OptionalFields>
        <Field>Size</Field>
        <Field>LastModifiedDate</Field>
        <Field>ETag</Field>
        <Field>StorageClass</Field>
        <Field>IsMultipartUploaded</Field>
        <Field>EncryptionStatus</Field>
     </OptionalFields>
  </InventoryConfiguration>

SDK

Les SDK suivants prennent en charge cette opération :

• Java

• Python V2

• Go V2

• Node.js

• C++

• .NET

CLI ossutil

Pour la commande ossutil correspondant à l'opération GetBucketInventory, consultez get-bucket-inventory.