Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/ Identity and Access Management/ Referência de API/ API/ Configurações de segurança/ Desvinculação de um dispositivo de MFA virtual
Atualizado em 2024-08-31 GMT+08:00
Ver PDF
Compartilhar

Desvinculação de um dispositivo de MFA virtual

Função

Essa API é usada pelo administrador para desvincular um dispositivo de MFA virtual de um usuário do IAM ou usada por um usuário do IAM para desvincular seu próprio dispositivo de MFA virtual.

A API pode ser chamada usando o ponto de extremidade global e pontos de extremidade da região específica. Para pontos de extremidade do IAM, consulte Regiões e pontos de extremidade.

URI

PUT /v3.0/OS-MFA/mfa-devices/unbind

Parâmetros de solicitação

Tabela 1 Parâmetros no cabeçalho da solicitação

Parâmetro

Obrigatório

Tipo

Descrição

X-Auth-Token

Sim

String
  • Se o administrador estiver solicitando a desvinculação de um dispositivo de MFA virtual de um usuário do IAM, consulte Ações.
  • Se um usuário do IAM estiver solicitando a desvinculação de seu próprio dispositivo de MFA virtual, o token do usuário (sem requisitos de permissão especiais) será necessário.
Tabela 2 Parâmetro no corpo da solicitação

Parâmetro

Obrigatório

Tipo

Descrição

user_id

Sim

String

ID do usuário do qual você desvinculará o dispositivo de MFA.

authentication_code

Sim

String
  • Administrador: insira um código de verificação aleatório de 6 dígitos.
  • Usuário do IAM: insira o código de verificação de MFA.

serial_number

Sim

String

Número de série do dispositivo de MFA virtual.

Parâmetros de resposta

Nenhum

Exemplo de solicitação

Solicitação para desvincular um dispositivo de MFA cujo número de série é iam:09f6bd6a96801de40f01c00c85691...:mfa/{device_name}. O código de verificação é 373658.

PUT https://iam.myhuaweicloud.com/v3.0/OS-MFA/mfa-devices/unbind 

{ 
  "user_id" : "09f99d8f6a001d4f1f01c00c31968...", 
  "authentication_code" : "373658", 
  "serial_number" : "iam:09f6bd6a96801de40f01c00c85691...:mfa/{device_name}" 
}

Exemplo de resposta

Código de status: 204

A solicitação foi bem-sucedida.

Códigos de status

Código de status

Descrição

204

A solicitação foi bem-sucedida.

400

A solicitação é inválida.

401

Falha na autenticação.

403

Você não tem permissão para executar esta ação.

404

O recurso solicitado não pode ser encontrado.

409

Um conflito ocorre quando o recurso solicitado é salvo.

500

Ocorreu um erro no sistema.

Códigos de erro

Para obter detalhes, consulte Códigos de erro.

Tópico principal: Configurações de segurança