Supprimer le réplica
Supprime un réplica de service exécuté sur un nœud.
Cette API simule un échec de réplica Service Fabric en supprimant un réplica dans un cluster Service Fabric. Cette suppression ferme le réplica, effectue la transition du réplica vers le rôle Aucun, puis supprime toutes les informations sur l’état du réplica dans le cluster. Cette API teste le chemin d’accès de suppression d’état du réplica, puis simule le chemin d’accès permanent du rapport d’erreurs via les API clientes. Avertissement : aucune vérification de sécurité n’est effectuée lorsque cette API est utilisée. Une utilisation incorrecte de cette API peut entraîner une perte des données des services avec état. De plus, l’indicateur forceRemove a un impact sur tous les autres réplicas hébergés dans le même processus.
Requête
Méthode | URI de demande |
---|---|
POST | /Nodes/{nodeName}/$/GetPartitions/{partitionId}/$/GetReplicas/{replicaId}/$/Delete?api-version=6.0&ForceRemove={ForceRemove}&timeout={timeout} |
Paramètres
Nom | Type | Obligatoire | Emplacement |
---|---|---|---|
nodeName |
string | Oui | Chemin d’accès |
partitionId |
string (uuid) | Oui | Chemin d’accès |
replicaId |
string | Oui | Chemin d’accès |
api-version |
string | Oui | Requête |
ForceRemove |
boolean | Non | Requête |
timeout |
entier (int64) | Non | Requête |
nodeName
Type : chaîne
Obligatoire : Oui
Nom du nœud.
partitionId
Type : string (uuid)
Obligatoire : Oui
Identité de la partition.
replicaId
Type : chaîne
Obligatoire : Oui
Identificateur du réplica.
api-version
Type : chaîne
Obligatoire : Oui
Par défaut : 6.0
Version de l’API. Ce paramètre est obligatoire et sa valeur doit être « 6.0 ».
La version de l’API REST Service Fabric est basée sur la version du runtime dans laquelle l’API a été introduite ou a été modifiée. Le runtime Service Fabric prend en charge plusieurs versions de l’API. Il s’agit de la dernière version prise en charge de l’API. Si une version d’API inférieure est transmise, la réponse retournée peut être différente de celle documentée dans cette spécification.
En outre, le runtime accepte toute version supérieure à la dernière version prise en charge jusqu’à la version actuelle du runtime. Par conséquent, si la dernière version de l’API est 6.0, mais si le runtime est 6.1, afin de faciliter l’écriture des clients, le runtime accepte la version 6.1 pour cette API. Toutefois, le comportement de l’API sera en fonction de la version 6.0 documentée.
ForceRemove
Type : booléen
Obligatoire : Non
Force la suppression d’un service ou d’une application Service Fabric, sans passer par la séquence d’arrêt normale. Ce paramètre permet de forcer la suppression d’une application ou d’un service pour lesquels le délai de suppression expire à cause de problèmes dans le code de service qui empêchent la fermeture normale des réplicas.
timeout
Type : integer (int64)
Obligatoire : Non
Par défaut : 60
InclusiveMaximum : 4294967295
InclusiveMinimum : 1
Délai d’attente du serveur pour l’exécution de l’opération en secondes. Il spécifie la durée pendant laquelle le client attend la fin de l’opération demandée. La valeur par défaut de ce paramètre est de 60 secondes.
Réponses
Code d’état HTTP | Description | Schéma de réponse |
---|---|---|
200 (OK) | Une opération réussie retourne 200 status code. Une opération réussie signifie que la commande de redémarrage a été reçue par le réplica sur le nœud et qu’elle est en cours de redémarrage. |
|
Tous les autres codes status | Réponse d’erreur détaillée. |
FabricError |