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/ Consulta de uma chave de acesso permanente
Atualizado em 2024-08-31 GMT+08:00
Ver PDF
Compartilhar

Consulta de uma chave de acesso permanente

Função

Essa API pode ser usada pelo administrador para consultar a chave de acesso permanente especificada de um usuário do IAM ou usada por um usuário do IAM para consultar uma de suas próprias chaves de acesso permanentes.

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

GET /v3.0/OS-CREDENTIAL/credentials/{access_key}

Tabela 1 Parâmetros de URI

Parâmetro

Obrigatório

Tipo

Descrição

access_key

Sim

String

AK da chave de acesso a ser consultada.

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

Se o administrador estiver solicitando consultar uma chave de acesso permanente especificada de um usuário do IAM, consulte Ações.

Se um usuário do IAM estiver solicitando a consulta de uma de suas próprias chaves de acesso permanentes, o token do usuário (sem requisitos de permissão especiais) será necessário.

Parâmetros de resposta

Tabela 3 Parâmetros no corpo da resposta

Parâmetro

Tipo

Descrição

credential

Object

Resultado de autenticação.
Tabela 4 credential

Parâmetro

Tipo

Descrição

user_id

String

ID do usuário do IAM.

access

String

AK.

status

String

Status da chave de acesso.

Opções:

  • active: ativado
  • inactive: desativado

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.

last_use_time

String

A última vez que a chave de acesso foi usada. Se a chave de acesso nunca foi usada, o tempo de criação da chave de acesso é retornado.

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 chave de acesso.

Exemplo de solicitação

Solicitação para que um usuário do IAM consulte sua chave de acesso permanente específica

 GET https://iam.myhuaweicloud.com/v3.0/OS-CREDENTIAL/credentials/{access_key}

Exemplo de resposta

Código de status: 200

A solicitação foi bem-sucedida.

{
    "credential": {
        "last_use_time": "2020-01-08T06:26:08.123059Z",
        "access": "LOSZM4YRVLKOY9E8...",
        "create_time": "2020-01-08T06:26:08.123059Z",
        "user_id": "07609fb9358010e21f7bc003751...",
        "description": "",
        "status": "active"
    }
}

Códigos de status

Código de status

Descrição

200

A solicitação foi bem-sucedida.

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.

Códigos de erro

Nenhum