Method: organizations.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]".

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

Misalnya, resourceProperties.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,resourceProperties.a_property". Karakter spasi yang berlebihan dalam sintaksis tidak signifikan. "name desc,resourceProperties.a_property" dan " name desc , resourceProperties.a_property " setara.
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 "state" ListAssetResult 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 status 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 "state" yang mungkin jika compareDuration ditentukan:

  • "ADDED": menunjukkan bahwa aset tidak ada sebelum compareDuration, tetapi ada pada 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 status yang mungkin adalah "UNUSED", yang menunjukkan bahwa aset ada pada readTime.

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

string (FieldMask format)

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

Pesan respons untuk listingan aset.

Jika berhasil, isi respons memuat data dengan struktur berikut:

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

object (ListAssetsResult)

Aset 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 aset yang cocok dengan kueri.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

ListAssetsResult

Hasil yang berisi Aset dan Statusnya.

Representasi JSON 
{
  "asset": {
    object (Asset)
  },
  "state": enum (State)
}
Kolom
asset

object (Asset)

Aset yang cocok dengan permintaan penelusuran.
state

enum (State)

Status aset.

Aset

Representasi Security Command Center dari resource Google Cloud.

Aset adalah resource Security Command Center yang merekam informasi tentang satu resource Google Cloud. Semua modifikasi pada Aset hanya dalam konteks Security Command Center dan tidak memengaruhi resource Google Cloud yang dirujuk.

Representasi JSON 
{
  "name": string,
  "securityCenterProperties": {
    object (SecurityCenterProperties)
  },
  "resourceProperties": {
    string: value,
    ...
  },
  "securityMarks": {
    object (SecurityMarks)
  },
  "createTime": string,
  "updateTime": string
}
Kolom
name

string

Nama resource relatif aset ini. Lihat: https://cloud.google.com/apis/design/resource_names#relative_resource_name Contoh: "organizations/{organization_id}/assets/{asset_id}".
securityCenterProperties

object (SecurityCenterProperties)

Properti yang dikelola Security Command Center. Properti ini dikelola oleh Security Command Center dan tidak dapat diubah oleh pengguna.
resourceProperties

map (key: string, value: value (Value format))

Properti yang dikelola resource. Properti ini dikelola dan ditentukan oleh resource Google Cloud dan tidak dapat diubah oleh pengguna.

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

object (SecurityMarks)

Tanda keamanan yang ditentukan pengguna. Tanda ini sepenuhnya dikelola oleh pengguna dan berasal dari resource SecurityMarks yang merupakan milik aset.
createTime

string (Timestamp format)

Waktu pembuatan aset di Security Command Center.

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

string (Timestamp format)

Waktu saat aset terakhir diperbarui, ditambahkan, atau dihapus di Security Command Center.

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

SecurityCenterProperties

Properti yang dikelola Security Command Center. Properti ini dikelola oleh Security Command Center dan tidak dapat diubah oleh pengguna.

Representasi JSON 
{
  "resourceName": string,
  "resourceType": string,
  "resourceParent": string,
  "resourceProject": string,
  "resourceOwners": [
    string
  ]
}
Kolom
resourceName

string

Tidak dapat diubah. Nama lengkap resource Google Cloud yang diwakili aset ini. Kolom ini tidak dapat diubah setelah waktu pembuatan. Lihat: https://cloud.google.com/apis/design/resource_names#full_resource_name
resourceType

string

Jenis resource Google Cloud. Contohnya mencakup: APPLICATION, PROJECT, dan ORGANIZATION. Ini adalah kolom yang tidak peka huruf besar/kecil yang ditentukan oleh Security Command Center dan/atau produsen resource dan tidak dapat diubah setelah waktu pembuatan.
resourceParent

string

Nama lengkap resource induk langsung dari resource. Lihat: https://cloud.google.com/apis/design/resource_names#full_resource_name
resourceProject

string

Nama resource lengkap project tempat resource berada. Lihat: https://cloud.google.com/apis/design/resource_names#full_resource_name
resourceOwners[]

string

Pemilik resource Google Cloud.

Negara bagian/Provinsi

Status aset.

Saat membuat kueri di antara dua titik waktu, hal ini menjelaskan perubahan antara dua titik tersebut: ADDED, REMOVED, atau ACTIVE. Jika tidak ada compareDuration yang diberikan dalam permintaan, statusnya harus: UNUSED

Enum
STATE_UNSPECIFIED Status tidak ditentukan.
UNUSED Permintaan tidak menentukan penggunaan kolom ini dalam hasil.
ADDED Aset ditambahkan di antara titik waktu.
REMOVED Aset dihapus di antara titik waktu.
ACTIVE Aset aktif pada kedua titik waktu.