Compartilhar via

Respostas de erro da API de Armazenamento de Cópias de Segurança

Os parceiros podem utilizar a API de Armazenamento Backup do Microsoft 365 no Microsoft Graph para criar as suas próprias aplicações para gerir cópias de segurança. A sua aplicação torna-se o controlador de Armazenamento Backup do Microsoft 365 no inquilino onde a aplicação é implementada.

Além dos erros gerais que se aplicam ao Microsoft Graph, algumas condições de erro são específicas da API de Armazenamento de Cópias de Segurança. Este tópico fornece uma lista de condições de erro comuns que poderá encontrar quando utiliza a API de Armazenamento de Cópias de Segurança.

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

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

A tabela seguinte lista os códigos de erro e resposta possíveis que podem ser devolvidos.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidCreateRequest Não é possível processar o pedido porque está incorreto ou incorreto. O pedido de criação é nulo, é inválido ou o respetivo tamanho é demasiado grande.
400 InvalidDisplayName Emitido quando o nome a apresentar da política excede o limite de carateres ou está vazio/nulo. Certifique-se de que o comprimento do nome da política deve ser > 0 carateres e <= 1024 carateres.
400 InvalidProtectionUnitId Emitido quando um dos IDs da Unidade de Proteção é inválido. O ID da Unidade de Proteção é inválido.
413 ProtectionUnitsLimitBreached Quando o utilizador tenta adicionar mais Unidades de Proteção do que as suportadas num pedido. O número de Unidades de Proteção em cada pedido não pode exceder 50.
409 PolicyCreationNotAllowed Lançada quando já existe uma política de proteção ativa para o serviço e o utilizador tenta criar uma nova política. Não é possível criar a Política. Já existe outra Política ativa.
409 ProtectionUnitAlreadyExists Artifact ArtifactId não é elegível para proteção porque já está protegido no policyId. Emitido quando o artefacto já está protegido sob outra política.
500 PolicySaveFailed Gerado quando ocorre um erro transitório no serviço de Cópia de Segurança M365. Ocorreu um erro desconhecido. Tente novamente.

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

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

A tabela seguinte lista os códigos de erro e resposta possíveis que podem ser devolvidos.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidPolicyId Emitido quando o ID da Política no pedido é inválido, nulo ou está vazio. O ID da Política é inválido.
404 PolicyNotFound Quando o ID é válido, mas a política não existe. Não é possível obter a Política de Proteção.

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

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

A tabela seguinte lista os códigos de erro e resposta possíveis que podem ser devolvidos.

Código de status de HTTP Código de erro Mensagem de erro Descrição
200 ProtectionUnitNotFound Este é um erro de nível ProtectionUnit de patch delta devolvido quando o utilizador pede para remover a Unidade de Proteção, que não está presente no serviço. Erro ao nível de ProtectionUnit: ProtectionUnit não existe.
200 ProtectionUnitAlreadyExists Artifact ArtifactId não é elegível para proteção porque já está protegido no policyId. Emitido quando o artefacto já está protegido sob outra política.
400 DuplicateProtectionUnitInList Este é um erro ao nível da Unidade de Proteção devolvido quando o pedido tem artefactos duplicados na lista. Erro ao nível da Unidade de Proteção: Unidade de Proteção Duplicada na lista.
400 ProtectionUnitActionNotAllowed O artefacto com o ID da unidade de proteção especificado não pode ser removido, uma vez que está protegido por uma regra dinâmica. As unidades de proteção protegidas através de regras dinâmicas não podem ser removidas manualmente.
404 PolicyNotFound Quando o ID é válido, mas a política não existe. Não é possível obter a Política de Proteção.

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

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

A tabela seguinte lista os códigos de erro e resposta possíveis que podem ser devolvidos.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidPolicyId Emitido quando o ID da política no pedido é inválido, nulo ou está vazio. O ID da Política está ausente.
404 PolicyNotFound Quando o ID é válido, 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 eliminar a política. Apenas a política em status inativas pode ser eliminada.

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

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

A tabela seguinte lista os códigos de erro e resposta possíveis que podem ser devolvidos.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidPolicyId Emitido quando o ID da política no pedido é inválido, nulo ou está vazio. O ID da Política está ausente.
403 PolicyActionNotAllowed Lançada quando a política não está no estado ativo. A política não está no estado correto. Aguarde até que se mova para o estado ativo.
404 PolicyNotFound Quando o ID é válido, mas a política não existe. Não é possível obter a Política de Proteção.

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

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

A tabela seguinte lista os códigos de erro e resposta possíveis que podem ser devolvidos.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidPolicyId Emitido quando o ID da política no pedido é inválido, nulo ou está vazio. O 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á no estado correto. Certifique-se de que a política está no estado Inativo.
404 PolicyNotFound Quando o ID é válido, mas a política não existe. Não é possível obter a Política de Proteção.

Listar toda a unidade de proteção sob erros da API de política de proteção

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

A tabela seguinte lista os códigos de erro e resposta possíveis que podem ser devolvidos.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidPolicyId O ID da política é inválido, nulo ou está vazio. O ID da Política é inválido.
400 FilterLengthExceeded Este erro ocorre quando o cliente tenta enviar demasiados filtros ou consultas de uma só vez num único pedido, incluindo consultas de filtro "e" e "ou" combinadas. O comprimento do filtro excede o limite permitido.
400 InvalidProtectionUnitId O ID da unidade de proteção é inválido ou está vazio. ID da Unidade de Proteção Inválido.
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 da API da unidade de proteção

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

A tabela seguinte lista os códigos de erro e resposta possíveis que podem ser devolvidos.

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, contacte o suporte.
200 ProtectionUnitNotFound A Unidade de Proteção não existe. A Unidade de Proteção Pedida não existe, é eliminada ou não pode ser encontrada. Verifique novamente o ID da Unidade de Proteção e tente novamente.
200 InvalidArtifactId ID de Unidade de Proteção inválido ou inexistente. A Unidade de Proteção a remover não foi encontrada.
200 QuotaExceeded Exceder a quota de tamanho da cópia de segurança (especificamente para o Exo). Excedeu a quota de cópia de segurança.
400 InvalidProtectionUnitId O ID da unidade de proteção é inválido ou está vazio. ID da Unidade de Proteção Inválido.

Criar erros da API de sessão de restauro

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

A tabela seguinte lista os códigos de erro e resposta possíveis que podem ser devolvidos.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidPathType PathType (novo/no local) não é conhecido pelos artefactos. O tipo de caminho de restauro não está presente.
400 InvalidArtifactRequest Lista de artefactos de restauro vazios ou nulos. Deve existir, pelo menos, um artefacto de restauro.
400 InvalidRestorePoint Foi fornecido um ponto de restauro inválido. O ID do Ponto de Restauro é inválido ou está vazio.
400 DifferentRestoreDestinationType Diferentes tipos de destino para artefactos a pedido. Tipo de destino de restauro diferente.
413 RestoreArtifactsLimitBreached O pedido excedeu o limite máximo de artefactos. O limite de Artefactos de Restauro foi violado.
400 DuplicateArtifactInList Duplicar artefactos na lista. O artefacto de restauro pedido já está presente.

Obter erros da API de sessão de restauro

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

A tabela seguinte lista os códigos de erro e resposta possíveis que podem ser devolvidos.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidRestoreSessionId Restaure o ID da sessão inválido, nulo ou vazio. O ID da Sessão de Restauro está ausente.
404 RestoreSessionNotFound ID válido, mas sessão não encontrada. Sessão de Restauro Não Encontrada.

Erros da API de sessão de restauro de patches

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

A tabela seguinte lista os códigos de erro e resposta possíveis que podem ser devolvidos.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidRestoreSessionId Restaure o ID da sessão inválido, nulo ou vazio. O ID da Sessão de Restauro está ausente.
400 InvalidPatchRequest Não é possível processar o pedido porque está incorreto ou incorreto. Não é possível processar o pedido porque está incorreto ou incorreto.
400 InvalidRestorePoint Foi fornecido um ponto de restauro inválido. O Ponto de Restauro é inválido.
400 RestoreArtifactsLimitBreached Foi excedido o limite máximo de artefactos de 50 para um único pedido. O limite de Artefactos de Restauro foi violado.
400 InvalidArtifactRequest Lista de artefactos de restauro vazios ou nulos. Restaurar Artefactos são nulos.
403 RestoreSessionActionNotAllowed Tente corrigir a sessão de restauro ativa. A sessão de restauro só pode ser corrigida no estado Rascunho.
404 RestoreSessionNotFound ID válido, mas sessão não encontrada. Não é possível obter a sessão de restauro.
400 DuplicateArtifactInList Duplicar artefactos no pedido. O artefacto de restauro pedido já está presente.

Eliminar erros da API de sessão de restauro

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

A tabela seguinte lista os códigos de erro e resposta possíveis que podem ser devolvidos.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidRestoreSessionId Restaure o ID da sessão inválido, nulo ou vazio. RestoreSessionId está ausente.
403 RestoreSessionActionNotAllowed Tente eliminar a sessão de restauro ativa. A sessão de restauro só pode ser eliminada no estado Rascunho.
404 RestoreSessionNotFound ID válido, mas sessão não encontrada. Não é possível obter a sessão de restauro.
500 IncompleteArtifactDeletion O serviço não consegue eliminar todos os artefactos pedidos. Não é possível eliminar a sessão, tente novamente.

Ativar erros da API de sessão de restauro

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

A tabela seguinte lista os códigos de erro e resposta possíveis que podem ser devolvidos.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidRestoreSessionId Restaure o ID da sessão inválido, nulo ou vazio. RestoreSessionId está ausente.
403 RestoreSessionActionNotAllowed Tente ativar a sessão de restauro ativa. A sessão de restauro só pode ser ativada no estado Rascunho.
404 RestoreSessionNotFound ID válido, mas sessão não encontrada. Não é possível obter a sessão de restauro.
500 TooManyActiveRestoreSessions Tente ativar mais de 25 sessões em simultâneo. Erro temporário: demasiadas sessões de restauro ativas.

Listar o artefacto de restauro sob erros da API de sessão de restauro

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

A tabela seguinte lista os códigos de erro e resposta possíveis que podem ser devolvidos.

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 fornecedor. Ocorreu um erro desconhecido. Tente novamente. Se o problema persistir, contacte o suporte.
200 ArtifactNotFound O Artefacto de Restauro não existe. O artefacto de restauro pedido não foi encontrado para restauro.
200 InvalidRestoreTime Tempo de restauro inválido ou fora dos limites. Não é possível restaurar o Artefacto para este carimbo de data/hora, o tempo de restauro fornecido é inválido ou está para além do período de retenção.
200 ArtifactCannotBeRestored O estado do Artefacto de Restauro não permite o restauro. O artefacto de restauro encontra-se num estado inesperado, como o bloqueio de preservação ou TenantDivestiture, que está a bloquear o restauro.
200 DuplicateArtifactRestoreRequest Restauro simultâneo do mesmo artefacto de restauro. Foi encontrado um Restauro em curso para o artefacto de restauro especificado. Aguarde até à conclusão e tente novamente.
400 InvalidRestoreSessionId Restaure o ID da sessão inválido, nulo ou vazio. RestoreSession ID é inválido.

Criar erros da API da regra de inclusão

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

A tabela seguinte lista o possível código de erro e resposta que pode ser devolvido.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidInclusionRuleCreateRequest Não é possível processar o pedido porque está incorreto ou incorreto. Pedido de criação inválido.
400 InvalidRuleExpression O valor não pode ser uma expressão nula ou inválida. A expressão não é válida e não pode ser analisada.
413 InvalidRuleExpressionGroupLimitExceeded A expressão de regra que contém mais de 100 IDs de grupo não é permitida. A expressão contém mais IDs de grupo do que o limite imposto permite.

Erros da API da regra de inclusão de atualizações

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

A tabela seguinte lista os códigos de erro e resposta possíveis que podem ser devolvidos.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidProtectionRulePatchRequest O parâmetro isAutoApplyEnabled não é suportado num pedido de patch. O parâmetro isAutoApplyEnabled só pode ser fornecido 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 uma 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. Pedido de atualização inválido.
404 ProtectionRuleNotFound A regra de proteção com o ID especificado não existe. O ID de regra especificado está incorreto ou a regra foi eliminada.
413 InvalidRuleExpressionGroupLimitExceeded A expressão de regra que contém mais de 100 IDs de grupo não é permitida. A expressão contém mais IDs de grupo do que o limite imposto permite.
422 InvalidProtectionRuleStatusForDynamicRuleEdit A operação de patch não é permitida no estado atual. A operação de patch não é permitida no deleteRequested estado .

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

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

A tabela seguinte lista o possível código de erro e resposta que pode ser devolvido.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidInclusionRuleId O ID da regra no pedido é inválido, nulo ou está vazio. O ID da regra é inválido.
404 ProtectionRuleNotFound A regra de proteção com o ID especificado não existe. O ID de regra especificado está incorreto ou a regra foi eliminada.
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 da regra de inclusão

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

A tabela seguinte lista os códigos de erro e resposta possíveis que podem ser devolvidos.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidInclusionRuleId O ID da regra no pedido é inválido, nulo ou está vazio. O ID da regra é inválido.
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 o ID especificado não existe. O ID de regra especificado está incorreto ou a regra foi eliminada.

Obter a regra de inclusão por erros da API de ID

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

A tabela seguinte lista os códigos de erro e resposta possíveis que podem ser devolvidos.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidInclusionRuleId O ID da regra no pedido é inválido, nulo ou está vazio. O ID da regra é inválido.
404 ProtectionRuleNotFound A regra de proteção com o ID especificado não existe. O ID de regra especificado está incorreto ou a regra foi eliminada.

Eliminar a regra de inclusão por erros da API de ID

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

A tabela seguinte lista os códigos de erro e resposta possíveis que podem ser devolvidos.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidInclusionRuleId O ID da regra no pedido é inválido, nulo ou está vazio. O ID da regra é inválido.
400 InvalidProtectionRuleStatusForDeletion A operação de eliminação não é permitida no estado atual. Estado inválido para invocar a operação de eliminação.
404 ProtectionRuleNotFound A regra de proteção com o ID especificado não existe. O ID de regra especificado está incorreto ou a regra foi eliminada.
422 InvalidProtectionRuleStatusForDynamicRuleDeletion A operação de eliminação não é permitida no estado atual. Estado inválido para invocar a operação de eliminação numa regra dinâmica.

Obter erros da API do ponto de restauro

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

A tabela seguinte lista os códigos de erro e resposta possíveis que podem ser devolvidos.

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 O limite de data/hora pedido ou o ID da unidade de proteção é inválido. A entrada do ponto de restauro é inválida.
400 InvalidProtectionUnitId O ID da unidade de proteção no pedido é inválido. ID da unidade de Proteção inválido.

Ativar erros da API de serviço

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

A tabela seguinte lista os códigos de erro e resposta possíveis que podem ser devolvidos.

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 faturação do fornecedor de perfis de faturação. Não é possível ler o perfil de faturação do fornecedor de perfis de faturação.
402 InvalidBillingProfile Perfil de faturação inválido recebido do fornecedor. Perfil de faturação inválido recebido do fornecedor.
400 InvalidAppOwnerTenantId ID do inquilino proprietário não encontrado ID de inquilino do proprietário da aplicação inválido recebido do utilizador.

Criar pedidos de adição em massa para restaurar erros da API de artefactos

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

A tabela seguinte lista os códigos de erro e resposta possíveis que podem ser devolvidos.

Código de status de HTTP Código de erro Mensagem de erro Descrição
400 InvalidBulkRestoreArtifactId O ID do pedido de restauro em massa é inválido. GUID inválido fornecido no URI.
400 BulkRestoreInvalidCreateRequest BulkRestoreCreateRequest é nulo. O pedido de criação é nulo ou é inválido.
400 BulkRestoreRestorationResourcesCountExceedsLimit O limite de entrada de restauro em massa foi excedido. O tamanho da entrada é demasiado grande.
400 BulkRestoreInvalidCreateRequestSiteUrl O URL da Web do site de restauro em massa é inválido. O URL do site é nulo, está vazio ou está num formato incorreto.
400 BulkRestoreInvalidCreateRequestUserEmail O restauro em massa do e-mail do utilizador é inválido. Email é nulo, está vazio ou num formato incorreto.

Obter pedidos de adição em massa para restaurar erros da API de artefactos

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

A tabela seguinte lista o possível código de erro e resposta que pode ser devolvido.

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

Eliminar pedidos de adição em massa para restaurar erros da API de artefactos

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

A tabela seguinte lista o possível código de erro e resposta que pode ser devolvido.

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 restauro e o pedido de criação são diferentes. Um pedido em massa só pode ser eliminado quando o respetivo status é completed ou completedWithErrors.

Erros do PowerShell

Os códigos de erro nesta secção aplicam-se às seguintes APIs quando são chamados a partir do Microsoft Graph PowerShell:

A tabela seguinte lista o possível código de erro e resposta que pode ser devolvido.

Código de status de HTTP Código de erro Mensagem de erro Descrição
403 Proibido Método não permitido para aplicações internas listadas conhecidas. O pedido é proibido quando chamado a partir do Microsoft Graph PowerShell porque estas APIs se destinam a ser utilizadas por aplicações do Controlador de Cópia de Segurança registadas. O SDK do PowerShell do Microsoft Graph não é um cliente suportado para estas operações.
  • Last updated on