ListServerGroupServers - - Centre de documentation Alibaba Cloud

Consulte les serveurs d'un groupe de serveurs.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

alb:ListServerGroupServers

get

*ServerGroup

acs:alb:{#regionId}:{#accountId}:servergroup/{#servergroupId}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
NextToken	string	Non	Le jeton de pagination utilisé dans la requête suivante pour récupérer une nouvelle page de résultats. Valeurs valides : Vous n'avez pas besoin de spécifier ce paramètre pour la première requête ou s'il n'existe aucune requête suivante. S'il existe une requête suivante, définissez la valeur sur la valeur NextToken renvoyée dans l'appel d'API précédent.	FFmyTO70tTpLG6I3FmYAXG****
MaxResults	integer	Non	Le nombre maximal d'enregistrements à renvoyer dans cette requête. Valeurs valides : 1 à 100. Si ce paramètre n'est pas spécifié, la valeur par défaut est 20.	50
ServerGroupId	string	Non	L'identifiant du groupe de serveurs.	sgp-cb25e2i2vr******
ServerIds	array	Non	La liste des identifiants de serveurs.
	string	Non	L'identifiant du serveur. Un maximum de 40 serveurs peut être affiché en un seul appel. Si le type de groupe de serveurs est Instance, ce paramètre spécifie l'identifiant de ressource d'une instance ECS, d'une ENI ou d'une instance ECI. Si le type de groupe de serveurs est Ip, ce paramètre spécifie une adresse IP. Si le type de groupe de serveurs est Fc, ce paramètre spécifie l'ARN d'une fonction Function Compute.	i-bp1e0u8f10by57wl****
Tag	array<object>	Non	Les balises associées au groupe de serveurs. Vous pouvez spécifier jusqu'à 10 balises dans une seule requête.
	object	Non	Les balises associées au groupe de serveurs. Vous pouvez spécifier jusqu'à 10 balises dans une seule requête.
Key	string	Non	La clé de balise. Vous pouvez spécifier jusqu'à 10 clés de balise. La clé de balise peut comporter jusqu'à 64 caractères et ne peut pas commencer par `aliyun` ou `acs:`. Elle ne peut pas contenir `http://` ou `https://`.	Test
Value	string	Non	La valeur de balise. Vous pouvez spécifier jusqu'à 10 valeurs de balise. La valeur de balise peut comporter jusqu'à 128 caractères et ne peut pas commencer par `aliyun` ou `acs:`. Elle ne peut pas contenir `http://` ou `https://`.	Test

Éléments de réponse

Élément	Type	Description	Exemple
	object	La structure de la réponse.
MaxResults	integer	Le nombre maximal d'enregistrements renvoyés dans cette requête.	50
NextToken	string	Le jeton de pagination utilisé dans la requête suivante pour récupérer une nouvelle page de résultats. Valeurs valides : Si NextToken est vide, il n'existe aucune requête suivante. Si NextToken est renvoyé, la valeur indique le jeton pour la requête suivante.	caeba0bbb2be03f8****
RequestId	string	L'identifiant de la requête.	CEF72CEB-54B6-4AE8-B225-F876FF*****
Servers	array<object>	La liste des serveurs.
	object	La structure du serveur back-end.
Description	string	La description du serveur back-end.	test
Port	integer	Le port utilisé par le serveur back-end. Valeurs valides : 1 à 65535.	80
ServerId	string	L'identifiant du serveur back-end. Remarque Si ServerType est défini sur Fc, ServerId spécifie l'ARN de la fonction Function Compute.	i-bp1f9kdprbgy9uiu****
ServerIp	string	L'adresse IP spécifiée.	192.168.XX.XX
ServerType	string	Le type du serveur back-end.	Ecs
Status	string	L'état du serveur back-end. Valeurs valides : Adding : en cours d'ajout. Available : disponible. Configuring : en cours de configuration. Removing : en cours de suppression.	Available
Weight	integer	Le poids du serveur back-end. Un serveur avec un poids plus élevé reçoit davantage de requêtes.	100
ServerGroupId	string	L'identifiant du groupe de serveurs.	sgp-qy042e1jabmprh****
RemoteIpEnabled	boolean	Indique si l'IP distante est activée. Valeurs valides : true : activée. false : désactivée.	true
TotalCount	integer	Le nombre total d'enregistrements qui correspondent aux conditions de filtre spécifiées.	3

Exemples

JSON format

{
  "MaxResults": 50,
  "NextToken": "caeba0bbb2be03f8****",
  "RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF*****",
  "Servers": [
    {
      "Description": "test",
      "Port": 80,
      "ServerId": "i-bp1f9kdprbgy9uiu****",
      "ServerIp": "192.168.XX.XX",
      "ServerType": "Ecs",
      "Status": "Available",
      "Weight": 100,
      "ServerGroupId": "sgp-qy042e1jabmprh****",
      "RemoteIpEnabled": true
    }
  ],
  "TotalCount": 3
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
403	Forbidden.ServerGroup	Authentication has failed for ServerGroup.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.