DescribeInstances - - Centre de documentation Alibaba Cloud

Remarques d'utilisation

Spécifiez plusieurs paramètres de requête pour filtrer les résultats. Les paramètres spécifiés sont liés par un opérateur logique AND. Seuls les paramètres indiqués sont inclus dans les conditions de filtrage. Toutefois, si le paramètre InstanceIds est défini sur un tableau JSON vide, il est considéré comme une condition de filtrage valide et le système renvoie un résultat vide.
Si vous utilisez un utilisateur ou un rôle RAM qui ne dispose pas des autorisations nécessaires pour appeler cette opération, une liste vide est renvoyée. Incluez le paramètre DryRun dans votre requête pour vérifier si la liste vide résulte d'un manque d'autorisations.
Lorsque vous appelez une opération API via Alibaba Cloud CLI, vous devez spécifier les valeurs des paramètres de requête selon les formats requis pour chaque type de données. Pour plus d'informations, consultez la rubrique Présentation du format des paramètres.
Utilisez l'une des méthodes suivantes pour vérifier les réponses :
- Méthode 1 : Lors d'une requête paginée, lorsque vous appelez l'opération DescribeInstances pour récupérer la première page de résultats, définissez le paramètre MaxResults afin de spécifier le nombre maximal d'entrées à renvoyer. La valeur renvoyée pour le paramètre NextToken correspond à un jeton de pagination, que vous pouvez utiliser dans la requête suivante pour obtenir une nouvelle page de résultats. Lorsque vous appelez l'opération DescribeInstances pour récupérer une nouvelle page, attribuez au paramètre NextToken la valeur NextToken renvoyée lors de l'appel précédent et définissez le paramètre MaxResults pour indiquer le nombre maximal d'entrées à renvoyer pour cet appel.
- Méthode 2 : Utilisez le paramètre PageSize pour spécifier le nombre d'entrées à renvoyer par page, puis utilisez le paramètre PageNumber pour indiquer le numéro de la page à renvoyer.
  
  Vous ne pouvez utiliser qu'une seule des méthodes précédentes. Si un grand nombre d'entrées doit être renvoyé, nous vous recommandons d'utiliser la méthode 1. Lorsque les paramètres MaxResults ou NextToken sont spécifiés, les paramètres de requête PageSize et PageNumber ne prennent pas effet et le paramètre de réponse TotalCount n'est pas valide.

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 l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Oui	DescribeInstances	Opération à exécuter. Définissez la valeur sur DescribeInstances.
RegionId	String	Oui	cn-hangzhou	ID de région de l'instance. Appelez l'opération DescribeRegions pour consulter la liste des régions la plus récente.
VpcId	String	Non	v-bp67acfmxazb4p****	ID du VPC auquel l'instance appartient.
VSwitchId	String	Non	vsw-bp67acfmxazb4p****	ID du vSwitch auquel l'instance est connectée.
ZoneId	String	Non	cn-hangzhou-g	ID de zone de disponibilité de l'instance.
InstanceNetworkType	String	Non	vpc	Type de réseau de l'instance. Valeurs disponibles : classic vpc
SecurityGroupId	String	Non	sg-bp67acfmxazb4p****	ID du groupe de sécurité auquel l'instance appartient.
InstanceIds	String	Non	["i-bp67acfmxazb4p**", "i-bp67acfmxazb4p", ... "i-bp67acfmxazb4p**"]	ID des instances. La valeur peut être un tableau JSON contenant jusqu'à 100 ID d'instance. Séparez les ID par des virgules (,).
PageNumber	Integer	Non	1	Numéro de page. La numérotation des pages commence à 1. Valeur par défaut : 1.
PageSize	Integer	Non	10	Nombre d'entrées par page. Valeurs valides : 1 à 100. Valeur par défaut : 10.
NextToken	String	Non	caeba0bbb2be03f84eb48b699f0a4883	Jeton de pagination utilisé dans la requête suivante pour récupérer une nouvelle page de résultats. Vous devez spécifier le jeton obtenu lors de la requête précédente comme valeur du paramètre `NextToken`.
MaxResults	Integer	Non	10	Nombre maximal d'entrées par page. Valeurs valides : 1 à 100. Valeurs par défaut : Si ce paramètre n'est pas spécifié ou s'il est défini sur une valeur inférieure à 10, la valeur par défaut est 10. Si ce paramètre est défini sur une valeur supérieure à 100, la valeur par défaut est 100.
InnerIpAddresses	String	Non	["10.1.1.1", "10.1.2.1", ... "10.1.10.1"]	Adresses IP internes des instances situées dans le réseau classique. Ce paramètre est valide lorsque le paramètre InstanceNetworkType est défini sur classic. La valeur peut être un tableau JSON contenant jusqu'à 100 adresses IP. Séparez les adresses IP par des virgules (,).
PrivateIpAddresses	String	Non	["172.16.1.1", "172.16.2.1", ... "172.16.10.1"]	Adresses IP privées des instances situées dans des VPC. Ce paramètre est valide lorsque le paramètre InstanceNetworkType est défini sur vpc. La valeur peut être un tableau JSON contenant jusqu'à 100 adresses IP. Séparez les adresses IP par des virgules (,).
PublicIpAddresses	String	Non	["42.1.1.", "42.1.2.", ... "42.1.10.**"]	Adresses IP publiques des instances. La valeur peut être un tableau JSON contenant jusqu'à 100 adresses IP. Séparez les adresses IP par des virgules (,).
EipAddresses	String	Non	["42.1.1.", "42.1.2.", ... "42.1.10.**"]	Adresses EIP (Elastic IP) des instances. Ce paramètre est valide lorsque le paramètre InstanceNetworkType est défini sur vpc. La valeur peut être un tableau JSON contenant jusqu'à 100 adresses IP. Séparez les adresses IP par des virgules (,).
InstanceChargeType	String	Non	PostPaid	Mode de facturation de l'instance. Valeurs disponibles : PostPaid : paiement à l'utilisation PrePaid : abonnement
InternetChargeType	String	Non	PayByTraffic	Mode de facturation pour l'utilisation du réseau. Valeurs disponibles : PayByBandwidth PayByTraffic Remarque Lorsque le mode de facturation pay-by-traffic est utilisé pour l'utilisation du réseau, les bandes passantes maximales entrante et sortante servent de limites supérieures plutôt que de garanties de performance. Dans les scénarios où la demande dépasse l'offre de ressources, les valeurs de bande passante maximale peuvent être limitées. Si vous souhaitez des bandes passantes garanties pour vos instances, utilisez le mode de facturation pay-by-bandwidth pour l'utilisation du réseau.
InstanceName	String	Non	Test	Nom de l'instance. La recherche floue avec le caractère générique astérisque (*) est prise en charge.
ImageId	String	Non	m-bp67acfmxazb4p****	ID de l'image.
Status	String	Non	Running	État de l'instance. Valeurs disponibles : Pending : L'instance est en cours de création. Running : L'instance est en cours d'exécution. Starting : L'instance est en cours de démarrage. Stopping : L'instance est en cours d'arrêt. Stopped : L'instance est arrêtée.
LockReason	String	Non	security	Raison pour laquelle l'instance est verrouillée. Valeurs disponibles : financial : L'instance est verrouillée en raison de paiements en retard. security : L'instance est verrouillée pour des raisons de sécurité. recycling : L'instance preemptible est verrouillée et en attente de libération. dedicatedhostfinancial : L'instance est verrouillée en raison de paiements en retard pour l'hôte dédié. refunded : L'instance est verrouillée car un remboursement a été effectué pour celle-ci.
Filter.1.Key	String	Non	CreationStartTime	Clé du premier filtre utilisé pour interroger les ressources. Définissez la valeur sur `CreationStartTime`. Vous pouvez définir une heure en spécifiant à la fois `Filter.1.Key` et `Filter.1.Value` pour interroger les ressources créées après cette heure.
Filter.2.Key	String	Non	CreationEndTime	Clé du deuxième filtre utilisé pour interroger les ressources. Définissez la valeur sur `CreationEndTime`. Vous pouvez définir une heure en spécifiant à la fois `Filter.2.Key` et `Filter.2.Value` pour interroger les ressources créées avant cette heure.
Filter.3.Key	String	Non	ExpiredStartTime	Clé du troisième filtre utilisé pour interroger les ressources. Définissez la valeur sur `ExpiredStartTime`. Vous pouvez définir une heure en spécifiant à la fois `Filter.3.Key` et `Filter.3.Value` pour interroger les ressources qui expirent après cette heure.
Filter.4.Key	String	Non	ExpiredEndTime	Clé du quatrième filtre utilisé pour interroger les ressources. Définissez la valeur sur `ExpiredEndTime`. Vous pouvez définir une heure en spécifiant à la fois `Filter.4.Key` et `Filter.4.Value` pour interroger les ressources qui expirent avant cette heure.
Filter.1.Value	String	Non	2017-12-05T22:40Z	Valeur du premier filtre utilisé pour interroger les ressources. Définissez la valeur sur une heure. Si vous spécifiez ce paramètre, vous devez également spécifier `Filter.1.Key`. Indiquez l'heure au format `yyyy-MM-ddTHH:mmZ`. L'heure doit être exprimée en UTC.
Filter.2.Value	String	Non	2017-12-06T22:40Z	Valeur du deuxième filtre utilisé pour interroger les ressources. Définissez la valeur sur une heure. Si vous spécifiez ce paramètre, vous devez également spécifier `Filter.2.Key`. Indiquez l'heure au format `yyyy-MM-ddTHH:mmZ`. L'heure doit être exprimée en UTC.
Filter.3.Value	String	Non	2017-12-07T22:40Z	Valeur du troisième filtre utilisé pour interroger les ressources. Définissez la valeur sur une heure. Si vous spécifiez ce paramètre, vous devez également spécifier `Filter.3.Key`. Indiquez l'heure au format `yyyy-MM-ddTHH:mmZ`. L'heure doit être exprimée en UTC.
Filter.4.Value	String	Non	2017-12-08T22:40Z	Valeur du quatrième filtre utilisé pour interroger les ressources. Définissez la valeur sur une heure. Si vous spécifiez ce paramètre, vous devez également spécifier `Filter.4.Key`. Indiquez l'heure au format `yyyy-MM-ddTHH:mmZ`. L'heure doit être exprimée en UTC.
DeviceAvailable	Boolean	Non	false	Remarque Ce paramètre fait l'objet d'un aperçu sur invitation et n'est pas disponible publiquement.
IoOptimized	Boolean	Non	true	Indique si l'instance est optimisée pour les E/S. Valeurs disponibles : true false
NeedSaleCycle	Boolean	Non	false	Remarque Ce paramètre fait l'objet d'un aperçu sur invitation et n'est pas disponible publiquement.
InstanceType	String	Non	ecs.g5.large	Type d'instance de l'instance.
InstanceTypeFamily	String	Non	ecs.g5	Famille d'instances de l'instance.
KeyPairName	String	Non	KeyPairNameTest	Nom de la paire de clés SSH associée à l'instance.
ResourceGroupId	String	Non	rg-bp67acfmxazb4p****	ID du groupe de ressources auquel attribuer l'instance. Si ce paramètre est spécifié pour interroger les ressources, jusqu'à 1 000 ressources appartenant au groupe de ressources indiqué sont renvoyées. Remarque Les interfaces réseau élastiques (ENI) du groupe de ressources par défaut s'affichent dans la réponse, quelle que soit la valeur de ce paramètre.
HpcClusterId	String	Non	hpc-bp67acfmxazb4p****	ID du cluster HPC (High-Performance Computing) auquel l'instance appartient.
RdmaIpAddresses	String	Non	10.10.10.102	Adresses IP RDMA (Remote Direct Memory Access) de l'instance appartenant à un cluster HPC.
DryRun	Boolean	Non	false	Indique s'il faut effectuer uniquement un test à blanc, sans envoyer la requête réelle. Valeurs disponibles : true : effectue uniquement un test à blanc. Le système vérifie la requête pour détecter d'éventuels problèmes, notamment des paires AccessKey non valides, des utilisateurs RAM non autorisés et des valeurs de paramètres manquantes. Si la requête échoue au test à blanc, un message d'erreur est renvoyé. Sinon, le code d'erreur DryRunOperation est renvoyé. false : effectue un test à blanc et envoie 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 exécutée. Valeur par défaut : false.
HttpEndpoint	String	Non	enabled	Indique si le canal d'accès aux métadonnées d'instance est activé. Valeurs disponibles : enabled disabled Valeur par défaut : enabled. Remarque Pour plus d'informations sur les métadonnées d'instance, consultez la rubrique Présentation des métadonnées d'instance ECS.
HttpTokens	String	Non	optional	Indique si le mode de renforcement de la sécurité (IMDSv2) est imposé pour accéder aux métadonnées d'instance. Valeurs disponibles : optional : Le mode de renforcement de la sécurité (IMDSv2) n'est pas imposé. required : Le mode de renforcement de la sécurité (IMDSv2) est imposé. Après avoir défini ce paramètre sur required, vous ne pouvez plus accéder aux métadonnées d'instance en mode normal. Valeur par défaut : optional. Remarque Pour plus d'informations sur les modes d'accès aux métadonnées d'instance, consultez la rubrique Mode d'accès aux métadonnées d'instance.
HttpPutResponseHopLimit	Integer	Non	0	Remarque Ce paramètre fait l'objet d'un aperçu sur invitation et n'est pas disponible publiquement.
Ipv6Address.N	String	Non	2408:4321:180:1701:94c7:bc38:3bfa:****	Adresse IPv6 N de l'ENI. Vous pouvez spécifier plusieurs adresses IPv6. Valeurs valides pour N : 1 à 100.
Tag.N.key	String	Non	keyTest	Clé du tag N de l'instance. Remarque Ce paramètre sera supprimé à l'avenir. Nous vous recommandons d'utiliser le paramètre `Tag.N.Key` pour garantir la compatibilité future.
Tag.N.Key	String	Non	TestKey	Clé du tag N de l'instance. Valeurs valides pour N : 1 à 20. Si un seul tag est spécifié pour interroger les ressources, jusqu'à 1 000 ressources comportant ce tag sont renvoyées. Si plusieurs tags sont spécifiés pour interroger les ressources, jusqu'à 1 000 ressources comportant tous ces tags sont renvoyées. Pour interroger plus de 1 000 ressources comportant les tags spécifiés, appelez l'opération ListTagResources.
Tag.N.Value	String	Non	TestValue	Valeur du tag N de l'instance. Valeurs valides pour N : 1 à 20.
Tag.N.value	String	Non	valueTest	Valeur du tag N de l'instance. Remarque Ce paramètre sera supprimé à l'avenir. Nous vous recommandons d'utiliser le paramètre `Tag.N.Value` pour garantir la compatibilité future.
AdditionalAttributes.N	String	Non	META_OPTIONS	Valeur de l'attribut N. Valeurs valides pour N : 1 à 20. Valeurs disponibles : META_OPTIONS : métadonnées d'instance DDH_CLUSTER : cluster d'hôtes dédiés NETWORK_PRIMARY_ENI_IP : adresse IP secondaire associée à l'ENI principale CPU_OPTIONS_TOPOLOGY_TYPE : topologie CPU de l'instance

Paramètres de réponse

Parameter	Type	Example	Description
NextToken	String	caeba0bbb2be03f84eb48b699f0a4883	Jeton de pagination. Utilisez-le dans la requête suivante pour obtenir une nouvelle page de résultats.
PageSize	Integer	10	Nombre d'entrées par page.
PageNumber	Integer	1	Numéro de page.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID de la requête.
TotalCount	Integer	1	Nombre total d'instances interrogées. Remarque Si vous spécifiez les paramètres `MaxResults` et `NextToken` pour effectuer une requête paginée, la valeur de `TotalCount` n'est pas valide.
Instances	Array of Instance		Instances interrogées.
Instance
CreationTime	String	2017-12-10T04:04Z	Date de création de l'instance. L'heure respecte la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ et s'affiche en UTC. Pour plus d'informations, consultez ISO 8601.
SerialNumber	String	51d1353b-22bf-4567-a176-8b3e12e4****	Numéro de série de l'instance.
Status	String	Running	État de l'instance.
DeploymentSetId	String	ds-bp67acfmxazb4p****	ID du déploiement set utilisé pour déployer l'instance.
KeyPairName	String	testKeyPairName	Nom de la paire de clés à associer à l'instance.
SaleCycle	String	month	Remarque Ce paramètre a été supprimé.
SpotStrategy	String	NoSpot	Politique d'enchère pour l'instance préemptible. Valeurs possibles : NoSpot : l'instance est une instance classique en paiement à l'utilisation. SpotWithPriceLimit : l'instance est une instance préemptible avec un prix horaire maximal défini par l'utilisateur. SpotAsPriceGo : l'instance est une instance préemptible dont le prix du marché est automatiquement utilisé comme prix d'enchère. Le prix du marché peut atteindre le tarif en paiement à l'utilisation.
DeviceAvailable	Boolean	true	Indique si des disques de données peuvent être attachés à l'instance. true false
LocalStorageCapacity	Long	1000	Capacité des disques locaux attachés à l'instance. Unité : GiB.
Description	String	testDescription	description de l'instance.
SpotDuration	Integer	1	Période de protection de l'instance préemptible. Unité : heures. Valeurs possibles : 1 : après la création d'une instance préemptible, Alibaba Cloud garantit que l'instance ne sera pas libérée automatiquement pendant 1 heure. À l'issue de cette période de protection d'une heure, le système compare le prix d'enchère au prix du marché et vérifie l'inventaire des ressources pour déterminer s'il convient de conserver ou de libérer l'instance. 0 : après la création d'une instance préemptible, Alibaba Cloud ne garantit pas que l'instance fonctionnera pendant 1 heure. Le système compare le prix d'enchère au prix du marché et vérifie l'inventaire des ressources pour déterminer s'il convient de conserver ou de libérer l'instance. Alibaba Cloud envoie un événement système ECS pour vous avertir 5 minutes avant la libération de l'instance. Les instances préemptibles sont facturées à la seconde. Nous vous recommandons de spécifier une période de protection adaptée à vos besoins métier. Remarque Ce paramètre est renvoyé lorsque le paramètre SpotStrategy est défini sur SpotWithPriceLimit ou SpotAsPriceGo.
InstanceNetworkType	String	vpc	Type de réseau de l'instance. Valeurs possibles : classic vpc
InstanceName	String	InstanceNameTest	Nom de l'instance.
OSNameEn	String	CentOS 7.4 64 bit	Nom anglais du système d'exploitation de l'instance.
HpcClusterId	String	hpc-bp67acfmxazb4p****	ID du cluster HPC auquel appartient l'instance.
SpotPriceLimit	Float	0.98	Prix horaire maximal de l'instance, précis jusqu'à trois décimales. Ce paramètre est valide lorsque le paramètre SpotStrategy est défini sur SpotWithPriceLimit.
Memory	Integer	16384	Taille de la mémoire de l'instance. Unité : MiB.
OSName	String	CentOS 7.4 64-bit	Nom du système d'exploitation de l'instance.
DeploymentSetGroupNo	Integer	1	Numéro du groupe de déploiement set auquel appartient l'instance au sein d'un déploiement set.
ImageId	String	m-bp67acfmxazb4p****	ID de l'image de l'instance.
VlanId	String	10	ID VLAN (Virtual LAN) de l'instance. Remarque Ce paramètre sera supprimé à l'avenir. Nous vous recommandons d'utiliser d'autres paramètres pour assurer la compatibilité future.
ClusterId	String	c-bp67acfmxazb4p****	ID du cluster auquel appartient l'instance. Remarque Ce paramètre sera supprimé à l'avenir. Nous vous recommandons d'utiliser d'autres paramètres pour assurer la compatibilité future.
GPUSpec	String	NVIDIA V100	Modèle de GPU utilisé par le type d'instance.
AutoReleaseTime	String	2017-12-10T04:04Z	Heure de libération automatique de l'instance en paiement à l'utilisation.
DeletionProtection	Boolean	false	Attribut de protection contre la suppression de l'instance. Ce paramètre indique si vous pouvez utiliser la console ECS ou appeler l'opération DeleteInstance pour libérer l'instance. true : la protection contre la suppression est activée pour l'instance. false : la protection contre la suppression est désactivée pour l'instance. Remarque Ce paramètre s'applique uniquement aux instances en paiement à l'utilisation. Il protège les instances contre les libérations manuelles, mais pas contre les libérations automatiques.
StoppedMode	String	KeepCharging	Indique si l'instance continue d'être facturée après son arrêt. Valeurs possibles : KeepCharging : l'instance est arrêtée en mode standard. La facturation de l'instance se poursuit après l'arrêt et les ressources sont conservées pour l'instance. StopCharging : l'instance est arrêtée en mode économique. La facturation de certaines ressources de l'instance s'arrête après l'arrêt. Lorsque l'instance est arrêtée, ses ressources telles que les vCPU, la mémoire et l'adresse IP publique sont libérées. L'instance risque de ne pas pouvoir redémarrer si certaines ressources requises ne sont plus disponibles dans la région actuelle. Not-applicable : le mode économique ne s'applique pas à l'instance.
GPUAmount	Integer	4	Nombre de GPU utilisés par le type d'instance.
HostName	String	testHostName	Nom d'hôte de l'instance.
InstanceId	String	i-bp67acfmxazb4p****	ID de l'instance.
InternetMaxBandwidthOut	Integer	5	Bande passante publique sortante maximale. Unité : Mbit/s.
InternetMaxBandwidthIn	Integer	50	Bande passante publique entrante maximale. Unité : Mbit/s.
InstanceType	String	ecs.g5.large	Type d'instance.
InstanceChargeType	String	PostPaid	Méthode de facturation de l'instance. Valeurs possibles : PrePaid : abonnement PostPaid : paiement à l'utilisation
RegionId	String	cn-hangzhou	ID de la région de l'instance.
IoOptimized	Boolean	true	Indique si l'instance est optimisée pour les E/S. true false
StartTime	String	2017-12-10T04:04Z	Date du dernier démarrage de l'instance. L'heure respecte la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ et s'affiche en UTC. Pour plus d'informations, consultez ISO 8601.
Cpu	Integer	8	Nombre de vCPU.
LocalStorageAmount	Integer	2	Nombre de disques locaux attachés à l'instance.
ExpiredTime	String	2017-12-10T04:04Z	Date d'expiration de l'instance. L'heure respecte la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ et s'affiche en UTC. Pour plus d'informations, consultez ISO 8601.
ResourceGroupId	String	rg-bp67acfmxazb4p****	ID du groupe de ressources auquel appartient l'instance.
InternetChargeType	String	PayByTraffic	Méthode de facturation de l'utilisation du réseau. Valeurs possibles : PayByBandwidth PayByTraffic
ZoneId	String	cn-hangzhou-g	ID de la zone de disponibilité de l'instance.
Recyclable	Boolean	false	Indique si l'instance peut être recyclée.
ISP	String	null	Remarque Ce paramètre est en aperçu sur invitation et n'est pas disponible publiquement.
CreditSpecification	String	Standard	Mode de performance de l'instance à rafale. Valeurs possibles : Standard : mode standard. Pour plus d'informations, consultez la section « Mode standard » de la rubrique Overview. Unlimited : mode illimité. Pour plus d'informations, consultez la section « Mode illimité » de la rubrique Overview.
InstanceTypeFamily	String	ecs.g5	Famille d'instances de l'instance.
OSType	String	linux	Type de système d'exploitation de l'instance. Valeurs possibles : windows linux
NetworkInterfaces	Array of NetworkInterface		ENI associées à l'instance.
NetworkInterface
Type	String	Primary	Type d'ENI. Valeurs possibles : Primary Secondary
MacAddress	String	00:16:3e:32:b4:**	Adresse MAC (Media Access Control) de l'ENI.
PrimaryIpAddress	String	172.17..*	Adresse IP privée principale de l'ENI.
NetworkInterfaceId	String	eni-2zeh9atclduxvf1z****	ID de l'ENI.
PrivateIpSets	Array of PrivateIpSet		Adresses IP privées.
PrivateIpSet
PrivateIpAddress	String	172.17..	Adresse IP privée de l'instance.
Primary	Boolean	true	Indique si l'adresse IP privée est l'adresse IP privée principale. true false
Ipv6Sets	Array of Ipv6Set		Adresses IPv6 attribuées à l'ENI. Ce paramètre possède une valeur uniquement lorsque `AdditionalAttributes.N` est défini sur `NETWORK_PRIMARY_ENI_IP`.
Ipv6Set
Ipv6Address	String	2408:4321:180:1701:94c7:bc38:3bfa:***	Adresse IPv6 attribuée à l'ENI.
Ipv4PrefixSets	Array of Ipv4PrefixSet		Préfixes IPv4 attribués à l'ENI. Ce paramètre possède une valeur uniquement lorsque `AdditionalAttributes.N` est défini sur `NETWORK_PRIMARY_ENI_IP`.
Ipv4PrefixSet
Ipv4Prefix	String	192.168../28	Préfixe IPv4 attribué à l'ENI.
Ipv6PrefixSets	Array of Ipv6PrefixSet		Préfixes IPv6 attribués à l'ENI. Ce paramètre possède une valeur uniquement lorsque `AdditionalAttributes.N` est défini sur `NETWORK_PRIMARY_ENI_IP`.
Ipv6PrefixSet
Ipv6Prefix	String	2001:1111::::/80	Préfixe IPv6 attribué à l'ENI.
OperationLocks	Array of LockReason		Raisons du verrouillage de l'instance.
LockReason
LockMsg	String	The specified instance is locked due to financial reason.	message renvoyé lors du verrouillage de l'instance.
LockReason	String	Recycling	Raison du verrouillage de l'instance. Valeurs possibles : financial : l'instance a été verrouillée en raison de paiements impayés. security : l'instance a été verrouillée pour des raisons de sécurité. recycling : l'instance préemptible a été verrouillée et est en attente de libération. dedicatedhostfinancial : l'instance a été verrouillée en raison de paiements impayés pour le dedicated host. refunded : l'instance a été verrouillée car un remboursement a été effectué pour celle-ci.
Tags	Array of Tag		tags de l'instance.
Tag
TagValue	String	TestValue	Valeur du tag de l'instance.
TagKey	String	TestKey	Clé du tag de l'instance.
RdmaIpAddress	Array of String	10.10.10.102	Adresses IP RDMA de l'instance appartenant à un cluster HPC.
SecurityGroupIds	Array of String	sg-bp67acfmxazb4p****	ID des groupes de sécurité auxquels appartient l'instance.
PublicIpAddress	Array of String	121.40..	Adresse IP publique de l'instance.
InnerIpAddress	Array of String	10.170..	Adresse IP interne de l'instance située dans le réseau classique.
VpcAttributes	Object		Attributs VPC de l'instance.
VpcId	String	vpc-2zeuphj08tt7q3brd****	ID du VPC.
NatIpAddress	String	172.17..	Adresse IP NAT de l'instance. Elle est utilisée par les instances ECS de différents VPC pour communiquer.

VSwitchId	String	vsw-2zeh0r1pabwtg6wcs****	L'ID du vSwitch.
PrivateIpAddress	Array of String	172.17..	L'adresse IP privée de l'instance.
EipAddress	Object		L'EIP associé à l'instance.
IsSupportUnassociate	Boolean	true	Indique si l'EIP peut être dissocié.
InternetChargeType	String	PayByTraffic	La méthode de facturation de l'EIP. Valeurs possibles : PayByBandwidth PayByTraffic
IpAddress	String	42.112..	L'EIP.
Bandwidth	Integer	5	La bande passante publique maximale de l'EIP. Unité : Mbit/s.
AllocationId	String	eip-2ze88m67qx5z****	L'ID de l'EIP.
HibernationOptions	Object		Remarque Ce paramètre est en aperçu sur invitation et n'est pas disponible publiquement.
Configured	Boolean	false	Remarque Ce paramètre est en aperçu sur invitation et n'est pas disponible publiquement.
DedicatedHostAttribute	Object		Les informations relatives à l'hôte dédié. Il s'agit d'un tableau composé des paramètres DedicatedHostClusterId, DedicatedHostId et DedicatedHostName.
DedicatedHostId	String	dh-bp67acfmxazb4p****	L'ID de l'hôte dédié.
DedicatedHostName	String	testDedicatedHostName	Le nom de l'hôte dédié.
DedicatedHostClusterId	String	dc-bp67acfmxazb4h****	L'ID du cluster d'hôtes dédiés auquel appartient l'hôte dédié.
EcsCapacityReservationAttr	Object		La réservation de capacité associée à l'instance.
CapacityReservationPreference	String	cr-bp67acfmxazb4p****	La préférence de la réservation de capacité.
CapacityReservationId	String	cr-bp67acfmxazb4p****	L'ID de la réservation de capacité.
DedicatedInstanceAttribute	Object		Les attributs de l'instance sur l'hôte dédié.
Affinity	String	default	Indique si l'instance sur un hôte dédié est associée à cet hôte. Valeurs possibles : default : l'instance n'est pas associée à l'hôte dédié. Lorsque l'instance est démarrée à partir du mode économique, elle peut être automatiquement déployée sur un autre hôte dédié dans le pool de ressources de déploiement automatique. host : l'instance est associée à l'hôte dédié. Lorsque l'instance est démarrée à partir du mode économique, elle reste déployée sur l'hôte dédié d'origine.
Tenancy	String	default	Indique si l'instance est hébergée sur un hôte dédié. Valeurs possibles : default : l'instance n'est pas hébergée sur un hôte dédié. host : l'instance est hébergée sur un hôte dédié.
CpuOptions	Object		Les options CPU.
Numa	String	2	Le nombre de threads alloués. Valeur valide : 2.
CoreCount	Integer	2	Le nombre de cœurs CPU physiques.
ThreadsPerCore	Integer	4	Le nombre de threads par cœur CPU.
TopologyType	String	DiscreteCoreToHTMapping	Le type de topologie CPU de l'instance. Valeurs possibles : ContinuousCoreToHTMapping : mode continu Hyper-Threading (HT) DiscreteCoreToHTMapping : mode discret HT
MetadataOptions	Object		Les options de métadonnées.
HttpEndpoint	String	enabled	Indique si le canal d'accès aux métadonnées de l'instance est activé. Valeurs possibles : enabled disabled
HttpPutResponseHopLimit	Integer	0	Remarque Ce paramètre n'est pas disponible publiquement.
HttpTokens	String	optional	Indique si le mode de renforcement de la sécurité (IMDSv2) est utilisé de manière obligatoire pour accéder aux métadonnées de l'instance. Valeurs possibles : optional : le mode de renforcement de la sécurité (IMDSv2) n'est pas utilisé de manière obligatoire. required : le mode de renforcement de la sécurité (IMDSv2) est utilisé de manière obligatoire.
ImageOptions	Object		Les options d'image.
LoginAsNonRoot	Boolean	false	Indique si l'instance utilisant l'image prend en charge les connexions de l'utilisateur ecs-user. Valeurs possibles : true false
SpotInterruptionBehavior	String	Terminate	Le mode d'interruption de l'instance préemptible lorsque le système lance une opération d'interruption d'instance préemptible. Valeurs possibles : terminate : libère l'instance préemptible. Stop : arrête l'instance en mode économique.

Exemples

Exemples de requêtes

https://ecs.aliyuncs.com/?Action=DescribeInstances
&RegionId=cn-hangzhou
&PageSize=1
&PageNumber=1
&<Common request parameters>

Exemples de réponses réussies

XML format

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

<DescribeInstancesResponse>
    <NextToken>caeba0bbb2be03f84eb48b699f0a4883</NextToken>
    <PageSize>10</PageSize>
    <PageNumber>1</PageNumber>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <TotalCount>1</TotalCount>
    <Instances>
        <Instance>
            <CreationTime>2017-12-10T04:04Z</CreationTime>
            <SerialNumber>51d1353b-22bf-4567-a176-8b3e12e4****</SerialNumber>
            <Status>Running</Status>
            <DeploymentSetId>ds-bp67acfmxazb4p****</DeploymentSetId>
            <KeyPairName>testKeyPairName</KeyPairName>
            <SaleCycle>month</SaleCycle>
            <SpotStrategy>NoSpot</SpotStrategy>
            <DeviceAvailable>true</DeviceAvailable>
            <LocalStorageCapacity>1000</LocalStorageCapacity>
            <Description>testDescription</Description>
            <SpotDuration>1</SpotDuration>
            <InstanceNetworkType>vpc</InstanceNetworkType>
            <InstanceName>InstanceNameTest</InstanceName>
            <OSNameEn>CentOS  7.4 64 bit</OSNameEn>
            <HpcClusterId>hpc-bp67acfmxazb4p****</HpcClusterId>
            <SpotPriceLimit>0.98</SpotPriceLimit>
            <Memory>16384</Memory>
            <OSName>CentOS  7.4 64-bit</OSName>
            <DeploymentSetGroupNo>1</DeploymentSetGroupNo>
            <ImageId>m-bp67acfmxazb4p****</ImageId>
            <VlanId>10</VlanId>
            <ClusterId>c-bp67acfmxazb4p****</ClusterId>
            <GPUSpec>NVIDIA V100</GPUSpec>
            <AutoReleaseTime>2017-12-10T04:04Z</AutoReleaseTime>
            <DeletionProtection>false</DeletionProtection>
            <StoppedMode>KeepCharging</StoppedMode>
            <GPUAmount>4</GPUAmount>
            <HostName>testHostName</HostName>
            <InstanceId>i-bp67acfmxazb4p****</InstanceId>
            <InternetMaxBandwidthOut>5</InternetMaxBandwidthOut>
            <InternetMaxBandwidthIn>50</InternetMaxBandwidthIn>
            <InstanceType>ecs.g5.large</InstanceType>
            <InstanceChargeType>PostPaid</InstanceChargeType>
            <RegionId>cn-hangzhou</RegionId>
            <IoOptimized>true</IoOptimized>
            <StartTime>2017-12-10T04:04Z</StartTime>
            <Cpu>8</Cpu>
            <LocalStorageAmount>2</LocalStorageAmount>
            <ExpiredTime>2017-12-10T04:04Z</ExpiredTime>
            <ResourceGroupId>rg-bp67acfmxazb4p****</ResourceGroupId>
            <InternetChargeType>PayByTraffic</InternetChargeType>
            <ZoneId>cn-hangzhou-g</ZoneId>
            <Recyclable>false</Recyclable>
            <ISP>null</ISP>
            <CreditSpecification>Standard</CreditSpecification>
            <InstanceTypeFamily>ecs.g5</InstanceTypeFamily>
            <OSType>linux</OSType>
            <NetworkInterfaces>
                <NetworkInterface>
                    <Type>Primary</Type>
                    <MacAddress>00:16:3e:32:b4:**</MacAddress>
                    <PrimaryIpAddress>172.17.**.***</PrimaryIpAddress>
                    <NetworkInterfaceId>eni-2zeh9atclduxvf1z****</NetworkInterfaceId>
                    <PrivateIpSets>
                        <PrivateIpSet>
                            <PrivateIpAddress>172.17.**.**</PrivateIpAddress>
                            <Primary>true</Primary>
                        </PrivateIpSet>
                    </PrivateIpSets>
                    <Ipv6Sets>
                        <Ipv6Set>
                            <Ipv6Address>2408:4321:180:1701:94c7:bc38:3bfa:***</Ipv6Address>
                        </Ipv6Set>
                    </Ipv6Sets>
                    <Ipv4PrefixSets>
                        <Ipv4PrefixSet>
                            <Ipv4Prefix>192.168.*.*/28</Ipv4Prefix>
                        </Ipv4PrefixSet>
                    </Ipv4PrefixSets>
                    <Ipv6PrefixSets>
                        <Ipv6PrefixSet>
                            <Ipv6Prefix>2001:1111:*:*::/80</Ipv6Prefix>
                        </Ipv6PrefixSet>
                    </Ipv6PrefixSets>
                    <OperationLocks>
                        <OperationLock>
                            <LockMsg>The specified instance is locked due to financial reason.</LockMsg>
                            <LockReason>Recycling</LockReason>
                        </OperationLock>
                    </OperationLocks>
                    <Tags>
                        <Tag>
                            <TagValue>TestValue</TagValue>
                            <TagKey>TestKey</TagKey>
                        </Tag>
                    </Tags>
                    <RdmaIpAddresses>
                        <RdmaIpAddress>10.10.10.102</RdmaIpAddress>
                    </RdmaIpAddresses>
                    <SecurityGroupIds>
                        <SecurityGroupId>sg-bp67acfmxazb4p****</SecurityGroupId>
                    </SecurityGroupIds>
                    <PublicIpAddress>
                        <PublicIpAddres>121.40.**.**</PublicIpAddres>
                    </PublicIpAddress>
                    <InnerIpAddress>
                        <InnerIpAddres>10.170.**.**</InnerIpAddres>
                    </InnerIpAddress>
                    <VpcAttributes>
                        <VpcId>vpc-2zeuphj08tt7q3brd****</VpcId>
                        <NatIpAddress>172.17.**.**</NatIpAddress>
                        <VSwitchId>vsw-2zeh0r1pabwtg6wcs****</VSwitchId>
                        <PrivateIpAddress>
                            <PrivateIpAddres>172.17.**.**</PrivateIpAddres>
                        </PrivateIpAddress>
                    </VpcAttributes>
                    <EipAddress>
                        <IsSupportUnassociate>true</IsSupportUnassociate>
                        <InternetChargeType>PayByTraffic</InternetChargeType>
                        <IpAddress>42.112.**.**</IpAddress>
                        <Bandwidth>5</Bandwidth>
                        <AllocationId>eip-2ze88m67qx5z****</AllocationId>
                    </EipAddress>
                    <HibernationOptions>
                        <Configured>false</Configured>
                    </HibernationOptions>
                    <DedicatedHostAttribute>
                        <DedicatedHostId>dh-bp67acfmxazb4p****</DedicatedHostId>
                        <DedicatedHostName>testDedicatedHostName</DedicatedHostName>
                        <DedicatedHostClusterId>dc-bp67acfmxazb4h****</DedicatedHostClusterId>
                    </DedicatedHostAttribute>
                    <EcsCapacityReservationAttr>
                        <CapacityReservationPreference>cr-bp67acfmxazb4p****</CapacityReservationPreference>
                        <CapacityReservationId>cr-bp67acfmxazb4p****</CapacityReservationId>
                    </EcsCapacityReservationAttr>
                    <DedicatedInstanceAttribute>
                        <Affinity>default</Affinity>
                        <Tenancy>default</Tenancy>
                    </DedicatedInstanceAttribute>
                    <CpuOptions>
                        <Numa>2</Numa>
                        <CoreCount>2</CoreCount>
                        <ThreadsPerCore>4</ThreadsPerCore>
                    </CpuOptions>
                    <MetadataOptions>
                        <HttpEndpoint>enabled</HttpEndpoint>
                        <HttpPutResponseHopLimit>0</HttpPutResponseHopLimit>
                        <HttpTokens>optional</HttpTokens>
                    </MetadataOptions>
                    <ImageOptions>
                        <LoginAsNonRoot>false</LoginAsNonRoot>
                    </ImageOptions>
                </NetworkInterface>
            </NetworkInterfaces>
        </Instance>
    </Instances>
</DescribeInstancesResponse>

JSON format

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

{
  "NextToken" : "caeba0bbb2be03f84eb48b699f0a4883",
  "PageSize" : 10,
  "PageNumber" : 1,
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "TotalCount" : 1,
  "Instances" : {
    "Instance" : [ {
      "CreationTime" : "2017-12-10T04:04Z",
      "SerialNumber" : "51d1353b-22bf-4567-a176-8b3e12e4****",
      "Status" : "Running",
      "DeploymentSetId" : "ds-bp67acfmxazb4p****",
      "KeyPairName" : "testKeyPairName",
      "SaleCycle" : "month",
      "SpotStrategy" : "NoSpot",
      "DeviceAvailable" : true,
      "LocalStorageCapacity" : 1000,
      "Description" : "testDescription",
      "SpotDuration" : 1,
      "InstanceNetworkType" : "vpc",
      "InstanceName" : "InstanceNameTest",
      "OSNameEn" : "CentOS  7.4 64 bit",
      "HpcClusterId" : "hpc-bp67acfmxazb4p****",
      "SpotPriceLimit" : 0.98,
      "Memory" : 16384,
      "OSName" : "CentOS  7.4 64-bit",
      "DeploymentSetGroupNo" : 1,
      "ImageId" : "m-bp67acfmxazb4p****",
      "VlanId" : "10",
      "ClusterId" : "c-bp67acfmxazb4p****",
      "GPUSpec" : "NVIDIA V100",
      "AutoReleaseTime" : "2017-12-10T04:04Z",
      "DeletionProtection" : false,
      "StoppedMode" : "KeepCharging",
      "GPUAmount" : 4,
      "HostName" : "testHostName",
      "InstanceId" : "i-bp67acfmxazb4p****",
      "InternetMaxBandwidthOut" : 5,
      "InternetMaxBandwidthIn" : 50,
      "InstanceType" : "ecs.g5.large",
      "InstanceChargeType" : "PostPaid",
      "RegionId" : "cn-hangzhou",
      "IoOptimized" : true,
      "StartTime" : "2017-12-10T04:04Z",
      "Cpu" : 8,
      "LocalStorageAmount" : 2,
      "ExpiredTime" : "2017-12-10T04:04Z",
      "ResourceGroupId" : "rg-bp67acfmxazb4p****",
      "InternetChargeType" : "PayByTraffic",
      "ZoneId" : "cn-hangzhou-g",
      "Recyclable" : false,
      "ISP" : "null",
      "CreditSpecification" : "Standard",
      "InstanceTypeFamily" : "ecs.g5",
      "OSType" : "linux",
      "NetworkInterfaces" : {
        "NetworkInterface" : [ {
          "Type" : "Primary",
          "MacAddress" : "00:16:3e:32:b4:**",
          "PrimaryIpAddress" : "172.17.**.***",
          "NetworkInterfaceId" : "eni-2zeh9atclduxvf1z****",
          "PrivateIpSets" : {
            "PrivateIpSet" : [ {
              "PrivateIpAddress" : "172.17.**.**",
              "Primary" : true
            } ]
          },
          "Ipv6Sets" : {
            "Ipv6Set" : [ {
              "Ipv6Address" : "2408:4321:180:1701:94c7:bc38:3bfa:***"
            } ]
          },
          "Ipv4PrefixSets" : {
            "Ipv4PrefixSet" : [ {
              "Ipv4Prefix" : "192.168.*.*/28"
            } ]
          },
          "Ipv6PrefixSets" : {
            "Ipv6PrefixSet" : [ {
              "Ipv6Prefix" : "2001:1111:*:*::/80"
            } ]
          },
          "OperationLocks" : {
            "OperationLock" : [ {
              "LockMsg" : "The specified instance is locked due to financial reason.",
              "LockReason" : "Recycling"
            } ]
          },
          "Tags" : {
            "Tag" : [ {
              "TagValue" : "TestValue",
              "TagKey" : "TestKey"
            } ]
          },
          "RdmaIpAddresses" : {
            "RdmaIpAddress" : [ "10.10.10.102" ]
          },
          "SecurityGroupIds" : {
            "SecurityGroupId" : [ "sg-bp67acfmxazb4p****" ]
          },
          "PublicIpAddress" : {
            "PublicIpAddres" : [ "121.40.**.**" ]
          },
          "InnerIpAddress" : {
            "InnerIpAddres" : [ "10.170.**.**" ]
          },
          "VpcAttributes" : {
            "VpcId" : "vpc-2zeuphj08tt7q3brd****",
            "NatIpAddress" : "172.17.**.**",
            "VSwitchId" : "vsw-2zeh0r1pabwtg6wcs****",
            "PrivateIpAddress" : {
              "PrivateIpAddres" : [ "172.17.**.**" ]
            }
          },
          "EipAddress" : {
            "IsSupportUnassociate" : true,
            "InternetChargeType" : "PayByTraffic",
            "IpAddress" : "42.112.**.**",
            "Bandwidth" : 5,
            "AllocationId" : "eip-2ze88m67qx5z****"
          },
          "HibernationOptions" : {
            "Configured" : false
          },
          "DedicatedHostAttribute" : {
            "DedicatedHostId" : "dh-bp67acfmxazb4p****",
            "DedicatedHostName" : "testDedicatedHostName",
            "DedicatedHostClusterId" : "dc-bp67acfmxazb4h****"
          },
          "EcsCapacityReservationAttr" : {
            "CapacityReservationPreference" : "cr-bp67acfmxazb4p****",
            "CapacityReservationId" : "cr-bp67acfmxazb4p****"
          },
          "DedicatedInstanceAttribute" : {
            "Affinity" : "default",
            "Tenancy" : "default"
          },
          "CpuOptions" : {
            "Numa" : "2",
            "CoreCount" : 2,
            "ThreadsPerCore" : 4
          },
          "MetadataOptions" : {
            "HttpEndpoint" : "enabled",
            "HttpPutResponseHopLimit" : 0,
            "HttpTokens" : "optional"
          },
          "ImageOptions" : {
            "LoginAsNonRoot" : false
          }
        } ]
      }
    } ]
  }
}

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	description
400	InvalidTag.Mismatch	The specified Tag.n.Key and Tag.n.Value are not match.	Les valeurs Tag.N.Key et Tag.N.Value ne correspondent pas.
400	InvalidTagCount	The specified tags are beyond the permitted range.	Le nombre maximal de tags est dépassé.
400	InvalidHpcClusterId.NotFound	The specified HpcClusterId is not found.	La valeur HpcClusterId spécifiée est introuvable.
400	InvalidHpcClusterId.Creating	The specified HpcClusterId is creating.	Le cluster HPC est en cours de création.
400	InternalError	The request processing has failed due to some unknown error, exception or failure.	Une erreur interne s'est produite. Réessayez ultérieurement.
404	InvalidInstanceChargeType.NotFound	The InstanceChargeType does not exist in our records.	Valeur InstanceChargeType non valide.
404	InvalidInternetChargeType.ValueNotSupported	The specified InternetChargeType is not valid.	Valeur InternetChargeType non valide.
404	InvalidLockReason.NotFound	The specified LockReason is not found.	La valeur LockReason spécifiée est introuvable.
404	InvalidStatus.NotFound	The specified Status is not found.	La valeur Status spécifiée est introuvable.

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur du service.