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 chaves de acesso/ Criação de uma chave de acesso permanente

Atualizado em 2023-02-16 GMT+08:00

Ver PDF

Criação de uma chave de acesso permanente

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 teclas de acesso não podem ser usadas para efetuar login no console. O AK é usado em conjunto com um 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 do acesso.

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

POST /v3.0/OS-CREDENTIAL/credentials

Parâmetros de solicitação

**Tabela 1** Parâmetros no cabeçalho da solicitação
Parâmetro	Obrigatoriedade	Tipo	Descrição
Content-Type	Sim	String	Preencha application/json;charset=utf8 neste 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 está solicitando a criação de uma chave de acesso permanente, o token do usuário (sem requisitos de permissão especiais) é necessário.

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

**Tabela 3** credential
Parâmetro	Obrigatoriedade	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 de 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 da autenticação.

**Tabela 5** credential
Parâmetro	Tipo	Descrição
create_time	String	Hora em que a chave de acesso foi criada.
access	String	AK.
secret	String	SK.
status	String	Status da chave de acesso.
user_id	String	ID do usuário do IAM.
description	String	Descrição da chave de acesso.

Exemplo de solicitação

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 teclas 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	Autenticação falhou.
403	Acesso negado.
500	Erro de servidor interno.