Consulte la liste des points de sauvegarde.
Description de l'opération
Cette opération consulte une liste de points de sauvegarde en fonction de la ressource protégée (ProtectedResourceId). Limites :
La ressource protégée doit exister et SourceType doit correspondre au type de source de données de la ressource protégée.
MaxResults doit être supérieur à 1. Valeur par défaut : 10.
Skip doit être un entier non négatif et un multiple de MaxResults. Lorsque Skip est supérieur à 0, vous ne pouvez pas spécifier NextToken en même temps.
CompleteTimeStart et CompleteTimeEnd sont des horodatages UNIX en secondes. La plage de filtrage est [CompleteTimeStart, CompleteTimeEnd).
Si aucun champ de tri n'est spécifié, les résultats sont triés par heure de fin de sauvegarde (CompleteTime) par ordre décroissant par défaut.
Testez maintenant
Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.
Test
Autorisation RAM
Paramètres de requête
|
Paramètre |
Type |
Requis |
Description |
Exemple |
| NextToken |
string |
Non |
Le jeton de pagination. Il n'est pas nécessaire de spécifier ce paramètre pour la première requête. Pour les pages suivantes, transmettez la valeur NextToken renvoyée par la requête précédente. Un NextToken vide indique qu'il n'y a plus de pages disponibles. Ce paramètre ne peut pas être utilisé conjointement avec Skip. |
eyJJbmRleCI6NjUwMX0= |
| MaxResults |
integer |
Non |
Le nombre maximal de résultats à renvoyer dans une requête paginée. Valeur par défaut : 10. La valeur doit être supérieure à 1. |
10 |
| Skip |
integer |
Non |
Le nombre d'entrées à ignorer. La valeur doit être un entier non négatif et un multiple de MaxResults. Ce paramètre ne peut pas être utilisé conjointement avec NextToken. |
0 |
| SourceType |
string |
Oui |
Le type de source de données. La valeur doit correspondre au type de source de données de la ressource protégée (ProtectedResourceId). Les types de sources de données pris en charge sont répertoriés dans les valeurs valides. Valeurs valides :
|
ECS_FILE |
| ProtectedResourceId |
string |
Oui |
L'identifiant de la ressource protégée. La ressource protégée doit exister et son type de source de données doit correspondre au paramètre SourceType. |
pr-123***7890 |
| VaultId |
string |
Non |
L'identifiant du coffre. Il s'agit d'une condition de filtrage facultative. S'il est spécifié, seuls les points de sauvegarde du coffre spécifié sont renvoyés. |
v-00030j3c******sn |
| CompleteTimeStart |
integer |
Non |
L'heure de début de finalisation. Un horodatage UNIX, en secondes. Seuls les points de sauvegarde dont l'heure de finalisation est supérieure ou égale à cette valeur sont renvoyés. |
1776059082 |
| CompleteTimeEnd |
integer |
Non |
L'heure de fin de finalisation. Un horodatage UNIX, en secondes. Seuls les points de sauvegarde dont l'heure de finalisation est antérieure à cette valeur sont renvoyés. |
1776059382 |
| PlanId |
string |
Non |
L'identifiant du plan de sauvegarde. Il s'agit d'une condition de filtrage facultative. S'il est spécifié, seuls les points de sauvegarde du plan de sauvegarde spécifié sont renvoyés. |
po-0000****123 |
Éléments de réponse
|
Élément |
Type |
Description |
Exemple |
|
object |
La réponse. |
||
| RequestId |
string |
L'identifiant de la requête. |
17189276-****-****-****-0FF51B5A41A0 |
| Code |
string |
Le code de retour. Une valeur de 200 indique un succès. |
200 |
| Message |
string |
Le message de retour. La valeur « successful » est renvoyée pour les requêtes réussies. Un message d'erreur est renvoyé pour les requêtes ayant échoué. |
successful |
| Success |
boolean |
Indique si la requête a réussi.
|
true |
| Snapshots |
array<object> |
La liste des instantanés. |
|
|
object |
Les informations de l'instantané. |
||
| Status |
string |
L'état de l'instantané. Valeurs valides :
|
COMPLETE |
| SnapshotHash |
string |
La valeur de hachage de l'instantané. |
f2ac5fd243**********************bc4451777be019 |
| VaultId |
string |
L'identifiant du coffre qui stocke les données de sauvegarde. |
v-00030j*******sn |
| ActualItems |
integer |
Le nombre réel de nœuds. |
6 |
| BackupType |
string |
Le type de sauvegarde. La valeur est COMPLETE, ce qui indique une sauvegarde complète. |
COMPLETE |
| CreateTime |
integer |
L'heure de création de l'instantané, en secondes. |
1607436917 |
| ActualBytes |
integer |
La quantité réelle de données écrites, en octets. |
600 |
| SourceType |
string |
Le type de source de données. Valeurs valides :
|
ECS_FILE |
| ClientId |
string |
Lorsque SourceType est défini sur ECS_FILE ou File, ce paramètre indique l'identifiant du client de sauvegarde. Dans les autres cas, il indique l'identifiant de la source de données de sauvegarde. |
c-********************* |
| BytesTotal |
integer |
La quantité totale de données à sauvegarder, en octets. |
1000 |
| ItemsDone |
integer |
Le nombre de nœuds qui ont été sauvegardés. |
8 |
| CompleteTime |
integer |
L'heure de finalisation de la sauvegarde. Un horodatage UNIX, en secondes. |
1642496679 |
| Retention |
integer |
La période de rétention de la sauvegarde, en jours. |
7 |
| CreatedTime |
integer |
L'heure de création de la sauvegarde. |
1642496679 |
| InstanceId |
string |
L'identifiant de l'instance de la source de données de sauvegarde. |
i-********************* |
| ErrorFile |
string |
Le fichier qui enregistre les informations d'échec de sauvegarde, y compris les informations sur les sauvegardes partiellement terminées. |
temp/report/123456789/job-xxxxxxxxx_failed.zip |
| SnapshotId |
string |
L'identifiant de l'instantané. |
s-00047mxg17p26*****b |
| JobId |
string |
L'identifiant de la tâche de sauvegarde. |
job-00030j3chkt******2 |
| Path |
string |
Le chemin source. |
/home |
| ItemsTotal |
integer |
Le nombre total de nœuds à sauvegarder. |
10 |
| BytesDone |
integer |
La quantité de données qui ont été sauvegardées, en octets. |
800 |
| Paths |
array |
La liste des chemins sources. |
|
|
string |
Le chemin source. |
/home |
|
| InstanceName |
string |
Le nom de l'instance Tablestore. |
instancename |
| TableName |
string |
Le nom de la table de données dans l'instance Tablestore. |
table2 |
| RangeStart |
integer |
L'heure de début de l'exécution de la tâche de sauvegarde Tablestore. Un horodatage UNIX, en millisecondes. |
1642492553038 |
| RangeEnd |
integer |
L'heure de fin de l'exécution de la tâche de sauvegarde Tablestore. Un horodatage UNIX, en millisecondes. |
1642521709966 |
| ExpireTime |
integer |
L'heure d'expiration de la sauvegarde. |
1771901707 |
| StorageClass |
string |
La classe de stockage. Valeurs valides :
|
STANDARD |
| ArchiveTime |
integer |
L'heure à laquelle la sauvegarde a été archivée. |
1640334062 |
| Include |
string |
Les chemins sources inclus dans la tâche de sauvegarde. |
["/test/example_cn-huhehaote_3.txt", "/test/example_cn-huhehaote_9.txt", "/test/example_cn-huhehaote_5.txt", "/test/example_cn-huhehaote_1.txt", "/test/example_cn-huhehaote_7.txt"] |
| Exclude |
string |
Les chemins sources exclus de la tâche de sauvegarde. |
["/test/example_cn-hangzhou_7.txt", "/test/example_cn-hangzhou_1.txt", "/test/example_cn-hangzhou_3.txt", "/test/example_cn-hangzhou_9.txt", "/test/example_cn-hangzhou_6.txt"] |
| ProtectedDataSize |
integer |
La taille des données source protégées, en octets. Lorsque SourceType est défini sur ECS_FILE, cela indique la capacité du disque cloud protégé. |
42949672960 |
| PlanId |
string |
L'identifiant du plan de sauvegarde. |
po-123***7890 |
| TotalCount |
integer |
Le nombre total d'enregistrements. |
3 |
| MaxResults |
integer |
Le nombre maximal de résultats renvoyés. |
10 |
| NextToken |
string |
Le jeton pour la page suivante. Un NextToken vide indique qu'il n'y a plus de pages disponibles. |
aWQj********MCMy |
Exemples
JSON format
{
"RequestId": "17189276-****-****-****-0FF51B5A41A0",
"Code": "200",
"Message": "successful",
"Success": true,
"Snapshots": [
{
"Status": "COMPLETE",
"SnapshotHash": "f2ac5fd243**********************bc4451777be019",
"VaultId": "v-00030j*******sn",
"ActualItems": 6,
"BackupType": "COMPLETE",
"CreateTime": 1607436917,
"ActualBytes": 600,
"SourceType": "ECS_FILE",
"ClientId": "c-*********************",
"BytesTotal": 1000,
"ItemsDone": 8,
"CompleteTime": 1642496679,
"Retention": 7,
"CreatedTime": 1642496679,
"InstanceId": "i-*********************",
"ErrorFile": "temp/report/123456789/job-xxxxxxxxx_failed.zip",
"SnapshotId": "s-00047mxg17p26*****b",
"JobId": "job-00030j3chkt******2",
"Path": "/home",
"ItemsTotal": 10,
"BytesDone": 800,
"Paths": [
"/home"
],
"InstanceName": "instancename",
"TableName": "table2",
"RangeStart": 1642492553038,
"RangeEnd": 1642521709966,
"ExpireTime": 1771901707,
"StorageClass": "STANDARD",
"ArchiveTime": 1640334062,
"Include": "[\\\"/test/example_cn-huhehaote_3.txt\\\", \\\"/test/example_cn-huhehaote_9.txt\\\", \\\"/test/example_cn-huhehaote_5.txt\\\", \\\"/test/example_cn-huhehaote_1.txt\\\", \\\"/test/example_cn-huhehaote_7.txt\\\"]",
"Exclude": "[\\\"/test/example_cn-hangzhou_7.txt\\\", \\\"/test/example_cn-hangzhou_1.txt\\\", \\\"/test/example_cn-hangzhou_3.txt\\\", \\\"/test/example_cn-hangzhou_9.txt\\\", \\\"/test/example_cn-hangzhou_6.txt\\\"]",
"ProtectedDataSize": 42949672960,
"PlanId": "po-123***7890"
}
],
"TotalCount": 3,
"MaxResults": 10,
"NextToken": "aWQj********MCMy"
}Codes d'erreur
Consultez Codes d'erreur pour la liste complète.
Notes de version
Consultez Notes de version pour la liste complète.