DescribeSnapshotLinks - Elastic Compute Service - Centre de documentation Alibaba Cloud

Consulte les chaînes d'instantanés des disques. Une chaîne d'instantanés se compose de tous les instantanés d'un disque. Chaque disque correspond à une chaîne d'instantanés.

Description de l'opération

Lorsque vous appelez cette opération, prenez note des éléments suivants :

Les paramètres de requête RegionId, DiskIds et InstanceId agissent comme des filtres. Ces paramètres ont une relation ET logique.
Si vous ne spécifiez aucun paramètre, les filtres ne prennent pas effet. Si DiskIds et SnapshotLinkIds sont tous deux des tableaux vides, les filtres sont considérés comme valides, mais un ensemble de résultats vide est renvoyé.

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

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

ecs:DescribeSnapshotLinks

get

*Toutes les ressources.

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région du disque. Vous pouvez appeler DescribeRegions pour consulter la liste des régions la plus récente.	cn-hangzhou
InstanceId	string	Non	L'identifiant de l'instance.	i-bp1h6jmbefj2cyqs****
DiskIds	string	Non	Les identifiants des disques. Vous pouvez spécifier jusqu'à 100 identifiants de disque à la fois. Le paramètre DiskIds est un tableau JSON. Séparez les identifiants de disque multiples par des virgules (,).	["d-bp1d6tsvznfghy7y**", "d-bp1ippxbaql9zet7", … "d-bp1ib7bcz07lcxa9**"]
SnapshotLinkIds	string	Non	Les identifiants des chaînes d'instantanés. Vous pouvez spécifier jusqu'à 100 identifiants de chaîne d'instantanés à la fois. Le paramètre SnapshotLinkIds est un tableau JSON. Séparez les identifiants multiples par des virgules (,).	["sl-bp1grgphbcc9brb5**", "sl-bp1c4izumvq0i5bs", … "sl-bp1akk7isz866dds**"]
PageNumber	integer	Non	Le numéro de page de la liste des états de disque. Valeur minimale : 1. Valeur par défaut : 1.	1
PageSize	integer	Non	Le nombre d'entrées par page pour une requête paginée. Valeurs valides : 1 à 100. Valeur par défaut : 10.	50
NextToken	string	Non	Le jeton de pagination. Définissez ce paramètre sur la valeur NextToken renvoyée lors de l'appel d'API précédent.	caeba0bbb2be03f84eb48b699f0a****
MaxResults	integer	Non	Le nombre maximal d'entrées par page pour une requête paginée. Valeur maximale : 100. Valeur par défaut : Si ce paramètre n'est pas spécifié ou est défini sur une valeur inférieure à 10, la valeur par défaut est 10. Si ce paramètre est défini sur une valeur supérieure à 100, la valeur par défaut est 100.	10

Éléments de réponse

Élément	Type	Description	Exemple
	object
NextToken	string	Le jeton de pagination renvoyé dans cet appel.	caeba0bbb2be03f84eb48b699f0a****
PageNumber	integer	Le numéro de page de la liste des chaînes d'instantanés.	1
PageSize	integer	Le nombre d'entrées par page que vous avez spécifié dans la requête.	50
RequestId	string	L'identifiant de la requête.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
SnapshotLinks	object
SnapshotLink	array<object>	La collection d'informations sur les chaînes d'instantanés.
	object
Category	string	Le type de la chaîne d'instantanés. Valeurs valides : standard : chaîne d'instantanés standard. archive : chaîne d'instantanés archivés. flash : chaîne d'instantanés à accès instantané.	standard
InstanceId	string	L'identifiant de l'instance.	i-bp1h6jmbefj2cyqs****
InstanceName	string	Le nom de l'instance.	testInstanceName
InstantAccess	boolean	Indique si la fonctionnalité d'accès instantané aux instantanés est activée. Valeurs valides : true : Activée. Seuls les disques ESSD prennent en charge cette fonctionnalité. false : Désactivée. L'instantané est un instantané standard pour lequel la fonctionnalité d'accès instantané n'est pas activée. Remarque Ce paramètre est obsolète. Les instantanés standard des disques ESSD ont été mis à niveau vers un accès instantané par défaut. Aucune configuration ni frais supplémentaires ne sont requis.	false
RegionId	string	L'identifiant de la région du disque source de la chaîne d'instantanés.	cn-hangzhou
SnapshotLinkId	string	L'identifiant de la chaîne d'instantanés.	sl-2ze0y1jwzpb1geqx****
SourceDiskId	string	L'identifiant du disque source. Ce champ est conservé même si le disque source de l'instantané a été supprimé.	d-bp1d6tsvznfghy7y****
SourceDiskName	string	Le nom du disque source.	testSourceDiskName
SourceDiskSize	integer	La capacité du disque source. Unité : Gio.	40
SourceDiskType	string	Le type du disque source. Valeurs valides : system : disque système. data : disque de données.	data
TotalCount	integer	Le nombre total d'instantanés.	1
TotalSize	integer	La taille totale de tous les instantanés dans la chaîne d'instantanés. Unité : octets.	2097152
TotalCount	integer	Le nombre total de chaînes d'instantanés. Remarque Lorsque vous utilisez les paramètres MaxResults et NextToken pour une requête paginée, la valeur TotalCount renvoyée n'est pas valide.	9

Exemples

JSON format

{
  "NextToken": "caeba0bbb2be03f84eb48b699f0a****",
  "PageNumber": 1,
  "PageSize": 50,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "SnapshotLinks": {
    "SnapshotLink": [
      {
        "Category": "standard",
        "InstanceId": "i-bp1h6jmbefj2cyqs****",
        "InstanceName": "testInstanceName",
        "InstantAccess": false,
        "RegionId": "cn-hangzhou",
        "SnapshotLinkId": "sl-2ze0y1jwzpb1geqx****",
        "SourceDiskId": "d-bp1d6tsvznfghy7y****",
        "SourceDiskName": "testSourceDiskName",
        "SourceDiskSize": 40,
        "SourceDiskType": "data",
        "TotalCount": 1,
        "TotalSize": 2097152
      }
    ]
  },
  "TotalCount": 9
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidInstanceId.NotFound	The specified instanceId is not exists.
400	InvalidRegionId	The specified regionId is invalid.	Le RegionId spécifié n'est pas valide.
400	InvalidSnapshotLinkIds	The specified snapshotLinkIds is invalid.	Le SnapshotLinkId spécifié n'est pas valide.
400	InvalidDiskIds	The specified diskIds is invalid.	Le disque spécifié n'est pas valide.
500	InternalError	The request processing has failed due to some unknown error.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.