Documentação do Oracle Cloud Infrastructure

Códigos de Status HTTP da API de MFA de Autenticação e Sob Demanda

As APIs de Autenticação Multifator (MFA) sob Demanda e Autenticação para domínios de identidade no serviço IAM são compatíveis com REST e usam códigos de status de resposta HTTP padrão para indicar falha.

Esta tabela descreve os diferentes códigos de status e os casos de uso em que esses códigos de status são enviados.

Consulte a seção Definições de Código de Status do Protocolo de Transferência de Hipertexto -- HTTP/1.1.

Código de Status HTTP

 Caso de Uso

Exemplo de Corpo de Resposta JSON
400 Bad Request

Este código indica uma solicitação inválida. Este código será enviado se algum atributo for fornecido com um valor inválido no payload, o que significa problemas de sintaxe.

 
{
    "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 acesso não autorizado. Isso é usado quando o requestState é inválido ou expirou, ou o ID do otpCode fornecido durante a autenticação é inválido.

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

Este código é usado quando a solicitação está sintaticamente correta, mas semanticamente errada. 422 significa que a solicitação é uma entidade não processável. Por exemplo, quando a solicitação está sem o atributo op, que é obrigatório para uma determinada ação.

 
{
    "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 um erro interno do servidor. Quando esse erro ocorre, a resposta contém ecId e a causa para que o cliente possa entrar em contato com o administrador para obter mais detalhes.