Respostas de erro da API de Armazenamento de Backup

Os parceiros podem usar a API de armazenamento de backup do Microsoft 365 no Microsoft Graph para criar seus próprios aplicativos para gerenciar backups. Seu aplicativo se torna o controlador de Armazenamento de Backup do Microsoft 365 no locatário em que o aplicativo está implantado.

Além dos erros gerais que se aplicam ao Microsoft Graph, algumas condições de erro são específicas para a API de Armazenamento de Backup. Este tópico fornece uma lista de condições de erro comuns que você pode encontrar ao usar a API de Armazenamento de Backup.

Criar erros de API de política de proteção

Os códigos de erro nesta seção se aplicam às seguintes APIs:

A tabela a seguir lista os possíveis códigos de erro e resposta que podem ser retornados.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidCreateRequest Não é possível processar a solicitação porque ela está malformada ou incorreta. Criar solicitação é nula, inválida ou seu tamanho é muito grande.
400 InvalidDisplayName Lançada quando o nome de exibição da política excede o limite de caracteres ou é vazio/nulo. Verifique se o comprimento do nome da política deve ser > 0 caracteres e <= 1024 caracteres.
400 InvalidProtectionUnitId Lançada quando uma das IDs de Unidade de Proteção é inválida. A ID da Unidade de Proteção é inválida.
413 ProtectionUnitsLimitBreached Lançada quando o usuário tenta adicionar mais Unidades de Proteção do que as com suporte em uma solicitação. O número de Unidades de Proteção em cada solicitação não deve exceder 50.
409 PolicyCreationNotAllowed Lançada quando já existe uma política de proteção ativa para o serviço e o usuário tenta criar uma nova política. Não é possível criar a Política. Já existe outra política ativa.
409 ProtectionUnitAlreadyExists O ArtifactId não está qualificado para proteção porque já está protegido pela PolicyId da política. Lançada quando o artefato já está protegido por outra política.
500 PolicySaveFailed Gerado quando ocorre um erro transitório no serviço de Backup do M365. Ocorreu um erro desconhecido. Tente novamente.

Obter erros de API de política de proteção

Os códigos de erro nesta seção se aplicam à seguinte API:

A tabela a seguir lista os possíveis códigos de erro e resposta que podem ser retornados.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidPolicyId Lançada quando a ID da Política na solicitação é inválida, nula ou vazia. A ID da política é inválida.
404 PolicyNotFound Lançada quando a ID é válida, mas a política não existe. Não é possível obter a Política de Proteção.

Erros de API da política de proteção contra patches

Os códigos de erro nesta seção se aplicam às seguintes APIs:

A tabela a seguir lista os possíveis códigos de erro e resposta que podem ser retornados.

Código de status de HTTP Código de erro Mensagem de erro Descrição
200 ProtectionUnitNotFound Este é um patch delta de nível ProtectionUnit retornado quando o usuário solicita a remoção da Unidade de Proteção, que não está presente no serviço. Erro de nível de ProtectionUnit: ProtectionUnit não existe.
200 ProtectionUnitAlreadyExists O ArtifactId não está qualificado para proteção porque já está protegido pela PolicyId da política. Lançada quando o artefato já está protegido por outra política.
400 DuplicateProtectionUnitInList Esse é um erro de nível de Unidade de Proteção retornado quando a solicitação tem artefatos duplicados na lista. Erro de nível da Unidade de Proteção: Unidade de Proteção Duplicada na lista.
400 ProtectionUnitActionNotAllowed O artefato com a ID da unidade de proteção especificada não pode ser removido, pois é protegido por uma regra dinâmica. As unidades de proteção protegidas por meio de regras dinâmicas não podem ser removidas manualmente.
404 PolicyNotFound Lançada quando a ID é válida, mas a política não existe. Não é possível obter a Política de Proteção.

Excluir erros de API da política de proteção inativa

Os códigos de erro nesta seção se aplicam à seguinte API:

A tabela a seguir lista os possíveis códigos de erro e resposta que podem ser retornados.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidPolicyId Lançada quando a ID da política na solicitação é inválida, nula ou vazia. A ID da política está ausente.
404 PolicyNotFound Lançada quando a ID é válida, mas a política não existe. Política não encontrada.
403 PolicyActionNotAllowed Lançada quando a política não está no estado Inativo. Não é possível excluir a política. Somente a política no status Inativo pode ser excluída.

Desativar erros da API da política de proteção ativa

Os códigos de erro nesta seção se aplicam à seguinte API:

A tabela a seguir lista os possíveis códigos de erro e resposta que podem ser retornados.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidPolicyId Lançada quando a ID da política na solicitação é inválida, nula ou vazia. A ID da política está ausente.
403 PolicyActionNotAllowed Lançada quando a política não está em estado ativo. A política não está em estado correto. Aguarde até que ele se mova para o estado ativo.
404 PolicyNotFound Lançada quando a ID é válida, mas a política não existe. Não é possível obter a Política de Proteção.

Ativar política de proteção inativa Erros de API

Os códigos de erro nesta seção se aplicam à seguinte API:

A tabela a seguir lista os possíveis códigos de erro e resposta que podem ser retornados.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidPolicyId Lançada quando a ID da política na solicitação é inválida, nula ou vazia. A ID da política está ausente.
403 PolicyActionNotAllowed Lançada quando a política não está no estado Inativo. Não é possível ativar a política. A política não está em estado correto. Verifique se a política está no estado Inativo.
404 PolicyNotFound Lançada quando a ID é válida, mas a política não existe. Não é possível obter a Política de Proteção.

Listar todas as unidades de proteção em uma política de proteção Erros de API

Os códigos de erro nesta seção se aplicam às seguintes APIs:

A tabela a seguir lista os possíveis códigos de erro e resposta que podem ser retornados.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidPolicyId A ID da política é inválida, nula ou vazia. A ID da política é inválida.
400 FilterLengthExceeded Esse erro ocorre quando o cliente tenta enviar muitos filtros ou consultas de uma só vez em uma única solicitação, incluindo as consultas de filtro "and" e "or" combinadas. O comprimento do filtro excede o limite permitido.
400 InvalidProtectionUnitId A ID da unidade de proteção é inválida ou é uma ID vazia. ID da Unidade de Proteção inválida.
404 PolicyNotFound A política não existe ou não pode ser encontrada. Não é possível obter a Política de Proteção.

Obter erros de API da unidade de proteção

Os códigos de erro nesta seção se aplicam à seguinte API:

A tabela a seguir lista os possíveis códigos de erro e resposta que podem ser retornados.

Código de status de HTTP Código de erro Mensagem de erro Descrição
200 UnknownError Ocorreu um erro desconhecido. Ocorreu um erro desconhecido. Tente novamente. Se o problema persistir, entre em contato com o suporte.
200 ProtectionUnitNotFound Unidade de Proteção não existe. A Unidade de Proteção Solicitada não existe, foi excluída ou não pode ser encontrada. Verifique novamente a ID da Unidade de Proteção e tente novamente.
200 InvalidArtifactId ID da Unidade de Proteção inválida ou inexistente. A Unidade de Proteção a ser removida não foi encontrada.
200 QuotaExceeded Exceder a cota de tamanho de backup (especificamente para Exo). Você excedeu a cota de backup.
400 InvalidProtectionUnitId A ID da unidade de proteção é inválida ou é uma ID vazia. ID da Unidade de Proteção inválida.

Criar restauração da sessão Erros de API

Os códigos de erro nesta seção se aplicam às seguintes APIs:

A tabela a seguir lista os possíveis códigos de erro e resposta que podem ser retornados.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidPathType PathType (novo/in-loco) não é conhecido por artefatos. O tipo de caminho de restauração não está presente.
400 InvalidArtifactRequest Lista de artefatos de restauração vazia ou nula. Deve haver pelo menos um artefato de restauração.
400 InvalidRestorePoint Ponto de restauração inválido fornecido. A ID do ponto de restauração é inválida ou está vazia.
400 DifferentRestoreDestinationType Diferentes tipos de destino para artefatos na solicitação. Tipo de destino de restauração diferente.
413 RestoreArtifactsLimitBreached Limite máximo de artefatos de solicitação excedida. O limite da Restauração de Artefatos foi violado.
400 DuplicateArtifactInList Duplicar artefatos na lista. O artefato de restauração solicitado já está presente.

Obter erros de API da sessão de restauração

Os códigos de erro nesta seção se aplicam à seguinte API:

A tabela a seguir lista os possíveis códigos de erro e resposta que podem ser retornados.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidRestoreSessionId Restaurar ID de sessão inválida, nula ou vazia. A ID da Sessão de Restauração está ausente.
404 RestoreSessionNotFound ID válida, mas sessão não encontrada. Restaurar sessão não encontrado.

Erros de API da sessão de restauração de patch

Os códigos de erro nesta seção se aplicam às seguintes APIs:

A tabela a seguir lista os possíveis códigos de erro e resposta que podem ser retornados.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidRestoreSessionId Restaurar ID de sessão inválida, nula ou vazia. A ID da Sessão de Restauração está ausente.
400 InvalidPatchRequest Não é possível processar a solicitação porque ela está malformada ou incorreta. Não é possível processar a solicitação porque ela está malformada ou incorreta.
400 InvalidRestorePoint Ponto de restauração inválido fornecido. O ponto de restauração é inválido.
400 RestoreArtifactsLimitBreached O limite máximo de artefatos foi excedido de 50 para uma única solicitação. O limite da Restauração de Artefatos foi violado.
400 InvalidArtifactRequest Lista de artefatos de restauração vazia ou nula. Os artefatos de restauração são nulos.
403 RestoreSessionActionNotAllowed Tente corrigir a sessão de restauração ativa. A sessão de restauração só pode ser corrigida no estado Rascunho.
404 RestoreSessionNotFound ID válida, mas sessão não encontrada. Não é possível obter a sessão de restauração.
400 DuplicateArtifactInList Artefatos duplicados na solicitação. O artefato de restauração solicitado já está presente.

Excluir restauração de erros da API da sessão

Os códigos de erro nesta seção se aplicam à seguinte API:

A tabela a seguir lista os possíveis códigos de erro e resposta que podem ser retornados.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidRestoreSessionId Restaurar ID de sessão inválida, nula ou vazia. RestoreSessionId está ausente.
403 RestoreSessionActionNotAllowed Tente excluir a sessão de restauração ativa. A sessão de restauração só pode ser excluída no estado Rascunho.
404 RestoreSessionNotFound ID válida, mas sessão não encontrada. Não é possível obter a sessão de restauração.
500 IncompleteArtifactDeletion O serviço não pode excluir todos os artefatos solicitados. Não é possível excluir a sessão, tente novamente.

Ativar restauração da sessão Erros de API

Os códigos de erro nesta seção se aplicam à seguinte API:

A tabela a seguir lista os possíveis códigos de erro e resposta que podem ser retornados.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidRestoreSessionId Restaurar ID de sessão inválida, nula ou vazia. RestoreSessionId está ausente.
403 RestoreSessionActionNotAllowed Tente ativar a sessão de restauração ativa. A sessão de restauração só pode ser ativada no estado Rascunho.
404 RestoreSessionNotFound ID válida, mas sessão não encontrada. Não é possível obter a sessão de restauração.
500 TooManyActiveRestoreSessions Tente ativar mais de 25 sessões simultaneamente. Erro temporário: muitas sessões de restauração ativas.

Listar artefato de restauração em uma sessão de restauração Erros de API

Os códigos de erro nesta seção se aplicam às seguintes APIs:

A tabela a seguir lista os possíveis códigos de erro e resposta que podem ser retornados.

Código de status de HTTP Código de erro Mensagem de erro Descrição
200 UnknownError Ocorreu um erro desconhecido ou um erro do lado do provedor. Ocorreu um erro desconhecido. Tente novamente. Se o problema persistir, entre em contato com o suporte.
200 ArtifactNotFound Artefato de Restauração não existe. O artefato de restauração solicitado não foi encontrado para restauração.
200 InvalidRestoreTime Tempo de restauração inválido ou fora dos limites. Não é possível restaurar o artefato para este carimbo de data/hora, o tempo de restauração fornecido é inválido ou está além do período de retenção.
200 ArtifactCannotBeRestored A restauração do estado do artefato não permite a restauração. O artefato de restauração está em um estado inesperado, como um bloqueio de preservação ou TenantDivestiture, que está bloqueando a restauração.
200 DuplicateArtifactRestoreRequest Restauração simultânea do mesmo artefato de restauração. Uma restauração em andamento foi encontrada para o artefato de restauração fornecido. Aguarde até a conclusão e tente novamente.
400 InvalidRestoreSessionId Restaurar ID de sessão inválida, nula ou vazia. A ID de RestoreSession é inválida.

Criar erros de API de regra de inclusão

Os códigos de erro nesta seção se aplicam à seguinte API:

A tabela a seguir lista os possíveis códigos de erro e resposta que podem ser retornados.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidInclusionRuleCreateRequest Não é possível processar a solicitação porque ela está malformada ou incorreta. Solicitação de criação inválida.
400 InvalidRuleExpression O valor não pode ser nulo ou expressão inválida. A expressão não é válida e não pode ser analisada.
413 InvalidRuleExpressionGroupLimitExceeded Não é permitida a expressão de regra que contenha mais de 100 IDs de grupo. A expressão contém mais IDs de grupo do que o permitido pelo limite imposto.

Atualizar erros de API da regra de inclusão

Os códigos de erro nesta seção se aplicam às seguintes APIs:

A tabela a seguir lista os possíveis códigos de erro e resposta que podem ser retornados.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidProtectionRulePatchRequest Não há suporte para o parâmetro isAutoApplyEnabled em uma solicitação de patch. O parâmetro isAutoApplyEnabled pode ser fornecido somente no momento da criação. A conversão entre uma regra estática e uma regra dinâmica e vice-versa não é permitida.
400 InvalidProtectionRuleStatusForUpdation A operação de atualização não é permitida no estado atual. Estado inválido para invocar a operação de atualização.
400 InvalidRuleExpression O valor não pode ser nulo ou expressão inválida A expressão não é válida e não pode ser analisada.
400 PatchNotAllowedForStaticRule A operação de patch não é permitida para uma regra estática. Solicitação de atualização inválida.
404 ProtectionRuleNotFound A regra de proteção com a ID especificada não existe. A ID de regra determinada está incorreta ou a regra foi excluída.
413 InvalidRuleExpressionGroupLimitExceeded Não é permitida a expressão de regra que contenha mais de 100 IDs de grupo. A expressão contém mais IDs de grupo do que o permitido pelo limite imposto.
422 InvalidProtectionRuleStatusForDynamicRuleEdit A operação de patch não é permitida no estado atual. A operação de patch não é permitida no deleteRequested estado.

Excluir e desproteger erros de API da regra de inclusão

Os códigos de erro nesta seção se aplicam às seguintes APIs:

A tabela a seguir lista os possíveis códigos de erro e resposta que podem ser retornados.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidInclusionRuleId A ID da regra na solicitação é inválida, nula ou vazia. A ID da regra é inválida.
404 ProtectionRuleNotFound A regra de proteção com a ID especificada não existe. A ID de regra determinada está incorreta ou a regra foi excluída.
422 InvalidProtectionRuleStatusForDynamicRuleDeleteAndUnprotectAll A operação deleteAndUnprotect não é permitida no estado atual. Estado inválido para invocar a ação deleteAndUnprotect .

Executar erros da API de regra de inclusão

Os códigos de erro nesta seção se aplicam às seguintes APIs:

A tabela a seguir lista os possíveis códigos de erro e resposta que podem ser retornados.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidInclusionRuleId A ID da regra na solicitação é inválida, nula ou vazia. A ID da regra é inválida.
400 ProtectionRuleActionNotAllowed A ação de execução não é permitida para a regra de proteção. Estado inválido para invocar a ação de execução.
400 RunNotAllowedForDynamicRule A operação de execução não é permitida para a regra dinâmica. Operação inválida para regras dinâmicas.
404 ProtectionRuleNotFound A regra de proteção com a ID especificada não existe. A ID de regra determinada está incorreta ou a regra foi excluída.

Obter regra de inclusão por ID Erros de API

Os códigos de erro nesta seção se aplicam à seguinte API:

A tabela a seguir lista os possíveis códigos de erro e resposta que podem ser retornados.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidInclusionRuleId A ID da regra na solicitação é inválida, nula ou vazia. A ID da regra é inválida.
404 ProtectionRuleNotFound A regra de proteção com a ID especificada não existe. A ID de regra determinada está incorreta ou a regra foi excluída.

Excluir regra de inclusão por ID Erros de API

Os códigos de erro nesta seção se aplicam à seguinte API:

A tabela a seguir lista os possíveis códigos de erro e resposta que podem ser retornados.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidInclusionRuleId A ID da regra na solicitação é inválida, nula ou vazia. A ID da regra é inválida.
400 InvalidProtectionRuleStatusForDeletion A operação de exclusão não é permitida no estado atual. Estado inválido para invocar a operação de exclusão.
404 ProtectionRuleNotFound A regra de proteção com a ID especificada não existe. A ID de regra determinada está incorreta ou a regra foi excluída.
422 InvalidProtectionRuleStatusForDynamicRuleDeletion A operação de exclusão não é permitida no estado atual. Estado inválido para invocar a operação de exclusão em uma regra dinâmica.

Obter erros de API do ponto de restauração

Os códigos de erro nesta seção se aplicam às seguintes APIs:

A tabela a seguir lista os possíveis códigos de erro e resposta que podem ser retornados.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 FilterLengthExceeded O comprimento do filtro excede o limite permitido. O comprimento do filtro excede o limite permitido.
400 InvalidSearchRequest A data, o limite de hora ou a ID da unidade de proteção solicitados são inválidos. A entrada do ponto de restauração é inválida.
400 InvalidProtectionUnitId A ID da unidade de proteção na solicitação é inválida. ID da Unidade de proteção inválida.

Habilitar erros da API de serviço

Os códigos de erro nesta seção se aplicam à seguinte API:

A tabela a seguir lista os possíveis códigos de erro e resposta que podem ser retornados.

Código de status de HTTP Código de erro Mensagem de erro Descrição
403 UnableToReadBillingProfile Não é possível ler o perfil de cobrança do provedor de perfil de cobrança. Não é possível ler o perfil de cobrança do provedor de perfil de cobrança.
402 InvalidBillingProfile Perfil de cobrança inválido recebido do provedor. Perfil de cobrança inválido recebido do provedor.
400 InvalidAppOwnerTenantId ID de locatário proprietária não encontrada ID de locatário do proprietário do aplicativo inválida recebida do usuário.

Criar solicitações de adição em massa para restaurar erros da API de artefatos

Os códigos de erro nesta seção se aplicam às seguintes APIs:

A tabela a seguir lista os possíveis códigos de erro e resposta que podem ser retornados.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidBulkRestoreArtifactId A ID da solicitação de restauração em massa é inválida. GUID inválido fornecido no URI.
400 BulkRestoreInvalidCreateRequest BulkRestoreCreateRequest é null. A solicitação de criação é nula ou inválida.
400 BulkRestoreRestorationResourcesCountExceedsLimit Limite de entrada de restauração em massa excedido. O tamanho da entrada é muito grande.
400 BulkRestoreInvalidCreateRequestSiteUrl A URL da Web do site de restauração em massa é inválida. A URL do site é nula, vazia ou está em um formato incorreto.
400 BulkRestoreInvalidCreateRequestUserEmail O email do usuário de restauração em massa é inválido. Email nulo, vazio ou com formato incorreto.

Obter solicitações de adição em massa para restaurar erros de API de artefatos

O código de erro nesta seção se aplica às seguintes APIs:

A tabela a seguir lista os possíveis códigos de erro e resposta que podem ser retornados.

Código de status de HTTP Código de erro Mensagem de erro Descrição
404 BulkRestoreArtifactsNotFound Nenhum item bulkRestoreArtifact com a bulkRestoreArtifactId fornecida. Nenhum restoreArtifactBulkAdditionRequest associado ao bulkRestoreArtifactId fornecido no URI.

Excluir solicitações de adição em massa para restaurar artefatos Erros de API

O código de erro nesta seção se aplica às seguintes APIs:

A tabela a seguir lista os possíveis códigos de erro e resposta que podem ser retornados.

Código de status de HTTP Código de erro Mensagem de erro Descrição
403 InvalidStateForBulkRequestDeletion A validação falha quando o tipo de serviço da sessão de restauração e da solicitação de criação são diferentes. Uma solicitação em massa só pode ser excluída quando seu status for completed ou completedWithErrors.

Criar unidades de exclusão Trabalho de adição em massa Erros de API

Os códigos de erro nesta seção se aplicam às seguintes APIs:

A tabela a seguir lista os possíveis códigos de erro e resposta que podem ser retornados.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 BulkExclusionInvalidCreateRequest BulkExclusionCreateRequest é null. A solicitação de criação é nula ou inválida.
400 BulkExclusionInputLimitExceeded Limite de entrada de exclusão em massa excedido. O tamanho da entrada é muito grande.

Listar erros de API de unidades de exclusão

Os códigos de erro nesta seção se aplicam às seguintes APIs:

A tabela a seguir lista os possíveis códigos de erro e resposta que podem ser retornados.

Código de status de HTTP Código de erro Mensagem de erro Descrição
404 PolicyNotFoundForExclusionUnitsBulkAdditionJob A política não existe ou não pode ser encontrada. Não é possível obter a política de proteção.

Erros do PowerShell

Os códigos de erro nesta seção se aplicam às seguintes APIs quando elas são chamadas no Microsoft Graph PowerShell:

A tabela a seguir lista os possíveis códigos de erro e resposta que podem ser retornados.

Código de status de HTTP Código de erro Mensagem de erro Descrição
403 Proibido Método não permitido para aplicativos internos conhecidos e permitidos. A solicitação é proibida quando chamada do Microsoft Graph PowerShell porque essas APIs destinam-se ao uso por aplicativos registrados do Controlador de Backup. O SDK do Microsoft Graph PowerShell não é um cliente compatível com essas operações.
  • Last updated on