Modificação da política de senha
Função
Essa API é fornecida para que o administrador modifique a política de senha.
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-SECURITYPOLICY/domains/{domain_id}/password-policy
| 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
| 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âmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| Sim | object | Política de senha. |
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| maximum_consecutive_identical_chars | Não | Integer | Número máximo de vezes que um caractere pode ser apresentado consecutivamente em uma senha. Intervalo de valores: 0–32. |
| minimum_password_age | Não | Integer | Período mínimo (minutos) após o qual os usuários têm permissão para fazer uma alteração de senha. Intervalo de valores: 0–1440. |
| minimum_password_length | Não | Integer | Número mínimo de caracteres que uma senha deve conter. Intervalo de valores: 6–32. |
| number_of_recent_passwords_disallowed | Não | Integer | Número de senhas usadas anteriormente que não são permitidas. Intervalo de valores: 0–10. |
| password_not_username_or_invert | Não | Boolean | Indica se a senha pode ser o nome de usuário ou o nome de usuário escrito ao contrário. |
| password_validity_period | Não | Integer | Período de validade da senha (dias). Intervalo de valores: 0–180. O valor 0 indica que este requisito não se aplica. |
| password_char_combination | Não | Integer | Número mínimo de tipos de caracteres que uma senha deve conter. Intervalo de valores: 2–4. |
Parâmetros de resposta
| Parâmetro | Tipo | Descrição |
|---|---|---|
| object | Política de senha. |
| 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 de alteração da política de senha para o seguinte: deve conter pelo menos 6 caracteres, pelo menos 3 tipos de caracteres, não pode ser o mesmo que as duas últimas senhas, o período mínimo de validade deve ser de 20 minutos, o período de validade da senha deve ser de 60 dias, os mesmos caracteres podem ser usados consecutivamente por um máximo de três vezes e não pode ser o mesmo que o nome de usuário ou o nome de usuário escrito ao contrário
PUT https://iam.myhuaweicloud.com/v3.0/OS-SECURITYPOLICY/domains/{domain_id}/password-policy
{
"password_policy" : {
"minimum_password_length" : 6,
"number_of_recent_passwords_disallowed" : 2,
"minimum_password_age" : 20,
"password_validity_period" : 60,
"maximum_consecutive_identical_chars" : 3,
"password_not_username_or_invert" : false,
"password_char_combination" : 3
}
} 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: 400
O corpo de solicitação é anormal.
- Exemplo 1
{
"error_msg" : "'%(key)s' is a required property.",
"error_code" : "IAM.0072"
} - Exemplo 2
{
"error_msg" : "Invalid input for field '%(key)s'. The value is '%(value)s'.",
"error_code" : "IAM.0073"
} 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: 500
O sistema está anormal.
{
"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. |
| 400 | O corpo de solicitação é anormal. |
| 401 | Falha na autenticação. |
| 403 | Acesso negado. |
| 500 | O sistema está anormal. |
Códigos de erro
Para obter detalhes, consulte Códigos de erro.
