Halaman ini diterjemahkan oleh Cloud Translation API.

Membuat dan memperbarui aset warehouse

Vision Warehouse (corpus) terhubung dalam aplikasi yang di-deploy untuk proses transfer 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 membuat warehouse (resource corpus), Anda dapat menambahkan satu atau beberapa resource asset video ke warehouse.

REST & CMD LINE

Kode berikut membuat aset baru di bawah penyimpanan yang diberikan (corpus) 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 europe-west4-. Lihat selengkapnya tentang endpoint yang diregionalkan.
PROJECT_NUMBER: Nomor project Google CloudAnda.
LOCATION_ID: Region tempat Anda menggunakan Vertex AI Vision. Misalnya: us-central1, europe-west4. Lihat region yang tersedia.
CORPUS_ID: ID korpus 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 korpus, atau TTL aset tertentu. Misalnya, untuk korpus dengan aset dengan 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

Isi JSON permintaan:

{
  "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 dengan 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 dengan 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 melihat respons JSON seperti berikut:

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

Vertex AI Vision SDK

Untuk mengirim permintaan guna membaca aliran output model, Anda harus menginstal Vertex AI 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: Google Cloud Nomor project Anda.
LOCATION_ID: ID lokasi Anda. Contoh, us-central1. Wilayah yang didukung. Informasi selengkapnya.
CORPUS_ID: ID warehouse target (resource corpus).

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

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

Memperbarui aset warehouse video streaming

Gunakan contoh kode berikut untuk memperbarui waktu aktif (TTL) aset. Anda hanya dapat memperbarui kolom TTL.

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

Jika ditentukan, hanya kolom di updateMask yang akan diperbarui.
Jika nilai update mask adalah *, permintaan akan memperbarui semua kolom.
Jika mask pembaruan tidak ditentukan, hanya kolom di URL permintaan dengan nilai yang diberikan dalam isi permintaan yang akan 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 europe-west4-. Lihat selengkapnya tentang endpoint yang diregionalkan.
PROJECT_NUMBER: Nomor project Google CloudAnda.
LOCATION_ID: Region tempat Anda menggunakan Vertex AI Vision. Misalnya: us-central1, europe-west4. Lihat region yang tersedia.
CORPUS_ID: ID korpus target Anda.
ASSET_ID: ID aset target Anda.
?updateMask=fieldToUpdate: Salah satu kolom yang tersedia tempat Anda dapat menerapkan 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

Isi JSON permintaan:

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

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

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

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 melihat respons JSON seperti berikut:

{
  "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 europe-west4-. Lihat selengkapnya tentang endpoint yang diregionalkan.
PROJECT_NUMBER: Nomor project Google CloudAnda.
LOCATION_ID: Region tempat Anda menggunakan Vertex AI Vision. Misalnya: us-central1, europe-west4. Lihat region yang tersedia.
CORPUS_ID: ID korpus target Anda.
ASSET_ID: ID aset target Anda.
?updateMask=fieldToUpdate: Salah satu kolom yang tersedia tempat Anda dapat menerapkan 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

Isi JSON permintaan:

{}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

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

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