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

Consulta informações detalhadas de um vSwitch especificado.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de requisição

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeVSwitchAttributes	Operação a ser executada. Defina o valor como DescribeVSwitchAttributes.
VSwitchId	String	Sim	vsw-25naue4g****	ID do vSwitch.
RegionId	String	Não	cn-hangzhou	ID da região da Virtual Private Cloud (VPC) à qual a tabela de rotas pertence. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
DryRun	Boolean	Não	false	Especifica se deve executar apenas uma simulação, sem realizar a requisição real. Valores válidos: true: executa uma simulação. O sistema verifica a requisição em busca de problemas potenciais, como valores de parâmetros ausentes, sintaxe incorreta e limites de serviço. Se a requisição falhar na simulação, o sistema retorna uma mensagem de erro. Caso contrário, retorna o código de erro `DryRunOperation`. false (padrão): envia a requisição e executa a simulação. Se a requisição passar na verificação, o sistema retorna um código de status HTTP 2xx e executa a operação.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
VpcId	String	vpc-257gq642n****	ID da VPC à qual o vSwitch pertence.
Status	String	Pending	Status do vSwitch. Valores válidos: Pending Available
CreationTime	String	2021-08-22T10:40:25Z	Horário de criação do vSwitch.
IsDefault	Boolean	false	Indica se o vSwitch é o padrão. Valores válidos: true false
AvailableIpAddressCount	Long	12	Quantidade de endereços IP disponíveis.
NetworkAclId	String	1	Regras da lista de controle de acesso (ACL) de rede.
OwnerId	Long	287683832402436789	ID da conta Alibaba Cloud proprietária do vSwitch.
VSwitchId	String	vsw-25b7pv15t****	ID do vSwitch.
RequestId	String	7B48B4B9-1EAD-469F-B488-594DAB4B6A1A	ID da requisição.
CidrBlock	String	192.168.0.1/24	Bloco CIDR do vSwitch.
Description	String	abc	Descrição do vSwitch.
ResourceGroupId	String	rg-acfmxazb4ph****	ID do grupo de recursos.
ZoneId	String	cn-beijing-a	ID da zona onde o vSwitch está localizado.
Ipv6CidrBlock	String	2408:XXXX:3c5:44e::/64	Bloco CIDR IPv6 do vSwitch.
VSwitchName	String	test	Nome do vSwitch.
ShareType	String	Shared	Indica se o vSwitch é compartilhado. Se nenhum valor for retornado, trata-se de um vSwitch comum. Se o retorno for Shared, o vSwitch está compartilhado. Se o retorno for Sharing, o vSwitch está em processo de compartilhamento.
RouteTable	Object		Informações sobre a tabela de rotas associada ao vSwitch.
RouteTableId	String	vtb-bp145q7glnuzdv****	ID da tabela de rotas associada ao vSwitch.
RouteTableType	String	System	Tipo da tabela de rotas. Valores válidos: System Custom
Tags	Array of Tag		Lista de tags.
Tag
Key	String	FinanceDept	Chave da tag.
Value	String	FinanceJoshua	Valor da tag.

Exemplos

Exemplos de requisições

http(s)://[Endpoint]/?Action=DescribeVSwitchAttributes
&VSwitchId=vsw-25naue4g****
&RegionId=cn-hangzhou
&DryRun=false
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

<DescribeVSwitchAttributesResponse>
    <VpcId>vpc-257gq642n****</VpcId>
    <Status>Pending</Status>
    <CreationTime>2021-08-22T10:40:25Z</CreationTime>
    <IsDefault>false</IsDefault>
    <AvailableIpAddressCount>12</AvailableIpAddressCount>
    <NetworkAclId>1</NetworkAclId>
    <OwnerId>287683832402436800</OwnerId>
    <VSwitchId>vsw-25b7pv15t****</VSwitchId>
    <RequestId>7B48B4B9-1EAD-469F-B488-594DAB4B6A1A</RequestId>
    <CidrBlock>192.168.0.1/24</CidrBlock>
    <Description>abc</Description>
    <ResourceGroupId>rg-acfmxazb4ph****</ResourceGroupId>
    <ZoneId>cn-beijing-a</ZoneId>
    <Ipv6CidrBlock>2408:XXXX:3c5:44e::/64</Ipv6CidrBlock>
    <VSwitchName>test</VSwitchName>
    <ShareType>Shared</ShareType>
    <RouteTable>
        <RouteTableId>vtb-bp145q7glnuzdv****</RouteTableId>
        <RouteTableType>System</RouteTableType>
    </RouteTable>
    <Tags>
        <Key>FinanceDept</Key>
        <Value>FinanceJoshua</Value>
    </Tags>
</DescribeVSwitchAttributesResponse>

Formato JSON

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

{
  "VpcId" : "vpc-257gq642n****",
  "Status" : "Pending",
  "CreationTime" : "2021-08-22T10:40:25Z",
  "IsDefault" : false,
  "AvailableIpAddressCount" : 12,
  "NetworkAclId" : "1",
  "OwnerId" : 287683832402436800,
  "VSwitchId" : "vsw-25b7pv15t****",
  "RequestId" : "7B48B4B9-1EAD-469F-B488-594DAB4B6A1A",
  "CidrBlock" : "192.168.0.1/24",
  "Description" : "abc",
  "ResourceGroupId" : "rg-acfmxazb4ph****",
  "ZoneId" : "cn-beijing-a",
  "Ipv6CidrBlock" : "2408:XXXX:3c5:44e::/64",
  "VSwitchName" : "test",
  "ShareType" : "Shared",
  "RouteTable" : {
    "RouteTableId" : "vtb-bp145q7glnuzdv****",
    "RouteTableType" : "System"
  },
  "Tags" : [ {
    "Key" : "FinanceDept",
    "Value" : "FinanceJoshua"
  } ]
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o Centro de Erros de API.