Tous les produits
Search
Centre de documentation

:RemoveServersFromServerGroup

Dernière mise à jour :Aug 18, 2026

Supprime des serveurs backend d'un groupe de serveurs spécifié.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre Type Obligatoire Exemple Description
Action String Oui RemoveServersFromServerGroup

Opération à effectuer. Définissez la valeur sur RemoveServersFromServerGroup.

ServerGroupId String Oui sgp-atstuj3rtoptyui****

ID du groupe de serveurs.

Servers.N.ServerId String Oui ecs-bp67acfmxazb4p****

ID du serveur.

  • Si le type de groupe de serveurs est Instance, définissez le paramètre ServerId sur l'ID d'une instance Elastic Compute Service (ECS), d'une interface réseau élastique (ENI) ou d'une instance de conteneur élastique. Ces serveurs backend sont spécifiés par Ecs, Eni ou Eci.
  • Si le type de groupe de serveurs est Ip, définissez le paramètre ServerId sur une adresse IP.
Servers.N.ServerType String Oui Ecs

Type du serveur backend. Valeurs possibles :

  • Ecs : instance ECS
  • Eni : ENI
  • Eci : instance de conteneur élastique
  • Ip : adresse IP
Servers.N.ServerIp String Non 192.168.6.6

Adresse IP du serveur. Si le type de groupe de serveurs est Ip, définissez le paramètre ServerId sur une adresse IP.

Servers.N.Port Integer Oui 443

Port utilisé par le serveur backend. Valeurs possibles : 1 à 65535.

DryRun Boolean Non false

Indique si la requête doit être uniquement prévalidée. Valeurs possibles :

  • true : prévalide la requête sans supprimer les serveurs backend. Le système vérifie les paramètres requis, la syntaxe de la requête et les limites. En cas d'échec de la prévalidation, un message d'erreur est renvoyé. En cas de succès, le code d'erreur DryRunOperation est renvoyé.
  • false (valeur par défaut) : envoie la requête. Si la prévalidation réussit, un code d'état HTTP 2xx est renvoyé et l'opération est exécutée.
ClientToken String Non 123e4567-e89b-12d3-a456-426655440000

Jeton client utilisé pour garantir l'idempotence de la requête.

Vous pouvez utiliser le client pour générer la valeur, mais vous devez vous assurer qu'elle est unique pour toutes les requêtes. ClientToken ne peut contenir que des caractères ASCII.

Remarque Si vous ne définissez pas ce paramètre, ClientToken prend la valeur de RequestId. La valeur de RequestId peut varier d'une requête API à l'autre.
RegionId String Non cn-hangzhou

ID de la région où l'instance NLB est déployée.

Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.

Paramètres de réponse

Paramètre

Type

Exemple

Description

RequestId

String

54B48E3D-DF70-471B-AA93-08E683A1B45

ID de la requête.

ServerGroupId

String

sgp-atstuj3rtoptyui****

ID du groupe de serveurs.

JobId

String

72dcd26b-f12d-4c27-b3af-18f6aed5****

ID de la tâche asynchrone.

Exemples

Exemples de requêtes

http(s)://[Endpoint]/?Action=RemoveServersFromServerGroup
&ServerGroupId=sgp-atstuj3rtoptyui****
&Servers=[{"ServerId":"ecs-bp67acfmxazb4p****","ServerType":"Ecs","ServerIp":"192.168.6.6","Port":443}]
&DryRun=false
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&RegionId=cn-hangzhou
&<Common request parameters>

Exemples de réponses réussies

Format XML

HTTP/1.1 200 OK
Content-Type:application/xml

<RemoveServersFromServerGroupResponse>
    <RequestId>54B48E3D-DF70-471B-AA93-08E683A1B45</RequestId>
    <ServerGroupId>sgp-atstuj3rtoptyui****</ServerGroupId>
    <JobId>72dcd26b-f12d-4c27-b3af-18f6aed5****</JobId>
</RemoveServersFromServerGroupResponse>

Format JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "54B48E3D-DF70-471B-AA93-08E683A1B45",
  "ServerGroupId" : "sgp-atstuj3rtoptyui****",
  "JobId" : "72dcd26b-f12d-4c27-b3af-18f6aed5****"
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs de l'API.