Commencez
Opérations de l'API REST StorageGRID Swift
Suggérer des modifications
PDF
Des opérations sont ajoutées à l'API REST Swift qui sont spécifiques au système StorageGRID.
DEMANDE DE cohérence du conteneur
"Valeurs de cohérence" Équilibre entre disponibilité des objets et cohérence entre ces objets sur différents nœuds et sites de stockage. La demande de cohérence GET Container vous permet de déterminer la cohérence appliquée à un conteneur particulier.
Demande
| En-tête HTTP de demande | Description |
|---|---|
X-Auth-Token |
Spécifie le jeton d'authentification Swift pour le compte à utiliser pour la demande. |
x-ntap-sg-cohérence |
Spécifie le type de demande, où |
Hôte |
Nom d'hôte auquel la demande est dirigée. |
Exemple de demande
GET /v1/28544923908243208806/Swift container X-Auth-Token: SGRD_3a877009a2d24cb1801587bfa9050f29 x-ntap-sg-consistency: true Host: test.com
Réponse
| En-tête HTTP de réponse | Description |
|---|---|
Date |
La date et l'heure de la réponse. |
Connexion |
Indique si la connexion au serveur est ouverte ou fermée. |
X-Trans-ID |
Identifiant de transaction unique pour la demande. |
Longueur-contenu |
Longueur du corps de réponse. |
x-ntap-sg-cohérence |
Cohérence appliquée au conteneur. Les valeurs suivantes sont prises en charge : All : tous les nœuds reçoivent immédiatement les données ou la demande échoue. Strong-global : garantit la cohérence lecture après écriture pour toutes les demandes client sur tous les sites. Strong-site : garantit la cohérence lecture après écriture pour toutes les demandes client au sein d'un site. Read-After-New-write: (Par défaut) fournit une cohérence lecture-après-écriture pour les nouveaux objets et une cohérence éventuelle pour les mises à jour d'objets. Offre une haute disponibilité et une protection des données garanties. Recommandé dans la plupart des cas. Disponible : assure la cohérence finale pour les nouveaux objets et les mises à jour d'objets. Pour les compartiments S3, utilisez uniquement si nécessaire (par exemple, pour un compartiment qui contient des valeurs de journal rarement lues ou pour les opérations HEAD ou GET sur des clés qui n'existent pas). Non pris en charge pour les compartiments FabricPool S3. |
Exemple de réponse
HTTP/1.1 204 No Content Date: Sat, 29 Nov 2015 01:02:18 GMT Connection: CLOSE X-Trans-Id: 1936575373 Content-Length: 0 x-ntap-sg-consistency: strong-site
REQUÊTE de cohérence du conteneur
La demande de cohérence PUT Container vous permet d'indiquer la cohérence à appliquer aux opérations effectuées sur un conteneur. Par défaut, les nouveaux conteneurs sont créés avec la cohérence « Read-after-New-write ».
Demande
| En-tête HTTP de demande | Description |
|---|---|
X-Auth-Token |
Jeton d'authentification Swift pour le compte à utiliser pour la demande. |
x-ntap-sg-cohérence |
Cohérence à appliquer aux opérations sur le conteneur. Les valeurs suivantes sont prises en charge : All : tous les nœuds reçoivent immédiatement les données ou la demande échoue. Strong-global : garantit la cohérence lecture après écriture pour toutes les demandes client sur tous les sites. Strong-site : garantit la cohérence lecture après écriture pour toutes les demandes client au sein d'un site. Read-After-New-write: (Par défaut) fournit une cohérence lecture-après-écriture pour les nouveaux objets et une cohérence éventuelle pour les mises à jour d'objets. Offre une haute disponibilité et une protection des données garanties. Recommandé dans la plupart des cas. Disponible : assure la cohérence finale pour les nouveaux objets et les mises à jour d'objets. Pour les compartiments S3, utilisez uniquement si nécessaire (par exemple, pour un compartiment qui contient des valeurs de journal rarement lues ou pour les opérations HEAD ou GET sur des clés qui n'existent pas). Non pris en charge pour les compartiments FabricPool S3. |
|
Nom d'hôte auquel la demande est dirigée. |
Impact de la cohérence et des règles ILM pour la protection des données
À la fois de votre choix "valeur de la cohérence" De plus, votre règle ILM affecte la façon dont les objets sont protégés. Ces paramètres peuvent interagir.
Par exemple, la cohérence utilisée lorsqu'un objet est stocké affecte le placement initial des métadonnées de l'objet, tandis que l' "comportement d'ingestion" Cette case à cocher affecte le placement initial des copies d'objet. Comme StorageGRID requiert l'accès aux métadonnées et aux données d'un objet pour répondre aux demandes des clients, le choix de niveaux de protection correspondants pour la cohérence et le comportement d'ingestion permet une meilleure protection initiale des données et des réponses système plus prévisibles.
Exemple de l'interaction des règles de cohérence et des règles ILM
Supposons que vous disposez d'un grid à deux sites avec la règle ILM suivante et la cohérence suivante :
-
Règle ILM : créez deux copies d'objet, une sur le site local et une sur un site distant. Le comportement d'entrée strict est sélectionné.
-
**: "Fort-global" (les métadonnées de l'objet sont immédiatement distribuées à tous les sites.)
Lorsqu'un client stocke un objet dans la grille, StorageGRID effectue à la fois des copies d'objet et distribue les métadonnées aux deux sites avant de rétablir la réussite du client.
L'objet est entièrement protégé contre la perte au moment du message d'ingestion. Par exemple, si le site local est perdu peu de temps après l'ingestion, des copies des données de l'objet et des métadonnées de l'objet existent toujours sur le site distant. L'objet est entièrement récupérable.
Si vous utilisez à la place la même règle ILM et la même cohérence « site fort », le client peut recevoir un message de réussite après la réplication des données d'objet vers le site distant, mais avant la distribution des métadonnées d'objet. Dans ce cas, le niveau de protection des métadonnées d'objet ne correspond pas au niveau de protection des données d'objet. Si le site local est perdu peu de temps après l'ingestion, les métadonnées d'objet sont perdues. Impossible de récupérer l'objet.
L'inter-relation entre la cohérence et les règles ILM peut être complexe. Contactez NetApp si vous avez besoin d'aide.
Exemple de demande
PUT /v1/28544923908243208806/_Swift container_ X-Auth-Token: SGRD_3a877009a2d24cb1801587bfa9050f29 x-ntap-sg-consistency: strong-site Host: test.com
Réponse
| En-tête HTTP de réponse | Description |
|---|---|
|
La date et l'heure de la réponse. |
|
Indique si la connexion au serveur est ouverte ou fermée. |
|
Identifiant de transaction unique pour la demande. |
|
Longueur du corps de réponse. |
Exemple de réponse
HTTP/1.1 204 No Content Date: Sat, 29 Nov 2015 01:02:18 GMT Connection: CLOSE X-Trans-Id: 1936575373 Content-Length: 0