DescribeNetworkInterfaces - Elastic Compute Service - Alibaba Cloud Documentation Center

Mengkueri detail satu atau beberapa Elastic Network Interface (ENI).

Deskripsi operasi

Deskripsi operasi.

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:DescribeNetworkInterfaces

get

NetworkInterface.

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-hangzhou
Tag	array<object>	No	Tag.
	object	No
Key	string	No	Kunci tag antarmuka jaringan (NIC). Nilai valid N: 1 hingga 20.	TestKey
Value	string	No	Nilai tag antarmuka jaringan (NIC). Nilai valid N: 1 hingga 20.	TestValue
ResourceGroupId	string	No	ID kelompok sumber daya. Saat menggunakan parameter ini untuk memfilter resource, jumlah resource tidak boleh melebihi 1000.	rg-bp67acfmxazb4p****
VSwitchId	string	No	ID vSwitch antarmuka jaringan (NIC).	vsw-bp16usj2p27htro3****
VpcId	string	No	ID Virtual Private Cloud (VPC) antarmuka jaringan (NIC).	vpc-bp1j7w3gc1cexjqd****
PrimaryIpAddress	string	No	Alamat IP privat primer antarmuka jaringan (NIC).	192.168..
SecurityGroupId	string	No	ID grup keamanan yang terkait dengan ENI sekunder.	sg-bp144yr32sx6ndw****
NetworkInterfaceName	string	No	Nama antarmuka jaringan (NIC). Panjang nama harus antara 2 hingga 128 karakter dan dapat berisi karakter dalam kategorisasi huruf Unicode (termasuk huruf Inggris, karakter Tiongkok, dan angka). Nama juga dapat berisi titik dua (:), garis bawah (_), titik (.), dan tanda hubung (-).	test-eni-name
Type	string	No	Tipe antarmuka jaringan (NIC). Nilai valid:	Secondary
InstanceId	string	No	ID instans tempat antarmuka jaringan (NIC) terpasang.	i-bp1e2l6djkndyuli****
ServiceManaged	boolean	No	Apakah pengguna antarmuka jaringan (NIC) adalah layanan Alibaba Cloud atau Virtual Network Operator (VNO).	true
Status	string	No	Status antarmuka jaringan (NIC). Nilai valid:	Available
PageNumber `deprecated`	integer	No	[Deprecated] Gunakan MaxResults atau NextToken untuk paginasi sebagai gantinya.	1
PageSize `deprecated`	integer	No	[Deprecated] Gunakan MaxResults atau NextToken untuk paginasi sebagai gantinya.	100
NextToken	string	No	Token paginasi. Atur parameter ini ke nilai NextToken yang dikembalikan dalam panggilan API sebelumnya.	AAAAAdDWBF2****
MaxResults	integer	No	Jumlah entri maksimum per halaman untuk kueri paging. Nilai valid: 10 hingga 500.	50
PrivateIpAddress	array	No	Alamat IP privat sekunder antarmuka jaringan (NIC). Nilai valid N: 1 hingga 100.	192.168..
	string	No	Alamat IP privat sekunder antarmuka jaringan (NIC). Nilai valid N: 1 hingga 100.	192.168..
NetworkInterfaceId	array	No	ID antarmuka jaringan (NIC). Nilai valid N: 1 hingga 100.	eni-bp125p95hhdhn3ot****
	string	No	ID antarmuka jaringan (NIC). Nilai valid N: 1 hingga 100.	eni-bp125p95hhdhn3ot****
Ipv6Address	array	No	Alamat IPv6 antarmuka jaringan (NIC). N menunjukkan bahwa Anda dapat mengonfigurasi beberapa alamat IPv6. Nilai valid N: 1 hingga 100.	2408:4321:180:1701:94c7:bc38:3bfa:****
	string	No	Alamat IPv6 antarmuka jaringan (NIC). N menunjukkan bahwa Anda dapat mengonfigurasi beberapa alamat IPv6. Nilai valid N: 1 hingga 100.	2408:4321:180:1701:94c7:bc38:3bfa:****

Elemen respons

Element	Type	Description	Example
	object
NextToken	string	Token paginasi yang dikembalikan dalam panggilan ini.	AAAAAdDWBF2****
PageSize	integer	Parameter kueri paging.	1
PageNumber	integer	Parameter kueri paging.	1
RequestId	string	ID permintaan.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
TotalCount	integer	Jumlah total Elastic Network Interface (ENI) yang dikembalikan.	2
NetworkInterfaceSets	object
NetworkInterfaceSet	array<object>	Informasi antarmuka jaringan (NIC).
	array<object>
CreationTime	string	Waktu pembuatan. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.	2019-12-25T12:31:31Z
VpcId	string	ID virtual private cloud (VPC) dari antarmuka jaringan.	vpc-bp1j7w3gc1cexjqd****
Type	string	Tipe antarmuka jaringan. Nilai valid:	Secondary
Status	string	Status antarmuka jaringan. Nilai valid:	Available
NetworkInterfaceTrafficMode	string	Mode komunikasi pengontrol antarmuka jaringan (NIC). Nilai valid:	Jenis Penyimpanan Standar
NetworkInterfaceName	string	Nama pengontrol antarmuka jaringan (NIC).	my-eni-name
MacAddress	string	Alamat MAC dari pengontrol antarmuka jaringan (NIC).	00:16:3e:12::
QueuePairNumber	integer	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.	0
NetworkInterfaceId	string	ID pengontrol antarmuka jaringan (NIC).	eni-bp125p95hhdhn3ot****
ServiceID	integer	ID Virtual Network Operator (VNO) yang terkait dengan pengontrol antarmuka jaringan (NIC).	12345678910
InstanceId	string	ID instans dari instans tempat pengontrol antarmuka jaringan (NIC) terpasang.	i-bp1e2l6djkndyuli****
OwnerId	string	ID akun yang memiliki pengontrol antarmuka jaringan (NIC).	123456****
ServiceManaged	boolean	Menunjukkan apakah pengguna pengontrol antarmuka jaringan (NIC) adalah layanan cloud atau Virtual Network Operator (VNO).	true
VSwitchId	string	ID vSwitch dari VPC.	vsw-bp16usj2p27htro3****
Description	string	Deskripsi.	DescriptionTest
ResourceGroupId	string	ID kelompok sumber daya.	rg-2ze88m67qx5z****
ZoneId	string	ID zona.	cn-hangzhou-e
PrivateIpAddress	string	Alamat IP privat dari pengontrol antarmuka jaringan (NIC).	172.17..
QueueNumber	integer	Jumlah antrian untuk pengontrol antarmuka jaringan (NIC).	8
PrivateIpSets	object
PrivateIpSet	array<object>	Koleksi objek PrivateIpSet.
	array<object>
PrivateIpAddress	string	Alamat IP privat dari instans.	172.17..
Primary	boolean	Menunjukkan apakah alamat IP tersebut adalah alamat IP privat utama. Nilai valid:	true
AssociatedPublicIp	object	Elastic IP Address (EIP) yang terkait dengan pengontrol antarmuka jaringan (NIC).
PublicIpAddress	string	Alamat EIP.	116.62..
AllocationId	string	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.	null
PrivateDnsName	string	Nama DNS privat dari instans.	DnsTestName
Ipv6Sets	object
Ipv6Set	array<object>	Alamat IPv6 yang ditetapkan ke pengontrol antarmuka jaringan (NIC).
	object
Ipv6Address	string	Alamat IPv6 yang ditetapkan ke pengontrol antarmuka jaringan (NIC).	2408:4321:180:1701:94c7:bc38:3bfa:****
Primary	boolean
Ipv4PrefixSets	object
Ipv4PrefixSet	array<object>	Awalan IPv4 yang ditetapkan ke pengontrol antarmuka jaringan (NIC).
	object
Ipv4Prefix	string	Awalan IPv4 yang ditetapkan ke pengontrol antarmuka jaringan (NIC).	192.168.**.0/28
Ipv6PrefixSets	object
Ipv6PrefixSet	array<object>	Awalan IPv6 yang ditetapkan ke pengontrol antarmuka jaringan (NIC).
	object
Ipv6Prefix	string	Awalan IPv6 yang ditetapkan ke pengontrol antarmuka jaringan (NIC).	2001:db8:1234:1a00:****::/80
Tags	object
Tag	array<object>	Tag.
	object
TagValue	string	Nilai tag.	TestValue
TagKey	string	Kunci tag.	TestKey
SecurityGroupIds	object
SecurityGroupId	array	Grup keamanan tempat ENI berada.
	string	ID grup keamanan.	sg-bp18kz60mefsicfg****
AssociatedPublicIp	object	Elastic IP Address (EIP) yang terkait dengan alamat IP privat sekunder dari pengontrol antarmuka jaringan (NIC).
PublicIpAddress	string	Alamat EIP.	116.62..
AllocationId	string	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.	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.	0
InstanceId	string	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.	null
TrunkNetworkInterfaceId	string	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.	null
NetworkCardIndex	integer	Indeks Kartu jaringan fisik tempat ENI terpasang.	0
DeleteOnRelease	boolean	Menunjukkan apakah ENI dipertahankan saat Instansi terkait dilepaskan. Nilai valid:	true
SourceDestCheck	boolean	Menunjukkan apakah pemeriksaan sumber/tujuan diaktifkan. Kami menyarankan Anda mengaktifkan fitur ini untuk meningkatkan keamanan jaringan. Nilai valid:	false

Contoh

Respons sukses

JSONformat

{
  "NextToken": "AAAAAdDWBF2****",
  "PageSize": 1,
  "PageNumber": 1,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "TotalCount": 2,
  "NetworkInterfaceSets": {
    "NetworkInterfaceSet": [
      {
        "CreationTime": "2019-12-25T12:31:31Z",
        "VpcId": "vpc-bp1j7w3gc1cexjqd****",
        "Type": "Secondary",
        "Status": "Available",
        "NetworkInterfaceTrafficMode": "Jenis Penyimpanan Standar",
        "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": {
          "PrivateIpSet": [
            {
              "PrivateIpAddress": "172.17.**.**",
              "Primary": true,
              "AssociatedPublicIp": {
                "PublicIpAddress": "116.62.**.**",
                "AllocationId": "null"
              },
              "PrivateDnsName": "DnsTestName"
            }
          ]
        },
        "Ipv6Sets": {
          "Ipv6Set": [
            {
              "Ipv6Address": "2408:4321:180:1701:94c7:bc38:3bfa:****",
              "Primary": false
            }
          ]
        },
        "Ipv4PrefixSets": {
          "Ipv4PrefixSet": [
            {
              "Ipv4Prefix": "192.168.**.0/28"
            }
          ]
        },
        "Ipv6PrefixSets": {
          "Ipv6PrefixSet": [
            {
              "Ipv6Prefix": "2001:db8:1234:1a00:****::/80"
            }
          ]
        },
        "Tags": {
          "Tag": [
            {
              "TagValue": "TestValue",
              "TagKey": "TestKey"
            }
          ]
        },
        "SecurityGroupIds": {
          "SecurityGroupId": [
            "sg-bp18kz60mefsicfg****"
          ]
        },
        "AssociatedPublicIp": {
          "PublicIpAddress": "116.62.**.**",
          "AllocationId": "null"
        },
        "Attachment": {
          "DeviceIndex": 0,
          "InstanceId": "null",
          "TrunkNetworkInterfaceId": "null",
          "NetworkCardIndex": 0
        },
        "DeleteOnRelease": true,
        "SourceDestCheck": false
      }
    ]
  }
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	MissingParameter	%s	Setidaknya satu dari parameter yang ditentukan harus disediakan. Parameter-parameter tersebut tidak boleh semuanya kosong.
400	UnsupportedParameter	%s	Parameter yang ditentukan tidak didukung.
400	InvalidParameter	%s	Kombinasi parameter yang ditentukan tidak valid.
400	InvalidInstanceID.Malformed	%s
400	InvalidOperation.InvalidEcsState	%s	Status instans saat ini tidak mendukung operasi ini.
400	InvalidOperation.InvalidEniState	%s	Status ENI saat ini tidak mengizinkan pengubahan atribut ENI.
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s	Melepaskan ENI primer dari instans tidak diizinkan.
400	Forbidden.RegionId	%s	Layanan ini sementara tidak tersedia di wilayah saat ini.
400	InvalidRegionId.MalFormed	The specified parameter RegionId is not valid.
403	InvalidUserType.NotSupported	%s	Parameter tipe pengguna tidak valid.
403	Abs.InvalidAccount.NotFound	%s	Akun Alibaba Cloud Anda tidak ada, atau AccessKey Anda telah kedaluwarsa.
403	Forbidden.NotSupportRAM	%s	Pengguna Resource Access Management (RAM) tidak didukung untuk menjalankan operasi ini.
403	Forbidden.SubUser	%s	Akun Anda tidak memiliki izin untuk mengoperasikan resource ini. Minta izin yang diperlukan dari akun Alibaba Cloud.
403	InvalidParameter	%s
403	MaxEniCountExceeded	%s	Jumlah maksimum Elastic Network Interface (ENI) yang dapat dioperasikan telah terlampaui.
403	EniPerInstanceLimitExceeded	%s	Jumlah Elastic Network Interface (ENI) yang menyambungkan ke instans telah mencapai batas maksimum. Tidak ada lagi Elastic Network Interface (ENI) yang dapat disambungkan ke instans.
403	InvalidOperation.AvailabilityZoneMismatch	%s	Antarmuka jaringan (NIC) dan Instans ECS tidak berada di zona yang sama karena vSwitch mereka berada di zona yang berbeda.
403	InvalidOperation.VpcMismatch	%s	VPC dari pengontrol antarmuka jaringan (NIC) tidak cocok dengan VPC dari grup keamanan.
403	SecurityGroupInstanceLimitExceed	%s	Jumlah instans dalam grup keamanan telah mencapai batas maksimum.
403	InvalidSecurityGroupId.NotVpc	%s	Parameter SecurityGroupId tidak valid. Jenis jaringan grup keamanan bukan VPC.
403	InvalidOperation.InvalidEniType	%s	Tipe Elastic Network Interface (ENI) saat ini tidak mendukung operasi ini.
403	InvalidVpc.Empty	%s	Tidak ada vSwitch yang dibuat di VPC yang ditentukan. Untuk informasi selengkapnya, lihat hasil pengembalian aktual dari placeholder %s dalam pesan error.
403	Forbidden.RegionId	%s
403	InvalidOperation.InvalidEniPageNumber	%s
403	InvalidVpc.Indeterminacy	%s
404	InvalidEcsId.NotFound	%s	ID instans yang ditentukan tidak ada.
404	InvalidEniId.NotFound	%s
404	InvalidVSwitchId.NotFound	%s	vSwitch yang ditentukan tidak ada.
404	InvalidSecurityGroupId.NotFound	%s	Grup keamanan yang ditentukan tidak ada.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.