Gunakan ListVpcEndpointConnections API - PrivateLink - Alibaba Cloud - PrivateLink

Mengkueri koneksi titik akhir.

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

privatelink:ListVpcEndpointConnections

list

*VpcEndpointService

acs:privatelink:{#regionId}:{#accountId}:vpcendpointservice/{#ServiceId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah dari koneksi titik akhir yang akan dikueri. Anda dapat memanggil DescribeRegions untuk mendapatkan ID wilayah.	cn-huhehaote
NextToken	string	No	Apakah akan menyertakan token untuk kueri berikutnya. Nilai valid: Biarkan parameter ini kosong untuk kueri pertama atau jika tidak ada kueri berikutnya. Jika ada kueri berikutnya, atur parameter ini ke nilai NextToken yang dikembalikan oleh panggilan API sebelumnya.	caeba0bbb2be03f84eb48b699f0a4883
MaxResults	integer	No	Jumlah entri per halaman. Nilai valid: 1 hingga 1000. Nilai default: 50.	50
ServiceId	string	No	ID layanan titik akhir.	epsrv-hp3vpx8yqxblby3i****
EniId	string	No	ID antarmuka jaringan elastis (ENI) titik akhir.	eni-hp32lk0pyv6o94hs****
EndpointId	string	No	ID titik akhir.	ep-hp33b2e43fays7s8****
ConnectionStatus	string	No	Status koneksi titik akhir. Nilai valid: Pending: sedang dimodifikasi. Connecting: sedang menghubungkan. Connected: terhubung. Disconnecting: sedang memutuskan koneksi. Disconnected: terputus. Deleting: sedang dihapus. ServiceDeleted: layanan titik akhir terkait telah dihapus.	Disconnected
EndpointOwnerId	integer	No	ID akun tempat titik akhir berada.	25346073170691****
ResourceId	string	No	ID sumber daya layanan.	lb-hp32z1wp5peaoox2q****
ReplacedResourceId	string	No	ID sumber daya layanan yang diganti dalam migrasi lancar skenario sumber daya EPS.	lb-hp32z1wp5peaoox2q****
RegionId	string	Yes	ID kelompok sumber daya dari titik akhir yang akan dikueri.	rg-acfmy*****
ResourceGroupId	string	No	ID kelompok sumber daya tempat titik akhir berada.	rg-acfmy*****

Elemen respons

Element	Type	Description	Example
	object
Connections	array<object>	Informasi koneksi titik akhir.
	array<object>	Informasi koneksi titik akhir.
Zones	array<object>	Informasi zona.
	object	Informasi zona.
VSwitchId	string	vSwitch tempat titik akhir berada.	vsw-hp3uf6045ljdhd5zr****
ZoneId	string	ID zona.	cn-huhehaote-b
ResourceId	string	ID sumber daya layanan.	lb-hp32z1wp5peaoox2q****
EniId	string	ID antarmuka jaringan elastis (ENI) titik akhir.	eni-hp32lk0pyv6o94hs****
ZoneDomain	string	Nama domain zona.	ep-hp34jaz8ykl0exwt**-cn-huhehaote.epsrv-hp3vpx8yqxblby3i**.cn-huhehaote-b.privatelink.aliyuncs.com
ZoneStatus	string	Status zona. Nilai valid: Creating: sedang dibuat. Wait: menunggu koneksi. Connected: terhubung. Deleting: sedang dihapus. Disconnecting: sedang memutuskan koneksi. Disconnected: terputus. Connecting: sedang menghubungkan. Migrating: sedang dimigrasi. Migrated: dimigrasi.	Connected
ReplacedResourceId	string	ID sumber daya layanan yang diganti dalam migrasi lancar skenario sumber daya EPS.	lb-hp32z1wp5peaoox2q****
ReplacedEniId	string	ID pengontrol antarmuka jaringan (NIC) titik akhir yang diganti dalam migrasi lancar skenario sumber daya EPS.	eni-hp32lk0pyv6o94hs****
ModifiedTime	string	Waktu ketika koneksi dimodifikasi.	2021-09-28T10:34:46Z
Bandwidth	integer	Bandwidth koneksi titik akhir. Unit: Mbit/s.	3072
EndpointOwnerId	integer	ID akun tempat titik akhir berada.	25346073170691****
ResourceOwner	boolean	Apakah titik akhir dan layanan titik akhir berada pada akun yang sama. Nilai valid: true: ya. false: tidak.	true
ServiceId	string	ID layanan titik akhir.	epsrv-hp3vpx8yqxblby3i****
ConnectionStatus	string	Status koneksi titik akhir. Nilai valid: Pending: sedang dimodifikasi. Connecting: sedang menghubungkan. Connected: terhubung. Disconnecting: sedang memutuskan koneksi. Disconnected: terputus. Deleting: sedang dihapus. ServiceDeleted: layanan titik akhir terkait telah dihapus.	Disconnected
EndpointId	string	ID titik akhir.	ep-hp33b2e43fays7s8****
EndpointVpcId	string	VPC tempat titik akhir berada.	vpc-hp356stwkxg3fn2xe****
ResourceGroupId	string	ID kelompok sumber daya dari titik akhir.	rg-acfmw353z35v***
TrafficControlMode	string	Mode kontrol trafik. Nilai valid: Scalability: skalabilitas elastis otomatis. Dalam mode ini, bandwidth koneksi yang dikonfigurasi untuk koneksi titik akhir tidak berlaku. BandwidthLimit: batas atas bandwidth koneksi titik akhir. Batas atas bandwidth adalah nilai Bandwidth.	BandwidthLimit
EndpointRegionId	string	ID wilayah dari titik akhir.	cn-hangzhou
ServiceRegionId	string	ID wilayah dari layanan titik akhir.	cn-huhehaote
NextToken	string	Apakah ada token untuk kueri berikutnya. Nilai valid: Jika NextToken kosong, tidak ada kueri berikutnya. Jika NextToken dikembalikan, nilai tersebut menunjukkan token untuk kueri berikutnya.	caeba0bbb2be03f84eb48b699f0a4883
RequestId	string	ID permintaan.	0ED8D006-F706-4D23-88ED-E11ED28DCAC0
MaxResults	integer	Jumlah entri per halaman.	50
TotalCount	string	Jumlah total entri dalam daftar koneksi titik akhir.	1

Contoh

Respons sukses

JSONformat

{
  "Connections": [
    {
      "Zones": [
        {
          "VSwitchId": "vsw-hp3uf6045ljdhd5zr****",
          "ZoneId": "cn-huhehaote-b",
          "ResourceId": "lb-hp32z1wp5peaoox2q****",
          "EniId": "eni-hp32lk0pyv6o94hs****",
          "ZoneDomain": "ep-hp34jaz8ykl0exwt****-cn-huhehaote.epsrv-hp3vpx8yqxblby3i****.cn-huhehaote-b.privatelink.aliyuncs.com",
          "ZoneStatus": "Connected",
          "ReplacedResourceId": "lb-hp32z1wp5peaoox2q****",
          "ReplacedEniId": "eni-hp32lk0pyv6o94hs****"
        }
      ],
      "ModifiedTime": "2021-09-28T10:34:46Z",
      "Bandwidth": 3072,
      "EndpointOwnerId": 0,
      "ResourceOwner": true,
      "ServiceId": "epsrv-hp3vpx8yqxblby3i****",
      "ConnectionStatus": "Disconnected",
      "EndpointId": "ep-hp33b2e43fays7s8****",
      "EndpointVpcId": "vpc-hp356stwkxg3fn2xe****",
      "ResourceGroupId": "rg-acfmw353z35v***",
      "TrafficControlMode": "BandwidthLimit",
      "EndpointRegionId": "cn-hangzhou",
      "ServiceRegionId": "cn-huhehaote"
    }
  ],
  "NextToken": "caeba0bbb2be03f84eb48b699f0a4883",
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
  "MaxResults": 50,
  "TotalCount": "1"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	EndpointServiceNotFound	The specified Service does not exist.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.