Oracle Analytics ServerのためのREST API

接続の削除

delete

/api/20210901/catalog/connections/{connectionId}

分析インスタンスから接続を削除します。

リクエスト

パス・パラメータ

connectionId(必須): string(byte)

Base64エンコーディングを使用した接続のID。たとえば、接続にオブジェクトID 'user'.'connId'がある場合、Base64でエンコードされた値J3VzZXInLidjb25uSWQnを入力します

この操作にはリクエスト本文はありません。

先頭に戻る

レスポンス

200レスポンス

成功した操作。

401レスポンス

未承認(資格情報の欠落や期限切れなど)。

ルート・スキーマ: Error

Type: object

ソースを表示

code(必須): string

プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
message(必須): string

判読可能なエラー文字列。

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Short error code that defines the error, meant for programmatic parsing.\n"
        },
        "message":{
            "type":"string",
            "description":"Human-readable error string.\n"
        }
    },
    "required":[
        "code",
        "message"
    ]
}

403レスポンス

禁止(操作の権限がない、不明な理由によりリクエストが拒否されたなど)。

ルート・スキーマ: Error

Type: object

ソースを表示

code(必須): string

プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
message(必須): string

判読可能なエラー文字列。

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Short error code that defines the error, meant for programmatic parsing.\n"
        },
        "message":{
            "type":"string",
            "description":"Human-readable error string.\n"
        }
    },
    "required":[
        "code",
        "message"
    ]
}

404レスポンス

見つかりません。リクエストされたリソースが見つかりませんでした。

ルート・スキーマ: Error

Type: object

ソースを表示

code(必須): string

プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
message(必須): string

判読可能なエラー文字列。

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Short error code that defines the error, meant for programmatic parsing.\n"
        },
        "message":{
            "type":"string",
            "description":"Human-readable error string.\n"
        }
    },
    "required":[
        "code",
        "message"
    ]
}

500レスポンス

内部サーバー・エラー。サーバーで、リクエストの履行を妨げる予期しない状況が発生しました。

ルート・スキーマ: Error

Type: object

ソースを表示

code(必須): string

プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
message(必須): string

判読可能なエラー文字列。

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Short error code that defines the error, meant for programmatic parsing.\n"
        },
        "message":{
            "type":"string",
            "description":"Human-readable error string.\n"
        }
    },
    "required":[
        "code",
        "message"
    ]
}

先頭に戻る

例

この例では、oracle_adw_walletlessをコールする必要がなくなったOracle Autonomous Data Warehouse (ADW)への接続を削除します。接続のオブジェクトIDは'admin'.'oracle_adw_walletless'で、Base64でエンコードされたconnectionId値はJ2FkbWluJy4nb3JhY2xlX2Fkd193YWxsZXRsZXNzJw==です。

cURLの例

まず、削除する接続のオブジェクトIDを取得し、Base64で値をエンコードしてconnectionIdを決定します。「オブジェクトID」の値は、Oracle Analytics Serverの「接続の検査」ダイアログから取得できます。

connectionIdを指定してcURLコマンドを実行します。

curl -i \
 --header 'Authorization: Bearer <token>' \
 --header 'Content-Type: application/json' \
 --request DELETE 'https://<hostname>/api/20210901/catalog/connections/J2FkbWluJy4nb3JhY2xlX2Fkd193YWxsZXRsZXNzJw=='

レスポンス・ヘッダーの例

適用不可。

レスポンス本文の例

適用不可。

先頭に戻る