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
"Contrôles 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 DU conteneur GET vous permet de déterminer le niveau de cohérence appliqué à 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 |
Niveau de contrôle de cohérence appliqué au conteneur. Les valeurs suivantes sont prises en charge : Tous : tous les nœuds reçoivent les données immédiatement ou la demande échouera. Forte-global: Garantit la cohérence 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 de clients au sein d'un site. Read-after-New-write: (Par défaut) fournit la cohérence lecture-après-écriture pour les nouveaux objets et éventuellement la cohérence 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 dans le conteneur vous permet de spécifier le niveau de cohérence à appliquer aux opérations effectuées dans un conteneur. Par défaut, les nouveaux conteneurs sont créés à l'aide du niveau de 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 |
Niveau de contrôle de cohérence à appliquer aux opérations sur le conteneur. Les valeurs suivantes sont prises en charge : Tous : tous les nœuds reçoivent les données immédiatement ou la demande échouera. Forte-global: Garantit la cohérence 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 de clients au sein d'un site. Read-after-New-write: (Par défaut) fournit la cohérence lecture-après-écriture pour les nouveaux objets et éventuellement la cohérence 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. |
Interaction des contrôles de cohérence et des règles ILM pour la protection des données
À la fois de votre choix "contrôle 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, le contrôle de cohérence utilisé lorsqu'un objet est stocké affecte le placement initial des métadonnées d'objet, tandis que l' "comportement d'ingestion" Cette case à cocher affecte le placement initial des copies d'objet. Étant donné que StorageGRID nécessite l'accès aux métadonnées d'un objet et à ses données pour répondre aux demandes client, la sélection de niveaux de protection correspondant au niveau de cohérence et au comportement d'ingestion permet d'améliorer la protection des données initiale et de mieux prévoir les réponses du système.
Exemple d'interaction du contrôle de cohérence et de la règle ILM
Supposons que vous disposez d'une grille à deux sites avec la règle ILM suivante et le paramètre de niveau de cohérence suivant :
-
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é.
-
Niveau de cohérence: "Sept-global" (les métadonnées d'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 le niveau de cohérence "sept-site", 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 que les métadonnées d'objet ne soient distribuées sur ce site. 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'interdépendance entre les niveaux de 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