Help Center/ ModelArts/ API Reference/ Model Inference/ Private Network Connections/ Batch Deleting Private Network Connections
Updated on 2026-07-24 GMT+08:00

Batch Deleting Private Network Connections

Function

This API is used to delete specified intranet access points in batches. It is applicable to the scenario where multiple private network access points that are no longer used need to be deleted. Before calling this API, ensure that you have the deletion permission and provide a valid private network access point ID list. After the deletion is successful, the specified private network access point is removed completely and does not take effect for any service. If the private network access point ID list contains invalid or deleted IDs, an error message is displayed, prompting you to check the validity of the IDs. Additionally, if the permission is insufficient or other system errors occur when the API is called, error information is returned to prompt the user 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::deleteIntranetConnection

    Write

    -

    -

    modelarts:intranetConnection:delete

    -

URI

POST /v2/{project_id}/intranet-connection/delete

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

Request Parameters

Table 2 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

Table 3 Request body parameters

Parameter

Mandatory

Type

Description

intranet_connection_ids

Yes

Array of strings

Private network connection ID list.

Response Parameters

Status code: 204

The deletion is successful.

None

Example Requests

POST https://{endpoint}/v2/{project_id}/intranet-connection/delete

{
  "intranet_connection_ids" : [ "a6ea6bfc-a52f-44fb-81b1-****example", "cfe5caf2-147a-4d07-b843-****example" ]
}

Example Responses

None

Status Codes

Status Code

Description

204

The deletion is successful.

Error Codes

See Error Codes.