Tous les produits
Search

Ce produit

    :DescribeInstanceTypes

    Centre de documentation

    :DescribeInstanceTypes

    Dernière mise à jour :Aug 06, 2026

    Interrogez les détails de tous les types d'instance ou d'un type d'instance spécifique fourni par Elastic Compute Service (ECS).

    Notes d'utilisation

    Tenez compte des points suivants :

    • Le paramètre MaxResults définit le nombre maximal d'entrées à renvoyer par page. Sa valeur maximale passe de 1 600 à 100. Si vous avez utilisé cette opération en 2022, vous pouvez continuer à utiliser 1 600 comme valeur maximale jusqu'au 15 novembre 2023. À partir du 15 novembre 2023, la valeur maximale autorisée sera uniquement de 100. Si vous ne configurez pas le paramètre NextToken lors de l'appel à l'opération DescribeInstanceTypes, seule la première page de résultats contenant jusqu'à 100 entrées est renvoyée. Pour récupérer davantage de résultats, configurez le paramètre NextToken afin d'effectuer des requêtes paginées ou spécifiez des conditions de filtrage pour affiner les résultats.

    • Nous vous recommandons de spécifier les paramètres MaxResults et NextToken pour effectuer des requêtes paginées. Lors du premier appel à l'opération DescribeInstanceTypes, définissez MaxResults pour limiter le nombre maximal d'entrées renvoyées. Si le nombre total d'entrées dépasse la valeur spécifiée pour MaxResults, la réponse inclut une valeur NextToken. Utilisez cette valeur retournée pour le paramètre NextToken dans votre prochaine requête DescribeInstanceTypes, tout en conservant la valeur MaxResults, afin de récupérer la page de résultats suivante.

    • L'opération DescribeInstanceTypes sert uniquement à interroger les spécifications et les informations de performance des types d'instance. Pour connaître les types d'instance disponibles dans une région donnée, appelez l'opération DescribeAvailableResource.

    • Pour utiliser des types d'instance spéciaux, tels que ceux qui ne sont pas disponibles à l'achat, soumettez un ticket.

    Débogage

    OpenAPI Explorer calcule automatiquement la valeur de signature. Par souci de simplicité, nous vous recommandons d'appeler cette opération via OpenAPI Explorer. Celui-ci génère dynamiquement des exemples de code adaptés aux différents SDK.

    Paramètres de requête

    Paramètre

    Type

    Obligatoire

    Exemple

    Description

    Action

    String

    Oui

    DescribeInstanceTypes

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

    InstanceTypeFamily

    String

    Non

    ecs.g6

    Famille d'instances à laquelle appartient le type d'instance. Pour connaître les valeurs valides de ce paramètre, consultez DescribeInstanceTypeFamilies.

    Pour plus d'informations sur les familles d'instances, consultez Familles d'instances.

    InstanceTypes.N

    String

    Non

    ecs.g6.large

    Type d'instance N. Les valeurs valides pour N vont de 1 à 10. Si ce paramètre est laissé vide, les informations relatives à tous les types d'instance sont interrogées.

    MinimumCpuCoreCount

    Integer

    Non

    2

    Nombre minimal de vCPU. La valeur doit être un entier positif.

    Remarque

    Si le nombre de vCPU d'un type d'instance est inférieur à la valeur spécifiée, les informations relatives à ce type d'instance ne sont pas interrogées.

    MaximumCpuCoreCount

    Integer

    Non

    10

    Nombre maximal de vCPU. La valeur doit être un entier positif.

    Remarque

    Si le nombre de vCPU d'un type d'instance est supérieur à la valeur spécifiée, les informations relatives à ce type d'instance ne sont pas interrogées.

    MinimumMemorySize

    Float

    Non

    20

    Taille minimale de la mémoire. Unité : GiB.

    Remarque

    Si la taille de la mémoire d'un type d'instance est inférieure à la valeur spécifiée, les informations relatives à ce type d'instance ne sont pas interrogées.

    MaximumMemorySize

    Float

    Non

    60

    Taille maximale de la mémoire. Unité : GiB.

    Remarque

    Si la taille de la mémoire d'un type d'instance est supérieure à la valeur spécifiée, les informations relatives à ce type d'instance ne sont pas interrogées.

    MinimumGPUAmount

    Integer

    Non

    3

    Nombre minimal de GPU. La valeur doit être un entier positif.

    Remarque

    Si un type d'instance propose moins de GPU que la valeur spécifiée, les informations relatives à ce type d'instance ne sont pas interrogées.

    MaximumGPUAmount

    Integer

    Non

    10

    Nombre maximal de GPU. La valeur doit être un entier positif.

    Remarque

    Si un type d'instance propose plus de GPU que la valeur spécifiée, les informations relatives à ce type d'instance ne sont pas interrogées.

    GPUSpec

    String

    Non

    NVIDIA V100

    Modèle de GPU.

    Remarque

    La correspondance floue est prise en charge. Par exemple, si un type d'instance utilise des GPU NVIDIA V100 et que vous définissez ce paramètre sur NVIDIA, les informations relatives à ce type d'instance seront interrogées.

    InstanceCategory

    String

    Non

    Big data

    Catégorie du type d'instance. Valeurs valides :

    • Usage général

    • Optimisé pour le calcul

    • Optimisé pour la mémoire

    • Big data

    • SSD locaux

    • Fréquence d'horloge élevée

    • Amélioré

    • Partagé

    • Optimisé pour le calcul avec GPU

    • Optimisé pour le calcul visuel

    • Service hétérogène

    • Optimisé pour le calcul avec FPGA

    • Optimisé pour le calcul avec NPU

    • ECS Bare Metal

    • Cluster de supercalcul

    • Calcul haute performance

    CpuArchitecture

    String

    Non

    X86

    Architecture CPU. Valeurs valides :

    • X86

    • ARM

    MinimumCpuSpeedFrequency

    Float

    Non

    2.5

    Fréquence d'horloge minimale.

    Remarque

    Si un type d'instance utilise des processeurs dont la fréquence d'horloge est inférieure à la valeur spécifiée, les informations relatives à ce type d'instance ne sont pas interrogées.

    MaximumCpuSpeedFrequency

    Float

    Non

    3.2

    Fréquence d'horloge maximale.

    Remarque

    Si un type d'instance utilise des processeurs dont la fréquence d'horloge est supérieure à la valeur spécifiée, les informations relatives à ce type d'instance ne sont pas interrogées.

    MinimumCpuTurboFrequency

    Float

    Non

    3.2

    Fréquence Turbo minimale.

    Remarque

    Si un type d'instance utilise des processeurs offrant une fréquence Turbo inférieure à la valeur spécifiée, les informations relatives à ce type d'instance ne sont pas interrogées.

    MaximumCpuTurboFrequency

    Float

    Non

    4.1

    Fréquence Turbo maximale.

    Remarque

    Si un type d'instance utilise des processeurs offrant une fréquence Turbo supérieure à la valeur spécifiée, les informations relatives à ce type d'instance ne sont pas interrogées.

    PhysicalProcessorModel

    String

    Non

    Intel Xeon(Ice Lake) Platinum 8369B

    Modèle de CPU.

    Remarque

    La correspondance floue est prise en charge. Par exemple, si un type d'instance utilise des processeurs Intel Xeon (Ice Lake) Platinum 8369B et que vous définissez ce paramètre sur Intel, les informations relatives à ce type d'instance seront interrogées.

    InstanceFamilyLevel

    String

    Non

    EntryLevel

    Niveau de la famille d'instances. Valeurs valides :

    • EntryLevel : partagé

    • EnterpriseLevel

    • CreditEntryLevel

    MinimumInstancePpsRx

    Long

    Non

    15

    Débit minimal de transfert de paquets entrants sur le réseau interne. Unité : pps.

    Remarque

    Si un type d'instance offre un débit de transfert de paquets entrants sur le réseau interne inférieur à la valeur spécifiée, les informations relatives à ce type d'instance ne sont pas interrogées.

    MinimumInstancePpsTx

    Long

    Non

    15

    Débit minimal de transfert de paquets sortants sur le réseau interne. Unité : pps.

    Remarque

    Si un type d'instance offre un débit de transfert de paquets sortants sur le réseau interne inférieur à la valeur spécifiée, les informations relatives à ce type d'instance ne sont pas interrogées.

    MinimumInstanceBandwidthRx

    Integer

    Non

    12288

    Bande passante interne entrante minimale. Unité : Kbit/s.

    Remarque

    Si un type d'instance offre une bande passante interne entrante inférieure à la valeur spécifiée, les informations relatives à ce type d'instance ne sont pas interrogées.

    MinimumInstanceBandwidthTx

    Integer

    Non

    12288

    Bande passante interne sortante minimale. Unité : Kbit/s.

    Remarque

    Si un type d'instance offre une bande passante interne sortante inférieure à la valeur spécifiée, les informations relatives à ce type d'instance ne sont pas interrogées.

    MinimumPrimaryEniQueueNumber

    Integer

    Non

    8

    Nombre minimal par défaut de files d'attente par interface réseau élastique (ENI) principale.

    Remarque

    Si un type d'instance prend en charge moins de files d'attente par ENI principale que la valeur spécifiée, les informations relatives à ce type d'instance ne sont pas interrogées.

    MinimumSecondaryEniQueueNumber

    Integer

    Non

    4

    Nombre minimal par défaut de files d'attente par ENI secondaire.

    Remarque

    Si un type d'instance prend en charge moins de files d'attente par ENI secondaire que la valeur spécifiée, les informations relatives à ce type d'instance ne sont pas interrogées.

    MinimumEniQuantity

    Integer

    Non

    4

    Nombre minimal d'ENI par instance.

    Remarque

    Si un type d'instance prend en charge moins d'ENI que la valeur spécifiée, les informations relatives à ce type d'instance ne sont pas interrogées.

    MinimumQueuePairNumber

    Integer

    Non

    8

    Nombre minimal de paires de files d'attente (QP) par interface RDMA élastique (ERI).

    Remarque

    Si un type d'instance prend en charge moins de QP par ERI que la valeur spécifiée, les informations relatives à ce type d'instance ne sont pas interrogées.

    MinimumEriQuantity

    Integer

    Non

    0

    Nombre minimal d'ERI par instance.

    Remarque

    Si un type d'instance prend en charge moins d'ERI que la valeur spécifiée, les informations relatives à ce type d'instance ne sont pas interrogées.

    MinimumEniPrivateIpAddressQuantity

    Integer

    Non

    2

    Nombre minimal d'adresses IPv4 par ENI.

    Remarque

    Si un type d'instance prend en charge moins d'adresses IPv4 par ENI que la valeur spécifiée, les informations relatives à ce type d'instance ne sont pas interrogées.

    MinimumEniIpv6AddressQuantity

    Integer

    Non

    2

    Nombre minimal d'adresses IPv6 par ENI.

    Remarque

    Si un type d'instance prend en charge moins d'adresses IPv6 par ENI que la valeur spécifiée, les informations relatives à ce type d'instance ne sont pas interrogées.

    MinimumLocalStorageAmount

    Integer

    Non

    4

    Nombre minimal de disques locaux par instance.

    Remarque

    Si un type d'instance prend en charge moins de disques locaux que la valeur spécifiée, les informations relatives à ce type d'instance ne sont pas interrogées.

    MinimumLocalStorageCapacity

    Long

    Non

    40

    Capacité de chaque disque local attaché par instance. Unité : GiB.

    MinimumDiskQuantity

    Integer

    Non

    4

    Nombre minimal de disques cloud par instance.

    Remarque

    Si un type d'instance prend en charge moins de disques cloud que la valeur spécifiée, les informations relatives à ce type d'instance ne sont pas interrogées.

    LocalStorageCategory

    String

    Non

    local_ssd_pro

    Catégorie des disques locaux. Pour plus d'informations, consultez Disques locaux. Valeurs valides :

    • local_hdd_pro : disques HDD SATA locaux, utilisés par les instances d1ne ou d1

    • local_ssd_pro : disques SSD NVMe locaux, utilisés par les instances i2, i2g, i1, ga1 ou gn5

    NvmeSupport

    String

    Non

    required

    Indique si les disques cloud peuvent être attachés via le protocole NVMe. Valeurs valides :

    • required : le disque cloud peut être attaché via le protocole NVMe.

    • unsupported : le disque cloud ne peut pas être attaché via le protocole NVMe.

    MinimumBaselineCredit

    Integer

    Non

    12

    Performance de calcul de base minimale des vCPU (performance globale de base de toutes les vCPU) pour une instance à rafale t5 ou t6.

    Remarque

    Si un type d'instance t5 ou t6 offre une performance de calcul de base des vCPU inférieure à la valeur spécifiée, les informations relatives à ce type d'instance ne sont pas interrogées.

    MinimumInitialCredit

    Integer

    Non

    12

    Crédits vCPU initiaux minimaux pour une instance à rafale t5 ou t6.

    Remarque

    Si un type d'instance t5 ou t6 offre moins de crédits vCPU initiaux que la valeur spécifiée, les informations relatives à ce type d'instance ne sont pas interrogées.

    MaxResults

    Long

    Non

    10

    Nombre d'entrées par page. Valeur maximale : 1 600.

    Valeur par défaut : 1 600.

    NextToken

    String

    Non

    e71d8a535bd9cc11

    Jeton de pagination utilisé dans la requête suivante pour récupérer une nouvelle page de résultats. Vous n'avez pas besoin de spécifier ce paramètre lors de la première requête. Vous devez indiquer le jeton obtenu lors de la requête précédente comme valeur pour NextToken.

    Paramètres de réponse

    Paramètre

    Type

    Exemple

    Description

    RequestId

    String

    00827261-20B7-4562-83F2-4DF39876A45A

    ID de la requête.

    InstanceTypes

    Array of InstanceType

    Détails relatifs aux types d'instance.

    InstanceType

    EniTotalQuantity

    Integer

    0

    Nombre maximal d'ENI, y compris les ENI principales, secondaires et trunk.

    Remarque

    Ce paramètre est en aperçu sur invitation et n'est pas disponible publiquement.

    LocalStorageCategory

    String

    local_ssd_pro

    Catégorie des disques locaux. Pour plus d'informations, consultez Disques locaux. Valeurs valides :

    • local_hdd_pro : disques HDD SATA locaux, utilisés par les instances d1ne ou d1

    • local_ssd_pro : disques SSD NVMe locaux, utilisés par les instances i2, i2g, i1, ga1 ou gn5

    PrimaryEniQueueNumber

    Integer

    4

    Nombre par défaut de files d'attente par ENI principale.

    MemorySize

    Float

    16

    Taille de la mémoire. Unité : GiB.

    LocalStorageCapacity

    Long

    5000

    Capacité de chaque disque local. Unité : GiB.

    InstanceFamilyLevel

    String

    EnterpriseLevel

    Niveau de la famille d'instances. Valeurs valides :

    • EntryLevel : partagé

    • EnterpriseLevel

    • CreditEntryLevel

    Pour plus d'informations, consultez Présentation.

    InstancePpsRx

    Long

    500000

    Débit de transfert de paquets entrants sur le réseau interne. Unité : pps.

    EniIpv6AddressQuantity

    Integer

    1

    Nombre maximal d'adresses IPv6 par ENI.

    MaximumQueueNumberPerEni

    Integer

    4

    Nombre maximal de files d'attente par ENI. L'ENI peut être principale ou secondaire.

    InstanceTypeId

    String

    ecs.g6.large

    ID du type d'instance.

    InstanceBandwidthRx

    Integer

    1024000

    Bande passante interne entrante maximale. Unité : Kbit/s.

    SecondaryEniQueueNumber

    Integer

    4

    Nombre par défaut de files d'attente par ENI secondaire.

    GPUSpec

    String

    NVIDIA V100

    Modèle de GPU.

    InstanceBandwidthTx

    Integer

    1024000

    Bande passante interne sortante maximale. Unité : Kbit/s.

    QueuePairNumber

    Integer

    22

    Nombre maximal de QP par ERI.

    EriQuantity

    Integer

    0

    Nombre d'ERI.

    Remarque

    Ce paramètre est en aperçu sur invitation et n'est pas disponible publiquement.

    GPUAmount

    Integer

    0

    Nombre de GPU.

    TotalEniQueueQuantity

    Integer

    12

    Nombre maximal de files d'attente sur les ENI prises en charge par le type d'instance.

    NvmeSupport

    String

    unsupported

    Indique si le disque cloud peut être attaché via le protocole NVMe. Valeurs valides :

    • required : le disque cloud peut être attaché via le protocole NVMe.

    • unsupported : le disque cloud ne peut pas être attaché via le protocole NVMe.

    DiskQuantity

    Integer

    17

    Nombre maximal de disques cloud par instance.

    InitialCredit

    Integer

    120

    Crédits vCPU initiaux pour une instance à rafale t5 ou t6.

    LocalStorageAmount

    Integer

    1

    Nombre de disques locaux par instance.

    BaselineCredit

    Integer

    4

    Performance de calcul de base des vCPU (performance globale de toutes les vCPU) pour l'instance à rafale t5 ou t6.

    InstancePpsTx

    Long

    500000

    Débit de transfert de paquets sortants sur le réseau interne. Unité : pps.

    EniPrivateIpAddressQuantity

    Integer

    10

    Nombre maximal d'adresses IPv4 par ENI.

    CpuCoreCount

    Integer

    4

    Nombre de vCPU.

    InstanceTypeFamily

    String

    ecs.g6

    Famille d'instances.

    EniQuantity

    Integer

    3

    Nombre maximal d'ENI.

    EniTrunkSupported

    Boolean

    true

    Indique si les ENI trunk sont prises en charge.

    Remarque

    Ce paramètre est en aperçu sur invitation et n'est pas disponible publiquement.

    CpuSpeedFrequency

    Float

    2.7

    Fréquence de base du CPU. Unité : GHz.

    CpuTurboFrequency

    Float

    3.5

    Fréquence Turbo du CPU. Unité : GHz.

    PhysicalProcessorModel

    String

    Intel Xeon(Ice Lake) Platinum 8369B

    Modèle de CPU.

    NetworkEncryptionSupport

    Boolean

    true

    Indique si le chiffrement du trafic réseau transmis via les réseaux privés virtuels (VPC) est autorisé. Valeurs valides :

    • true

    • false

    InstanceCategory

    String

    Big data

    Catégorie du type d'instance. Valeurs valides :

    • Usage général

    • Optimisé pour le calcul

    • Optimisé pour la mémoire

    • Big data

    • SSD locaux

    • Fréquence d'horloge élevée

    • Amélioré

    • Partagé

    • Optimisé pour le calcul avec GPU

    • Optimisé pour le calcul visuel

    • Service hétérogène

    • Optimisé pour le calcul avec FPGA

    • Optimisé pour le calcul avec NPU

    • ECS Bare Metal

    • Cluster de supercalcul

    • Calcul haute performance

    CpuArchitecture

    String

    X86

    Architecture CPU. Valeurs valides :

    • X86

    • ARM

    GPUMemorySize

    Float

    32

    Taille de la mémoire par GPU. Unité : GiB.

    NetworkCardQuantity

    Integer

    1

    Nombre maximal de cartes réseau prises en charge par le type d'instance.

    NetworkCards

    Array of NetworkCardInfo

    Détails relatifs aux cartes réseau.

    NetworkCardInfo

    NetworkCardIndex

    Integer

    1

    Index de la carte réseau.

    NextToken

    String

    e71d8a535bd9cc11

    Jeton de requête renvoyé lors de cet appel.

    Exemples

    Exemple de requête

    https://ecs.aliyuncs.com/?Action=DescribeInstanceTypes
&InstanceTypeFamily=ecs.g6
&InstanceTypes.1=ecs.g6.large
&<Common request parameters>

    Exemple de réponse réussie

    XML format

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

<DescribeInstanceTypesResponse>
    <RequestId>00827261-20B7-4562-83F2-4DF39876A45A</RequestId>
    <NextToken/>
    <InstanceTypes>
        <InstanceType>
            <InstancePpsTx>500000</InstancePpsTx>
            <NvmeSupport>unsupported</NvmeSupport>
            <PrimaryEniQueueNumber>4</PrimaryEniQueueNumber>
            <TotalEniQueueQuantity>12</TotalEniQueueQuantity>
            <EniTrunkSupported>true</EniTrunkSupported>
            <InstanceTypeFamily>ecs.g6</InstanceTypeFamily>
            <InstancePpsRx>500000</InstancePpsRx>
            <EriQuantity>0</EriQuantity>
            <InstanceBandwidthRx>1024000</InstanceBandwidthRx>
            <InstanceBandwidthTx>1024000</InstanceBandwidthTx>
            <SecondaryEniQueueNumber>4</SecondaryEniQueueNumber>
            <LocalStorageCategory/>
            <GPUSpec/>
            <InstanceTypeId>ecs.g6.xlarge</InstanceTypeId>
            <MemorySize>16</MemorySize>
            <MaximumQueueNumberPerEni>4</MaximumQueueNumberPerEni>
            <EniIpv6AddressQuantity>1</EniIpv6AddressQuantity>
            <EniTotalQuantity>5</EniTotalQuantity>
            <CpuCoreCount>4</CpuCoreCount>
            <EniQuantity>3</EniQuantity>
            <GPUAmount>0</GPUAmount>
            <DiskQuantity>17</DiskQuantity>
            <QueuePairNumber>22</QueuePairNumber>
            <InstanceFamilyLevel>EnterpriseLevel</InstanceFamilyLevel>
            <EniPrivateIpAddressQuantity>10</EniPrivateIpAddressQuantity>
            <CpuSpeedFrequency>2.7</CpuSpeedFrequency>
            <CpuTurboFrequency>3.5</CpuTurboFrequency>
            <PhysicalProcessorModel>Intel Xeon(Ice Lake) Platinum 8369B</PhysicalProcessorModel>
            <InitialCredit>120</InitialCredit>
        </InstanceType>
    </InstanceTypes>
</DescribeInstanceTypesResponse>

    JSON format

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

{
  "RequestId" : "00827261-20B7-4562-83F2-4DF39876A45A",
  "NextToken" : "",
  "InstanceTypes" : {
    "InstanceType" : [ {
      "InstancePpsTx" : 500000,
      "NvmeSupport" : "unsupported",
      "PrimaryEniQueueNumber" : 4,
      "TotalEniQueueQuantity" : 12,
      "EniTrunkSupported" : true,
      "InstanceTypeFamily" : "ecs.g6",
      "InstancePpsRx" : 500000,
      "EriQuantity" : 0,
      "InstanceBandwidthRx" : 1024000,
      "InstanceBandwidthTx" : 1024000,
      "SecondaryEniQueueNumber" : 4,
      "LocalStorageCategory" : "",
      "GPUSpec" : "",
      "InstanceTypeId" : "ecs.g6.xlarge",
      "MemorySize" : 16,
      "MaximumQueueNumberPerEni" : 4,
      "EniIpv6AddressQuantity" : 1,
      "EniTotalQuantity" : 5,
      "CpuCoreCount" : 4,
      "EniQuantity" : 3,
      "GPUAmount" : 0,
      "DiskQuantity" : 17,
      "QueuePairNumber" : 22,
      "InstanceFamilyLevel" : "EnterpriseLevel",
      "EniPrivateIpAddressQuantity" : 10,
      "CpuSpeedFrequency" : 2.7,
      "CpuTurboFrequency" : 3.5,
      "PhysicalProcessorModel" : "Intel Xeon(Ice Lake) Platinum 8369B",
      "InitialCredit" : "120"
    } ]
  }
}

    Codes d'erreur

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