ListVSwitchCidrReservations - : Central de Documentação do Alibaba Cloud

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	ListVSwitchCidrReservations	A operação a ser executada. Defina o valor como ListVSwitchCidrReservations.
VSwitchId	String	Sim	vsw-25navfgbue4g****	O ID do vSwitch cujos blocos CIDR reservados serão consultados.
VSwitchCidrReservationIds.N	String	Não	vcr-bp1m12saqteraw3rp****	O ID do bloco CIDR reservado. É possível especificar até 10 IDs.
VSwitchCidrReservationType	String	Não	prefix	O tipo do bloco CIDR reservado. Defina o valor como prefix. Nota Ao alocar um bloco CIDR para uma interface de rede elástica (ENI), seja manualmente ou pelo sistema, a alocação deve originar-se do bloco CIDR reservado. Se o bloco CIDR reservado estiver esgotado, o sistema retornará um erro.
IpVersion	String	Não	IPv4	A versão IP do bloco CIDR reservado. Valores válidos: IPv4 (padrão) IPv6
NextToken	String	Não	FFmyTO70tTpLG6I3FmYAXGKPd****	O token de paginação usado na próxima solicitação para recuperar uma nova página de resultados. Valores válidos: Não é necessário especificar este parâmetro na primeira solicitação. Especifique o token obtido na consulta anterior como valor de NextToken.
MaxResults	Long	Não	10	O número de entradas a serem retornadas em cada página. Valores válidos: 1 a 100. Valor padrão: 10.
RegionId	String	Sim	cn-hangzhou	O ID da região onde o vSwitch está implantado. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	54B48E3D-DF70-471B-AA93-08E683A1B45	O ID da solicitação.
NextToken	String	FFmyTO70tTpLG6I3FmYAXGKPd****	O token usado para a próxima consulta. Valores válidos: Se nenhum valor for retornado para NextToken, não haverá próximas consultas. Se NextToken não estiver vazio, o valor indica o token a ser usado na próxima consulta.
TotalCount	Long	10	O número total de entradas retornadas.
MaxResults	Long	10	O número de entradas retornadas por página.
VSwitchCidrReservations	Array of VSwitchCidrReservation		A lista de blocos CIDR reservados.
VpcId	String	vpc-bp1wdz2pdhgurz1od****	A Virtual Private Cloud (VPC) à qual o bloco CIDR reservado pertence.
VSwitchId	String	vsw-25navfgbue4g****	O ID do vSwitch ao qual o bloco CIDR reservado pertence.
VSwitchCidrReservationId	String	vcr-bp1m12saqteraw3rp****	O ID do bloco CIDR reservado.
VSwitchCidrReservationCidr	String	192.168.1.64/28	O bloco CIDR reservado.
VSwitchCidrReservationName	String	ReservationName	O nome do bloco CIDR reservado.
VSwitchCidrReservationDescription	String	ReservationDescription	A descrição do bloco CIDR reservado.
IpVersion	String	IPv4	A versão IP do bloco CIDR reservado. Valores válidos: IPv4 (padrão) IPv6
CreationTime	String	2023-03-14T10:02:37Z	O horário de criação do bloco CIDR reservado.
Type	String	prefix	O tipo do bloco CIDR reservado. Apenas prefix (padrão) pode ser retornado.
AvailableCidrCount	Integer	10	A quantidade de prefixos disponíveis no bloco CIDR reservado.
AssignedCidrCount	Integer	6	A quantidade de prefixos utilizados no bloco CIDR reservado.
Status	String	Assigned	O status do bloco CIDR reservado. Valores válidos: Assigning Assigned Releasing Released

Exemplos

Solicitações de exemplo

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

Respostas de sucesso de exemplo

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 erro

HttpCode	Código de erro	Mensagem de erro	Descrição
400	IllegalParam.NextToken	The specified NextToken is invalid.	O valor definido para NextToken é inválido.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.