Compartilhar via

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

  • Artigo

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.
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 ProtectionUnitAlreadyExists Este é um erro de nível ProtectionUnit de patch delta devolvido quando o pedido tem a Unidade de Proteção duplicada na lista que já está presente no serviço. Erro ao nível de ProtectionUnit: ProtectionUnit já existe.
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.
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.
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.

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 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.

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.