Method: organizations.locations.securityCenterServices.patch

指定された更新マスクを使用して Security Command Center サービスを更新します。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
securityCenterService.name

string

ID。サービスの名前。次のいずれかの形式で指定します。

  • 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 のドキュメントをご覧ください。