Códigos de error para la API de OneNote en Microsoft Graph
En este artículo se describen los códigos de error que devuelve la API de OneNote en Microsoft Graph cuando se produce un error en una solicitud que se envía a través de la API.
Ejemplo de respuesta de error
Cuando la solicitud genera un error, la API de OneNote deja de realizar la solicitud y devuelve una respuesta de error como un objeto JSON. Una respuesta de error contiene el código de error asociado, un mensaje y un vínculo a la sección correspondiente en este artículo. El ejemplo siguiente muestra el aspecto de una respuesta de error.
{
"error":{
"code":"10002",
"message":"The service is currently unavailable. Please try again later.",
"innerError": {
"requestId": "request-id",
"date": "date-time"
}
}
}
Para obtener más información sobre los errores de Microsoft Graph, consulte Respuestas de error de Microsoft Graph y tipos de recursos.
Códigos de 10001 a 19999
El servicio tiene problemas o está enviando información a la aplicación.
10001
Se produjo un error inesperado y la solicitud ha fallado.
10002
El servicio no está disponible en este momento.
10003
La cuenta del usuario actual superó el número máximo de solicitudes activas. La aplicación debe repetir la solicitud.
10004
El servicio no puede crear una página en la sección solicitada porque la sección está protegida por contraseña.
10005
La solicitud contiene más del número máximo de etiquetas de imagen en las que el atributo data-render-src contiene un PDF. Vea Agregar imágenes y archivos.
10006
La API de OneNote no pudo crear una página en la sección especificada porque esta sección está dañada.
10007
El servidor está demasiado ocupado para atender la solicitud entrante en este momento. Inténtelo de nuevo más tarde.
10008
Uno o más de las bibliotecas de documentos en OneDrive del usuario o del grupo contiene más de 5000 elementos de OneNote (blocs de notas, secciones, grupos de secciones) y no se puede consultar mediante la API. Asegúrese de que ninguna de las bibliotecas de documentos del usuario o grupo contenga más de 5000 elementos de OneNote. Consulte el blog de desarrollo de OneNote para conocer los pasos de mitigación.
10012
No se puede crear o actualizar la entidad porque la biblioteca que contiene el cuaderno requiere que los elementos se desprotegerán antes de que se puedan editar. Para obtener más información, consulte Configuración de una biblioteca para requerir la des check-out de los archivos.
Quite el requisito de desprotección de la biblioteca o mueva el bloc de notas.
10013
Uno o más de las bibliotecas de documentos en OneDrive del usuario o del grupo contiene más de 20 000 elementos y no se puede indexar para realizar consultas mediante la API. Asegúrese de que ninguna de las bibliotecas de documentos del usuario o grupo contenga más de 20 000 elementos. Consulte el blog de desarrollo de OneNote para conocer los pasos de mitigación.
10014
Azure Key Vault está demasiado ocupado para atender la solicitud entrante en este momento. Inténtelo de nuevo más tarde.
10015
SharePoint no está disponible actualmente. Inténtelo de nuevo más tarde.
10016
La biblioteca de documentos de OneDrive del usuario o grupo superó el límite de umbral de ámbitos de seguridad únicos. El número máximo de ámbitos de seguridad únicos establecidos para una biblioteca no debe exceder de 50 000.
10017
Solicitud incorrecta (Bad Request)
19999
Ha habido un error en la solicitud porque se produjo un error sin determinar.
Códigos de 20001 a 29999
El código de la aplicación hizo algo incorrecto.
20001
Falta la parte "Presentación", necesaria en la solicitud. Se necesita exactamente una.
20002
La solicitud contiene dos o más partes "Presentación". Se necesita exactamente una.
20003
El tipo de contenido de la parte "Presentación" puede ser solo texto/HTML o aplicación/XHTML+XML.
20004
El HTML de la parte "Presentación" contiene una etiqueta de imagen con ambos conjuntos de propiedades: src y data-render-src. La API omite la propiedad src y usa la propiedad data-render-src .
20005
El URI de la solicitud es demasiado largo. El tamaño máximo del URI (incluyendo todos los parámetros y datos) es de 16 KB o 16 384 caracteres.
20006
El HTML de la parte "Presentación" contiene una etiqueta de imagen sin los conjuntos de propiedades src o data-render-src. La API omite la etiqueta de imagen .
20007
El código HTML de la parte "Presentation" contiene una cadena de fecha y hora de creación que no coincide con ninguno de los formatos permitidos.
20008
El tamaño de la solicitud es demasiado grande.
20009
La solicitud contiene partes con nombres duplicados. Los nombres de las partes deben ser únicos.
20010
No se proporcionó el encabezado Content-Disposition para el tipo de contenido especificado.
20011
La solicitud contiene una carga de varias partes con formato incorrecto. Entre los problemas se incluyen la falta de líneas en blanco, falta de la última línea, separadores de partes con formato incorrecto, etc. Si va a crear el mensaje de varias partes a mano, revise cuidadosamente la lógica o considere el uso de una biblioteca de terceros.
20012
La solicitud no proporciona un tipo de contenido para la parte especificada.
20013
La solicitud no proporciona los encabezados Content-Type y Content-Disposition para la parte especificada.
20014
La longitud de una parte en el mensaje de varias partes supera el tamaño máximo de 25 MB.
20015
El recuento de partes en el mensaje de varias partes supera el límite de 500.
20016
La longitud del mensaje de varias partes supera el límite de 75 MB.
20017
El correo electrónico MIME está mal formado.
20018
La reunión MIME o ICal está mal formada.
20019
No se ha encontrado ningún ICal.
20020
Se encontró JSON con formato incorrecto en el cuerpo de la solicitud.
20100
Hay algún fallo en la sintaxis de su solicitud.
20101
La propiedad que ha solicitado no existe.
20102
Ha solicitado un recurso que no existe.
20103
La consulta expand no se admite para esta solicitud. Vea Opciones de cadena de consultas OData admitidas.
20104
La opción de consulta pagelevel solo se admite al realizar consultas para la colección de páginas de una sección o de una página específica. Por ejemplo:
GET ../sections/{id}/pages?pagelevel=true
GET ../pages/{id}?pagelevel=true
20106
La solicitud contiene un operador de consulta que no es compatible.
20108
La solicitud contiene parámetros de consulta de OData no compatibles.
20109
La carga útil de la solicitud PATCH no se ha creado correctamente.
20110
Las solicitudes de creación de la página con partes de datos requieren que el contenido tenga varias partes, con una parte "Presentación".
20111
La solicitud usa una característica de OData que no es compatible.
20112
Su solicitud contiene un identificador no válido para el bloc de notas de destino, el grupo de sección, la sección o la entidad de la página.
20113
Se eliminó el recurso especificado en la solicitud.
20115
El nombre contiene caracteres no válidos. El nombre de un bloc de notas no puede contener ninguno de los siguientes caracteres: ? * \ / : < > | ' "
20117
Ya existe un elemento con el nombre especificado en la ubicación indicada.
20119
El código HTML de la parte "Presentation" contiene un atributo data-attachment que no tiene un formato válido o que incluye uno o varios de estos caracteres no válidos para un nombre de archivo: \ / : * ? < > | ". La solicitud sustituye el valor indicado en el mensaje de error.
20120
Su solicitud especifica un destino PATCH que no se encuentra.
20121
La solicitud contiene un argumento PATCH no válido. Consulte Actualizar contenido de la página.
20122
La solicitud especifica una acción PATCH no compatible. Consulte Actualizar contenido de la página.
20123
La solicitud PATCH no puede modificar la página especificada.
20124
La solicitud PATCH de varias partes no incluye una parte "commands" con la estructura JSON de la acción PATCH. Vea Actualizar contenido de la página.
20125
La solicitud PATCH no contiene acciones. Consulte Actualizar contenido de la página.
20126
El cuerpo del mensaje contiene JSON con un formato incorrecto o campos que no son compatibles con esta operación.
20127
La solicitud especifica el nombre de una propiedad desconocida.
20128
La solicitud contiene un error de sintaxis de OData en la posición indicada en el mensaje.
20129
La solicitud contiene una opción de la cadena de consulta top cuyo valor es demasiado alto. Para las consultas de páginas, el valor máximo es 100 y el valor predeterminado es 20.
20130
La solicitud contiene un URI que apunta a un recurso de HTTP que no se encuentra.
20131
La solicitud contiene un valor no válido para Content-Type. Use el valor indicado en el mensaje.
20132
Su solicitud incluye contenido no válido. Las causas comunes son la falta de un encabezado Content-Type o un cuerpo de la solicitud sin contenido.
20133
La solicitud especifica un destino PATCH que no se admite. Vea Actualizar contenido de la página.
20134
La solicitud especifica un elemento no válido como destino de la acción PATCH. Si el destino usa el identificador de id. de datos , asegúrese de que lo anteponga a un símbolo #. Consulte Actualizar contenido de la página.
20135
La solicitud especifica un tipo de entidad que no se admite para la operación PATCH. Vea Actualizar contenido de la página.
20136
La solicitud contiene un atributo data-render-src o data-render-method no válido o que falta. Vea Extraer los datos de las capturas.
20137
La página de destino no admite solicitudes PATCH.
20138
El tipo de elemento de destino de la solicitud PATCH no admite la acción append especificada. Consulte Actualizar contenido de la página.
20139
La solicitud contiene un valor de atributo data-tag no válido. Vea Usar etiquetas de nota.
20140
La solicitud contiene un valor de estado data-tag no válido. Las etiquetas de nota de casillas pueden tener un estado completed.
Ejemplo:
<p data-tag="to-do:completed">To-do note tag in completed state (checked box in the UI)</p>
20141
El destino de la solicitud PATCH no admite la acción especificada. Vea Actualizar contenido de la página.
20142
La solicitud contiene una expresión de expansión para un elemento primario de entidades secundarias o un elemento secundario de entidades primarias, que no se admite. Vea Opciones de cadena de consultas OData admitidas.
20143
La consulta OData no es válida.
20144
La solicitud contiene una expresión expand para una propiedad de no navegación. Únicamente se pueden expandir las propiedades de navegación.
20145
La expresión select o expand de la solicitud contiene un término no válido.
20146
El atributo style="position:absolute" se especifica en un elemento, pero el elemento body no especifica data-absolute-enabled="true", que es necesario para admitir el posicionamiento. Se omitirán todas las configuraciones de posición. Vea Crear elementos con posición absoluta.
20147
El style="position:absolute" atributo se especifica en un elemento que no es un elemento secundario directo del elemento body , que no se admite. Si el elemento es un div, img o objeto, consígalo como un elemento secundario directo del cuerpo; De lo contrario, se omite la configuración de posición y su contenido se representa dentro de un div con posición absoluta. Vea Crear elementos con posición absoluta.
20148
El atributo style="position:absolute" se especifica en un tipo de elemento que no es compatible. Solo div, img y object admiten la posición de los elementos que son elementos secundarios directos del cuerpo de la página. Vea Crear elementos con posición absoluta.
20149
Su solicitud especifica un elemento de destino que no se encuentra.
20150
La solicitud no es válida para este tipo de autenticación. Use la ruta de acceso ../me/onenote/ en su lugar.
20151
La solicitud no es válida para este tipo de autenticación. Use el punto de conexión ../me/onenote/section/{id}/pages para crear una página en una sección específica.
20152
No hay ningún valor name especificado para la entidad. El nombre debe estar definido y no puede contener solo espacios en blanco.
20153
El nombre de la entidad contiene caracteres no válidos. El nombre de la organización no puede contener los siguientes caracteres: ? * \ / : < > | & # " % ~
20154
El nombre de la entidad no puede comenzar con un espacio.
20155
El nombre de entidad es demasiado largo. Los nombres de los blocs de notas tienen un límite de 128 caracteres. Los nombres de otras entidades tienen un límite de 50 caracteres.
20156
El identificador especificado para el recurso de destino no existe.
20157
El identificador especificado para la entidad de destino no es válido.
20158
No se pueden obtener los metadatos de la dirección URL del sitio especificada en la solicitud. Compruebe el formato de la dirección URL suministrada. Los formatos admitidos son https://domain.sharepoint.com/site-a y https://domain.com/sites/site-a.
20160
No se puede encontrar un grupo unificado de Office 365 con el identificador especificado.
20161
El contexto no especifica ningún Id. de usuario válido. Un error frecuente es que PUID/CID se ha pasado como un long en lugar de un hex.
20166
La aplicación ha emitido demasiadas solicitudes en nombre de un usuario en un corto período de tiempo. Para ayudar a garantizar que la API de OneNote permanece estable y con capacidad de respuesta, la API devuelve un código de estado 429 y este error cuando detecta que una aplicación está usando demasiados recursos.
Para obtener más información, consulte Guía de limitación específica del servicio de Microsoft Graph.
20168
No se admite el origen de vídeo especificado en la solicitud. Vea Sitios de vídeo compatibles para obtener la lista actual.
20266
Se supera el número máximo de secciones para esta solicitud. Para obtener páginas para cuentas con un gran número de secciones, se recomienda obtener páginas de una sección a la vez (use la API De listas de páginas ).
Códigos de 30001 a 39999
Hay algún fallo en la cuenta del usuario.
30101
La cuenta de usuario superó su cuota de OneDrive. Vea OneDrive.
30102
No se puede agregar nada más a la sección solicitada porque ha alcanzado su tamaño máximo.
30103
El consumo de recursos es demasiado alto para la solicitud. La cuenta de usuario de destino tiene un gran conjunto de datos o el servicio está recibiendo un gran número de solicitudes simultáneas para el mismo sitio (por ejemplo, el sitio personal del usuario o un sitio de grupo).
30104
Se suspendió la cuenta de usuario.
30105
No se aprovisiona el sitio personal de OneDrive para la Empresa del usuario, que es necesario para acceder a los cuadernos. El servicio de OneNote aprovisionará el sitio ahora. Este proceso puede tardar varios minutos.
30106
OneDrive for Business se está aprovisionando para el usuario.
30108
No se pudo recuperar el OneDrive for Business personal del usuario. En la tabla siguiente se enumeran algunas causas posibles.
| Motivo | Solución |
|---|---|
| No se ha aprovisionado el sitio personal del usuario. | El usuario debe abrir OneDrive for Business y seguir las instrucciones para crear el sitio. Si se produce un error, debe ponerse en contacto con su administrador de inquilinos de Microsoft 365. |
| Actualmente se está aprovisionando el sitio personal del usuario. | Intente de nuevo la solicitud más tarde. |
| El usuario no tiene un OneDrive válido para la licencia de la empresa. | El usuario debe ponerse en contacto con su administrador de inquilinos de Microsoft 365. |
| Un problema de red ha impedido que la solicitud se enviase correctamente. | Intente de nuevo la solicitud más tarde. |
30109
No existen algunos usuarios de la solicitud.
30110
Los servicios de información de alumno no se han registrado para este arrendatario.
30111
Hay un error genérico con los servicios de información del alumno.
30112
Varios usuarios afectados por la solicitud tenían el mismo nombre de usuario.
30113
El cuaderno no está configurado para permitir invitaciones.
30114
Falta un parámetro necesario.
Códigos de 40001 a 49999
El usuario o la aplicación no tienen los permisos correctos.
40001
La solicitud no contiene un token válido de OAuth. Vea Permisos de notas.
40002
El usuario no tiene permiso para escribir en la ubicación solicitada.
40003
El usuario no tiene permiso para acceder al recurso solicitado.
40004
El token de OAuth no tiene los ámbitos necesarios para realizar la acción solicitada. Vea Permisos de notas.
40006
El token de OAuth no tiene los ámbitos necesarios para realizar la acción solicitada. Específicamente, el permiso de edición. Vea Permisos de notas.
40007
El usuario no tiene permisos para acceder a este recurso.
40008
El acceso está prohibido para este recurso.
40009
El contenedor ya está en uso por otro recurso.