Method: organizations.locations.securityCenterServices.patch

Actualiza un servicio de Security Command Center con la máscara de actualización proporcionada.

Solicitud HTTP

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

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

Parámetros de ruta de acceso

Parámetros
securityCenterService.name

string

Identificador. El nombre del servicio, en uno de los siguientes formatos:

  • organizations/{organization}/locations/{location}/securityCenterServices/{service}
  • folders/{folder}/locations/{location}/securityCenterServices/{service}
  • projects/{project}/locations/{location}/securityCenterServices/{service}

Los siguientes valores son válidos para {service}:

  • container-threat-detection
  • event-threat-detection
  • security-health-analytics
  • vm-threat-detection
  • web-security-scanner

Parámetros de consulta

Parámetros
updateMask

string (FieldMask format)

Obligatorio. Los campos que se actualizarán. Acepta los siguientes valores:

  • intendedEnablementState
  • modules

Si se omite, se actualizan 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. Si se establece en true, se validará la solicitud (incluidas las verificaciones de IAM), pero no se actualizará ningún servicio. 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 servicio 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 actualización del servicio

La configuración predeterminada es false.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de SecurityCenterService.

Cuerpo de la respuesta

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

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.securityCenterServices.update

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