追加する分類のラベルを指定することで、フォルダに分類を追加します。
このAPIは、/folders/:id/enterprise_12345/securityClassification-6VMVochwUWo
のように、URLにEnterprise IDを明示的に含めることで呼び出すこともできます。
12345
フォルダを表す一意の識別子。
フォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLがhttps://*.app.box.com/folder/123
の場合、folder_id
は123
です。
Boxアカウントのルートフォルダは常にID 0
で表されます。
"Sensitive"
このフォルダに適用する分類の名前。
会社で使用できる分類のリストを取得するには、分類APIを使用して、使用可能なすべての分類キーが表示される分類テンプレートを取得します。
フォルダに適用された分類テンプレートインスタンスを返します。
リクエスト本文が無効な場合にエラーを返します。
schema_validation_failed
- リクエスト本文に、存在しないフィールドか、値またはタイプが期待されるフィールドタイプと一致しないフィールドの値が含まれています。たとえば、enum
またはmultiSelect
フィールドに不明なオプションが指定されている場合があります。フォルダテンプレートまたはメタデータテンプレートが見つからなかった場合にエラーを返します。
not_found
- フォルダが見つからないか、ユーザーがフォルダにアクセスできません。instance_tuple_not_found
- メタデータテンプレートが見つかりませんでした。このメタデータテンプレートのインスタンスがすでにフォルダに存在する場合はエラーを返します。
tuple_already_exists
- メタデータテンプレートのインスタンスがすでにフォルダに存在する場合に返されます。予期しないクライアントエラー。
curl -i -X POST "https://api.box.com/2.0/folders/12345/metadata/enterprise/securityClassification-6VMVochwUWo" \
-H "authorization: Bearer <ACCESS_TOKEN>" \
-H "content-type: application/json" \
-d '{
"Box__Security__Classification__Key": "Sensitive"
}'
{
"$canEdit": true,
"$parent": "folder_59449484661,",
"$scope": "enterprise_27335",
"$template": "securityClassification-6VMVochwUWo",
"$type": "securityClassification-6VMVochwUWo-fd31537a-0f95-4d86-9f2b-5974a29978f8",
"$typeVersion": 5,
"$version": 1,
"Box__Security__Classification__Key": "Sensitive"
}