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/ Gerenciamento de agências/ Modificação de uma agência

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

Ver PDF

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}

**Tabela 1** Parâmetros de URI
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

**Tabela 2** Parâmetros no cabeçalho da 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.

**Tabela 3** Parâmetros no corpo da solicitação
Parâmetro	Obrigatório	Tipo	Descrição
agency	Sim	object	Informações da agência.

**Tabela 4** agency
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: FOREVER: a agência tem validade ilimitada. ONEDAY: a agência é válida por um dia. Dias específicos: a agência é válida por um número específico de dias, por exemplo, 20 dias.

Parâmetros de resposta

**Tabela 5** Parâmetros no corpo da resposta
Parâmetro	Tipo	Descrição
agency	object	Informações da agência.

**Tabela 6** agency
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. FOREVER/null: a agência tem validade ilimitada. 24: a agência é válida por 24 horas. XXX: a agência tem validade limitada de, por exemplo, 480 horas.
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.