Method: organizations.locations.securityHealthAnalyticsCustomModules.patch

Actualiza el SecurityHealthAnalyticsCustomModule con el nombre determinado según la máscara de actualización especificada. La actualización del estado de habilitación es compatible con los módulos residentes y heredados (aunque los módulos residentes no pueden tener un estado de habilitación de "heredado"). La actualización del nombre visible y la configuración personalizada de un módulo solo se admite en los módulos residentes.

Solicitud HTTP

PATCH https://securitycentermanagement.googleapis.com/v1/{securityHealthAnalyticsCustomModule.name=organizations/*/locations/*/securityHealthAnalyticsCustomModules/*}

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
securityHealthAnalyticsCustomModule.name

string

Identificador. El nombre de recurso completo del módulo personalizado, en uno de los siguientes formatos:

  • organizations/{organization}/locations/{location}/securityHealthAnalyticsCustomModules/{custom_module}
  • folders/{folder}/locations/{location}/securityHealthAnalyticsCustomModules/{custom_module}
  • projects/{project}/locations/{location}/securityHealthAnalyticsCustomModules/{custom_module}

Parámetros de consulta

Parámetros
updateMask

string (FieldMask format)

Obligatorio. Los campos que se actualizarán. Los siguientes valores son válidos:

  • customConfig
  • enablementState

Si omites este campo o lo estableces en el valor de comodín *, se actualizarán todos los campos aptos.

Esta es una lista separada por comas de los nombres de campos totalmente calificados. Ejemplo: "user.displayName,photo".
validateOnly

boolean

Opcional. Cuando se establece en true, se valida la solicitud (incluidas las verificaciones de IAM), pero no se actualiza ningún módulo. Una respuesta OK indica que la solicitud es válida, mientras que una respuesta de error indica que no lo es.

Si la solicitud es válida, es posible que una solicitud posterior para actualizar el módulo falle por uno de los siguientes motivos:

  • Cambió el estado de tus recursos de la nube; por ejemplo, perdiste un permiso de IAM obligatorio
  • Se produjo un error durante la creación del módulo

La configuración predeterminada es false.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de SecurityHealthAnalyticsCustomModule.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de SecurityHealthAnalyticsCustomModule.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Descripción general de la autenticación.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • securitycentermanagement.securityHealthAnalyticsCustomModules.update

Para obtener más información, consulta la documentación de IAM.