Modificação de uma agência
Função
Esta API é fornecida para que o administrador modifique uma agência.
A API pode ser chamada usando o ponto de extremidade global e pontos de extremidade específicos da região. Para pontos de extremidade do IAM, consulte Regiões e pontos de extremidade.
URI
PUT /v3.0/OS-AGENCY/agencies/{agency_id}
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
agency_id |
Sim |
String |
ID da agência. Para obter detalhes sobre como obter uma ID de agência, consulte Obtenção de informações de conta, usuário do IAM, grupo, projeto, região e agência. |
Parâmetros de solicitação
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
Content-Type |
Sim |
String |
Preencha application/json;charset=utf8 neste campo. |
X-Auth-Token |
Sim |
String |
Consulte Ações. |
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
Sim |
object |
Informações da agência. |
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
trust_domain_id |
Não |
String |
ID da conta delegada. Se ambos trust_domain_id e trust_domain_name forem especificados, trust_domain_name terá precedência. Pelo menos um destes quatro parâmetros deve ser especificado para a agência. |
trust_domain_name |
Não |
String |
Nome da conta delegada. Se ambos trust_domain_id e trust_domain_name forem especificados, trust_domain_name terá precedência. Pelo menos um destes quatro parâmetros deve ser especificado para a agência. |
description |
Não |
String |
Descrição da agência, que deve conter menos ou igual a 255 caracteres. Pelo menos um destes quatro parâmetros deve ser especificado para a agência. |
duration |
Não |
String |
Prazo de validade da agência. Unidade: dia. Pelo menos um destes quatro parâmetros deve ser especificado para a agência. Opções:
|
Parâmetros de resposta
Parâmetro |
Tipo |
Descrição |
---|---|---|
object |
Informações da agência. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
create_time |
String |
Momento em que a agência foi criada. |
description |
String |
Descrição da agência. |
domain_id |
String |
ID da conta que delega. |
duration |
String |
Prazo de validade da agência. Unidade: hora.
|
expire_time |
String |
Prazo de expiração da agência. null indica que a agência tem validade ilimitada. |
id |
String |
ID da agência. |
name |
String |
Nome da agência. |
trust_domain_id |
String |
ID da conta delegada. |
trust_domain_name |
String |
Nome da conta delegada. |
Exemplo de solicitação
PUT https://iam.myhuaweicloud.com/v3.0/OS-AGENCY/agencies/{agency_id}
{ "agency": { "trust_domain_id": "b2cd82a33fb043dc9304bf72...", "trust_domain_name": "IAMDomainB", "description": "IAMDescription", "duration": "ONEDAY" } }
Exemplo de resposta
Código de status: 200
A agência foi modificada com sucesso.
{ "agency": { "description": "IAMDescription", "trust_domain_id": "b2cd82a33fb043dc9304bf72a0...", "id": "0760a9e2a60026664f1fc0031f9f205e", "duration": "ONEDAY", "create_time": "2020-01-04T03:37:16.000000", "expire_time": "2020-01-21T13:06:11.241588", "domain_id": "d78cbac186b744899480f25...", "name": "IAMAgency" } }
Códigos de status
Código de status |
Descrição |
---|---|
200 |
A agência foi modificada com sucesso. |
400 |
Parâmetros inválidos. |
401 |
Autenticação falhou. |
403 |
Acesso negado. |
404 |
O recurso solicitado não pode ser encontrado. |
500 |
Erro de servidor interno. |
Códigos de erro
Nenhum