Crea y actualiza un recurso de almacén

Un almacén de Vision conectado (corpus) en una app implementada que transfiere datos tiene uno o más recursos de objetos multimedia (por ejemplo, recursos de video). Estos objetos multimedia (recursos asset) contienen metadatos y anotaciones de recursos. Usa los siguientes comandos para crear y actualizar estos objetos multimedia.

Crea un recurso de almacén de video en streaming

Después de crear un almacén (recurso corpus), puedes agregar uno o más recursos de asset de video al almacén.

LÍNEA DE REST Y CMD

Con el siguiente código, se crea un activo nuevo en el almacén determinado (corpus) con la opción de especificar el ID del activo y un TTL.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • REGIONALIZED_ENDPOINT: El extremo puede incluir un prefijo que coincida con LOCATION_ID, como europe-west4-. Obtén más información sobre los extremos regionalizados.
  • PROJECT_NUMBER: Tu Google Cloud número de proyecto.
  • LOCATION_ID: La región en la que usas Vertex AI Vision. Por ejemplo: us-central1, europe-west4. Consulta las regiones disponibles.
  • CORPUS_ID: Es el ID de tu corpus de destino.
  • ASSET_ID: (Opcional) Es un valor proporcionado por el usuario para el ID del activo. En esta solicitud, el valor se agrega a la URL de la solicitud de la siguiente forma:
    • https://ENDPOINT/v1/[...]/corpora/CORPUS_ID/assets?asset_id=ASSET_ID
  • TIME_TO_LIVE: Es la cantidad de tiempo de actividad (TTL) para todos los activos de un corpus o el TTL de un activo específico. Por ejemplo, para un corpus con recursos con un TTL de 100 días, proporciona el valor 8640000 (segundos).

Método HTTP y URL: 

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

Cuerpo JSON de la solicitud:

{
  "ttl": {
    "seconds": TIME_TO_LIVE
  }
}

Para enviar tu solicitud, elige una de estas opciones:

curl

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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/CORPUS_ID/assets"

PowerShell

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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/CORPUS_ID/assets" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

SDK de Vertex AI Vision

Para enviar una solicitud para leer un flujo de salida de modelo, debes instalar el SDK de Vertex AI Vision.

Cuando usas la herramienta de línea de comandos de vaictl para crear un recurso, no puedes especificar un ID ni un TTL de recurso.

Realiza las siguientes sustituciones de variables:

  • PROJECT_NUMBER: Es el Google Cloud número de tu proyecto.
  • LOCATION_ID: Es el ID de tu ubicación. Por ejemplo, us-central1 Regiones admitidas. Más información.
  • CORPUS_ID: Es el ID del almacén de destino (recurso corpus).
vaictl --project-id=PROJECT_NUMBER \
--location-id=LOCATION_ID \
--service-endpoint=warehouse-visionai.googleapis.com \
create asset CORPUS_ID

Después de crear un activo, puedes transferir datos de video directamente al almacén de ese activo con la herramienta de línea de comandos de vaictl.

Actualiza un recurso de almacén de video de transmisión

Usa la siguiente muestra de código para actualizar el tiempo de vida útil (TTL) de un activo. Solo puedes actualizar el campo TTL.

Usa el parámetro de consulta updateMask en la siguiente muestra de código para actualizar el TTL de un activo. Puedes usar un parámetro de consulta para actualizar solo el campo TTL. updateMask funciona de la siguiente manera:

  • Si se especifica, solo se actualizan los campos en updateMask.
  • Si el valor de la máscara de actualización es *, la solicitud actualiza todos los campos.

  • Si no se especifica la máscara de actualización, solo se actualizan los campos de la URL de la solicitud con un valor proporcionado en el cuerpo de la solicitud.

LÍNEA DE REST Y CMD

En las siguientes muestras de código, se modifica el TTL de un activo con el método projects.locations.corpora.assets.patch.

Cambia un valor de TTL

En este ejemplo, se usa ?updateMask=ttl en la URL de la solicitud y se incluye un valor ttl.seconds nuevo en el cuerpo de la solicitud para actualizar el recurso.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • REGIONALIZED_ENDPOINT: El extremo puede incluir un prefijo que coincida con LOCATION_ID, como europe-west4-. Obtén más información sobre los extremos regionalizados.
  • PROJECT_NUMBER: Tu Google Cloud número de proyecto.
  • LOCATION_ID: La región en la que usas Vertex AI Vision. Por ejemplo: us-central1, europe-west4. Consulta las regiones disponibles.
  • CORPUS_ID: Es el ID de tu corpus de destino.
  • ASSET_ID: Es el ID del recurso de destino.
  • ?updateMask=fieldToUpdate: Es uno de los campos disponibles a los que puedes aplicar un updateMask. Campos disponibles:
    • Tiempo de actividad (TTL): ?updateMask=ttl
    • Actualiza todos los campos: ?updateMask=*

Método HTTP y URL: 

PATCH https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID?updateMask=ttl

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, elige una de estas opciones:

curl

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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/assets/ASSET_ID?updateMask=ttl"

PowerShell

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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/assets/ASSET_ID?updateMask=ttl" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

Cómo quitar un valor de TTL

En este ejemplo, se usa ?updateMask=ttl en la URL de la solicitud y se incluye un cuerpo de solicitud vacío para borrar el valor de TTL del activo.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • REGIONALIZED_ENDPOINT: El extremo puede incluir un prefijo que coincida con LOCATION_ID, como europe-west4-. Obtén más información sobre los extremos regionalizados.
  • PROJECT_NUMBER: Tu Google Cloud número de proyecto.
  • LOCATION_ID: La región en la que usas Vertex AI Vision. Por ejemplo: us-central1, europe-west4. Consulta las regiones disponibles.
  • CORPUS_ID: Es el ID de tu corpus de destino.
  • ASSET_ID: Es el ID del recurso de destino.
  • ?updateMask=fieldToUpdate: Es uno de los campos disponibles a los que puedes aplicar un updateMask. Campos disponibles:
    • Tiempo de actividad (TTL): ?updateMask=ttl
    • Actualiza todos los campos: ?updateMask=*

Método HTTP y URL: 

PATCH https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID?updateMask=ttl

Cuerpo JSON de la solicitud:

{}

Para enviar tu solicitud, elige una de estas opciones:

curl

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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/assets/ASSET_ID?updateMask=ttl"

PowerShell

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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/assets/ASSET_ID?updateMask=ttl" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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