REST Resource: projects.locations.consumerEnforcementActions

리소스: ConsumerEnforcementAction

파트너의 공급업체 계약을 시행하기 위해 취한 파트너 조치를 나타냅니다.

JSON 표현
{
  "name": string,
  "uid": string,
  "etag": string,
  "state": enum (State),
  "createTime": string,
  "updateTime": string,
  "succeedTime": string,
  "displayName": string,
  "labels": {
    string: string,
    ...
  },
  "consumerScope": {
    object (ConsumerScope)
  },
  "productScope": {
    object (ProductScope)
  },
  "denyReason": {
    object (DenyReason)
  },

  // Union field action can be only one of the following:
  "projectAccessRestrictionAction": {
    object (ProjectAccessRestrictionConfig)
  }
  // End of list of possible types for union field action.
}
필드
name

string

식별자. ConsumerEnforcementAction 리소스의 이름입니다.

형식: projects/{project}/locations/{location}/consumerEnforcementActions/{consumerEnforcementAction}

uid

string

출력 전용입니다. 리소스의 고유 식별자입니다.

etag

string

이 체크섬은 다른 필드의 값을 기준으로 서버에서 계산되며, 처리 전 클라이언트에 최신 값이 적용되도록 업데이트 및 삭제 요청이 있을 때 전송될 수 있습니다.

state

enum (State)

출력 전용입니다. 리소스의 현재 수명 주기 상태입니다.

createTime

string (Timestamp format)

출력 전용입니다. 리소스가 생성된 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

updateTime

string (Timestamp format)

출력 전용입니다. 리소스가 마지막으로 업데이트된 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

succeedTime

string (Timestamp format)

출력 전용입니다. 시정 조치가 완료된 시점의 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

displayName

string

선택사항입니다. 리소스의 사람이 읽을 수 있는 표시 이름입니다. 최대 길이는 63자(영문 기준)입니다.

labels

map (key: string, value: string)

선택사항입니다. 리소스의 사용자 정의 라벨입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

consumerScope

object (ConsumerScope)

필수 항목입니다. 변경할 수 없습니다. 시정 조치의 소비자 범위입니다.

productScope

object (ProductScope)

필수 항목입니다. 변경할 수 없습니다. 시정 조치의 제품 범위입니다.

denyReason

object (DenyReason)

출력 전용입니다. 거부 이유입니다. 리소스 상태가 DENIED인 경우에 표시됩니다.

통합 필드 action. 필수 항목입니다. 구성된 시행 작업입니다. action은 다음 중 하나여야 합니다.
projectAccessRestrictionAction

object (ProjectAccessRestrictionConfig)

선택사항입니다. 변경할 수 없습니다. 소비자 프로젝트의 제품 액세스를 제한합니다.

ProjectAccessRestrictionConfig

고객 프로젝트에 적용되는 액세스 제한 구성입니다.

액세스 제한이 프로젝트에 적용되는 동안에는 관련 제품에서 제공하는 서비스에 액세스하는 요청에서 해당 프로젝트를 클라이언트 프로젝트로 사용할 수 없습니다. 액세스 제한은 비파괴적이며 소비자의 조달 상태를 수정하지 않습니다. 제한이 삭제되거나 프로젝트에 적용되지 않으면 소비자 프로젝트 액세스가 자동으로 복원됩니다.

JSON 표현
{
  "falsePositiveGuardDisabled": boolean
}
필드
falsePositiveGuardDisabled

boolean

선택사항입니다. Google에서 거짓양성을 방지할지 여부를 제어합니다.

이 기능을 사용 설정하면 공급업체 계약 위반이 잘못된 긍정 오류로 발견되거나 파트너가 의도치 않게 지나치게 광범위한 시정 조치를 취하여 발생할 수 있는 방해적인 시정 조치를 Google에서 방지합니다. Google은 Google에서 사용할 수 있는 정보를 기반으로 시정 조치를 진행해야 하는지 여부를 자체적으로 판단하며, 재량에 따라 시정 조치를 거부할 수 있습니다. Google은 요청된 시정 조치가 거부된 경우 재량에 따라 결정의 근거에 관한 세부정보를 제공할 수 있지만, 그렇게 해야 할 의무는 없으며 파트너와 공유할 수 없는 정보를 기반으로 결정을 내릴 수 있습니다. 파트너가 결정에 동의하지 않는 경우 가드 없이 새로운 시정 조치를 적용할 수 있습니다.

주

시정 조치의 수명 주기 상태를 나타냅니다.

향후 이 enum에 새 값이 추가될 수 있습니다.

열거형
STATE_UNSPECIFIED 지정되지 않은 상태입니다. 사용되지 않습니다.
RUNNING

시정 조치가 실행 중입니다. 이는 리소스의 초기 상태이며 consumerEnforcementActions.create 장기 실행 작업이 실행되는 동안 유지됩니다.

시행 효과가 발생하기 전에 작업이 취소되거나 종료되면 리소스가 삭제됩니다. 그렇지 않으면 작업이 완료되면 리소스 상태가 다음 상태 중 하나로 확인됩니다.

  • 시정 조치가 수락되고 성공적으로 적용되면 완료 시 상태가 SUCCEEDED로 전환됩니다.
  • 시정 조치가 거부되면 완료 시 상태가 DENIED로 전환됩니다.
  • 강제 조치 효과를 부분적으로 적용한 후 강제 조치가 실패하면 불일치하는 부분 강제 조치 상태를 반영하기 위해 상태가 FAILED로 전환됩니다.
SUCCEEDED 시정 조치가 수락되어 적용되었습니다. 시정 조치의 진행 중인 효과가 활성화되어 있습니다.
DENIED denyReason에 자세히 설명된 이유로 시정 조치가 수락되지 않았으며 적용되지 않았습니다.
FAILED 일시적이거나 내부 시스템 오류로 인해 상태 전환이 실패했습니다. 시행 동작이 일관되지 않을 수 있습니다. 이 상태의 리소스를 삭제하면 진행 중인 효과가 모두 삭제됩니다.

ConsumerScope

강제 조치 대상 소비자 리소스 항목을 지정합니다.

JSON 표현
{

  // Union field target_consumer_entity can be only one of the following:
  "project": string,
  "billingAccount": string,
  "organization": string
  // End of list of possible types for union field target_consumer_entity.
}
필드
통합 필드 target_consumer_entity. 필수 항목입니다. 타겟 리소스 식별자를 정확히 하나 설정해야 합니다. target_consumer_entity은 다음 중 하나여야 합니다.
project

string

단일 프로젝트 리소스를 타겟팅합니다. 시정 조치의 범위는 지정된 프로젝트로 제한됩니다.

시정 조치가 생성될 때 존재해야 합니다. project_number 형식을 사용하여 지정해야 합니다.

형식: projects/{project_number}

billingAccount

string

결제 계정 리소스를 타겟팅합니다. 시정 조치의 범위는 결제 계정 및 연결된 모든 프로젝트를 포함합니다.

이 범위는 동적입니다. 시정 조치가 생성될 때 적용된 효과는 해당 시점에 범위 내에 있는 항목에 적용됩니다. 시정 조치의 진행 중인 효과는 관련 시점에 범위 내에 있는 항목에 적용됩니다.

시정 조치가 생성될 때 존재해야 합니다. 이 필드는 리셀러 상위 결제 계정을 타겟팅하는 데 사용할 수 없습니다.

형식: billingAccounts/{billingAccount}

organization

string

조직 리소스를 타겟팅합니다. 시정 조치의 범위는 조직 내의 모든 프로젝트, 조직 내의 모든 결제 계정, 해당 결제 계정에 연결된 모든 프로젝트를 포함합니다.

이 범위는 동적입니다. 시정 조치가 생성될 때 적용된 효과는 해당 시점에 범위 내에 있는 항목에 적용됩니다. 시정 조치의 진행 중인 효과는 관련 시점에 범위 내에 있는 항목에 적용됩니다.

시정 조치가 생성될 때 존재해야 합니다.

형식: organizations/{organization}

ProductScope

강제 조치의 제품 범위를 정의합니다.

JSON 표현
{
  "aiplatformPublisherId": string
}
필드
aiplatformPublisherId

string

선택사항입니다. 지정된 게시자 ID가 상위인 AI Platform Model Garden의 모든 관리 모델 제품을 타겟팅합니다.

AI Platform Model Garden에서 publisher_id는 모델 게시자를 식별합니다. Model Garden에서 제품을 사용할 수 있는 파트너에게는 첫 온보딩 시 고유한 게시자 ID가 할당됩니다. 파트너의 자체 게시자 ID만 지정할 수 있습니다. 게시자 ID를 모르는 경우 파트너 지원팀에 문의하여 도움을 받으세요.

형식: {publisher_id} (예: google)

DenyReason

시정 조치가 적용되지 않은 이유에 대한 설명입니다.

JSON 표현
{
  "reasonCode": enum (ReasonCode),
  "detailMessage": string
}
필드
reasonCode

enum (ReasonCode)

출력 전용입니다. 이유 코드입니다. 시정 조치가 거부된 경우 항상 표시됩니다.

detailMessage

string

출력 전용입니다. 시정 조치가 거부된 이유를 설명하는 사람이 읽을 수 있는 추가 메시지(선택사항)입니다.

ReasonCode

Google에서 시정 조치를 거부한 이유를 나타내는 코드입니다.

열거형
REASON_CODE_UNSPECIFIED 지정되지 않은 이유입니다. 사용되지 않습니다.
EXEMPT 타겟 소비자 엔티티 (또는 엔티티 계층 구조에서 하위 엔티티)가 API에서 시작된 요청된 시정 조치의 적용에서 제외됩니다. 소비자에 대한 시정 조치를 진행하려면 Google에 문의하세요.
FALSE_POSITIVE_GUARD 거짓양성 가드 모드가 요청되었고 거짓양성 보호가 트리거되어 시정 조치가 거부되었습니다.

메서드

create

ConsumerEnforcementAction 리소스를 만듭니다.

delete

ConsumerEnforcementAction 리소스를 삭제합니다.

get

이름으로 ConsumerEnforcementAction 리소스를 가져옵니다.

list

상위 위치의 ConsumerEnforcementActions를 나열합니다.

patch

기존 ConsumerEnforcementAction 리소스를 업데이트합니다.