このページは Cloud Translation API によって翻訳されました。

ストリーミング動画ウェアハウスを作成して更新する

Vision Warehouse は、アプリに追加してモデルの出力とストリーミングデータを保存できるコンポーネントです。

ストリーミング動画ウェアハウスを作成する

アプリグラフの他のコンポーネントノードをウェアハウスに接続するには、まずストリーミング動画ウェアハウスを作成する必要があります。

Console

Vertex AI Vision ダッシュボードの [倉庫] タブを開きます。

[倉庫] タブに移動
[作成] を選択します。
ウェアハウスの名前を追加し、ウェアハウスに保存されるアセットの有効期間（TTL）を選択します。これらの値は後で変更できます。

ウェアハウスを作成したら、アプリケーショングラフにウェアハウスを追加できます。

REST とコマンドライン

指定されたプロジェクトに新しい corpus リソースを作成し、corpus の表示名、説明、TTL を指定します。

リクエストのデータを使用する前に、次のように置き換えます。

REGIONALIZED_ENDPOINT: エンドポイントには、LOCATION_ID に一致する接頭辞（europe-west4- など）が含まれている場合があります。リージョン化されたエンドポイントの詳細をご覧ください。
PROJECT_NUMBER: Google Cloud プロジェクト番号。
LOCATION_ID: Vertex AI Vision を使用するリージョン。例: us-central1、europe-west4。利用可能なリージョンをご覧ください。
DISPLAY_NAME: 倉庫の表示名。
WAREHOUSE_DESCRIPTION: ウェアハウスの説明（corpus）。
TIME_TO_LIVE: コーパス内のすべてのアセットの有効期間（TTL）または特定のアセットの TTL。たとえば、TTL が 100 日のアセットを含むコーパスの場合は、値 8640000（秒）を指定します。

HTTP メソッドと URL:

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

リクエストの本文（JSON）:

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

リクエストを送信するには、次のいずれかのオプションを選択します。

curl

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザーアカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

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

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ご自分のユーザーアカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$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

次のような JSON レスポンスが返されます。

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

ストリーミング動画倉庫を更新する

指定したプロジェクトの既存のコーパスを更新します。表示名、説明、デフォルトの TTL を更新するか、使用可能なすべてのフィールドを更新できます。

REST とコマンドライン

指定されたプロジェクトの既存の corpus リソースを更新します。このサンプルでは、corpus の表示名を更新する方法を示していますが、同じ URL 形式と更新されたリクエスト本文を使用して、説明、TTL、またはすべてのフィールドを一度に更新することもできます。

リクエストのデータを使用する前に、次のように置き換えます。

REGIONALIZED_ENDPOINT: エンドポイントには、LOCATION_ID に一致する接頭辞（europe-west4- など）が含まれている場合があります。リージョン化されたエンドポイントの詳細をご覧ください。
PROJECT_NUMBER: Google Cloud プロジェクト番号。
LOCATION_ID: Vertex AI Vision を使用するリージョン。例: us-central1、europe-west4。利用可能なリージョンをご覧ください。
CORPUS_ID: ターゲットコーパスの ID。
?updateMask=fieldToUpdate: updateMask を適用できる使用可能なフィールドの 1 つ。リクエスト本文で、対応する新しいフィールド値を指定します。この新しい値は、既存のフィールド値に置き換えられます。使用可能なフィールド:
- 表示名: ?updateMask=display_name
- 説明: ?updateMask=description
- デフォルトの有効期間（TTL）: ?updateMask=default_ttl
- すべてのフィールドを更新: ?updateMask=*
UPDATED_FIELD_VALUE: 指定されたフィールドの新しい値。この例では、倉庫リソースの新しいユーザー指定の表示名。

HTTP メソッドと URL:

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

リクエストの本文（JSON）:

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

リクエストを送信するには、次のいずれかのオプションを選択します。

curl

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

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

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$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

次のような JSON レスポンスが返されます。

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