Object Storage Service:PutBucketInventory

Paramètre

Type

Obligatoire

Exemple

Description

Id

String

Oui

report1

Nom personnalisé de l'inventaire. Ce nom doit respecter les exigences suivantes :

• Il doit être unique au sein du bucket.

• Sa longueur ne peut pas dépasser 192 caractères.

IsEnabled

Boolean

Oui

true

Indique si l'inventaire est activé.

Filter

Container

Non

N/A

Conteneur du filtre définissant les critères de sélection des objets à inclure dans l'inventaire.

Prefix

String

Non

Pics/

Préfixe utilisé pour filtrer les objets.

Nœud parent : Filter

LastModifyBeginTimeStamp

String

Non

1637883649

Début de la plage de dates de dernière modification des objets, exprimé sous forme d'horodatage UNIX en secondes.

Plage de valeurs : [1262275200, 253402271999]

LastModifyEndTimeStamp

String

Non

1638347592

Fin de la plage de dates de dernière modification des objets, exprimée sous forme d'horodatage UNIX en secondes.

Plage de valeurs : [1262275200, 253402271999]

LowerSizeBound

String

Non

1024

Taille minimale (en octets) des objets à inclure dans l'inventaire.

Cette valeur doit être supérieure ou égale à 0 o et inférieure ou égale à 48,8 To.

UpperSizeBound

String

Non

1048576

Taille maximale (en octets) des objets à inclure dans l'inventaire.

Elle doit être strictement supérieure à 0 o et inférieure ou égale à 48,8 To.

StorageClass

String

Non

Standard,IA

Classes de stockage des objets à inventorier. Vous pouvez spécifier plusieurs classes de stockage.

Destination

Container

Oui

N/A

Conteneur regroupant les informations sur la destination où sont stockés les rapports d'inventaire.

OSSBucketDestination

Container

Oui

N/A

Conteneur contenant les informations relatives au bucket de stockage des rapports d'inventaire.

Nœud parent : Destination

Format

String

Oui

CSV

Format du rapport d'inventaire. Ce rapport prend la forme d'un fichier CSV compressé avec GZIP.

Valeurs valides : CSV, Parquet (le format Parquet n'est actuellement pris en charge que dans la région Royaume-Uni (Londres).)

Nœud parent : OSSBucketDestination

AccountId

String

Oui

100000000000000

ID du compte Alibaba Cloud propriétaire du bucket de destination.

Nœud parent : OSSBucketDestination

RoleArn

String

Oui

acs:ram::100000000000000:role/AliyunOSSRole

Alibaba Cloud Resource Name (ARN) du rôle RAM disposant des permissions nécessaires pour lire tous les objets du bucket source et écrire des objets dans le bucket de destination. Le format attendu est acs:ram::uid:role/rolename.

Nœud parent : OSSBucketDestination

Bucket

String

Oui

acs:oss:::bucket_0001

Bucket de destination recevant le rapport d'inventaire.

Nœud parent : OSSBucketDestination

Prefix

String

Non

prefix1/

Préfixe du chemin de stockage des fichiers de rapport d'inventaire.

Nœud parent : OSSBucketDestination

Encryption

Container

Non

N/A

Conteneur de la configuration de chiffrement côté serveur appliquée au rapport d'inventaire.

Valeurs valides :

• SSE-OSS : utilise des clés gérées par OSS pour le chiffrement et le déchiffrement.

• SSE-KMS : s'appuie sur une clé principale client (CMK) par défaut ou spécifiée, gérée par Key Management Service (KMS), pour chiffrer et déchiffrer les données.

Nœud parent : OSSBucketDestination

Pour plus d'informations sur le chiffrement côté serveur, consultez la rubrique Chiffrement côté serveur.

SSE-OSS

Container

No

N/A

Conteneur de la configuration de chiffrement SSE-OSS.

Nœud parent : Encryption

SSE-KMS

Container

No

N/A

Conteneur de la configuration de chiffrement SSE-KMS.

Nœud parent : Encryption

KeyId

String

No

keyId

ID de la CMK gérée par KMS.

Nœud parent : SSE-KMS

Schedule

Container

Yes

N/A

Conteneur de la planification de génération du rapport d'inventaire.

Frequency

String

Yes

Daily

Fréquence de génération du rapport d'inventaire.

Valeurs valides :

• Daily : les rapports d'inventaire sont générés chaque jour.

• Weekly : les rapports d'inventaire sont générés chaque semaine.

• Monthly : les rapports d'inventaire sont générés chaque mois.

• Once : un seul rapport d'inventaire est généré.

Nœud parent : Schedule

DayOfMonth

Positive integer

No

1

Lorsque Frequency a pour valeur Monthly, ce paramètre indique le jour du mois où l'inventaire doit être généré. La valeur doit correspondre à un entier positif compris entre 1 et 31.

• En l'absence de spécification de DayOfMonth, l'inventaire est généré selon un intervalle fixe de 30 jours. La première analyse démarre le jour de la configuration de la règle, puis les rapports suivants sont produits tous les 30 jours.

• Pour une valeur comprise entre 1 et 28, la tâche d'inventaire débute le jour indiqué de chaque mois.

• Si la valeur se situe entre 29 et 31, la tâche commence ce jour-là lorsque le mois le comporte. Dans le cas contraire, elle démarre le dernier jour du mois. Par exemple, avec la valeur 31, la tâche s'exécute le 30 avril.

Nœud parent : Schedule

AutoDelete

Boolean

No

true

Détermine si la configuration d'inventaire doit être supprimée après la génération d'un inventaire unique. Cet élément n'est valide que lorsque Frequency a pour valeur Once.

Valeurs valides : true, false

Nœud parent : Schedule

IncludedObjectVersions

String

Yes

All

Indique si les versions des objets doivent figurer dans l'inventaire.

OptionalFields

Container

No

N/A

Conteneur regroupant les champs facultatifs à intégrer au rapport d'inventaire.

Field

String

No

Size

Champs facultatifs à intégrer au rapport d'inventaire.

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

• VersionId : ID de version de l'objet. Ce champ n'apparaît que si IncludedObjectVersions a pour valeur All.

  • Sans gestion des versions activée sur le bucket, ce champ reste vide.

  • Avec la gestion des versions activée, il contient l'ID de version de l'objet.

• IsDeleteMarker : signale si la version de l'objet constitue un marqueur de suppression. Ce champ n'est présent que si IncludedObjectVersions a pour valeur All.

  • Lorsque le bucket ne dispose pas de la gestion des versions, ce champ prend la valeur false par défaut.

  • Si la gestion des versions est active et que l'objet représente un marqueur de suppression, ce champ affiche true. Dans le cas contraire, il affiche false.

• Size : taille de l'objet.

• StorageClass : classe de stockage de l'objet.

• TransitionTime : date à laquelle une règle de cycle de vie a fait basculer l'objet vers la classe de stockage Archive ou Cold Archive.

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

• ETag : ETag de l'objet. Généré lors de la création de l'objet, il permet d'en identifier le contenu.

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

  • Pour un objet créé par d'autres méthodes, l'ETag représente une valeur unique calculée selon une règle spécifique ; il ne s'agit donc pas du hachage MD5 du contenu.

• IsMultipartUploaded : indique si l'objet a été importé via un upload multipart.

• ObjectType : type de l'objet.

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

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

• EncryptionStatus : précise si l'objet est chiffré.

• TaggingCount : nombre de tags.

IncrementalInventory

Container

No

N/A

Conteneur de la configuration d'inventaire incrémental.

IsEnabled

Boolean

Oui

true

Indique s'il faut activer l'inventaire incrémental. Valeurs valides :

• true : active l'inventaire incrémental.

• false : désactive l'inventaire incrémental.

Si cet élément est défini sur true, l'inventaire incrémental est activé et prend effet même lorsque InventoryConfiguration/IsEnabled a pour valeur false.

Nœud parent : IncrementalInventory

Schedule

Container

Oui

N/A

Conteneur regroupant la planification de génération de l'inventaire incrémental.

Nœud parent : IncrementalInventory

Frequency

Entier positif

Oui

600

Fréquence de génération de l'inventaire incrémental, exprimée en secondes.

Le système applique une fréquence fixe de 600 secondes. À chaque période, un préfixe de répertoire est créé automatiquement, accompagné d'un fichier manifeste correspondant et de plusieurs fichiers CSV générés durant cette même période. Les fréquences personnalisées ne sont pas prises en charge.

Nœud parent : Schedule

OptionalFields

Container

Non

N/A

Conteneur des propriétés à inclure dans le fichier d'inventaire incrémental.

Nœud parent : IncrementalInventory

Field

String

Non

Size

Champs à intégrer dans l'inventaire incrémental.

Nœud parent : OptionalFields

• SequenceNumber : numéro de séquence unique attribué à chaque enregistrement. Pour les enregistrements d'un même objet au sein d'un même bucket, vous pouvez les trier selon SequenceNumber. L'ordre obtenu suit généralement une chronologie.

• RecordType : type d'événement. Valeurs valides : CREATE, UPDATE_METADATA et DELETE.

  • CREATE : couvre toutes les méthodes d'envoi d'objets sous le préfixe sélectionné, telles que Put, Post, Append, MultipartUpload et Copy.

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

  • DELETE : concerne toutes les méthodes de suppression d'objets sous le préfixe sélectionné, notamment DeleteObject, DeleteMultipleObjects, la création de marqueurs de suppression après l'activation du versioning, ainsi que les suppressions liées au cycle de vie. Ces opérations incluent à la fois les marqueurs de suppression et les suppressions définitives. Pour les enregistrements de suppression définitive, seuls les champs principaux Bucket, Key, SequenceNumber, RecordType, RecordTimestamp et VersionId sont conservés ; les autres colonnes restent nulles.

• RecordTimestamp : horodatage de l'enregistrement, exprimé en GMT avec une précision à la milliseconde. Exemple : « 2024-08-25 18:08:01.024 ».

• Requester : ID Alibaba Cloud ou ID de principal de l'auteur de la requête.

• RequestId : identifiant unique de la requête.

• SourceIp : adresse IP source de l'auteur de la requête.

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

• VersionId : ID de version de l'objet. Ce champ n'apparaît que si la règle d'inventaire est configurée pour exporter toutes les versions.

  • Lorsque le versioning n'est pas activé sur le bucket, ce champ reste vide.

  • Si le versioning est activé, il contient l'ID de version de l'objet.

• IsDeleteMarker : indique si la version de l'objet correspond à un marqueur de suppression. Ce champ n'est présent que lorsque la règle d'inventaire exporte toutes les versions.

  • Sans activation du versioning sur le bucket, ce champ prend par défaut la valeur false.

  • Avec le versioning activé, il vaut true si l'objet est un marqueur de suppression, et false dans le cas contraire.

• 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, généré lors de sa création afin d'en identifier le contenu.

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

  • S'il est créé par d'autres méthodes, l'ETag représente une valeur unique calculée selon une règle spécifique, distincte du hachage MD5 du contenu.

• IsMultipartUploaded : précise si l'objet a été envoyé au moyen d'un upload multipart.

• ObjectType : type de l'objet.

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

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

• EncryptionStatus : état de chiffrement de l'objet.