Method: organizations.locations.securityCenterServices.patch

使用给定的更新掩码更新 Security Command Center 服务。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
securityCenterService.name

string

标识符。服务的名称，采用以下某种格式：

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

{service} 的有效值如下：

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

查询参数

参数
updateMask

string (FieldMask format)

必需。要更新的字段。接受以下值：

  • intendedEnablementState
  • modules

如果省略，则系统会更新所有符合条件的字段。

这是完全限定字段名称的逗号分隔列表。示例："user.displayName,photo"。
validateOnly

boolean

可选。设置为 true 时，系统会对请求进行验证（包括 IAM 检查），但不会更新任何服务。OK 响应表示请求有效，而错误响应表示请求无效。

即使请求有效，后续更新服务的请求仍可能会因以下某种原因而失败：

  • 您的云资源状态发生了变化；例如，您失去了必要的 IAM 权限
  • 更新服务时出错

默认值为 false。

请求正文

请求正文包含一个 SecurityCenterService 实例。

响应正文

如果成功，则响应正文包含一个 SecurityCenterService 实例。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

需要拥有 name 资源的以下 IAM 权限：

  • securitycentermanagement.securityCenterServices.update

如需了解详情，请参阅 IAM 文档。