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.

Nesta página

Mostrar todos

Central de ajuda/ Identity and Access Management/ Referência de API/ API/ Gerenciamento de chaves de acesso/ Criação de uma chave de acesso permanente

Criação de uma chave de acesso permanente

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

Ver PDF

Função

Essa API pode ser usada pelo administrador para criar uma chave de acesso permanente para um usuário do IAM ou usada por um usuário do IAM para criar uma chave de acesso permanente.

As chaves de acesso são credenciais de identidade para usar ferramentas de desenvolvimento (APIs, CLI e SDKs) para acessar a Huawei Cloud. As chaves de acesso não podem ser usadas para fazer logon no console. O AK é usado em conjunto com uma SK para assinar solicitações criptograficamente, garantindo que as solicitações sejam secretas, completas e corretas. Para obter detalhes sobre como criar uma chave de acesso no console, consulte Chaves de acesso.

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-CREDENTIAL/credentials

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	Se um administrador estiver solicitando a criação de uma chave de acesso permanente para um usuário do IAM, consulte Ações. Se um usuário do IAM estiver solicitando a criação de uma chave de acesso permanente, o token do usuário (sem requisitos de permissão especiais) será necessário.

**Tabela 2** Parâmetros no corpo da solicitação
Parâmetro	Obrigatório	Tipo	Descrição
credential	Sim	Object	Informações de autenticação.

**Tabela 3** credential
Parâmetro	Obrigatório	Tipo	Descrição
user_id	Sim	String	ID do usuário do IAM que está solicitando a criação de uma chave de acesso. Para obter detalhes sobre como obter o ID de usuário, consulte Obtenção de informações sobre conta, usuário do IAM, grupo, projeto, região e agência.
description	Não	String	Descrição da chave de acesso.

Parâmetros de resposta

**Tabela 4** Parâmetros no corpo da resposta
Parâmetro	Tipo	Descrição
credential	Object	Resultado de autenticação.

**Tabela 5** credential
Parâmetro	Tipo	Descrição
create_time	String	Hora em que a chave de acesso 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.
access	String	AK.
secret	String	SK.
status	String	Status da chave de acesso. Opções: active: ativado inactive: desativado
user_id	String	ID do usuário do IAM.
description	String	Descrição da chave de acesso.

Exemplo de solicitação

Solicitação para criar uma chave de acesso permanente para um usuário do IAM cujo ID é 07609fb9358010e21f7bc003751c7c32

POST https://iam.myhuaweicloud.com/v3.0/OS-CREDENTIAL/credentials

{
    "credential": {
        "description": "IAMDescription",
        "user_id": "07609fb9358010e21f7bc003751c7c32"
    }
}

Exemplo de resposta

Código de status: 201

A chave de acesso permanente foi criada com sucesso.

{
    "credential": {
        "access": "P83EVBZJMXCYTMUII...",
        "create_time": "2020-01-08T06:25:19.014028Z",
        "user_id": "07609fb9358010e21f7bc003751...",
        "description": "IAMDescription",
        "secret": "TTqAHPbhWorg9ozx8Dv9MUyzYnOKDppxzHt...",
        "status": "active"
    }
}

Código de status: 400

Parâmetros inválidos. (O número de chaves de acesso atingiu o limite máximo permitido.)

{
    "error": {
        "message": "akSkNumExceed",
        "code": 400,
        "title": "Bad Request"
    }
}

Códigos de status

Código de status	Descrição
201	A chave de acesso permanente foi criada com sucesso.
400	Parâmetros inválidos ou o número de chaves de acesso atingiu o limite máximo permitido.
401	Falha na autenticação.
403	Acesso negado.
500	Erro de servidor interno.