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 da região específica. Para pontos de extremidade do IAM, consulte Regiões e pontos de extremidade.
URI
PUT /v3.0/OS-AGENCY/agencies/{agency_id}
Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
agency_id | Sim | String | ID da agência. Para obter detalhes sobre como obter o ID da agência, 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 |
|---|---|---|---|
Content-Type | Sim | String | Preencha application/json;charset=utf8 nesse campo. |
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 | Informações da agência. |
Parâmetro | Obrigatório | 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 | Período 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 | Hora em que a agência foi criada. NOTA: O valor é uma hora UTC no formato AAAA-MM-DDTHH:mm:ss.ssssssZ, por exemplo, 2023-06-28T08:56:33.710000Z. Para obter detalhes sobre os formatos de data e carimbo de data/hora, consulte ISO-8601. |
description | String | Descrição da agência. |
domain_id | String | ID da conta delegada. |
duration | String | Período de validade da agência. Unidade: hora.
|
expire_time | String | Tempo de expiração da agência. O valor null indica que a agência tem validade ilimitada. NOTA: O valor é uma hora UTC no formato AAAA-MM-DDTHH:mm:ss.ssssssZ, por exemplo, 2023-06-28T08:56:33.710000Z. Para obter detalhes sobre os formatos de data e carimbo de data/hora, consulte ISO-8601. |
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
Solicitação para alterar o período de validade de uma agência para um dia.
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 | Falha na autenticação. |
403 | Acesso negado. |
404 | O recurso solicitado não pode ser encontrado. |
500 | Erro de servidor interno. |
Códigos de erro
Nenhum
