Method: organizations.assets.group

Memfilter aset organisasi dan mengelompokkan aset tersebut berdasarkan properti yang ditentukan.

Permintaan HTTP


URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib. Nama organisasi untuk groupBy. Formatnya adalah "organizations/[organization_id], folders/[folder_id], atau projects/[projectId]".

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "filter": string,
  "groupBy": string,
  "compareDuration": string,
  "readTime": string,
  "pageToken": string,
  "pageSize": integer
}
Kolom
filter

string

Ekspresi yang menentukan filter yang akan diterapkan di seluruh aset. Ekspresi ini adalah daftar nol atau beberapa batasan yang digabungkan melalui operator logis AND dan OR. Tanda kurung didukung, dan OR memiliki prioritas lebih tinggi daripada AND.

Batasan memiliki bentuk <field> <operator> <value> dan dapat memiliki karakter - di depannya untuk menunjukkan negasi. Kolom dipetakan ke kolom yang ditentukan dalam resource Aset. Beberapa contoh di antaranya:

  • nama
  • securityCenterProperties.resource_name
  • resourceProperties.a_property
  • securityMarks.marks.marka

Operator yang didukung adalah:

  • = untuk semua jenis nilai.
  • >, <, >=, <= untuk nilai bilangan bulat.
  • :, yang berarti pencocokan substring, untuk string.

Jenis nilai yang didukung adalah:

  • literal string dalam tanda kutip.
  • literal bilangan bulat tanpa tanda kutip.
  • literal boolean true dan false tanpa tanda petik.

Kombinasi kolom dan operator berikut didukung:

  • nama: =
  • updateTime: =, >, <, >=, <=

Penggunaan: Ini harus berupa milidetik sejak epoch atau string RFC3339. Contoh: updateTime = "2019-06-10T16:07:18-07:00" updateTime = 1560208038000

  • createTime: =, >, <, >=, <=

Penggunaan: Ini harus berupa milidetik sejak epoch atau string RFC3339. Contoh: createTime = "2019-06-10T16:07:18-07:00" createTime = 1560208038000

  • iamPolicy.policy_blob: =, :
  • resourceProperties: =, :, >, <, >=, <=
  • securityMarks.marks: =, :
  • securityCenterProperties.resource_name: =, :
  • securityCenterProperties.resource_name_display_name: =, :
  • securityCenterProperties.resource_type: =, :
  • securityCenterProperties.resource_parent: =, :
  • securityCenterProperties.resource_parent_display_name: =, :
  • securityCenterProperties.resource_project: =, :
  • securityCenterProperties.resource_project_display_name: =, :
  • securityCenterProperties.resource_owners: =, :

Misalnya, resourceProperties.size = 100 adalah string filter yang valid.

Gunakan pencocokan sebagian pada string kosong untuk memfilter berdasarkan properti yang ada: resourceProperties.my_property : ""

Gunakan pencocokan sebagian yang dinegasikan pada string kosong untuk memfilter berdasarkan properti yang tidak ada: -resourceProperties.my_property : ""
groupBy

string

Wajib. Ekspresi yang menentukan kolom aset yang akan digunakan untuk pengelompokan. Nilai string harus mengikuti sintaksis SQL: daftar kolom yang dipisahkan koma. Misalnya: "securityCenterProperties.resource_project,securityCenterProperties.project".

Kolom berikut didukung jika compareDuration tidak ditetapkan:

  • securityCenterProperties.resource_project
  • securityCenterProperties.resource_project_display_name
  • securityCenterProperties.resource_type
  • securityCenterProperties.resource_parent
  • securityCenterProperties.resource_parent_display_name

Kolom berikut didukung saat compareDuration ditetapkan:

  • securityCenterProperties.resource_type
  • securityCenterProperties.resource_project_display_name
  • securityCenterProperties.resource_parent_display_name
compareDuration

string (Duration format)

Saat compareDuration ditetapkan, properti "stateChange" GroupResult akan diperbarui untuk menunjukkan apakah aset ditambahkan, dihapus, atau tetap ada selama jangka waktu compareDuration yang mendahului readTime. Ini adalah waktu antara (readTime - compareDuration) dan readTime.

Nilai perubahan status diperoleh berdasarkan keberadaan aset pada dua titik waktu. Perubahan status perantara antara kedua waktu tersebut tidak memengaruhi hasilnya. Misalnya, hasilnya tidak akan terpengaruh jika aset dihapus dan dibuat ulang.

Nilai "stateChange" yang mungkin jika compareDuration ditentukan:

  • "ADDED": menunjukkan bahwa aset tidak ada di awal compareDuration, tetapi ada di reference_time.
  • "REMOVED": menunjukkan bahwa aset ada di awal compareDuration, tetapi tidak ada di reference_time.
  • "ACTIVE": menunjukkan bahwa aset ada di awal dan akhir jangka waktu yang ditentukan oleh compareDuration dan reference_time.

Jika compareDuration tidak ditentukan, satu-satunya kemungkinan stateChange adalah "UNUSED", yang akan menjadi stateChange yang ditetapkan untuk semua aset yang ada pada readTime.

Jika kolom ini ditetapkan, stateChange harus berupa kolom yang ditentukan di groupBy.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".
readTime

string (Timestamp format)

Waktu yang digunakan sebagai titik referensi saat memfilter aset. Filter ini terbatas pada aset yang ada pada waktu yang diberikan dan nilainya adalah nilai pada waktu tertentu tersebut. Jika tidak ada, kolom ini akan ditetapkan secara default ke versi NOW API.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. 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".
pageToken

string

Nilai yang ditampilkan oleh GroupAssetsResponse terakhir; menunjukkan bahwa ini adalah kelanjutan dari panggilan assets.group sebelumnya, dan bahwa sistem harus menampilkan halaman data berikutnya.
pageSize

integer

Jumlah maksimum hasil yang akan ditampilkan dalam satu respons. Default-nya 10, minimum 1, maksimum 1.000.

Isi respons

Jika berhasil, isi respons akan berisi instance GroupAssetsResponse.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.