Method: organizations.locations.securityCenterServices.patch

지정된 업데이트 마스크를 사용하여 Security Command Center 서비스를 업데이트합니다.

HTTP 요청

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

URL은 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 문서를 참조하세요.