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.

Requête PUT Bucket compliance obsolète dans StorageGRID

PDF

La requête PUT Bucket compliance est obsolète. Cependant, vous pouvez continuer à utiliser cette requête pour modifier les paramètres de conformité d'un compartiment Compliant existant. Par exemple, vous pouvez placer un compartiment existant en rétention légale ou augmenter sa période de conservation.

Remarque

La fonctionnalité de conformité StorageGRID, disponible dans les versions précédentes de StorageGRID, est obsolète et a été remplacée par S3 Object Lock. Pour plus de détails, consultez ce qui suit :

Vous devez disposer de l’autorisation s3:PutBucketCompliance, ou être root du compte, pour effectuer cette opération.

Vous devez spécifier une valeur pour chaque champ des paramètres de conformité lors de l’émission d’une requête de conformité PUT Bucket.

Exemple de requête

Cette requête d'exemple modifie les paramètres de conformité du compartiment nommé mybucket. Dans cet exemple, les objets dans mybucket seront désormais conservés pendant deux ans (1 051 200 minutes) au lieu d'un an, à compter de leur ingestion dans la grille. Ce compartiment n'est soumis à aucune restriction légale. Chaque objet sera automatiquement supprimé après deux ans.

PUT /mybucket/?x-ntap-sg-compliance HTTP/1.1
Date: date
Authorization: authorization name
Host: host
Content-Length: 152

<SGCompliance>
  <RetentionPeriodMinutes>1051200</RetentionPeriodMinutes>
  <LegalHold>false</LegalHold>
  <AutoDelete>true</AutoDelete>
</SGCompliance>
Nom Description

RetentionPeriodMinutes

La durée de la période de conservation des objets ajoutés à ce compartiment, en minutes. La période de conservation commence lorsque l'objet est ingérée dans la grille.

Important Lorsque vous définissez une nouvelle valeur pour RetentionPeriodMinutes, vous devez indiquer une valeur supérieure ou égale à la période de rétention actuelle du compartiment. Une fois la période de rétention du compartiment définie, vous ne pouvez plus diminuer cette valeur ; vous pouvez seulement l'augmenter.

LegalHold

  • Vrai : Ce compartiment fait actuellement l’objet d’une rétention légale. Les objets dans ce compartiment ne peuvent pas être supprimés tant que la rétention légale n’est pas levée, même si leur période de conservation est expirée.

  • Faux : ce compartiment n’est actuellement soumis à aucune restriction légale. Les objets de ce compartiment peuvent être supprimés à l’expiration de leur période de conservation.

AutoDelete

  • Vrai : les objets dans ce compartiment seront automatiquement supprimés à l’expiration de leur période de conservation, sauf si le compartiment fait l’objet d’une rétention légale.

  • Faux : les objets de ce compartiment ne seront pas supprimés automatiquement à l’expiration de la période de rétention. Vous devez supprimer ces objets manuellement si vous devez les supprimer.

Cohérence des paramètres de conformité

Lorsque vous mettez à jour les paramètres de conformité d'un compartiment S3 à l'aide d'une requête PUT Bucket compliance, StorageGRID tente de mettre à jour les métadonnées du compartiment sur l'ensemble de la grille. Par défaut, StorageGRID utilise la cohérence Strong-global pour garantir que tous les sites de centres de données et tous les nœuds de stockage contenant des métadonnées de compartiment bénéficient d'une cohérence en lecture après écriture pour les paramètres de conformité modifiés.

Si StorageGRID ne peut pas atteindre la cohérence Strong-global parce qu'un site de centre de données ou plusieurs Storage Nodes d'un site sont indisponibles, le code d'état HTTP de la réponse est 503 Service Unavailable.

Si vous recevez cette réponse, vous devez contacter l'administrateur du grid pour vous assurer que les services de stockage requis sont disponibles dans les plus brefs délais. Si l'administrateur du grid ne parvient pas à rendre disponibles suffisamment de Storage Nodes sur chaque site, le support technique pourrait vous demander de relancer la requête ayant échoué en forçant la cohérence Strong-site.

Avertissement N’imposez jamais la cohérence Strong-site pour la conformité du compartiment PUT, sauf si le support technique vous l’a demandé et si vous comprenez les conséquences potentielles de l’utilisation de ce niveau.

Lorsque la cohérence est réduite à Strong-site, StorageGRID garantit que les paramètres de conformité mis à jour offriront une cohérence de lecture après écriture uniquement pour les requêtes client au sein d'un site. Cela signifie que le système StorageGRID peut temporairement avoir plusieurs paramètres incohérents pour ce bucket, jusqu'à ce que tous les sites et nœuds de stockage soient disponibles. Les paramètres incohérents peuvent entraîner un comportement inattendu et indésirable. Par exemple, si vous placez un bucket sous conservation légale et que vous forcez une cohérence inférieure, les paramètres de conformité précédents du bucket (c'est-à-dire conservation légale désactivée) peuvent continuer à être en vigueur sur certains sites de centres de données. En conséquence, des objets que vous pensez être sous conservation légale peuvent être supprimés à l'expiration de leur période de rétention, soit par l'utilisateur, soit par AutoDelete, si cette option est activée.

Pour forcer l'utilisation de la cohérence Strong-site, réémettez la requête de conformité PUT Bucket et incluez l' `Consistency-Control`en-tête de requête HTTP, comme suit :

PUT /mybucket/?x-ntap-sg-compliance HTTP/1.1
Consistency-Control: strong-site

Réponses d'erreur

  • Si le compartiment n'a pas été créé pour être conforme, le code d'état HTTP de la réponse est 404 Not Found.

  • Si RetentionPeriodMinutes dans la requête est inférieur à la période de rétention actuelle du compartiment, le code d'état HTTP est 400 Bad Request.

Informations connexes

"Déprécié : Modifications des requêtes PUT Bucket pour conformité"