Cursor - - Centre de documentation Alibaba Cloud

Définit la plage de données de surveillance à exporter. Cette opération renvoie les informations Cursor. Lors du premier appel à l'opération BatchExport, vous devez spécifier ces informations Cursor.

Prérequis

Le service Hybrid Cloud Monitoring est activé. Pour plus d'informations, consultez la rubrique Activate Hybrid Cloud Monitoring.

Informations contextuelles

Appelez cette opération pour obtenir les informations Cursor, puis appelez l'opération BatchExport afin d'exporter les données de surveillance.

Notes d'utilisation

Cette rubrique présente un exemple de définition des données de surveillance pour une métrique spécifique d'un service cloud donné. Dans cet exemple, le namespace du service cloud est défini sur acs_ecs_dashboard, la métrique sur cpu_idle, l'heure de début sur 1641627000000 et l'heure de fin sur 1641645000000. Le nombre de cœurs de CPU inactifs sur vos instances Elastic Compute Service (ECS) est mesuré toutes les 60 secondes, du 8 janvier 2022 à 15:30:00 au 8 janvier 2022 à 20:30:00. L'opération renvoie les informations Cursor.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. Il génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	Cursor	Opération à effectuer. Définissez la valeur sur Cursor.
Namespace	String	Oui	acs_ecs_dashboard	Namespace du service cloud. Pour plus d'informations sur les namespaces des services cloud, consultez l'Annexe 1 : Métriques.
Metric	String	Oui	cpu_idle	Métrique utilisée pour surveiller le service cloud. Pour plus d'informations sur les métriques des services cloud, consultez l'Annexe 1 : Métriques.
Period	Integer	Oui	60	Intervalle de temps utilisé pour mesurer la valeur de la métrique. Unité : secondes. Remarque Dans la plupart des cas, l'intervalle est de 60 secondes. Pour plus d'informations, consultez le paramètre `Period` dans l'Annexe 1 : Métriques.
StartTime	String	Oui	1641627000000	Début de la plage de temps à interroger. Spécifiez l'heure au format ISO 8601 yyyy-MM-ddTHH:mm:ssZ. L'heure doit être exprimée en UTC. Par exemple, 2023-01-01T00:00:00Z correspond au 1er janvier 2023 à 00:00:00 UTC. Remarque La durée de conservation (TTL) des données de surveillance varie selon la granularité temporelle dans CloudMonitor. Spécifiez un intervalle de temps approprié en fonction de la TTL correspondant à la valeur du paramètre `Period`.
EndTime	String	Non	1641645000000	Fin de la plage de temps à interroger. Unité : millisecondes. Remarque Cette valeur est un horodatage UNIX représentant le nombre de millisecondes écoulées depuis le 1er janvier 1970 à 00:00:00 UTC. Spécifiez l'heure au format ISO 8601 yyyy-MM-ddTHH:mm:ssZ. L'heure doit être exprimée en UTC. Par exemple, 2023-01-01T00:00:00Z correspond au 1er janvier 2023 à 00:00:00 UTC. Si vous ne définissez pas l'heure de fin, celle-ci est infinie. Vous pouvez laisser ce paramètre vide dans les scénarios d'exportation en temps réel. La durée de conservation (TTL) des données de surveillance varie selon la granularité temporelle dans CloudMonitor. Spécifiez un intervalle de temps approprié en fonction de la TTL correspondant à la valeur du paramètre `Period`.
Matchers	Tableau de Matcher	Non		Informations de dimension de la métrique.

Pour plus d'informations sur les paramètres de requête communs, consultez la rubrique Common parameters.

Paramètres de réponse

Paramètre	Type	Exemple	Description
Message	String	success	Message renvoyé.
Cursor	String	v2.5eyJiYXRjaGVzIjoxLCJidWNrZXRCeXRlcyI6IndBPT0iLCJidWNrZXRzIjo0LCJjdXJyZW50QnVja2V0IjotNjQsImN1cnJlbnRUYXJnZXRUaW1lU2xvdCI6MTY3ODc1MjAwMCwiZW5kVGltZSI6MTY3ODc4MjQxOTAwMCwiZXhwb3J0RW5kVGltZSI6MTY3ODc4MjQxOTAwMCwiZXhwb3J0U3RhcnRUaW1lIjoxNjc4NzgxODE5MDAwLCJleHByZXNzUmFuZ2UiOmZhbHNlLCJoYXNOZXh0Ijp0cnVlLCJpbmRleCI6MCwibGF0ZXN0TG9nVGltZSI6MCwibWF0Y2hlcnMiOnsiY2hhaW4iOlt7ImxhYmVsIjoidXNlcklkIiwib3BlcmF0b3IiOiJFUVVBTFMiLCJ2YWx1ZSI6IjEyNzA2NzY2Nzk1NDY3MDQifV0sImxvY2tlZCI6dHJ1ZX0sIm1ldHJpYyI6IlNwbGl0cndQcm94eU1heFJlc3BvbnNlU2l6ZSIsIm1ldHJpY1R5cGUiOiJNRVRSSUMiLCJuYW1lc3BhY2UiOiJhY3Nfa3ZzdG9yZV9leCIsIm5leHRQa0FkYXB0ZXIiOnsiZGltIjoiVjowXG5EOmB1c2VySWRgPTEyNzA2NzY2Nzk1NDY3MDQsYGluc3RhbmNlSWRgPXItcmo5ZjlzMTlsc3V1MXd1bnVyLGBub2RlSWRgPXItcmo5ZjlzMTlsc3V1MXd1bnVyLXByb3h5LTIsXG4iLCJtZXRhIjoiXG5WOjBcbk06YWNzX2t2c3RvcmVfZXgvU3BsaXRyd1Byb3h5TWF4UmVzcG9uc2VTaXplXG5XOjYwXG5COjRcbkk6LTFcblQ6MFxuQzpgQXZlcmFnZWAsYE1heGltdW1gLGBfX2NvdW50X19gLGBfX3RzX19gXG4iLCJyZCI6InN1YkFMU0RwWXY2K0t6aENQQUFBWkErNUFKMEpjbGErRGd2V0hFNWxDSHMvbGtqR2FXYTFJTkVwdFE9PSIsInRhZyI6IiJ9LCJvZmZzZXQiOjAsIm9mZnNldERpZ2l0Ijo0NTU0NTczNDQyMTc4NDIxMjIsInN0YXJ0VGltZSI6MTY3ODc4MTgxOTAwMCwic3RlcCI6LTEsInRhZ01hdGNoZXJzIjp7ImNoYWluIjpbXSwibG9ja2VkIjp0cnVlfSwidGFyZ2V0VGltZVNsb3RzIjpbMTY3ODY2NTYwMCwxNjc4NzUyMDAwXSwidXVpZCI6ImQwMmFhZmY1LWU3ZGQtNDUyYy0***********	Le paramètre Cursor sert de paramètre d'entrée pour l'exportation des données dans l'opération BatchExport.
Code	Integer	200	Code d'état. Remarque Le code d'état 200 indique que la requête a abouti.
Success	Boolean	true	Indique si la requête a abouti. Valeurs possibles : true false
RequestId	String	915C2D7A-E6A4-17C3-8E13-4DBDD61E7919	ID de la requête.

Exemples

Exemples de requêtes

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>

Exemples de réponses réussies

Format 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>

Format 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
}

Codes d'erreur

Accédez au Centre d'erreurs pour afficher davantage de codes d'erreur.

Pour obtenir la liste des codes d'erreur, consultez la rubrique Service error codes.