创建和更新在线视频仓库

Vision 仓库是一种可以添加到应用中的组件，用于存储模型输出和流式数据。

创建流式视频仓库

如需将应用图的其他组件节点连接到仓库，您必须先创建一个在线视频仓库。

控制台

  1. 打开 Vertex AI Vision 信息中心的仓库标签页。

    前往“仓库”标签页

  2. 选择 创建。

  3. 为仓库添加名称，并为存储在仓库中的资源选择存留时间 (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 为 100 天的资源的语料库，请提供值 8640000（秒）。

HTTP 方法和网址：

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

将请求正文保存在名为 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

将请求正文保存在名为 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 显示名称，但您也可以使用相同的网址格式和更新后的请求正文同时更新说明、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 的某个可用字段。在请求正文中指定相应的新字段值。此新值会替换现有字段值。可用字段：
    • 显示名：?updateMask=display_name
    • 说明：?updateMask=description
    • 默认存留时间 (TTL)：?updateMask=default_ttl
    • 更新所有字段：?updateMask=*
  • UPDATED_FIELD_VALUE：指定字段的新值。在此示例中，为仓库资源提供的新的用户提供的显示名称。

HTTP 方法和网址：

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