Method: transferJobs.list

Répertorie les tâches de transfert.

Requête HTTP

GET https://storagetransfer.googleapis.com/v1/transferJobs

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
filter

string

Obligatoire. Liste de paramètres de requête spécifiés sous forme de texte JSON au format suivant:

{
  "projectId":"my_project_id",
  "jobNames":["jobid1","jobid2",...],
  "jobStatuses":["status1","status2",...],
  "dataBackend":"QUERY_REPLICATION_CONFIGS",
  "sourceBucket":"source-bucket-name",
  "sinkBucket":"sink-bucket-name",
}

La mise en forme JSON de l'exemple est à des fins d'affichage uniquement. Fournissez les paramètres de requête sans espaces ni retours à la ligne.

  • Veuillez renseigner l'élément projectId.
  • Étant donné que jobNames et jobStatuses acceptent plusieurs valeurs, leurs valeurs doivent être spécifiées à l'aide de l'notation de tableau. jobNames et jobStatuses sont facultatifs. Les valeurs valides sont insensibles à la casse :
  • Spécifiez "dataBackend":"QUERY_REPLICATION_CONFIGS" pour afficher la liste des jobs de réplication entre les buckets.
  • Limitez les résultats aux tâches d'un bucket spécifique avec sourceBucket et/ou à un bucket spécifique avec sinkBucket.

L'autorisation IAM suivante est requise pour la ressource filter indiquée :

  • storagetransfer.jobs.list
pageSize

integer

Taille de la page de la liste. La valeur maximale autorisée est de 256.
pageToken

string

Le jeton de page de la liste.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Réponse de transferJobs.list.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "transferJobs": [
    {
      object (TransferJob)
    }
  ],
  "nextPageToken": string
}
Champs
transferJobs[]

object (TransferJob)

Liste des tâches de transfert.
nextPageToken

string

Jeton de page suivante de la liste.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez Authentication Overview.