AddServersToServerGroup - - Centre de documentation Alibaba Cloud

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	AddServersToServerGroup	L'opération à effectuer. Définissez la valeur sur AddServersToServerGroup.
ServerGroupId	String	Yes	sgp-atstuj3rtoptyui****	ID du groupe de serveurs.
Servers.N.ServerId	String	Yes	ecs-bp67acfmxazb4p****	ID du serveur backend. Vous pouvez spécifier jusqu'à 40 serveurs backend par appel. Si le type de groupe de serveurs est Instance, définissez ce paramètre sur l'ID d'une instance Elastic Compute Service (ECS), d'une interface réseau élastique (ENI) ou d'une instance de conteneur élastique. Les serveurs backend sont spécifiés par Ecs, Eni ou Eci. Si le type de groupe de serveurs est Ip, définissez ce paramètre sur une adresse IP.
Servers.N.ServerType	String	Yes	Ecs	Type de serveur backend. Valeurs valides : Ecs : instance ECS Eni : ENI Eci : instance de conteneur élastique Ip : adresse IP Remarque Vous pouvez spécifier jusqu'à 40 serveurs backend par appel.
Servers.N.ServerIp	String	No	192.168.6.6	Adresse IP du serveur backend. Si le type de groupe de serveurs est Ip, vous devez spécifier une adresse IP. Remarque Vous pouvez spécifier jusqu'à 40 serveurs backend par appel.
Servers.N.Port	Integer	No	443	Port utilisé par le serveur backend. Valeurs valides : 1 à 65535. Une fois la redirection tous ports activée pour un groupe de serveurs, il n'est pas nécessaire de spécifier les ports lors de l'ajout de serveurs backend. NLB transfère le trafic vers les serveurs backend en fonction des ports frontend. Pour vérifier si la redirection tous ports est activée pour un groupe de serveurs, consultez la valeur AnyPortEnabled renvoyée par l'opération ListServerGroups. Remarque Vous pouvez spécifier jusqu'à 40 serveurs backend par appel.
Servers.N.Weight	Integer	No	100	Poids du serveur backend. Valeurs valides : 0 à 100. Valeur par défaut : 100. Si le poids d'un serveur backend est défini sur 0, aucune requête ne lui est transférée. Remarque Vous pouvez spécifier jusqu'à 40 serveurs backend par appel.
Servers.N.Description	String	No	ECS	Description du serveur backend. La description doit comporter entre 2 et 256 caractères et peut contenir des lettres, des chiffres, des virgules (,), des points (.), des points-virgules (;), des barres obliques (/), des signes at (@), des traits de soulignement (_) et des traits d'union (-). Remarque Vous pouvez spécifier jusqu'à 40 serveurs backend par appel.
RegionId	String	No	cn-hangzhou	ID de région de l'instance NLB. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.
DryRun	Boolean	No	false	Indique s'il faut effectuer uniquement un test à blanc, sans exécuter la requête réelle. Valeurs valides : true : effectue uniquement un test à blanc. Le système vérifie la requête pour détecter d'éventuels problèmes, notamment les valeurs de paramètres manquantes, la syntaxe de requête incorrecte et les limites de service. Si la requête échoue au test à blanc, un message d'erreur est renvoyé. Si la requête réussit le test à blanc, le code d'erreur `DryRunOperation` est renvoyé. false (par défaut) : effectue un test à blanc puis exécute la requête réelle. Si la requête réussit le test à blanc, un code d'état HTTP 2xx est renvoyé et l'opération est effectuée.
ClientToken	String	No	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 le jeton, mais vous devez vous assurer qu'il est unique pour chaque requête. Le jeton ne peut contenir que des caractères ASCII. Remarque Si vous ne spécifiez pas ce paramètre, le système utilise automatiquement le client token comme request ID. L'request ID peut être différent pour chaque requête.

Paramètres de réponse

Parameter	Type	Example	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=AddServersToServerGroup
&ServerGroupId=sgp-atstuj3rtoptyui****
&Servers=[{"ServerId":"ecs-bp67acfmxazb4p****","ServerType":"Ecs","ServerIp":"192.168.6.6","Port":443,"Weight":100,"Description":"ECS"}]
&RegionId=cn-hangzhou
&DryRun=false
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&<Common request parameters>

Exemples de réponses réussies

XML format

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

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

JSON format

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 API.