PutCustomMetric - : Central de Documentação do Alibaba Cloud

Nota

Recomendamos usar a operação

do Hybrid Cloud Monitoring para relatar dados de monitoramento.

Depuração

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

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	PutCustomMetric	A operação a ser executada. Defina o valor como PutCustomMetric.
MetricList.N.Type	String	Sim	0	O tipo dos dados relatados. Valores válidos de N: 1 a 21. Valores válidos: 0: relata dados brutos 1: relata dados agregados Nota Recomendamos relatar dados agregados nos períodos de agregação de 60 s e 300 s. Caso contrário, não será possível consultar dados de monitoramento em um intervalo superior a sete dias.
MetricList.N.MetricName	String	Sim	cpu_total	O nome da métrica. Valores válidos de N: 1 a 21. Para mais informações, consulte Apêndice 1: Métricas.
MetricList.N.Time	String	Não	1508136760000	O carimbo de data/hora de geração dos dados da métrica. Valores válidos de N: 1 a 21. O carimbo de data/hora pode estar em um dos seguintes formatos: Carimbo de data/hora UTC no formato AAAA-MM-DDThh:mm:ssZ. Exemplo: 20171012T132456.888+0800. Carimbo de data/hora UNIX do tipo LONG. Exemplo: 1508136760000.
MetricList.N.GroupId	String	Sim	12345	O ID do grupo de aplicativos. Valores válidos de N: 1 a 21. Nota Se a métrica não pertencer a nenhum grupo de aplicativos, insira 0.
MetricList.N.Values	String	Sim	{"value":10.5}	A coleção de valores da métrica. Valores válidos de N: 1 a 21. Nota Se o parâmetro MetricList.N.Type estiver definido como 0, as chaves neste parâmetro devem ter o valor especificado. O CloudMonitor agrega dados brutos em cada período de agregação para gerar vários valores estatísticos, como valor máximo, contagem e valor total.
MetricList.N.Dimensions	String	Sim	{"sampleName1":"value1","sampleName2":"value2"}	As dimensões que especificam os recursos cujos dados de monitoramento você deseja consultar. Valores válidos de N: 1 a 21. Defina o valor como uma coleção de pares chave-valor. Formato:`{"Key":"Value"}`. A chave ou o valor deve ter entre 1 e 64 bytes de comprimento. Caracteres excedentes são truncados. A chave ou o valor pode conter letras, dígitos, pontos (.), hifens (-), sublinhados (_), barras (/) e barras invertidas (\). Nota As dimensões devem ser formatadas como uma string JSON em uma ordem específica.
MetricList.N.Period	String	Não	60	O período de agregação. Valores válidos de N: 1 a 21. Unidade: segundos. Valores válidos: 60 e 300. Nota Se o parâmetro MetricList.N.Type estiver definido como 1, o parâmetro MetricList.N.Period é obrigatório.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
Code	String	200	O código de status HTTP. Nota O código de status 200 indica que a chamada foi bem-sucedida.
Message	String	The request has failed due to a temporary failure of the server.	A mensagem de erro.
RequestId	String	05B36C2C-5F6E-48D5-8B41-CE36DD7EE8E0	O ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=PutCustomMetric
&MetricList.1.Dimensions={"sampleName1":"value1","sampleName2":"value2"}
&MetricList.1.GroupId=12345
&MetricList.1.MetricName=cpu_total
&MetricList.1.Type=0
&MetricList.1.Values={"value":10.5}
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<PutCustomMetricResponse>
	<RequestId>75D115CE-5DA8-4647-9073-8F72BB85B6F7</RequestId>
	<Message>success</Message>
	<Code>200</Code>
</PutCustomMetricResponse>

Formato JSON

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

{
  "RequestId" : "75D115CE-5DA8-4647-9073-8F72BB85B6F7",
  "Message" : "success",
  "Code" : "200"
}

Códigos de erro

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