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 2024-08-01 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 invocar 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 de conexión de IAM, consulte Regiones 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. Opciones: active: Habilitado inactive: Desactivado
create_time	String	Hora en la que se creó la clave de acceso. NOTA: El valor es una hora UTC en el formato AAAA-MM-DDTHH:mm:ss.ssssssZ, por ejemplo, 2023-06-28T08:56:33.710000Z. Para obtener más información sobre los formatos de fecha y hora, consulte ISO-8601.
last_use_time	String	La última vez que se usó la clave de acceso. Si la clave de acceso nunca se ha utilizado, se devuelve el tiempo de creación de la clave de acceso. NOTA: El valor es una hora UTC en el formato AAAA-MM-DDTHH:mm:ss.ssssssZ, por ejemplo, 2023-06-28T08:56:33.710000Z. Para obtener más información sobre los formatos de fecha y hora, consulte ISO-8601.
description	String	Descripción de la clave de acceso.

Solicitud de ejemplo

Solicitud de un usuario de IAM para consultar su clave de acceso permanente específica

 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.