diff --git a/guides/api-calls/permissions-and-errors/common-errors.md b/guides/api-calls/permissions-and-errors/common-errors.md index afdce5d06..966ed18be 100644 --- a/guides/api-calls/permissions-and-errors/common-errors.md +++ b/guides/api-calls/permissions-and-errors/common-errors.md @@ -58,103 +58,103 @@ Box APIの使用時に発生した一般的なエラーの解決策について -| | | | -| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | -| **エラー** | `bad_digest` | | -| **メッセージ** | The specified `content-md5` did not match what we received. (指定のcontent-md5は受信したものと一致しませんでした。) | | -| **解決策** | ファイルのアップロード中に、ファイルのSHA-1ハッシュと`content-md5`ヘッダーを指定して、ファイルが転送中に破損していないかどうかを確認できます。リクエストで指定されたSHA-1ハッシュは、アップロードで受信したものと一致していません。アップロードしたファイルの有効なSHA-1ハッシュを指定してください。 | | -| | | | -| **エラー** | `bad_request` | | -| **メッセージ** | | | -| **解決策** | APIリクエストで指定された必須パラメータが見つからないか無効です。詳細については、レスポンス本文の拡張エラーメッセージを確認してください。 | | -| | | | -| **エラー** | `cannot_make_collaborated_subfolder_private` | | -| **メッセージ** | Cannot move a collaborated folder to a private folder unless the new owner is explicitly specified. (新しい所有者が明示的に指定されない限り、コラボレーションサブフォルダを非公開フォルダに移動することはできません。) | | -| **解決策** | リクエストの`owned_by.id`フィールドを設定して、コンテンツの転送先となるユーザーのIDを指定してください。 | | -| | | | -| **エラー** | `collaborations_not_available_on_root_folder` | | -| **メッセージ** | Root folder cannot be collaborated (ルートフォルダのコラボレーションができません) | | -| **解決策** | ユーザーのルートフォルダ (フォルダID 0) にコラボレータを設定できません。ルートフォルダとは異なるフォルダIDを使用してください。 | | -| | | | -| **エラー** | `cyclical_folder_structure` | | -| **メッセージ** | Folder move creates cyclical folder structure (フォルダの移動により循環フォルダ構造が作成されます) | | -| **解決策** | フォルダの移動で指定したフォルダIDによって、循環フォルダ構造 (たとえば、フォルダがそのフォルダ内のサブフォルダに移動される構造) が作成されます。フォルダ移動リクエストで指定するフォルダを変更してください。 | | -| | | | -| **エラー** | `folder_not_empty` | | -| **メッセージ** | Cannot delete – folder not empty (削除できません – フォルダにファイルが存在しません) | | -| **解決策** | 削除する前に、フォルダからすべてのコンテンツを削除してください。 | | -| | | | -| **エラー** | `invalid_collaboration_item` | | -| **メッセージ** | Item type must be specified and set to 'folder' (項目タイプは指定されていなければならず、「folder」に設定されていることが必要です) | | -| **解決策** | コラボレーション項目の`item.type`フィールドをフォルダに設定してください。 | | -| | | | -| **エラー** | `invalid_grant` | | -| **メッセージ** | Verify the authorization code is set correctly in your request, or your application likely needs to get a new authorization code. (リクエストに承認コードが正しく設定されていることを確認してください。そうしないと、アプリケーションで新しい承認コードが必要になる可能性があります。) | | -| **解決策** | APIリクエストで指定された承認コードが見つからないか、無効になりました。考えられる解決策として、リクエストにアクセストークンが正しく追加されているかどうかを確認してください。正しく設定されている場合は、アクセストークンが期限切れになっている可能性があります。アクセストークンを更新するか、新しいアクセストークンを取得してください。 | | -| | | | -| **エラー** | `invalid_grant` | | -| **メッセージ** | Current date time must be before the expiration date time listed in the 'exp' claim. (現在の日時は「exp」クレームに記載されている有効期限の日時よりも前である必要があります。) | | -| **解決策** | このエラーは、ローカルマシンとBoxサーバーのUnix時間が同期されていない場合に発生します。このエラーを修正するには、ローカルマシンのUnix時間を、同期対象の時刻サーバーと一致するよう更新し、再度リクエストしてみてください。 | | -| | | | -| **エラー** | `invalid_limit` | | -| **メッセージ** | Limit is not a valid number (制限値が有効な数値ではありません) | | -| **解決策** | 指定された制限値に有効な数値を追加してください。 | | -| | | | -| **エラー** | `invalid_offset` | | -| **メッセージ** | Offset is not a valid number (オフセットが有効な数値ではありません) | | -| **解決策** | 指定されたオフセット値に有効な数値を追加してください。 | | -| | | | -| **エラー** | `invalid_request_parameters` | | -| **メッセージ** | Invalid input parameters in request (リクエスト内に無効な入力パラメータがあります) | | -| **解決策** | APIリクエストで無効なパラメータが送信されました。APIリファレンスドキュメントで、このAPI操作に指定すべき正しいリクエストパラメータを確認してください。 | | -| | | | -| **エラー** | `invalid_status` | | -| **メッセージ** | You can change the status only if the collaboration is pending (ステータスを変更できるのは、コラボレーションが保留中の場合のみです) | | -| **解決策** | コラボレーションのステータスは、現在のステータスが保留中に設定されている場合に、`accessible_by`フィールドで指定されたユーザーのみが承認済みまたは拒否済みに更新できます。 | | -| | | | -| **エラー** | `invalid_upload_session_id` | | -| **メッセージ** | The upload session ID provided in the URL is not of a valid format. (URLに指定されているアップロードセッションIDが有効な形式ではありません。) | | -| **解決策** | 分割アップロードAPIリクエストの送信時に指定されたセッションIDが無効です。作成されたセッションと同じセッションIDを使用してください。 | | -| | | | -| **エラー** | `item_name_invalid` | | -| **メッセージ** | Item name invalid (項目名が無効です) | | -| **解決策** | ファイルの名前が有効であることを確認してください。Boxでは、255文字以下のファイル名またはフォルダ名のみがサポートされています。印刷不可能な文字を含むファイル名、`/`、`\`、`<`、`>`、`:`、\` | `, `?`, `\*`, `—\`という文字を含む名前、先頭または末尾にスペースを含む名前のほか、「.」と「..」という予約済みの名前も使用できません。 | -| | | | -| **エラー** | `item_name_too_long` | | -| **メッセージ** | Item name too long (項目名が長すぎます) | | -| **解決策** | 項目に指定されている名前の長さを短くしてください。Boxのファイル名またはフォルダ名に使用できる文字数は255文字以下です。 | | -| | | | -| **エラー** | `metadata_after_file_contents` | | -| **メッセージ** | Metadata is included after file contents in a file upload request. (メタデータは、ファイルアップロードリクエストでファイルのコンテンツの後に含まれています。) | | -| **解決策** | ファイルのコンテンツの前にファイルのメタデータを含めてください。 | | -| **エラー** | `password_reset_required` | | -| **メッセージ** | User needs to reset password (ユーザーはパスワードをリセットする必要があります) | | -| **解決策** | ユーザーは、アカウントの[設定手順](https://support.box.com/hc/ja/articles/360043691614)を完了していません。 | | -| | | | -| **エラー** | `requested_page_out_of_range` | | -| **メッセージ** | Requested representation page out of range (リクエストされたレプリゼンテーションページが範囲外です) | | -| **解決策** | 指定された範囲ヘッダーは、指定した項目のサイズに収まりません。項目のサイズに収まるよう範囲を調整し、もう一度やり直してください。 | | -| | | | -| **エラー** | `requested_preview_unavailable` | | -| **メッセージ** | Requested preview unavailable (リクエストされたプレビューは利用できません) | | -| **解決策** | ファイルに対してリクエストされたサムネイルサイズが有効ではありません。API操作のリファレンスドキュメントで、利用可能な形式サイズを確認してください。 | | -| | | | -| **エラー** | `sync_item_move_failure` | | -| **メッセージ** | Cannot move a synced item (同期した項目を移動できません) | | -| **解決策** | 項目は、Box Syncクライアントによって同期が設定されているため移動できません。項目の`sync_state`を`not_synced`に設定することで、解決できる場合があります。 | | -| | | | -| **エラー** | `task_assignee_not_allowed` | | -| **メッセージ** | Assigner does not have sufficient privileges to assign task to assignee (任命者には、担当者にタスクを割り当てるのに十分な権限がありません) | | -| **解決策** | タスクを割り当てようとしているユーザーに、そのための適切な権限がありません。タスクの割り当てを許可するようユーザー権限を調整してください。 | | -| | | | -| **エラー** | `terms_of_service_required` | | -| **メッセージ** | User must accept custom terms of service before action can be taken (ユーザーは操作を実行する前にカスタマイズされたサービス利用規約に同意する必要があります) | | -| **解決策** | Boxアカウントの管理者はサービス利用規約のカスタマイズを設定していますが、ユーザーはまだログインしてこのサービス利用規約に同意していません。続行するには、ユーザーがこのサービス利用規約に同意するか、管理者が同規約を無効にする必要があります。詳細については、[こちら](https://support.box.com/hc/ja/articles/360044192733-カスタム利用規約の使用)で確認してください。 | | -| | | | -| **エラー** | `user_already_collaborator` | | -| **メッセージ** | ユーザーはすでにコラボレータです | | -| **解決策** | ある項目のコラボレータに設定しようとしているユーザーは、すでにその項目のコラボレータです。このリクエストは必要ありません。 | | -| | | | +| | | | +| --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | +| **エラー** | `bad_digest` | | +| **メッセージ** | The specified `content-md5` did not match what we received. (指定のcontent-md5は受信したものと一致しませんでした。) | | +| **解決策** | ファイルのアップロード中に、ファイルのSHA-1ハッシュと`content-md5`ヘッダーを指定して、ファイルが転送中に破損していないかどうかを確認できます。リクエストで指定されたSHA-1ハッシュは、アップロードで受信したものと一致していません。アップロードしたファイルの有効なSHA-1ハッシュを指定してください。 | | +| | | | +| **エラー** | `bad_request` | | +| **メッセージ** | | | +| **解決策** | APIリクエストで指定された必須パラメータが見つからないか無効です。詳細については、レスポンス本文の拡張エラーメッセージを確認してください。 | | +| | | | +| **エラー** | `cannot_make_collaborated_subfolder_private` | | +| **メッセージ** | Cannot move a collaborated folder to a private folder unless the new owner is explicitly specified. (新しい所有者が明示的に指定されない限り、コラボレーションサブフォルダを非公開フォルダに移動することはできません。) | | +| **解決策** | リクエストの`owned_by.id`フィールドを設定して、コンテンツの転送先となるユーザーのIDを指定してください。 | | +| | | | +| **エラー** | `collaborations_not_available_on_root_folder` | | +| **メッセージ** | Root folder cannot be collaborated (ルートフォルダのコラボレーションができません) | | +| **解決策** | ユーザーのルートフォルダ (フォルダID 0) にコラボレータを設定できません。ルートフォルダとは異なるフォルダIDを使用してください。 | | +| | | | +| **エラー** | `cyclical_folder_structure` | | +| **メッセージ** | Folder move creates cyclical folder structure (フォルダの移動により循環フォルダ構造が作成されます) | | +| **解決策** | フォルダの移動で指定したフォルダIDによって、循環フォルダ構造 (たとえば、フォルダがそのフォルダ内のサブフォルダに移動される構造) が作成されます。フォルダ移動リクエストで指定するフォルダを変更してください。 | | +| | | | +| **エラー** | `folder_not_empty` | | +| **メッセージ** | Cannot delete – folder not empty (削除できません – フォルダにファイルが存在しません) | | +| **解決策** | 削除する前に、フォルダからすべてのコンテンツを削除してください。 | | +| | | | +| **エラー** | `invalid_collaboration_item` | | +| **メッセージ** | Item type must be specified and set to 'folder' (項目タイプは指定されていなければならず、「folder」に設定されていることが必要です) | | +| **解決策** | コラボレーション項目の`item.type`フィールドをフォルダに設定してください。 | | +| | | | +| **エラー** | `invalid_grant` | | +| **メッセージ** | Verify the authorization code is set correctly in your request, or your application likely needs to get a new authorization code. (リクエストに承認コードが正しく設定されていることを確認してください。そうしないと、アプリケーションで新しい承認コードが必要になる可能性があります。) | | +| **解決策** | APIリクエストで指定された承認コードが見つからないか、無効になりました。考えられる解決策として、リクエストにアクセストークンが正しく追加されているかどうかを確認してください。正しく設定されている場合は、アクセストークンが期限切れになっている可能性があります。アクセストークンを更新するか、新しいアクセストークンを取得してください。 | | +| | | | +| **エラー** | `invalid_grant` | | +| **メッセージ** | Current date time must be before the expiration date time listed in the 'exp' claim. (現在の日時は「exp」クレームに記載されている有効期限の日時よりも前である必要があります。) | | +| **解決策** | このエラーは、ローカルマシンとBoxサーバーのUnix時間が同期されていない場合に発生します。このエラーを修正するには、ローカルマシンのUnix時間を、同期対象の時刻サーバーと一致するよう更新し、再度リクエストしてみてください。 | | +| | | | +| **エラー** | `invalid_limit` | | +| **メッセージ** | Limit is not a valid number (制限値が有効な数値ではありません) | | +| **解決策** | 指定された制限値に有効な数値を追加してください。 | | +| | | | +| **エラー** | `invalid_offset` | | +| **メッセージ** | Offset is not a valid number (オフセットが有効な数値ではありません) | | +| **解決策** | 指定されたオフセット値に有効な数値を追加してください。 | | +| | | | +| **エラー** | `invalid_request_parameters` | | +| **メッセージ** | Invalid input parameters in request (リクエスト内に無効な入力パラメータがあります) | | +| **解決策** | APIリクエストで無効なパラメータが送信されました。APIリファレンスドキュメントで、このAPI操作に指定すべき正しいリクエストパラメータを確認してください。 | | +| | | | +| **エラー** | `invalid_status` | | +| **メッセージ** | You can change the status only if the collaboration is pending (ステータスを変更できるのは、コラボレーションが保留中の場合のみです) | | +| **解決策** | コラボレーションのステータスは、現在のステータスが保留中に設定されている場合に、`accessible_by`フィールドで指定されたユーザーのみが承認済みまたは拒否済みに更新できます。 | | +| | | | +| **エラー** | `invalid_upload_session_id` | | +| **メッセージ** | The upload session ID provided in the URL is not of a valid format. (URLに指定されているアップロードセッションIDが有効な形式ではありません。) | | +| **解決策** | 分割アップロードAPIリクエストの送信時に指定されたセッションIDが無効です。作成されたセッションと同じセッションIDを使用してください。 | | +| | | | +| **エラー** | `item_name_invalid` | | +| **メッセージ** | Item name invalid (項目名が無効です) | | +| **解決策** | ファイルの名前が有効であることを確認してください。Boxでは、255文字以下のファイル名またはフォルダ名のみがサポートされています。印刷不可能な文字を含むファイル名、`/`、`\`、`<`、`>`、`:`、\` | `, `?`, `\*`, `—\`という文字を含む名前、先頭または末尾にスペースを含む名前のほか、「.」と「..」という予約済みの名前も使用できません。 | +| | | | +| **エラー** | `item_name_too_long` | | +| **メッセージ** | Item name too long (項目名が長すぎます) | | +| **解決策** | 項目に指定されている名前の長さを短くしてください。Boxのファイル名またはフォルダ名に使用できる文字数は255文字以下です。 | | +| | | | +| **エラー** | `metadata_after_file_contents` | | +| **メッセージ** | Metadata is included after file contents in a file upload request. (メタデータは、ファイルアップロードリクエストでファイルのコンテンツの後に含まれています。) | | +| **解決策** | ファイルのコンテンツの前にファイルのメタデータを含めてください。 | | +| **エラー** | `password_reset_required` | | +| **メッセージ** | User needs to reset password (ユーザーはパスワードをリセットする必要があります) | | +| **解決策** | ユーザーは、アカウントの[設定手順](https://support.box.com/hc/ja/articles/360043691614)を完了していません。 | | +| | | | +| **エラー** | `requested_page_out_of_range` | | +| **メッセージ** | Requested representation page out of range (リクエストされたレプリゼンテーションページが範囲外です) | | +| **解決策** | 指定された範囲ヘッダーは、指定した項目のサイズに収まりません。項目のサイズに収まるよう範囲を調整し、もう一度やり直してください。 | | +| | | | +| **エラー** | `requested_preview_unavailable` | | +| **メッセージ** | Requested preview unavailable (リクエストされたプレビューは利用できません) | | +| **解決策** | ファイルに対してリクエストされたサムネイルサイズが有効ではありません。API操作のリファレンスドキュメントで、利用可能な形式サイズを確認してください。 | | +| | | | +| **エラー** | `sync_item_move_failure` | | +| **メッセージ** | Cannot move a synced item (同期した項目を移動できません) | | +| **解決策** | 項目は、Box Syncクライアントによって同期が設定されているため移動できません。項目の`sync_state`を`not_synced`に設定することで、解決できる場合があります。 | | +| | | | +| **エラー** | `task_assignee_not_allowed` | | +| **メッセージ** | Assigner does not have sufficient privileges to assign task to assignee (任命者には、担当者にタスクを割り当てるのに十分な権限がありません) | | +| **解決策** | タスクを割り当てようとしているユーザーに、そのための適切な権限がありません。タスクの割り当てを許可するようユーザー権限を調整してください。 | | +| | | | +| **エラー** | `terms_of_service_required` | | +| **メッセージ** | User must accept custom terms of service before action can be taken (ユーザーは操作を実行する前にカスタムサービス利用規約に同意する必要があります) | | +| **解決策** | Boxアカウントの管理者はカスタムサービス利用規約を設定していますが、ユーザーはまだログインしてこのサービス利用規約に同意していません。続行するには、ユーザーがこのサービス利用規約に同意するか、管理者が同規約を無効にする必要があります。詳細については、[こちら](https://support.box.com/hc/ja/articles/360044192733-カスタム利用規約の使用)で確認してください。 | | +| | | | +| **エラー** | `user_already_collaborator` | | +| **メッセージ** | ユーザーはすでにコラボレータです | | +| **解決策** | ある項目のコラボレータに設定しようとしているユーザーは、すでにその項目のコラボレータです。このリクエストは必要ありません。 | | +| | | |