更新オプション一覧項目

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

PUT /datasources/{name}

次のプレースホルダーを置き換えます。

プレースホルダ	形容
{name}	更新が必要なオプションリストのname

ボディパラメータ

パラメーター	種類	形容
name	String	変更する必要があるオプション・リストの名前。このパラメータは必須ですが、値は変更できません。
labels	Labels	正規名の翻訳。
type	String	Flatオプションリストアイテムのネストを無効にしますHierarchical 、オプションリストアイテムのネストを有効にします。 Flatに設定され、values配列にネストされた項目が含まれている場合は、エラーがスローされます。このパラメータは、変更されないままであっても必須です。
values	配列。 DatasourceValue	オプションリストに属するオプションリスト項目。
is_system_owned	Boolean	falseオプションリストを編集可能にtrue 、オプションリストをロックしてそれ以上の変更を防ぎます。APIを使用してオプションリストを作成する場合は、デフォルト値であるalways use falseにする必要があります。

このリソースは、オプションリストのvalues配列全体を、PUT要求本文で送信されている配列で上書きすることで機能します。

オプションリストアイテムを削除するには、オプションリストの既存のvalues配列全体から、削除する必要があるオプション項目を除いたものを再度送信します。

項目の名前を変更するには、名前を変更する必要があるオプション項目を除いたvalues配列全体と、新しい名前を含むオプション項目を送信します。

現時点ではnot possible to change the name of the option listです。

ボディ例

作成オプションリストの例から設定を取得します

そして、それは次のように変換されます。

次の本文をリソースに渡します。

{
  "name": "Groceries",
  "type": "Hierarchical",
  "values": [
    {
      "identifier" : "Aloafofbread",
      "labels": {
        "en-US": "A loaf of bread",
        "nl-BE": "Een brood"
      },
      "values" : []
    },
    {
      "identifier" : "Jam",
      "values" : []
    }
  ]
}

nameパラメータとtypeパラメータは、変更できない、または変更しない場合でも必須であることに注意してください。識別子文字列には、文字、数字、アンダースコア、ハイフン、ピリオド、および50文字未満のみを含めることができます。

応答

応答	体
204 No Content	すべてがエラーなしで処理された場合は、空の本体を返します。
400 Bad Request	otherキーを使用してアクセス可能な本文にエラーメッセージを返します。つまり、必要な本文パラメータの1つが欠落している場合

応答の例

Status: 400 Bad Request

{
  "Message": "The type of an existing datasource cannot be changed."
}

この記事を改善するための提案がある場合は、お知らせください!