DescribeVSwitchAttributes - - Centro de documentación de Alibaba Cloud

Consulta la información detallada de un vSwitch específico.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que ejecute esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	DescribeVSwitchAttributes	La operación que desea ejecutar. Establezca el valor en DescribeVSwitchAttributes.
VSwitchId	String	Sí	vsw-25naue4g****	El ID del vSwitch.
RegionId	String	No	cn-hangzhou	El ID de región de la nube privada virtual (VPC) a la que pertenece la tabla de rutas. Llame a la operación DescribeRegions para consultar la lista de regiones más reciente.
DryRun	Boolean	No	false	Especifica si se debe realizar solo una prueba en seco, sin ejecutar la solicitud real. Valores válidos: true: realiza una prueba en seco. El sistema comprueba la solicitud en busca de posibles problemas, como valores de parámetro faltantes, sintaxis incorrecta y límites de servicio. Si la solicitud no supera la prueba, se devuelve un mensaje de error. Si la solicitud supera la prueba, se devuelve el código de error `DryRunOperation`. false (predeterminado): envía la solicitud y realiza una prueba en seco. Si la solicitud supera la prueba, se devuelve un código de estado HTTP 2xx y se ejecuta la operación.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
VpcId	String	vpc-257gq642n****	El ID de la VPC a la que pertenece el vSwitch.
Status	String	Pending	El estado del vSwitch. Valores válidos: Pending Available
CreationTime	String	2021-08-22T10:40:25Z	La hora en que se creó el vSwitch.
IsDefault	Boolean	false	Indica si el vSwitch es el vSwitch predeterminado. Valores válidos: true false
AvailableIpAddressCount	Long	12	El número de direcciones IP disponibles.
NetworkAclId	String	1	Las reglas de la lista de control de acceso (ACL) de red.
OwnerId	Long	287683832402436789	El ID de la cuenta de Alibaba Cloud a la que pertenece el vSwitch.
VSwitchId	String	vsw-25b7pv15t****	El ID del vSwitch.
RequestId	String	7B48B4B9-1EAD-469F-B488-594DAB4B6A1A	El ID de la solicitud.
CidrBlock	String	192.168.0.1/24	El bloque CIDR del vSwitch.
Description	String	abc	La descripción del vSwitch.
ResourceGroupId	String	rg-acfmxazb4ph****	El ID del resource group.
ZoneId	String	cn-beijing-a	El ID de la zona a la que pertenece el vSwitch.
Ipv6CidrBlock	String	2408:XXXX:3c5:44e::/64	El bloque CIDR IPv6 del vSwitch.
VSwitchName	String	test	El nombre del vSwitch.
ShareType	String	Shared	Indica si el vSwitch está compartido. Si no se devuelve ningún valor, el vSwitch es un vSwitch estándar. Si se devuelve Shared, el vSwitch está compartido. Si se devuelve Sharing, el vSwitch se encuentra en proceso de compartirse.
RouteTable	Object		La información sobre la tabla de rutas asociada al vSwitch.
RouteTableId	String	vtb-bp145q7glnuzdv****	El ID de la tabla de rutas asociada al vSwitch.
RouteTableType	String	System	El tipo de la tabla de rutas. Valores válidos: System Custom
Tags	Array of Tag		La lista de etiquetas.
Tag
Key	String	FinanceDept	La clave de la etiqueta.
Value	String	FinanceJoshua	El valor de la etiqueta.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

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 error

Para obtener una lista de los códigos de error, visite el Centro de errores de API.