ListProductQuotas - Quota Center: Central de Documentação do Alibaba Cloud

Consulta uma lista de cotas para um produto de nuvem especificado.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

quotas:ListProductQuotas

list

*Quota

acs:quotas:{#regionId}:{#accountId}:quota/{#ProductCode}/*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
NextToken	string	Não	O token usado para iniciar a próxima consulta. Deixe este parâmetro vazio para a primeira consulta ou se nenhuma consulta subsequente for necessária. Se uma consulta subsequente for necessária, defina o valor como o valor de NextToken retornado da última chamada de API.	AAAAAd****
MaxResults	integer	Não	O número máximo de registros a serem retornados para a consulta. Valores válidos: 1 a 100. Valor padrão: 30.	30
ProductCode	string	Sim	A abreviação do produto de nuvem. Nota Para mais informações sobre como obter a abreviação de um produto de nuvem, consulte o parâmetro ProductCode em ListProducts.	ecs
QuotaActionCode	string	Não	O ID da cota.	q_security-groups
KeyWord	string	Não	A palavra-chave a ser usada para pesquisar cotas. Nota Este parâmetro é aplicável apenas a cotas de tipo de instância do Elastic Compute Service (ECS). A pesquisa é realizada em QuotaName e QuotaActionCode.	security
SortField	string	Não	O campo a ser usado para classificar as cotas. Nota Este parâmetro é aplicável apenas a cotas de tipo de instância do ECS. Se você não definir este parâmetro, os resultados da consulta não serão classificados. Valores válidos: TOTAL : Classifica pelo uso total da cota. TIME : Classifica pela hora da última atualização. RESERVED : Classifica pelo uso da cota reservada.	TIME
SortOrder	string	Não	A ordem para classificar os resultados. Nota Este parâmetro é aplicável apenas a cotas de tipo de instância do ECS. Se você não definir este parâmetro, os resultados da consulta não serão classificados. Valores válidos: Descending : Classifica em ordem decrescente. Ascending : Classifica em ordem crescente.	Ascending
Dimensions	array<object>	Não	As dimensões da cota.
	object	Não	As dimensões da cota.
Key	string	Não	A chave da dimensão da cota. Nota O valor de N depende do número de dimensões suportadas pelo produto de nuvem.	regionId
Value	string	Não	O valor da dimensão da cota. Nota O valor de N depende do número de dimensões suportadas pelo produto de nuvem.	cn-hangzhou
QuotaCategory	string	Não	A categoria da cota. Valor padrão: CommonQuota. Valores válidos: FlowControl : Cotas de limite de taxa de API. WhiteListLabel : Cotas de privilégio. CommonQuota : Cotas gerais.	FlowControl
GroupCode	string	Não	O código do grupo de dimensões.	entconsole_w1j3ms****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O resultado retornado.
MaxResults	integer	O número máximo de registros retornados para a consulta.	1
NextToken	string	O token usado para iniciar a próxima consulta. Se este parâmetro estiver vazio, nenhuma consulta subsequente será iniciada. Se um valor for retornado, o valor é o token usado para a próxima consulta.	AAAAAd****
Quotas	array<object>	Os detalhes das cotas.
	array<object>	Os detalhes da cota.
Adjustable	boolean	Indica se a cota é ajustável. Valores válidos: true : A cota é ajustável. false : A cota não é ajustável.	true
ApplicableRange	array	O intervalo do valor da cota que você pode solicitar para a cota. Isso pode ser usado como referência para solicitações de aumento de cota.
	number	O intervalo do valor da cota que você pode solicitar. Este intervalo não inclui a cota existente do usuário. Você pode usar isso como referência ao solicitar um aumento de cota. Por exemplo, [1010,10000].	[1010,10000]
ApplicableType	string	O tipo de ajuste da cota. Valores válidos: continuous : O valor da cota é contínuo. discontinuous : O valor da cota é descontínuo.	discontinuous
ApplyReasonTips	string	Um exemplo do motivo para uma solicitação de aumento de cota.	The business xxx is expected to grow by 50%.
Consumable	boolean	Indica se a cota usada é exibida. Valores válidos: true : A cota usada é exibida. false : A cota usada não é exibida.	true
Dimensions	object	As dimensões da cota. Formato: {"regionId":"Region"}.	{"regionId":"cn-hangzhou"}
EffectiveTime	string	O horário UTC em que a cota entra em vigor.	2022-09-28T06:07:00Z
ExpireTime	string	O horário UTC em que a cota expira.	2022-09-29T06:07:00Z
GlobalQuota	boolean	Indica se a cota é uma cota global. Valores válidos: true : A cota é compartilhada por todas as regiões. false : A cota é independente para cada região.	true
Period	object	O ciclo de cálculo da cota.
PeriodUnit	string	The unit of the calculation cycle. Valores válidos: week : Week hour : Hour day : Day second : Seconds minute : minutes	day
PeriodValue	integer	The value of the calculation cycle.	{}
ProductCode	string	A abreviação do produto de nuvem.	ecs
QuotaActionCode	string	O ID da cota.	q_security-groups
QuotaArn	string	O Alibaba Cloud Resource Name (ARN) da cota.	acs:quotas:cn-hangzhou:120886317861****:quota/ecs/q_security-groups
QuotaCategory	string	A categoria da cota. Valores válidos: FlowControl : Cotas de limite de taxa de API. WhiteListLabel : Cotas de privilégio. CommonQuota : Cotas gerais.	CommonQuota
QuotaDescription	string	A descrição da cota.	The maximum number of security groups that can be owned by the current account.
QuotaItems	array<object>	Os detalhes da cota.
	object	Os detalhes da cota.
Quota	string	The quota value.	1009
QuotaUnit	string	The unit of the quota.	Count
Type	string	The quota type. Valores válidos: BaseQuota : Guaranteed quota ReservedQuota : Reserved quota	BaseQuota
Usage	string	The quota usage.	1009
QuotaName	string	O nome da cota.	ecs.g5.2xlarge
QuotaType	string	O tipo de cota. Valores válidos: normal : Padrão. privilege : Privilégios.	privilege
QuotaUnit	string	A unidade da cota.	AMOUNT
SupportedRange	array	O intervalo do valor da cota que é suportado pela cota. Isso pode ser usado como referência ao configurar um modelo de cota.
	number	O intervalo do valor da cota que é suportado pela cota. Isso pode ser usado como referência ao configurar um modelo de cota. Se ApplicableType for contínuo e o valor for [1009,10000], indica que todos os valores de 1009 a 10000 são suportados. Se ApplicableType for descontínuo e o valor for [10,20,50,100], indica que apenas os valores 10, 20, 50 e 100 são suportados.	[1009,10000]
TotalQuota	number	O valor da cota.	200
TotalUsage	number	O uso da cota.	1009
UnadjustableDetail	string	O motivo pelo qual a cota não é ajustável. Valores válidos: limitReached : O limite da cota foi atingido. nonactivated : O serviço não está ativado. applicationProcess : Uma solicitação de aumento de cota está sendo processada.	applicationProcess
UsageMetric	object	As informações de monitoramento do uso da cota no CloudMonitor. Nota Um valor vazio indica que não há dados de monitoramento disponíveis para a cota no CloudMonitor.
MetricDimensions	object	The dimensions for CloudMonitor. Format: a collection of key-value pairs. For example: `{"productCode":"*","metricKey":"","regionId":"","label":"*"}`.
	string	The value of the dimension for CloudMonitor.	ecs
MetricName	string	The name of the CloudMonitor metric.	Usage
MetricNamespace	string	The namespace of the metric for CloudMonitor.	acs_quotas_flowcontrol
RequestId	string	O ID da solicitação.	D0131FD5-5397-44FE-BF5A-4B7165B813CC
TotalCount	integer	O número total de registros retornados para a solicitação.	1

Exemplos

Resposta de sucesso

JSON formato

{
  "MaxResults": 1,
  "NextToken": "AAAAAd****",
  "Quotas": [
    {
      "Adjustable": true,
      "ApplicableRange": [
        0
      ],
      "ApplicableType": "discontinuous",
      "ApplyReasonTips": "The business xxx is expected to grow by 50%.",
      "Consumable": true,
      "Dimensions": {
        "regionId": "cn-hangzhou"
      },
      "EffectiveTime": "2022-09-28T06:07:00Z",
      "ExpireTime": "2022-09-29T06:07:00Z",
      "GlobalQuota": true,
      "Period": {
        "PeriodUnit": "day",
        "PeriodValue": 0
      },
      "ProductCode": "ecs",
      "QuotaActionCode": "q_security-groups",
      "QuotaArn": "acs:quotas:cn-hangzhou:120886317861****:quota/ecs/q_security-groups",
      "QuotaCategory": "CommonQuota",
      "QuotaDescription": "The maximum number of security groups that can be owned by the current account.",
      "QuotaItems": [
        {
          "Quota": "1009",
          "QuotaUnit": "Count",
          "Type": "BaseQuota",
          "Usage": "1009"
        }
      ],
      "QuotaName": "ecs.g5.2xlarge",
      "QuotaType": "privilege",
      "QuotaUnit": "AMOUNT",
      "SupportedRange": [
        0
      ],
      "TotalQuota": 200,
      "TotalUsage": 1009,
      "UnadjustableDetail": "applicationProcess",
      "UsageMetric": {
        "MetricDimensions": {
          "key": "ecs"
        },
        "MetricName": "Usage",
        "MetricNamespace": "acs_quotas_flowcontrol"
      }
    }
  ],
  "RequestId": "D0131FD5-5397-44FE-BF5A-4B7165B813CC",
  "TotalCount": 1
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidSortOrder	Invalid SortOrder	The specified SortOrder parameter is invalid.
400	INVALID.MAX.RESULTS	The maxResults parameter is invalid. Use an integer ranging from 1 to 100.	The maxResults value is invalid. It must be an integer within the range of 1 to 100.
400	DIMENSIONGROUP.NOT.FOUND	Dimension group does not exist.	Dimension group parameter is incorrect

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.