PUT Bucket Consistency demandée
La demande de cohérence PUT bucket permet de spécifier le niveau de cohérence à appliquer aux opérations effectuées dans un compartiment.
Les contrôles de cohérence par défaut garantissent la lecture après écriture des nouveaux objets.
Vous disposez de l'autorisation s3:PutBuckeConsistency, ou soyez root de compte, pour effectuer cette opération.
Demande
Le x-ntap-sg-consistency
le paramètre doit contenir l'une des valeurs suivantes :
Contrôle de cohérence | Description |
---|---|
tous |
Tous les nœuds reçoivent les données immédiatement, sinon la requête échoue. |
forte croissance mondiale |
Garantit une cohérence de lecture après écriture pour toutes les demandes client sur tous les sites. |
site fort |
Garantit la cohérence de lecture après écriture pour toutes les demandes client dans un site. |
lecture-après-nouvelle-écriture |
(Valeur par défaut) assure la cohérence en lecture après écriture des nouveaux objets et la cohérence des mises à jour des objets. Offre une haute disponibilité et une protection des données garanties. Le correspondance le plus étroite avec les garanties de cohérence Amazon S3. Remarque : si votre application utilise des demandes HEAD sur des objets qui n'existent pas, vous pouvez recevoir un nombre élevé de 500 erreurs de serveur interne si un ou plusieurs nœuds de stockage ne sont pas disponibles. Pour éviter ces erreurs, définissez le contrôle de cohérence sur « disponible », sauf si vous avez besoin de garanties de cohérence similaires à Amazon S3. |
Disponible (cohérence possible pour les opérations DE TÊTE) |
Se comporte de la même manière que le niveau de cohérence « entre la date et la nouvelle écriture », mais n'assure qu'une cohérence éventuelle pour les opérations DE TÊTE. Niveaux de disponibilité supérieurs à ceux de la « nouvelle écriture » en cas d'indisponibilité des nœuds de stockage Diffère des garanties de cohérence Amazon S3 pour les opérations HEAD uniquement. |
Remarque: en général, vous devez utiliser la valeur de contrôle de cohérence "entre les nouvelles écritures". Si les demandes ne fonctionnent pas correctement, modifiez le comportement du client de l'application si possible. Ou configurez le client afin de spécifier le contrôle de cohérence pour chaque requête d'API. Réglez le contrôle de cohérence au niveau du godet uniquement en dernier recours.
Exemple de demande
PUT /bucket?x-ntap-sg-consistency=strong-global HTTP/1.1
Date: date
Authorization: authorization string
Host: host