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/ Consulta da política de senha de uma conta

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

Ver PDF

Consulta da política de senha de uma conta

Função

Essa API é usada para consultar a política de senha de uma conta.

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

GET /v3.0/OS-SECURITYPOLICY/domains/{domain_id}/password-policy

**Tabela 1** Parâmetros de URI
Parâmetro	Obrigatório	Tipo	Descrição
domain_id	Sim	String	ID da conta. Para obter detalhes sobre como obter o ID da conta, consulte Obtenção de informações sobre conta, usuário do IAM, grupo, projeto, região e agência.

Parâmetros de solicitação

**Tabela 2** Parâmetros no cabeçalho da solicitação
Parâmetro	Obrigatório	Tipo	Descrição
X-Auth-Token	Sim	String	Token de acesso emitido para um usuário para suportar sua identidade e permissões. Para obter detalhes sobre as permissões exigidas pelo token, consulte Ações.

Parâmetros de resposta

**Tabela 3** Parâmetros no corpo da resposta
Parâmetro	Tipo	Descrição
password_policy	object	Política de senha.

**Tabela 4** password_policy
Parâmetro	Tipo	Descrição
maximum_consecutive_identical_chars	Integer	Número máximo de vezes que um caractere pode ser apresentado consecutivamente em uma senha.
maximum_password_length	Integer	Número máximo de caracteres que uma senha pode conter.
minimum_password_age	Integer	Período mínimo (minutos) após o qual os usuários têm permissão para fazer uma alteração de senha.
minimum_password_length	Integer	Número mínimo de caracteres que uma senha deve conter.
number_of_recent_passwords_disallowed	Integer	Número de senhas usadas anteriormente que não são permitidas.
password_not_username_or_invert	Boolean	Indica se a senha pode ser o nome de usuário ou o nome de usuário escrito ao contrário.
password_requirements	String	Caracteres que uma senha deve conter.
password_validity_period	Integer	Período de validade da senha (dias).
password_char_combination	Integer	Número mínimo de tipos de caracteres que uma senha deve conter. Intervalo de valores: 2–4.

Exemplo de solicitação

Solicitação para consultar a política de senha de uma conta

GET https://iam.myhuaweicloud.com/v3.0/OS-SECURITYPOLICY/domains/{domain_id}/password-policy

Exemplo de resposta

Código de status: 200

A solicitação foi bem-sucedida.

{ 
  "password_policy" : { 
    "password_requirements" : "A password must contain at least two of the following: uppercase letters, lowercase letters, digits, and special characters.", 
    "minimum_password_age" : 20, 
    "minimum_password_length" : 8, 
    "maximum_password_length" : 32, 
    "number_of_recent_passwords_disallowed" : 2, 
    "password_validity_period" : 60, 
    "maximum_consecutive_identical_chars" : 3, 
    "password_not_username_or_invert" : true,
    "password_char_combination" : 3
  } 
}

Código de status: 403

Acesso negado.

Exemplo 1

{ 
   "error_msg" : "You are not authorized to perform the requested action.", 
   "error_code" : "IAM.0002" 
 }

Exemplo 2

{ 
   "error_msg" : "Policy doesn't allow %(actions)s to be performed.", 
   "error_code" : "IAM.0003" 
 }

Código de status: 404

O recurso solicitado não pode ser encontrado.

{ 
  "error_msg" : "Could not find %(target)s: %(target_id)s.", 
  "error_code" : "IAM.0004" 
}

Código de status: 500

Erro de servidor interno.

{ 
  "error_msg" : "An unexpected error prevented the server from fulfilling your request.", 
  "error_code" : "IAM.0006" 
}

Códigos de status

Código de status	Descrição
200	A solicitação foi bem-sucedida.
401	Falha na autenticação.
403	Acesso negado.
404	O recurso solicitado não pode ser encontrado.
500	Erro de servidor interno.