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/ Modificación de una clave de acceso permanente

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

Ver PDF

Modificación de una clave de acceso permanente

Función

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

PUT /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 modificar.

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

**Tabla 3** Parámetros en el cuerpo de la solicitud
Parámetro	Obligatorio	Tipo	Descripción
credential	Sí	Object	Información de autenticación.

**Tabla 4** credential
Parámetro	Obligatorio	Tipo	Descripción
status	No	String	Estado de la clave de acceso. Opciones: active: Habilitado inactive: Desactivado
description	No	String	Descripción de la clave de acceso.

Parámetros de respuesta

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

**Tabla 6** credencial
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

Solicitar que un usuario de IAM inhabilite su clave de acceso permanente específica

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

{
    "credential": {
        "status": "inactive",
        "description": "IAMDescription"
    }
}

Ejemplo de respuesta

Código de estado: 200

La solicitud se ha realizado correctamente.

{
    "credential": {
        "status": "inactive",
        "access": "LOSZM4YRVLKOY9...",
        "create_time": "2020-01-08T06:26:08.123059Z",
        "user_id": "07609fb9358010e21f7bc00375..."
    }
}

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.