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
Le niveau de cohérence assure un équilibre entre la disponibilité des objets et la cohérence de ces objets entre plusieurs nœuds de stockage et sites. 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 |
|---|---|
|
Spécifie le jeton d'authentification Swift pour le compte à utiliser pour la demande. |
|
Spécifie le type de demande, où |
|
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 |
|---|---|
|
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. |
|
Niveau de contrôle de cohérence appliqué au conteneur. Les valeurs suivantes sont prises en charge :
|
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 |
|---|---|
|
Jeton d'authentification Swift pour le compte à utiliser pour la demande. |
|
Niveau de contrôle de cohérence à appliquer aux opérations sur le conteneur. Les valeurs suivantes sont prises en charge :
|
|
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
Le contrôle de cohérence et la règle ILM de votre choix affectent la protection des objets. 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 le comportement d'ingestion sélectionné pour la règle ILM 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.
Les comportements d'ingestion suivants sont disponibles pour les règles ILM :
-
Strict : toutes les copies spécifiées dans la règle ILM doivent être effectuées avant que le succès ne soit renvoyé au client.
-
Équilibré: StorageGRID tente de faire toutes les copies spécifiées dans la règle ILM à l'entrée; si ce n'est pas possible, des copies intermédiaires sont faites et le succès est renvoyé au client. Les copies spécifiées dans la règle ILM sont effectuées lorsque cela est possible.
-
Double commit: StorageGRID effectue immédiatement des copies intermédiaires de l'objet et retourne le succès au client. Les copies spécifiées dans la règle ILM sont effectuées lorsque cela est possible.
|
Avant de sélectionner le comportement d'entrée d'une règle ILM, lisez la description complète de ces paramètres dans les instructions de gestion des objets avec la gestion du cycle de vie des informations. |
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. L'objet ne peut pas être récupéré.
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