Solicitar acceso

Errores y límites de solicitudes

Cada código de error que devuelve la API de Node Lodge, qué significa y qué hacer, y los límites de solicitudes por minuto y por hora.

Todos los errores tienen la misma forma. El estado HTTP indica el tipo de fallo; code indica cuál.

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many requests. Retry in a moment.",
    "reference": "7F3K-92QD"
  }
}
  • code: estable, se puede usar para ramificar la lógica.
  • message: una frase para una persona. Puede cambiar.
  • reference: indíquela al soporte para localizar la solicitud.
  • fields: solo en VALIDATION_ERROR, los campos que fallaron, cada uno con un path y un message.

Códigos de error

Solicitud

Código Estado Significado Qué hacer
VALIDATION_ERROR 400 Un campo, la consulta o el cuerpo JSON no es válido. Corrija los campos indicados en fields.
AMBIGUOUS_CREDENTIALS 400 La solicitud lleva a la vez una cookie de sesión de consola y una clave de API. Envíe solo una de las dos.
PAYLOAD_TOO_LARGE 413 El cuerpo supera 64 KiB. Envíe un cuerpo más pequeño.
IDEMPOTENCY_MISMATCH 422 La Idempotency-Key ya se usó con otro cuerpo. Use una clave nueva para una solicitud nueva.

Autenticación y acceso

Código Estado Significado Qué hacer
UNAUTHENTICATED 401 No hay sesión ni clave de API válida. Revise la cabecera Authorization: Bearer o cree una clave nueva.
FORBIDDEN 403 Su rol, o el propietario del recurso, no permite esta acción. Consulte a un propietario o administrador de la organización.
API_KEY_NOT_ALLOWED 403 Las claves de API no pueden llamar a esta ruta, o la clave no tiene el alcance. Añada el alcance a una clave nueva o use la consola. Consulte Qué puede llamar una clave.
EMAIL_NOT_VERIFIED 403 La dirección de correo electrónico de la cuenta no está confirmada. Abra el enlace de confirmación de su bandeja de entrada.
TERMS_REQUIRED 403 Las condiciones de uso vigentes no están aceptadas. Acéptelas en la consola.
MFA_REQUIRED 403 La acción requiere la autenticación de dos factores activada. Actívela en Settings.
STEP_UP_REQUIRED 403 La acción requiere un código de dos factores de los últimos 10 minutos. Introduzca un código nuevo y vuelva a intentarlo.
MFA_CODE_INVALID 400 El código de dos factores es incorrecto o ha caducado. Introduzca el código vigente.
TOKEN_INVALID 400 Un enlace de correo electrónico no es válido o ha caducado. Solicite un enlace nuevo.
ACCOUNT_THROTTLED 429 Demasiados inicios de sesión o códigos de dos factores fallidos en 15 minutos. Espere 15 minutos.

Sesiones, crédito y límites

Código Estado Significado Qué hacer
CREDIT_INSUFFICIENT 402 El presupuesto supera el crédito disponible. Añada crédito o reduzca el presupuesto.
FUNDS_INSUFFICIENT 402 Los fondos disponibles no cubren la reserva. Añada crédito o reserve una duración más corta.
ACCOUNT_BLOCKED 402 Un pago falló o fue revertido, por lo que las nuevas sesiones están bloqueadas. Consulte Pago rechazado.
TRUST_LIMIT 403 La sesión supera sus límites de cuenta. Detenga una sesión, elija otra clase de GPU o solicite un límite mayor.
API_KEY_LIMIT 409 El presupuesto de la sesión, su aumento o la reserva supera un límite de gasto de la clave de API. Baje el presupuesto o aumente los límites de la clave con Edit limits. Consulte Límites de gasto.
API_KEY_INVALID 409 La clave que reservó la sesión ya no es válida. Use una clave válida.
MAX_COST_EXCEEDED 409 La reserva cuesta más que el máximo enviado. Aumente el máximo o reserve menos tiempo.
BUDGET_EXCEEDED 409 La sesión supera el límite de gasto que se aplica a esta oferta. Reduzca el presupuesto o elija otra oferta.
RESOURCE_UNAVAILABLE 409 La máquina se desconectó o acaba de alquilarse. Elija otra oferta.
PARTNER_UNAVAILABLE 409 La oferta cambió o ya no existe. Recargue el catálogo y vuelva a elegir.
SESSION_REQUIRED 409 Las máquinas de centro de datos se inician como sesiones, con un presupuesto. Láncela con POST /v1/sessions.
RESERVATION_REQUIRED 409 En esta cuenta, las máquinas de centro de datos se contratan como reservas. Resérvela con POST /v1/reservations y luego iníciela.
INVALID_STATE 409 El estado de la sesión no lo permite, por ejemplo si ya terminó. Lea la sesión y actúe según su estado.
CONFLICT 409 El recurso ya existe, o la misma solicitud sigue en curso. Lea el recurso, o espere y vuelva a intentarlo.
NOT_FOUND 404 El recurso no existe o no es suyo. Compruebe el ID.

Límites y servidor

Código Estado Significado Qué hacer
RATE_LIMITED 429 Demasiadas solicitudes. Espere los segundos indicados en retry-after y vuelva a intentarlo.
INTERNAL_ERROR 500 La solicitud falló en el servidor. Vuelva a intentarlo. Si persiste, envíe la reference al soporte.

Límites de solicitudes

Los límites cuentan las solicitudes por ventana de tiempo. Con una clave de API, el límite general se cuenta por clave; sin ella, por dirección IP.

Solicitudes Límite
Cualquier ruta de la API, salvo las indicadas abajo 300 cada minuto
Registro e inicio de sesión 10 cada minuto
Códigos de dos factores 10 cada minuto
Solicitud de restablecimiento de contraseña 5 en 15 minutos
Claves de API: crear o editar límites 30 cada hora
Claves SSH: añadir 30 cada hora
Cambios de tarjeta, crédito y recarga automática 20 cada hora, por tipo de cambio
Soporte: nueva solicitud 10 cada hora
Soporte: responder, reabrir, resolver 30 cada hora, por acción
Disponibilidad pública de GPU 60 cada minuto

Cada respuesta indica el estado de su límite:

  • x-ratelimit-limit: solicitudes permitidas en la ventana.
  • x-ratelimit-remaining: solicitudes restantes.
  • x-ratelimit-reset: segundos hasta que la ventana se reinicia.

Superado el límite, la respuesta es 429 RATE_LIMITED con una cabecera retry-after en segundos. Espere ese tiempo y vuelva a intentarlo. Espacie más los reintentos ante 429 repetidos.

Reintentar con seguridad

  • Reintente los 429, 500 y los errores de red, nunca los errores 4xx que señalan un campo o un estado.
  • Envíe una cabecera Idempotency-Key (de 8 a 128 letras, dígitos, - o _) cuando reserve o lance: un reintento con la misma clave y el mismo cuerpo devuelve el primer resultado en lugar de reservar dos veces.

Última actualización