ListVSwitchCidrReservations - - Centro de documentación de Alibaba Cloud

Consulta los bloques CIDR reservados para un vSwitch.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, se recomienda llamar a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDKs.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	ListVSwitchCidrReservations	La operación que desea ejecutar. Establezca el valor en ListVSwitchCidrReservations.
VSwitchId	String	Sí	vsw-25navfgbue4g****	El ID del vSwitch del cual desea consultar los bloques CIDR reservados.
VSwitchCidrReservationIds.N	String	No	vcr-bp1m12saqteraw3rp****	El ID del bloque CIDR reservado. Especifique hasta 10 IDs.
VSwitchCidrReservationType	String	No	prefix	El tipo de bloque CIDR reservado. Establezca el valor en prefix. Nota Cuando usted o el sistema asignan un bloque CIDR a una interfaz de red elástica (ENI), este debe provenir del bloque CIDR reservado. Si el bloque CIDR reservado se agota, el sistema devuelve un error.
IpVersion	String	No	IPv4	La versión IP del bloque CIDR reservado. Valores válidos: IPv4 (predeterminado) IPv6
NextToken	String	No	FFmyTO70tTpLG6I3FmYAXGKPd****	El token de paginación utilizado en la siguiente solicitud para recuperar una nueva página de resultados. Valores válidos: No es necesario especificar este parámetro en la primera solicitud. Especifique el token obtenido de la consulta anterior como valor de NextToken.
MaxResults	Long	No	10	El número de entradas por devolver en cada página. Valores válidos: de 1 a 100. Valor predeterminado: 10.
RegionId	String	Sí	cn-hangzhou	El ID de la región donde se despliega el vSwitch. Llame a la operación DescribeRegions para consultar la lista de regiones más reciente.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	54B48E3D-DF70-471B-AA93-08E683A1B45	El ID de la solicitud.
NextToken	String	FFmyTO70tTpLG6I3FmYAXGKPd****	El token utilizado para la siguiente consulta. Valores válidos: Si no se devuelve ningún valor para NextToken, no se envían más consultas. Si NextToken no está vacío, el valor indica el token para la siguiente consulta.
TotalCount	Long	10	El número total de entradas devueltas.
MaxResults	Long	10	El número de entradas devueltas por página.
VSwitchCidrReservations	Array of VSwitchCidrReservation		La lista de bloques CIDR reservados.
VpcId	String	vpc-bp1wdz2pdhgurz1od****	La nube privada virtual (VPC) a la que pertenece el bloque CIDR reservado.
VSwitchId	String	vsw-25navfgbue4g****	El ID del vSwitch al que pertenece el bloque CIDR reservado.
VSwitchCidrReservationId	String	vcr-bp1m12saqteraw3rp****	El ID del bloque CIDR reservado.
VSwitchCidrReservationCidr	String	192.168.1.64/28	El bloque CIDR reservado.
VSwitchCidrReservationName	String	ReservationName	El nombre del bloque CIDR reservado.
VSwitchCidrReservationDescription	String	ReservationDescription	La descripción del bloque CIDR reservado.
IpVersion	String	IPv4	La versión IP del bloque CIDR reservado. Valores válidos: IPv4 (predeterminado) IPv6
CreationTime	String	2023-03-14T10:02:37Z	La hora de creación del bloque CIDR reservado.
Type	String	prefix	El tipo de bloque CIDR reservado. Solo puede devolverse prefix (predeterminado).
AvailableCidrCount	Integer	10	El número de prefijos disponibles en el bloque CIDR reservado.
AssignedCidrCount	Integer	6	El número de prefijos usados en el bloque CIDR reservado.
Status	String	Assigned	El estado del bloque CIDR reservado. Valores válidos: Assigning Assigned Releasing Released

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

Formato 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>

Formato 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"
  } ]
}

Códigos de error

HttpCode	Código de error	Mensaje de error	Descripción
400	IllegalParam.NextToken	The specified NextToken is invalid.	El valor establecido para NextToken no es válido.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.