DescribeVSwitchAttributes - - Centre de documentation Alibaba Cloud

Récupère les informations détaillées d’un vSwitch spécifié.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d’appeler cette opération via OpenAPI Explorer, qui génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	DescribeVSwitchAttributes	Opération à effectuer. Définissez la valeur sur DescribeVSwitchAttributes.
VSwitchId	String	Oui	vsw-25naue4g****	ID du vSwitch.
RegionId	String	Non	cn-hangzhou	ID de la région du VPC (Virtual Private Cloud) auquel appartient la table de routage. Appelez l’opération DescribeRegions pour obtenir la liste des régions la plus récente.
DryRun	Boolean	Non	false	Indique si le système doit uniquement vérifier la requête (dry run) sans l’exécuter. Valeurs valides : true : vérification seule. Le système analyse la requête pour détecter d’éventuels problèmes (paramètres manquants, syntaxe incorrecte, limites de service). En cas d’échec, un message d’erreur s’affiche. En cas de succès, le code d’erreur `DryRunOperation` est renvoyé. false (par défaut) : envoi et exécution de la requête. Si la vérification préliminaire réussit, un code d’état HTTP 2xx est renvoyé et l’opération est exécutée.

Paramètres de réponse

Paramètre	Type	Exemple	Description
VpcId	String	vpc-257gq642n****	ID du VPC auquel appartient le vSwitch.
Status	String	Pending	État du vSwitch. Valeurs valides : Pending Available
CreationTime	String	2021-08-22T10:40:25Z	Date et heure de création du vSwitch.
IsDefault	Boolean	false	Indique si le vSwitch est le vSwitch par défaut. Valeurs valides : true false
AvailableIpAddressCount	Long	12	Nombre d’adresses IP disponibles.
NetworkAclId	String	1	ID de la liste de contrôle d’accès réseau (ACL).
OwnerId	Long	287683832402436789	ID du compte Alibaba Cloud propriétaire du vSwitch.
VSwitchId	String	vsw-25b7pv15t****	ID du vSwitch.
RequestId	String	7B48B4B9-1EAD-469F-B488-594DAB4B6A1A	ID de la requête.
CidrBlock	String	192.168.0.1/24	Bloc CIDR du vSwitch.
Description	String	abc	Description du vSwitch.
ResourceGroupId	String	rg-acfmxazb4ph****	ID du groupe de ressources.
ZoneId	String	cn-beijing-a	ID de la zone où se trouve le vSwitch.
Ipv6CidrBlock	String	2408:XXXX:3c5:44e::/64	Bloc CIDR IPv6 du vSwitch.
VSwitchName	String	test	Nom du vSwitch.
ShareType	String	Shared	Indique si le vSwitch est partagé. Absence de valeur : vSwitch standard. Valeur Shared : vSwitch partagé. Valeur Sharing : vSwitch en cours de partage.
RouteTable	Object		Informations sur la table de routage associée au vSwitch.
RouteTableId	String	vtb-bp145q7glnuzdv****	ID de la table de routage associée au vSwitch.
RouteTableType	String	System	Type de table de routage. Valeurs valides : System Custom
Tags	Array of Tag		Liste des tags.
Tag
Key	String	FinanceDept	Clé du tag.
Value	String	FinanceJoshua	Valeur du tag.

Exemples

Exemple de requête

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

Exemple de réponse en cas de succès

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

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

Codes d'erreur

Pour la liste des codes d'erreur, consultez le Centre d'erreurs de l'API.