CreateCacheAnalysisJob - - Centre de documentation Alibaba Cloud

Avant d'appeler cette opération, tenez compte des points suivants :

Si vous utilisez un SDK Alibaba Cloud ou un SDK Database Autonomy Service (DAS) pour appeler cette opération, nous vous recommandons d'utiliser la dernière version du SDK.
Si vous utilisez un SDK pour appeler DAS, définissez l'ID de région sur cn-shanghai.
Cette opération s'applique uniquement aux instances ApsaraDB for Redis Community Edition et aux instances optimisées pour les performances d'ApsaraDB for Redis Enhanced Edition (Tair).

Remarque

ApsaraDB for Redis 7.0 et les modules personnalisés ne sont pas pris en charge.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	CreateCacheAnalysisJob	Opération à effectuer. Définissez la valeur sur CreateCacheAnalysisJob.
InstanceId	String	Yes	r-bp18ff4a195d****	ID de l'instance ApsaraDB for Redis.
NodeId	String	No	r-x****-db-0	ID du nœud de données sur l'instance. Spécifiez ce paramètre pour interroger les informations de surveillance du nœud indiqué. Remarque Si vous spécifiez BackupSetId, le système ignore la valeur de NodeId. Appelez l'opération DescribeLogicInstanceTopology pour interroger l'ID du nœud.
BackupSetId	String	No	12345	ID du fichier de sauvegarde. Appelez l'opération DescribeBackups pour interroger l'ID du fichier de sauvegarde. Pour spécifier plusieurs ID de fichiers de sauvegarde, séparez-les par des virgules (,). Par exemple, définissez ce paramètre sur `12345,67890`. Si vous omettez ce paramètre, le système sauvegarde automatiquement les données et effectue une analyse du cache sur le fichier de sauvegarde.
Separators	String	No	&	Délimiteurs utilisés pour identifier les préfixes des clés. Vous n'avez pas besoin de spécifier ce paramètre si l'un des délimiteurs par défaut suivants est utilisé : `: ; , _ - + @ = \| #`

Paramètres de réponse

Parameter	Type	Example	Description
Message	String	Successful	Message renvoyé. Remarque En cas de succès de la requête, la valeur Successful est renvoyée. En cas d'échec, un message d'erreur contenant des informations telles qu'un code d'erreur est renvoyé.
RequestId	String	B6D17591-B48B-4D31-9CD6-9B9796B2****	ID de la requête.
Data	Object		Détails de la tâche.
TaskState	String	BACKUP	État de la tâche d'analyse du cache. Valeurs possibles : BACKUP : Sauvegarde des données en cours. ANALYZING : Analyse des données en cours. FINISHED : Analyse des données terminée. FAILED : Échec.
JobId	String	sf79-sd99-sa37-****	ID de la tâche d'analyse du cache. Remarque Ce paramètre permet d'interroger une tâche d'analyse du cache spécifique. La création d'une tâche d'analyse du cache via l'opération CreateCacheAnalysisJob prend un certain temps. Par conséquent, les résultats de l'analyse ne sont pas immédiatement disponibles. Spécifiez ce paramètre lors de l'appel de l'opération DescribeCacheAnalysisJob pour interroger les résultats d'analyse de la tâche indiquée.
Message	String	Successful	Message renvoyé. Remarque En cas de succès de la requête, la valeur Successful est renvoyée. En cas d'échec, un message d'erreur contenant des informations telles qu'un code d'erreur est renvoyé.
BigKeys	Array of KeyInfo		Détails des grandes clés. Les grandes clés renvoyées sont triées par ordre décroissant selon le nombre d'octets occupés.
KeyInfo
Type	String	hash	Type de données de l'instance ApsaraDB for Redis.
Db	Integer	0	Nom de la base de données.
ExpirationTimeMillis	Long	1596256542547	Heure d'expiration de la clé, en millisecondes. Une valeur de 0 indique que la clé n'expire pas.
Key	String	task_x****	Nom de la clé.
Encoding	String	hashtable	Type de données de la clé.
Bytes	Long	12345	Nombre d'octets occupés par la clé.
NodeId	String	r-x****-db-0	ID du nœud de données sur l'instance.
Count	Long	127	Nombre d'éléments dans la clé.
InstanceId	String	r-bp18ff4a195d****	ID de l'instance de base de données.
NodeId	String	r-x****-db-0	ID du nœud de données sur l'instance.
Code	String	200	Code de réponse.
Success	String	true	Indique si la requête a abouti. Valeurs possibles : true false

Exemples

Exemple de requête

http(s)://das.cn-shanghai.aliyuncs.com/?Action=CreateCacheAnalysisJob
&InstanceId=r-bp18ff4a195d****
&NodeId=r-x****-db-0
&BackupSetId=12345
&Separators=&
&Common request parameters

Exemple de réponse réussie

XML format

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

<CreateCacheAnalysisJobResponse>
    <Message>Successful</Message>
    <RequestId>B6D17591-B48B-4D31-9CD6-9B9796B2****</RequestId>
    <Data>
        <TaskState>BACKUP</TaskState>
        <JobId>sf79-sd99-sa37-****</JobId>
        <Message>Successful</Message>
        <BigKeys>
            <Type>hash</Type>
            <Db>0</Db>
            <ExpirationTimeMillis>1596256542547</ExpirationTimeMillis>
            <Key>task_x****</Key>
            <Encoding>hashtable</Encoding>
            <Bytes>12345</Bytes>
            <NodeId>r-x****-db-0</NodeId>
            <Count>127</Count>
        </BigKeys>
        <InstanceId>r-bp18ff4a195d****</InstanceId>
        <NodeId>r-x****-db-0</NodeId>
    </Data>
    <Code>200</Code>
    <Success>true</Success>
</CreateCacheAnalysisJobResponse>

JSON format

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

{
  "Message" : "Successful",
  "RequestId" : "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Data" : {
    "TaskState" : "BACKUP",
    "JobId" : "sf79-sd99-sa37-****",
    "Message" : "Successful",
    "BigKeys" : [ {
      "Type" : "hash",
      "Db" : 0,
      "ExpirationTimeMillis" : 1596256542547,
      "Key" : "task_x****",
      "Encoding" : "hashtable",
      "Bytes" : 12345,
      "NodeId" : "r-x****-db-0",
      "Count" : 127
    } ],
    "InstanceId" : "r-bp18ff4a195d****",
    "NodeId" : "r-x****-db-0"
  },
  "Code" : "200",
  "Success" : "true"
}

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	InvalidParams	The request parameters are invalid.	Les paramètres de requête ne sont pas valides.
403	NoPermission	You are not authorized to do this action.	Vous n'êtes pas autorisé à effectuer cette opération.

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur du service.