Consultar detalhes sobre vSwitches - : Central de Documentação do Alibaba Cloud

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para facilitar o uso, 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 de requisição

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeVSwitches	A operação que você deseja executar. Defina o valor como DescribeVSwitches.
RegionId	String	No	cn-hangzhou	O ID da região à qual o vSwitch pertence. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
VpcId	String	No	vpc-bp1opxu1zkhn**********	O ID do VPC ao qual o vSwitch pertence. Nota Especifique este parâmetro ou o parâmetro DedicatedHostGroupId.
ZoneId	String	No	cn-hangzhou-i	O ID da zona à qual o vSwitch pertence. Chame a operação DescribeAvailableZones para consultar o ID da zona. Ao especificar este parâmetro, os resultados da consulta são filtrados com base no valor informado e apenas os detalhes dos vSwitches implantados na zona especificada são retornados.
DedicatedHostGroupId	String	No	dhg-7a9********	O ID do cluster dedicado. Chame a operação DescribeDedicatedHostGroups para consultar o ID do cluster dedicado. Ao especificar este parâmetro, são retornados os detalhes de todos os vSwitches no VPC ao qual o cluster dedicado pertence. Nota Especifique este parâmetro ou o parâmetro VpcId.
PageNumber	Integer	No	1	O número da página a ser retornada. Valor padrão: 1.
PageSize	Integer	No	30	O número de entradas a retornar por página. Valores válidos: 1 a 50. Valor padrão: 30.
ResourceGroupId	String	No	rg-bp67acfmxazb4p****	O ID do grupo de recursos.

Parâmetros de resposta

Parameter	Type	Example	Description
RequestId	String	8A68AEA1-AFBD-53F8-9BBB-06555EAE5C0E	O ID da requisição.
TotalCount	Integer	2	O número total de entradas retornadas.
PageNumber	Integer	1	O número da página retornada.
PageSize	Integer	30	O número de entradas retornadas por página. O valor deste parâmetro é igual ao valor do parâmetro PageSize nos parâmetros de requisição.
VSwitchs	Array of VSwitch		Os detalhes dos vSwitches.
CidrBlock	String	172.16.0.0/24	O bloco CIDR dos vSwitches.
Description	String	VSwitchDescription	A descrição dos vSwitches.
IsDefault	Boolean	true	Indica se o vSwitch é o vSwitch padrão. Valores válidos: true: O vSwitch é o vSwitch padrão. false: O vSwitch não é o vSwitch padrão.
IzNo	String	cn-hangzhou-h	O ID da zona à qual o vSwitch pertence.
Status	String	Available	O status do vSwitch. Valores válidos: Pending: O vSwitch está sendo configurado. Available: O vSwitch está disponível.
VSwitchId	String	vsw-bp1pnaz94xc**********	O ID do vSwitch.
VSwitchName	String	test	O nome do vSwitch.

Exemplos

Exemplos de requisição

http(s)://rds.aliyuncs.com/?Action=DescribeVSwitches
&ResourceOwnerId=0
&RegionId=cn-hangzhou
&VpcId=vpc-bp1opxu1zkhn**********
&ZoneId=cn-hangzhou-h
&PageNumber=1
&PageSize=30
&Common request parameters

Exemplos de resposta com sucesso

XML format

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

<DescribeVSwitchesResponse>
    <VSwitchs>
        <IsDefault>false</IsDefault>
        <Status>Available</Status>
        <IzNo>cn-hangzhou-h</IzNo>
        <Description/>
        <VSwitchId>vsw-bp1pnaz94xc**********</VSwitchId>
        <CidrBlock>192.168.0.1/24</CidrBlock>
        <VSwitchName>test</VSwitchName>
    </VSwitchs>
    <VSwitchs>
        <IsDefault>true</IsDefault>
        <Status>Available</Status>
        <IzNo>cn-hangzhou-h</IzNo>
        <Description>System created default virtual switch.</Description>
        <VSwitchId>vsw-bp10aqj6o4l**********</VSwitchId>
        <CidrBlock>172.16.0.1/20</CidrBlock>
        <VSwitchName/>
    </VSwitchs>
    <TotalCount>2</TotalCount>
    <RequestId>A5362A78-1B78-53D7-AFBA-E375D9C26F2F</RequestId>
    <PageSize>30</PageSize>
    <PageNumber>1</PageNumber>
</DescribeVSwitchesResponse>

JSON format

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

{
  "VSwitchs" : [ {
    "IsDefault" : false,
    "Status" : "Available",
    "IzNo" : "cn-hangzhou-h",
    "Description" : "",
    "VSwitchId" : "vsw-bp1pnaz94xc**********",
    "CidrBlock" : "192.168.0.1/24",
    "VSwitchName" : "test"
  }, {
    "IsDefault" : true,
    "Status" : "Available",
    "IzNo" : "cn-hangzhou-h",
    "Description" : "System created default virtual switch.",
    "VSwitchId" : "vsw-bp10aqj6o4l**********",
    "CidrBlock" : "172.16.0.1/20",
    "VSwitchName" : ""
  } ],
  "TotalCount" : 2,
  "RequestId" : "A5362A78-1B78-53D7-AFBA-E375D9C26F2F",
  "PageSize" : 30,
  "PageNumber" : 1
}

Códigos de erro

HTTP status code	Error code	Error message	Description
400	InvalidVSwitchId.NotFound	Specified virtual switch is not found in specified VPC.	Nenhum vSwitch está disponível no VPC informado.
400	IncorrecttVpcId	The specified parameter VPCId is not valid.	O valor do parâmetro VpcId é inválido. Especifique um valor válido para o parâmetro VpcId.
400	InvalidIzNo.NotSupported	Specified VPC zone is not supported.	A zona especificada não é compatível com o VPC informado. Especifique um ID de zona válido e tente novamente.

Para obter a lista de códigos de erro, acesse o API Error Center.