Esta página se ha traducido con Cloud Translation API.

Eliminar tareas

En esta página se describe cuándo y cómo eliminar trabajos por lotes.

Cuando se elimina una tarea, los detalles y el historial de la tarea que aparecen cuando consultas una tarea y sus subtareas se eliminan de Batch. Si quieres eliminar toda la información y los recursos asociados a un trabajo, también debes eliminar los elementos de losGoogle Cloud productos adicionales que hayas habilitado, como los temas de Pub/Sub, las tablas de BigQuery o los registros de Cloud Logging.

Google Cloud elimina automáticamente una tarea 60 días después de que se cancele, se complete o falle. Antes de que se elimine automáticamente una tarea, puedes hacer una de las siguientes acciones:

Información de la tarea de exportación: si quieres conservar la información de la tarea durante más de 60 días, puedes exportarla a BigQuery mediante Workflows. Para obtener más información, consulta Exportar información de los trabajos.
Eliminar un trabajo: como se explica en este documento, puedes eliminar manualmente un trabajo cuando quieras quitarlo de la lista de trabajos de tu proyecto y ya no necesites su historial. Si eliminas un trabajo antes de que se ejecute o mientras se está ejecutando, se cancelará y se eliminará.

Antes de empezar

Si no has usado Batch antes, consulta el artículo Empezar a usar Batch y habilita Batch completando los requisitos previos para proyectos y usuarios.
Para obtener los permisos que necesitas para eliminar un trabajo, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Editor de trabajos por lotes (roles/batch.jobsEditor) en el proyecto. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Eliminar una tarea

Puedes eliminar un trabajo mediante la Google Cloud consola, la CLI de gcloud, la API Batch, Go, Java, Node.js, Python o C++.

Consola

Para eliminar un trabajo mediante la consola Google Cloud , siga estos pasos:

En la Google Cloud consola, ve a la página Lista de tareas.

Ir a la lista de tareas
Haz clic en el nombre del trabajo que has creado. Se abrirá la página Detalles del trabajo.
Haz clic en Eliminar.
En el cuadro de diálogo ¿Eliminar trabajo por lotes?, introduce Delete en el campo.
Haz clic en Eliminar.

En la página Lista de tareas se indica que la tarea se ha eliminado.

gcloud

Para eliminar un trabajo con gcloud CLI, usa el comando gcloud batch jobs delete.

gcloud batch jobs delete JOB_NAME --location LOCATION

Haz los cambios siguientes:

JOB_NAME: el nombre del puesto.
LOCATION: la ubicación del puesto.

API

Para eliminar un trabajo mediante la API Batch, usa el método jobs.delete:

DELETE https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME

Haz los cambios siguientes:

PROJECT_ID: el ID de proyecto de tu proyecto.
LOCATION: la ubicación del puesto.
JOB_NAME: el nombre del puesto.

Go

Para obtener más información, consulta la documentación de referencia de la API Batch Go.

Para autenticarte en Batch, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.

import (
	"context"
	"fmt"
	"io"

	batch "cloud.google.com/go/batch/apiv1"
	"cloud.google.com/go/batch/apiv1/batchpb"
)

// Deletes the specified job
func deleteJob(w io.Writer, projectID, region, jobName string) error {
	// projectID := "your_project_id"
	// region := "us-central1"
	// jobName := "some-job"

	ctx := context.Background()
	batchClient, err := batch.NewClient(ctx)
	if err != nil {
		return fmt.Errorf("NewClient: %w", err)
	}
	defer batchClient.Close()

	req := &batchpb.DeleteJobRequest{
		Name: fmt.Sprintf("projects/%s/locations/%s/jobs/%s", projectID, region, jobName),
	}

	response, err := batchClient.DeleteJob(ctx, req)
	if err != nil {
		return fmt.Errorf("unable to delete job: %w", err)
	}

	fmt.Fprintf(w, "Job deleted: %v\n", response)

	return nil
}

Java

Para obtener más información, consulta la documentación de referencia de la API Batch Java.

import com.google.cloud.batch.v1.BatchServiceClient;
import java.io.IOException;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.TimeoutException;

public class DeleteJob {

  public static void main(String[] args)
      throws IOException, ExecutionException, InterruptedException, TimeoutException {
    // TODO(developer): Replace these variables before running the sample.
    // Project ID or project number of the Cloud project you want to use.
    String projectId = "YOUR_PROJECT_ID";

    // Name of the region hosts the job.
    String region = "europe-central2";

    // The name of the job that you want to delete.
    String jobName = "JOB_NAME";

    deleteJob(projectId, region, jobName);
  }

  // Triggers the deletion of a Job.
  public static void deleteJob(String projectId, String region, String jobName)
      throws IOException, ExecutionException, InterruptedException, TimeoutException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests. After completing all of your requests, call
    // the `batchServiceClient.close()` method on the client to safely
    // clean up any remaining background resources.
    try (BatchServiceClient batchServiceClient = BatchServiceClient.create()) {

      // Construct the parent path of the job.
      String name = String.format("projects/%s/locations/%s/jobs/%s", projectId, region, jobName);

      batchServiceClient.deleteJobAsync(name).get(5, TimeUnit.MINUTES);
      System.out.printf("Delete the job: %s", jobName);
    }
  }
}

Node.js

Para obtener más información, consulta la documentación de referencia de la API Batch Node.js.

/**
 * TODO(developer): Uncomment and replace these variables before running the sample.
 */
// const projectId = 'YOUR_PROJECT_ID';
/**
 * The region that hosts the job.
 */
// const region = 'us-central-1';
/**
 * The name of the job you want to delete.
 */
// const jobName = 'YOUR_JOB_NAME';

// Imports the Batch library
const batchLib = require('@google-cloud/batch');

// Instantiates a client
const batchClient = new batchLib.v1.BatchServiceClient();

async function callDeleteJob() {
  // Construct request
  const request = {
    name: `projects/${projectId}/locations/${region}/jobs/${jobName}`,
  };

  // Run request
  const [operation] = await batchClient.deleteJob(request);
  const [response] = await operation.promise();
  console.log(response);
}

await callDeleteJob();

Python

Para obtener más información, consulta la documentación de referencia de la API Batch Python.

from google.api_core.operation import Operation

from google.cloud import batch_v1


def delete_job(project_id: str, region: str, job_name: str) -> Operation:
    """
    Triggers the deletion of a Job.

    Args:
        project_id: project ID or project number of the Cloud project you want to use.
        region: name of the region hosts the job.
        job_name: the name of the job that you want to delete.

    Returns:
        An operation object related to the deletion. You can call `.result()`
        on it to wait for its completion.
    """
    client = batch_v1.BatchServiceClient()

    return client.delete_job(
        name=f"projects/{project_id}/locations/{region}/jobs/{job_name}"
    )

C++

Para obtener más información, consulta la documentación de referencia de la API Batch C++.

#include "google/cloud/batch/v1/batch_client.h"

  [](std::string const& project_id, std::string const& location_id,
     std::string const& job_id) {
    auto const name = "projects/" + project_id + "/locations/" + location_id +
                      "/jobs/" + job_id;
    google::cloud::batch::v1::DeleteJobRequest request;
    request.set_name(name);
    // Initialize a client and issue the request.
    auto client = google::cloud::batch_v1::BatchServiceClient(
        google::cloud::batch_v1::MakeBatchServiceConnection());
    auto future = client.DeleteJob(request);
    // Wait until the long-running operation completes.
    auto success = future.get();
    if (!success) throw std::move(success).status();
    std::cout << "Job " << name << " successfully deleted\n";
  }

Eliminar tareas Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Antes de empezar

Eliminar una tarea

Consola

gcloud

API

Go

Go

Java

Java

Node.js

Node.js

Python

Python

C++

C++

Siguientes pasos

Eliminar tareas