Todos os produtos
Search

Este produto

    :DescribeInstanceTypes

    Central de documentação

    :DescribeInstanceTypes

    Última atualização: Jul 03, 2026

    Consulta os detalhes de todos os tipos de instância ou de um tipo específico fornecido pelo Elastic Compute Service (ECS).

    Observações de uso

    Atente-se aos seguintes pontos:

    • O parâmetro MaxResults define o número máximo de entradas retornadas por página. O valor máximo deste parâmetro foi alterado de 1600 para 100. Se você chamou esta operação em 2022, pode continuar usando 1600 como valor máximo do MaxResults até 15 de novembro de 2023. A partir de 15 de novembro de 2023, apenas 100 poderá ser usado como valor máximo. Se você não configurar o parâmetro NextToken ao chamar a operação DescribeInstanceTypes, somente a primeira página de resultados, contendo até 100 entradas, será retornada. Para recuperar mais resultados, configure o parâmetro NextToken para executar consultas paginadas ou especifique condições de filtro para limitar os resultados.

    • Recomenda-se especificar MaxResults e NextToken para realizar consultas paginadas. Na primeira chamada à operação DescribeInstanceTypes, defina MaxResults para limitar o número máximo de entradas retornadas. Se a quantidade total de entradas exceder o valor definido em MaxResults, a resposta incluirá um valor de NextToken. Utilize esse valor retornado como NextToken e mantenha o MaxResults na próxima solicitação à operação DescribeInstanceTypes para obter a página seguinte de resultados.

    • A operação DescribeInstanceTypes serve exclusivamente para consultar especificações e informações de desempenho dos tipos de instância. Para verificar quais tipos de instância estão disponíveis em uma região específica, chame a operação DescribeAvailableResource.

    • Para usar tipos de instância especiais, como aqueles indisponíveis para compra, envie um ticket.

    Depuração

    O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

    Parâmetros de solicitação

    Parâmetro

    Tipo

    Obrigatório

    Exemplo

    Descrição

    Action

    String

    Sim

    DescribeInstanceTypes

    A operação a ser executada. Defina o valor como DescribeInstanceTypes.

    InstanceTypeFamily

    String

    Não

    ecs.g6

    Família de instâncias à qual o tipo pertence. Para informações sobre os valores válidos deste parâmetro, consulte DescribeInstanceTypeFamilies.

    Para mais detalhes sobre famílias de instâncias, veja Famílias de instâncias.

    InstanceTypes.N

    String

    Não

    ecs.g6.large

    Tipo de instância N. Valores válidos de N: 1 a 10. Se este parâmetro for deixado vazio, as informações de todos os tipos de instância serão consultadas.

    MinimumCpuCoreCount

    Integer

    Não

    2

    Número mínimo de vCPUs. O valor deve ser um inteiro positivo.

    Nota

    Se o número de vCPUs de um tipo de instância for menor que o valor especificado, as informações desse tipo não serão retornadas.

    MaximumCpuCoreCount

    Integer

    Não

    10

    Número máximo de vCPUs. O valor deve ser um inteiro positivo.

    Nota

    Se o número de vCPUs de um tipo de instância for maior que o valor especificado, as informações desse tipo não serão retornadas.

    MinimumMemorySize

    Float

    Não

    20

    Tamanho mínimo de memória. Unidade: GiB.

    Nota

    Se o tamanho de memória de um tipo de instância for menor que o valor especificado, as informações desse tipo não serão retornadas.

    MaximumMemorySize

    Float

    Não

    60

    Tamanho máximo de memória. Unidade: GiB.

    Nota

    Se o tamanho de memória de um tipo de instância for maior que o valor especificado, as informações desse tipo não serão retornadas.

    MinimumGPUAmount

    Integer

    Não

    3

    Número mínimo de GPUs. O valor deve ser um inteiro positivo.

    Nota

    Se um tipo de instância oferecer menos GPUs do que o valor especificado, suas informações não serão retornadas.

    MaximumGPUAmount

    Integer

    Não

    10

    Número máximo de GPUs. O valor deve ser um inteiro positivo.

    Nota

    Se um tipo de instância oferecer mais GPUs do que o valor especificado, suas informações não serão retornadas.

    GPUSpec

    String

    Não

    NVIDIA V100

    Modelo da GPU.

    Nota

    Há suporte para correspondência parcial. Por exemplo, se um tipo de instância possui GPUs NVIDIA V100 e você definir este parâmetro como NVIDIA, as informações desse tipo serão retornadas.

    InstanceCategory

    String

    Não

    Big data

    Categoria do tipo de instância. Valores válidos:

    • Uso geral

    • Otimizada para computação

    • Otimizada para memória

    • Big data

    • SSDs locais

    • Alta frequência de clock

    • Aprimorada

    • Compartilhada

    • Otimizada para computação com GPU

    • Computação visual otimizada

    • Serviço heterogêneo

    • Otimizada para computação com FPGA

    • Otimizada para computação com NPU

    • ECS Bare Metal

    • Super Computing Cluster

    • High Performance Compute

    CpuArchitecture

    String

    Não

    X86

    Arquitetura da CPU. Valores válidos:

    • X86

    • ARM

    MinimumCpuSpeedFrequency

    Float

    Não

    2.5

    Velocidade mínima de clock.

    Nota

    Se um tipo de instância utilizar processadores com velocidade de clock inferior ao valor especificado, suas informações não serão retornadas.

    MaximumCpuSpeedFrequency

    Float

    Não

    3.2

    Velocidade máxima de clock.

    Nota

    Se um tipo de instância utilizar processadores com velocidade de clock superior ao valor especificado, suas informações não serão retornadas.

    MinimumCpuTurboFrequency

    Float

    Não

    3.2

    Frequência turbo mínima.

    Nota

    Se um tipo de instância utilizar processadores com frequência turbo inferior ao valor especificado, suas informações não serão retornadas.

    MaximumCpuTurboFrequency

    Float

    Não

    4.1

    Frequência turbo máxima.

    Nota

    Se um tipo de instância utilizar processadores com frequência turbo superior ao valor especificado, suas informações não serão retornadas.

    PhysicalProcessorModel

    String

    Não

    Intel Xeon(Ice Lake) Platinum 8369B

    Modelo da CPU.

    Nota

    Há suporte para correspondência parcial. Por exemplo, se um tipo de instância usa processadores Intel Xeon (Ice Lake) Platinum 8369B e você definir este parâmetro como Intel, as informações desse tipo serão retornadas.

    InstanceFamilyLevel

    String

    Não

    EntryLevel

    Nível da família de instâncias. Valores válidos:

    • EntryLevel: compartilhada

    • EnterpriseLevel

    • CreditEntryLevel

    MinimumInstancePpsRx

    Long

    Não

    15

    Taxa mínima de encaminhamento de pacotes de entrada na rede interna. Unidade: pps.

    Nota

    Se um tipo de instância oferecer uma taxa de encaminhamento de pacotes de entrada na rede interna inferior ao valor especificado, suas informações não serão retornadas.

    MinimumInstancePpsTx

    Long

    Não

    15

    Taxa mínima de encaminhamento de pacotes de saída na rede interna. Unidade: pps.

    Nota

    Se um tipo de instância oferecer uma taxa de encaminhamento de pacotes de saída na rede interna inferior ao valor especificado, suas informações não serão retornadas.

    MinimumInstanceBandwidthRx

    Integer

    Não

    12288

    Largura de banda interna mínima de entrada. Unidade: Kbit/s.

    Nota

    Se um tipo de instância oferecer uma largura de banda interna de entrada inferior ao valor especificado, suas informações não serão retornadas.

    MinimumInstanceBandwidthTx

    Integer

    Não

    12288

    Largura de banda interna mínima de saída. Unidade: Kbit/s.

    Nota

    Se um tipo de instância oferecer uma largura de banda interna de saída inferior ao valor especificado, suas informações não serão retornadas.

    MinimumPrimaryEniQueueNumber

    Integer

    Não

    8

    Número mínimo padrão de filas por interface de rede elástica (ENI) primária.

    Nota

    Se um tipo de instância suportar menos filas por ENI primária do que o valor especificado, suas informações não serão retornadas.

    MinimumSecondaryEniQueueNumber

    Integer

    Não

    4

    Número mínimo padrão de filas por ENI secundária.

    Nota

    Se um tipo de instância suportar menos filas por ENI secundária do que o valor especificado, suas informações não serão retornadas.

    MinimumEniQuantity

    Integer

    Não

    4

    Número mínimo de ENIs por instância.

    Nota

    Se um tipo de instância suportar menos ENIs do que o valor especificado, suas informações não serão retornadas.

    MinimumQueuePairNumber

    Integer

    Não

    8

    Número mínimo de pares de filas (QPs) por interface RDMA elástica (ERI).

    Nota

    Se um tipo de instância suportar menos QPs por ERI do que o valor especificado, suas informações não serão retornadas.

    MinimumEriQuantity

    Integer

    Não

    0

    Número mínimo de ERIs por instância.

    Nota

    Se um tipo de instância suportar menos ERIs do que o valor especificado, suas informações não serão retornadas.

    MinimumEniPrivateIpAddressQuantity

    Integer

    Não

    2

    Número mínimo de endereços IPv4 por ENI.

    Nota

    Se um tipo de instância suportar menos endereços IPv4 por ENI do que o valor especificado, suas informações não serão retornadas.

    MinimumEniIpv6AddressQuantity

    Integer

    Não

    2

    Número mínimo de endereços IPv6 por ENI.

    Nota

    Se um tipo de instância suportar menos endereços IPv6 por ENI do que o valor especificado, suas informações não serão retornadas.

    MinimumLocalStorageAmount

    Integer

    Não

    4

    Número mínimo de discos locais por instância.

    Nota

    Se um tipo de instância suportar menos discos locais do que o valor especificado, suas informações não serão retornadas.

    MinimumLocalStorageCapacity

    Long

    Não

    40

    Capacidade de cada disco local anexado por instância. Unidade: GiB.

    MinimumDiskQuantity

    Integer

    Não

    4

    Número mínimo de discos em nuvem por instância.

    Nota

    Se um tipo de instância suportar menos discos em nuvem do que o valor especificado, suas informações não serão retornadas.

    LocalStorageCategory

    String

    Não

    local_ssd_pro

    Categoria dos discos locais. Para mais informações, consulte Discos locais. Valores válidos:

    • local_hdd_pro: HDDs SATA (Serial Advanced Technology Attachment) locais, usados por instâncias d1ne ou d1

    • local_ssd_pro: SSDs NVMe (Non-Volatile Memory Express) locais, usados por instâncias i2, i2g, i1, ga1 ou gn5

    NvmeSupport

    String

    Não

    required

    Indica se discos em nuvem podem ser anexados usando o protocolo NVMe. Valores válidos:

    • required: O disco em nuvem pode ser anexado usando o protocolo NVMe.

    • unsupported: O disco em nuvem não pode ser anexado usando o protocolo NVMe.

    MinimumBaselineCredit

    Integer

    Não

    12

    Desempenho mínimo de computação de vCPU de linha de base (desempenho geral de linha de base de todas as vCPUs) de uma instância expansível t5 ou t6.

    Nota

    Se um tipo de instância t5 ou t6 oferecer desempenho de computação de vCPU de linha de base inferior ao valor especificado, suas informações não serão retornadas.

    MinimumInitialCredit

    Integer

    Não

    12

    Créditos iniciais mínimos de vCPU de uma instância expansível t5 ou t6.

    Nota

    Se um tipo de instância t5 ou t6 oferecer menos créditos iniciais de vCPU do que o valor especificado, suas informações não serão retornadas.

    MaxResults

    Long

    Não

    10

    Número de entradas por página. Valor máximo: 1600.

    Valor padrão: 1600.

    NextToken

    String

    Não

    e71d8a535bd9cc11

    Token de paginação usado na próxima solicitação para recuperar uma nova página de resultados. Não é necessário especificar este parâmetro na primeira solicitação. Você deve definir o token obtido na consulta anterior como o valor de NextToken.

    Parâmetros de resposta

    Parâmetro

    Tipo

    Exemplo

    Descrição

    RequestId

    String

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

    ID da solicitação.

    InstanceTypes

    Array of InstanceType

    Detalhes sobre os tipos de instância.

    InstanceType

    EniTotalQuantity

    Integer

    0

    Número máximo de ENIs, incluindo ENIs primárias, secundárias e trunk.

    Nota

    Este parâmetro está em prévia por convite e não está disponível publicamente.

    LocalStorageCategory

    String

    local_ssd_pro

    Categoria dos discos locais. Para mais informações, consulte Discos locais. Valores válidos:

    • local_hdd_pro: HDDs SATA locais, usados por instâncias d1ne ou d1

    • local_ssd_pro: SSDs NVMe locais, usados por instâncias i2, i2g, i1, ga1 ou gn5

    PrimaryEniQueueNumber

    Integer

    4

    Número padrão de filas por ENI primária.

    MemorySize

    Float

    16

    Tamanho da memória. Unidade: GiB.

    LocalStorageCapacity

    Long

    5000

    Capacidade de cada disco local. Unidade: GiB.

    InstanceFamilyLevel

    String

    EnterpriseLevel

    Nível da família de instâncias. Valores válidos:

    • EntryLevel: compartilhada

    • EnterpriseLevel

    • CreditEntryLevel

    Para mais informações, consulte Visão geral.

    InstancePpsRx

    Long

    500000

    Taxa de encaminhamento de pacotes de entrada na rede interna. Unidade: pps.

    EniIpv6AddressQuantity

    Integer

    1

    Número máximo de endereços IPv6 por ENI.

    MaximumQueueNumberPerEni

    Integer

    4

    Número máximo de filas por ENI. A ENI pode ser primária ou secundária.

    InstanceTypeId

    String

    ecs.g6.large

    ID do tipo de instância.

    InstanceBandwidthRx

    Integer

    1024000

    Largura de banda interna máxima de entrada. Unidade: Kbit/s.

    SecondaryEniQueueNumber

    Integer

    4

    Número padrão de filas por ENI secundária.

    GPUSpec

    String

    NVIDIA V100

    Modelo da GPU.

    InstanceBandwidthTx

    Integer

    1024000

    Largura de banda interna máxima de saída. Unidade: Kbit/s.

    QueuePairNumber

    Integer

    22

    Número máximo de QPs por ERI.

    EriQuantity

    Integer

    0

    Número de ERIs.

    Nota

    Este parâmetro está em prévia por convite e não está disponível publicamente.

    GPUAmount

    Integer

    0

    Número de GPUs.

    TotalEniQueueQuantity

    Integer

    12

    Número máximo de filas nas ENIs suportadas pelo tipo de instância.

    NvmeSupport

    String

    unsupported

    Indica se o disco em nuvem pode ser anexado usando o protocolo NVMe. Valores válidos:

    • required: O disco em nuvem pode ser anexado usando o protocolo NVMe.

    • unsupported: O disco em nuvem não pode ser anexado usando o protocolo NVMe.

    DiskQuantity

    Integer

    17

    Número máximo de discos em nuvem por instância.

    InitialCredit

    Integer

    120

    Créditos iniciais de vCPU de uma instância expansível t5 ou t6.

    LocalStorageAmount

    Integer

    1

    Número de discos locais por instância.

    BaselineCredit

    Integer

    4

    Desempenho de computação de vCPU de linha de base (desempenho geral de todas as vCPUs) da instância expansível t5 ou t6.

    InstancePpsTx

    Long

    500000

    Taxa de encaminhamento de pacotes de saída na rede interna. Unidade: pps.

    EniPrivateIpAddressQuantity

    Integer

    10

    Número máximo de endereços IPv4 por ENI.

    CpuCoreCount

    Integer

    4

    Número de vCPUs.

    InstanceTypeFamily

    String

    ecs.g6

    Família de instâncias.

    EniQuantity

    Integer

    3

    Número máximo de ENIs.

    EniTrunkSupported

    Boolean

    true

    Indica se há suporte para ENIs trunk.

    Nota

    Este parâmetro está em prévia por convite e não está disponível publicamente.

    CpuSpeedFrequency

    Float

    2.7

    Frequência base da CPU. Unidade: GHz.

    CpuTurboFrequency

    Float

    3.5

    Frequência turbo da CPU. Unidade: GHz.

    PhysicalProcessorModel

    String

    Intel Xeon(Ice Lake) Platinum 8369B

    Modelo da CPU.

    NetworkEncryptionSupport

    Boolean

    true

    Indica se é permitido criptografar o tráfego de rede transmitido por redes privadas virtuais (VPCs). Valores válidos:

    • true

    • false

    InstanceCategory

    String

    Big data

    Categoria do tipo de instância. Valores válidos:

    • Uso geral

    • Otimizada para computação

    • Otimizada para memória

    • Big data

    • SSDs locais

    • Alta frequência de clock

    • Aprimorada

    • Compartilhada

    • Otimizada para computação com GPU

    • Computação visual otimizada

    • Serviço heterogêneo

    • Otimizada para computação com FPGA

    • Otimizada para computação com NPU

    • ECS Bare Metal

    • Super Computing Cluster

    • High Performance Compute

    CpuArchitecture

    String

    X86

    Arquitetura da CPU. Valores válidos:

    • X86

    • ARM

    GPUMemorySize

    Float

    32

    Tamanho de memória por GPU. Unidade: GiB.

    NetworkCardQuantity

    Integer

    1

    Número máximo de placas de rede suportadas pelo tipo de instância.

    NetworkCards

    Array of NetworkCardInfo

    Detalhes sobre as placas de rede.

    NetworkCardInfo

    NetworkCardIndex

    Integer

    1

    Índice da placa de rede.

    NextToken

    String

    e71d8a535bd9cc11

    Token de consulta retornado nesta chamada.

    Exemplos

    Exemplos de solicitações

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

    Exemplos de respostas de sucesso

    Formato XML

    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>

    Formato JSON

    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"
    } ]
  }
}

    Códigos de erro

    Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.