ListVSwitchCidrReservations - - 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, qui 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	ListVSwitchCidrReservations	Opération à effectuer. Définissez la valeur sur ListVSwitchCidrReservations.
VSwitchId	String	Yes	vsw-25navfgbue4g****	ID du vSwitch dont vous souhaitez interroger les blocs CIDR réservés.
VSwitchCidrReservationIds.N	String	No	vcr-bp1m12saqteraw3rp****	ID du bloc CIDR réservé. Vous pouvez spécifier jusqu'à 10 ID.
VSwitchCidrReservationType	String	No	prefix	Type du bloc CIDR réservé. Définissez la valeur sur prefix. Remarque L'allocation d'un bloc CIDR pour une interface réseau élastique (ENI), qu'elle soit manuelle ou automatique, doit provenir du bloc CIDR réservé. Si le bloc CIDR réservé est épuisé, le système renvoie une erreur.
IpVersion	String	No	IPv4	Version IP du bloc CIDR réservé. Valeurs possibles : IPv4 (par défaut) IPv6
NextToken	String	No	FFmyTO70tTpLG6I3FmYAXGKPd****	Jeton de pagination utilisé dans la requête suivante pour récupérer la page de résultats suivante. Valeurs possibles : Ne spécifiez pas ce paramètre lors de la première requête. Spécifiez le jeton obtenu lors de la requête précédente comme valeur de NextToken.
MaxResults	Long	No	10	Nombre d'entrées à renvoyer par page. Valeurs possibles : 1 à 100. Valeur par défaut : 10.
RegionId	String	Yes	cn-hangzhou	ID de la région où le vSwitch est déployé. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	54B48E3D-DF70-471B-AA93-08E683A1B45	ID de la requête.
NextToken	String	FFmyTO70tTpLG6I3FmYAXGKPd****	Jeton utilisé pour la requête suivante. Valeurs possibles : Si NextToken ne renvoie aucune valeur, aucune autre requête n'est envoyée. Si NextToken n'est pas vide, la valeur indique le jeton à utiliser pour la requête suivante.
TotalCount	Long	10	Nombre total d'entrées renvoyées.
MaxResults	Long	10	Nombre d'entrées renvoyées par page.
VSwitchCidrReservations	Array of VSwitchCidrReservation		Liste des blocs CIDR réservés.
VpcId	String	vpc-bp1wdz2pdhgurz1od****	Cloud privé virtuel (VPC) auquel appartient le bloc CIDR réservé.
VSwitchId	String	vsw-25navfgbue4g****	ID du vSwitch auquel appartient le bloc CIDR réservé.
VSwitchCidrReservationId	String	vcr-bp1m12saqteraw3rp****	ID du bloc CIDR réservé.
VSwitchCidrReservationCidr	String	192.168.1.64/28	Bloc CIDR réservé.
VSwitchCidrReservationName	String	ReservationName	Nom du bloc CIDR réservé.
VSwitchCidrReservationDescription	String	ReservationDescription	Description du bloc CIDR réservé.
IpVersion	String	IPv4	Version IP du bloc CIDR réservé. Valeurs possibles : IPv4 (par défaut) IPv6
CreationTime	String	2023-03-14T10:02:37Z	Date de création du bloc CIDR réservé.
Type	String	prefix	Type du bloc CIDR réservé. Seule la valeur prefix (par défaut) peut être renvoyée.
AvailableCidrCount	Integer	10	Nombre de préfixes disponibles dans le bloc CIDR réservé.
AssignedCidrCount	Integer	6	Nombre de préfixes utilisés dans le bloc CIDR réservé.
Status	String	Assigned	État du bloc CIDR réservé. Valeurs possibles : Assigning Assigned Releasing Released

Exemples

Exemples de requêtes

http(s)://[Endpoint]/?Action=ListVSwitchCidrReservations
&VSwitchId=vsw-25navfgbue4g****
&VSwitchCidrReservationIds=["vcr-bp1m12saqteraw3rp****"]
&VSwitchCidrReservationType=prefix
&IpVersion=IPv4
&NextToken=FFmyTO70tTpLG6I3FmYAXGKPd****
&MaxResults=10
&RegionId=cn-hangzhou
&Common request parameters

Exemples de réponses réussies

Format XML

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

<ListVSwitchCidrReservationsResponse>
    <RequestId>54B48E3D-DF70-471B-AA93-08E683A1B45</RequestId>
    <NextToken>FFmyTO70tTpLG6I3FmYAXGKPd****</NextToken>
    <TotalCount>10</TotalCount>
    <MaxResults>10</MaxResults>
    <VSwitchCidrReservations>
        <VpcId>vpc-bp1wdz2pdhgurz1od****</VpcId>
        <VSwitchId>vsw-25navfgbue4g****</VSwitchId>
        <VSwitchCidrReservationId>vcr-bp1m12saqteraw3rp****</VSwitchCidrReservationId>
        <VSwitchCidrReservationCidr>192.168.1.64/28</VSwitchCidrReservationCidr>
        <VSwitchCidrReservationName>ReservationName</VSwitchCidrReservationName>
        <VSwitchCidrReservationDescription>ReservationDescription</VSwitchCidrReservationDescription>
        <IpVersion>IPv4</IpVersion>
        <CreationTime>2023-03-14T10:02:37Z</CreationTime>
        <Type>prefix</Type>
        <AvailableCidrCount>10</AvailableCidrCount>
        <AssignedCidrCount>6</AssignedCidrCount>
        <Status>Assigned</Status>
    </VSwitchCidrReservations>
</ListVSwitchCidrReservationsResponse>

Format JSON

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

{
  "RequestId" : "54B48E3D-DF70-471B-AA93-08E683A1B45",
  "NextToken" : "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "TotalCount" : 10,
  "MaxResults" : 10,
  "VSwitchCidrReservations" : [ {
    "VpcId" : "vpc-bp1wdz2pdhgurz1od****",
    "VSwitchId" : "vsw-25navfgbue4g****",
    "VSwitchCidrReservationId" : "vcr-bp1m12saqteraw3rp****",
    "VSwitchCidrReservationCidr" : "192.168.1.64/28",
    "VSwitchCidrReservationName" : "ReservationName",
    "VSwitchCidrReservationDescription" : "ReservationDescription",
    "IpVersion" : "IPv4",
    "CreationTime" : "2023-03-14T10:02:37Z",
    "Type" : "prefix",
    "AvailableCidrCount" : 10,
    "AssignedCidrCount" : 6,
    "Status" : "Assigned"
  } ]
}

Codes d'erreur

HttpCode	Error code	Error message	Description
400	IllegalParam.NextToken	The specified NextToken is invalid.	NextToken est défini sur une valeur non valide.

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