All Products
Search
Document Center

Virtual Private Cloud:ListVpcGatewayEndpoints

Last Updated:Jun 12, 2026

Memanggil operasi ListVpcGatewayEndpoints untuk mengkueri daftar titik akhir gerbang VPC yang telah dibuat.

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

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter

Type

Required

Description

Example

EndpointId

string

No

ID instans titik akhir gerbang.

vpce-bp1i1212ss2whuwyw****

EndpointName

string

No

Nama titik akhir gerbang.

Panjang nama harus 1 hingga 128 karakter.

test

ServiceName

string

No

Nama layanan titik akhir.

com.aliyun.cn-hangzhou.oss

NextToken

string

No

Apakah token kueri berikutnya tersedia. Nilai valid:

  • Kosongkan parameter ini untuk kueri pertama atau ketika tidak ada hasil lagi yang tersedia.

  • Jika kueri berikutnya tersedia, atur parameter ini ke nilai NextToken yang dikembalikan dalam panggilan API sebelumnya.

FFmyTO70tTpLG6I3FmYAXGKPd****

MaxResults

integer

No

Jumlah entri per halaman untuk kueri berhalaman. Nilai valid: 1 hingga 100. Nilai default: 20.

20

RegionId

string

Yes

ID wilayah titik akhir gerbang yang ingin Anda kueri.

Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.

cn-hangzhou

ResourceGroupId

string

No

ID kelompok sumber daya tempat titik akhir gerbang berada.

rg-acfmxvfvazb4p****

Tags

array<object>

No

Daftar tag.

object

No

Daftar tag.

Key

string

No

Kunci tag Sumber daya. Anda dapat menentukan hingga 20 kunci tag. Kunci tag tidak boleh berupa string kosong.

Panjang kunci tag dapat mencapai 128 karakter. Tidak boleh diawali dengan aliyun atau acs:, dan tidak boleh mengandung http:// atau https://.

FinanceDept

Value

string

No

Nilai tag Sumber daya. Anda dapat menentukan hingga 20 nilai tag. Nilai tag dapat berupa string kosong.

Panjang nilai tag dapat mencapai 128 karakter. Tidak boleh diawali dengan aliyun atau acs:, dan tidak boleh mengandung http:// atau https://.

FinanceJoshua

VpcId

string

No

ID VPC tempat titik akhir gerbang berada.

vpc-bp1gsk7h12ew7oegk****

Elemen respons

Element

Type

Description

Example

object

ID permintaan.

RequestId

string

ID permintaan.

0AB1129F-32C1-5E4D-9E22-E4A859CA46EB

NextToken

string

Apakah token kueri berikutnya tersedia. Nilai valid:

  • Jika NextToken kosong, tidak ada hasil lagi yang tersedia.

  • Jika NextToken dikembalikan, nilai tersebut menunjukkan token untuk kueri berikutnya.

FFmyTO70tTpLG6I3FmYAXGKPd****

TotalCount

integer

Jumlah total entri yang dikembalikan.

10

Endpoints

array<object>

Daftar titik akhir gerbang.

array<object>

Daftar titik akhir gerbang.

EndpointId

string

ID instans titik akhir gerbang.

vpce-bp1i1212ss2whuwyw****

EndpointName

string

Nama titik akhir gerbang.

test

EndpointDescription

string

Deskripsi titik akhir gerbang.

test_description

ServiceName

string

Nama layanan titik akhir.

com.aliyun.cn-hangzhou.oss

VpcId

string

ID VPC tempat titik akhir gerbang berada.

vpc-bp1gsk7h12ew7oegk****

PolicyDocument

string

Kebijakan akses untuk layanan cloud.

Untuk informasi lebih lanjut mengenai sintaks dan struktur kebijakan akses, lihat Struktur dan sintaks kebijakan.

{\n \"Version\": \"1\",\n \"Statement\": [\n {\n \"Effect\": \"Allow\",\n \"Action\": \"*\",\n \"Principal\": \"*\",\n \"Resource\": \"*\"\n }\n ]\n}

CreationTime

string

Pengatur waktu ketika titik akhir gerbang dibuat. Pengatur waktu ditampilkan dalam UTC dengan format YYYY-MM-DDThh:mm:ssZ.

2021-09-08T08:43:04Z

EndpointStatus

string

Status titik akhir gerbang. Nilai valid:

  • Creating: sedang dibuat.

  • Created: telah dibuat dan dalam keadaan Normal.

  • Modifying: sedang dimodifikasi.

  • Associating: sedang dikaitkan.

  • Dissociating: sedang dilepaskan kaitannya.

  • Deleting: sedang dihapus.

Created

AssociatedRouteTables

array

ID tabel entri rute yang dikaitkan dengan titik akhir gerbang.

string

ID tabel entri rute yang dikaitkan dengan titik akhir gerbang.

vtb-bp1sme72jnuodvyx7****

ResourceGroupId

string

ID kelompok sumber daya tempat titik akhir gerbang berada.

rg-acfmxvfvazb4p****

Tags

array<object>

Daftar tag.

object

Daftar tag.

Key

string

The key of tag N added to the resource.

FinanceDept

Value

string

The value of tag N added to the resource.

FinanceJoshua

MaxResults

integer

Jumlah entri per halaman untuk kueri berhalaman.

20

Contoh

Respons sukses

JSONformat

{
  "RequestId": "0AB1129F-32C1-5E4D-9E22-E4A859CA46EB",
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "TotalCount": 10,
  "Endpoints": [
    {
      "EndpointId": "vpce-bp1i1212ss2whuwyw****",
      "EndpointName": "test",
      "EndpointDescription": "test_description",
      "ServiceName": "com.aliyun.cn-hangzhou.oss",
      "VpcId": "vpc-bp1gsk7h12ew7oegk****",
      "PolicyDocument": "{\\n  \\\"Version\\\": \\\"1\\\",\\n  \\\"Statement\\\": [\\n    {\\n      \\\"Effect\\\": \\\"Allow\\\",\\n      \\\"Action\\\": \\\"*\\\",\\n      \\\"Principal\\\": \\\"*\\\",\\n      \\\"Resource\\\": \\\"*\\\"\\n    }\\n  ]\\n}",
      "CreationTime": "2021-09-08T08:43:04Z",
      "EndpointStatus": "Created",
      "AssociatedRouteTables": [
        "vtb-bp1sme72jnuodvyx7****"
      ],
      "ResourceGroupId": "rg-acfmxvfvazb4p****",
      "Tags": [
        {
          "Key": "FinanceDept",
          "Value": "FinanceJoshua"
        }
      ]
    }
  ],
  "MaxResults": 20
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 IllegalParam.NextToken The specified NextToken is invalid.
400 IllegalParam.MaxResults The param of MaxResults is illegal.
400 InvalidVpcId.NotFound Specified value of VpcId is not found in our record.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.