Object Storage Service:PutBucketInventory

Paramètre

Type

Obligatoire

Exemple

Description

Id

String

Oui

report1

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

• Le nom doit être unique au sein du compartiment.

• Le nom ne peut pas dépasser 192 caractères.

IsEnabled

Boolean

Oui

true

Indique si l'inventaire est activé.

Filter

Container

Non

N/A

Conteneur pour le filtre, qui spécifie les critères 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 temps de dernière modification des objets. La valeur est un horodatage UNIX en secondes.

Plage de valeurs : [1262275200, 253402271999]

LastModifyEndTimeStamp

String

Non

1638347592

Fin de la plage de temps de dernière modification des objets. La valeur est un horodatage UNIX en secondes.

Plage de valeurs : [1262275200, 253402271999]

LowerSizeBound

String

Non

1024

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

La 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.

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

StorageClass

String

Non

Standard,IA

Classes de stockage des objets à inclure dans l'inventaire. Vous pouvez spécifier plusieurs classes de stockage.

Destination

Container

Oui

N/A

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

OSSBucketDestination

Container

Oui

N/A

Conteneur contenant les informations sur le compartiment où les rapports d'inventaire sont stockés.

Nœud parent : Destination

Format

String

Oui

CSV

Format du rapport d'inventaire. Le rapport est un fichier CSV compressé au format GZIP.

Valeur valide : CSV

Nœud parent : OSSBucketDestination

AccountId

String

Oui

100000000000000

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

Nœud parent : OSSBucketDestination

RoleArn

String

Oui

acs:ram::100000000000000:role/AliyunOSSRole

Nom de ressource Alibaba Cloud (ARN) du rôle RAM disposant des autorisations pour lire tous les objets du compartiment source et écrire des objets dans le compartiment de destination. Le format est acs:ram::uid:role/rolename.

Nœud parent : OSSBucketDestination

Bucket

String

Oui

acs:oss:::bucket_0001

Compartiment de destination pour le rapport d'inventaire.

Nœud parent : OSSBucketDestination

Prefix

String

Non

prefix1/

Préfixe du chemin d'accès où les fichiers de rapport d'inventaire sont stockés.

Nœud parent : OSSBucketDestination

Encryption

Container

Non

N/A

Conteneur pour la configuration du chiffrement côté serveur du 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 : utilise une clé maître cliente (CMK) par défaut ou spécifiée, gérée par Key Management Service (KMS), pour le chiffrement et le déchiffrement.

Nœud parent : OSSBucketDestination

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

SSE-OSS

Container

Non

N/A

Conteneur pour la configuration du chiffrement SSE-OSS.

Nœud parent : Encryption

SSE-KMS

Container

Non

N/A

Conteneur pour la configuration du chiffrement SSE-KMS.

Nœud parent : Encryption

KeyId

String

Non

keyId

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

Nœud parent : SSE-KMS

Schedule

Container

Oui

N/A

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

Frequency

String

Oui

Daily

Spécifie la fréquence de génération du rapport d'inventaire.

Valeurs valides :

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

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

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

• Once : un rapport d'inventaire est généré une seule fois.

Nœud parent : Schedule

DayOfMonth

Entier positif

Non

1

Si Frequency est défini sur Monthly, spécifie le jour du mois auquel l'inventaire est généré. La valeur doit être un entier positif compris entre 1 et 31.

• Si vous ne spécifiez pas DayOfMonth, l'inventaire est généré à intervalle fixe de 30 jours. La première analyse commence le jour où la règle est configurée, et les rapports suivants sont générés tous les 30 jours.

• Si la valeur est comprise entre 1 et 28, la tâche d'inventaire commence le jour spécifié de chaque mois.

• Si la valeur est comprise entre 29 et 31, la tâche commence ce jour-là si le mois le comporte. Sinon, la tâche commence le dernier jour du mois. Par exemple, si vous définissez la valeur sur 31, la tâche commence le 30 avril.

Nœud parent : Schedule

AutoDelete

Boolean

Non

true

Spécifie s'il faut supprimer la configuration d'inventaire après la génération d'un inventaire unique. Cet élément est valide uniquement lorsque Frequency est défini sur Once.

Valeurs valides : true, false

Nœud parent : Schedule

IncludedObjectVersions

String

Oui

All

Spécifie s'il faut inclure les versions d'objet dans l'inventaire.

OptionalFields

Container

Non

N/A

Conteneur pour les champs facultatifs à inclure dans le rapport d'inventaire.

Field

String

Non

Size

Champs facultatifs à inclure dans le rapport d'inventaire.

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

• VersionId : ID de version de l'objet. Ce champ est inclus uniquement si IncludedObjectVersions est défini sur All.

  • Si le versionnage n'est pas activé pour le compartiment, ce champ est vide.

  • Si le versionnage est activé pour le compartiment, ce champ contient l'ID de version de l'objet.

• IsDeleteMarker : indique si la version de l'objet est un marqueur de suppression. Ce champ est inclus uniquement si IncludedObjectVersions est défini sur All.

  • Si le versionnage n'est pas activé pour le compartiment, ce champ est défini sur false par défaut.

  • Si le versionnage est activé et que l'objet est un marqueur de suppression, ce champ est défini sur true. Si l'objet n'est pas un marqueur de suppression, ce champ est défini sur false.

• Size : taille de l'objet.

• StorageClass : classe de stockage de l'objet.

• TransitionTime : heure à laquelle l'objet a été transféré vers la classe de stockage Archive ou ColdArchive par une règle de cycle de vie.

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

• ETag : ETag de l'objet. L'ETag est généré lors de la création d'un objet et identifie son contenu.

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

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

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

• 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 : indique si l'objet est chiffré.

• TaggingCount : nombre de tags.

IncrementalInventory

Container

Non

N/A

Conteneur pour la configuration de l'inventaire incrémentiel.

IsEnabled

Boolean

Oui

true

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

• true : active l'inventaire incrémentiel.

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

Si cet élément est défini sur true, l'inventaire incrémentiel est activé et prend effet, même si InventoryConfiguration/IsEnabled est défini sur false.

Nœud parent : IncrementalInventory

Schedule

Container

Oui

N/A

Conteneur pour la planification de la génération de l'inventaire incrémentiel.

Nœud parent : IncrementalInventory

Frequency

Entier positif

Oui

600

Fréquence de génération de l'inventaire incrémentiel, en secondes.

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

Nœud parent : Schedule

OptionalFields

Container

Non

N/A

Conteneur pour les propriétés à inclure dans le fichier d'inventaire incrémentiel.

Nœud parent : IncrementalInventory

Field

String

Non

Size

Champs à inclure dans l'inventaire incrémentiel.

Nœud parent : OptionalFields

• SequenceNumber : numéro de séquence unique pour chaque enregistrement. Pour les enregistrements du même objet dans le même compartiment, vous pouvez les trier par SequenceNumber. Les enregistrements triés suivent généralement un ordre chronologique.

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

  • CREATE : inclut toutes les méthodes de téléchargement des objets sous le préfixe sélectionné, telles que Put, Post, Append, MultipartUpload et Copy.

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

  • DELETE : inclut toutes les méthodes de suppression des objets sous le préfixe sélectionné, telles que DeleteObject, DeleteMultipleObjects, la génération de marqueurs de suppression après l'activation du versionnage et la suppression basée sur le cycle de vie. Les suppressions incluent à la fois les marqueurs de suppression et les suppressions permanentes. Pour les enregistrements de suppression permanente, seuls les champs principaux Bucket, Key, SequenceNumber, RecordType, RecordTimestamp et VersionId sont conservés ; les autres colonnes sont nulles.

• RecordTimestamp : horodatage de l'enregistrement, en GMT, 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 de l'objet dans le compartiment. Le nom est encodé en URL.

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

  • Si le versionnage n'est pas activé pour le compartiment, ce champ est vide.

  • Si le versionnage est activé pour le compartiment, ce champ contient l'ID de version de l'objet.

• IsDeleteMarker : indique si la version de l'objet est un marqueur de suppression. Ce champ est inclus uniquement si la règle d'inventaire est configurée pour exporter toutes les versions.

  • Si le versionnage n'est pas activé pour le compartiment, ce champ est défini sur false par défaut.

  • Si le versionnage est activé et que l'objet est un marqueur de suppression, ce champ est défini sur true. Si l'objet n'est pas un marqueur de suppression, ce champ est défini sur false.

• 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. L'ETag est généré lors de la création d'un objet et identifie son contenu.

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

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

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

• 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 : indique si l'objet est chiffré.

Code d'erreur

Code d'état HTTP

Description

InvalidArgument

400

Un ou plusieurs paramètres spécifiés ne sont pas valides.

InventoryExceedLimit

400

Le nombre de règles d'inventaire configurées dépasse la limite.

AccessDenied

403

• Identifiants d'authentification manquants dans la requête PutBucketInventory.

• Vous n'êtes pas autorisé à effectuer cette opération.

InventoryAlreadyExist

409

La règle d'inventaire existe déjà.