QueryCommercialUsage - Application Real-Time Monitoring Service: Central de Documentação do Alibaba Cloud

Consulta a quantidade de dados gravados no Application Monitoring, Managed Service for OpenTelemetry, Managed Service for Prometheus e Real User Monitoring (RUM).

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

arms:QueryCommercialUsage

get

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
IntervalInSec	integer	Não	O intervalo de tempo entre fatias de dados. Unidade: segundos. Valor mínimo: 3600. Valores válidos: 3600: 1 hora 86400: 1 dia Valores válidos: 3600 : 86400 :	3600
StartTime	integer	Sim	O início do intervalo de tempo a ser consultado. Unidade: milissegundos.	1699200000000
EndTime	integer	Sim	O fim do intervalo de tempo a ser consultado. Unidade: milissegundos.	1699286400000
OrderBy	string	Não	A dimensão pela qual os dados são classificados. Valor válido: dataType Valores válidos: dataType : dataType.	dataType
Metric	string	Sim	O nome da métrica. Valor válido: USAGEFEE.STAT. Valores válidos: USAGEFEE.STAT : USAGEFEE.STAT.	USAGEFEE.STAT
Order	string	Não	A ordem em que os dados são classificados. Valores válidos: ASC: ordem crescente DESC: ordem decrescente	ASC
AdvancedFilters	array<object>	Não	As condições de filtro.
	object	Não
Key	string	Não	A chave da condição de filtro.	regionId
Value	string	Não	O valor da condição de filtro.	cn-hangzhou
OpType	string	Não	O operador. Valores válidos: eq e in. Valores válidos: in : in eq : eq	eq
Dimensions	array	Não	As dimensões da métrica que você deseja consultar. Valores válidos: dataType: tipo de dados productType: tipo de produto instanceId: ID da instância instanceName: nome da instância instanceType: tipo de instância
	string	Não	A dimensão da métrica.	dataType
Measures	array	Não	As medidas da métrica que você deseja consultar.
	string	Não	A medida da métrica. Valor válido: byte_sum. Valores válidos: byte_sum : byte_sum.	byte_sum
QueryType	string	Sim	O tipo de dados. Valores válidos: instantQuery: não série temporal timeSeriesQuery: série temporal Valores válidos: timeSeriesQuery : timeSeriesQuery. instantQuery : instantQuery.	instantQuery

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
Code	integer	O status da resposta. Valores válidos: 2XX: A solicitação foi bem-sucedida. 3XX: Uma mensagem de redirecionamento é retornada. 4XX: A solicitação é inválida. 5XX: Ocorre um erro de servidor.	200
HttpStatusCode	integer	O código de status HTTP.	200
Message	string	A mensagem de erro retornada se a solicitação falhar.	success
RequestId	string	O ID da solicitação.	99A663CB-8D7B-4B0D-A006-03C8EE38E7BB
Success	boolean	Indica se a solicitação foi bem-sucedida. Valores válidos: true false	true
Data	object	A estrutura retornada.
Complete	boolean	Indica se uma consulta multirregião está concluída. Valores válidos: true false	true
Items	array<object>	A estrutura retornada.
	object	Os dados consultados.	{ "date": "1697108400", "dataType": "metrics", "byte_sum": 9497922 }

Exemplos

Resposta de sucesso

JSON formato

{
  "Code": 200,
  "HttpStatusCode": 200,
  "Message": "success",
  "RequestId": "99A663CB-8D7B-4B0D-A006-03C8EE38E7BB",
  "Success": true,
  "Data": {
    "Complete": true,
    "Items": [
      {
        "date": "1697108400",
        "dataType": "metrics",
        "byte_sum": 9497922
      }
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro
400	ParameterMetricIllegal	The specified metric is invalid.
400	ParameterMeasuresIllegal	The specified Measures is invalid.
400	ParameterTimeStampIllegal	The specified timeStamp is invalid.
400	ParameterOrderIllegal	The specified order is invalid.
400	ParameterPageSizeIllegal	The specified PageSize is invalid.
400	ParameterIntervalIllegal	The specified interval is invalid.
400	ParameterMeasuresMissing	You must specify measures.
400	ParameterDimensionsIllegal	The specified dimensions is invalid.
400	ParameterRegionIdIllegal	The specified RegionId is invalid.
400	InternalError	Internal error. Please try again. Contact the DingTalk service account if the issue persists after multiple retries.
403	APINotAuthorize	The current user is not authorized to access the interface.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.