API REST Profil de réplication de stockage de bloc

Utilisez cette API REST pour gérer les profils de réplication de stockage de bloc.

Vous pouvez effectuer les tâches suivantes pour gérer les profils de réplication de stockage de bloc :

Mise à jour d'un profil de réplication du stockage de bloc existant.
Mise à jour de la bande passante de la réplication du stockage de bloc basée sur IP et du débit de copie en arrière-plan
Validation d'un profil de réplication du stockage de bloc.
Activation des profils de réplication du stockage de bloc sur les armoires principale et auxiliaire pour réplication.
Désactivation des profils de réplication du stockage de bloc sur les armoires principale et auxiliaire pour réplication.
Suppression d'un profil de réplication du stockage de bloc.

Vous pouvez utiliser des paramètres facultatifs pour modifier la réponse de l'appel de l'API REST. Pour plus d'informations, voir la section Information associée.

Pour utiliser cette API REST, votre nom d'utilisateur doit disposer des droits suivants :

Gérer les profils de réplication de stockage en bloc (droits complets)
Administration de la sécurité avec le droit Gérer la sécurité (droits complets)

Mise à jour d'un profil de réplication du stockage de bloc

Créez un profil de réplication du stockage de bloc sur les systèmes principal et auxiliaire qui participent à la réplication.

URI	/admin/resources/dr_infos
Méthode	PUT
Renvoie	200	Le profil de réplication du stockage de bloc a été mis à jour.
	400	Le profil de réplication du stockage de bloc n'a pas été mis à jour.
	500	Platform System Manager a rencontré une erreur interne lors du traitement de la demande.

Corps de demande

Cet appel d'API REST requiert un corps de demande JSON en entrée, avec les attributs à mettre à jour et leurs nouvelles valeurs, comme celui de l'exemple suivant :

{
   "partner_ip" : "new_ip address or new_hostname"
}

Seuls les attributs à mettre à jour doivent être inclus dans la demande JSON.

En cas de problèmes lors de ce processus, les messages d'erreur suivants peuvent être consignés dans les journaux :

Si le profil n'existe pas :

Unable to update block storage replication profile, profile does not exist

Si la valeur de repl_type est FRR :

CWZIP7917W Disaster recovery is not supported by this rack.

Si la valeur de repl_type est autre qu'IDR :

CWZIP9453E The type of the block storage replication profile cannot be changed.

Si la valeur de repl_type est IDR et que le paramètre role est spécifié :

CWZIP9284W Role cannot be specified for a block storage replication profile.

Si partner_ip spécifie l'adresse IP ou le nom d'hôte de l'armoire locale :

CWZIP9397W A block storage replication profile could not be added. The peer management location identifies the local system.

La relation d'accréditation est supprimée.

Si un profil existe déjà :

CWZIP9200W Unable to add block storage replication profile, a profile already exists

Mise à jour de la bande passante de la réplication du stockage de bloc basée sur IP et du débit de copie en arrière-plan

Mettez à jour la bande passante de la réplication du stockage de bloc basée sur IP et le débit de copie en arrière-plan.

URI	/admin/resources/dr_infos/{id}
Méthode	PUT
Renvoie	202	Accepté.
	400	Demande incorrecte. La notation JSON d'entrée n'est pas valide.
	403	Interdit. L'utilisateur n'est pas autorisé à effectuer la fonction demandée.
	500	Platform System Manager a rencontré une erreur interne lors du traitement de la demande.

Corps de demande

Cet appel d'API REST requiert un corps de demande JSON en entrée, avec les attributs à mettre à jour et leurs nouvelles valeurs, comme dans l'exemple suivant :

{
   "storage_copy_bandwidth":2000, "background_copy_rate":45
}

storage_copy_bandwidth: Définit la bande passante cumulée de la liaison de copie à distance entre deux systèmes en cluster en mégabits par seconde (Mbps). La valeur est une valeur numérique comprise entre 1 et 100000 et la valeur par défaut est 1000.
background_copy_rate: Indique le pourcentage maximal de la bande passante cumulée de la liaison pour les opérations de copie d'arrière-plan. La valeur est une valeur numérique comprise entre 0 et 100. La valeur par défaut est 50, ce qui signifie qu'au maximum 50 % de la bande passante cumulée de la liaison peut être utilisée pour les opérations de copie d'arrière-plan.

Remarque: La combinaison de storage_copy_bandwidth et de background_copy_rate doit générer une bande passante de copie en arrière-plan d'au moins 8 Mbit / s.

Par exemple, lorsque vous soumettez une mise à jour avec le code JSON suivant :

{"storage_copy_bandwidth":2000, "background_copy_rate":45}

La bande passante pour les copies à distance passe à 2000 Mbps et le débit de copie en arrière-plan passe à 45 %.

Validation d'un profil de réplication du stockage de bloc

URI	/admin/resources/dr_infos
Méthode	PUT
Renvoie	200	Le profil de réplication du stockage de bloc a été validé.
	400	Le profil de réplication du stockage de bloc n'a pas été validé.
	500	Platform System Manager a rencontré une erreur interne lors du traitement de la demande.

Pour pouvoir valider le profil, vous devez vous assurer qu'il est désactivé.

Corps de demande

Cet appel d'API REST requiert un corps de demande JSON en entrée, avec les attributs à valider et leurs nouvelles valeurs, comme celui de l'exemple suivant :

{
   "target_state" : "validated"
}

Activation ou démarrage d'un profil de réplication du stockage de bloc

URI	/admin/resources/dr_infos
Méthode	PUT
Renvoie	200	Le profil de réplication du stockage de bloc a été activé.
	400	Le profil de réplication du stockage de bloc n'a pas été activé.
	500	Platform System Manager a rencontré une erreur interne lors du traitement de la demande.

L'activation ou le démarrage de la réplication du stockage de bloc à partir d'une armoire l'active sur les deux armoires.

Corps de demande

Cet appel d'API REST requiert un corps de demande JSON en entrée, avec les attributs à mettre à jour et leurs nouvelles valeurs, comme celui de l'exemple suivant :

{
   "target_state" : "enabled"
}

Désactivation d'un profil de réplication du stockage de bloc

URI	/admin/resources/dr_infos
Méthode	PUT
Renvoie	200	Le profil de réplication du stockage de bloc a été désactivé.
	400	Le profil de réplication du stockage de bloc n'a pas été désactivé.
	500	Platform System Manager a rencontré une erreur interne lors du traitement de la demande.

La désactivation de la réplication du stockage de bloc à partir d'une armoire la désactive sur les deux armoires.

Corps de demande

Cet appel d'API REST requiert un corps de demande JSON en entrée, avec les attributs à mettre à jour et leurs nouvelles valeurs, comme celui de l'exemple suivant :

{
   "target_state" : "validated"
   "disable" : "yes"
}

Suppression d'un profil de réplication du stockage de bloc

URI	/admin/resources/dr_infos
Méthode	Supprimer
Renvoie	200	Accepté.
	400	Le profil est introuvable.
	500	Platform System Manager a rencontré une erreur interne lors du traitement de la demande.

Cet appel d'API REST supprime le profil de réplication du stockage de bloc. Il n'existe aucun corps de demande ou de réponse associé à cet appel.

Vous devez désactiver le profil de réplication du stockage de bloc pour pouvoir le supprimer. Si vous tentez de supprimer le profil alors qu'il n'est pas désactivé, le message suivant est affiché :

CWZIP9250E Unable to delete block storage replication profile, profile is not disabled