DescribeVSwitches - - Alibaba Cloud Dokümantasyon Merkezi

Hata Ayıklama

OpenAPI Explorer, imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için işlem örnek kodunu dinamik olarak oluşturur.

İstek parametreleri

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeVSwitches	Gerçekleştirmek istediğiniz işlem. Değeri DescribeVSwitches olarak ayarlayın.
VpcId	String	No	vpc-25cdvfeq58pl****	vSwitch'in ait olduğu VPC'nin kimliği. Not RegionId ve VpcId parametrelerinden en az birini belirtin.
VSwitchId	String	No	vsw-23dscddcffvf3****	Sorgulamak istediğiniz vSwitch'in kimliği.
ZoneId	String	No	cn-hangzhou-d	vSwitch'in ait olduğu alanın kimliği. En güncel alan listesini sorgulamak için DescribeZones işlemini çağırabilirsiniz.
RegionId	String	No	cn-hangzhou	vSwitch'in ait olduğu bölgenin kimliği. En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz. Not RegionId ve VpcId parametrelerinden en az birini belirtin.
VSwitchName	String	No	vSwitch	vSwitch'in adı. Ad 1 ila 128 karakter uzunluğunda olmalıdır. Ad `http://` veya `https://` ile başlayamaz.
DryRun	Boolean	No	true	Yalnızca deneme çalıştırması yapılıp yapılmayacağını, yani gerçek isteğin gönderilmeyeceğini belirtir. Geçerli değerler: true: Yalnızca deneme çalıştırması yapılır. Sistem, eksik parametre değerleri, hatalı istek sözdizimi ve hizmet sınırları dahil olmak üzere istekte potansiyel sorunlar olup olmadığını kontrol eder. İstek deneme çalıştırmasında başarısız olursa bir hata mesajı döndürülür. İstek deneme çalıştırmasını başarıyla geçerse `DryRunOperation` hata kodu döndürülür. false (varsayılan): Deneme çalıştırması yapılır ve gerçek istek gönderilir. İstek deneme çalıştırmasını başarıyla geçerse 2xx HTTP durum kodu döndürülür ve işlem gerçekleştirilir.
IsDefault	Boolean	No	true	Belirtilen bölgedeki varsayılan vSwitch'in sorgulanıp sorgulanmayacağını belirtir. Geçerli değerler: true false Bu parametreyi belirtmezseniz sistem varsayılan olarak belirtilen bölgedeki tüm vSwitch'leri sorgular.
RouteTableId	String	No	vtb-bp145q7glnuzdvzu2****	Yönlendirme tablosunun kimliği.
ResourceGroupId	String	No	rg-bp67acfmxazb4ph****	vSwitch'in ait olduğu kaynak grubunun kimliği.
PageNumber	Integer	No	1	Döndürülecek sayfa numarası. Varsayılan değer: 1.
PageSize	Integer	No	10	Sayfa başına kayıt sayısı. Maksimum değer: 50. Varsayılan değer: 10.
VSwitchOwnerId	Long	No	2546073170691****	vSwitch'in ait olduğu Alibaba Cloud hesabının kimliği.
Tag.N.Key	String	No	FinanceDept	Kaynağa eklemek için N. etiketin anahtarı. En fazla 20 etiket anahtarı belirtebilirsiniz. Etiket anahtarı boş bir dize olamaz. Etiket anahtarı en fazla 128 karakter uzunluğunda olabilir. `aliyun` veya `acs:` ile başlayamaz ve `http://` veya `https://` içeremez.
Tag.N.Value	String	No	FinanceJoshua	Kaynağa eklemek için N. etiketin değeri. En fazla 20 etiket değeri belirtebilirsiniz. Etiket değeri boş bir dize olabilir. Etiket değeri en fazla 128 karakter uzunluğunda olabilir ve `http://` veya `https://` içeremez. Etiket değeri `aliyun` veya `acs:` ile başlayamaz.

Yanıt parametreleri

Parameter	Type	Example	Description
PageSize	Integer	10	Sayfa başına kayıt sayısı.
RequestId	String	9A572171-4E27-40D1-BD36-D26C9E71E29E	İstek kimliği.
PageNumber	Integer	1	Döndürülen sayfanın sayfa numarası.
TotalCount	Integer	1	Döndürülen kayıt sayısı.
VSwitches	Array of VSwitch		vSwitch ile ilgili ayrıntılar.
VSwitch
VpcId	String	vpc-257gcdcdq64****	vSwitch'in ait olduğu VPC'nin kimliği.
Status	String	Available	vSwitch'in durumu. Geçerli değerler: Pending Available
CreationTime	String	2022-01-18T12:43:57Z	vSwitch'in oluşturulma zamanı.
IsDefault	Boolean	true	Yığının dağıtıldığı bölgedeki varsayılan vSwitch'in sorgulanıp sorgulanmadığını gösterir. Geçerli değerler: true false
AvailableIpAddressCount	Long	1	vSwitch'teki kullanılabilir IP adresi sayısı.
NetworkAclId	String	nacl-a2do9e413e0spzasx****	Ağ ACL'sinin kimliği.
OwnerId	Long	253460731706911258	vSwitch'in ait olduğu Alibaba Cloud hesabının kimliği.
VSwitchId	String	vsw-25bcdxs7pv1****	vSwitch'in kimliği.
CidrBlock	String	172.16.0.0/24	vSwitch'in IPv4 CIDR bloğu.
Description	String	VSwitchDescription	vSwitch'in açıklaması.
ResourceGroupId	String	rg-acfmxazb4ph6aiy****	vSwitch'in ait olduğu kaynak grubunun kimliği.
ZoneId	String	cn-hangzhou-d	vSwitch'in ait olduğu alanın kimliği.
Ipv6CidrBlock	String	2408:4002:10c4:4e03::/64	vSwitch'in IPv6 CIDR bloğu.
VSwitchName	String	vSwitch	vSwitch'in adı.
ShareType	String	Shared	vSwitch'in paylaşılıp paylaşılmadığını gösterir. Değer döndürülmezse vSwitch normal bir vSwitch'tir. Shared döndürülürse vSwitch paylaşılan bir vSwitch'tir. Sharing döndürülürse vSwitch paylaşım aşamasındadır.
EnabledIpv6	Boolean	true	vSwitch için IPv6'nın etkinleştirilip etkinleştirilmeyeceğini belirtir. IPv6'yı etkinleştirirseniz vSwitch'in IPv6 CIDR bloğunu yapılandırmanız gerekir. Geçerli değerler: true false
Tags	Array of Tag		vSwitch ile ilgili etiket bilgileri.
Tag
Key	String	department	N. etiketin anahtarı.
Value	String	dev	N. etiketin değeri.
RouteTable	Object		Yönlendirme tablosu ile ilgili bilgiler.
RouteTableId	String	vrt-bp145q7glnuzdv****	vSwitch ile ilişkili yönlendirme tablosunun kimliği.
RouteTableType	String	System	vSwitch ile ilişkili yönlendirme tablosunun türü. Geçerli değerler: System Custom

Örnekler

Örnek istekler

http(s)://[Endpoint]/?Action=DescribeVSwitches
&VpcId=vpc-25cdvfeq58pl****
&VSwitchId=vsw-23dscddcffvf3****
&ZoneId=cn-hangzhou-d
&RegionId=cn-hangzhou
&VSwitchName=vSwitch
&DryRun=true
&IsDefault=true
&RouteTableId=vtb-bp145q7glnuzdvzu2****
&ResourceGroupId=rg-bp67acfmxazb4ph****
&PageNumber=1
&PageSize=10
&Tag=[{"Key":"FinanceDept","Value":"FinanceJoshua"}]
&Common request parameters

Başarılı yanıt örnekleri

XML biçimi

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

<DescribeVSwitchesResponse>
    <PageSize>10</PageSize>
    <RequestId>9A572171-4E27-40D1-BD36-D26C9E71E29E</RequestId>
    <PageNumber>1</PageNumber>
    <TotalCount>1</TotalCount>
    <VSwitches>
        <VpcId>vpc-257gcdcdq64****</VpcId>
        <Status>Available</Status>
        <CreationTime>2022-01-18T12:43:57Z</CreationTime>
        <IsDefault>true</IsDefault>
        <AvailableIpAddressCount>1</AvailableIpAddressCount>
        <NetworkAclId>nacl-a2do9e413e0spzasx****</NetworkAclId>
        <OwnerId>253460731706911260</OwnerId>
        <VSwitchId>vsw-25bcdxs7pv1****</VSwitchId>
        <CidrBlock>172.16.0.0/24</CidrBlock>
        <Description>VSwitchDescription</Description>
        <ResourceGroupId>rg-acfmxazb4ph6aiy****</ResourceGroupId>
        <ZoneId>cn-hangzhou-d</ZoneId>
        <Ipv6CidrBlock>2408:4002:10c4:4e03::/64</Ipv6CidrBlock>
        <VSwitchName>vSwitch</VSwitchName>
        <ShareType>Shared</ShareType>
        <EnabledIpv6>true</EnabledIpv6>
        <Tags>
            <Key>department</Key>
            <Value>dev</Value>
        </Tags>
        <RouteTable>
            <RouteTableId>vrt-bp145q7glnuzdv****</RouteTableId>
            <RouteTableType>System</RouteTableType>
        </RouteTable>
    </VSwitches>
</DescribeVSwitchesResponse>

JSON biçimi

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

{
  "PageSize" : 10,
  "RequestId" : "9A572171-4E27-40D1-BD36-D26C9E71E29E",
  "PageNumber" : 1,
  "TotalCount" : 1,
  "VSwitches" : [ {
    "VpcId" : "vpc-257gcdcdq64****",
    "Status" : "Available",
    "CreationTime" : "2022-01-18T12:43:57Z",
    "IsDefault" : true,
    "AvailableIpAddressCount" : 1,
    "NetworkAclId" : "nacl-a2do9e413e0spzasx****",
    "OwnerId" : 253460731706911260,
    "VSwitchId" : "vsw-25bcdxs7pv1****",
    "CidrBlock" : "172.16.0.0/24",
    "Description" : "VSwitchDescription",
    "ResourceGroupId" : "rg-acfmxazb4ph6aiy****",
    "ZoneId" : "cn-hangzhou-d",
    "Ipv6CidrBlock" : "2408:4002:10c4:4e03::/64",
    "VSwitchName" : "vSwitch",
    "ShareType" : "Shared",
    "EnabledIpv6" : true,
    "Tags" : [ {
      "Key" : "department",
      "Value" : "dev"
    } ],
    "RouteTable" : {
      "RouteTableId" : "vrt-bp145q7glnuzdv****",
      "RouteTableType" : "System"
    }
  } ]
}

Hata kodları

HttpCode	Error code	Error message	Description
400	Forbidden.VpcNotFound	Specified VPC can not found.	Belirtilen VPC mevcut değil.
400	InvalidTagKey	The tag keys are not valid.	Etiket dizini geçersiz.
400	InvalidTagValue	The tag values are not valid.	Etiket değeri geçersiz.
404	InvalidVSwitchId.NotFound	VSwitch not exist.	Belirtilen vSwitch mevcut değil. Belirtilen vSwitch kimliğinin geçerli olup olmadığını kontrol edin.
404	InvalidVpcIdNumber.NotSupported	The number of vpcIds exceeds the limit.	VPC kimliklerinin sayısı sınırı aşıyor.

Hata kodlarının listesi için bkz. Hizmet hata kodları.