Tous les produits
Search
Centre de documentation

:ListServerGroupServers

Dernière mise à jour :Aug 18, 2026

Répertorie les serveurs backend d’un groupe de serveurs spécifié.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. 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

Parameter Type Required Example Description
Action String Yes ListServerGroupServers

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

ServerGroupId String No sgp-atstuj3rtoptyui****

ID du groupe de serveurs.

ServerIds.N String No ecs-bp67acfmxazb4p****

ID des serveurs. Vous pouvez spécifier jusqu’à 40 ID de serveur par appel.

ServerIps.N String No 192.168.6.3

Adresses IP des serveurs. Vous pouvez spécifier jusqu’à 40 adresses IP de serveur par appel.

NextToken String No FFmyTO70tTpLG6I3FmYAXGKPd****

Jeton utilisé pour la requête suivante. Valeurs possibles :

  • S’il s’agit de votre première requête ou si aucune requête suivante n’est nécessaire, ignorez ce paramètre.
  • Pour envoyer une requête suivante, **définissez** le paramètre sur la valeur NextToken renvoyée lors du dernier appel.
MaxResults Integer No 20

Nombre d’entrées à renvoyer par page. Valeurs possibles : 1 à 100. Valeur par défaut : 20.

Paramètres de réponse

Parameter Type Example Description
RequestId String 54B48E3D-DF70-471B-AA93-08E683A1B45

ID de la requête.

Servers Array of Server

Liste des serveurs backend.

ServerId String ecs-bp67acfmxazb4p****

ID du serveur.

ServerType String Ecs

Type du serveur backend. Valeurs possibles :

  • Ecs : instance Elastic Compute Service (ECS)
  • Eni : interface réseau élastique (ENI)
  • Eci : instance de conteneur élastique
  • Ip : adresse IP
ServerIp String 192.168.2.1

Adresse IP du serveur backend.

Port Integer 80

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

Weight Integer 100

Pondération du serveur backend.

ServerGroupId String sgp-atstuj3rtoptyui****

ID du groupe de serveurs.

Description String ECS

Description du serveur backend.

ZoneId String cn-hangzhou-a

ID de zone du serveur.

Status String Available

État du serveur backend. Valeurs possibles :

  • Adding : Ajout du serveur backend en cours.
  • Available : Serveur backend ajouté.
  • Configuring : Configuration du serveur backend en cours.
  • Removing : Suppression du serveur backend en cours.
TotalCount Integer 10

Nombre total d’entrées renvoyées.

NextToken String FFmyTO70tTpLG6I3FmYAXGKPd****

Jeton utilisé pour la requête suivante. Valeurs possibles :

  • S’il s’agit de votre première requête ou si aucune requête suivante n’est nécessaire, ignorez ce paramètre.
  • Pour envoyer une requête suivante, **définissez** le paramètre sur la valeur NextToken renvoyée lors du dernier appel.
MaxResults Integer 20

Nombre d’entrées renvoyées par page.

Exemples

Exemple de requête

http(s)://[Endpoint]/?Action=ListServerGroupServers
&ServerGroupId=sgp-atstuj3rtoptyui****
&ServerIds=["ecs-bp67acfmxazb4p****"]
&ServerIps=["192.168.6.3"]
&NextToken=FFmyTO70tTpLG6I3FmYAXGKPd****
&MaxResults=20
&<Common request parameters>

Exemple de réponse réussie

Format XML

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

<ListServerGroupServersResponse>
    <RequestId>54B48E3D-DF70-471B-AA93-08E683A1B45</RequestId>
    <Servers>
        <ServerId>ecs-bp67acfmxazb4p****</ServerId>
        <ServerType>Ecs</ServerType>
        <ServerIp>192.168.2.1</ServerIp>
        <Port>80</Port>
        <Weight>100</Weight>
        <ServerGroupId>sgp-atstuj3rtoptyui****</ServerGroupId>
        <Description>ECS</Description>
        <ZoneId>cn-hangzhou-a</ZoneId>
        <Status>Available</Status>
    </Servers>
    <TotalCount>10</TotalCount>
    <NextToken>FFmyTO70tTpLG6I3FmYAXGKPd****</NextToken>
    <MaxResults>20</MaxResults>
</ListServerGroupServersResponse>

Format JSON

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

{
  "RequestId" : "54B48E3D-DF70-471B-AA93-08E683A1B45",
  "Servers" : [ {
    "ServerId" : "ecs-bp67acfmxazb4p****",
    "ServerType" : "Ecs",
    "ServerIp" : "192.168.2.1",
    "Port" : 80,
    "Weight" : 100,
    "ServerGroupId" : "sgp-atstuj3rtoptyui****",
    "Description" : "ECS",
    "ZoneId" : "cn-hangzhou-a",
    "Status" : "Available"
  } ],
  "TotalCount" : 10,
  "NextToken" : "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "MaxResults" : 20
}

Codes d'erreur

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