ListInstanceQuotasWithUsage - Edge Security Acceleration: Central de Documentação do Alibaba Cloud

Consulta as cotas e o uso real de um plano com base no ID do site ou do plano.

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

esa:ListInstanceQuotasWithUsage

list

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
InstanceId	string	Não	O ID do plano, que pode ser obtido chamando a operação ListSites.	sp-xcdn-96wblslz****
SiteId	integer	Não	O ID do site, que pode ser obtido chamando a operação ListSites.	1232223****
QuotaNames	string	Sim	Os nomes das cotas no plano. Separe os nomes das cotas com vírgulas (,). Você pode consultar até 10 nomes de cotas por vez. Valores válidos: customHttpCert: os certificados personalizados. transition-rule: as regras de transformação. waiting_room: as salas de espera. https\|rule_quota: as regras de SSL/TLS. cache_rules\|rule_quota: as regras de cache. configuration_rules\|rule_quota: as regras de configuração. redirect_rules\|rule_quota: as regras de redirecionamento. compression_rules\|rule_quota: as regras de compactação. origin_rules\|rule_quota: as regras de origem.	customHttpCert

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta.
RequestId	string	O ID da solicitação.	85H66C7B-671A-4297-9187-2C4477247A74
InstanceId	string	O ID do plano.	sp-xcdn-96wblslz****
Status	string	O status do plano. Valores válidos: online: O plano está em serviço. offline: O plano expirou dentro de um período permitido. Neste estado, o plano está indisponível. disable: O plano foi liberado.	online
Quotas	array<object>	As cotas e seu uso real no plano.
	array<object>	Os detalhes da cota e o uso da cota no plano.
QuotaName	string	O nome da cota.	redirect_rules\|rule_quota
QuotaValue	string	O valor da cota.	10
Usage	string	O uso da cota.	3
SiteUsage	array<object>	O uso da cota em cada site associado ao plano.
	object	Os detalhes de uso da cota em um único site.
SiteId	integer	The website ID.	34818329392****
SiteUsage	string	The quota usage of the website.	1
SiteName	string	The website name.	test.top

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "85H66C7B-671A-4297-9187-2C4477247A74",
  "InstanceId": "sp-xcdn-96wblslz****",
  "Status": "online",
  "Quotas": [
    {
      "QuotaName": "redirect_rules|rule_quota",
      "QuotaValue": "10",
      "Usage": "3",
      "SiteUsage": [
        {
          "SiteId": 0,
          "SiteUsage": "1",
          "SiteName": "test.top"
        }
      ]
    }
  ]
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParameter	The specified parameter is invalid.	The specified parameter is invalid.
400	QuotaNotExist	The quota item does not exist or the purchased plan has not taken effect. Confirm and try again.	The quota item does not exist or the purchased plan has not taken effect. Confirm and try again.
400	InstanceNotExist	The instance does not exist. Check whether the specified instance ID is correct or whether the instance belongs to your account.	The instance does not exist. Check whether the specified instance ID is correct or whether the instance belongs to your account.
400	NoPermission	You do not have permissions to access or operate on the resource.Contact your account administrator to attach the AliyunESAFullAccess policy to the current user.	You do not have permissions to access or operate on the resource.Contact your account administrator to attach the AliyunESAFullAccess policy to the current user.
400	ErService.HasOpened	You have already activated Edge Routine.	You have already activated Edge Routine.
403	Site.NotExist	The specified website does not exist or is not recognized by the system.Check whether the specified website identifier is valid and matches a website that is active, defined, and recognized by the system.If you want to add a new website, make sure that the creation and registration process is complete to integrate the website to the system.	The specified website does not exist or is not recognized by the system.Check whether the specified website identifier is valid and matches a website that is active, defined, and recognized by the system.If you want to add a new website, make sure that the creation and registration process is complete to integrate the website to the system.
404	SiteNotFound	The website does not exist or does not belong to you.	The website does not exist or does not belong to you.
404	UnsupportQuota	Unsupported quota is specified. Check and try again.	Unsupported quota is specified. Check and try again.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.