Todos os produtos
Search
Central de documentação

:DescribeInstanceTypeFamilies

Última atualização: Jul 03, 2026

Consulta as famílias de instâncias do Elastic Compute Service (ECS).

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar esta operação no OpenAPI Explorer, que gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros de solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action String Sim DescribeInstanceTypeFamilies

Operação a ser executada. Defina o valor como DescribeInstanceTypeFamilies.

RegionId String Sim cn-hangzhou

ID da região da família de instâncias. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.

Generation String Não ecs-5

Geração da família de instâncias. Para obter mais informações, consulte Visão geral das famílias de instâncias. Valores válidos:

  • ecs-1: Geração I. Tipos de instância mais antigos e econômicos.
  • ecs-2: Geração II. Hardware e software atualizados com desempenho superior ao da Geração I.
  • ecs-3: Geração III. Famílias de instâncias de alto desempenho adequadas para diversos cenários de negócios.
  • ecs-4: Geração IV. Inclui famílias de instâncias de nível empresarial (como g5, c5 e r5), famílias de ECS Bare Metal Instance (como ebmc5s, ebmg5s e ebmr5s) e famílias de instâncias com capacidade de pico (como t5). Atende a uma ampla variedade de requisitos de negócios com menor latência.
  • ecs-5: Geração V. Reúne famílias de instâncias de nível empresarial (como g6, c6 e r6), famílias de ECS Bare Metal Instance (como ebmg6, ebmg6e e ebmc6) e famílias de instâncias otimizadas para armazenamento (como g6e). Proporciona tempos de resposta rápidos e maior desempenho.
  • ecs-6: Geração VI. Abrange famílias de instâncias de nível empresarial (como hfc7, hfg7 e hfr7) e famílias de ECS Bare Metal Instance (como ebmhfg7). Disponível em visualização restrita.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

ID da solicitação.

InstanceTypeFamilies

Array of InstanceTypeFamily

Famílias de instâncias.

InstanceTypeFamily

Generation

String

ecs-5

Geração da família de instâncias.

InstanceTypeFamilyId

String

ecs.g6

ID da família de instâncias.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=DescribeInstanceTypeFamilies
&RegionId=cn-hangzhou
&Generation=ecs-5
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<DescribeInstanceTypeFamiliesResponse>
    <InstanceTypeFamilies>
        <InstanceTypeFamily>
            <InstanceTypeFamilyId>ecs.g6</InstanceTypeFamilyId>
            <Generation>ecs-5</Generation>
        </InstanceTypeFamily>
        <InstanceTypeFamily>
            <InstanceTypeFamilyId>ecs.ebmg6</InstanceTypeFamilyId>
            <Generation>ecs-5</Generation>
        </InstanceTypeFamily>
        <InstanceTypeFamily>
            <InstanceTypeFamilyId>ecs.ebmg6e</InstanceTypeFamilyId>
            <Generation>ecs-5</Generation>
        </InstanceTypeFamily>
        <InstanceTypeFamily>
            <InstanceTypeFamilyId>ecs.g6e</InstanceTypeFamilyId>
            <Generation>ecs-5</Generation>
        </InstanceTypeFamily>
        <InstanceTypeFamily>
            <InstanceTypeFamilyId>ecs.c6</InstanceTypeFamilyId>
            <Generation>ecs-5</Generation>
        </InstanceTypeFamily>
        <InstanceTypeFamily>
            <InstanceTypeFamilyId>ecs.r6</InstanceTypeFamilyId>
            <Generation>ecs-5</Generation>
        </InstanceTypeFamily>
        <InstanceTypeFamily>
            <InstanceTypeFamilyId>ecs.t6</InstanceTypeFamilyId>
            <Generation>ecs-5</Generation>
        </InstanceTypeFamily>
        <InstanceTypeFamily>
            <InstanceTypeFamilyId>ecs.hfc6</InstanceTypeFamilyId>
            <Generation>ecs-5</Generation>
        </InstanceTypeFamily>
        <InstanceTypeFamily>
            <InstanceTypeFamilyId>ecs.hfg6</InstanceTypeFamilyId>
            <Generation>ecs-5</Generation>
        </InstanceTypeFamily>
        <InstanceTypeFamily>
            <InstanceTypeFamilyId>ecs.hfr6</InstanceTypeFamilyId>
            <Generation>ecs-5</Generation>
        </InstanceTypeFamily>
        <InstanceTypeFamily>
            <InstanceTypeFamilyId>ecs.ebmc6</InstanceTypeFamilyId>
            <Generation>ecs-5</Generation>
        </InstanceTypeFamily>
        <InstanceTypeFamily>
            <InstanceTypeFamilyId>ecs.ebmr6</InstanceTypeFamilyId>
            <Generation>ecs-5</Generation>
        </InstanceTypeFamily>
    </InstanceTypeFamilies>
    <RequestId>A66D039A-EC35-4130-B0D1-E9873C07****</RequestId>
</DescribeInstanceTypeFamiliesResponse>

Formato JSON

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

{
  "InstanceTypeFamilies" : {
    "InstanceTypeFamily" : [ {
      "InstanceTypeFamilyId" : "ecs.g6",
      "Generation" : "ecs-5"
    }, {
      "InstanceTypeFamilyId" : "ecs.ebmg6",
      "Generation" : "ecs-5"
    }, {
      "InstanceTypeFamilyId" : "ecs.ebmg6e",
      "Generation" : "ecs-5"
    }, {
      "InstanceTypeFamilyId" : "ecs.g6e",
      "Generation" : "ecs-5"
    }, {
      "InstanceTypeFamilyId" : "ecs.c6",
      "Generation" : "ecs-5"
    }, {
      "InstanceTypeFamilyId" : "ecs.r6",
      "Generation" : "ecs-5"
    }, {
      "InstanceTypeFamilyId" : "ecs.t6",
      "Generation" : "ecs-5"
    }, {
      "InstanceTypeFamilyId" : "ecs.hfc6",
      "Generation" : "ecs-5"
    }, {
      "InstanceTypeFamilyId" : "ecs.hfg6",
      "Generation" : "ecs-5"
    }, {
      "InstanceTypeFamilyId" : "ecs.hfr6",
      "Generation" : "ecs-5"
    }, {
      "InstanceTypeFamilyId" : "ecs.ebmc6",
      "Generation" : "ecs-5"
    }, {
      "InstanceTypeFamilyId" : "ecs.ebmr6",
      "Generation" : "ecs-5"
    } ]
  },
  "RequestId" : "A66D039A-EC35-4130-B0D1-E9873C07****"
}

Códigos de erro

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