Oracle Analytics CloudのためのREST API

機械翻訳について

フォルダの削除

delete

/api/20210901/catalog/folders/{id}

カタログからフォルダを削除します。

リクエスト

パス・パラメータ

id(必須): string

base64url形式のカタログ品目ID。

問合せパラメータ

recursive: boolean

指定してtrueにすると、すべての子アイテムが再帰的に削除されます。それ以外の場合は、空のフォルダのみを削除できます

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

先頭に戻る

レスポンス

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"
    ]
}

先頭に戻る

例

この例では、Salesをコールする必要がなくなったフォルダを削除します。フォルダのオブジェクトIDは/@Catalog/shared/Salesで、Base64URLセーフでエンコードされたid値は L0BDYXRhbG9nL3NoYXJlZC9TYWxlcwです。

cURLの例

最初に、削除するフォルダのオブジェクトIDを取得し、Base64URLを安全にエンコードしてidを決定します。「オブジェクトID」値は、Oracle Analytics Cloudのフォルダの「検査」ダイアログから取得できます。

必要なidを指定してcURLコマンドを実行します。

curl -i \
 --header 'Authorization: Bearer <token>' \
 --request DELETE 'https://<hostname>/api/20210901/catalog/folders/L0BDYXRhbG9nL3NoYXJlZC9TYWxlcw'

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

適用不可。

レスポンス本文の例

適用不可。

先頭に戻る