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

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.