DescribeSnapshotLinks - - Centre de documentation Alibaba Cloud

Description

Lors de l'appel à cette opération, tenez compte des points suivants :

Spécifiez plusieurs paramètres de requête tels que RegionId, DiskIds et InstanceId pour la recherche. Les paramètres spécifiés sont liés par une relation ET logique.
Seuls les paramètres spécifiés servent de conditions de filtrage. Si les paramètres DiskIds et SnapshotLinkIds sont tous deux définis comme des tableaux JSON vides, ils sont considérés comme des conditions de filtrage valides et la réponse renvoyée est vide.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	DescribeSnapshotLinks	L'opération à effectuer. Définissez la valeur sur DescribeSnapshotLinks.
RegionId	String	Oui	cn-hangzhou	L'ID de région du disque. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.
InstanceId	String	Non	i-bp1h6jmbefj2cyqs****	L'ID de l'instance.
DiskIds	String	Non	["d-bp1d6tsvznfghy7y", "d-bp1ippxbaql9zet7", ... "d-bp1ib7bcz07lcxa9"]	Les ID des disques. La valeur est un tableau JSON contenant jusqu'à 100 ID de disques. Séparez les différents ID de disques par des virgules (,).
SnapshotLinkIds	String	Non	["sl-bp1grgphbcc9brb5", "sl-bp1c4izumvq0i5bs", ... "sl-bp1akk7isz866dds"]	Les ID des chaînes de snapshots. La valeur est un tableau JSON contenant jusqu'à 100 ID de chaînes de snapshots. Séparez les différents ID de chaînes de snapshots par des virgules (,).
PageNumber	Integer	Non	1	Le numéro de la page à renvoyer. La numérotation des pages commence à 1. Valeur par défaut : 1
PageSize	Integer	Non	50	Le nombre d'entrées à renvoyer par page. Valeurs valides : 1 à 100. Valeur par défaut : 10.

Paramètres de réponse

Paramètre	Type	Exemple	Description
PageNumber	Integer	1	Le numéro de la page renvoyée.
PageSize	Integer	50	Le nombre d'entrées renvoyées par page.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	L'ID de la requête.
SnapshotLinks	Array of SnapshotLink		Détails sur les chaînes de snapshots.
SnapshotLink
Category	String	standard	La catégorie du snapshot. Remarque Ce paramètre sera supprimé à l'avenir. Nous vous recommandons d'utiliser le paramètre `InstantAccess` pour garantir la compatibilité future.
InstanceId	String	i-bp1h6jmbefj2cyqs****	L'ID de l'instance.
InstanceName	String	testInstanceName	Le nom de l'instance.
InstantAccess	Boolean	false	Indique si la fonctionnalité d'accès instantané est activée. Valeurs valides : true : la fonctionnalité d'accès instantané est activée. Cette fonctionnalité n'est disponible que pour les disques ESSD (Enhanced SSD). false : la fonctionnalité d'accès instantané est désactivée. Le snapshot est un snapshot standard pour lequel la fonctionnalité d'accès instantané est désactivée.
RegionId	String	cn-hangzhou	L'ID de la région où se trouve le disque source de la chaîne de snapshots.
SnapshotLinkId	String	sl-2ze0y1jwzpb1geqx****	L'ID de la chaîne de snapshots.
SourceDiskId	String	d-bp1d6tsvznfghy7y****	L'ID du disque source. Ce paramètre est conservé même si le disque source est supprimé.
SourceDiskName	String	testSourceDiskName	Le nom du disque source.
SourceDiskSize	Integer	40	La capacité du disque source. Unité : GiB.
SourceDiskType	String	data	La catégorie du disque source. Valeurs valides : system : disque système data : disque de données
TotalCount	Integer	1	Le nombre total de snapshots.
TotalSize	Long	2097152	La capacité totale de tous les snapshots de la chaîne de snapshots. Unité : octet.
TotalCount	Integer	9	Le nombre total de chaînes de snapshots.

Exemples

Exemples de requêtes

https://ecs.aliyuncs.com/?Action=DescribeSnapshotLinks
&RegionId=cn-hangzhou
&InstanceId=i-bp1h6jmbefj2cyqs****
&DiskIds=["d-bp1d6tsvznfghy7y****", "d-bp1ippxbaql9zet7****", ... "d-bp1ib7bcz07lcxa9****"]
&SnapshotLinkIds=["sl-bp1grgphbcc9brb5****", "sl-bp1c4izumvq0i5bs****", ... "sl-bp1akk7isz866dds****"]
&PageNumber=1
&PageSize=10
&<Common request parameters>

Exemples de réponses réussies

Format XML

<DescribeSnapshotLinksResponse>
      <SnapshotLinks>
            <SnapshotLink>
                  <InstanceName>testInstanceName1</InstanceName>
                  <TotalCount>1</TotalCount>
                  <Category>standard</Category>
                  <SourceDiskSize>40</SourceDiskSize>
                  <InstanceId>i-bp1dh0xo8nucqe1o****</InstanceId>
                  <SnapshotLinkId>sl-bp1hgvjgqo3wn8u7****</SnapshotLinkId>
                  <SourceDiskName>testSourceDiskName1</SourceDiskName>
                  <RegionId></RegionId>
                  <SourceDiskType>system</SourceDiskType>
                  <TotalSize>3806330880</TotalSize>
                  <SourceDiskId>d-bp149tb0mqn0boy6****</SourceDiskId>
            </SnapshotLink>
            <SnapshotLink>
                  <InstanceName>testInstanceName2</InstanceName>
                  <TotalCount>1</TotalCount>
                  <Category>standard</Category>
                  <InstanceId>i-bp1c84ts5f4b6t6z****</InstanceId>
                  <SnapshotLinkId>sl-bp163h35n7endbpv****</SnapshotLinkId>
                  <SourceDiskName>testSourceDiskName2</SourceDiskName>
                  <RegionId></RegionId>
                  <TotalSize>2709520384</TotalSize>
                  <SourceDiskType>data</SourceDiskType>
                  <SourceDiskId>d-bp1cl4hqnh0i2u5h****</SourceDiskId>
            </SnapshotLink>
      </SnapshotLinks>
      <PageNumber>1</PageNumber>
      <PageSize>2</PageSize>
      <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
      <TotalCount>9</TotalCount>
</DescribeSnapshotLinksResponse>

Format JSON

{
    "SnapshotLinks": {
        "SnapshotLink": [
            {
                "InstanceName": "testInstanceName1",
                "TotalCount": 1,
                "Category": "standard",
                "SourceDiskSize": 40,
                "InstanceId": "i-bp1dh0xo8nucqe1o****",
                "SnapshotLinkId": "sl-bp1hgvjgqo3wn8u7****",
                "SourceDiskName": "testSourceDiskName1",
                "RegionId": "",
                "SourceDiskType": "system",
                "TotalSize": 3806330880,
                "SourceDiskId": "d-bp149tb0mqn0boy6****"
            },
            {
                "InstanceName": "testInstanceName2",
                "TotalCount": 1,
                "Category": "standard",
                "InstanceId": "i-bp1c84ts5f4b6t6z****",
                "SnapshotLinkId": "sl-bp163h35n7endbpv****",
                "SourceDiskName": "testSourceDiskName2",
                "RegionId": "",
                "TotalSize": 2709520384,
                "SourceDiskType": "data",
                "SourceDiskId": "d-bp1cl4hqnh0i2u5h****"
            }
        ]
    },
    "PageNumber": 1,
    "PageSize": 1,
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
    "TotalCount": 2
}

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidRegionId	The specified regionId is invalid.	Le message d'erreur renvoyé indique que le paramètre RegionId spécifié n'est pas valide.
400	InvalidSnapshotLinkIds	The specified snapshotLinkIds is invalid.	Le message d'erreur renvoyé indique que le paramètre SnapshotLinkIds spécifié n'est pas valide.
400	InvalidDiskIds	The specified diskIds is invalid.	Le message d'erreur renvoyé indique que le paramètre DiskIds spécifié n'est pas valide.
500	InternalError	The request processing has failed due to some unknown error.	Le message d'erreur renvoyé indique qu'une erreur interne s'est produite. Réessayez ultérieurement. Si l'erreur persiste, soumettez un ticket.

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs de l'API.