Gunakan API ListVpcEndpointServices untuk mengkueri layanan endpoint - PrivateLink - Alibaba Cloud - PrivateLink

Panggil operasi ListVpcEndpointServices untuk mengkueri layanan endpoint yang dimiliki oleh akun Anda.

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

get

*VpcEndpointService

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID region tempat layanan endpoint di-deploy. Panggil operasi DescribeRegions untuk memperoleh ID region.	cn-huhehaote
NextToken	string	No	Token paginasi untuk kueri berikutnya. Nilai yang valid: Kosongkan parameter ini untuk kueri pertama atau ketika tidak ada hasil lebih lanjut. Jika kueri lain diperlukan, atur parameter ini ke nilai NextToken yang dikembalikan pada panggilan API sebelumnya.	FFmyTO70tTpLG6I3FmYAXGKPd****
MaxResults	integer	No	Jumlah entri yang dikembalikan per halaman. Nilai yang valid: 1 hingga 1000. Nilai default: 50.	50
ServiceId	string	No	ID layanan endpoint.	epsrv-hp3vpx8yqxblby3i****
ServiceName	string	No	Nama layanan endpoint.	com.aliyuncs.privatelink.cn-huhehaote.epsrv-hp3vpx8yqxblby3i****
ResourceId	string	No	ID sumber daya layanan.	lb-hp32z1wp5peaoox2q****
ServiceResourceType	string	No	Tipe sumber daya layanan. Nilai yang valid: slb: Sumber daya layanan adalah instans Classic Load Balancer (CLB). alb: Sumber daya layanan adalah instans Application Load Balancer (ALB). nlb: Sumber daya layanan adalah instans Network Load Balancer (NLB). gwlb: Sumber daya layanan adalah instans Gateway Load Balancer (GWLB).	slb
AutoAcceptEnabled	boolean	No	Menentukan apakah koneksi endpoint diterima secara otomatis. Nilai yang valid: true: Menerima koneksi endpoint secara otomatis. false: Tidak menerima koneksi endpoint secara otomatis.	false
ServiceStatus	string	No	Status layanan endpoint. Nilai yang valid: Creating: Layanan endpoint sedang dibuat. Pending: Layanan endpoint sedang dimodifikasi. Active: Layanan endpoint tersedia. Deleting: Layanan endpoint sedang dihapus.	Active
ServiceBusinessStatus	string	No	Status bisnis layanan endpoint. Nilai yang valid: Normal: Layanan endpoint berjalan sesuai harapan. FinancialLocked: Layanan endpoint terkunci karena pembayaran yang telah jatuh tempo.	Normal
ZoneAffinityEnabled	boolean	No	Menentukan apakah afinitas zona diaktifkan untuk resolusi nama domain. Nilai yang valid: true: Ya. false: Tidak.	true
RegionId	string	Yes	ID region tempat layanan endpoint di-deploy. Panggil operasi DescribeRegions untuk memperoleh ID region.	cn-huhehaote
Tag	array<object>	No	Daftar tag.
	object	No	Tag.
Key	string	No	Kunci tag dari instans. Anda dapat menentukan hingga 20 kunci tag. Kunci tidak boleh berupa string kosong. Kunci dapat berukuran hingga 64 karakter dan tidak boleh diawali dengan `aliyun` atau `acs:`. Kunci tidak boleh mengandung `http://` atau `https://`.	FinanceDept
Value	string	No	Nilai tag dari instans. Anda dapat menentukan hingga 20 nilai tag. Nilai boleh berupa string kosong. Nilai dapat berukuran hingga 128 karakter dan tidak boleh diawali dengan `aliyun` atau `acs:`. Nilai tidak boleh mengandung `http://` atau `https://`.	FinanceJoshua
ResourceGroupId	string	No	ID grup sumber daya.	rg-acfmy*****
AddressIpVersion	string	No	Versi alamat IP. Nilai yang valid: IPv4: Tipe IPv4. DualStack: Tipe dual-stack.	IPv4

Elemen respons

Element	Type	Description	Example
	object
Services	array<object>	Koleksi layanan endpoint.
	array<object>	Koleksi layanan endpoint.
AutoAcceptEnabled	boolean	Menentukan apakah koneksi endpoint diterima secara otomatis. Nilai yang valid: true: Menerima koneksi endpoint secara otomatis. false: Tidak menerima koneksi endpoint secara otomatis.	true
ServiceId	string	ID layanan endpoint.	epsrv-hp3vpx8yqxblby3i****
CreateTime	string	Waktu ketika layanan endpoint dibuat.	2021-09-24T17:15:10Z
MinBandwidth	integer	Bandwidth minimum dari koneksi endpoint. Satuan: Mbps.	100
MaxBandwidth	integer	Bandwidth maksimum dari koneksi endpoint. Satuan: Mbps.	1024
ServiceStatus	string	Status layanan endpoint. Nilai yang valid: Creating: Layanan endpoint sedang dibuat. Pending: Layanan endpoint sedang dimodifikasi. Active: Layanan endpoint tersedia. Deleting: Layanan endpoint sedang dihapus.	Active
ZoneAffinityEnabled	boolean	Menentukan apakah afinitas zona diaktifkan. Nilai yang valid: true: Ya. false: Tidak.	true
RegionId	string	Region tempat layanan endpoint di-deploy.	cn-huhehaote
ServiceDomain	string	Nama domain layanan endpoint.	epsrv-hp3vpx8yqxblby3i****.cn-huhehaote.privatelink.aliyuncs.com
Payer	string	Pihak pembayar. Nilai yang valid: Endpoint: konsumen layanan. EndpointService: penyedia layanan.	Endpoint
ServiceBusinessStatus	string	Status bisnis layanan endpoint. Nilai yang valid: Normal: Layanan endpoint berjalan sesuai harapan. FinancialLocked: Layanan endpoint terkunci karena pembayaran yang telah jatuh tempo.	Normal
ConnectBandwidth	integer	Bandwidth maksimum default. Satuan: Mbps.	1024
ServiceName	string	Nama layanan endpoint.	com.aliyuncs.privatelink.cn-huhehaote.epsrv-hp3vpx8yqxblby3i****
ServiceDescription	string	Deskripsi layanan endpoint.	This is my EndpointService.
ServiceResourceType	string	Tipe sumber daya layanan. Nilai yang valid: slb: Sumber daya layanan adalah instans CLB. alb: Sumber daya layanan adalah instans ALB. nlb: Sumber daya layanan adalah instans NLB. gwlb: Sumber daya layanan adalah instans GWLB.	slb
ServiceType	string	Tipe layanan endpoint. Nilai yang valid: Interface: endpoint antarmuka (interface endpoint). Anda dapat menambahkan instans CLB, ALB, dan NLB sebagai sumber daya layanan. GatewayLoadBalancer: endpoint Gateway Load Balancer. Anda dapat menambahkan instans GWLB sebagai sumber daya layanan.	Interface
ServiceSupportIPv6 `deprecated`	boolean	Menunjukkan apakah layanan endpoint mendukung IPv6. Nilai yang valid: true: Ya. false: Tidak.	false
Tags	array<object>	Daftar tag.
	object	Daftar tag.
Key	string	The key of the tag.	FinanceDept
Value	string	The value of the tag.	FinanceJoshua
ResourceGroupId	string	ID grup sumber daya.	rg-acfmy*****
AddressIpVersion	string	Versi alamat IP. Nilai yang valid: IPv4: Tipe IPv4. DualStack: Tipe dual-stack.	IPv4
SupportedRegionSet	array<object>	Daftar region yang didukung oleh layanan endpoint. Konsumen layanan dapat menginisiasi koneksi endpoint dari region-region ini.
	object
ServiceRegionId `deprecated`	string
RegionServiceStatus	string	The status of the endpoint service in the supported region. Valid values: Pending: The service is being modified. Available: The service is available. Deleting: The service is being deleted. Failed: The service failed to be deployed in the region. Closed: The service is closed.	Available
RegionBusinessStatus	string	The business status of the endpoint service in the supported region. Valid values: Normal: The service is running as expected. FinancialLocked: The service is financially locked.	Normal
SupportedRegionId	string	The ID of the supported region.	cn-hangzhou
NextToken	string	Token paginasi untuk kueri berikutnya. Nilai yang valid: Jika NextToken kosong, tidak ada hasil lebih lanjut. Jika NextToken memiliki nilai, gunakan sebagai token awal untuk kueri berikutnya.	FFmyTO70tTpLG6I3FmYAXGKPd****
RequestId	string	ID permintaan.	0ED8D006-F706-4D23-88ED-E11ED28DCAC0
MaxResults	integer	Jumlah entri yang dikembalikan per halaman.	50
TotalCount	integer	Jumlah total record.	12

Contoh

Respons sukses

JSONformat

{
  "Services": [
    {
      "AutoAcceptEnabled": true,
      "ServiceId": "epsrv-hp3vpx8yqxblby3i****",
      "CreateTime": "2021-09-24T17:15:10Z",
      "MinBandwidth": 100,
      "MaxBandwidth": 1024,
      "ServiceStatus": "Active",
      "ZoneAffinityEnabled": true,
      "RegionId": "cn-huhehaote",
      "ServiceDomain": "epsrv-hp3vpx8yqxblby3i****.cn-huhehaote.privatelink.aliyuncs.com",
      "Payer": "Endpoint",
      "ServiceBusinessStatus": "Normal",
      "ConnectBandwidth": 1024,
      "ServiceName": "com.aliyuncs.privatelink.cn-huhehaote.epsrv-hp3vpx8yqxblby3i****",
      "ServiceDescription": "This is my EndpointService.",
      "ServiceResourceType": "slb",
      "ServiceType": "Interface",
      "ServiceSupportIPv6": false,
      "Tags": [
        {
          "Key": "FinanceDept",
          "Value": "FinanceJoshua"
        }
      ],
      "ResourceGroupId": "rg-acfmy*****",
      "AddressIpVersion": "IPv4",
      "SupportedRegionSet": [
        {
          "ServiceRegionId": "",
          "RegionServiceStatus": "Available",
          "RegionBusinessStatus": "Normal",
          "SupportedRegionId": "cn-hangzhou"
        }
      ]
    }
  ],
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
  "MaxResults": 50,
  "TotalCount": 12
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.