Box Developerドキュメント
最新バージョン

メタデータ階層レベルを更新

patch
https://api.box.com/2.0
/metadata_taxonomies/:namespace/:taxonomy_key/levels/:level_index

このエンドポイントはバージョン2024.0です。引き続き使用するために 変更は必要ありません。詳細については、 **Box APIのバージョン管理**を参照してください。

既存のメタデータ階層レベルを更新します。

リクエスト

bearer [ACCESS_TOKEN]
application/json

パスパラメータ

integerパス内必須
1

メタデータ階層レベルのインデックス。

stringパス内必須
enterprise_123456

メタデータ階層の名前空間。

stringパス内必須
geography

メタデータ階層のキー。

リクエスト本文

string本文内省略可能
"French Republic"

メタデータ階層レベルの説明。

string本文内必須
"France"

メタデータ階層レベルの表示名。

レスポンス

更新されたメタデータ階層レベル。

リクエストのパラメータまたは本文が無効な場合に返されます。

  • bad_request - 本文に有効なリクエストが含まれていない場合に返されます。多くの場合、このレスポンスには、不足しているフィールドに関する追加の詳細が含まれます。

ユーザーにメタデータ階層を変更する権限がない場合に返されます。その理由はいくつかありますが、最も一般的なのは、ユーザーが (共同) 管理者権限を持っていないこと、またはユーザーに指定した名前空間へのアクセス権限が与えられていないことです。

予期しないクライアントエラー。

patch
メタデータ階層レベルを更新
このドキュメント内で一部のAPIを試せるようになりました。
ログイン

リクエストの例

Box SDKのバージョン戦略の詳細については、 **こちら**を確認してください。


.NET v6
await client.MetadataTaxonomies.UpdateMetadataTaxonomyLevelByIdAsync(namespaceParam: namespaceParam, taxonomyKey: taxonomyKey, levelIndex: 1L, requestBody: new UpdateMetadataTaxonomyLevelByIdRequestBody(displayName: "Continent UPDATED") { Description = "Continent Level UPDATED" });
Node v4
await client.metadataTaxonomies.updateMetadataTaxonomyLevelById(
  namespace,
  taxonomyKey,
  1,
  {
    displayName: 'Continent UPDATED',
    description: 'Continent Level UPDATED',
  } satisfies UpdateMetadataTaxonomyLevelByIdRequestBody,
);

レスポンスの例

{
  "description": "Continent",
  "displayName": "Continent",
  "level": 1
}