Tüm Ürünler
Search
Belge Merkezi

:DescribeNetworkInterfaceAttribute

Son Güncelleme:Sep 30, 2026

Elastik ağ arayüzünün (ENI) ayrıntılarını sorgular.

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şlemin örnek kodunu dinamik olarak oluşturur.

İstek parametreleri

Parametre

Tür

Gerekli

Örnek

Açıklama

Action String Evet DescribeNetworkInterfaceAttribute

Gerçekleştirmek istediğiniz işlem. Değeri DescribeNetworkInterfaceAttribute olarak ayarlayın.

RegionId String Evet 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 Hayır TestKey
Not Bu parametre genel kullanıma açık değildir.
Tag.N.Value String Hayır TestValue
Not Bu parametre genel kullanıma açık değildir.
NetworkInterfaceId String Evet eni-bp67acfmxazb4p****

ENI'nin kimliği.

Attribute String Hayır test

ENI'nin niteliği.

Yanıt parametreleri

Parametre

Tür

Örnek

Açıklama

CreationTime String 2019-12-25T12:31:31Z

ENI'nin oluşturulduğu zaman.

VpcId String vpc-bp67acfmxazb4p****

ENI'nin ait olduğu sanal özel cloud (VPC) kimliği.

Type String Secondary

ENI türü. Geçerli değerler:

  • Primary
  • Secondary
Status String Available

ENI durumu. Geçerli değerler:

  • Available: ENI herhangi bir örneğe bağlı değil.
  • 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.

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, Pekin K Alanı'nda bulunan c7re RDMA ile geliştirilmiş bir örneğe bağlıysa HighPerformance değerine sahip olabilir.
NetworkInterfaceName String my-eni-name

ENI adı.

MacAddress String 00:16:3e:12:**:**

ENI'nin ortam erişim denetimi (MAC) adresi.

QueuePairNumber Integer 22
Not Bu parametre davetiye ön izlemesindedir ve genel kullanıma açık değildir.
NetworkInterfaceId String eni-bp125p95hhdhn3ot****

ENI kimliği.

ServiceID Long 12345678910

ENI'nin ait olduğu distribütörü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 distribütör mü olduğunu belirtir.

VSwitchId String vsw-bp1s5fnvk4gn2tws0****

ENI'nin bağlı olduğu vSwitch kimliği.

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

İstek kimliği.

Description String testDescription

ENI açıklaması.

ResourceGroupId String rg-bp67acfmxazb4p****

İlişkili örneğin ait olduğu 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 Varsayılan kaynak grubundaki kaynaklar, bu parametrenin nasıl ayarlandığından bağımsız olarak yanıtta görüntülenir.
ZoneId String cn-hangzhou-g

ENI alan kimliği.

PrivateIpAddress String 10.1.**.**

ENI özel IP adresi.

QueueNumber Integer 8

ENI tarafından desteklenen kuyruk sayısı.

  • Birincil ENI için: Örnek türünün ENI için desteklediği varsayılan kuyruk sayısı döndürülür.
  • İkincil ENI için:
    • ENI InUse durumundaysa aşağıdaki durumlar oluşur:
      • ENI tarafından desteklenen kuyruk sayısı değiştirilmediyse, örnek türünün ENI için desteklediği varsayılan kuyruk sayısı döndürülür.
      • ENI tarafından desteklenen kuyruk sayısı değiştirildiyse, yeni kuyruk sayısı döndürülür.
    • ENI Available durumundaysa aşağıdaki durumlar oluşur:
      • ENI tarafından desteklenen kuyruk sayısı değiştirilmediyse dönüş değeri boş olur.
      • ENI tarafından desteklenen kuyruk sayısı değiştirildiyse, yeni kuyruk sayısı döndürülür.
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 elastik IP adresi (EIP).

PublicIpAddress String 116.62.**.**

ENI EIP'si.

AllocationId String null

EIP kimliği.

Attachment Object
Not Bu parametre davetiye ön izlemesindedir ve genel kullanıma açık değildir.
DeviceIndex Integer hide
Not Bu parametre davetiye ön izlemesindedir ve genel kullanıma açık değildir.
InstanceId String hide
Not Bu parametre davetiye ön izlemesindedir ve genel kullanıma açık değildir.
TrunkNetworkInterfaceId String hide
Not Bu parametre davetiye ön izlemesindedir ve genel kullanıma açık değildir.
MemberNetworkInterfaceIds Array of String hide
Not Bu parametre davetiye ön izlemesindedir ve genel kullanıma açık değildir.
NetworkCardIndex Integer 0

Ağ kartı dizini.

  • ENI Available durumundaysa veya ENI bağlanırken ağ kartı dizini belirtilmemişse bu parametre boştur.
  • ENI InUse durumundaysa ve ENI bağlanırken ağ kartı dizini belirtilmişse belirtilen ağ kartı dizini bu parametrenin değeri olarak döndürülür.
PrivateIpSets Array of PrivateIpSet

Özel IP adresleri.

PrivateIpSet
PrivateIpAddress String 172.17.**.**

ENI özel IP adresi.

Primary Boolean true

IP adresinin birincil özel IP adresi olup olmadığını belirtir. Geçerli değerler:

  • true: birincil özel IP adresi
  • false: ikincil özel IP adresi
AssociatedPublicIp Object

ENI'nin ikincil özel IP adresiyle ilişkili EIP hakkında ayrıntılar.

PublicIpAddress String 116.62.**.**

EIP.

AllocationId String null
Not Bu parametre davetiye ön izlemesindedir ve genel kullanıma açık değildir.
Ipv6Sets Array of Ipv6Set

ENI IPv6 adresleri.

Ipv6Set
Ipv6Address String 2001:db8:1234:1a00::****

ENI'ye atanmış IPv6 adresi.

Ipv4PrefixSets Array of Ipv4PrefixSet

ENI IPv4 ön ekleri.

Ipv4PrefixSet
Ipv4Prefix String 192.168.**.0/28

ENI'ye atanmış IPv4 ön eki.

Ipv6PrefixSets Array of Ipv6PrefixSet

ENI IPv6 ön ekleri.

Ipv6PrefixSet
Ipv6Prefix String 2001:db8:1234:1a00:****::/80

ENI'ye atanmış IPv6 ön eki.

Tags Array of Tag

ENI etiketleri.

Tag
TagValue String TestValue

ENI etiket değeri.

TagKey String TestKey

ENI etiket anahtarı.

BondInterfaceSpecification Object
Not Bu parametre davetiye ön izlemesindedir ve genel kullanıma açık değildir.
BondMode String null
Not Bu parametre davetiye ön izlemesindedir ve genel kullanıma açık değildir.
SlaveInterfaceSpecification Array of SlaveInterfaceSpecificationSet
Not Bu parametre davetiye ön izlemesindedir ve genel kullanıma açık değildir.
SlaveInterfaceSpecificationSet
SlaveNetworkInterfaceId String null
Not Bu parametre davetiye ön izlemesindedir ve genel kullanıma açık değildir.
WorkState String null
Not Bu parametre davetiye ön izlemesindedir ve genel kullanıma açık değildir.
BondNetworkInterfaceId String null
Not Bu parametre davetiye ön izlemesindedir ve genel kullanıma açık değildir.
SlaveInterfaceSpecification Object
Not Bu parametre davetiye ön izlemesindedir ve genel kullanıma açık değildir.
SlaveNetworkInterfaceId String null
Not Bu parametre davetiye ön izlemesindedir ve genel kullanıma açık değildir.
WorkState String null
Not Bu parametre davetiye ön izlemesindedir ve genel kullanıma açık değildir.
BondNetworkInterfaceId String null
Not Bu parametre davetiye ön izlemesindedir ve genel kullanıma açık değildir.
DeleteOnRelease Boolean true

İlişkili örnek serbest bırakıldığında ENI'nin korunup korunmayacağını belirtir. Geçerli değerler:

  • true
  • false

Örnekler

Örnek istekler

http(s)://ecs.aliyuncs.com/?Action=DescribeNetworkInterfaceAttribute
&RegionId=cn-hangzhou
&NetworkInterfaceId=eni-bp67acfmxazb4p****
&Attribute=test
&<Common request parameters>

Örnek başarılı yanıtlar

XML biçimi

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

<DescribeNetworkInterfaceAttributeResponse>
    <CreationTime>2019-12-25T12:31:31Z</CreationTime>
    <VpcId>vpc-bp67acfmxazb4p****</VpcId>
    <Type>Secondary</Type>
    <Status>Available</Status>
    <NetworkInterfaceTrafficMode>Standard</NetworkInterfaceTrafficMode>
    <NetworkInterfaceName>my-eni-name</NetworkInterfaceName>
    <MacAddress>00:16:3e:12:**:**</MacAddress>
    <QueuePairNumber>22</QueuePairNumber>
    <NetworkInterfaceId>eni-bp125p95hhdhn3ot****</NetworkInterfaceId>
    <ServiceID>12345678910</ServiceID>
    <InstanceId>i-bp1e2l6djkndyuli****</InstanceId>
    <OwnerId>123456****</OwnerId>
    <ServiceManaged>true</ServiceManaged>
    <VSwitchId>vsw-bp1s5fnvk4gn2tws0****</VSwitchId>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
    <Description>testDescription</Description>
    <ResourceGroupId>rg-bp67acfmxazb4p****</ResourceGroupId>
    <ZoneId>cn-hangzhou-g</ZoneId>
    <PrivateIpAddress>10.1.**.**</PrivateIpAddress>
    <QueueNumber>8</QueueNumber>
    <SecurityGroupIds>sg-bp18kz60mefsicfg****</SecurityGroupIds>
    <AssociatedPublicIp>
        <PublicIpAddress>116.62.**.**</PublicIpAddress>
        <AllocationId>null</AllocationId>
    </AssociatedPublicIp>
    <Attachment>
        <InstanceId>hide</InstanceId>
        <TrunkNetworkInterfaceId>hide</TrunkNetworkInterfaceId>
        <MemberNetworkInterfaceIds>hide</MemberNetworkInterfaceIds>
        <NetworkCardIndex>0</NetworkCardIndex>
    </Attachment>
    <PrivateIpSets>
        <PrivateIpAddress>172.17.**.**</PrivateIpAddress>
        <Primary>true</Primary>
        <AssociatedPublicIp>
            <PublicIpAddress>116.62.**.**</PublicIpAddress>
            <AllocationId>null</AllocationId>
        </AssociatedPublicIp>
    </PrivateIpSets>
    <Ipv6Sets>
        <Ipv6Address>2001:db8:1234:1a00::****</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>
    <BondInterfaceSpecification>
        <BondMode>null</BondMode>
        <SlaveInterfaceSpecification>
            <SlaveNetworkInterfaceId>null</SlaveNetworkInterfaceId>
            <WorkState>null</WorkState>
            <BondNetworkInterfaceId>null</BondNetworkInterfaceId>
        </SlaveInterfaceSpecification>
    </BondInterfaceSpecification>
    <SlaveInterfaceSpecification>
        <SlaveNetworkInterfaceId>null</SlaveNetworkInterfaceId>
        <WorkState>null</WorkState>
        <BondNetworkInterfaceId>null</BondNetworkInterfaceId>
        <DeleteOnRelease>true</DeleteOnRelease>
    </SlaveInterfaceSpecification>
</DescribeNetworkInterfaceAttributeResponse>

JSON biçimi

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

{
  "CreationTime" : "2019-12-25T12:31:31Z",
  "VpcId" : "vpc-bp67acfmxazb4p****",
  "Type" : "Secondary",
  "Status" : "Available",
  "NetworkInterfaceTrafficMode" : "Standard",
  "NetworkInterfaceName" : "my-eni-name",
  "MacAddress" : "00:16:3e:12:**:**",
  "QueuePairNumber" : 22,
  "NetworkInterfaceId" : "eni-bp125p95hhdhn3ot****",
  "ServiceID" : 12345678910,
  "InstanceId" : "i-bp1e2l6djkndyuli****",
  "OwnerId" : "123456****",
  "ServiceManaged" : true,
  "VSwitchId" : "vsw-bp1s5fnvk4gn2tws0****",
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "Description" : "testDescription",
  "ResourceGroupId" : "rg-bp67acfmxazb4p****",
  "ZoneId" : "cn-hangzhou-g",
  "PrivateIpAddress" : "10.1.**.**",
  "QueueNumber" : 8,
  "SecurityGroupIds" : [ "sg-bp18kz60mefsicfg****" ],
  "AssociatedPublicIp" : {
    "PublicIpAddress" : "116.62.**.**",
    "AllocationId" : "null"
  },
  "Attachment" : {
    "InstanceId" : "hide",
    "TrunkNetworkInterfaceId" : "hide",
    "MemberNetworkInterfaceIds" : [ "hide" ],
    "NetworkCardIndex" : 0
  },
  "PrivateIpSets" : [ {
    "PrivateIpAddress" : "172.17.**.**",
    "Primary" : true,
    "AssociatedPublicIp" : {
      "PublicIpAddress" : "116.62.**.**",
      "AllocationId" : "null"
    }
  } ],
  "Ipv6Sets" : [ {
    "Ipv6Address" : "2001:db8:1234:1a00::****"
  } ],
  "Ipv4PrefixSets" : [ {
    "Ipv4Prefix" : "192.168.**.0/28"
  } ],
  "Ipv6PrefixSets" : [ {
    "Ipv6Prefix" : "2001:db8:1234:1a00:****::/80"
  } ],
  "Tags" : [ {
    "TagValue" : "TestValue",
    "TagKey" : "TestKey"
  } ],
  "BondInterfaceSpecification" : {
    "BondMode" : "null",
    "SlaveInterfaceSpecification" : [ {
      "SlaveNetworkInterfaceId" : "null",
      "WorkState" : "null",
      "BondNetworkInterfaceId" : "null"
    } ]
  },
  "SlaveInterfaceSpecification" : {
    "SlaveNetworkInterfaceId" : "null",
    "WorkState" : "null",
    "BondNetworkInterfaceId" : "null",
    "DeleteOnRelease" : "true"
  }
}

Hata kodları

HTTP durum kodu

Hata kodu

Hata iletisi

Açıklama

400

MissingParameter

%s

Gerekli bir parametre belirtilmemiş.

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

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

Hesap 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ştirme izinleri yok.

403

Forbidden.SubUser

%s

Kaynağa erişiminiz yok. Alibaba Cloud hesabının sahibiyle iletişime geçin.

404

InvalidEniId.NotFound

%s

ENI kimliği bulunamadı.

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