Documentación de Oracle Cloud Infrastructure

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

Las API de autenticación y autenticación multifactor (MFA) bajo demanda para dominios de identidad en 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 distintos 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 de HTTP

 Caso de uso

Cuerpo de respuesta JSON de ejemplo
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. Esto 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 la solicitud no tiene 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 interno del servidor. 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.