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

Supprimer et exporter des jobs

Cette page explique comment supprimer et exporter des jobs Batch.

Lorsqu'une tâche est supprimée, les détails et l'historique de cette tâche qui apparaissent lorsque vous affichez une tâche et ses tâches 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 des autres produits Google Cloud 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 échec ou sa réussite. Avant de supprimer automatiquement une tâche, vous pouvez éventuellement effectuer l'une des opérations suivantes:

Exportez la tâche: si vous souhaitez conserver les informations liées à la tâche pendant plus de 60 jours, vous pouvez effectuer l'une des opérations suivantes:
- Exportez le job vers BigQuery. L'exemple de script export-to-bigquery-delete-batch-jobs exporte une tâche vers BigQuery, puis la supprime. Si vous ne souhaitez pas supprimer le job après l'avoir exporté, vous pouvez modifier l'exemple de script.
- Configurer des notifications Pub/Sub pour la tâche et les diffuser vers BigQuery Pour en savoir plus, consultez la page Surveiller les jobs à l'aide des notifications.
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 la page 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 attribuer 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 section Gérer les accès.

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

Supprimer une offre d'emploi

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 jobs.

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

La page Liste des jobs indique que le job a été supprimé.

gcloud

Pour supprimer une tâche à l'aide de gcloud CLI, exécutez 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: lieu 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: lieu 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 Batch Go.

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.

Afficher sur GitHub Commentaires

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 Batch Java.

Afficher sur GitHub Commentaires

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 Batch Node.js.

Afficher sur GitHub Commentaires

/**
 * 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);
}

callDeleteJob();

Python

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

Afficher sur GitHub Commentaires

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 Batch C++.

Afficher sur GitHub Commentaires

#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 et exporter des jobs

Avant de commencer

Supprimer une offre d'emploi

Console

gcloud

API

Go

Go

Java

Java

Node.js

Node.js

Python

Python

C++

C++

Étapes suivantes