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 políticas personalizadas/ Modificación de una directiva personalizada para servicios en la nube

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

Ver PDF

Modificación de una directiva personalizada para servicios en la nube

Función

Esta API se proporciona para que el administrador modifique una política personalizada para los servicios en la nube.

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

PATCH /v3.0/OS-ROLE/roles/{role_id}

**Tabla 1** Parámetros de URI
Parámetro	Obligatorio	Tipo	Descripción
role_id	Sí	String	ID de política personalizado. Para obtener más información sobre cómo obtener un ID de política personalizado, consulte ID de política personalizado.

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	Token de acceso emitido a un usuario para acreditar su identidad y sus permisos. Para obtener más información sobre los permisos requeridos por el token, consulte Acciones.

**Tabla 3** Parámetros en el cuerpo de la solicitud
Parámetro	Obligatorio	Tipo	Descripción
role	Sí	Object	Información de política personalizada.

**Tabla 4** role
Parámetro	Obligatorio	Tipo	Descripción
display_name	Sí	String	Nombre para mostrar de la política personalizada.
type	Sí	String	Modo de visualización. NOTA: AX: el proyecto de servicio global XA: proyectos específicos de la región Establezca el modo de visualización de una política personalizada en AX o XA.
description	Sí	String	Descripción de la política personalizada.
description_cn	No	String	Descripción de la política personalizada en chino.
policy	Sí	Object	Contenido de la política personalizada.

**Tabla 5** role.policy
Parámetro	Obligatorio	Tipo	Descripción
Version	Sí	String	Versión de política. Al crear una política personalizada, establezca este parámetro en 1.1. NOTA: 1.0: Función definida por el sistema. Solo se proporciona un número limitado de roles de nivel de servicio para la autorización. 1.1: Política. Una política define los permisos necesarios para realizar operaciones en un recurso de nube específico bajo ciertas condiciones.
Statement	Sí	Array of objects	Sentencia de la política. Una política puede contener un máximo de ocho sentencias.

**Tabla 6** role.policy.Statement
Parámetro	Obligatorio	Tipo	Descripción
Action	Sí	Array of strings	Permisos de operación específicos en un recurso. Para obtener más información sobre las acciones admitidas, consulte "Permisos y acciones admitidas" en la Referencia de API de servicios en la nube. NOTA: El formato de valor es Service name:Resource type:Operation, por ejemplo, vpc:ports:create. Service name: indica el nombre del producto, como ecs, evs, o vpc. Solo se permiten letras minúsculas. Los tipos de recursos y las operaciones no distinguen entre mayúsculas y minúsculas.You can use an asterisk (*) to represent all operations.
Effect	Sí	String	Efectos del permiso. El valor puede ser Allow o Deny. Si las sentencias Allow y Deny se encuentran en una política, la autenticación comienza desde las sentencias Deny. Opciones: Allow Deny
Condition	No	Map<String,Map<String,Array<String>>>	Condiciones para que el permiso entre en vigor. Para obtener más información, consulte Creación de una política personalizada. NOTA: Tome la condición en la solicitud de ejemplo como un ejemplo, los valores de la clave de condición (obs:prefix) y cadena (public) deben ser iguales (StringEquals). "Condition": { "StringEquals": { "obs:prefix": [ "public" ] } }
Resource	No	Array of strings	Recurso en la nube. NOTA: Formato: ::::. Por ejemplo, obs:::bucket:. Se permiten asteriscos. El segmento de región puede ser o una región accesible para el usuario. El recurso especificado debe pertenecer al servicio correspondiente que realmente existe.

Parámetros de respuesta

**Tabla 7** Parámetros en el cuerpo de respuesta
Parámetro	Tipo	Descripción
role	Object	Información de política personalizada.

**Tabla 8** role
Parámetro	Tipo	Descripción
catalog	String	Catálogo de servicios.
display_name	String	Nombre para mostrar de la política personalizada.
description	String	Descripción de la política personalizada.
links	Object	Enlace de recurso de la política personalizada.
policy	Object	Contenido de la política personalizada.
description_cn	String	Descripción de la política personalizada en chino.
domain_id	String	ID de cuenta.
type	String	Modo de visualización. NOTA: AX: el proyecto de servicio global XA: proyectos específicos de la región Establezca el modo de visualización de una política personalizada en AX o XA.
id	String	ID de política personalizado.
name	String	Nombre de la política personalizada.
updated_time	String	Hora en la que se actualizó por última vez la política personalizada. 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.
created_time	String	Hora en la que se creó la política personalizada. 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.
references	String	Número de referencias.

**Tabla 9** role.links
Parámetro	Tipo	Descripción
self	String	Enlace de recurso.

**Tabla 10** role.policy
Parámetro	Tipo	Descripción
Version	String	Versión de política. NOTA: 1.0: Función definida por el sistema. Solo se proporciona un número limitado de roles de nivel de servicio para la autorización. 1.1: Política. Una política define los permisos necesarios para realizar operaciones en un recurso de nube específico bajo ciertas condiciones.
Statement	Array of objects	Sentencia de la política.

**Tabla 11** role.policy.Statement
Parámetro	Obligatorio	Tipo	Descripción
Action	Sí	Array of strings	Permisos de operación específicos en un recurso. Para obtener más información sobre las acciones admitidas, consulte "Permisos y acciones admitidas" en la Referencia de API de servicios en la nube. NOTA: El formato de valor es Service name:Resource type:Operation, por ejemplo, vpc:ports:create. Service name: indica el nombre del producto, como ecs, evs, o vpc. Solo se permiten letras minúsculas. Los tipos de recursos y las operaciones no distinguen entre mayúsculas y minúsculas. Puede utilizar un asterisco (*) para representar todas las operaciones.
Effect	Sí	String	Efectos del permiso. El valor puede ser Allow o Deny. Si las sentencias Allow y Deny se encuentran en una política, la autenticación comienza desde las sentencias Deny. Opciones: Allow Deny
Condition	No	Map<String,Map<String,Array<String>>>	Condiciones para que el permiso entre en vigor. Para obtener más información, consulte Creación de una política personalizada. NOTA: Tome la condición en la solicitud de ejemplo como un ejemplo, los valores de la clave de condición (obs:prefix) y cadena (public) deben ser iguales (StringEquals). "Condition": { "StringEquals": { "obs:prefix": [ "public" ] } }
Resource	No	Array of strings	Recurso en la nube. NOTA: Formato: ::::. Por ejemplo, obs:::bucket:. Se permiten asteriscos. El segmento de región puede ser o una región accesible para el usuario. El recurso especificado debe pertenecer al servicio correspondiente que realmente existe.

Solicitud de ejemplo

Solicitud para modificar la política personalizada IAMCloudServicePolicy para permitir que solo los proyectos cuyos nombres comiencen por ap-southeast-1 obtengan información de ACL sobre todos los buckets.

PATCH https://iam.myhuaweicloud.com/v3.0/OS-ROLE/roles/{role_id}

{
    "role": {
        "display_name": "IAMCloudServicePolicy",
        "type": "AX",
        "description": "IAMDescription",
        "description_cn": "Description in Chinese",
        "policy": {
            "Version": "1.1",
            "Statement": [
                {
                    "Effect": "Allow",
                    "Action": [
                        "obs:bucket:GetBucketAcl"
                    ],
                    "Condition": {
                        "StringStartWith": {
                            "g:ProjectName": [
                                "ap-southeast-1"
                            ]
                        }
                    },
                    "Resource": [
                        "obs:*:*:bucket:*"
                    ]
                }
            ]
        }
    }
}

Ejemplo de respuesta

Código de estado: 200

La solicitud se ha realizado correctamente.

{
    "role": {
        "catalog": "CUSTOMED",
        "display_name": "IAMCloudServicePolicy",
        "description": "IAMDescription",
        "links": {
            "self": "https://iam.myhuaweicloud.com/v3/roles/93879fd90f1046f69e6e0b31c94d2615"
        },
        "policy": {
            "Version": "1.1",
            "Statement": [
                {
                    "Action": [
                        "obs:bucket:GetBucketAcl"
                    ],
                    "Resource": [
                        "obs:*:*:bucket:*"
                    ],
                    "Effect": "Allow",
                    "Condition": {
                        "StringStartWith": {
                            "g:ProjectName": [
                                "ap-southeast-1"
                            ]
                        }
                    }
                }
            ]
        },
        "description_cn": "Description in Chinese",
        "domain_id": "d78cbac186b744899480f25bd0...",
        "type": "AX",
        "id": "93879fd90f1046f69e6e0b31c94d2615",
        "name": "custom_d78cbac186b744899480f25bd022f468_1"
    }
}