Querying Private Network Connection Requests

Function

This API is used to query all private network connection request records. It is applicable to scenarios where the private network connection request 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 request, such as the application ID, creation time, status, and region ID. If the current tenant has no private network connection request 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

-

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
modelarts::listIntranetConnection	List	-	-	modelarts:intranetConnection:list	-

URI

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

**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
status	No	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
id	No	String	Definition Private network connection ID. 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
service_name	No	String	Definition Service name. Constraints N/A Range N/A Default Value N/A
vpc_id	No	String	Definition ID of the VPC network. Constraints N/A Range N/A Default Value N/A
vpc_name	No	String	Definition Name of the VPC network. 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
offset	No	Integer	Definition: Offset of pagination list query. Constraints: The value of offset must be an integral multiple of limit. Range: N/A Default Value: 0
limit	No	Integer	Definition Maximum number of records that can be returned. Constraints N/A Range [1,500] Default Value 10.
workspace_id	No	String	Definition Workspace ID. Constraints N/A Range N/A Default Value N/A
sort_dir	No	String	Definition Sorting mode. Constraints N/A Range ASC: ascending order DESC: descending order Default Value DESC
sort_key	No	String	Definition Sorting field. Separate multiple fields with commas (,). The value can be create_at or update_at. The default value is update_at. Constraints N/A Range create_at: sorting by creation time update_at: sorting by update time Default Value update_at

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 request list of the current tenant.

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

Example Responses

Status code: 200

Content access request list.

{
  "current" : 0,
  "data" : [ {
    "applicant_user_name" : "user_name****example",
    "create_at" : 1753156304363,
    "dispatcher_group_id" : "ca29ce14-b475-4bee-93****example",
    "id" : "566149dd-d0ce-43e6-9f2d-57608a36de80",
    "owner_domain_name" : "domain_name****example",
    "scene" : "VPC",
    "service_id" : "e78773fa-4b27-446e-801d-42c****example",
    "service_name" : "service-ll-722-10",
    "status" : "CONNECTED",
    "subnet_id" : "339e64b8-ec66-4a08-b710-c51****example",
    "type" : "SERVICE",
    "update_at" : 1753156315023,
    "url_list" : [ "https://100.**.**.**/v2/infer/e78773fa-4b27-446e-****example" ],
    "vpc_id" : "15e04c58-45df-44ee-8b5c-****example"
  } ],
  "pages" : 15,
  "size" : 1,
  "total" : 15
}