Partilhar via


Códigos de erro da API do OneNote no Microsoft Graph

Este artigo descreve os códigos de erro que a API do OneNote no Microsoft Graph devolve quando um pedido enviado através da API falha.

Exemplo de resposta de erro

Quando sua solicitação gera um erro, a API do OneNote para de executar a solicitação e retorna uma resposta de erro como um objeto JSON. Uma resposta de erro contém o código de erro associado, uma mensagem e um link para a seção apropriada deste artigo. O exemplo a seguir mostra como é uma resposta de erro.

{
   "error":{
      "code":"10002",
      "message":"The service is currently unavailable. Please try again later.",
      "innerError": {
        "requestId": "request-id",
        "date": "date-time"
      }
   }
}

Para saber mais sobre erros do Microsoft Graph, confira Respostas de erros e tipos de recurso do Microsoft Graph.

Códigos de 10001 às 19999

O serviço está tendo problemas ou está enviando informações ao aplicativo.

10001

Ocorreu um erro inesperado e a solicitação falhou.

10002

O serviço não está disponível no momento.

10003

A conta do utilizador atual excedeu o número máximo de pedidos ativos. A sua aplicação tem de repetir o pedido.

10004

O serviço não pode criar uma página na seção solicitada porque essa seção é protegida por uma senha.

10005

A solicitação contém mais do que o número máximo de marcas de imagem nas quais o atributo data-render-src contém um PDF. Confira Adicionar imagens e arquivos.

10006

A API do OneNote não pôde criar uma página na seção especificada porque a seção está corrompida.

10007

O servidor está ocupado demais para lidar com a solicitação de entrada neste momento. Tente novamente mais tarde.

10008

Uma ou mais das bibliotecas de documentos no OneDrive do usuário ou grupo contêm mais de 5.000 itens do OneNote (bloco de anotações, seções, grupos de seções) e não podem ser consultadas usando a API. Certifique-se de que nenhuma das bibliotecas de documentos do utilizador ou grupo contém mais de 5000 itens do OneNote. Confira o blog de desenvolvimento do OneNote para ver as etapas de mitigação.

10012

Não é possível criar nem atualizar a entidade porque a biblioteca que contém o bloco de anotações exige que seja feito check-out dos itens para que eles possam ser editados. Para saber mais, confira Configurar uma biblioteca para exigir check-out de arquivos.

Remova o requisito de check-out da biblioteca ou mova o bloco de anotações.

10013

Uma ou mais das bibliotecas de documentos no OneDrive do usuário ou grupo contêm mais de 20.000 itens e não podem ser indexadas para consulta usando a API. Certifique-se de que nenhuma das bibliotecas de documentos do utilizador ou grupo contém mais de 20 000 itens. Confira o blog de desenvolvimento do OneNote para ver as etapas de mitigação.

10014

O Azure Key Vault está ocupado demais para lidar com a solicitação de entrada neste momento. Tente novamente mais tarde.

10015

O SharePoint atualmente não está disponível. Tente novamente mais tarde.

10016

A biblioteca de documentos no OneDrive do utilizador ou grupo excedeu o limite de limiar de âmbitos de segurança exclusivo. O número máximo de escopos exclusivos de segurança definido para uma biblioteca não pode exceder 50.000.

10017

Solicitação Incorreta.

19999

A solicitação falhou porque ocorreu um erro indeterminado.

Códigos de 20001 às 29999

O código da aplicação fez algo de errado.

20001

A parte "Apresentação" necessária está faltando na solicitação. Exatamente uma é necessária.

20002

A solicitação contém duas ou mais partes de "Apresentação". Exatamente uma é necessária.

20003

O tipo de conteúdo da parte "Apresentação" pode ser somente texto/HTML ou aplicativo/XHTML+XML.

20004

O HTML da parte "Apresentação" contém uma marca de imagem com a src e o conjunto de propriedades data-render-src. A API ignora a propriedade src e utiliza a propriedade data-render-src .

20005

O URI da solicitação é muito longo. O tamanho máximo do URI (incluindo todos os parâmetros e dados) é de 16 KB ou 16.384 caracteres.

20006

O HTML da parte "Apresentação" contém uma marca de imagem sem a src, nem o conjunto de propriedades data-render-src. A API ignora a etiqueta de imagem .

20007

O HTML da parte "Apresentação" contém uma cadeia de caracteres de data/hora criada que não corresponde a nenhum dos formatos permitidos.

20008

O tamanho da solicitação é muito grande.

20009

A solicitação contém partes com nomes duplicados. Os nomes das partes devem ser exclusivos.

20010

O cabeçalho Content-Disposition não foi fornecido para o tipo de conteúdo especificado.

20011

A solicitação contém uma carga de partes múltiplas malformadas. Os problemas poderiam incluir ausência de linhas em branco, ausência de uma última linha, separadores de parte formatados incorretamente, etc. Se você estiver criando a mensagem de partes múltiplas à mão, verifique cuidadosamente a lógica, ou considere o uso de uma biblioteca de terceiros.

20012

A solicitação não fornece um tipo de conteúdo para a parte especificada.

20013

A solicitação não fornece cabeçalhos Content-Type e Content-Disposition para a parte especificada.

20014

O comprimento de uma parte na mensagem de partes múltiplas excede o tamanho máximo de 25 MB.

20015

A contagem das partes na mensagem de partes múltiplas excede o limite de 500.

20016

O comprimento da mensagem de partes múltiplas excede o limite de 75 MB.

20017

O MIME do email foi malformado.

20018

O MIME ou ICal da reunião foi malformado.

20019

Nenhum ICal foi encontrado.

20020

Json malformado encontrado no corpo da solicitação.

20100

Algo está errado com a sintaxe da sua solicitação.

20101

A propriedade solicitada não existe.

20102

Você solicitou um recurso que não existe.

20103

A consulta expand não tem suporte para essa solicitação. Confira Opções de cadeia de caracteres de consulta OData com suporte.

20104

A opção de consulta pagelevel tem suporte somente na consulta para a coleção de páginas em uma seção ou para uma página específica. Por exemplo:

GET ../sections/{id}/pages?pagelevel=true
GET ../pages/{id}?pagelevel=true

20106

Sua solicitação contém um operador de consulta que não tem suporte.

20108

Sua solicitação contém parâmetros de consulta OData sem suporte.

20109

A carga na solicitação PATCH não foi criada corretamente.

20110

As solicitações de criação de página com partes de dados exigem que o conteúdo seja de partes múltiplas, com uma parte "Apresentação".

20111

Sua solicitação usa um recurso do OData que não tem suporte.

20112

Sua solicitação contém uma ID inválida para o bloco de anotações, o grupo de seções, a seção ou a entidade de página do destino.

20113

O recurso especificado no pedido foi eliminado.

20115

O nome contém caracteres inválidos. Um nome de bloco de anotações não pode conter nenhum dos seguintes caracteres: ? * \ / : < > | ' "

20117

Um item com o nome especificado já existe no local que você especificou.

20119

O HTML na parte "Apresentação" contém um atributo data-attachment que não tem um formato válido nem inclui um ou mais desses caracteres inválidos para um nome de arquivo: \ / : * ? < > | ". A solicitação substituiu o valor indicado na mensagem de erro.

20120

Sua solicitação especifica um destino PATCH que não pode ser localizado.

20121

Sua solicitação contém um argumento PATCH inválido. Confira Atualizar conteúdo da página.

20122

Sua solicitação especifica uma ação PATCH sem suporte. Confira Atualizar conteúdo da página.

20123

A solicitação PATCH não pode alterar a página especificada.

20124

Sua solicitação PATCH de partes múltiplas não inclui uma parte "comandos" com a estrutura JSON da ação PATCH. Confira Atualizar conteúdo da página.

20125

Sua solicitação PATCH não contém ações. Confira Atualizar conteúdo da página.

20126

O corpo da mensagem contém JSON incorretamente formatado ou arquivos que não têm suporte para essa operação.

20127

Sua solicitação especifica o nome de uma propriedade desconhecida.

20128

Sua solicitação contém um erro de sintaxe OData na posição indicada na mensagem.

20129

Sua solicitação contém uma opção de cadeia de caracteres de consulta top cujo valor é muito alto. Para consultas de página, o valor máximo é 100 e o valor padrão é 20.

20130

Sua solicitação contém um URI que aponta para um recurso HTTP que não pode ser encontrado.

20131

Sua solicitação contém um valor inválido para Content-Type. Use o valor indicado na mensagem.

20132

Sua solicitação apresentas conteúdo inválido. As causas mais comuns para isso são a ausência do cabeçalho da solicitação Content-Type e/ou nenhum conteúdo no corpo da solicitação.

20133

O pedido especifica um destino PATCH que não é suportado. Confira Atualizar conteúdo da página.

20134

Sua solicitação especifica um elemento inválido como o destino da ação PATCH. Se o destino utilizar o identificador data-id, certifique-se de que o prefixa com um símbolo # . Confira Atualizar conteúdo da página.

20135

O pedido especifica um tipo de entidade que não é suportado para a operação PATCH. Confira Atualizar conteúdo da página.

20136

Sua solicitação contém um atributo data-render-src ou data-render-method inválido ou que está ausente. Confira Extrair dados de capturas.

20137

A página de destino não dá suporte a solicitações PATCH.

20138

O tipo de elemento de destino em sua solicitação PATCH não dá suporte à ação acrescentar. Confira Atualizar conteúdo da página.

20139

Sua solicitação contém um valor de atributo data-tag inválido. Confira Usar marcas de anotação.

20140

Sua solicitação contém um valor de status data-tag inválido. A caixa de seleção de marcas de anotação pode ter um status concluído.

Exemplo:

    <p data-tag="to-do:completed">To-do note tag in completed state (checked box in the UI)</p>

Confira Usar marcas de anotação.

20141

O destino em sua solicitação PATCH não dá suporte à ação especificada. Confira Atualizar conteúdo da página.

20142

O pedido contém uma expressão de expansão para um elemento principal de entidades subordinadas ou um subordinado de entidades principais, que não é suportada. Confira Opções de cadeia de caracteres de consulta OData com suporte.

20143

A consulta OData é inválida.

20144

Sua solicitação contém uma expressão expand para uma propriedade de não navegação. Somente as propriedades de navegação podem ser expandidas.

20145

A expressão select ou expand em sua solicitação contém um termo inválido.

20146

O atributo style="position:absolute"é especificado em um elemento, mas o elemento body não especifica data-absolute-enabled="true", que é exigido para dar suporte ao posicionamento. Todas as configurações de posição serão ignoradas. Confira Criar elementos posicionados absolutos.

20147

O style="position:absolute" atributo é especificado num elemento que não é um elemento subordinado direto do elemento do corpo , o que não é suportado. Se o elemento for div,img ou objeto, torne-o numa subordinada direta do corpo; caso contrário, as definições de posição são ignoradas e o respetivo conteúdo é composto dentro de um div posicionado absoluto. Confira Criar elementos posicionados absolutos.

20148

O atributo style="position:absolute" é especificado em um tipo de elemento que não dá suporte a ele. Somente elementos div, img e object que são filhos direto do corpo da página dão suporte ao posicionamento. Confira Criar elementos posicionados absolutos.

20149

Sua solicitação especifica um elemento de destino que não pode ser encontrado.

20150

O pedido não é válido para este tipo de autenticação. Use o caminho ../me/onenote/ no lugar.

20151

O pedido não é válido para este tipo de autenticação. Use o ponto de extremidade ../me/onenote/section/{id}/pages para criar uma página em uma seção específica.

20152

Não há qualquer valor de nome especificado para a entidade. O nome deve ser definido e não pode conter somente espaços em branco.

20153

O nome da entidade contém caracteres inválidos. O nome não pode conter os seguintes caracteres: ? * \ / : < > | & # " % ~

20154

O nome da entidade não pode começar com um espaço.

20155

O nome da entidade é muito longo. Os nomes do bloco de anotações têm um limite de 128 caracteres. Outros nomes de entidade têm um limite de 50 caracteres.

20156

A ID especificada para o recurso de destino não existe.

20157

A ID especificada para a entidade de destino é inválida.

20158

Não é possível obter metadados para a URL do site especificada na solicitação. Verifique o formato da URL fornecida. Os formatos com suporte incluem https://domain.sharepoint.com/site-a e https://domain.com/sites/site-a.

20160

Não é possível encontrar um grupo unificado do Office 365 que tem a ID especificada.

20161

O contexto não especifica uma ID de usuário válida. Um erro comum é que PUID/CID foi transmitido como um longo, e não como um hexadecimal.

20166

O aplicativo emitiu muitas solicitações em nome de um usuário em um curto período de tempo. Para ajudar a garantir que a API do OneNote permaneça estável e responsiva, a API retorna um código de status 429 e esse erro quando detecta que um aplicativo está usando muitos recursos.

Para obter mais informações, veja Orientações de limitação específicas do serviço Microsoft Graph.

20168

A origem de vídeo especificada no pedido não é suportada. Confira Sites de vídeo com suporte para a lista atual.

20266

O número máximo de secções foi excedido para este pedido. Para obter páginas para contas com um número elevado de secções, recomendamos que obtenha páginas para uma secção de cada vez (utilize a API Páginas de Lista ).

Códigos de 30001 às 39999

Algo está errado com a conta do usuário.

30101

A conta de utilizador excedeu a quota do OneDrive. Confira OneDrive.

30102

Nada mais pode ser adicionado à seção solicitada porque ela atingiu seu tamanho máximo.

30103

O consumo de recursos é muito alto para a solicitação. A conta de usuário de destino tem um grande conjunto de dados ou o serviço está recebendo um grande número de solicitações simultâneas para o mesmo site (por exemplo, o site pessoal do usuário ou um site de equipe).

30104

A conta de utilizador foi suspensa.

30105

O site pessoal do OneDrive para Empresas do utilizador não está aprovisionado, o que é necessário para aceder aos blocos de notas. Agora, o serviço do OneNote provisionará o site. Este processo pode levar algum tempo.

30106

O OneDrive for Business está sendo provisionado para o usuário.

30108

O OneDrive for Business pessoal do usuário não pôde ser recuperado. A tabela a seguir lista algumas possíveis causas.

Causa Resolução
O site pessoal do usuário não foi provisionado. O usuário deve abrir o OneDrive for Business e seguir as instruções para provisionar o site. Se isto falhar, deverá contactar o respetivo administrador inquilino do Microsoft 365.
No momento, o site pessoal do usuário está sendo provisionado. Tente a solicitação mais tarde.
O usuário não tem uma licença válida do OneDrive for Business. O utilizador deve contactar o administrador inquilino do Microsoft 365.
Um problema de rede impediu a solicitação de ser enviada com êxito. Tente a solicitação mais tarde.

30109

Alguns usuários na solicitação não existem.

30110

Os Serviços de Informações do Aluno não foram registrados para esse locatário.

30111

Há um erro genérico com os Serviços de Informações do Aluno.

30112

Vários usuários afetados pela solicitação tinham o mesmo nome de usuário.

30113

O bloco de notas não está configurado para permitir convites.

30114

Há um parâmetro obrigatório ausente.

Códigos de 40001 às 49999

O usuário ou o aplicativo não tem as permissões corretas.

40001

A solicitação não contém um token OAuth válido. Confira Permissões de notas.

40002

O usuário não tem permissão para gravar no local solicitado.

40003

O usuário não tem permissão para acessar o recurso solicitado.

40004

O token OAuth não tem os escopos necessários para executar a ação solicitada. Confira Permissões de notas.

40006

O token OAuth não tem os escopos necessários para executar a ação solicitada. Especificamente a permissão de edição. Confira Permissões de notas.

40007

O usuário não tem permissões para acessar esse recurso.

40008

O acesso é proibido para esse recurso.

40009

O contêiner já está em uso por outro recurso.