Crie e atualize um armazém de vídeos em streaming

Um Vision Warehouse é um componente que pode adicionar à sua app para armazenar dados de streaming e resultados de modelos.

Crie um armazém de vídeos de streaming

Para associar outros nós de componentes do gráfico da sua app a um armazém de dados, tem de criar primeiro um armazém de dados de vídeo em streaming.

Consola

  1. Abra o separador Armazéns do painel de controlo do Vertex AI Vision.

    Aceda ao separador Armazéns

  2. Selecione Criar.

  3. Adicione um nome para o armazém e escolha um período de tempo de vida (TTL) para os recursos armazenados no armazém. Pode modificar estes valores mais tarde.

    Depois de criar um armazém, pode adicionar o armazém a um gráfico de aplicações.

REST e linha de comandos

Cria um novo recurso corpus no projeto indicado com a opção de especificar o nome a apresentar, a descrição e um TTL.corpus

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • REGIONALIZED_ENDPOINT: o ponto final pode incluir um prefixo correspondente ao LOCATION_ID, como europe-west4-. Veja mais informações sobre os pontos finais regionalizados.
  • PROJECT_NUMBER: o seu Google Cloud número do projeto.
  • LOCATION_ID: A região onde está a usar o Vertex AI Vision. Por exemplo: us-central1, europe-west4. Veja as regiões disponíveis.
  • DISPLAY_NAME: nome a apresentar do armazém.
  • WAREHOUSE_DESCRIPTION: a descrição do armazém (corpus).
  • TIME_TO_LIVE: O tempo de vida (TTL) de todos os recursos num corpus ou o TTL de um recurso específico. Por exemplo, para um conjunto de dados com recursos com um TTL de 100 dias, indique o valor 8640000 (segundos).

Método HTTP e URL: 

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

Corpo JSON do pedido: 

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

Para enviar o seu pedido, escolha uma destas opções:

curl

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando: 

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

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando: 

$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

Deve receber uma resposta JSON semelhante à seguinte:

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

Atualize um banco de dados de vídeos em streaming

Atualiza um corpus existente no projeto especificado com a opção de atualizar o nome a apresentar, a descrição, o TTL predefinido ou todos os campos disponíveis.

REST e linha de comandos

Atualiza um recurso corpus existente no projeto indicado. Este exemplo mostra como atualizar o nome a apresentar, mas também pode atualizar a descrição, o TTL ou todos os campos em simultâneo através do mesmo formato de URL e do corpo do pedido atualizado.corpus

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • REGIONALIZED_ENDPOINT: o ponto final pode incluir um prefixo correspondente ao LOCATION_ID, como europe-west4-. Veja mais informações sobre os pontos finais regionalizados.
  • PROJECT_NUMBER: o seu Google Cloud número do projeto.
  • LOCATION_ID: A região onde está a usar o Vertex AI Vision. Por exemplo: us-central1, europe-west4. Veja as regiões disponíveis.
  • CORPUS_ID: o ID do seu corpus de destino.
  • ?updateMask=fieldToUpdate: um dos campos disponíveis aos quais pode aplicar um updateMask. Especifique o valor do novo campo correspondente no corpo do pedido. Este novo valor substitui o valor do campo existente. Campos disponíveis:
    • Nome a apresentar: ?updateMask=display_name
    • Descrição: ?updateMask=description
    • Tempo de vida (TTL) predefinido: ?updateMask=default_ttl
    • Atualize todos os campos: ?updateMask=*
  • UPDATED_FIELD_VALUE: um novo valor para o campo especificado. Neste exemplo, um novo nome a apresentar fornecido pelo utilizador para o recurso de armazém.

Método HTTP e URL: 

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

Corpo JSON do pedido: 

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

Para enviar o seu pedido, escolha uma destas opções:

curl

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando: 

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

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando: 

$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

Deve receber uma resposta JSON semelhante à seguinte:

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