Method: folders.assets.list

Mencantumkan aset organisasi.

Permintaan HTTP


URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib. Nama organisasi yang memiliki aset. Formatnya adalah "organizations/[organization_id], folders/[folder_id], atau projects/[projectId]".

Parameter kueri

Parameter
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.

Berikut adalah kombinasi kolom dan operator yang diizinkan:

  • 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_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 : ""
orderBy

string

Ekspresi yang menentukan kolom dan urutan yang akan digunakan untuk pengurutan. Nilai string harus mengikuti sintaksis SQL: daftar kolom yang dipisahkan koma. Misalnya: "name,resourceProperties.a_property". Urutan pengurutan default adalah menaik. Untuk menentukan urutan menurun untuk kolom, akhiran " desc" harus ditambahkan ke nama kolom. Misalnya: "name desc,resourceProperties.a_property". Karakter spasi yang berlebihan dalam sintaksis tidak signifikan. "name desc,resourceProperties.a_property" dan " name desc , resourceProperties.a_property " setara.

Kolom berikut didukung: name updateTime resourceProperties securityMarks.marks securityCenterProperties.resource_name securityCenterProperties.resource_display_name securityCenterProperties.resource_parent securityCenterProperties.resource_parent_display_name securityCenterProperties.resource_project securityCenterProperties.resource_project_display_name securityCenterProperties.resource_type
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".
compareDuration

string (Duration format)

Saat compareDuration ditetapkan, atribut "stateChange" ListAssetsResult 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 stateChange berasal dari 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 readTime.
  • "REMOVED": menunjukkan bahwa aset ada di awal compareDuration, tetapi tidak ada di readTime.
  • "ACTIVE": menunjukkan bahwa aset ada di awal dan akhir jangka waktu yang ditentukan oleh compareDuration dan readTime.

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

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

string (FieldMask format)

Mask kolom untuk menentukan kolom ListAssetsResult yang akan dicantumkan dalam respons. Mask kolom kosong akan mencantumkan semua kolom.
pageToken

string

Nilai yang ditampilkan oleh ListAssetsResponse terakhir; menunjukkan bahwa ini adalah kelanjutan dari panggilan assets.list 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 permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons akan berisi instance ListAssetsResponse.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.