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/Criação de uma agência
Atualizado em 2024-08-31 GMT+08:00
Ver PDF
Compartilhar

Criação de uma agência

Função

Esta API é fornecida para o administrador criar 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

POST /v3.0/OS-AGENCY/agencies

Parâmetros de solicitação

Tabela 1 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 2 Parâmetros no corpo da solicitação

Parâmetro

Obrigatório

Tipo

Descrição

agency

Sim

object

Informações da agência.

Tabela 3 agency

Parâmetro

Obrigatório

Tipo

Descrição

name

Sim

String

Nome da agência, que deve conter menos ou igual a 64 caracteres.

domain_id

Sim

String

ID da conta delegada.

trust_domain_id

Não

String

ID da conta delegada. Tanto trust_domain_id ou trust_domain_name deve ser especificado. Se ambos forem especificados, trust_domain_name terá precedência.

trust_domain_name

Não

String

Nome da conta delegada. Tanto trust_domain_id ou trust_domain_name deve ser especificado. Se ambos forem especificados, trust_domain_name terá precedência.

description

Não

String

Descrição da agência, que deve conter menos ou igual a 255 caracteres.

duration

Não

String

Período de validade da agência. Unidade: dia. Valor padrão: FOREVER.

Opções:

  • FOREVER: a agência tem validade ilimitada.
  • ONEDAY: a agência é válida por um dia.
  • Dias específicos: a agência tem validade limitada de, por exemplo, 20 dias.

Parâmetros de resposta

Tabela 4 Parâmetros no corpo da resposta

Parâmetro

Tipo

Descrição

agency

object

Informações da agência.

Tabela 5 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. 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 criar uma agência chamada IAMAgency com um período de validade ilimitado para a conta delegada cujo ID é c2cd82a33fb043dc9304bf72a... e cujo nome é IAMDomainB

POST https://iam.myhuaweicloud.com/v3.0/OS-AGENCY/agencies
{
    "agency": {
        "name": "IAMAgency",
        "domain_id": "d78cbac186b744899480f25bd...",
        "trust_domain_id": "c2cd82a33fb043dc9304bf72a...",
        "trust_domain_name": "IAMDomainB",
        "duration": "FOREVER",
        "description": "IAMDescription"
    }
}

Exemplo de resposta

Código de status: 201

A agência é criada com sucesso.

{
    "agency": {
        "description": "IAMDescription",
        "trust_domain_id": "a2cd82a33fb043dc9304bf72a0f...",
        "id": "078ade0fc20010004f8fc0034fad529d",
        "duration": "FOREVER",
        "create_time": "2020-01-20T12:59:20.811642",
        "expire_time": null,
        "domain_id": "d78cbac186b744899480f25bd02...",
        "name": "IAMAgency"
    }
}

Códigos de status

Código de status

Descrição

201

A agência é criada com sucesso.

400

Parâmetros inválidos.

401

Falha na autenticação.

403

Acesso negado.

404

O recurso solicitado não pode ser encontrado.

409

Ocorre um conflito de recursos.

500

Erro de servidor interno.

Códigos de erro

Nenhum

Tópico principal:Gerenciamento de agências