Tous les produits
Search
Centre de documentation

:DescribeSnapshotsUsage

Dernière mise à jour :Aug 18, 2026

Renvoie le nombre de snapshots stockés dans une région et leur taille totale.

Notes d'utilisation

Pour consulter l'utilisation des snapshots de chaque disque dans la région actuelle, appelez l'opération DescribeSnapshotLinks afin d'obtenir les informations sur les chaînes de snapshots.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. L'outil génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre

Type

Obligatoire

Exemple

Description

Action

String

Oui

DescribeSnapshotsUsage

Opération à effectuer. Définissez la valeur sur DescribeSnapshotsUsage.

RegionId

String

Oui

cn-hangzhou

ID de région du snapshot. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.

Paramètres de réponse

Paramètre

Type

Exemple

Description

SnapshotSize

Long

122

Taille totale des snapshots stockés dans la région actuelle. Unité : octets.

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

ID de la requête.

SnapshotCount

Integer

5

Nombre de snapshots stockés dans la région actuelle.

Exemples

Exemple de requête

https://ecs.aliyuncs.com/?Action=DescribeSnapshotsUsage
&RegionId=cn-hangzhou
&<Common request parameters>

Exemple de réponse réussie

Format XML

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

<DescribeSnapshotsUsageResponse>
	<SnapshotCount>5</SnapshotCount>
	<SnapshotSize>122</SnapshotSize>    
    <RequestId>ED5CF6DD-71CA-462C-9C94-A61A78A01479</RequestId>
</DescribeSnapshotsUsageResponse>

Format JSON

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

{
  "SnapshotCount" : "5",
  "SnapshotSize" : "122",
  "RequestId" : "ACD9BBB0-A9D1-46D7-9630-B7A69889E110"
}

Codes d'erreur

Code d'état HTTP

Code d'erreur

Message d'erreur

Description

403

InvalidParam.RegionId

The specified region is not exist.

La région spécifiée n'existe pas.

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