REST Resource: projects.locations.consumerEnforcementActions

Resource: ConsumerEnforcementAction

Mewakili tindakan partner yang diambil untuk menegakkan Perjanjian Vendor partner.

Representasi 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.
}
Kolom
name

string

ID. Nama resource ConsumerEnforcementAction.

Format: projects/{project}/locations/{location}/consumerEnforcementActions/{consumerEnforcementAction}

uid

string

Hanya output. ID unik resource.

etag

string

Checksum ini dihitung oleh server berdasarkan nilai kolom lain, dan dapat dikirim pada permintaan update dan hapus untuk memastikan klien memiliki nilai terbaru sebelum melanjutkan.

state

enum (State)

Hanya output. Status siklus proses resource saat ini.

createTime

string (Timestamp format)

Hanya output. Stempel waktu saat resource dibuat.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Hanya output. Stempel waktu saat resource terakhir diperbarui.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

succeedTime

string (Timestamp format)

Hanya output. Stempel waktu saat tindakan penegakan berhasil.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

displayName

string

Opsional. Nama tampilan resource yang dapat dibaca manusia. Panjang maksimum adalah 63 karakter.

labels

map (key: string, value: string)

Opsional. Label yang ditentukan pengguna untuk resource.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

consumerScope

object (ConsumerScope)

Wajib. Tidak dapat diubah. Cakupan konsumen dari tindakan penegakan kebijakan.

productScope

object (ProductScope)

Wajib. Tidak dapat diubah. Cakupan produk dari tindakan penegakan kebijakan.

denyReason

object (DenyReason)

Hanya output. Alasan penolakan. Ada saat status resource adalah DENIED.

Kolom union action. Wajib. Tindakan penegakan yang dikonfigurasi. action hanya ada berupa salah satu diantara berikut:
projectAccessRestrictionAction

object (ProjectAccessRestrictionConfig)

Opsional. Tidak dapat diubah. Membatasi akses produk untuk project konsumen.

ProjectAccessRestrictionConfig

Konfigurasi untuk pembatasan akses yang berlaku untuk project konsumen.

Selama pembatasan akses berlaku untuk project, project tersebut tidak dapat digunakan sebagai project klien dalam permintaan yang mengakses layanan yang disediakan oleh produk yang relevan. Pembatasan akses tidak merusak, dan tidak mengubah status perolehan konsumen. Akses project konsumen dipulihkan secara otomatis saat batasan dihapus atau tidak lagi berlaku untuk project.

Representasi JSON
{
  "falsePositiveGuardDisabled": boolean
}
Kolom
falsePositiveGuardDisabled

boolean

Opsional. Mengontrol apakah Google melindungi dari positif palsu.

Jika diaktifkan, Google akan melindungi dari tindakan penegakan yang mengganggu yang dapat terjadi akibat temuan positif palsu atas pelanggaran Perjanjian Vendor atau penegakan yang tidak disengaja dan terlalu luas oleh partner. Google akan membuat penentuannya sendiri berdasarkan informasi yang tersedia bagi Google mengenai apakah tindakan penegakan harus dilanjutkan, dan atas pertimbangannya sendiri dapat menolak tindakan penegakan tersebut. Google dapat memberikan detail tentang dasar penentuannya atas pertimbangannya sendiri jika tindakan penegakan yang diminta ditolak, tetapi Google tidak berkewajiban untuk melakukannya, dan Google dapat membuat penentuan berdasarkan informasi yang tidak dapat dibagikan kepada partner. Jika partner tidak menyetujui penentuan tersebut, partner dapat menerapkan tindakan penegakan kebijakan baru tanpa pengamanan.

Negara Bagian

Merepresentasikan status siklus proses tindakan penegakan.

Nilai baru dapat ditambahkan ke enum ini pada masa mendatang.

Enum
STATE_UNSPECIFIED Status tidak ditentukan. Tidak digunakan.
RUNNING

Tindakan penegakan kebijakan sedang berjalan. Ini adalah status awal resource dan tetap ada saat Operasi yang berjalan lama consumerEnforcementActions.create berjalan.

Jika operasi dibatalkan atau berakhir sebelum efek penegakan apa pun terjadi, resource akan dihapus. Jika tidak, saat operasi selesai, status resource akan diselesaikan ke salah satu status berikut.

  • Jika tindakan penegakan diterima dan berhasil diterapkan, setelah selesai, status akan bertransisi ke SUCCEEDED.
  • Jika tindakan penegakan ditolak, setelah selesai, status akan bertransisi ke DENIED.
  • Jika tindakan penegakan gagal setelah penerapan sebagian efek penegakan, status akan bertransisi ke FAILED untuk mencerminkan status penegakan sebagian yang tidak konsisten.
SUCCEEDED Tindakan penegakan diterima dan berhasil diterapkan. Setiap efek berkelanjutan dari tindakan penegakan kebijakan akan aktif.
DENIED Tindakan penegakan tidak diterima dan tidak berlaku karena alasan yang dijelaskan dalam denyReason.
FAILED Transisi status gagal karena error sistem internal atau sementara. Perilaku penegakan mungkin tidak konsisten. Penghapusan resource dalam status ini akan menghapus semua efek yang sedang berlangsung.

ConsumerScope

Menentukan entity resource konsumen target untuk tindakan penegakan.

Representasi 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.
}
Kolom
Kolom union target_consumer_entity. Wajib. Tepat satu ID resource target harus ditetapkan. target_consumer_entity hanya ada berupa salah satu diantara berikut:
project

string

Menargetkan satu resource project. Cakupan tindakan penegakan terbatas pada project yang ditentukan.

Harus ada pada saat tindakan penegakan dibuat. Harus ditentukan menggunakan format project_number.

Format: projects/{project_number}

billingAccount

string

Menargetkan resource akun penagihan. Cakupan tindakan penegakan mencakup akun penagihan dan semua project yang ditautkan ke akun tersebut.

Cakupan ini bersifat dinamis. Setiap efek yang diterapkan pada saat tindakan penegakan dibuat akan diterapkan ke entity dalam cakupan pada saat itu. Setiap efek berkelanjutan dari tindakan penegakan berlaku untuk entity dalam cakupan pada waktu yang relevan.

Harus ada pada saat tindakan penegakan dibuat. Kolom ini tidak dapat digunakan untuk menargetkan akun penagihan induk reseller.

Format: billingAccounts/{billingAccount}

organization

string

Menargetkan resource organisasi. Cakupan tindakan penegakan mencakup semua project dalam organisasi, serta semua akun penagihan dalam organisasi, dan semua project yang ditautkan ke akun penagihan tersebut.

Cakupan ini bersifat dinamis. Setiap efek yang diterapkan pada saat tindakan penegakan dibuat akan diterapkan ke entity dalam cakupan pada saat itu. Setiap efek berkelanjutan dari tindakan penegakan berlaku untuk entity dalam cakupan pada waktu yang relevan.

Harus ada pada saat tindakan penegakan dibuat.

Format: organizations/{organization}

ProductScope

Menentukan cakupan produk dari tindakan penegakan.

Representasi JSON
{
  "aiplatformPublisherId": string
}
Kolom
aiplatformPublisherId

string

Opsional. Menargetkan semua produk model terkelola di AI Platform Model Garden yang dimiliki oleh ID penayang yang ditentukan.

Di Model Garden AI Platform, publisher_id mengidentifikasi penayang model. Partner dengan produk yang tersedia di Model Garden akan diberi ID penayang unik pada saat aktivasi pertama. Hanya ID penayang milik partner itu sendiri yang dapat ditentukan. Jika Anda tidak mengetahui ID penayang, hubungi dukungan partner untuk mendapatkan bantuan.

Format: {publisher_id} (misalnya, google).

DenyReason

Penjelasan mengapa tindakan penegakan tidak diterapkan.

Representasi JSON
{
  "reasonCode": enum (ReasonCode),
  "detailMessage": string
}
Kolom
reasonCode

enum (ReasonCode)

Hanya output. Kode alasan. Selalu ada saat penegakan ditolak.

detailMessage

string

Hanya output. Pesan tambahan opsional yang dapat dibaca manusia yang menjelaskan alasan tindakan penegakan ditolak.

ReasonCode

Kode yang menunjukkan alasan tindakan penegakan ditolak oleh Google.

Enum
REASON_CODE_UNSPECIFIED Alasan tidak ditentukan. Tidak digunakan.
EXEMPT Entitas konsumen target (atau sub-entitas yang lebih rendah dalam hierarki entitas) dikecualikan dari penerapan tindakan penegakan yang diminta yang dimulai oleh API. Untuk melanjutkan penegakan terhadap konsumen, hubungi Google.
FALSE_POSITIVE_GUARD Tindakan penegakan ditolak karena mode perlindungan positif palsu diminta dan perlindungan positif palsu dipicu.

Metode

create

Membuat resource ConsumerEnforcementAction.

delete

Menghapus resource ConsumerEnforcementAction.

get

Mendapatkan resource ConsumerEnforcementAction berdasarkan nama.

list

Mencantumkan ConsumerEnforcementActions di lokasi induk.

patch

Memperbarui resource ConsumerEnforcementAction yang ada.