Réponses d’erreur de l’API de stockage de sauvegarde
Les partenaires peuvent utiliser l’API de stockage Sauvegarde Microsoft 365 dans Microsoft Graph pour créer leurs propres applications afin de gérer les sauvegardes. Votre application devient le contrôleur de stockage Sauvegarde Microsoft 365 dans le locataire où l’application est déployée.
En plus des erreurs générales qui s’appliquent à Microsoft Graph, certaines conditions d’erreur sont spécifiques à l’API stockage de sauvegarde. Cette rubrique fournit la liste des conditions d’erreur courantes que vous pouvez rencontrer lorsque vous utilisez l’API de stockage de sauvegarde.
Créer des erreurs d’API de stratégie de protection
Les codes d’erreur de cette section s’appliquent aux API suivantes :
- Créer exchangeProtectionPolicy
- Créer oneDriveForBusinessProtectionPolicy
- Créer sharePointProtectionPolicy
Le tableau suivant répertorie les codes d’erreur et de réponse possibles qui peuvent être retournés.
| Code d’état HTTP | Code d’erreur | Message d’erreur | Description |
|---|---|---|---|
| 400 | InvalidCreateRequest | Impossible de traiter la demande, car elle est incorrecte ou incorrecte. | La demande de création est null, non valide ou sa taille est trop grande. |
| 400 | InvalidDisplayName | Levée lorsque le nom d’affichage de la stratégie dépasse la limite de caractères ou est vide/null. | Vérifiez que la longueur du nom de la stratégie doit être > de 0 caractères et <= 1 024 caractères. |
| 400 | InvalidProtectionUnitId | Levée lorsque l’un des ID d’unité de protection n’est pas valide. | L’ID d’unité de protection n’est pas valide. |
| 413 | ProtectionUnitsLimitBreached | Levée lorsque l’utilisateur tente d’ajouter plus d’unités de protection que celles prises en charge dans une seule requête. | Le nombre d’unités de protection dans chaque requête ne doit pas dépasser 50. |
| 409 | PolicyCreationNotAllowed | Levée lorsqu’une stratégie de protection active existe déjà pour le service et que l’utilisateur tente de créer une stratégie. | Impossible de créer une stratégie. Une autre stratégie active existe déjà. |
| 500 | PolicySaveFailed | Levée lorsqu’une erreur temporaire se produit dans le service sauvegarde M365. | Une erreur inconnue s’est produite. Réessayez. |
Obtenir les erreurs de l’API de stratégie de protection
Les codes d’erreur de cette section s’appliquent à l’API suivante :
Le tableau suivant répertorie les codes d’erreur et de réponse possibles qui peuvent être retournés.
| Code d’état HTTP | Code d’erreur | Message d’erreur | Description |
|---|---|---|---|
| 400 | InvalidPolicyId | Levée lorsque l’ID de stratégie dans la requête n’est pas valide, null ou vide. | L’ID de stratégie n’est pas valide. |
| 404 | PolicyNotFound | Levée lorsque l’ID est valide mais que la stratégie n’existe pas. | Impossible d’obtenir la stratégie de protection. |
Erreurs de l’API de stratégie de protection des correctifs
Les codes d’erreur de cette section s’appliquent aux API suivantes :
- Mettre à jour exchangeProtectionPolicy
- Mettre à jour oneDriveForBusinessProtectionPolicy
- Mettre à jour sharePointProtectionPolicy
Le tableau suivant répertorie les codes d’erreur et de réponse possibles qui peuvent être retournés.
| Code d’état HTTP | Code d’erreur | Message d’erreur | Description |
|---|---|---|---|
| 200 | ProtectionUnitAlreadyExists | Il s’agit d’une erreur de niveau ProtectionUnit du correctif delta retournée lorsque la demande contient une unité de protection en double dans la liste déjà présente dans le service. | Erreur de niveau ProtectionUnit : ProtectionUnit existe déjà. |
| 200 | ProtectionUnitNotFound | Il s’agit d’une erreur de niveau ProtectionUnit du correctif delta retournée lorsque l’utilisateur demande la suppression de l’unité de protection, qui n’est pas présente dans le service. | Erreur de niveau ProtectionUnit : ProtectionUnit n’existe pas. |
| 400 | DuplicateProtectionUnitInList | Il s’agit d’une erreur au niveau de l’unité de protection retournée lorsque la requête contient des artefacts en double dans la liste. | Erreur au niveau de l’unité de protection : unité de protection dupliquée dans la liste. |
| 404 | PolicyNotFound | Levée lorsque l’ID est valide mais que la stratégie n’existe pas. | Impossible d’obtenir la stratégie de protection. |
Supprimer les erreurs d’API de stratégie de protection inactive
Les codes d’erreur de cette section s’appliquent à l’API suivante :
Le tableau suivant répertorie les codes d’erreur et de réponse possibles qui peuvent être retournés.
| Code d’état HTTP | Code d’erreur | Message d’erreur | Description |
|---|---|---|---|
| 400 | InvalidPolicyId | Levée lorsque l’ID de stratégie dans la requête n’est pas valide, null ou vide. | L’ID de stratégie est absent. |
| 404 | PolicyNotFound | Levée lorsque l’ID est valide mais que la stratégie n’existe pas. | Stratégie introuvable. |
| 403 | PolicyActionNotAllowed | Levée lorsque la stratégie n’est pas à l’état Inactif. | Impossible de supprimer la stratégie. Seule la stratégie dans les status inactifs peut être supprimée. |
Désactiver les erreurs de l’API de stratégie de protection active
Les codes d’erreur de cette section s’appliquent à l’API suivante :
Le tableau suivant répertorie les codes d’erreur et de réponse possibles qui peuvent être retournés.
| Code d’état HTTP | Code d’erreur | Message d’erreur | Description |
|---|---|---|---|
| 400 | InvalidPolicyId | Levée lorsque l’ID de stratégie dans la requête n’est pas valide, null ou vide. | L’ID de stratégie est absent. |
| 403 | PolicyActionNotAllowed | Levée lorsque la stratégie n’est pas à l’état actif. | La stratégie n’est pas dans un état correct. Attendez qu’il passe à l’état actif. |
| 404 | PolicyNotFound | Levée lorsque l’ID est valide mais que la stratégie n’existe pas. | Impossible d’obtenir la stratégie de protection. |
Erreurs d’API Activer la stratégie de protection inactive
Les codes d’erreur de cette section s’appliquent à l’API suivante :
Le tableau suivant répertorie les codes d’erreur et de réponse possibles qui peuvent être retournés.
| Code d’état HTTP | Code d’erreur | Message d’erreur | Description |
|---|---|---|---|
| 400 | InvalidPolicyId | Levée lorsque l’ID de stratégie dans la requête n’est pas valide, null ou vide. | L’ID de stratégie est absent. |
| 403 | PolicyActionNotAllowed | Levée lorsque la stratégie n’est pas à l’état Inactif. | Impossible d’activer la stratégie. La stratégie n’est pas dans un état correct. Vérifiez que la stratégie est à l’état Inactif. |
| 404 | PolicyNotFound | Levée lorsque l’ID est valide mais que la stratégie n’existe pas. | Impossible d’obtenir la stratégie de protection. |
Répertorier toutes les unités de protection sous une API de stratégie de protection
Les codes d’erreur de cette section s’appliquent aux API suivantes :
Le tableau suivant répertorie les codes d’erreur et de réponse possibles qui peuvent être retournés.
| Code d’état HTTP | Code d’erreur | Message d’erreur | Description |
|---|---|---|---|
| 400 | InvalidPolicyId | L’ID de stratégie n’est pas valide, null ou vide. | L’ID de stratégie n’est pas valide. |
| 400 | FilterLengthExceeded | Cette erreur se produit lorsque le client tente d’envoyer un trop grand nombre de filtres ou de requêtes à la fois dans une même requête, y compris les requêtes de filtre « et » et « ou » combinées. | La longueur du filtre dépasse la limite autorisée. |
| 400 | InvalidProtectionUnitId | L’ID d’unité de protection n’est pas valide ou n’est pas valide. | ID d’unité de protection non valide. |
| 404 | PolicyNotFound | La stratégie n’existe pas ou est introuvable. | Impossible d’obtenir la stratégie de protection. |
Obtenir les erreurs de l’API d’unité de protection
Les codes d’erreur de cette section s’appliquent à l’API suivante :
Le tableau suivant répertorie les codes d’erreur et de réponse possibles qui peuvent être retournés.
| Code d’état HTTP | Code d’erreur | Message d’erreur | Description |
|---|---|---|---|
| 200 | UnknownError | Une erreur inconnue s’est produite. | Une erreur inconnue s’est produite. Réessayez. Si le problème persiste, contactez le support technique. |
| 200 | ProtectionUnitNotFound | L’unité de protection n’existe pas. | L’unité de protection demandée n’existe pas, est supprimée ou introuvable. Vérifiez à nouveau l’ID de l’unité de protection, puis réessayez. |
| 200 | InvalidArtifactId | ID d’unité de protection non valide ou inexistant. | L’unité de protection à supprimer est introuvable. |
| 200 | QuotaExceeded | Dépassement du quota de taille de sauvegarde (spécifiquement pour Exo). | Vous avez dépassé le quota de sauvegarde. |
| 400 | InvalidProtectionUnitId | L’ID d’unité de protection n’est pas valide ou n’est pas valide. | ID d’unité de protection non valide. |
Créer des erreurs d’API de session de restauration
Les codes d’erreur de cette section s’appliquent aux API suivantes :
Le tableau suivant répertorie les codes d’erreur et de réponse possibles qui peuvent être retournés.
| Code d’état HTTP | Code d’erreur | Message d’erreur | Description |
|---|---|---|---|
| 400 | InvalidPathType | PathType (new/in-place) n’est pas connu pour les artefacts. | Le type de chemin de restauration n’est pas présent. |
| 400 | InvalidArtifactRequest | Liste d’artefacts de restauration vide ou null. | Il doit y avoir au moins un artefact de restauration. |
| 400 | InvalidRestorePoint | Point de restauration fourni non valide. | L’ID du point de restauration n’est pas valide ou est vide. |
| 400 | DifferentRestoreDestinationType | Différents types de destination pour les artefacts dans la demande. | Type de destination de restauration différent. |
| 413 | RestoreArtifactsLimitBreached | La demande a dépassé la limite maximale des artefacts. | La limite de restauration des artefacts est dépassée. |
| 400 | DuplicateArtifactInList | Dupliquer les artefacts dans la liste. | L’artefact de restauration demandé est déjà présent. |
Obtenir les erreurs de l’API de session de restauration
Les codes d’erreur de cette section s’appliquent à l’API suivante :
Le tableau suivant répertorie les codes d’erreur et de réponse possibles qui peuvent être retournés.
| Code d’état HTTP | Code d’erreur | Message d’erreur | Description |
|---|---|---|---|
| 400 | InvalidRestoreSessionId | L’ID de session de restauration n’est pas valide, null ou vide. | L’ID de session de restauration est absent. |
| 404 | RestoreSessionNotFound | ID valide mais session introuvable. | Session de restauration introuvable. |
Corriger les erreurs de l’API de session de restauration
Les codes d’erreur de cette section s’appliquent aux API suivantes :
- Mettre à jour exchangeRestoreSession
- Mettre à jour oneDriveForBusinessRestoreSession
- Mettre à jour sharePointRestoreSession
Le tableau suivant répertorie les codes d’erreur et de réponse possibles qui peuvent être retournés.
| Code d’état HTTP | Code d’erreur | Message d’erreur | Description |
|---|---|---|---|
| 400 | InvalidRestoreSessionId | L’ID de session de restauration n’est pas valide, null ou vide. | L’ID de session de restauration est absent. |
| 400 | InvalidPatchRequest | Impossible de traiter la demande, car elle est incorrecte ou incorrecte. | Impossible de traiter la demande, car elle est incorrecte ou incorrecte. |
| 400 | InvalidRestorePoint | Point de restauration fourni non valide. | Le point de restauration n’est pas valide. |
| 400 | RestoreArtifactsLimitBreached | Dépassement de la limite maximale d’artefacts de 50 pour une seule requête. | La limite de restauration des artefacts est dépassée. |
| 400 | InvalidArtifactRequest | Liste d’artefacts de restauration vide ou null. | Les artefacts de restauration ont la valeur Null. |
| 403 | RestoreSessionActionNotAllowed | Tentative de mise à jour corrective de la session de restauration active. | La session de restauration ne peut être corrigée qu’à l’état Brouillon. |
| 404 | RestoreSessionNotFound | ID valide mais session introuvable. | Impossible d’obtenir la session de restauration. |
| 400 | DuplicateArtifactInList | Dupliquer les artefacts dans la requête. | L’artefact de restauration demandé est déjà présent. |
Supprimer les erreurs de l’API de session de restauration
Les codes d’erreur de cette section s’appliquent à l’API suivante :
Le tableau suivant répertorie les codes d’erreur et de réponse possibles qui peuvent être retournés.
| Code d’état HTTP | Code d’erreur | Message d’erreur | Description |
|---|---|---|---|
| 400 | InvalidRestoreSessionId | L’ID de session de restauration n’est pas valide, null ou vide. | RestoreSessionId est absent. |
| 403 | RestoreSessionActionNotAllowed | Tentative de suppression de la session de restauration active. | La session de restauration ne peut être supprimée qu’à l’état Brouillon. |
| 404 | RestoreSessionNotFound | ID valide mais session introuvable. | Impossible d’obtenir la session de restauration. |
| 500 | IncompleteArtifactDeletion | Le service ne peut pas supprimer tous les artefacts demandés. | Impossible de supprimer la session, réessayez. |
Erreurs d’activation de l’API de session de restauration
Les codes d’erreur de cette section s’appliquent à l’API suivante :
Le tableau suivant répertorie les codes d’erreur et de réponse possibles qui peuvent être retournés.
| Code d’état HTTP | Code d’erreur | Message d’erreur | Description |
|---|---|---|---|
| 400 | InvalidRestoreSessionId | L’ID de session de restauration n’est pas valide, null ou vide. | RestoreSessionId est absent. |
| 403 | RestoreSessionActionNotAllowed | Essayez d’activer la session de restauration active. | La session de restauration ne peut être activée qu’à l’état Brouillon. |
| 404 | RestoreSessionNotFound | ID valide mais session introuvable. | Impossible d’obtenir la session de restauration. |
| 500 | TooManyActiveRestoreSessions | Essayez d’activer plus de 25 sessions simultanément. | Erreur temporaire : Trop de sessions de restauration actives. |
Répertorier les artefacts de restauration sous une API de session de restauration
Les codes d’erreur de cette section s’appliquent aux API suivantes :
Le tableau suivant répertorie les codes d’erreur et de réponse possibles qui peuvent être retournés.
| Code d’état HTTP | Code d’erreur | Message d’erreur | Description |
|---|---|---|---|
| 200 | UnknownError | Une erreur inconnue s’est produite ou une erreur côté fournisseur. | Une erreur inconnue s’est produite. Réessayez. Si le problème persiste, contactez le support technique. |
| 200 | ArtifactNotFound | L’artefact de restauration n’existe pas. | L’artefact de restauration demandé n’a pas été trouvé pour la restauration. |
| 200 | InvalidRestoreTime | Heure de restauration non valide ou hors limites. | L’artefact de restauration ne peut pas être restauré dans cet horodatage, l’heure de restauration fournie n’est pas valide ou au-delà de la période de rétention. |
| 200 | ArtifactCannotBeRestored | Restaurer l’état de l’artefact n’autorise pas la restauration. | L’artefact de restauration est dans un état inattendu tel que le verrou de préservation ou TenantDivestiture qui bloque la restauration. |
| 200 | DuplicateArtifactRestoreRequest | Restauration simultanée du même artefact de restauration. | Une restauration en cours a été trouvée pour l’artefact de restauration donné. Veuillez patienter jusqu’à sa fin et réessayer. |
| 400 | InvalidRestoreSessionId | L’ID de session de restauration n’est pas valide, null ou vide. | L’ID RestoreSession n’est pas valide. |
Créer des erreurs d’API de règle d’inclusion
Les codes d’erreur de cette section s’appliquent à l’API suivante :
Le tableau suivant répertorie les erreurs et le code de réponse possibles qui peuvent être retournés.
| Code d’état HTTP | Code d’erreur | Message d’erreur | Description |
|---|---|---|---|
| 400 | InvalidInclusionRuleCreateRequest | Impossible de traiter la demande, car elle est incorrecte ou incorrecte. | Demande de création non valide. |
Obtenir la règle d’inclusion par les erreurs d’API d’ID
Les codes d’erreur de cette section s’appliquent à l’API suivante :
Le tableau suivant répertorie les erreurs et le code de réponse possibles qui peuvent être retournés.
| Code d’état HTTP | Code d’erreur | Message d’erreur | Description |
|---|---|---|---|
| 400 | InvalidInclusionRuleId | L’ID de règle dans la requête n’est pas valide, null ou vide. | L’ID de règle n’est pas valide. |
Obtenir les erreurs de l’API de point de restauration
Les codes d’erreur de cette section s’appliquent aux API suivantes :
Le tableau suivant répertorie les codes d’erreur et de réponse possibles qui peuvent être retournés.
| Code d’état HTTP | Code d’erreur | Message d’erreur | Description |
|---|---|---|---|
| 400 | FilterLengthExceeded | La longueur du filtre dépasse la limite autorisée. | La longueur du filtre dépasse la limite autorisée. |
| 400 | InvalidSearchRequest | La limite de date et heure demandée ou l’ID d’unité de protection n’est pas valide. | L’entrée du point de restauration n’est pas valide. |
| 400 | InvalidProtectionUnitId | L’ID d’unité de protection dans la requête n’est pas valide. | ID d’unité de protection non valide. |
Erreurs d’activation de l’API de service
Les codes d’erreur de cette section s’appliquent à l’API suivante :
Le tableau suivant répertorie les codes d’erreur et de réponse possibles qui peuvent être retournés.
| Code d’état HTTP | Code d’erreur | Message d’erreur | Description |
|---|---|---|---|
| 403 | UnableToReadBillingProfile | Impossible de lire le profil de facturation à partir du fournisseur de profil de facturation. | Impossible de lire le profil de facturation à partir du fournisseur de profil de facturation. |
| 402 | InvalidBillingProfile | Profil de facturation non valide reçu du fournisseur. | Profil de facturation non valide reçu du fournisseur. |
| 400 | InvalidAppOwnerTenantId | ID de locataire propriétaire introuvable | ID de locataire du propriétaire de l’application non valide reçu de l’utilisateur. |