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/ Criação de um dispositivo de MFA virtual

Atualizado em 2024-08-31 GMT+08:00

Ver PDF

Criação de um dispositivo de MFA virtual

Função

Esta API é fornecida para que os usuários do IAM criem um 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

POST /v3.0/OS-MFA/virtual-mfa-devices

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	Token (sem requisitos especiais de permissão) do usuário do IAM correspondente ao user_id especificado no corpo da solicitação.

**Tabela 2** Parâmetro no corpo da solicitação
Parâmetro	Obrigatório	Tipo	Descrição
virtual_mfa_device	Sim	object	Informações do dispositivo de MFA.

**Tabela 3** virtual_mfa_device
Parâmetro	Obrigatório	Tipo	Descrição
name	Sim	String	Nome do dispositivo. Comprimento mínimo: 1 caractere Comprimento máximo: 64 caracteres
user_id	Sim	String	ID do usuário do IAM para o qual você criará o dispositivo de MFA.

Parâmetros de resposta

Código de status: 201

**Tabela 4** Parâmetros no corpo da resposta
Parâmetro	Tipo	Descrição
virtual_mfa_device	object	Informações sobre o dispositivo de MFA virtual.

**Tabela 5** virtual_mfa_device
Parâmetro	Tipo	Descrição
serial_number	String	Número de série do dispositivo de MFA virtual.
base32_string_seed	String	Semente Base32, que um sistema de terceiros pode usar para gerar um código CAPTCHA.

Exemplo de solicitação

Solicitação para criar um dispositivo de MFA virtual

POST https://iam.myhuaweicloud.com/v3.0/OS-MFA/virtual-mfa-devices 
 
{ 
  "virtual_mfa_device" : { 
    "name" : "{device_name}", 
    "user_id" : "09f99d8f6a001d4f1f01c00c31968..." 
  } 
}

Exemplo de resposta

Código de status: 201

A solicitação foi bem-sucedida.

{
  "virtual_mfa_device": {
    "serial_number": "iam:09f6bd6a96801de40f01c00c85691...:mfa/{device_name}",
    "base32_string_seed": "{string}"
  }
}

Códigos de status

Código de status	Descrição
201	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.
500	Ocorreu um erro no sistema.