All Products
Search

This Product

    Identity as a Service:ListNetworkAccessEndpoints

    Document Center

    Identity as a Service:ListNetworkAccessEndpoints

    Last Updated:Jun 10, 2026

    Mencantumkan titik akhir jaringan untuk instans IDaaS EIAM.

    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

    eiam:ListNetworkAccessEndpoints

    get

    *NetworkAccessEndpoint

    acs:eiam:{#regionId}:{#accountId}:instance/{#InstanceId}/networkaccessendpoint/*

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    InstanceId

    string

    Yes

    ID instans.

    idaas_ue2jvisn35ea5lmthk267xxxxx
    NextToken

    string

    No

    Token yang digunakan untuk kueri berikutnya. Atur parameter ini ke nilai NextToken yang dikembalikan dari panggilan API sebelumnya. Biarkan parameter ini kosong untuk kueri pertama.

    NTxxxxxexample
    MaxResults

    integer

    No

    Jumlah entri yang dikembalikan pada setiap halaman. Nilai maksimum adalah 100.

    20
    NetworkAccessEndpointType

    string

    No

    Tipe titik akhir jaringan. Nilai valid:

    • shared: titik akhir jaringan bersama.

    • private: titik akhir jaringan pribadi.

    Nilai default adalah private.

    private
    VpcId

    string

    No

    ID VPC tempat titik akhir jaringan pribadi terhubung. Parameter ini tidak berlaku ketika NetworkAccessEndpointType diatur ke shared.

    vpc-examplexxx
    VpcRegionId

    string

    No

    ID wilayah VPC tempat titik akhir jaringan pribadi terhubung. Nilai parameter ini harus berupa wilayah yang dikembalikan oleh operasi ListNetworkAccessEndpointAvailableRegions. Parameter ini tidak berlaku ketika NetworkAccessEndpointType diatur ke shared.

    cn-hangzhou
    NetworkAccessEndpointStatus

    string

    No

    Status titik akhir jaringan. Nilai valid:

    • pending: Titik akhir menunggu inisialisasi.

    • creating: Titik akhir sedang dibuat.

    • running: Titik akhir sedang berjalan.

    • deleting: Titik akhir sedang dihapus.

    Parameter ini tidak berlaku ketika NetworkAccessEndpointType diatur ke shared.

    running

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    The request ID.

    0441BD79-92F3-53AA-8657-F8CE4A2B912A
    TotalCount

    integer

    The total number of entries.

    100
    NextToken

    string

    The token returned for the next query.

    NTxxxexample
    NetworkAccessEndpoints

    array<object>

    A collection of network endpoints.

    object

    The network endpoint information.

    InstanceId

    string

    The instance ID.

    idaas_ue2jvisn35ea5lmthk267xxxxx
    NetworkAccessEndpointId

    string

    The network endpoint ID.

    nae_examplexxx
    NetworkAccessEndpointName

    string

    The name of the network endpoint.

    VPC access endpoint for xx service
    VpcId

    string

    The ID of the VPC to which the private network endpoint is connected.

    vpc-examplexxx
    VpcRegionId

    string

    The region ID of the VPC to which the private network endpoint is connected.

    cn-hangzhou
    VSwitchIds

    array

    A list of vSwitches to which the private network endpoint is connected.

    vsw-examplexxx

    string

    The vSwitch ID.

    vsw-2vc8z0f90z4k6xxxxx
    SecurityGroupId

    string

    The ID of the security group used by the private network endpoint.

    sg-examplexxx
    Status

    string

    The status of the network endpoint. Valid values:

    • pending: The endpoint is pending initialization.

    • creating: The endpoint is being created.

    • running: The endpoint is running.

    • deleting: The endpoint is being deleted.

    running
    NetworkAccessEndpointType

    string

    The type of the network endpoint. Valid values:

    • shared: a shared network endpoint.

    • private: a private network endpoint.

    private
    CreateTime

    integer

    The time when the network endpoint was created. This value is a UNIX timestamp. Unit: milliseconds.

    1649830226000
    UpdateTime

    integer

    The time when the network endpoint was last updated. This value is a UNIX timestamp. Unit: milliseconds.

    1649830226000

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "0441BD79-92F3-53AA-8657-F8CE4A2B912A",
  "TotalCount": 100,
  "NextToken": "NTxxxexample",
  "NetworkAccessEndpoints": [
    {
      "InstanceId": "idaas_ue2jvisn35ea5lmthk267xxxxx",
      "NetworkAccessEndpointId": "nae_examplexxx",
      "NetworkAccessEndpointName": "VPC access endpoint for xx service",
      "VpcId": "vpc-examplexxx",
      "VpcRegionId": "cn-hangzhou",
      "VSwitchIds": [
        "vsw-2vc8z0f90z4k6xxxxx"
      ],
      "SecurityGroupId": "sg-examplexxx",
      "Status": "running",
      "NetworkAccessEndpointType": "private",
      "CreateTime": 1649830226000,
      "UpdateTime": 1649830226000
    }
  ]
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.