Method: organizations.sources.findings.list

Mencantumkan temuan organisasi atau sumber.

Untuk mencantumkan di semua sumber, berikan - sebagai ID sumber. Contoh: /v1beta1/organizations/{organization_id}/sources/-/findings

Permintaan HTTP


URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib. Nama sumber temuan. Formatnya adalah "organizations/[organization_id]/sources/[source_id]". Untuk mencantumkan di semua sumber, berikan source_id -. Misalnya: organizations/{organization_id}/sources/-

Parameter kueri

Parameter
filter

string

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

Batasan memiliki bentuk <field> <operator> <value> dan dapat memiliki karakter - di depannya untuk menunjukkan negasi. Beberapa contoh di antaranya:

  • nama
  • sourceProperties.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.

Misalnya, sourceProperties.size = 100 adalah string filter yang valid.
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,sourceProperties.a_property". Karakter spasi yang berlebihan dalam sintaksis tidak signifikan. "name desc,sourceProperties.a_property" dan " name desc , sourceProperties.a_property " setara.
readTime

string (Timestamp format)

Waktu yang digunakan sebagai titik referensi saat memfilter temuan. Filter ini terbatas pada temuan 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".
fieldMask

string (FieldMask format)

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

string

Nilai yang ditampilkan oleh ListFindingsResponse terakhir; menunjukkan bahwa ini adalah kelanjutan dari panggilan findings.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

Pesan respons untuk mencantumkan temuan.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "findings": [
    {
      object (Finding)
    }
  ],
  "readTime": string,
  "nextPageToken": string,
  "totalSize": integer
}
Kolom
findings[]

object (Finding)

Temuan yang cocok dengan permintaan daftar.
readTime

string (Timestamp format)

Waktu yang digunakan untuk menjalankan permintaan daftar.

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".
nextPageToken

string

Token untuk mengambil halaman hasil berikutnya, atau kosong jika tidak ada lagi hasil.
totalSize

integer

Jumlah total temuan yang cocok dengan kueri.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.