DescribeNetworkInterfaceAttribute - Elastic Compute Service

Mengkueri detail Elastic Network Interface (ENI) berdasarkan ID ENI.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

ecs:DescribeNetworkInterfaceAttribute

get

*NetworkInterface.

acs:ecs:{#regionId}:{#accountId}:eni/{#eniId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah pengontrol antarmuka jaringan (NIC). Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-hangzhou
Tag	array<object>	No	Catatan Parameter ini tidak tersedia untuk digunakan.
	object	No	Catatan Parameter ini tidak tersedia untuk digunakan.
Key	string	No	Catatan Parameter ini tidak tersedia untuk digunakan.	TestKey
Value	string	No	Catatan Parameter ini tidak tersedia untuk digunakan.	TestValue
NetworkInterfaceId	string	Yes	ID pengontrol antarmuka jaringan (NIC).	eni-bp67acfmxazb4p****
Attribute	string	No	Properti Elastic Network Interface (ENI). Nilai valid: attachment: mengkueri informasi lampiran antarmuka jaringan (NIC) anggota untuk antarmuka jaringan (NIC) trunk. Parameter ini berada dalam pratinjau undangan dan tidak tersedia untuk digunakan. connectionTrackingConfiguration: mengkueri konfigurasi pelacakan konektivitas jaringan. Nilai default: kosong.	attachment

Elemen respons

Element	Type	Description	Example
	object	Kumpulan informasi ENI.
CreationTime	string	Pengatur waktu pembuatan antarmuka jaringan. Pengatur waktu menggunakan format ISO 8601 dan ditampilkan dalam UTC.	2019-12-25T12:31:31Z
VpcId	string	ID VPC tempat antarmuka jaringan berada.	vpc-bp67acfmxazb4p****
Type	string	Tipe Elastic Network Interface (ENI). Nilai valid: Primary: antarmuka jaringan primer. Secondary: Elastic Network Interface (ENI) sekunder.	Secondary
Status	string	Status antarmuka jaringan. Nilai valid: Available: aktif. Attaching: sedang dilampirkan. InUse: sedang digunakan. Detaching: sedang dilepas. Deleting: sedang dihapus. Nilai default: kosong, yang menunjukkan bahwa antarmuka jaringan dalam semua status dikueri.	Available
NetworkInterfaceTrafficMode	string	Mode komunikasi antarmuka jaringan. Nilai valid: Jenis Penyimpanan Standar: menggunakan mode komunikasi TCP. HighPerformance: mengaktifkan Elastis RDMA Interface (ERI) dan menggunakan mode komunikasi RDMA. Catatan Nilai parameter HighPerformance hanya didukung oleh keluarga instans yang ditingkatkan RDMA c7re.	Jenis Penyimpanan Standar
NetworkInterfaceName	string	Nama antarmuka jaringan.	my-eni-name
MacAddress	string	Alamat MAC antarmuka jaringan.	00:16:3e:12::
QueuePairNumber	integer	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.	22
NetworkInterfaceId	string	ID pengontrol antarmuka jaringan (NIC).	eni-bp125p95hhdhn3ot****
ServiceID	integer	ID Virtual Network Operator (VNO) yang terkait dengan antarmuka jaringan.	12345678910
InstanceId	string	ID instans tempat antarmuka jaringan dilampirkan. Catatan Antarmuka jaringan yang dikelola dan dikendalikan oleh layanan Alibaba Cloud lainnya tidak mengembalikan ID instans.	i-bp1e2l6djkndyuli****
OwnerId	string	ID akun yang memiliki antarmuka jaringan.	123456****
ServiceManaged	boolean	Apakah pengguna antarmuka jaringan adalah layanan Alibaba Cloud atau VNO.	true
VSwitchId	string	ID vSwitch tempat antarmuka jaringan berada.	vsw-bp1s5fnvk4gn2tws0****
RequestId	string	ID permintaan.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
Description	string	Deskripsi antarmuka jaringan.	testDescription
ResourceGroupId	string	ID kelompok sumber daya tempat instans berada. Saat menggunakan parameter ini untuk memfilter resource, jumlah resource tidak boleh melebihi 1000. Catatan Memfilter berdasarkan kelompok sumber daya default tidak didukung.	rg-bp67acfmxazb4p****
ZoneId	string	ID zona.	cn-hangzhou-g
PrivateIpAddress	string	Alamat IP privat antarmuka jaringan.	10.1..
QueueNumber	integer	Jumlah antrian untuk Elastic Network Interface (ENI). Jika ENI adalah antarmuka jaringan primer: jumlah antrian default untuk antarmuka jaringan primer yang diizinkan oleh tipe instans akan dikembalikan. Jika ENI adalah ENI sekunder: Jika ENI sekunder berada dalam status InUse: Jika jumlah antrian untuk ENI sekunder belum dimodifikasi, jumlah antrian default untuk ENI sekunder yang diizinkan oleh tipe instans akan dikembalikan. Jika jumlah antrian untuk ENI sekunder telah dimodifikasi, jumlah antrian yang telah dimodifikasi akan dikembalikan. Jika ENI sekunder berada dalam status aktif (Available): Jika jumlah antrian untuk ENI sekunder belum dimodifikasi, nilai kosong akan dikembalikan. Jika jumlah antrian untuk ENI sekunder telah dimodifikasi, jumlah antrian yang telah dimodifikasi akan dikembalikan.	8
SecurityGroupIds	object
SecurityGroupId	array	Kumpulan grup keamanan tempat antarmuka jaringan berada.
	string	Grup keamanan tempat antarmuka jaringan berada.	sg-bp18kz60mefsicfg****
AssociatedPublicIp	object	Elastic IP Address (EIP) yang terkait dengan alamat IP privat sekunder antarmuka jaringan.
PublicIpAddress	string	Alamat EIP.	116.62..
AllocationId	string	ID EIP.	null
Attachment	object	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.
DeviceIndex	integer	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.	hide
InstanceId	string	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.	hide
TrunkNetworkInterfaceId	string	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.	hide
MemberNetworkInterfaceIds	object
MemberNetworkInterfaceId	array	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.
	string	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.	hide
NetworkCardIndex	integer	Indeks Kartu jaringan fisik tempat ENI dilampirkan. Jika ENI berada dalam status Available atau indeks tidak ditentukan saat pelampiran, nilai ini tidak dikembalikan. Jika ENI berada dalam status InUse dan indeks ditentukan saat pelampiran, nilai ini menunjukkan indeks Kartu jaringan fisik tempat ENI dilampirkan.	0
PrivateIpSets	object
PrivateIpSet	array<object>	Kumpulan informasi alamat IP privat untuk antarmuka jaringan.
	array<object>	Informasi alamat IP privat antarmuka jaringan.
PrivateIpAddress	string	Alamat IP privat antarmuka jaringan.	172.17..
Primary	boolean	Apakah alamat IP adalah alamat IP privat primer. Nilai valid: true: alamat IP privat primer. false: alamat IP privat sekunder.	true
AssociatedPublicIp	object	Elastic IP Address (EIP) yang terkait dengan alamat IP privat sekunder antarmuka jaringan.
PublicIpAddress	string	Alamat EIP.	116.62..
AllocationId	string	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.	null
Ipv6Sets	object
Ipv6Set	array<object>	Daftar alamat IPv6 yang dialokasikan ke antarmuka jaringan.
	object	Alamat IPv6 yang dialokasikan ke antarmuka jaringan.
Ipv6Address	string	Alamat IPv6 yang ditetapkan ke antarmuka jaringan.	2001:db8:1234:1a00::****
Primary	boolean
Ipv4PrefixSets	object
Ipv4PrefixSet	array<object>	Kumpulan awalan IPv4 yang dialokasikan ke antarmuka jaringan.
	object	Awalan IPv4 yang ditetapkan ke ENI.
Ipv4Prefix	string	Awalan IPv4 yang dialokasikan ke antarmuka jaringan (NIC).	192.168.**.0/28
Ipv6PrefixSets	object
Ipv6PrefixSet	array<object>	Kumpulan awalan IPv6 yang dialokasikan ke antarmuka jaringan.
	object
Ipv6Prefix	string	Awalan IPv6 yang dialokasikan ke antarmuka jaringan (NIC).	2001:db8:1234:1a00:****::/80
Tags	object
Tag	array<object>	Kumpulan tag untuk antarmuka jaringan.
	object	Informasi tag antarmuka jaringan.
TagValue	string	Nilai tag.	TestValue
TagKey	string	Kunci tag.	TestKey
BondInterfaceSpecification	object	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.
BondMode	string	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.	null
SlaveInterfaceSpecification	object
SlaveInterfaceSpecificationSet	array<object>	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.
	object	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.
SlaveNetworkInterfaceId	string	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.	null
WorkState	string	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.	null
BondNetworkInterfaceId	string	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.	null
SlaveInterfaceSpecification	object	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.
SlaveNetworkInterfaceId	string	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.	null
WorkState	string	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.	null
BondNetworkInterfaceId	string	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.	null
DeleteOnRelease	boolean	Apakah ENI dipertahankan saat Instansi terkait dilepas. Nilai valid: true: ENI tidak dipertahankan. false: ENI dipertahankan.	true
TcpOptionAddressEnabled	string	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.	null
NetworkInterfaceTrafficConfig	object	Parameter trafik pengontrol antarmuka jaringan (NIC).
NetworkInterfaceTrafficMode	string	Mode komunikasi pengontrol antarmuka jaringan (NIC).	HighPerformance
QueueNumber	integer	Jumlah antrian untuk pengontrol antarmuka jaringan (NIC).	8
QueuePairNumber	integer	Jumlah pasangan antrian RDMA.	8
ConnectionTrackingConfiguration	object	Kumpulan informasi konfigurasi pelacakan konektivitas jaringan. Sebelum menggunakan parameter ini, baca Manajemen pengatur waktu koneksi. Catatan Parameter ini hanya dikembalikan saat parameter input Attribute diatur ke connectionTrackingConfiguration.
TcpEstablishedTimeout	integer	Periode pengatur waktu tunggu untuk koneksi TCP dalam status ESTABLISHED. Unit: detik. Nilai valid: [30, 60, 80, 100, 200, 300, 500, 700, 910].	910
TcpClosedAndTimeWaitTimeout	integer	Periode pengatur waktu tunggu untuk koneksi TCP dalam status TIME_WAIT dan CLOSED. Unit: detik. Nilai valid: bilangan bulat dari 3 hingga 15. Catatan Jika Instans ECS Anda digunakan dengan NLB atau CLB, pengatur waktu tunggu default untuk koneksi dalam status `TIME_WAIT` adalah 15 detik.	3
UdpTimeout	integer	Periode pengatur waktu tunggu untuk aliran UDP. Unit: detik. Nilai valid: [10, 20, 30, 60, 80, 100]. Catatan Jika Instans ECS Anda digunakan dengan NLB atau CLB, nilai default adalah 100 detik.	30
SourceDestCheck	boolean	Parameter ini tidak tersedia secara publik.	false
EnhancedNetwork	object	Parameter ini tidak tersedia secara publik.
EnableSriov	boolean	Parameter ini tidak tersedia secara publik.	false
EnableRss	boolean	Catatan Parameter ini tidak tersedia untuk digunakan.	true
VirtualFunctionTotalQueueNumber	integer
VirtualFunctionQuantity	integer
EnableExpress	boolean
QoSConfig	object	Pengaturan pembatasan laju QoS.
EnableQoS	boolean	Apakah pembatasan laju QoS diaktifkan.
QoS	object	Pengaturan pembatasan laju QoS.
BandwidthTx	integer	Batas bandwidth internal arah keluar maksimum.	50000
BandwidthRx	integer	Batas bandwidth internal arah masuk maksimum.	50000
PpsTx	integer	Laju penerusan paket jaringan internal arah keluar.	50000
PpsRx	integer	Laju penerusan paket jaringan internal arah masuk.	50000
ConcurrentConnections	integer	Jumlah sesi maksimum.	50000

Contoh

Respons sukses

JSONformat

{
  "CreationTime": "2019-12-25T12:31:31Z",
  "VpcId": "vpc-bp67acfmxazb4p****",
  "Type": "Secondary",
  "Status": "Available",
  "NetworkInterfaceTrafficMode": "Jenis Penyimpanan Standar",
  "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": {
    "SecurityGroupId": [
      "sg-bp18kz60mefsicfg****"
    ]
  },
  "AssociatedPublicIp": {
    "PublicIpAddress": "116.62.**.**",
    "AllocationId": "null"
  },
  "Attachment": {
    "DeviceIndex": 0,
    "InstanceId": "hide",
    "TrunkNetworkInterfaceId": "hide",
    "MemberNetworkInterfaceIds": {
      "MemberNetworkInterfaceId": [
        "hide"
      ]
    },
    "NetworkCardIndex": 0
  },
  "PrivateIpSets": {
    "PrivateIpSet": [
      {
        "PrivateIpAddress": "172.17.**.**",
        "Primary": true,
        "AssociatedPublicIp": {
          "PublicIpAddress": "116.62.**.**",
          "AllocationId": "null"
        }
      }
    ]
  },
  "Ipv6Sets": {
    "Ipv6Set": [
      {
        "Ipv6Address": "2001:db8:1234:1a00::****",
        "Primary": false
      }
    ]
  },
  "Ipv4PrefixSets": {
    "Ipv4PrefixSet": [
      {
        "Ipv4Prefix": "192.168.**.0/28"
      }
    ]
  },
  "Ipv6PrefixSets": {
    "Ipv6PrefixSet": [
      {
        "Ipv6Prefix": "2001:db8:1234:1a00:****::/80"
      }
    ]
  },
  "Tags": {
    "Tag": [
      {
        "TagValue": "TestValue",
        "TagKey": "TestKey"
      }
    ]
  },
  "BondInterfaceSpecification": {
    "BondMode": "null",
    "SlaveInterfaceSpecification": {
      "SlaveInterfaceSpecificationSet": [
        {
          "SlaveNetworkInterfaceId": "null",
          "WorkState": "null",
          "BondNetworkInterfaceId": "null"
        }
      ]
    }
  },
  "SlaveInterfaceSpecification": {
    "SlaveNetworkInterfaceId": "null",
    "WorkState": "null",
    "BondNetworkInterfaceId": "null"
  },
  "DeleteOnRelease": true,
  "TcpOptionAddressEnabled": "null",
  "NetworkInterfaceTrafficConfig": {
    "NetworkInterfaceTrafficMode": "HighPerformance",
    "QueueNumber": 8,
    "QueuePairNumber": 8
  },
  "ConnectionTrackingConfiguration": {
    "TcpEstablishedTimeout": 910,
    "TcpClosedAndTimeWaitTimeout": 3,
    "UdpTimeout": 30
  },
  "SourceDestCheck": false,
  "EnhancedNetwork": {
    "EnableSriov": false,
    "EnableRss": true,
    "VirtualFunctionTotalQueueNumber": 0,
    "VirtualFunctionQuantity": 0,
    "EnableExpress": false
  },
  "QoSConfig": {
    "EnableQoS": false,
    "QoS": {
      "BandwidthTx": 50000,
      "BandwidthRx": 50000,
      "PpsTx": 50000,
      "PpsRx": 50000,
      "ConcurrentConnections": 50000
    }
  }
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	MissingParameter	%s	Parameter yang diperlukan hilang.
400	UnsupportedParameter	%s	Port parameter yang ditentukan tidak didukung. Periksa apakah parameter sudah benar.
400	InvalidParameter	%s	Parameter permintaan saat ini tidak valid. Coba lagi.
400	InvalidInstanceID.Malformed	%s
400	Forbidden.RegionId	%s	Layanan saat ini tidak tersedia di wilayah ini.
400	InvalidRegionId.MalFormed	The specified parameter RegionId is not valid.
403	InvalidUserType.NotSupported	%s	Tipe pengguna tidak valid.
403	Abs.InvalidAccount.NotFound	%s	Akun tidak ditemukan, atau AccessKey telah kedaluwarsa.
403	Forbidden.NotSupportRAM	%s	Pengguna Resource Access Management (RAM) tidak didukung untuk menjalankan operasi ini.
403	Forbidden.SubUser	%s	Pengguna RAM Anda saat ini tidak memiliki izin untuk melakukan operasi pada Sumber daya ini.
403	InvalidParameter	%s
404	InvalidEniId.NotFound	%s

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.