Backup Storage API エラー応答
パートナーは、Microsoft Graph の Microsoft 365 バックアップ Storage API を使用して、独自のアプリケーションを作成してバックアップを管理できます。 アプリケーションは、アプリケーションがデプロイされているテナント内の Microsoft 365 バックアップ ストレージ コントローラーになります。
Microsoft Graph に適用される 一般的なエラー に加えて、一部のエラー条件は Backup Storage API に固有です。 このトピックでは、Backup Storage API を使用するときに発生する可能性がある一般的なエラー条件の一覧を示します。
保護ポリシー API エラーを作成する
このセクションのエラー コードは、次の API に適用されます。
- exchangeProtectionPolicy を作成する
- oneDriveForBusinessProtectionPolicy を作成する
- sharePointProtectionPolicy を作成する
次の表に、返される可能性のあるエラー コードと応答コードを示します。
| HTTP ステータス コード | エラー コード | エラー メッセージ | 説明 |
|---|---|---|---|
| 400 | InvalidCreateRequest | 形式が正しくないか正しくないため、要求を処理できません。 | 作成要求が null、無効、またはそのサイズが大きすぎます。 |
| 400 | InvalidDisplayName | ポリシーの表示名が文字数制限を超えた場合、または空/null の場合にスローされます。 | ポリシー名の長さは 0 文字 > 、 < = 1024 文字であることを確認してください。 |
| 400 | InvalidProtectionUnitId | 保護ユニット ID のいずれかが無効な場合にスローされます。 | 保護ユニット ID が無効です。 |
| 413 | ProtectionUnitsLimitBreached | ユーザーが 1 つの要求でサポートされている以上の保護ユニットを追加しようとするとスローされます。 | 各要求の保護ユニットの数は 50 を超えてはなりません。 |
| 409 | PolicyCreationNotAllowed | アクティブな保護ポリシーが既にサービスに存在し、ユーザーが新しいポリシーを作成しようとしたときにスローされます。 | ポリシーを作成できません。 別のアクティブなポリシーが既に存在します。 |
| 500 | PolicySaveFailed | M365 Backup サービスで一時的なエラーが発生したときにスローされます。 | 不明なエラーが発生しました。 操作を再び実行してください。 |
保護ポリシー API エラーを取得する
このセクションのエラー コードは、次の API に適用されます。
次の表に、返される可能性のあるエラー コードと応答コードを示します。
| HTTP ステータス コード | エラー コード | エラー メッセージ | 説明 |
|---|---|---|---|
| 400 | InvalidPolicyId | 要求内のポリシー ID が無効、null、または空の場合にスローされます。 | ポリシー ID が無効です。 |
| 404 | PolicyNotFound | ID が有効だがポリシーが存在しない場合にスローされます。 | 保護ポリシーを取得できません。 |
パッチ保護ポリシー API エラー
このセクションのエラー コードは、次の API に適用されます。
- exchangeProtectionPolicy を更新する
- oneDriveForBusinessProtectionPolicy を更新する
- sharePointProtectionPolicy を更新する
次の表に、返される可能性のあるエラー コードと応答コードを示します。
| HTTP ステータス コード | エラー コード | エラー メッセージ | 説明 |
|---|---|---|---|
| 200 | ProtectionUnitAlreadyExists | これは、要求がサービスに既に存在するリストに重複する保護ユニットがある場合に返されるデルタ パッチ ProtectionUnit レベルのエラーです。 | ProtectionUnit レベルのエラー: ProtectionUnit は既に存在します。 |
| 200 | ProtectionUnitNotFound | これは、ユーザーがサービスに存在しない保護ユニットの削除を要求したときに返される差分パッチ ProtectionUnit レベルのエラーです。 | ProtectionUnit レベルのエラー: ProtectionUnit が存在しません。 |
| 400 | DuplicateProtectionUnitInList | これは、要求に重複する成果物がリストに含まれている場合に返される保護ユニット レベルのエラーです。 | 保護ユニット レベルエラー: リスト内の重複する保護ユニット。 |
| 404 | PolicyNotFound | ID が有効だがポリシーが存在しない場合にスローされます。 | 保護ポリシーを取得できません。 |
非アクティブな保護ポリシー API エラーを削除する
このセクションのエラー コードは、次の API に適用されます。
次の表に、返される可能性のあるエラー コードと応答コードを示します。
| HTTP ステータス コード | エラー コード | エラー メッセージ | 説明 |
|---|---|---|---|
| 400 | InvalidPolicyId | 要求内のポリシー ID が無効、null、または空の場合にスローされます。 | ポリシー ID が存在しません。 |
| 404 | PolicyNotFound | ID が有効だがポリシーが存在しない場合にスローされます。 | ポリシーが見つかりません。 |
| 403 | PolicyActionNotAllowed | ポリシーが非アクティブ状態でない場合にスローされます。 | ポリシーを削除できません。 非アクティブ状態のポリシーのみを削除できます。 |
アクティブな保護ポリシー API エラーを非アクティブ化する
このセクションのエラー コードは、次の API に適用されます。
次の表に、返される可能性のあるエラー コードと応答コードを示します。
| HTTP ステータス コード | エラー コード | エラー メッセージ | 説明 |
|---|---|---|---|
| 400 | InvalidPolicyId | 要求内のポリシー ID が無効、null、または空の場合にスローされます。 | ポリシー ID が存在しません。 |
| 403 | PolicyActionNotAllowed | ポリシーがアクティブな状態でない場合にスローされます。 | ポリシーが正しい状態ではありません。 アクティブな状態に移行するまで待ちます。 |
| 404 | PolicyNotFound | ID が有効だがポリシーが存在しない場合にスローされます。 | 保護ポリシーを取得できません。 |
非アクティブな保護ポリシー API エラーをアクティブ化する
このセクションのエラー コードは、次の API に適用されます。
次の表に、返される可能性のあるエラー コードと応答コードを示します。
| HTTP ステータス コード | エラー コード | エラー メッセージ | 説明 |
|---|---|---|---|
| 400 | InvalidPolicyId | 要求内のポリシー ID が無効、null、または空の場合にスローされます。 | ポリシー ID が存在しません。 |
| 403 | PolicyActionNotAllowed | ポリシーが非アクティブ状態でない場合にスローされます。 | ポリシーをアクティブ化できません。 ポリシーが正しい状態ではありません。 ポリシーが非アクティブ状態であることを確認します。 |
| 404 | PolicyNotFound | ID が有効だがポリシーが存在しない場合にスローされます。 | 保護ポリシーを取得できません。 |
保護ポリシー API エラーの下にあるすべての保護ユニットを一覧表示する
このセクションのエラー コードは、次の API に適用されます。
次の表に、返される可能性のあるエラー コードと応答コードを示します。
| HTTP ステータス コード | エラー コード | エラー メッセージ | 説明 |
|---|---|---|---|
| 400 | InvalidPolicyId | ポリシー ID が無効、null、または空です。 | ポリシー ID が無効です。 |
| 400 | FilterLengthExceeded | このエラーは、クライアントが "and" と "or" の両方のフィルター クエリを組み合わせて含む 1 つの要求で一度に送信しようとするフィルターまたはクエリの数が多すぎる場合に発生します。 | フィルターの長さが許可される制限を超えています。 |
| 400 | InvalidProtectionUnitId | 保護ユニット ID が無効または空の ID です。 | 保護ユニット ID が無効です。 |
| 404 | PolicyNotFound | ポリシーが存在しないか、見つかりません。 | 保護ポリシーを取得できません。 |
保護ユニット API エラーを取得する
このセクションのエラー コードは、次の API に適用されます。
次の表に、返される可能性のあるエラー コードと応答コードを示します。
| HTTP ステータス コード | エラー コード | エラー メッセージ | 説明 |
|---|---|---|---|
| 200 | UnknownError | 不明なエラーが発生しました。 | 不明なエラーが発生しました。 もう一度やり直してください。 問題が解決しない場合は、サポートにお問い合わせください。 |
| 200 | ProtectionUnitNotFound | 保護ユニットが存在しません。 | 要求された保護ユニットが存在しないか、削除されているか、見つかりません。 保護ユニット ID を再確認し、もう一度お試しください。 |
| 200 | InvalidArtifactId | 無効または存在しない保護ユニット ID。 | 削除する保護ユニットが見つかりませんでした。 |
| 200 | QuotaExceeded | バックアップ サイズ クォータを超えています (特に Exo 用)。 | バックアップ クォータを超えました。 |
| 400 | InvalidProtectionUnitId | 保護ユニット ID が無効または空の ID です。 | 保護ユニット ID が無効です。 |
復元セッション API エラーを作成する
このセクションのエラー コードは、次の API に適用されます。
次の表に、返される可能性のあるエラー コードと応答コードを示します。
| HTTP ステータス コード | エラー コード | エラー メッセージ | 説明 |
|---|---|---|---|
| 400 | InvalidPathType | PathType (new/in-place) は成果物では認識されません。 | 復元パスの種類が存在しません。 |
| 400 | InvalidArtifactRequest | 空または null の復元成果物リスト。 | 復元アーティファクトは少なくとも 1 つ必要です。 |
| 400 | InvalidRestorePoint | 指定された復元ポイントが無効です。 | 復元ポイント ID が無効または空です。 |
| 400 | DifferentRestoreDestinationType | 要求内の成果物のさまざまな宛先の種類。 | 復元先の種類が異なります。 |
| 413 | RestoreArtifactsLimitBreached | 要求最大成果物の上限を超えました。 | 復元成果物の制限に違反しています。 |
| 400 | DuplicateArtifactInList | リスト内の重複する成果物。 | 要求された復元成果物は既に存在します。 |
復元セッション API エラーを取得する
このセクションのエラー コードは、次の API に適用されます。
次の表に、返される可能性のあるエラー コードと応答コードを示します。
| HTTP ステータス コード | エラー コード | エラー メッセージ | 説明 |
|---|---|---|---|
| 400 | InvalidRestoreSessionId | 復元セッション ID が無効、null、または空です。 | 復元セッション ID は存在しません。 |
| 404 | RestoreSessionNotFound | 有効な ID が、セッションが見つかりません。 | 復元セッションが見つかりません。 |
パッチ復元セッション API エラー
このセクションのエラー コードは、次の API に適用されます。
次の表に、返される可能性のあるエラー コードと応答コードを示します。
| HTTP ステータス コード | エラー コード | エラー メッセージ | 説明 |
|---|---|---|---|
| 400 | InvalidRestoreSessionId | 復元セッション ID が無効、null、または空です。 | 復元セッション ID は存在しません。 |
| 400 | InvalidPatchRequest | 形式が正しくないか正しくないため、要求を処理できません。 | 形式が正しくないか正しくないため、要求を処理できません。 |
| 400 | InvalidRestorePoint | 指定された復元ポイントが無効です。 | 復元ポイントが無効です。 |
| 400 | RestoreArtifactsLimitBreached | 1 回の要求に対して成果物の上限が 50 を超えました。 | 復元成果物の制限に違反しています。 |
| 400 | InvalidArtifactRequest | 空または null の復元成果物リスト。 | 復元成果物は null です。 |
| 403 | RestoreSessionActionNotAllowed | アクティブな復元セッションにパッチを適用しようとします。 | 復元セッションには、下書き状態でのみ修正プログラムを適用できます。 |
| 404 | RestoreSessionNotFound | 有効な ID が、セッションが見つかりません。 | 復元セッションを取得できません。 |
| 400 | DuplicateArtifactInList | 要求内の重複する成果物。 | 要求された復元成果物は既に存在します。 |
復元セッション API エラーを削除する
このセクションのエラー コードは、次の API に適用されます。
次の表に、返される可能性のあるエラー コードと応答コードを示します。
| HTTP ステータス コード | エラー コード | エラー メッセージ | 説明 |
|---|---|---|---|
| 400 | InvalidRestoreSessionId | 復元セッション ID が無効、null、または空です。 | RestoreSessionId は存在しません。 |
| 403 | RestoreSessionActionNotAllowed | アクティブな復元セッションの削除を試みます。 | 復元セッションは下書き状態でのみ削除できます。 |
| 404 | RestoreSessionNotFound | 有効な ID が、セッションが見つかりません。 | 復元セッションを取得できません。 |
| 500 | IncompleteArtifactDeletion | サービスは、要求されたすべての成果物を削除できません。 | セッションを削除できません。もう一度お試しください。 |
復元セッション API エラーをアクティブ化する
このセクションのエラー コードは、次の API に適用されます。
次の表に、返される可能性のあるエラー コードと応答コードを示します。
| HTTP ステータス コード | エラー コード | エラー メッセージ | 説明 |
|---|---|---|---|
| 400 | InvalidRestoreSessionId | 復元セッション ID が無効、null、または空です。 | RestoreSessionId は存在しません。 |
| 403 | RestoreSessionActionNotAllowed | アクティブな復元セッションのアクティブ化を試みます。 | 復元セッションは下書き状態でのみアクティブ化できます。 |
| 404 | RestoreSessionNotFound | 有効な ID が、セッションが見つかりません。 | 復元セッションを取得できません。 |
| 500 | TooManyActiveRestoreSessions | 同時に 25 を超えるセッションのアクティブ化を試みます。 | 一時的なエラー: アクティブな復元セッションが多すぎます。 |
復元セッション API エラーの下に復元成果物を一覧表示する
このセクションのエラー コードは、次の API に適用されます。
次の表に、返される可能性のあるエラー コードと応答コードを示します。
| HTTP ステータス コード | エラー コード | エラー メッセージ | 説明 |
|---|---|---|---|
| 200 | UnknownError | 不明なエラーが発生したか、プロバイダー側エラーが発生しました。 | 不明なエラーが発生しました。 もう一度やり直してください。 問題が解決しない場合は、サポートにお問い合わせください。 |
| 200 | ArtifactNotFound | Restore Artifact が存在しません。 | 要求された復元成果物が復元用に見つかりませんでした。 |
| 200 | InvalidRestoreTime | 無効または範囲外の復元時間。 | 復元成果物は、このタイムスタンプに復元できません。指定された復元時間が無効であるか、保持期間を超えています。 |
| 200 | ArtifactCannotBeRestored | 復元成果物の状態では、復元は許可されません。 | 復元成果物が、復元をブロックしている保持ロックや TenantDivestiture などの予期しない状態にあります。 |
| 200 | DuplicateArtifactRestoreRequest | 同じ復元成果物の同時復元。 | 特定の復元成果物に対して進行中の復元が見つかりました。 完了するまで待ってから、もう一度お試しください。 |
| 400 | InvalidRestoreSessionId | 復元セッション ID が無効、null、または空です。 | RestoreSession ID が無効です。 |
包含ルール API エラーを作成する
このセクションのエラー コードは、次の API に適用されます。
次の表に、返される可能性のあるエラーコードと応答コードを示します。
| HTTP ステータス コード | エラー コード | エラー メッセージ | 説明 |
|---|---|---|---|
| 400 | InvalidInclusionRuleCreateRequest | 形式が正しくないか正しくないため、要求を処理できません。 | 作成要求が無効です。 |
ID API エラーによる包含ルールの取得
このセクションのエラー コードは、次の API に適用されます。
次の表に、返される可能性のあるエラーコードと応答コードを示します。
| HTTP ステータス コード | エラー コード | エラー メッセージ | 説明 |
|---|---|---|---|
| 400 | InvalidInclusionRuleId | 要求のルール ID が無効、null、または空です。 | ルール ID が無効です。 |
復元ポイント API エラーを取得する
このセクションのエラー コードは、次の API に適用されます。
次の表に、返される可能性のあるエラー コードと応答コードを示します。
| HTTP ステータス コード | エラー コード | エラー メッセージ | 説明 |
|---|---|---|---|
| 400 | FilterLengthExceeded | フィルターの長さが許可される制限を超えています。 | フィルターの長さが許可される制限を超えています。 |
| 400 | InvalidSearchRequest | 要求された日付の時間制限または保護ユニット ID が無効です。 | 復元ポイントの入力が無効です。 |
| 400 | InvalidProtectionUnitId | 要求の保護ユニット ID が無効です。 | 保護ユニット ID が無効です。 |
サービス API エラーを有効にする
このセクションのエラー コードは、次の API に適用されます。
次の表に、返される可能性のあるエラー コードと応答コードを示します。
| HTTP ステータス コード | エラー コード | エラー メッセージ | 説明 |
|---|---|---|---|
| 403 | UnableToReadBillingProfile | 課金プロファイル プロバイダーから課金プロファイルを読み取ることができません。 | 課金プロファイル プロバイダーから課金プロファイルを読み取ることができません。 |
| 402 | InvalidBillingProfile | プロバイダーから受信した課金プロファイルが無効です。 | プロバイダーから受信した課金プロファイルが無効です。 |
| 400 | InvalidAppOwnerTenantId | 所有しているテナント ID が見つかりません | ユーザーから受け取ったアプリ所有者テナント ID が無効です。 |