Delete a connection
delete
/api/20210901/catalog/connections/{connectionId}
Remove a connection from an Analytics instance.
Request
Path Parameters
-
connectionId(required): string(byte)
The ID of the connection with Base64 encoding. For example, if your connection has the object ID 'user'.'connId', enter the Base64 encoded value, J3VzZXInLidjb25uSWQn
There's no request body for this operation.
Back to TopResponse
200 Response
Successful operation.
401 Response
Unauthorized (missing or expired credentials, and so on).
Root Schema : Error
Type:
Show Source
object
-
code(required): string
Short error code that defines the error, meant for programmatic parsing.
-
message(required): string
Human-readable error string.
403 Response
Forbidden (missing permissions for operation, request denied for unspecified reason, and so on).
Root Schema : Error
Type:
Show Source
object
-
code(required): string
Short error code that defines the error, meant for programmatic parsing.
-
message(required): string
Human-readable error string.
404 Response
Not Found. The requested resource was not found.
Root Schema : Error
Type:
Show Source
object
-
code(required): string
Short error code that defines the error, meant for programmatic parsing.
-
message(required): string
Human-readable error string.
500 Response
Internal Server Error. The server encountered an unexpected condition
preventing fulfilment of the request.
Root Schema : Error
Type:
Show Source
object
-
code(required): string
Short error code that defines the error, meant for programmatic parsing.
-
message(required): string
Human-readable error string.
Examples
In this example, you delete a connection to Oracle Autonomous Data Warehouse (ADW) that you no longer want called oracle_adw_walletless
. The object ID of the connection is 'admin'.'oracle_adw_walletless'
, which has the Base64 encoded connectionId
value J2FkbWluJy4nb3JhY2xlX2Fkd193YWxsZXRsZXNzJw==
.
cURL Example
First, obtain the object ID of the connection you want to delete and Base64 encode the value to determine the connectionId
. You can obtain the Object ID value from the Inspect Connection dialog in Oracle Analytics Cloud.
Run the cURL command with the connectionId
:
curl -i \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --request DELETE 'https://<hostname>/api/20210901/catalog/connections/J2FkbWluJy4nb3JhY2xlX2Fkd193YWxsZXRsZXNzJw=='
Example of Response Header
Not applicable.
Example of Response Body
Not applicable.