Todos os produtos
Search
Central de documentação

:DescribeAccountAttributes

Última atualização: Jul 03, 2026

Consulta as cotas de recursos do Elastic Compute Service (ECS) que você pode criar em uma região da Alibaba Cloud. Em uma região específica, consulte os limites máximos de grupos de segurança, interfaces de rede elásticas (ENIs), vCPUs para instâncias de pagamento conforme o uso, vCPUs para instâncias preemptíveis e hosts dedicados, além das cotas de capacidade para discos de pagamento conforme o uso. Também é possível obter informações como tipos de rede ou se a conta concluiu a verificação de nome real.

Descrição

Depois de criar uma conta Alibaba Cloud, você pode crie um número específico de instâncias ECS em diferentes regiões da conta. Para mais informações, consulte Limites.

Solicite um aumento de cota no console do Quota Center.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para sua conveniência. A ferramenta gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim DescribeAccountAttributes

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

RegionId String Sim cn-hangzhou

O ID da região. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.

ZoneId String Não cn-hangzhou-b

O ID da zona.

AttributeName.N String Não max-security-groups

O tipo de cota de recurso N. Valores válidos de N: 1 a 8. Valores válidos:

  • instance-network-type: tipos de rede disponíveis
  • max-security-groups: limite máximo de grupos de segurança
  • max-elastic-network-interfaces: limite máximo de ENIs
  • max-postpaid-instance-vcpu-count: limite máximo de vCPUs para instâncias de pagamento conforme o uso
  • max-spot-instance-vcpu-count: limite máximo de vCPUs para instâncias preemptíveis
  • used-postpaid-instance-vcpu-count: quantidade de vCPUs já alocadas para instâncias de pagamento conforme o uso
  • used-spot-instance-vcpu-count: quantidade de vCPUs já alocadas para instâncias preemptíveis
  • max-postpaid-yundisk-capacity: capacidade máxima de discos de dados de pagamento conforme o uso
  • used-postpaid-yundisk-capacity: capacidade dos discos de pagamento conforme o uso já criados
  • max-dedicated-hosts: limite máximo de hosts dedicados
  • supported-postpaid-instance-types: tipos de instância para instâncias otimizadas para I/O de pagamento conforme o uso
  • max-axt-command-count: limite máximo de comandos do Cloud Assistant
  • max-axt-invocation-daily: limite máximo de execuções diárias de comandos do Cloud Assistant
  • max-cloud-assistant-activation-count: limite máximo de códigos de ativação criáveis para registrar instâncias gerenciadas
  • real-name-authentication: indica se a conta concluiu a verificação de nome real
    Nota É necessário concluir a verificação de nome real antes de criar instâncias ECS nas regiões da China continental.

Por padrão, este parâmetro está vazio.

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
RequestId String 8CE45CD5-31FB-47C2-959D-CA8144CE****

O ID da solicitação.

AccountAttributeItems Array of AccountAttributeItem

Detalhes sobre os privilégios da conta especificados por AccountAttributeItem na região indicada.

AccountAttributeItem
AttributeName String max-security-groups

O tipo de cota de recurso na região especificada. Valores válidos:

  • instance-network-type: tipos de rede disponíveis
  • max-security-groups: limite máximo de grupos de segurança
  • max-elastic-network-interfaces: limite máximo de ENIs
  • max-postpaid-instance-vcpu-count: limite máximo de vCPUs para instâncias de pagamento conforme o uso
  • max-spot-instance-vcpu-count: limite máximo de vCPUs para instâncias preemptíveis
  • used-postpaid-instance-vcpu-count: quantidade de vCPUs já alocadas para instâncias de pagamento conforme o uso
  • used-spot-instance-vcpu-count: quantidade de vCPUs já alocadas para instâncias preemptíveis
  • max-postpaid-yundisk-capacity: capacidade máxima de discos de dados de pagamento conforme o uso
  • used-postpaid-yundisk-capacity: capacidade dos discos de pagamento conforme o uso já criados
  • max-dedicated-hosts: limite máximo de hosts dedicados
  • supported-postpaid-instance-types: tipos de instância para instâncias otimizadas para I/O de pagamento conforme o uso
  • max-axt-command-count: limite máximo de comandos do Cloud Assistant
  • max-axt-invocation-daily: limite máximo de execuções diárias de comandos do Cloud Assistant
  • real-name-authentication: indica se a conta concluiu a verificação de nome real
  • max-cloud-assistant-activation-count: limite máximo de códigos de ativação criáveis para registrar instâncias gerenciadas
AttributeValues Array of ValueItem

Os valores específicos das cotas de recursos.

ValueItem
DiskCategory String cloud_ssd

A categoria do disco de dados. Valores válidos:

  • cloud_efficiency: disco ultra
  • cloud_ssd: SSD padrão
  • cloud_essd: SSD aprimorado (ESSD)
Value String 800

O valor da cota de recurso na região especificada. Valores válidos:

Os valores retornados para as cotas de recursos correspondentes aos seguintes valores de AttributeName são 0 ou inteiros positivos:

  • max-security-groups
  • max-elastic-network-interfaces
  • max-postpaid-instance-vcpu-count
  • max-spot-instance-vcpu-count
  • used-postpaid-instance-vcpu-count
  • used-spot-instance-vcpu-count
  • max-postpaid-yundisk-capacity
  • used-postpaid-yundisk-capacity
  • max-dedicated-hosts
  • max-axt-command-count
  • max-axt-invocation-daily
  • max-cloud-assistant-activation-count

Se o parâmetro AttributeName for definido como supported-postpay-instance-types, um tipo de instância será retornado. Para mais informações, consulte Famílias de instâncias.

Se o parâmetro AttributeName for definido como real-name-authentications, um dos seguintes valores será retornado:

  • yes
  • none
  • unnecessary

Se o parâmetro AttributeName for definido como instance-network-type, um dos seguintes valores será retornado:

  • vpc
  • classic
ExpiredTime String 2019-01-01T12:30:00Z

O horário de expiração de um privilégio. Este parâmetro é retornado apenas quando o privilégio da conta possui data de validade. O horário segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ e é exibido em UTC.

ZoneId String cn-hangzhou-b

O ID da zona.

InstanceType String ecs.g5.large

O tipo da instância.

Count Integer 3

O número de atributos de privilégio na conta.

InstanceChargeType String PrePaid

O método de faturamento da instância.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=DescribeAccountAttributes
&RegionId=cn-hangzhou
&ZoneId=cn-hangzhou-b
&AttributeName.1=max-security-groups
&<Common request parameters>

Exemplo de resposta de sucesso

Formato XML

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

<DescribeAccountAttributesResponse>
    <AccountAttributeItems>
        <AccountAttributeItem>
            <AttributeValues>
                <ValueItem>
                    <Value>100</Value>
                </ValueItem>
            </AttributeValues>
            <AttributeName>max-security-groups</AttributeName>
        </AccountAttributeItem>
        <AccountAttributeItem>
            <AttributeValues>
                <ValueItem>
                    <Value>2</Value>
                </ValueItem>
            </AttributeValues>
            <AttributeName>max-dedicated-hosts</AttributeName>
        </AccountAttributeItem>
        <AccountAttributeItem>
            <AttributeValues>
                <ValueItem>
                    <Value>1000</Value>
                </ValueItem>
            </AttributeValues>
            <AttributeName>max-postpaid-instance-vcpu-count</AttributeName>
        </AccountAttributeItem>
        <AccountAttributeItem>
            <AttributeValues>
                <ValueItem>
                    <Value>1000</Value>
                </ValueItem>
            </AttributeValues>
            <AttributeName>max-spot-instance-vcpu-count</AttributeName>
        </AccountAttributeItem>
        <AccountAttributeItem>
            <AttributeValues>
                <ValueItem>
                    <Value>5000</Value>
                </ValueItem>
            </AttributeValues>
            <AttributeName>max-elastic-network-interfaces</AttributeName>
        </AccountAttributeItem>
        <AccountAttributeItem>
            <AttributeValues>
                <ValueItem>
                    <Value>yes</Value>
                </ValueItem>
            </AttributeValues>
            <AttributeName>real-name-authentication</AttributeName>
        </AccountAttributeItem>
        <AccountAttributeItem>
            <AttributeValues>
                <ValueItem>
                    <Value>vpc</Value>
                </ValueItem>
            </AttributeValues>
            <AttributeName>instance-network-type</AttributeName>
        </AccountAttributeItem>
        <AccountAttributeItem>
            <AttributeValues>
                <ValueItem>
                    <Value>229376</Value>
                    <DiskCategory>cloud_efficiency</DiskCategory>
                </ValueItem>
                <ValueItem>
                    <Value>204800</Value>
                    <DiskCategory>cloud_ssd</DiskCategory>
                </ValueItem>
                <ValueItem>
                    <Value>204800</Value>
                    <DiskCategory>cloud_essd</DiskCategory>
                </ValueItem>
            </AttributeValues>
            <AttributeName>max-postpaid-yundisk-capacity</AttributeName>
        </AccountAttributeItem>
        <AccountAttributeItem>
            <AttributeValues>
                <ValueItem>
                    <Value>ecs.f3-c16f1.4xlarge</Value>
                </ValueItem>
                <ValueItem>
                    <Value>ecs.g5.2xlarge</Value>
                </ValueItem>
            </AttributeValues>
            <AttributeName>supported-postpaid-instance-types</AttributeName>
        </AccountAttributeItem>
    </AccountAttributeItems>
    <RequestId>8CE45CD5-31FB-47C2-959D-CA8144CE****</RequestId>
</DescribeAccountAttributesResponse>

Formato JSON

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

{
  "AccountAttributeItems" : {
    "AccountAttributeItem" : [ {
      "AttributeValues" : {
        "ValueItem" : [ {
          "Value" : "100"
        } ]
      },
      "AttributeName" : "max-security-groups"
    }, {
      "AttributeValues" : {
        "ValueItem" : [ {
          "Value" : "2"
        } ]
      },
      "AttributeName" : "max-dedicated-hosts"
    }, {
      "AttributeValues" : {
        "ValueItem" : [ {
          "Value" : "1000"
        } ]
      },
      "AttributeName" : "max-postpaid-instance-vcpu-count"
    }, {
      "AttributeValues" : {
        "ValueItem" : [ {
          "Value" : "1000"
        } ]
      },
      "AttributeName" : "max-spot-instance-vcpu-count"
    }, {
      "AttributeValues" : {
        "ValueItem" : [ {
          "Value" : "5000"
        } ]
      },
      "AttributeName" : "max-elastic-network-interfaces"
    }, {
      "AttributeValues" : {
        "ValueItem" : [ {
          "Value" : "yes"
        } ]
      },
      "AttributeName" : "real-name-authentication"
    }, {
      "AttributeValues" : {
        "ValueItem" : [ {
          "Value" : "vpc"
        } ]
      },
      "AttributeName" : "instance-network-type"
    }, {
      "AttributeValues" : {
        "ValueItem" : [ {
          "Value" : "229376",
          "DiskCategory" : "cloud_efficiency"
        }, {
          "Value" : "204800",
          "DiskCategory" : "cloud_ssd"
        }, {
          "Value" : "204800",
          "DiskCategory" : "cloud_essd"
        } ]
      },
      "AttributeName" : "max-postpaid-yundisk-capacity"
    }, {
      "AttributeValues" : {
        "ValueItem" : [ {
          "Value" : "ecs.f3-c16f1.4xlarge"
        }, {
          "Value" : "ecs.g5.2xlarge"
        } ]
      },
      "AttributeName" : "supported-postpaid-instance-types"
    } ]
  },
  "RequestId" : "8CE45CD5-31FB-47C2-959D-CA8144CE****"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

403

Invalid.Parameter

The required parameter regionId must be not null.

Mensagem de erro retornada porque o parâmetro RegionId não foi especificado.

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