Box Developerドキュメント
ログイン

Box Developerドキュメントの新しいベータ版サイトがまもなくリリースされる予定です。最新の開発者向けガイド、APIリファレンス、AI搭載の検索により、Boxを使用した迅速な開発をサポートします。更新情報については今しばらくお待ちください。

最新バージョン

メタデータカスケードポリシーのリストを取得

get
https://api.box.com/2.0
/metadata_cascade_policies

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

指定したフォルダに適用されているすべてのメタデータカスケードポリシーのリストを取得します。これは、IDが0のルートフォルダでは使用できません。

関連するガイド

リクエスト

bearer [ACCESS_TOKEN]
application/json

クエリパラメータ

stringクエリ内必須
31232

どのフォルダのポリシーを返すかを指定します。これは、IDが0のルートフォルダでは使用できません。

stringクエリ内省略可能
JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii

結果が返される開始位置のマーカー。マーカーベースのページネーションを使用している場合に使用されます。

これを使用するには、usemarkerをtrueに設定する必要があります。

integer (int64)クエリ内省略可能
1000
0

レスポンスが開始される項目のオフセット。

オフセットパラメータ値が10,000を超えているクエリは拒否され、400レスポンスが返されます。

stringクエリ内省略可能
31232

メタデータカスケードポリシーを検索するEnterprise ID。指定されていない場合は、デフォルトで現在のEnterpriseに設定されます。

レスポンス

application/jsonメタデータカスケードポリシー

メタデータカスケードポリシーのリストを返します。

application/jsonクライアントエラー

パラメータのいずれかが有効な形式でない場合はエラーを返します。

application/jsonクライアントエラー

フォルダにアクセスできない場合にエラーを返します。このエラーは、IDが0のルートフォルダにアクセスした場合によく発生します。

application/jsonクライアントエラー

フォルダが見つからないか、ユーザーがフォルダにアクセスできない場合はエラーを返します。

  • not_found - フォルダが見つからないか、ユーザーがフォルダにアクセスできない場合に返されます。
application/jsonクライアントエラー

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

get
メタデータカスケードポリシーのリストを取得
このドキュメント内で一部のAPIを試せるようになりました。
ログイン

リクエストの例

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


cURL
curl -i -X GET "https://api.box.com/2.0/metadata_cascade_policies?folder_id=31232" \
     -H "authorization: Bearer <ACCESS_TOKEN>"
Node/TypeScript v10
await client.metadataCascadePolicies.getMetadataCascadePolicies({
  folderId: folder.id,
} satisfies GetMetadataCascadePoliciesQueryParams);
Python v10
client.metadata_cascade_policies.get_metadata_cascade_policies(folder.id)
.NET v10
await client.MetadataCascadePolicies.GetMetadataCascadePoliciesAsync(queryParams: new GetMetadataCascadePoliciesQueryParams(folderId: folder.Id));
Swift v10
try await client.metadataCascadePolicies.getMetadataCascadePolicies(queryParams: GetMetadataCascadePoliciesQueryParams(folderId: folder.id))
Java v10
client.getMetadataCascadePolicies().getMetadataCascadePolicies(new GetMetadataCascadePoliciesQueryParams(folder.getId()))
.NET v6
await client.MetadataCascadePolicies.GetMetadataCascadePoliciesAsync(queryParams: new GetMetadataCascadePoliciesQueryParams(folderId: folder.Id));
Node v4
await client.metadataCascadePolicies.getMetadataCascadePolicies({
  folderId: folder.id,
} satisfies GetMetadataCascadePoliciesQueryParams);

レスポンスの例

{
  "entries": [
    {
      "id": "6fd4ff89-8fc1-42cf-8b29-1890dedd26d7",
      "owner_enterprise": {
        "id": "690678",
        "type": "enterprise"
      },
      "parent": {
        "id": "1234567",
        "type": "folder"
      },
      "scope": "enterprise_123456",
      "templateKey": "productInfo",
      "type": "metadata_cascade_policy"
    }
  ],
  "limit": 1000,
  "next_marker": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii",
  "prev_marker": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVih"
}