Skip to main content
Une version plus récente de ce produit est disponible.
La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

Opérations sur les objets

Contributeurs

Cette section décrit la manière dont le système StorageGRID implémente les opérations de l'API REST S3 pour les objets.

Les conditions suivantes s'appliquent à toutes les opérations d'objet :

  • StorageGRID "contrôles de cohérence" sont prises en charge par toutes les opérations sur les objets, à l'exception de ce qui suit :

    • OBTENIR l'ACL d'objet

    • OPTIONS /

    • METTRE l'objet en attente légale

    • CONSERVATION des objets

    • SÉLECTIONNEZ contenu de l'objet

  • Les demandes contradictoires des clients, telles que deux clients qui écrivent sur la même clé, sont résolues sur une base de « derniers-victoires ». Le calendrier de l'évaluation « derniers-victoires » est basé sur le moment où le système StorageGRID remplit une demande donnée et non sur le moment où les clients S3 commencent une opération.

  • Tous les objets d'un compartiment StorageGRID sont détenus par le propriétaire du compartiment, y compris les objets créés par un utilisateur anonyme ou par un autre compte.

  • Les objets de données ingérés dans le système StorageGRID via Swift ne sont pas accessibles via S3.

Le tableau ci-dessous décrit la manière dont StorageGRID implémente les opérations sur les objets de l'API REST S3.

Fonctionnement Mise en place

SUPPRIMER l'objet

Authentification multifacteur (MFA) et en-tête de réponse x-amz-mfa ne sont pas pris en charge.

Lors du traitement d'une requête DE SUPPRESSION d'objet, StorageGRID tente de supprimer immédiatement toutes les copies de l'objet des emplacements stockés. En cas de succès, StorageGRID renvoie immédiatement une réponse au client. Si toutes les copies ne peuvent pas être supprimées dans les 30 secondes (par exemple, parce qu'un emplacement est temporairement indisponible), StorageGRID met les copies en file d'attente pour suppression et indique que le client a réussi.

Gestion des versions

Pour supprimer une version spécifique, le demandeur doit être le propriétaire du compartiment et utiliser le versionId sous-ressource. L'utilisation de cette sous-ressource supprime définitivement la version. Si le versionId correspond à un marqueur de suppression, l'en-tête de réponse x-amz-delete-marker est renvoyé à true.

  • Si un objet est supprimé sans l' versionId sous-ressource sur un compartiment activé pour la version, il génère un marqueur de suppression. Le versionId pour le marqueur de suppression, est renvoyé à l'aide du x-amz-version-id en-tête de réponse, et le x-amz-delete-marker l'en-tête de réponse est renvoyé à true.

  • Si un objet est supprimé sans l' versionId sous-ressource sur un compartiment suspendu de version, elle entraîne la suppression permanente d'une version existante 'null' ou d'un marqueur de suppression 'null' et la génération d'un nouveau marqueur de suppression 'null'. Le x-amz-delete-marker l'en-tête de réponse est renvoyé à true.

    Remarque : dans certains cas, plusieurs marqueurs de suppression peuvent exister pour un objet.

Voir "Utilisez l'API REST S3 pour configurer le verrouillage objet S3" Pour apprendre à supprimer des versions d'objets en mode GOUVERNANCE.

SUPPRIMER plusieurs objets

(DeleteObjects)

Authentification multifacteur (MFA) et en-tête de réponse x-amz-mfa ne sont pas pris en charge.

Plusieurs objets peuvent être supprimés dans le même message de demande.

Voir "Utilisez l'API REST S3 pour configurer le verrouillage objet S3" Pour apprendre à supprimer des versions d'objets en mode GOUVERNANCE.

SUPPRIMER le balisage d'objets

Utilise le tagging sous-ressource pour supprimer toutes les balises d'un objet.

Gestion des versions

Si le versionId le paramètre query n'est pas spécifié dans la demande. l'opération supprime toutes les balises de la version la plus récente de l'objet dans un compartiment versionné. Si la version actuelle de l'objet est un marqueur de suppression, un état "methodNotAldue" est renvoyé avec l' x-amz-delete-marker réponse en-tête réglée sur true.

OBTENIR l'objet

OBTENIR l'ACL d'objet

Si les informations d'identification d'accès nécessaires sont fournies pour le compte, l'opération renvoie une réponse positive ainsi que l'ID, le DisplayName et l'autorisation du propriétaire de l'objet, ce qui indique que le propriétaire dispose d'un accès complet à l'objet.

OBTENIR la mise en attente légale de l'objet

OBTENIR la conservation des objets

OBTENIR le balisage d'objets

Utilise le tagging sous-ressource pour renvoyer toutes les balises d'un objet.

Gestion des versions

Si le versionId le paramètre query n'est pas spécifié dans la demande, l'opération renvoie toutes les balises de la version la plus récente de l'objet dans un compartiment versionné. Si la version actuelle de l'objet est un marqueur de suppression, un état "methodNotAldue" est renvoyé avec l' x-amz-delete-marker réponse en-tête réglée sur true.

Objet TÊTE

Restauration POST-objet

PLACER l'objet

PLACER l'objet - Copier

METTRE l'objet en attente légale

CONSERVATION des objets

PUT Object tagging

Utilise le tagging sous-ressource pour ajouter un ensemble de balises à un objet existant.

Limites des balises d'objet

Vous pouvez ajouter des balises à de nouveaux objets lorsque vous les téléchargez ou les ajouter à des objets existants. StorageGRID et Amazon S3 prennent en charge jusqu'à 10 balises pour chaque objet. Les balises associées à un objet doivent avoir des clés de balise uniques. Une clé de balise peut comporter jusqu'à 128 caractères Unicode et les valeurs de balise peuvent comporter jusqu'à 256 caractères Unicode. Les clés et les valeurs sont sensibles à la casse

Mises à jour des balises et comportement d'ingestion

Lorsque vous utilisez PUT Object tagging pour mettre à jour les balises d'un objet, StorageGRID ne réingérer pas l'objet. Cela signifie que l'option de comportement d'ingestion spécifiée dans la règle ILM correspondante n'est pas utilisée. Tout changement au placement d'objet déclenché par la mise à jour est apporté lors de l'évaluation de ILM par des processus ILM en arrière-plan normaux.

En d'autres termes, si la règle ILM utilise l'option strict pour le comportement d'ingestion, aucune action n'est entreprise si les placements d'objet requis ne peuvent pas être effectués (par exemple, parce qu'un nouvel emplacement n'est pas disponible). L'objet mis à jour conserve son emplacement actuel jusqu'à ce que le placement requis soit possible.

Résolution des conflits

Les demandes contradictoires des clients, telles que deux clients qui écrivent sur la même clé, sont résolues sur la base des « derniers-victoires ». Le calendrier de l'évaluation « derniers-victoires » est basé sur le moment où le système StorageGRID remplit une demande donnée et non sur le moment où les clients S3 commencent une opération.

Gestion des versions

Si le versionId le paramètre de requête n'est pas spécifié dans la requête, l'opération ajoute des balises à la version la plus récente de l'objet dans un compartiment versionné. Si la version actuelle de l'objet est un marqueur de suppression, un état "methodNotAldue" est renvoyé avec l' x-amz-delete-marker réponse en-tête réglée sur true.

SelectObjectContent