機械翻訳について

移動先

• リクエスト
• レスポンス
• 例

新しいドラフト・バージョンの作成

post

/content/management/api/v1.1/taxonomies/{id}/createDraft

既存のタクソノミから新しいドラフト・タクソノミを作成します。

リクエスト

パス・パラメータ

• id: string
  タクソノミのId。

問合せパラメータ

• links(optional): string
  このパラメータは、リンク名のカンマ区切りのリストを受け入れます。 デフォルトでは、このパラメータによって、適用可能なすべてのリンクが指定されます。 可能な値は次のとおりです: self, canonical, describedby

ヘッダー・パラメータ

• X-Requested-With: string
  CSRF攻撃を軽減するためのカスタム・ヘッダー。

  許容値: [ "XMLHttpRequest" ]

本文()

タクソノミで下書きリクエスト・ペイロードが作成されます。 statusおよびversionは、ソース・タクソノミの判別に使用されます。 現在、versionは使用していません。

新しいドラフトが作成されると、プロモート・タクソノミのshortNameが他のタクソノミと競合する場合、新しいshortNameが生成されます。 shortNameを変更すると、apiNameのないカテゴリは自動的に生成されます。

これは非同期操作です。 非同期リクエストは、ロケーション・ヘッダーにステータス・リンクがある202ステータスで応答します。

ルート・スキーマ : TaxonomyOperationCreateDraftRequest

型: object

タクソノミ操作下書きリクエストの作成

ソースを表示

• status(optional): string
  タクソノミのステータス(ドラフト/促進済)。 現在、プロモートされたタクソノミのみを使用して新しい下書きを作成できます。
• version(optional): integer(int32)
  タクソノミのバージョン。 現在、バージョン・フィールドは無視されます。

{
    "type":"object",
    "properties":{
        "status":{
            "type":"string",
            "description":"Status of the Taxonomy (draft/promoted). Currently, only promoted taxonomies can be used to create a new draft."
        },
        "version":{
            "type":"integer",
            "format":"int32",
            "description":"Version of a Taxonomy. The version field is currently ignored."
        }
    },
    "description":"Taxonomy Operation Create Draft Request"
}

トップに戻る

レスポンス

サポートされているメディア・タイプ

• application/json

202レスポンス

Accepted.

400レスポンス

不正リクエスト

403レスポンス

禁止。

404レスポンス

タクソノミが見つかりません。 リクエストしたリソースが見つかりません。

409レスポンス

リクエストされたリソース操作は一時的に使用できません

500レスポンス

内部サーバー・エラー

トップに戻る

例

次の例は、cURLを使用してRESTリソースにPOSTリクエストを発行することで、既存の昇格されたタクソノミからドラフトのタクソノミを作成する方法を示しています:

curl -X POST -H 'Content-Type: application/json' -H 'X-Requested-With: XMLHttpRequest' 'https://host:port/content/management/api/v1.1/taxonomies/{id}/createDraft'

例:

既存の昇格されたタクソノミからドラフトのタクソノミを作成します。

/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/createDraft

リクエスト本文

{
  "status": "promoted"
}

先頭に戻る