Supprimer des jobs

Cette page explique quand et comment supprimer des jobs Batch.

Attention : Attendez de supprimer un job jusqu'à ce que vous n'ayez plus besoin de ses informations, par exemple après avoir débogué un job ayant échoué. Si vous souhaitez arrêter ou empêcher l'exécution d'un job sans perdre ses informations, alors annulez le job à la place.

Lorsqu'un job est supprimé, ses détails et son historique qui s'affichent lorsque vous consultez un job et ses tâches sont supprimés de Batch. Si vous souhaitez supprimer toutes les informations et ressources associées à un job, vous devez également supprimer des éléments de tous les produits supplémentaires Google Cloud que vous avez activés, tels que les thèmes Pub/Sub, les tables BigQuery ou les journaux Cloud Logging.

Google Cloud supprime automatiquement un job 60 jours après son annulation, sa réussite ou son échec. Avant qu'un job ne soit automatiquement supprimé, vous pouvez éventuellement effectuer l'une des opérations suivantes :

• Exporter les informations sur le job : si vous souhaitez conserver les informations du job pendant plus de 60 jours, vous pouvez les exporter vers BigQuery à l'aide de Workflows. Pour en savoir plus, consultez Exporter des informations sur un job.

• Supprimer un job : comme expliqué dans ce document, vous pouvez supprimer manuellement un job lorsque vous êtes prêt à le supprimer de la liste des jobs de votre projet et que vous n’avez plus besoin de son historique. Si vous supprimez un job avant ou pendant son exécution, il est annulé et supprimé.

Avant de commencer

1. Si vous n'avez jamais utilisé Batch, consultez Premiers pas avec Batch et activez Batch en remplissant les prérequis pour les projets et les utilisateurs.

2. Pour obtenir les autorisations nécessaires pour supprimer un job, demandez à votre administrateur de vous accorder le rôle IAM Éditeur de jobs Batch (roles/batch.jobsEditor) sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez 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 Google Cloud console, de gcloud CLI, de l' API Batch, de Go, de Java, de Node.js, de Python ou de C++.

Console

Pour supprimer un job à l'aide de la Google Cloud console, procédez comme suit :

1. Dans la Google Cloud console, accédez à la page Job list (Liste des jobs).

   Accéder à la liste des jobs

2. Cliquez sur le nom du job que vous avez créé. La page Job details (Détails du job) s'ouvre.

3. Cliquez sur Delete (Supprimer).

4. Dans la boîte de dialogue Delete batch job? (Supprimer le job par lot ?), saisissez Delete dans le champ.

5. Cliquez sur Delete (Supprimer).

   La page Job list (Liste des jobs) indique que le job est supprimé.

gcloud

Pour supprimer un job à l'aide de gcloud CLI, utilisez la gcloud batch jobs delete commande.

gcloud batch jobs delete JOB_NAME --location LOCATION

Remplacez les éléments suivants :

• JOB_NAME : nom du job.
• LOCATION : l'emplacement du job.

API

Pour supprimer un job à l'aide de l'API Batch, utilisez la jobs.delete méthode :

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

Remplacez les éléments suivants :

• PROJECT_ID : l'ID du projet de votre projet.
• LOCATION : l'emplacement du job.
• JOB_NAME : nom du job.

Go

Go

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

Pour vous authentifier auprès de Batch, configurez le service 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

Java

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

Pour vous authentifier auprès de Batch, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

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

Node.js

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

Pour vous authentifier auprès de Batch, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

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

Python

Pour en savoir plus, consultez la documentation de référence de l'APIPython Batch.

Pour vous authentifier auprès de Batch, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

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

C++

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

Pour vous authentifier auprès de Batch, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

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

Étape suivante

• Exporter des informations sur un job.
• Afficher les jobs dans votre projet
• Créer un autre job