タクソノミの削除
delete
/content/management/api/v1.1/taxonomies/{id}
次のオプションを使用して、タクソノミのバージョンを削除できます: draft、プロモート済またはすべて。
リクエスト
パス・パラメータ
- id: string
タクソノミのId。
問合せパラメータ
- q(optional): string
このパラメータは、フィールド値に一致する問合せ式条件を受け入れます。 問合せ条件は、AND演算子を使用して結合し、カッコでグループ化できます。 問合せ条件の値は、{fieldName} {operator} "{fieldValue}"の形式に従います。 許可されるフィールド名は、statusのみです。 問合せに複数のstatus fieldNamesを含めることはできません。
statusに値が指定されていない場合、デフォルトの「プロモート」になります。 タクソノミを削除する場合、statusは「draft」、「「プロモート済」」または「「すべて」」と同じにできます。 statusが「すべて」と等しい場合、タクソノミのすべてのバージョンが削除されます。
演算子で使用できる値は、statusのeq (Equals)のみです。
タクソノミを削除する場合は、デフォルト・ステータスが「プロモート済」であるため、削除する特定のバージョンを常に問合せパラメータに指定する必要があります。
例:
https://{cecsdomain}/content/management/api/v1.1/taxonomies/{id}?q=(status eq "draft")
例:
https://{cecsdomain}/content/management/api/v1.1/taxonomies/{id}?q=(status eq "promoted")
例:
https://{cecsdomain}/content/management/api/v1.1/taxonomies/{id}?q=(status eq "all")
プロモート済バージョンを削除する場合、タクソノミを公開したり、タクソノミをリポジトリに割り当てることはできません。
ヘッダー・パラメータ
- X-Requested-With: string
CSRF攻撃を軽減するためのカスタム・ヘッダー。許容値:
[ "XMLHttpRequest" ]
レスポンス
204レスポンス
OK。
400レスポンス
不正リクエスト
403レスポンス
禁止。
404レスポンス
タクソノミが見つかりません。 リクエストしたリソースが見つかりません。
409レスポンス
リクエストされたリソース操作は一時的に使用できません
500レスポンス
内部サーバー・エラー
例
次の例は、cURLを使用してRESTリソースに対してDELETEリクエストを送信し、タクソノミを削除する方法を示しています。
curl -i -X DELETE -H 'X-Requested-With: XMLHttpRequest' 'https://host:port/content/management/api/v1.1/taxonomies/{id}?q=(status eq \"draft\")'
例:
これにより、タクソノミIDによって識別されたタクソノミが削除されます。
ノート:
ドラフトのタクソノミのみ削除できます。 したがって、問合せフィールドのステータスはドラフトと指定する必要があります。/content/management/api/v1.1/taxonomies/3F6C5D0EEFDD4C34B9908EB996696BE1?q=(status eq \"draft\")"