Cette page a été traduite par l'API Cloud Translation.

Supprimer des jobs

Cette page explique comment supprimer et exporter des tâches par lot.

Lorsqu'une tâche est supprimée, les détails et l'historique de la tâche qui s'affichent lorsque vous consultez une tâche et ses tâches associées sont supprimés de Batch. Si vous souhaitez supprimer toutes les informations et ressources associées à une tâche, vous devez également supprimer les éléments de tous les produitsGoogle Cloud supplémentaires que vous avez activés, tels que les sujets Pub/Sub, les tables BigQuery ou les journaux Cloud Logging.

Google Cloud supprime automatiquement une tâche 60 jours après son annulation (Aperçu), son succès ou son échec. Avant qu'une tâche ne soit supprimée automatiquement, vous pouvez effectuer l'une des opérations suivantes:

Exporter les informations de la tâche: si vous souhaitez conserver les informations de la tâche pendant plus de 60 jours, vous pouvez les exporter vers BigQuery à l'aide de Workflows. Pour en savoir plus, consultez la section Exporter des informations sur les jobs.
Supprimer une tâche: comme expliqué dans ce document, vous pouvez supprimer manuellement une tâche lorsque vous êtes prêt à la retirer de la liste des tâches de votre projet et que vous n'avez plus besoin de son historique. Si vous supprimez une tâche avant ou pendant son exécution, elle est annulée.

Avant de commencer

Si vous n'avez jamais utilisé Batch, consultez Premiers pas avec Batch et activez Batch en remplissant les conditions préalables pour les projets et les utilisateurs.
Pour obtenir les autorisations nécessaires pour supprimer une tâche, demandez à votre administrateur de vous accorder le rôle IAM Éditeur de tâches par lot (roles/batch.jobsEditor) sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

Supprimer un job

Vous pouvez supprimer un job à l'aide de la console Google Cloud , de gcloud CLI, de l'API Batch, de Go, de Java, de Node.js, de Python ou de C++.

Console

Pour supprimer une tâche à l'aide de la console Google Cloud , procédez comme suit:

Dans la console Google Cloud , accédez à la page Liste des tâches.

Accéder à la liste des tâches
Cliquez sur le nom de la tâche que vous avez créée. La page "Job Details" (informations sur le job) s'ouvre alors.
Cliquez sur Supprimer.
Dans la boîte de dialogue Supprimer le job par lot ?, saisissez Delete dans le champ.
Cliquez sur Supprimer.

La page Liste des tâches indique que la tâche a été supprimée.

gcloud

Pour supprimer une tâche à l'aide de gcloud CLI, utilisez la commande gcloud batch jobs delete.

gcloud batch jobs delete JOB_NAME --location LOCATION

Remplacez les éléments suivants :

JOB_NAME: nom de la tâche.
LOCATION: emplacement de la tâche.

API

Pour supprimer une tâche à l'aide de l'API Batch, utilisez la méthode jobs.delete:

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

Remplacez les éléments suivants :

PROJECT_ID: ID de projet de votre projet.
LOCATION: emplacement de la tâche.
JOB_NAME: nom de la tâche.

Go

Pour en savoir plus, consultez la documentation de référence de l'API Go par lot.

Pour vous authentifier auprès de Batch, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement 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

Pour en savoir plus, consultez la documentation de référence de l'API Java par lot.

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

Pour en savoir plus, consultez la documentation de référence de l'API Node.js par lot.

/**
 * 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

Pour en savoir plus, consultez la documentation de référence de l'API Python par lot.

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++

Pour en savoir plus, consultez la documentation de référence de l'API C++ par lot.

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

Supprimer des jobs

Avant de commencer

Supprimer un job

Console

gcloud

API

Go

Go

Java

Java

Node.js

Node.js

Python

Python

C++

C++

Étape suivante