Pencarian sumber dan anggota multicast ENI dengan ListGrantVSwitchEnis - Cloud Enterprise Network - Alibaba Cloud - Cloud Enterprise Network

Mengkueri antarmuka jaringan elastis (ENI) dalam virtual private cloud (VPC) yang dapat berfungsi sebagai sumber multicast atau anggota multicast untuk komunikasi multicast.

Deskripsi operasi

Sebelum Anda memanggil operasi ListGrantVSwitchEnis, pastikan bahwa instans yang terhubung ke VPC telah terhubung ke Cloud Enterprise Network (CEN). Untuk informasi lebih lanjut, lihat CreateTransitRouterVpcAttachment.

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

cen:ListGrantVSwitchEnis

get

*CenInstance

acs:cen:*:{#accountId}:ceninstance/{#ceninstanceId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
CenId	string	Yes	ID Instans CEN tempat instans yang terhubung ke VPC berada.	cen-a7syd349kne38g****
VpcId	string	Yes	ID instans yang terhubung ke VPC.	vpc-p0w9alkte4w2htrqe****
VSwitchId	string	Yes	ID vSwitch pada instans yang terhubung ke VPC. Anda hanya dapat mengkueri informasi antarmuka jaringan (NIC) untuk satu vSwitch dalam satu pengatur waktu.	vsw-p0w9s2ig1jnwgrbzl****
NextToken	string	No	Token untuk kueri berikutnya. Nilai valid: Jika ini adalah kueri pertama atau tidak ada kueri berikutnya, biarkan parameter ini kosong. Jika ada kueri berikutnya, atur parameter ini ke nilai NextToken yang dikembalikan oleh panggilan API sebelumnya.	AAAAAdDWBF2****
MaxResults	integer	No	Jumlah maksimum entri per halaman untuk kueri berhalaman. Nilai valid: 10 hingga 500. Nilai default: Jika Anda tidak mengatur parameter ini, nilai defaultnya adalah 20. Jika nilai yang Anda atur lebih besar dari 500, nilai defaultnya adalah 500.	20
NetworkInterfaceId	array	No	ID antarmuka jaringan (NIC).
	string	No	ID antarmuka jaringan elastis (ENI). Saat ini, hanya ENI yang terkait dengan instans ECS yang dapat berfungsi sebagai sumber multicast. Sistem mengirimkan Trafik multicast ke kelompok multicast dari alamat IP privat utama antarmuka jaringan elastis (ENI).	eni-wz9a2sgsskvw69v2****
NetworkInterfaceName	string	No	Nama antarmuka jaringan elastis (ENI). Anda dapat menggunakan parameter ini untuk memfilter network interface controllers (NIC) berdasarkan nama.	test-eni-name.
PrimaryIpAddress	string	No	Alamat IP IPv4 privat utama antarmuka jaringan elastis (ENI). Anda dapat menggunakan parameter ini untuk memfilter network interface controllers (NIC) berdasarkan alamat IP privat utama.	192.168..

Elemen respons

Element	Type	Description	Example
	object	Parameter tanggapan.
RequestId	string	ID permintaan.	DBFE1736-2F33-5309-9954-875B11E9519D.
TotalCount	string	Jumlah total entri yang dikembalikan. Penting Saat Anda menggunakan parameter MaxResults dan NextToken untuk paging, nilai parameter Total yang dikembalikan tidak memiliki arti.	6
GrantVSwitchEnis	array<object>	Daftar informasi antarmuka jaringan (NIC).
	object	Informasi antarmuka jaringan elastis (ENI). Setiap entri berisi detail sebuah network interface controller (NIC).
VpcId	string	ID instans yang terhubung ke VPC.	vpc-p0w9alkte4w2htrqe****
VSwitchId	string	ID vSwitch.	vsw-p0w9s2ig1jnwgrbzl****
NetworkInterfaceId	string	ID antarmuka jaringan elastis (ENI). Ini adalah pengenal network interface controller (NIC).	eni-p0w172vv82kxzb49****
Description	string	Deskripsi antarmuka jaringan elastis (ENI). Ini mendeskripsikan network interface controller (NIC).	created by CBN.
TransitRouterFlag	boolean	Apakah antarmuka jaringan elastis (ENI) dibuat oleh Router transit untuk tujuan perutean dan penerusan. true: ENI dibuat oleh Router transit. false: ENI tidak dibuat oleh Router transit. Antarmuka jaringan elastis (ENI) yang dibuat oleh Router transit tidak dapat berfungsi sebagai sumber multicast atau anggota multicast.	false.
NetworkInterfaceName	string	Nama antarmuka jaringan elastis (ENI). Ini adalah nama network interface controller (NIC).	my-eni-name.
PrimaryIpAddress	string	Alamat IP IPv4 privat utama antarmuka jaringan elastis (ENI). Ini adalah alamat IP privat utama network interface controller (NIC).	192.168..
NextToken	string	Token yang dikembalikan untuk kueri ini.	AAAAAdDWBF2****
MaxResults	integer	Jumlah maksimum entri yang dikembalikan untuk kueri ini.	20

Contoh

Respons sukses

JSONformat

{
  "RequestId": "DBFE1736-2F33-5309-9954-875B11E9519D",
  "TotalCount": "6",
  "GrantVSwitchEnis": [
    {
      "VpcId": "vpc-p0w9alkte4w2htrqe****",
      "VSwitchId": "vsw-p0w9s2ig1jnwgrbzl****",
      "NetworkInterfaceId": "eni-p0w172vv82kxzb49****",
      "Description": "created by CBN",
      "TransitRouterFlag": false,
      "NetworkInterfaceName": "my-eni-name",
      "PrimaryIpAddress": "192.168.**.**"
    }
  ],
  "NextToken": "AAAAAdDWBF2****",
  "MaxResults": 20
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidCenId.NotFound	The specified CenId is not found.	CenId yang ditentukan dalam parameter tidak ada.
400	InvalidVpcId.NotFound	The specified VpcId is not found.	VpcId yang ditentukan dalam parameter tidak ada.
400	InvalidOperation.MulticastDomainAssociationNotExist	Operation is invalid because multicast association domain association not exist.	Asosiasi domain multicast tidak ada. Operasi tidak didukung.
400	InvalidParameter	Invalid parameter.	Parameter tidak valid.
400	Unauthorized	The AccessKeyId is unauthorized.	Akun tidak memiliki izin untuk melakukan operasi ini.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.