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
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. |
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
Sim |
Object |
Informações da autenticação. |
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
Parâmetro |
Tipo |
Descrição |
---|---|---|
Object |
Resultado da autenticação. |
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. |
Códigos de erro
Nenhum