Operaciones de larga duración

Para algunas llamadas a la API, Vertex AI muestra los nombres de las operaciones. En estas llamadas a la API, se inician las operaciones que requieren tiempo para completarse y se conocen como operaciones de larga duración. Por ejemplo, la creación de un conjunto de datos, la eliminación de un extremo o la exportación de un modelo son operaciones de larga duración. Puedes usar métodos de ayuda junto con nombres de operación para obtener el estado de una operación de larga duración o cancelarla, como se describe en las secciones siguientes.

Obtén el estado de una operación

Para obtener el estado de la operación, usa el nombre de la operación que estaba en la respuesta cuando solicitaste una operación de larga duración. Por ejemplo, cuando creas un conjunto de datos, Vertex AI muestra un nombre de operación, como:
projects/PROJECT_NUMBER/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID

Puedes consultar la operación a intervalos regulares para saber cuándo se completa una operación.

REST

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

  • OPERATION_NAME: El nombre de la operación que se muestra cuando inicias una operación de larga duración, como projects/PROJECT_NUMBER/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID

Método HTTP y URL: 

GET https://LOCATION-aiplatform.googleapis.com/v1/OPERATION_NAME

Para enviar tu solicitud, elige una de estas opciones:

curl

Ejecuta el siguiente comando: 

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://LOCATION-aiplatform.googleapis.com/v1/OPERATION_NAME"

PowerShell

Ejecuta el siguiente comando: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://LOCATION-aiplatform.googleapis.com/v1/OPERATION_NAME" | Select-Object -Expand Content

En el resultado, el objeto metadata contiene información específica para el tipo de solicitud. El campo done indica si se completó la operación. Si la operación se completa, el objeto response contiene sus resultados.

{
  "name": "projects/123456789012/locations/us-central1/datasets/1234567890123456789/operations/1223344556677889900",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateDatasetOperationMetadata",
    "genericMetadata": {
      "createTime": "2020-10-12T16:00:44.686500Z",
      "updateTime": "2020-10-12T16:01:06.115081Z"
    }
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.Dataset",
    "name": "projects/123456789012/locations/us-central1/datasets/1234567890123456789",
    "displayName": "image_dataset",
    "metadataSchemaUri": "gs://google-cloud-aiplatform/schema/dataset/metadata/image_1.0.0.yaml",
    "labels": {
      "aiplatform.googleapis.com/dataset_metadata_schema": "IMAGE"
    },
    "metadata": {
      "dataItemSchemaUri": "gs://google-cloud-aiplatform/schema/dataset/dataitem/image_1.0.0.yaml"
    }
  }
}

Cancela una operación

Puedes cancelar una operación de larga duración para detenerla antes de que se complete. Cuando cancelas una operación de forma correcta, la operación no se borra. En su lugar, se detiene con un código de error de 1 y con un mensaje CANCELLED. Ten en cuenta que no se garantiza que la cancelación se realice de forma correcta.

REST

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

  • OPERATION_NAME: El nombre de la operación que se muestra cuando inicias una operación de larga duración, como projects/PROJECT_NUMBER/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID

Método HTTP y URL: 

POST https://LOCATION-aiplatform.googleapis.com/v1/OPERATION_NAME:cancel

Para enviar tu solicitud, elige una de estas opciones:

curl

Ejecuta el siguiente comando: 

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://LOCATION-aiplatform.googleapis.com/v1/OPERATION_NAME:cancel"

PowerShell

Ejecuta el siguiente comando: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://LOCATION-aiplatform.googleapis.com/v1/OPERATION_NAME:cancel" | Select-Object -Expand Content

Deberías recibir un código de estado exitoso (2xx) y una respuesta vacía.