Streamingvideo-Warehouse erstellen und aktualisieren

Ein Vision Warehouse ist eine Komponente, die Sie Ihrer App hinzufügen können, um Modellausgaben und Streamingdaten zu speichern.

Streaming-Video-Warehouse erstellen

Wenn Sie andere Komponentenknoten Ihres App-Graphs mit einem Warehouse verknüpfen möchten, müssen Sie zuerst ein Streaming-Video-Warehouse erstellen.

Console

  1. Öffnen Sie im Vertex AI Vision Dashboard den Tab Warehouses (Lagerhäuser).

    Rufe den Tab „Lagerhäuser“ auf.

  2. Wählen Sie Erstellen aus.

  3. Geben Sie einen Namen für das Warehouse ein und wählen Sie eine Gültigkeitsdauer (TTL) für die im Warehouse gespeicherten Assets aus. Diese Werte können später geändert werden.

    Nachdem ein Warehouse erstellt wurde, können Sie es einer Anwendungsgrafik hinzufügen.

REST UND BEFEHLSZEILE

Erstellt eine neue corpus-Ressource unter dem angegebenen Projekt mit der Möglichkeit, den Anzeigenamen, die Beschreibung und die TTL der corpus anzugeben.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • REGIONALIZED_ENDPOINT: Der Endpunkt kann ein Präfix enthalten, das mit dem LOCATION_ID übereinstimmt, z. B. europe-west4-. Weitere Informationen zu regionalisierten Endpunkten
  • PROJECT_NUMBER: Ihre Google Cloud Projektnummer.
  • LOCATION_ID: Die Region, in der Sie Vertex AI Vision verwenden. Beispiel: us-central1, europe-west4. Weitere Informationen finden Sie unter Verfügbare Regionen.
  • DISPLAY_NAME: Anzeigename für das Lager.
  • WAREHOUSE_DESCRIPTION: Die Beschreibung des Lagers (corpus).
  • TIME_TO_LIVE: Die Gültigkeitsdauer (TTL) für alle Assets in einem Corpus oder die TTL eines bestimmten Assets. Geben Sie für einen Corpus mit Assets mit einer TTL von 100 Tagen beispielsweise den Wert 8640000 (Sekunden) an.

HTTP-Methode und URL:

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

JSON-Text der Anfrage:

{
  "display_name": "DISPLAY_NAME",
  "description": "WAREHOUSE_DESCRIPTION",
  "type": "STREAM_VIDEO",
  "default_ttl": {
    "seconds": TIME_TO_LIVE
  }
}

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

curl

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus: 

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"

PowerShell

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus: 

$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" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/warehouseoperations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.visionai.v1.CreateCorpusMetadata"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.visionai.v1.Corpus",
    "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID",
    "displayName": "DISPLAY_NAME",
    "description": "WAREHOUSE_DESCRIPTION",
    "type": "STREAM_VIDEO",
    "defaultTtl": "TIME_TO_LIVE"
  }
}

Streamingvideo-Data Warehouse aktualisieren

Aktualisiert einen vorhandenen Corpus im angegebenen Projekt. Dabei können der Anzeigename, die Beschreibung, die Standard-TTL oder alle verfügbaren Felder aktualisiert werden.

REST UND BEFEHLSZEILE

Aktualisiert eine vorhandene corpus-Ressource im angegebenen Projekt. In diesem Beispiel wird gezeigt, wie der Anzeigename der corpus aktualisiert wird. Sie können aber auch die Beschreibung, die TTL oder alle Felder gleichzeitig mit demselben URL-Format und aktualisiertem Anfragetext aktualisieren.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • REGIONALIZED_ENDPOINT: Der Endpunkt kann ein Präfix enthalten, das mit dem LOCATION_ID übereinstimmt, z. B. europe-west4-. Weitere Informationen zu regionalisierten Endpunkten
  • PROJECT_NUMBER: Ihre Google Cloud Projektnummer.
  • LOCATION_ID: Die Region, in der Sie Vertex AI Vision verwenden. Beispiel: us-central1, europe-west4. Weitere Informationen finden Sie unter Verfügbare Regionen.
  • CORPUS_ID: Die ID des Zielkorpus.
  • ?updateMask=fieldToUpdate: Eines der verfügbaren Felder, auf das ein updateMask angewendet werden kann. Geben Sie den entsprechenden neuen Feldwert im Anfragetext an. Dieser neue Wert ersetzt den vorhandenen Feldwert. Verfügbare Felder:
    • Anzeigename: ?updateMask=display_name
    • Beschreibung: ?updateMask=description
    • Standard-Gültigkeitsdauer (TTL): ?updateMask=default_ttl
    • Aktualisieren Sie alle Felder: ?updateMask=*
  • UPDATED_FIELD_VALUE: Ein neuer Wert für das angegebene Feld. In diesem Beispiel ist das ein neuer vom Nutzer angegebener Anzeigename für die Lagerressource.

HTTP-Methode und URL:

PATCH https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID?update_mask=display_name

JSON-Text der Anfrage:

{
  "displayName": "UPDATED_FIELD_VALUE",
  "description": "Original description",
  "defaultTtl": {
    "seconds": "7800"
  }
}

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

curl

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus: 

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?update_mask=display_name"

PowerShell

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus: 

$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?update_mask=display_name" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/corpora/CORPORA_ID",
  "displayName": "UPDATED_FIELD_VALUE",
  "description": "Original description",
  "defaultTtl": "7800s"
}