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 claves de acceso permanente

Actualización más reciente 2024-08-01 GMT+08:00

Ver PDF

Consulta de claves de acceso permanente

Función

Esta API puede ser utilizada por el administrador para consultar toda la clave de acceso permanente de un usuario de IAM o utilizada por un usuario de IAM para consultar todas 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

**Tabla 1** Parámetros de consulta
Parámetro	Obligatorio	Tipo	Descripción
user_id	No	String	ID de usuario.

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 un usuario de IAM está solicitando consultar sus propias claves de acceso permanente, se requiere el token de usuario (sin requisitos de permiso especiales) del usuario. Si el administrador está solicitando consultar todas las claves de acceso permanentes de un usuario de IAM, consulte Acciones.

Parámetros de respuesta

**Tabla 3** Parámetros en el cuerpo de respuesta
Parámetro	Tipo	Descripción
credentials	Array of objects	Resultado de autenticación.

**Tabla 4** credentials
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.
description	String	Descripción de la clave de acceso.

Solicitud de ejemplo

Solicitud de un usuario de IAM para consultar sus propias claves de acceso permanentes
```
GET https://iam.myhuaweicloud.com/v3.0/OS-CREDENTIAL/credentials
```
Solicitud de un administrador para consultar todas las claves de acceso permanentes de un usuario de IAM (ID de usuario: 07609fb9358010e21f7bc003751c...)
```
GET https://iam.myhuaweicloud.com/v3.0/OS-CREDENTIAL/credentials?user_id=07609fb9358010e21f7bc0037....
```

Ejemplo de respuesta

Código de estado: 200

La solicitud se ha realizado correctamente.

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