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 tels que RegionId, DiskIds et InstanceId agissent comme des filtres. Un ET logique est utilisé entre ces paramètres.
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 la réponse est vide.

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

*All Resource

*

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 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****
PageSize	integer	Le nombre d'entrées par page tel que spécifié dans la requête.	50
RequestId	string	L'identifiant de la requête.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
PageNumber	integer	Le numéro de page de la liste des chaînes d'instantanés.	1
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. Pour la pagination, utilisez plutôt `MaxResults` et `NextToken`.	9
SnapshotLinks	object
SnapshotLink	array<object>	La collection d'informations sur les chaînes d'instantanés.
	object
InstantAccess	boolean	Indicates whether the snapshot instant access feature is enabled. Valid values: true: Enabled. Only enterprise SSDs (ESSDs) support this feature. false: Disabled. The snapshot is a standard snapshot without the snapshot instant access feature enabled. Remarque This parameter is deprecated. Standard snapshots of enterprise SSDs have been upgraded to instant access by default. No additional configuration or cost is required.	false
TotalSize	integer	The total size of all snapshots in the snapshot chain. Unit: bytes.	2097152
SourceDiskName	string	The name of the source disk.	testSourceDiskName
SourceDiskSize	integer	The capacity of the source disk. Unit: GiB.	40
SourceDiskType	string	The type of the source disk. Valid values: system: system disk. data: data disk.	data
InstanceId	string	The instance ID.	i-bp1h6jmbefj2cyqs****
SnapshotLinkId	string	The snapshot chain ID.	sl-2ze0y1jwzpb1geqx****
TotalCount	integer	The total number of snapshots.	1
RegionId	string	The region ID of the source disk of the snapshot chain.	cn-hangzhou
SourceDiskId	string	The source disk ID. This field is retained even if the source disk of the snapshot has been deleted.	d-bp1d6tsvznfghy7y****
InstanceName	string	Instance name	testInstanceName
Category	string	The type of the snapshot chain. Valid values: standard: standard snapshot chain. archive: archive snapshot chain. flash: instant access snapshot chain.	standard

Exemples

JSON format

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

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.	The specified RegionId parameter is invalid.
400	InvalidSnapshotLinkIds	The specified snapshotLinkIds is invalid.	The specified SnapshotLinkId parameter is invalid.
400	InvalidDiskIds	The specified diskIds is invalid.	The specified DiskIds parameter is invalid.
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.