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

Consulta os detalhes da cota de um serviço 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:GetProductQuota

get

*Quota

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ProductCode	string	Sim	O nome abreviado do serviço de nuvem. Nota Para mais informações sobre como obter o nome abreviado de um serviço de nuvem, consulte o parâmetro ProductCode em ListProducts.	ecs
QuotaActionCode	string	Sim	O ID da cota. Nota Para mais informações sobre como obter o ID da cota de um serviço de nuvem especificado, consulte o parâmetro QuotaActionCode em ListProductQuotas.	q_security-groups
Dimensions	array<object>	Não	As dimensões da cota. As propriedades do item de cota. A combinação de dimensões e QuotaActionCode determina um item de cota exclusivo. Nota As dimensões são obrigatórias para alguns serviços de nuvem. Você pode chamar a operação ListProductQuotaDimensions para consultar as dimensões de cota de um serviço de nuvem e verificar se uma dimensão é obrigatória. O parâmetro de resposta Requisite indica se a dimensão é obrigatória.	{\"regionId\":\"cn-beijing\"}
	object	Não	A dimensão da cota.
Key	string	Não	A chave da dimensão da cota. Nota Você deve especificar tanto Dimensions.N.Key quanto Dimensions.N.Value. O intervalo de valores de N depende do número de dimensões suportadas pelo serviço de nuvem. Você pode chamar a operação ListProductQuotaDimensions para consultar as dimensões de cota suportadas pelo serviço de nuvem. O comprimento do array retornado é o valor máximo de N.	regionId
Value	string	Não	O valor da dimensão da cota. Nota Você deve especificar tanto Dimensions.N.Key quanto Dimensions.N.Value. O intervalo de valores de N depende do número de dimensões suportadas pelo serviço de nuvem. Você pode chamar a operação ListProductQuotaDimensions para consultar as dimensões de cota suportadas pelo serviço de nuvem. O comprimento do array retornado é o valor máximo de N.	cn-hangzhou

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A resposta.
Quota	object	Os detalhes da cota.
Adjustable	boolean	Indica se a cota é ajustável. Valores válidos: true: Ajustável. false: Não ajustável.	true
ApplicableRange	array	O intervalo aplicável para ajuste de cota.
	number	O intervalo aplicável para ajuste de cota. Exemplo: `[802,10000]`.	802
ApplicableType	string	O tipo de ajuste de cota. Valores válidos: continuous: Contínuo. discontinuous: Descontínuo.	continuous
ApplyReasonTips	string	Os motivos de exemplo para solicitar um ajuste de cota.	The business xxx is expected to grow by 50%.
Consumable	boolean	Indica se a cota utilizada é exibida. Valores válidos: true: A cota utilizada é exibida. false: A cota utilizada não é exibida.	true
Dimensions	object	As dimensões da cota. Formato: `{"regionId":"region"}`.	{"regionId":"cn-hangzhou"}
EffectiveTime	string	A hora UTC em que a cota entra em vigor.	2022-09-28T06:06:00Z
ExpireTime	string	A hora UTC em que a cota expira.	2022-09-29T06:06:00Z
GlobalQuota	boolean	Indica se a cota é uma cota global. Valores válidos: true: O item de cota é compartilhado em todas as regiões. false: O item de cota é independente para cada região.	true
Period	object	O período da cota.
PeriodUnit	string	A unidade do período da cota. Valores válidos: second: Segundos. minute: Minutos. hour: Horas. day: Dias. week: Semanas.	day
PeriodValue	integer	O valor do período da cota.	1
ProductCode	string	O nome abreviado do serviço de nuvem.	ecs
QuotaActionCode	string	O ID da cota.	q_security-groups
QuotaArn	string	O ARN da cota.	acs:quotas:cn-hangzhou:120886317861****:quota/ecs/q_security-groups/
QuotaCategory	string	A categoria da cota. Valores válidos: CommonQuota: Cota geral. FlowControl: Limite de taxa de API. WhiteListLabel: Privilégio.	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	O item de cota.
Quota	string	O valor da cota.	801
QuotaUnit	string	A unidade da cota. Nota A unidade varia para cada cota. Por exemplo, a unidade da cota q_cbdch3 (número máximo de clusters) para o Container Service for Kubernetes é Cluster, e a unidade da cota q_security-groups (número máximo de grupos de segurança) para servidores do Elastic Compute Service é contagem.	Count
Type	string	O tipo de item de cota. Valores válidos: BaseQuota: Cota base. ReservedQuota: Cota reservada.	BaseQuota
Usage	string	O uso da cota.	26
QuotaName	string	O nome da cota.	Maximum Number of Security Groups
QuotaType	string	O tipo de cota. Valores válidos: privilege: Privilégio. normal: Normal.	normal
QuotaUnit	string	A unidade da cota. Nota A unidade varia para cada cota. Por exemplo, a unidade da cota q_cbdch3 (número máximo de clusters) para o Container Service for Kubernetes é Cluster, e a unidade da cota q_security-groups (número máximo de grupos de segurança) para servidores do Elastic Compute Service é contagem.	Count
SupportedRange	array	O intervalo suportado de valores de cota para o item de cota atual, que pode ser usado como referência ao configurar um modelo de cota.
	number	O intervalo suportado de valores de cota para o item de cota atual, que pode ser usado como referência ao configurar um modelo de cota. Se ApplicableType for continuous e o valor for [802,1000], indica todos os inteiros de 802 a 1000. Se ApplicableType for discontinuous e o valor for [10,20,50,100], indica apenas os valores 10, 20, 50 e 100.	[802,1000]
TotalQuota	number	O valor da cota.	801
TotalUsage	number	O uso da cota.	26
UnadjustableDetail	string	O motivo pelo qual a cota não pode ser ajustada. Valores válidos: nonactivated: O serviço não está ativado. applicationProcess: A solicitação de cota está sendo processada. limitReached: O limite da cota foi atingido. supportTicketRequired: Um ticket deve ser enviado para a solicitação.	limitReached
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 esta cota no CloudMonitor.
MetricDimensions	object	As dimensões de monitoramento do CloudMonitor. Formato: uma coleção de pares `chave:valor`. Exemplo: `{"productCode":"*","metricKey":"","regionId":"","label":"*"}`.
	string	O valor da dimensão de monitoramento do CloudMonitor.	ecs
MetricName	string	O nome da métrica do CloudMonitor.	Usage
MetricNamespace	string	O namespace da métrica do CloudMonitor.	acs_quotas_flowcontrol
RequestId	string	O ID da solicitação.	8FF8CAF0-29D9-4F11-B6A4-FD2CBCA016D3

Exemplos

Resposta de sucesso

JSON formato

{
  "Quota": {
    "Adjustable": true,
    "ApplicableRange": [
      802
    ],
    "ApplicableType": "continuous",
    "ApplyReasonTips": "The business xxx is expected to grow by 50%.",
    "Consumable": true,
    "Dimensions": {
      "regionId": "cn-hangzhou"
    },
    "EffectiveTime": "2022-09-28T06:06:00Z",
    "ExpireTime": "2022-09-29T06:06:00Z",
    "GlobalQuota": true,
    "Period": {
      "PeriodUnit": "day",
      "PeriodValue": 1
    },
    "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": "801",
        "QuotaUnit": "Count",
        "Type": "BaseQuota",
        "Usage": "26"
      }
    ],
    "QuotaName": "Maximum Number of Security Groups",
    "QuotaType": "normal",
    "QuotaUnit": "Count",
    "SupportedRange": [
      0
    ],
    "TotalQuota": 801,
    "TotalUsage": 26,
    "UnadjustableDetail": "limitReached",
    "UsageMetric": {
      "MetricDimensions": {
        "key": "ecs"
      },
      "MetricName": "Usage",
      "MetricNamespace": "acs_quotas_flowcontrol"
    }
  },
  "RequestId": "8FF8CAF0-29D9-4F11-B6A4-FD2CBCA016D3"
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.