Method: organizations.locations.securityHealthAnalyticsCustomModules.patch

지정된 업데이트 마스크에 따라 지정된 이름 아래의 SecurityHealthAnalyticsCustomModule를 업데이트합니다. 사용 설정 상태 업데이트는 상주 모듈과 상속된 모듈 모두에서 지원됩니다 (상주 모듈은 '상속됨'의 사용 설정 상태를 가질 수 없음). 모듈의 표시 이름과 맞춤 구성을 업데이트하는 기능은 상주 모듈에서만 지원됩니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
securityHealthAnalyticsCustomModule.name

string

식별자. 커스텀 모듈의 전체 리소스 이름(다음 형식 중 하나)

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

쿼리 매개변수

매개변수
updateMask

string (FieldMask format)

필수 입력란입니다. 업데이트할 필드입니다. 유효한 값은 다음과 같습니다.

  • customConfig
  • enablementState

이 필드를 생략하거나 와일드 카드 값 *로 설정하면 요건을 충족하는 모든 필드가 업데이트됩니다.

정규화된 필드 이름의 쉼표로 구분된 목록입니다. 예: "user.displayName,photo"
validateOnly

boolean

선택사항입니다. true로 설정하면 요청이 검증되지만 (IAM 검사 포함) 모듈은 업데이트되지 않습니다. OK 응답은 요청이 유효함을 나타내고 오류 응답은 요청이 유효하지 않음을 나타냅니다.

요청이 유효하더라도 다음과 같은 이유로 모듈 업데이트 요청이 실패할 수 있습니다.

  • 클라우드 리소스의 상태가 변경되었습니다(예: 필수 IAM 권한이 상실됨).
  • 모듈을 만드는 중에 오류가 발생했습니다.

기본값은 false입니다.

요청 본문

요청 본문에 SecurityHealthAnalyticsCustomModule의 인스턴스가 포함됩니다.

응답 본문

성공한 경우 응답 본문에 SecurityHealthAnalyticsCustomModule의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • securitycentermanagement.securityHealthAnalyticsCustomModules.update

자세한 내용은 IAM 문서를 참조하세요.