Membuat dan memperbarui aset warehouse

Vision Warehouse (corpus) yang terhubung dalam aplikasi yang di-deploy dan menyerap data memiliki satu atau beberapa resource objek media (misalnya, resource video). Objek media ini (resource asset) berisi metadata dan anotasi resource. Gunakan perintah berikut untuk membuat dan memperbarui objek media ini.

Membuat aset warehouse video streaming

Setelah Anda membuat warehouse (corpus resource), Anda dapat menambahkan satu atau beberapa resource asset video ke warehouse.

REST &CMD LINE

Kode berikut membuat aset baru di warehouse (corpus) yang diberikan dengan opsi untuk menentukan ID aset dan TTL.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• REGIONALIZED_ENDPOINT: Endpoint mungkin menyertakan awalan yang cocok dengan LOCATION_ID seperti seperti europe-west4-. Lihat lebih lanjut tentang endpoint regional.
• PROJECT_NUMBER: Nomor Google Cloud project Anda.
• LOCATION_ID: Region tempat Anda menggunakan Agent Platform Vision. Misalnya: us-central1, europe-west4. Lihat region yang tersedia.
• CORPUS_ID: ID corpus target Anda.
• ASSET_ID: (Opsional) Nilai yang diberikan pengguna untuk ID aset. Dalam permintaan ini, nilai ditambahkan ke URL permintaan dalam bentuk:
  • https://ENDPOINT/v1/[...]/corpora/CORPUS_ID/assets?asset_id=ASSET_ID
• TIME_TO_LIVE: Jumlah time to live (TTL) untuk semua aset dalam corpus, atau TTL aset tertentu. Misalnya, untuk corpus dengan aset yang memiliki TTL 100 hari, berikan nilai 8640000 (detik).

Metode HTTP dan URL:

POST https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets

Meminta isi JSON:

{
  "ttl": {
    "seconds": TIME_TO_LIVE
  }
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets"

PowerShell

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets" | Select-Object -Expand Content

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID",
  "ttl": "TIME_TO_LIVEs"
}

Gemini Enterprise Agent Platform Vision SDK

Untuk mengirim permintaan untuk membaca aliran output model, Anda harus menginstal Gemini Enterprise Agent Platform Vision SDK.

Saat menggunakan alat command line vaictl untuk membuat aset, Anda tidak dapat menentukan ID aset atau TTL.

Lakukan penggantian variabel berikut:

• PROJECT_NUMBER: Nomor Google Cloud project Anda.
• LOCATION_ID: ID lokasi Anda. Misalnya, us-central1. Region yang didukung. Informasi selengkapnya.
• CORPUS_ID: ID warehouse target (corpus resource).

vaictl --project-id=PROJECT_NUMBER \
--location-id=LOCATION_ID \
--service-endpoint=warehouse-visionai.googleapis.com \
create asset CORPUS_ID

Setelah aset dibuat, Anda dapat memasukkan data video langsung ke warehouse untuk aset tersebut menggunakan alat command line vaictl.

Memperbarui aset warehouse video streaming

Gunakan contoh kode berikut untuk memperbarui time-to-live (TTL) aset. Anda hanya dapat memperbarui kolom TTL.

Gunakan parameter kueri updateMask dalam contoh kode berikut untuk memperbarui TTL aset. Anda hanya dapat menggunakan parameter kueri untuk memperbarui kolom TTL. updateMask berfungsi sebagai berikut:

• Jika ditentukan, hanya kolom di updateMask yang diperbarui.
• Jika nilai mask update adalah *, permintaan akan memperbarui semua kolom.

• Jika mask update tidak ditentukan, hanya kolom di URL permintaan dengan nilai yang diberikan dalam isi permintaan yang diperbarui.

REST &CMD LINE

Contoh kode berikut mengubah TTL aset menggunakan metode projects.locations.corpora.assets.patch.

Mengubah nilai TTL

Contoh ini menggunakan ?updateMask=ttl di URL permintaan, dan menyertakan nilai ttl.seconds baru dalam isi permintaan untuk memperbarui aset.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• REGIONALIZED_ENDPOINT: Endpoint mungkin menyertakan awalan yang cocok dengan LOCATION_ID seperti seperti europe-west4-. Lihat lebih lanjut tentang endpoint regional.
• PROJECT_NUMBER: Nomor Google Cloud project Anda.
• LOCATION_ID: Region tempat Anda menggunakan Agent Platform Vision. Misalnya: us-central1, europe-west4. Lihat region yang tersedia.
• CORPUS_ID: ID corpus target Anda.
• ASSET_ID: ID aset target Anda.
• ?updateMask=fieldToUpdate: Salah satu kolom yang tersedia yang dapat Anda terapkan updateMask. Kolom yang tersedia:
  • Time-to-live (TTL): ?updateMask=ttl
  • Perbarui semua kolom: ?updateMask=*

Metode HTTP dan URL:

PATCH https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID?updateMask=ttl

Meminta isi JSON:

{
  "ttl": {
    "seconds": "1"
  }
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID?updateMask=ttl"

PowerShell

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID?updateMask=ttl" | Select-Object -Expand Content

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID"
}

Menghapus nilai TTL

Contoh ini menggunakan ?updateMask=ttl di URL permintaan, dan menyertakan isi permintaan kosong untuk menghapus nilai TTL aset.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• REGIONALIZED_ENDPOINT: Endpoint mungkin menyertakan awalan yang cocok dengan LOCATION_ID seperti seperti europe-west4-. Lihat lebih lanjut tentang endpoint regional.
• PROJECT_NUMBER: Nomor Google Cloud project Anda.
• LOCATION_ID: Region tempat Anda menggunakan Agent Platform Vision. Misalnya: us-central1, europe-west4. Lihat region yang tersedia.
• CORPUS_ID: ID corpus target Anda.
• ASSET_ID: ID aset target Anda.
• ?updateMask=fieldToUpdate: Salah satu kolom yang tersedia yang dapat Anda terapkan updateMask. Kolom yang tersedia:
  • Time-to-live (TTL): ?updateMask=ttl
  • Perbarui semua kolom: ?updateMask=*

Metode HTTP dan URL:

PATCH https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID?updateMask=ttl

Meminta isi JSON:

{}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID?updateMask=ttl"

PowerShell

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID?updateMask=ttl" | Select-Object -Expand Content

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID"
}