Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda> Identity and Access Management> Referencia de la API> API> Gestión de claves de acceso> Consulta de una clave de acceso permanente

Actualización más reciente 2022-11-08 GMT+08:00

Ver PDF

Consulta de una clave de acceso permanente

Función

Esta API puede ser utilizada por el administrador para consultar la clave de acceso permanente especificada de un usuario de IAM o utilizada por un usuario de IAM para consultar una de sus propias claves de acceso permanente.

Se puede llamar a la API utilizando tanto el punto de conexión global como los puntos de conexión específicos de la región. Para los puntos finales de IAM, consulte Regions y puntos de conexión.

URI

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

**Tabla 1** Parámetros de URI
Parámetro	Obligatorio	Tipo	Descripción
access_key	Sí	String	AK de la clave de acceso a consultar.

Parámetros de solicitud

**Tabla 2** Parámetros en el encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
Content-Type	Sí	String	Rellene application/json;charset=utf8 en este campo.
X-Auth-Token	Sí	String	Si el administrador está solicitando consultar una clave de acceso permanente especificada de un usuario de IAM, consulte Acciones. Si un usuario de IAM está solicitando consultar una de sus propias claves de acceso permanente, se requiere el token de usuario (sin requisitos de permiso especiales) del usuario.

Parámetros de respuesta

**Tabla 3** Parámetros en el cuerpo de respuesta
Parámetro	Tipo	Descripción
credential	Object	Resultado de autenticación.

**Tabla 4** credential
Parámetro	Tipo	Descripción
user_id	String	ID de usuario de IAM.
access	String	AK.
status	String	Estado de la clave de acceso.
create_time	String	Hora en la que se creó la clave de acceso.
last_use_time	String	Hora en la que se utilizó por última vez la clave de acceso.
description	String	Descripción de la clave de acceso.

Solicitud de ejemplo

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

Ejemplo de respuesta

Código de estado: 200

La solicitud se ha realizado correctamente.

{
    "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 estado

Código de estado	Descripción
200	La solicitud se ha realizado correctamente.
400	Parámetros no válidos.
401	Error de autenticación.
403	Acceso denegado.
404	No se puede encontrar el recurso solicitado.
500	Error de servidor interno.