Documentación de Oracle Cloud Infrastructure

Códigos de estado HTTP de la API de autenticación multifactor bajo demanda y autenticación

Las API de autenticación y autenticación multifactor (MFA) bajo demanda para dominios de identidad de IAM son compatibles con REST y utilizan códigos de estado de respuesta HTTP estándar para indicar un fallo.

En esta tabla se describen los diferentes códigos de estado y los casos de uso en los que se envían estos códigos de estado.

Consulte la sección Definiciones de Código de Estado del protocolo de transferencia de hipertexto: HTTP/1.1.

Código de estado HTTP

 Caso de uso

Cuerpo de respuesta de JSON de muestra
400 Bad Request

Este código indica una solicitud incorrecta. Este código se envía si se proporciona algún atributo con un valor no válido en la carga útil, lo que significa problemas de sintaxis.

 
{
    "status": "failed",
    "ecid": "Suwmo0F0000000000",
    "cause":
            [
                {
                    "message": "Invalid value [EMAILS] for attribute authFactor. One of [USERNAME_PASSWORD,PUSH,TOTP,EMAIL,SMS,BYPASSCODE, SECURITY_QUESTIONS] was expected.",
                    "code": "AUTH-1111"
                }
            ],
    "requestState": "bnJ7Qkz2Vff0RNuxwcJQwnaQFA"
}
401 Unauthorized

Este código indica el acceso no autorizado. Se utiliza cuando requestState no es válido o ha caducado o el ID de otpCode proporcionado durante la autenticación no es válido.

 
{
    "status": "failed",
    "ecid": "3YkZh1H0000000000",
    "cause":
            [
                {
                    "message": "You entered an incorrect username or password.",
                    "code": "AUTH-3001"
                }
            ],
    "requestState": "b0EYFnXpo"
}
422

Este código se utiliza cuando la solicitud es sintácticamente correcta, pero semánticamente incorrecta. 422 significa que la solicitud es una entidad no procesable. Por ejemplo, cuando a la solicitud le falta el atributo op, que es obligatorio para una acción determinada.

 
{
    "status": "failed",
    "ecid": "KIN^r0J0000000000",
    "nextOp": ["credSubmit"],
    "cause":
            [
                {
                    "message": "Your input request is missing the op attribute, which is mandatory.",
                    "code": "AUTH-1111"
                }
            ],
    "requestState": "b0EYFnLpFWEihmJ6btqTXpo",
    "USERNAME_PASSWORD":
            {
                "credentials": ["username", "password"]
            },
    "nextAuthFactors": ["USERNAME_PASSWORD"]
}
500 Internal Server Error

Este código indica un error de servidor interno. Cuando se produce este error, la respuesta contiene ecId y la causa para que el cliente pueda ponerse en contacto con el administrador para obtener más información.