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

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

Ver PDF

Creación de una clave de acceso permanente

Función

Esta API puede ser utilizada por el administrador para crear una clave de acceso permanente para un usuario de IAM o utilizada por un usuario de IAM para crear una clave de acceso permanente.

Las claves de acceso son credenciales de identidad para usar herramientas de desarrollo (API, CLI y SDK) para acceder a Huawei Cloud. Las claves de acceso no se pueden utilizar para iniciar sesión en la consola. AK se utiliza junto con un SK para firmar solicitudes criptográficamente, asegurando que las solicitudes sean secretas, completas y correctas. Para obtener más información acerca de cómo crear una clave de acceso en la consola, consulte Claves de acceso.

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

POST /v3.0/OS-CREDENTIAL/credentials

Parámetros de solicitud

**Tabla 1** 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 administrador está solicitando crear una clave de acceso permanente para un usuario de IAM, consulte Acciones. Si un usuario de IAM está solicitando crear una clave de acceso permanente, se requiere el token de usuario (sin requisitos de permiso especiales) del usuario.

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

**Tabla 3** credential
Parámetro	Obligatorio	Tipo	Descripción
user_id	Sí	String	ID del usuario de IAM que solicita crear una clave de acceso. Para obtener más información acerca de cómo obtener el ID de usuario, consulte Obtención de información de cuenta, usuario de IAM, grupo, proyecto, región y delegación.
description	No	String	Descripción de la clave de acceso.

Parámetros de respuesta

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

**Tabla 5** credential
Parámetro	Tipo	Descripción
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.
access	String	AK.
secret	String	SK.
status	String	Estado de la clave de acceso. Opciones: active: Habilitado inactive: Desactivado
user_id	String	ID de usuario de IAM.
description	String	Descripción de la clave de acceso.

Solicitud de ejemplo

Solicitud de creación de una clave de acceso permanente para un usuario de IAM cuyo ID sea 07609fb9358010e21f7bc003751c7c32

POST https://iam.myhuaweicloud.com/v3.0/OS-CREDENTIAL/credentials

{
    "credential": {
        "description": "IAMDescription",
        "user_id": "07609fb9358010e21f7bc003751c7c32"
    }
}

Ejemplo de respuesta

Código de estado: 201

La clave de acceso permanente se crea correctamente.

{
    "credential": {
        "access": "P83EVBZJMXCYTMUII...",
        "create_time": "2020-01-08T06:25:19.014028Z",
        "user_id": "07609fb9358010e21f7bc003751...",
        "description": "IAMDescription",
        "secret": "TTqAHPbhWorg9ozx8Dv9MUyzYnOKDppxzHt...",
        "status": "active"
    }
}

Código de estado: 400

Parámetros no válidos. (El número de claves de acceso ha alcanzado el límite máximo permitido.)

{
    "error": {
        "message": "akSkNumExceed",
        "code": 400,
        "title": "Bad Request"
    }
}

Códigos de estado

Código de estado	Descripción
201	La clave de acceso permanente se crea correctamente.
400	Parámetros no válidos o el número de claves de acceso ha alcanzado el límite máximo permitido.
401	Error de autenticación.
403	Acceso denegado.
500	Error de servidor interno.