Help Center/ ModelArts/ API Reference/ Model Inference/ Private Network Connections/ This API is used to query the private network connection approval list.
Updated on 2026-07-24 GMT+08:00

This API is used to query the private network connection approval list.

Function

This API is used to query all private network connection approval records. It is applicable to scenarios where the private network connection approval status needs to be managed and monitored. Before calling this API, ensure that you have the corresponding query permission. The returned list contains the basic information about each private network connection approval, such as the approval ID, application time, status (such as pending approval, approved, and rejected), requester information, and region ID. If the current tenant has no private network connection approval record, an empty list is returned. If the permission is insufficient or other system errors occur when the API is called, an error is reported, prompting you to check the permission or contact technical support.

Debugging

You can debug this API through automatic authentication in API Explorer or use the SDK sample code generated by API Explorer.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

  • If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
  • If you are using identity policy-based authorization, the following identity policy-based permissions are required.

    Action

    Access Level

    Resource Type (*: required)

    Condition Key

    Alias

    Dependencies

    modelarts::listIntranetConnection

    List

    -

    -

    modelarts:intranetConnection:list

    -

URI

GET /v2/{project_id}/intranet-connection/reviews

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Definition

Project ID.

Constraints

N/A

Range

N/A

Default Value

N/A

Table 2 Query Parameters

Parameter

Mandatory

Type

Description

scene

No

String

Definition

Private network connection scenario.

Constraints

N/A

Range

  • POOL: User resource pool access

  • VPC: User VPC network access

Default Value

N/A

id

No

String

Definition

Private network connection ID.

Constraints

N/A

Range

N/A

Default Value

N/A

applicant_domain_id

No

String

Definition

Domain ID of the requester.

Constraints

N/A

Range

N/A

Default Value

N/A

service_id

No

String

Definition

Service ID.

Constraints

N/A

Range

N/A

Default Value

N/A

applicant_user_name

No

String

Definition

Username of the requestor.

Constraints

N/A

Range

N/A

Default Value

N/A

service_name

No

String

Definition

Service name.

Constraints

N/A

Range

N/A

Default Value

N/A

vpc_name

No

String

Definition

VPC name.

Constraints

N/A

Range

N/A

Default Value

N/A

vpc_id

No

String

Definition

VPC ID.

Constraints

N/A

Range

N/A

Default Value

N/A

pool_id

No

String

Definition

Resource pool ID.

Constraints

N/A

Range

N/A

Default Value

N/A

sort_key

No

String

Definition

Sorting field. The value can be update_at or create_at. The default value is update_at.

Constraints

N/A

Range

  • update_at: sorting by update time

  • create_at: sorting by creation time

Default Value

update_at

limit

No

Integer

Definition

Maximum number of records that can be returned.

Constraints

N/A

Range

[1,500]

Default Value

10

offset

No

Integer

Definition

Offset of the pagination list query.

Constraints

The value must be an integral multiple of limit.

Range

N/A

Default Value

0

status

No

String

Definition

Request status.

Constraints

N/A

Range

N/A

Default Value

N/A

type

No

String

Definition

Private network request type.

Constraints

N/A

Range

N/A

Default Value

N/A

Request Parameters

Table 3 Request header parameters

Parameter

Mandatory

Type

Description

x-auth-token

Yes

String

Definition

User token. It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is the user token. For details about how to obtain the token, see Obtaining a User Token Through Password Authentication.

Constraints

N/A

Range

N/A

Default Value

N/A

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

current

Integer

Definition

Current page number.

Range

N/A

pages

Integer

Definition

Total number of pages.

Range

N/A

size

Integer

Definition

Page size.

Range

N/A

total

Integer

Definition

Total number of records.

Range

N/A

data

Array of IntranetConnectionInfo objects

Definition

Request information list.

Table 5 IntranetConnectionInfo

Parameter

Type

Description

applicant_user_name

String

Definition

Username of the requestor.

Range

N/A

id

String

Definition

Private network connection ID.

Range

N/A

message

String

Definition

Request description.

Range

N/A

owner_domain_name

String

Definition

Domain name of the reviewer.

Range

N/A

scene

String

Definition

Private network connection scenario.

Constraints

N/A

Range

  • POOL: User resource pool access

  • VPC: User VPC connection

Default Value

N/A

service_id

String

Definition

Service ID.

Range

N/A

service_name

String

Definition

Service name.

Range

N/A

status

String

Definition

Private network connection status, which can be queried in the list.

Constraints

N/A

Range

  • APPROVING

  • REJECTED

  • CONNECTING

  • CONNECTED

  • CANCELED

  • FAILED

  • DELETING

Default Value

N/A

subnet_id

String

Definition

Subnet ID.

Range

N/A

url_list

Array of strings

Definition

Access address list.

custom_url_list

Array of strings

Definition

Access address list.

vpc_id

String

Definition

VPC ID.

Range

N/A

dispatcher_group_id

String

Definition

ID of the dispatcher group bound to the service.

Range

N/A

type

String

Definition

Access granularity. The options are SERVICE and GLOBAL.

Range

N/A

maos_network_name

String

Definition

Resource pool network name.

Range

N/A

service_type

String

Definition

Service type.

Range

N/A

pool_id

String

Definition

Resource pool ID.

Range

N/A

create_at

String

Definition

Creation time.

Range

N/A

update_at

String

Definition

Modification time.

Range

N/A

Example Requests

This API is used to query the private network connection approval list of the current tenant.

https://{endpoint}/v2/{project_id}/intranet-connection/reviews

Example Responses

Status code: 200

Private network access approval list.

{
  "current" : 0,
  "data" : [ {
    "applicant_user_name" : "user_name***example",
    "create_at" : 1745245018845,
    "id" : "1d7812a3-0032-4f7a-bf31-878****example",
    "owner_domain_name" : "domain_name***example",
    "scene" : "VPC",
    "service_id" : "58865106-c6c6-427a-9e0b-1c****example",
    "service_name" : "service_name***example",
    "status" : "APPROVING",
    "subnet_id" : "f4f58570-0f91-43c6-9981-8f19****example",
    "update_at" : 1745245455478,
    "vpc_id" : "ea697f73-ffc8-40bc-a11f-e8a6****example"
  }, {
    "applicant_user_name" : "user_name***example",
    "create_at" : 1745307967369,
    "id" : "6ff637dc-30ee-4e85-ab75-0b46ec****example",
    "owner_domain_name" : "domain_name***example",
    "scene" : "VPC",
    "service_id" : "58865106-c6c6-427a-9e0b-1c****example",
    "service_name" : "service_name***example",
    "status" : "APPROVING",
    "subnet_id" : "cf47bd54-0676-4367-b99e-4876****example",
    "update_at" : 1745307967369,
    "vpc_id" : "3e2a8f0f-f61e-4ad8-b6ce-d97****example"
  } ],
  "pages" : 1,
  "size" : 10,
  "total" : 2
}

Status Codes

Status Code

Description

200

Private network access approval list.

Error Codes

See Error Codes.