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

Defina o intervalo de dados de monitoramento a exportar. A operação retorna as informações do Cursor. Ao chamar a operação BatchExport pela primeira vez, especifique as informações do Cursor.

Pré-requisitos

O Hybrid Cloud Monitoring deve estar ativado. Para mais informações, consulte Ativar o Hybrid Cloud Monitoring.

Informações básicas

Use esta operação para obter as informações do Cursor e, em seguida, chame a operação BatchExport para exportar os dados de monitoramento.

Observações de uso

Este tópico apresenta um exemplo de definição dos dados de monitoramento de uma métrica específica para um serviço de nuvem. Neste exemplo, o namespace do serviço é acs_ecs_dashboard, a métrica é cpu_idle, a hora de início é 1641627000000 e a hora de término é 1641645000000. O sistema mede o número de núcleos de CPU ociosos nas instâncias do Elastic Compute Service (ECS) a cada 60 segundos, das 15:30:00 às 20:30:00 de 8 de janeiro de 2022. A operação retorna as informações do Cursor.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar o OpenAPI Explorer para facilitar a chamada desta operação. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	Cursor	A operação a ser executada. Defina o valor como Cursor.
Namespace	String	Sim	acs_ecs_dashboard	O namespace do serviço de nuvem. Para mais informações sobre namespaces de serviços de nuvem, consulte Apêndice 1: Métricas.
Metric	String	Sim	cpu_idle	A métrica usada para monitorar o serviço de nuvem. Para mais informações sobre métricas de serviços de nuvem, consulte Apêndice 1: Métricas.
Period	Integer	Sim	60	O intervalo de tempo usado para medir o valor da métrica. Unidade: segundos. Nota Geralmente, o intervalo é definido como 60 segundos. Para mais informações, consulte o parâmetro `Period` no Apêndice 1: Métricas.
StartTime	String	Sim	1641627000000	O início do intervalo de tempo da consulta. Especifique a hora no padrão ISO 8601, no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC. Por exemplo, 2023-01-01T00:00:00Z indica 1º de janeiro de 2023, 00:00:00 UTC. Nota O tempo de vida (TTL) dos dados de monitoramento varia conforme a granularidade de tempo no CloudMonitor. Especifique um intervalo adequado com base no TTL correspondente ao valor do parâmetro `Period`.
EndTime	String	Não	1641645000000	O fim do intervalo de tempo da consulta. Unidade: milissegundos. Nota Este valor é um carimbo de data/hora UNIX que representa o número de milissegundos decorridos desde 1º de janeiro de 1970, 00:00:00 UTC. Especifique a hora no padrão ISO 8601, no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC. Por exemplo, 2023-01-01T00:00:00Z indica 1º de janeiro de 2023, 00:00:00 UTC. Se você não definir a hora de término, ela será considerada infinita. Deixe este parâmetro vazio em cenários de exportação em tempo real. O TTL dos dados de monitoramento varia conforme a granularidade de tempo no CloudMonitor. Especifique um intervalo adequado com base no TTL correspondente ao valor do parâmetro `Period`.
Matchers	Array de Matcher	Não		As informações de dimensão da métrica.

Para mais informações sobre parâmetros comuns de solicitação, consulte Parâmetros comuns.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
Message	String	success	A mensagem retornada.
Cursor	String	v2.5eyJiYXRjaGVzIjoxLCJidWNrZXRCeXRlcyI6IndBPT0iLCJidWNrZXRzIjo0LCJjdXJyZW50QnVja2V0IjotNjQsImN1cnJlbnRUYXJnZXRUaW1lU2xvdCI6MTY3ODc1MjAwMCwiZW5kVGltZSI6MTY3ODc4MjQxOTAwMCwiZXhwb3J0RW5kVGltZSI6MTY3ODc4MjQxOTAwMCwiZXhwb3J0U3RhcnRUaW1lIjoxNjc4NzgxODE5MDAwLCJleHByZXNzUmFuZ2UiOmZhbHNlLCJoYXNOZXh0Ijp0cnVlLCJpbmRleCI6MCwibGF0ZXN0TG9nVGltZSI6MCwibWF0Y2hlcnMiOnsiY2hhaW4iOlt7ImxhYmVsIjoidXNlcklkIiwib3BlcmF0b3IiOiJFUVVBTFMiLCJ2YWx1ZSI6IjEyNzA2NzY2Nzk1NDY3MDQifV0sImxvY2tlZCI6dHJ1ZX0sIm1ldHJpYyI6IlNwbGl0cndQcm94eU1heFJlc3BvbnNlU2l6ZSIsIm1ldHJpY1R5cGUiOiJNRVRSSUMiLCJuYW1lc3BhY2UiOiJhY3Nfa3ZzdG9yZV9leCIsIm5leHRQa0FkYXB0ZXIiOnsiZGltIjoiVjowXG5EOmB1c2VySWRgPTEyNzA2NzY2Nzk1NDY3MDQsYGluc3RhbmNlSWRgPXItcmo5ZjlzMTlsc3V1MXd1bnVyLGBub2RlSWRgPXItcmo5ZjlzMTlsc3V1MXd1bnVyLXByb3h5LTIsXG4iLCJtZXRhIjoiXG5WOjBcbk06YWNzX2t2c3RvcmVfZXgvU3BsaXRyd1Byb3h5TWF4UmVzcG9uc2VTaXplXG5XOjYwXG5COjRcbkk6LTFcblQ6MFxuQzpgQXZlcmFnZWAsYE1heGltdW1gLGBfX2NvdW50X19gLGBfX3RzX19gXG4iLCJyZCI6InN1YkFMU0RwWXY2K0t6aENQQUFBWkErNUFKMEpjbGErRGd2V0hFNWxDSHMvbGtqR2FXYTFJTkVwdFE9PSIsInRhZyI6IiJ9LCJvZmZzZXQiOjAsIm9mZnNldERpZ2l0Ijo0NTU0NTczNDQyMTc4NDIxMjIsInN0YXJ0VGltZSI6MTY3ODc4MTgxOTAwMCwic3RlcCI6LTEsInRhZ01hdGNoZXJzIjp7ImNoYWluIjpbXSwibG9ja2VkIjp0cnVlfSwidGFyZ2V0VGltZVNsb3RzIjpbMTY3ODY2NTYwMCwxNjc4NzUyMDAwXSwidXVpZCI6ImQwMmFhZmY1LWU3ZGQtNDUyYy0***********	O Cursor serve como parâmetro de entrada para exportação de dados na operação BatchExport.
Code	Integer	200	O código de status. Nota O código de status 200 indica que a solicitação foi bem-sucedida.
Success	Boolean	true	Indica se a solicitação foi bem-sucedida. Valores válidos: true false
RequestId	String	915C2D7A-E6A4-17C3-8E13-4DBDD61E7919	O ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=Cursor
&Namespace=acs_ecs_dashboard
&Metric=cpu_idle
&Period=60
&StartTime=1641627000000
&EndTime=1641645000000
&Matchers=[{"Label":"userId","Value":"120886317861****","Operator":"EQUALS"}]
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<CursorResponse>
    <RequestId>915C2D7A-E6A4-17C3-8E13-4DBDD61E7919</RequestId>
    <Message>success</Message>
    <Data>
        <Cursor>eyJidWNrZXRzIjo0LCJjdXJzb3IiOiIxNjQxNDU0MzIwMDAwMWUxY2YxNWY0NTU0MTliZjllYTY4OWQ2ODI1OTU1Yzc1NmZjMDQ2OTMxMzczMzM2MzUzMTMxMzEzMzM0MzMzODM5MzEzMTMwMjQyYzY5MmQ3NTY2MzYzMjY3NmI2ZjM5MzU2YjY4MzAzMTYyNzg3MTcwNjkzMTM3MjQyYyIsImN1cnNvclZlcnNpb24iOiJxdWVyeSIsImVuZFRpbWUiOjE2NDE0NTQ3OTU4MjMsImV4cG9ydEVuZFRpbWUiOjE2NDE0NTQ3OTU4MjMsImV4cG9ydFN0YXJ0VGltZSI6MTY0MTQ1NDE5NTgyMywiZXhwcmVzc1JhbmdlIjpmYWxzZSwiaGFzTmV4dCI6dHJ1ZSwiaW5wdXRNZXRyaWMiOiJDUFVVdGlsaXphdGlvbiIsImlucHV0TmFtZXNwYWNlIjoiYWNzX2Vjc19kYXNoYm9hcmQiLCJsaW1pdCI6MTAwMCwibG9nVGltZU1vZGUiOnRydWUsIm1hdGNoZXJzIjp7ImNoYWluIjpbeyJsYWJlbCI6InVzZXJJZCIsIm9wZXJhdG9yIjoiRVFVQUxTIiwidmFsdWUiOiIxNzM2NTExMTM0Mzg5MTEwIn1dfSwibWV0cmljIjoiQ1BVVXRpbGl6YXRpb24iLCJtZXRyaWNUeXBlIjoiTUVUUklDIiwibmFtZXNwYWNlIjoiYWNzX2Vjc19kYXNoYm9hcmQiLCJuZXh0UGtBZGFwdGVyIjp7fSwib2Zmc2V0IjowLCJwYXJlbnRVaWQiOjEyNzA2NzY2Nzk1NDY3MDQsInN0YXJ0VGltZSI6MTY0MTQ1NDE5NTgyMywic3RlcCI6LTEsInRpbWVvdXQiOjEyMCwid2luZG93Ijo2****</Cursor>
    </Data>
    <Code>200</Code>
    <Success>true</Success>
</CursorResponse>

Formato JSON

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

{
  "RequestId" : "915C2D7A-E6A4-17C3-8E13-4DBDD61E7919",
  "Message" : "success",
  "Data" : {
    "Cursor" : "eyJidWNrZXRzIjo0LCJjdXJzb3IiOiIxNjQxNDU0MzIwMDAwMWUxY2YxNWY0NTU0MTliZjllYTY4OWQ2ODI1OTU1Yzc1NmZjMDQ2OTMxMzczMzM2MzUzMTMxMzEzMzM0MzMzODM5MzEzMTMwMjQyYzY5MmQ3NTY2MzYzMjY3NmI2ZjM5MzU2YjY4MzAzMTYyNzg3MTcwNjkzMTM3MjQyYyIsImN1cnNvclZlcnNpb24iOiJxdWVyeSIsImVuZFRpbWUiOjE2NDE0NTQ3OTU4MjMsImV4cG9ydEVuZFRpbWUiOjE2NDE0NTQ3OTU4MjMsImV4cG9ydFN0YXJ0VGltZSI6MTY0MTQ1NDE5NTgyMywiZXhwcmVzc1JhbmdlIjpmYWxzZSwiaGFzTmV4dCI6dHJ1ZSwiaW5wdXRNZXRyaWMiOiJDUFVVdGlsaXphdGlvbiIsImlucHV0TmFtZXNwYWNlIjoiYWNzX2Vjc19kYXNoYm9hcmQiLCJsaW1pdCI6MTAwMCwibG9nVGltZU1vZGUiOnRydWUsIm1hdGNoZXJzIjp7ImNoYWluIjpbeyJsYWJlbCI6InVzZXJJZCIsIm9wZXJhdG9yIjoiRVFVQUxTIiwidmFsdWUiOiIxNzM2NTExMTM0Mzg5MTEwIn1dfSwibWV0cmljIjoiQ1BVVXRpbGl6YXRpb24iLCJtZXRyaWNUeXBlIjoiTUVUUklDIiwibmFtZXNwYWNlIjoiYWNzX2Vjc19kYXNoYm9hcmQiLCJuZXh0UGtBZGFwdGVyIjp7fSwib2Zmc2V0IjowLCJwYXJlbnRVaWQiOjEyNzA2NzY2Nzk1NDY3MDQsInN0YXJ0VGltZSI6MTY0MTQ1NDE5NTgyMywic3RlcCI6LTEsInRpbWVvdXQiOjEyMCwid2luZG93Ijo2****"
  },
  "Code" : 200,
  "Success" : true
}

Códigos de erro

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