Deleting a Shared Connection

Function

This API is used to delete a shared connection.

Authorization Information

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

If you are using role/policy-based authorization, see the required permissions in Permissions Policies and Supported Actions.

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	Dependency
das:connection:cancelShareConnections	Write	Connection	-	-	-

URI

DELETE /v3/{project_id}/connections/share

**Table 1** URI parameter
Parameter	Mandatory	Type	Description
project_id	Yes	String	Explanation: Project ID of a tenant in a region. To obtain this value, see Obtaining a Project ID. Constraints: N/A Values: The value can contain 32 characters, including only letters and digits. Default value: N/A

Request Parameters

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
shared_conn_id	Yes	String	Explanation: ID of a shared connection established between a database account and the database. The database user ID is created using the API in Creating an Instance Connection. Constraints: N/A Values: The value is a UUID containing 36 characters. Only letters, digits, and hyphens (-) are allowed. Default value: N/A
users	Yes	Array of ShareConnUserInfo objects	Explanation: User Constraints: Multiple values need to be separated by commas (,). Values: N/A Default value: N/A

**Table 3** ShareConnUserInfo
Parameter	Mandatory	Type	Description
user_id	Yes	String	Explanation: User ID Constraints: N/A Values: N/A Default value: N/A
user_name	Yes	String	Explanation: Username Constraints: N/A Values: N/A Default value: N/A

Response Parameters

Status code: 200

None

Example Request

Deleting a shared link

DELETE https://{{endpoint}}/v3/{{project_id}}/connections/share 
{ 
  "users" : [ { 
    "user_id" : "0852a89ae180d5401f5ac00271a4a02e", 
    "user_name" : "username1" 
  }, { 
    "user_id" : "07da4af00180d5651f49c00200b352b5", 
    "user_name" : "username2" 
  } ], 
  "shared_conn_id" : "ee64e597-4f25-486f-bba1-0c850b3b59d6" 
}