DescribeAutoSnapshotPolicyEx - - Centre de documentation Alibaba Cloud

Débogage

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

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeAutoSnapshotPolicyEx	Opération à effectuer. Définissez la valeur sur DescribeAutoSnapshotPolicyEx.
RegionId	String	Yes	cn-hangzhou	ID de région de la politique de snapshot automatique. Appelez l'opération DescribeRegions pour obtenir la liste des régions disponibles.
AutoSnapshotPolicyId	String	No	sp-bp67acfmxazb4ph****	ID de la politique de snapshot automatique.
AutoSnapshotPolicyName	String	No	TestName	Nom de la politique de snapshot automatique.
PageNumber	Integer	No	1	Numéro de la page à renvoyer. La numérotation commence à 1. Valeur par défaut : 1.
PageSize	Integer	No	10	Nombre d'entrées par page. Valeur maximale : 100. Valeur par défaut : 10.
Tag.N.Key	String	No	TestKey	Clé du tag N de la politique de snapshot automatique. Valeurs valides pour N : 1 à 20. La clé ne doit pas être vide. Longueur maximale : 128 caractères. Elle ne peut pas commencer par acs: ou aliyun, ni contenir http:// ou https://.
Tag.N.Value	String	No	TestValue	Valeur du tag N de la politique de snapshot automatique. Valeurs valides pour N : 1 à 20. La valeur peut être vide. Longueur maximale : 128 caractères. Elle ne peut pas commencer par acs: ni contenir http:// ou https://.
ResourceGroupId	String	No	rg-aek2kkmhmhs****	ID du groupe de ressources. Si ce paramètre est spécifié, la réponse affiche au maximum 1 000 ressources appartenant au groupe de ressources indiqué. Remarque Les ressources du groupe de ressources par défaut s'affichent dans la réponse, quelle que soit la valeur de ce paramètre.

Paramètres de réponse

Parameter	Type	Example	Description
PageSize	Integer	10	Nombre d'entrées renvoyées par page.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID de la requête.
PageNumber	Integer	1	Numéro de la page renvoyée.
TotalCount	Integer	1	Nombre total de politiques de snapshot automatique.
AutoSnapshotPolicies	Array of AutoSnapshotPolicy		Détails des politiques de snapshot automatique.
AutoSnapshotPolicy
TimePoints	String	["1"]	Heures de création des snapshots automatiques. L'heure est exprimée en UTC+8. Unité : heures. Les valeurs valides vont de 0 à 23, correspondant aux heures pleines de 00:00:00 à 23:00:00. 1 correspond à 01:00:00. Vous pouvez spécifier plusieurs heures. La valeur du paramètre est un tableau JSON contenant jusqu'à 24 heures séparées par des virgules (,). Exemple : `["0", "1", ... "23"]`.
CreationTime	String	2019-12-10T16:00Z	Date de création de la politique de snapshot automatique. L'heure suit la norme ISO 8601 au format yyyy-MM-ddThh:mm:ssZ et est exprimée en UTC.
Status	String	Normal	État de la politique de snapshot automatique. Valeurs valides : Normal : la politique de snapshot automatique est active. Expire : la politique de snapshot automatique est inutilisable en raison d'impayés sur votre compte.
AutoSnapshotPolicyName	String	testAutoSnapshotPolicyName	Nom de la politique de snapshot automatique.
TargetCopyRegions	String	test	Remarque Ce paramètre est en aperçu sur invitation et n'est pas disponible pour tous les utilisateurs.
CopiedSnapshotsRetentionDays	Integer	0	Remarque Ce paramètre est en aperçu sur invitation et n'est pas disponible pour tous les utilisateurs.
AutoSnapshotPolicyId	String	sp-bp67acfmxazb4ph****	ID de la politique de snapshot automatique.
RetentionDays	Integer	7	Durée de conservation du snapshot automatique. Unité : jours. Valeurs valides : -1 : le snapshot automatique est conservé jusqu'à sa suppression. 1 à 65536 : le snapshot automatique est conservé pendant le nombre de jours spécifié.
RegionId	String	cn-hangzhou	ID de région de la politique de snapshot automatique.
DiskNums	Integer	1	Nombre de disques auxquels la politique de snapshot automatique est appliquée.
EnableCrossRegionCopy	Boolean	false	Remarque Ce paramètre est en aperçu sur invitation et n'est pas disponible pour tous les utilisateurs.
RepeatWeekdays	String	["6"]	Jours de la semaine de création des snapshots automatiques. Valeurs valides : 1 à 7, correspondant aux jours de la semaine. 1 correspond au lundi. Vous pouvez spécifier un ou plusieurs jours.
VolumeNums	Integer	2	Nombre de volumes étendus auxquels la politique de snapshot automatique est appliquée.
ResourceGroupId	String	rg-aek2kkmhmhs****	ID du groupe de ressources.
Tags	Array of Tag		Tags de la politique de snapshot automatique.
Tag
TagValue	String	TestValue	Valeur du tag de la politique de snapshot automatique.
TagKey	String	TestKey	Clé du tag de la politique de snapshot automatique.

Exemples

Exemples de requêtes

http(s)://ecs.aliyuncs.com/?Action=DescribeAutoSnapshotPolicyEx
&RegionId=cn-hangzhou
&AutoSnapshotPolicyId=sp-bp67acfmxazb4ph****
&AutoSnapshotPolicyName=p-23f2i9s4t
&PageNumber=1
&PageSize=1
&Tag=[{"Key":"TestKey","Value":"TestValue"}]
&ResourceGroupId=rg-aek2kkmhmhs****
&Common request parameters

Exemples de réponses réussies

XML format

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

<DescribeAutoSnapshotPolicyExResponse>
    <PageSize>10</PageSize>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <PageNumber>1</PageNumber>
    <TotalCount>1</TotalCount>
    <AutoSnapshotPolicies>
        <TimePoints>["1"]</TimePoints>
        <CreationTime>2021-09-01 15:30:01</CreationTime>
        <Status>Normal</Status>
        <AutoSnapshotPolicyName>testAutoSnapshotPolicyName</AutoSnapshotPolicyName>
        <TargetCopyRegions>test</TargetCopyRegions>
        <CopiedSnapshotsRetentionDays>0</CopiedSnapshotsRetentionDays>
        <AutoSnapshotPolicyId>sp-bp67acfmxazb4ph****</AutoSnapshotPolicyId>
        <RetentionDays>7</RetentionDays>
        <RegionId>cn-hangzhou</RegionId>
        <DiskNums>1</DiskNums>
        <EnableCrossRegionCopy>false</EnableCrossRegionCopy>
        <RepeatWeekdays>["6"]</RepeatWeekdays>
        <VolumeNums>2</VolumeNums>
        <ResourceGroupId>rg-aek2kkmhmhs****</ResourceGroupId>
        <Tags>
            <TagValue>TestValue</TagValue>
            <TagKey>TestKey</TagKey>
        </Tags>
    </AutoSnapshotPolicies>
</DescribeAutoSnapshotPolicyExResponse>

JSON format

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

{
  "PageSize" : 10,
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "PageNumber" : 1,
  "TotalCount" : 1,
  "AutoSnapshotPolicies" : [ {
    "TimePoints" : "[\"1\"]",
    "CreationTime" : "2021-09-01 15:30:01",
    "Status" : "Normal",
    "AutoSnapshotPolicyName" : "testAutoSnapshotPolicyName",
    "TargetCopyRegions" : "test",
    "CopiedSnapshotsRetentionDays" : 0,
    "AutoSnapshotPolicyId" : "sp-bp67acfmxazb4ph****",
    "RetentionDays" : 7,
    "RegionId" : "cn-hangzhou",
    "DiskNums" : 1,
    "EnableCrossRegionCopy" : false,
    "RepeatWeekdays" : "[\"6\"]",
    "VolumeNums" : 2,
    "ResourceGroupId" : "rg-aek2kkmhmhs****",
    "Tags" : [ {
      "TagValue" : "TestValue",
      "TagKey" : "TestKey"
    } ]
  } ]
}

Codes d'erreur

HTTP status code	Error codes	Error message	Description
400	InvalidRegionId.NotFound	The specified RegionId does not exist.	Le message d'erreur indique que le paramètre RegionId spécifié n'est pas valide.
400	InvalidTag.Mismatch	The specified Tag.n.Key and Tag.n.Value are not match.	Le message d'erreur indique que le paramètre Tag.N.Key spécifié ne correspond pas au paramètre Tag.N.Value spécifié.
400	InvalidTagCount	The specified tags are beyond the permitted range.	Le message d'erreur indique que le nombre de tags spécifiés a dépassé la limite autorisée.

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