DescribeNetworkInterfaces - - Alibaba Cloud Dokümantasyon Merkezi

Kullanım notları

MaxResults veya NextToken parametresini belirterek DescribeNetworkInterfaces işlemi için sayfalı sorgu yapabilirsiniz. Sayfalı sorgu sırasında, ilk sonuç sayfasını almak üzere DescribeNetworkInterfaces işlemini çağırdığınızda döndürülecek maksimum kayıt sayısını belirtmek için MaxResults değerini ayarlayın. NextToken dönüş değeri, bir sonraki çağrıda yeni bir sonuç sayfası almak için kullanabileceğiniz bir sayfalama belirtecidir. Yeni bir sonuç sayfası almak üzere DescribeNetworkInterfaces işlemini çağırdığınızda NextToken parametresine önceki çağrıdan dönen NextToken değerini yazın ve bu çağrıda döndürülecek maksimum kayıt sayısını belirtmek için MaxResults değerini ayarlayın.

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'ler için işlem örnek kodunu dinamik olarak oluşturur.

İstek parametreleri

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeNetworkInterfaces	Gerçekleştirmek istediğiniz işlem. Değeri DescribeNetworkInterfaces olarak ayarlayın.
RegionId	String	Yes	cn-hangzhou	ENI'nin bölge kimliği. En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.
Tag.N.Key	String	No	TestKey	ENI'nin N. etiketinin anahtarı. N için geçerli değerler: 1 ile 20.
Tag.N.Value	String	No	TestValue	ENI'nin N. etiketinin değeri. N için geçerli değerler: 1 ile 20. Kaynakları sorgulamak için tek bir etiket belirtildiğinde yanıtta bu etikete sahip en fazla 1.000 kaynak görüntülenebilir. Kaynakları sorgulamak için birden çok etiket belirtildiğinde yanıtta bu etiketlerin tümüne sahip en fazla 1.000 kaynak görüntülenebilir. Belirtilen etiketlere sahip 1.000'den fazla ENI'yi sorgulamak için ListTagResources işlemini çağırın.
ResourceGroupId	String	No	rg-bp67acfmxazb4p****	Kaynak grubunun kimliği. Kaynakları sorgulamak için bu parametre belirtilirse belirtilen kaynak grubuna ait en fazla 1.000 kaynak döndürülür. Not Bu parametrenin nasıl ayarlandığından bağımsız olarak varsayılan kaynak grubundaki ENI'ler yanıtta görüntülenir.
VSwitchId	String	No	vsw-bp16usj2p27htro3****	ENI'nin bağlı olduğu vSwitch'in kimliği.
VpcId	String	No	vpc-bp1j7w3gc1cexjqd****	ENI'nin ait olduğu sanal özel cloud (VPC) kimliği.
PrimaryIpAddress	String	No	192.168..	ENI'nin birincil özel IPv4 adresi.
SecurityGroupId	String	No	sg-bp144yr32sx6ndw****	İkincil ENI'nin ait olduğu güvenlik grubunun kimliği. Bir güvenlik grubunun kimliğine göre ikincil ENI'lerin ayrıntılarını sorgulamak için bu parametreyi belirtin. Bir güvenlik grubunun kimliğine göre birincil ENI'lerin ayrıntılarını sorgulamak için `SecurityGroupId` parametresi belirtilmiş şekilde DescribeInstances işlemini çağırın.
NetworkInterfaceName	String	No	test-eni-name	ENI'nin adı.
Type	String	No	Secondary	ENI türü. Geçerli değerler: Primary Secondary Bu parametre varsayılan olarak boştur; bu durum hem birincil hem de ikincil ENI'lerin sorgulandığını gösterir.
InstanceId	String	No	i-bp1e2l6djkndyuli****	ENI'nin bağlı olduğu örneğin kimliği.
ServiceManaged	Boolean	No	true	ENI kullanıcısının bir Alibaba Cloud hizmeti mi yoksa bir dağıtıcı mı olduğunu belirtir.
Status	String	No	Available	ENI durumu. Geçerli değerler: Available: ENI kullanılabilir durumda. Attaching: ENI bir örneğe bağlanıyor. InUse: ENI bir örneğe bağlı. Detaching: ENI bir örnekten ayrılıyor. Deleting: ENI siliniyor. Bu parametre varsayılan olarak boştur; bu durum tüm durumlardaki ENI'lerin sorgulandığını gösterir.
PageNumber	Integer	No	1	Not Bu parametre artık kullanılmamaktadır. Sayfalı sorgu için MaxResults veya NextToken parametresini belirtmenizi öneririz.
PageSize	Integer	No	100	Not Bu parametre artık kullanılmamaktadır. Sayfalı sorgu için MaxResults veya NextToken parametresini belirtmenizi öneririz.
NextToken	String	No	AAAAAdDWBF2****	Yeni bir sonuç sayfası almak için sonraki istekte kullanılan sayfalama belirteci. İlk istek için bu parametreyi belirtmeniz gerekmez. Önceki sorgudan elde edilen belirteci `NextToken` değeri olarak belirtmelisiniz. Bu işlemin döndürdüğü yanıtları kontrol etme hakkında bilgi için bu konudaki "Kullanım notları" bölümüne bakın.
MaxResults	Integer	No	50	Sayfa başına maksimum kayıt sayısı. Geçerli değerler: 10 ile 500. Varsayılan değer: Bu parametre belirtilmezse veya 10'dan küçük bir değere ayarlanırsa varsayılan değer 10'dur. Bu parametre 500'den büyük bir değere ayarlanırsa varsayılan değer 500 kullanılır.
PrivateIpAddress.N	String	No	192.168..	ENI'nin N. ikincil özel IPv4 adresi. N için geçerli değerler: 1 ile 100.
NetworkInterfaceId.N	String	No	eni-bp125p95hhdhn3ot****	N. ENI'nin kimliği. N için geçerli değerler: 1 ile 100.
Ipv6Address.N	String	No	2408:4321:180:1701:94c7:bc38:3bfa:****	ENI'nin N. IPv6 adresi. N için geçerli değerler: 1 ile 100.

Yanıt parametreleri

Parameter	Type	Example	Description
NextToken	String	AAAAAdDWBF2****	Sayfalama belirteci. Yeni bir sonuç sayfası almak için sonraki istekte kullanılabilir.
PageSize	Integer	1	Sayfa başına kayıt sayısı. Not Bu parametre gelecekte kaldırılacaktır. Sayfalı sorgu için NextToken ve MaxResults parametrelerini kullanmanızı öneririz.
PageNumber	Integer	1	Sayfa numarası. Not Bu parametre gelecekte kaldırılacaktır. Sayfalı sorgu için NextToken ve MaxResults parametrelerini kullanmanızı öneririz.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	İsteğin kimliği.
TotalCount	Integer	2	Döndürülen toplam ENI sayısı. Not `MaxResults` ve `NextToken` parametrelerini belirterek sayfalı sorgu yaparsanız `TotalCount` yanıt parametresinin değeri geçersiz olur.
NetworkInterfaceSets	Array of NetworkInterfaceSet		ENI'lerin ayrıntıları.
NetworkInterfaceSet
CreationTime	String	2019-12-25T12:31:31Z	ENI'nin oluşturulma zamanı.
VpcId	String	vpc-bp1j7w3gc1cexjqd****	ENI'nin ait olduğu VPC'nin kimliği.
Type	String	Secondary	ENI türü.
Status	String	Available	ENI durumu.
NetworkInterfaceTrafficMode	String	Standard	ENI iletişim modu. Geçerli değerler: Standard: TCP iletişim modunu kullanır. HighPerformance: Elastic RDMA Interface (ERI) etkinleştirilmiş uzak doğrudan bellek erişimi (RDMA) iletişim modunu kullanır. Not Parametre yalnızca ENI, Beijing Alan K bölgesinde bulunan c7re RDMA geliştirilmiş bir örneğe bağlı olduğunda HighPerformance değerini alabilir.
NetworkInterfaceName	String	my-eni-name	ENI'nin adı.
MacAddress	String	00:16:3e:12::	ENI'nin medya erişim denetimi (MAC) adresi.
QueuePairNumber	Integer	0	Not Bu parametre davetli ön izleme aşamasındadır ve genel kullanıma sunulmamıştır.
NetworkInterfaceId	String	eni-bp125p95hhdhn3ot****	ENI'nin kimliği.
ServiceID	Long	12345678910	ENI'nin ait olduğu dağıtıcının kimliği.
InstanceId	String	i-bp1e2l6djkndyuli****	ENI'nin bağlı olduğu örneğin kimliği. Not ENI diğer Alibaba Cloud hizmetleri tarafından yönetiliyor ve kontrol ediliyorsa hiçbir örnek kimliği döndürülmez.
OwnerId	String	123456****	ENI'nin ait olduğu hesabın kimliği.
ServiceManaged	Boolean	true	ENI kullanıcısının bir Alibaba Cloud hizmeti mi yoksa bir dağıtıcı mı olduğunu gösterir.
VSwitchId	String	vsw-bp16usj2p27htro3****	ENI ile ilişkili vSwitch'in kimliği.
Description	String	DescriptionTest	ENI açıklaması.
ResourceGroupId	String	rg-2ze88m67qx5z****	ENI'nin ait olduğu kaynak grubunun kimliği.
ZoneId	String	cn-hangzhou-e	ENI'nin alan kimliği.
PrivateIpAddress	String	172.17..	ENI'nin özel IP adresi.
QueueNumber	Integer	8	ENI tarafından desteklenen kuyruk sayısı. ENI, InUse (InUse) durumunda bir ikincil ENI ise ve ENI tarafından desteklenen kuyruk sayısı hiçbir zaman değiştirilmemişse örnek türünün ikincil ENI başına desteklediği varsayılan kuyruk sayısı döndürülür. İkincil ENI tarafından desteklenen kuyruk sayısı değiştirildiyse yeni kuyruk sayısı döndürülür. ENI, Available (Available) durumunda bir ikincil ENI ise ve ENI tarafından desteklenen kuyruk sayısı hiçbir zaman değiştirilmemişse boş bir değer döndürülür. ENI bir birincil ENI ise örnek türünün birincil ENI başına desteklediği varsayılan kuyruk sayısı döndürülür.
PrivateIpSets	Array of PrivateIpSet		ENI'nin özel IP adresleri.
PrivateIpSet
PrivateIpAddress	String	172.17..	ENI'nin özel IP adresi.
Primary	Boolean	true	IP adresinin birincil özel IP adresi olup olmadığını gösterir. Geçerli değerler: true: IP adresi birincil özel IP adresidir. false: IP adresi ikincil özel IP adresidir.
AssociatedPublicIp	Object		ENI ile ilişkili elastik IP adresinin (EIP) ayrıntıları.
PublicIpAddress	String	116.62..	ENI'nin EIP'si.
AllocationId	String	null	Not Bu parametre davetli ön izleme aşamasındadır ve genel kullanıma sunulmamıştır.
Ipv6Sets	Array of Ipv6Set		ENI'ye atanan IPv6 adresleri.
Ipv6Set
Ipv6Address	String	2408:4321:180:1701:94c7:bc38:3bfa:****	ENI'ye atanan IPv6 adresi.
Ipv4PrefixSets	Array of Ipv4PrefixSet		ENI'ye atanan IPv4 ön ekleri.
Ipv4PrefixSet
Ipv4Prefix	String	192.168.**.0/28	ENI'ye atanan IPv4 ön eki.
Ipv6PrefixSets	Array of Ipv6PrefixSet		ENI'ye atanan IPv6 ön ekleri.
Ipv6PrefixSet
Ipv6Prefix	String	2001:db8:1234:1a00:****::/80	ENI'ye atanan IPv6 ön ekleri.
Tags	Array of Tag		ENI'nin etiketleri.
Tag
TagValue	String	TestValue	ENI'nin etiket değeri.
TagKey	String	TestKey	ENI'nin etiket anahtarı.
SecurityGroupIds	Array of String	sg-bp18kz60mefsicfg****	ENI'nin ait olduğu güvenlik gruplarının kimlikleri.
AssociatedPublicIp	Object		ENI'nin ikincil özel IP adresiyle ilişkili EIP.
PublicIpAddress	String	116.62..	ENI'nin EIP'si.
AllocationId	String	null	Not Bu parametre davetli ön izleme aşamasındadır ve genel kullanıma sunulmamıştır.
Attachment	Object		Not Bu parametre davetli ön izleme aşamasındadır ve genel kullanıma sunulmamıştır.
DeviceIndex	Integer	0	Not Bu parametre davetli ön izleme aşamasındadır ve genel kullanıma sunulmamıştır.
InstanceId	String	null	Not Bu parametre davetli ön izleme aşamasındadır ve genel kullanıma sunulmamıştır.
TrunkNetworkInterfaceId	String	null	Not Bu parametre davetli ön izleme aşamasındadır ve genel kullanıma sunulmamıştır.
NetworkCardIndex	Integer	0	Ağ kartının dizini. ENI Available (Available) durumundaysa veya ENI bağlanırken hiçbir ağ kartı dizini belirtilmediyse bu parametrenin değeri yoktur. ENI InUse (InUse) durumundaysa ve ENI bağlanırken bir ağ kartı dizini belirtildiyse belirtilen ağ kartı dizini bu parametrenin değeri olarak döndürülür.
DeleteOnRelease	Boolean	true	İlişkili örnek serbest bırakıldığında ENI'nin de serbest bırakılıp bırakılmayacağını gösterir. Geçerli değerler: true false

Örnekler

Örnek istekler

https://ecs.aliyuncs.com/?Action=DescribeNetworkInterfaces
&RegionId=cn-hangzhou
&PrivateIpAddress.1=192.168.**.**
&PrivateIpAddress.2=192.168.**.**
&NextToken=AAAAAdDWBF2****
&<Common request parameters>

Örnek başarılı yanıt

XML biçimi

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

<DescribeNetworkInterfacesResponse>
    <NextToken>AAAAAdDWBF2****</NextToken>
    <PageSize>1</PageSize>
    <PageNumber>1</PageNumber>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <TotalCount>2</TotalCount>
    <NetworkInterfaceSets>
        <CreationTime>2019-12-25T12:31:31Z</CreationTime>
        <VpcId>vpc-bp1j7w3gc1cexjqd****</VpcId>
        <Type>Secondary</Type>
        <Status>Available</Status>
        <NetworkInterfaceTrafficMode>Standard</NetworkInterfaceTrafficMode>
        <NetworkInterfaceName>my-eni-name</NetworkInterfaceName>
        <MacAddress>00:16:3e:12:**:**</MacAddress>
        <QueuePairNumber>0</QueuePairNumber>
        <NetworkInterfaceId>eni-bp125p95hhdhn3ot****</NetworkInterfaceId>
        <ServiceID>12345678910</ServiceID>
        <InstanceId>i-bp1e2l6djkndyuli****</InstanceId>
        <OwnerId>123456****</OwnerId>
        <ServiceManaged>true</ServiceManaged>
        <VSwitchId>vsw-bp16usj2p27htro3****</VSwitchId>
        <Description>DescriptionTest</Description>
        <ResourceGroupId>rg-2ze88m67qx5z****</ResourceGroupId>
        <ZoneId>cn-hangzhou-e</ZoneId>
        <PrivateIpAddress>172.17.**.**</PrivateIpAddress>
        <QueueNumber>8</QueueNumber>
        <PrivateIpSets>
            <PrivateIpAddress>172.17.**.**</PrivateIpAddress>
            <Primary>true</Primary>
            <AssociatedPublicIp>
                <PublicIpAddress>116.62.**.**</PublicIpAddress>
                <AllocationId>null</AllocationId>
            </AssociatedPublicIp>
        </PrivateIpSets>
        <Ipv6Sets>
            <Ipv6Address>2408:4321:180:1701:94c7:bc38:3bfa:****</Ipv6Address>
        </Ipv6Sets>
        <Ipv4PrefixSets>
            <Ipv4Prefix>192.168.**.0/28</Ipv4Prefix>
        </Ipv4PrefixSets>
        <Ipv6PrefixSets>
            <Ipv6Prefix>2001:db8:1234:1a00:****::/80</Ipv6Prefix>
        </Ipv6PrefixSets>
        <Tags>
            <TagValue>TestValue</TagValue>
            <TagKey>TestKey</TagKey>
        </Tags>
        <SecurityGroupIds>sg-bp18kz60mefsicfg****</SecurityGroupIds>
        <AssociatedPublicIp>
            <PublicIpAddress>116.62.**.**</PublicIpAddress>
            <AllocationId>null</AllocationId>
        </AssociatedPublicIp>
        <Attachment>
            <DeviceIndex>0</DeviceIndex>
            <InstanceId>null</InstanceId>
            <TrunkNetworkInterfaceId>null</TrunkNetworkInterfaceId>
            <NetworkCardIndex>0</NetworkCardIndex>
            <DeleteOnRelease>true</DeleteOnRelease>
        </Attachment>
    </NetworkInterfaceSets>
</DescribeNetworkInterfacesResponse>

JSON biçimi

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

{
  "NextToken" : "AAAAAdDWBF2****",
  "PageSize" : 1,
  "PageNumber" : 1,
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "TotalCount" : 2,
  "NetworkInterfaceSets" : [ {
    "CreationTime" : "2019-12-25T12:31:31Z",
    "VpcId" : "vpc-bp1j7w3gc1cexjqd****",
    "Type" : "Secondary",
    "Status" : "Available",
    "NetworkInterfaceTrafficMode" : "Standard",
    "NetworkInterfaceName" : "my-eni-name",
    "MacAddress" : "00:16:3e:12:**:**",
    "QueuePairNumber" : 0,
    "NetworkInterfaceId" : "eni-bp125p95hhdhn3ot****",
    "ServiceID" : 12345678910,
    "InstanceId" : "i-bp1e2l6djkndyuli****",
    "OwnerId" : "123456****",
    "ServiceManaged" : true,
    "VSwitchId" : "vsw-bp16usj2p27htro3****",
    "Description" : "DescriptionTest",
    "ResourceGroupId" : "rg-2ze88m67qx5z****",
    "ZoneId" : "cn-hangzhou-e",
    "PrivateIpAddress" : "172.17.**.**",
    "QueueNumber" : 8,
    "PrivateIpSets" : [ {
      "PrivateIpAddress" : "172.17.**.**",
      "Primary" : true,
      "AssociatedPublicIp" : {
        "PublicIpAddress" : "116.62.**.**",
        "AllocationId" : "null"
      }
    } ],
    "Ipv6Sets" : [ {
      "Ipv6Address" : "2408:4321:180:1701:94c7:bc38:3bfa:****"
    } ],
    "Ipv4PrefixSets" : [ {
      "Ipv4Prefix" : "192.168.**.0/28"
    } ],
    "Ipv6PrefixSets" : [ {
      "Ipv6Prefix" : "2001:db8:1234:1a00:****::/80"
    } ],
    "Tags" : [ {
      "TagValue" : "TestValue",
      "TagKey" : "TestKey"
    } ],
    "SecurityGroupIds" : [ "sg-bp18kz60mefsicfg****" ],
    "AssociatedPublicIp" : {
      "PublicIpAddress" : "116.62.**.**",
      "AllocationId" : "null"
    },
    "Attachment" : {
      "DeviceIndex" : 0,
      "InstanceId" : "null",
      "TrunkNetworkInterfaceId" : "null",
      "NetworkCardIndex" : 0,
      "DeleteOnRelease" : "true"
    }
  } ]
}

Hata kodları

HTTP status code	Error code	Error message	Description
400	MissingParameter	%s	Gerekli bir parametre belirtilmedi.
400	UnsupportedParameter	%s	Belirtilen bir parametre desteklenmiyor.
400	InvalidParameter	%s	Geçersiz parametre değeri.
400	InvalidInstanceID.Malformed	%s	Geçersiz InstanceId biçimi.
400	InvalidOperation.InvalidEcsState	%s	Bu işlem, mevcut durumdaki örnek üzerinde gerçekleştirilemez.
400	InvalidOperation.InvalidEniState	%s	Bu işlem, mevcut durumdaki ENI üzerinde gerçekleştirilemez.
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s	Birincil ENI örnekten ayrılamaz.
400	Forbidden.RegionId	%s	Hizmet şu anda bölgede kullanılamıyor.
400	InvalidRegionId.MalFormed	The specified parameter RegionId is not valid.	Geçersiz RegionId değeri.
403	InvalidUserType.NotSupported	%s	Hesabınız bu işlemi desteklemiyor.
403	Abs.InvalidAccount.NotFound	%s	Alibaba Cloud hesabınız bulunamadı veya AccessKey çiftinizin süresi doldu.
403	Forbidden.NotSupportRAM	%s	Resource Access Management (RAM) kullanıcılarının bu işlemi gerçekleştirmek için izni yok.
403	Forbidden.SubUser	%s	Kaynağa erişiminiz yok. Alibaba Cloud hesabının sahibiyle iletişime geçin.
403	MaxEniCountExceeded	%s	Yönetilebilecek maksimum ENI sayısı aşıldı.
403	EniPerInstanceLimitExceeded	%s	Örneğe bağlanabilecek maksimum ENI sayısı aşıldı.
403	InvalidOperation.AvailabilityZoneMismatch	%s	İşlem geçersiz.
403	InvalidOperation.VpcMismatch	%s	İşlem geçersiz. İşlemdeki VPC'nin diğer parametrelerle eşleşip eşleşmediğini kontrol edin.
403	SecurityGroupInstanceLimitExceed	%s	Güvenlik grubundaki maksimum örnek sayısı aşıldı.
403	InvalidSecurityGroupId.NotVpc	%s	Geçersiz güvenlik grubu kimliği. Belirtilen güvenlik grubunun ağ türü VPC değil.
403	InvalidOperation.InvalidEniType	%s	Bu işlem bu ENI türünde gerçekleştirilemez.
403	InvalidVpc.Empty	%s	Belirtilen VPC'de hiçbir vSwitch yok. Daha fazla bilgi için hata mesajındaki %s yer tutucusunun dönüş değerine bakın.
404	InvalidEcsId.NotFound	%s	Örnek kimliği bulunamadı.
404	InvalidEniId.NotFound	%s	ENI kimliği bulunamadı.
404	InvalidVSwitchId.NotFound	%s	Belirtilen vSwitch kimliği bulunamadı.
404	InvalidSecurityGroupId.NotFound	%s	Belirtilen güvenlik grubu kimliği bulunamadı.

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