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 chaves de acesso permanentes

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

Ver PDF

Consulta de chaves de acesso permanentes

Função

Essa API pode ser usada pelo administrador para consultar todas as chaves de acesso permanentes de um usuário do IAM ou usada por um usuário do IAM para consultar todas as 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

**Tabela 1** Parâmetros de consulta
Parâmetro	Obrigatório	Tipo	Descrição
user_id	Não	String	ID do usuário.

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 um usuário do IAM estiver solicitando a consulta de suas próprias chaves de acesso permanentes, o token do usuário (sem requisitos de permissão especiais) será necessário. Se o administrador estiver solicitando a consulta de todas as chaves de acesso permanentes de um usuário do IAM, consulte Ações.

Parâmetros de resposta

**Tabela 3** Parâmetros no corpo da resposta
Parâmetro	Tipo	Descrição
credentials	Array of objects	Resultado de autenticação.

**Tabela 4** credentials
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.
description	String	Descrição da chave de acesso.

Exemplo de solicitação

Solicitação para que um usuário do IAM consulte suas próprias chaves de acesso permanentes
```
GET https://iam.myhuaweicloud.com/v3.0/OS-CREDENTIAL/credentials
```
Solicitação para que um administrador consulte todas as chaves de acesso permanentes de um usuário do IAM (ID de usuário: 07609fb9358010e21f7bc003751c...)
```
GET https://iam.myhuaweicloud.com/v3.0/OS-CREDENTIAL/credentials?user_id=07609fb9358010e21f7bc0037....
```

Exemplo de resposta

Código de status: 200

A solicitação foi bem-sucedida.

{
    "credentials": [
        {
            "access": "LOSZM4YRVLKOY9E8X...",
            "create_time": "2020-01-08T06:26:08.123059Z",
            "user_id": "07609fb9358010e21f7bc0037...",
            "description": "",
            "status": "active"
        },
        {
            "access": "P83EVBZJMXCYTMU...",
            "create_time": "2020-01-08T06:25:19.014028Z",
            "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.