Pour garantir une haute qualité et être cohérente avec nos autres bibliothèques Cloud, la documentation du service de transfert de stockage utilise désormais les bibliothèques clientes Cloud au lieu des bibliothèques clientes des API Google. Pour en savoir plus sur ces deux options, consultez la section Présentation des bibliothèques clientes.
La bibliothèque cliente des API Google continue de recevoir des mises à jour, mais elle n'est plus référencée dans la documentation.
Ce guide décrit les principales différences applicables à l'utilisation du service de transfert de stockage et fournit des instructions pour mettre à jour vos clients lors de la migration vers la bibliothèque cliente Cloud.
Java
Mettre à jour les dépendances
Pour passer à la nouvelle bibliothèque, remplacez votre dépendance à google-api-services-storagetransfer par google-cloud-storage-transfer.
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-storage-transfer</artifactId>
<version>0.2.3</version>
</dependency>
Si vous utilisez Gradle sans BOM, ajoutez ce qui suit à vos dépendances:
implementation 'com.google.cloud:google-cloud-storage-transfer:0.2.3'
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>libraries-bom</artifactId>
<version>24.1.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<dependencies>
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-storage-transfer</artifactId>
</dependency>
Dans la plupart des cas, le code peut être facilement converti de la bibliothèque cliente des API vers la bibliothèque cliente Cloud. Voici quelques-unes des principales différences entre les deux clients Java
Instanciation du client
La bibliothèque cliente Cloud gère une grande partie du code récurrent associé à l'instanciation du client en le gérant en arrière-plan.
Bibliothèque cliente des API
GoogleCredentials credential = GoogleCredentials.getApplicationDefault();
if (credential.createScopedRequired()) {
credential = credential.createScoped(StoragetransferScopes.all());
}
Storagetransfer storageTransfer = new Storagetransfer.Builder(Utils.getDefaultTransport(),
Utils.getDefaultJsonFactory(), new HttpCredentialsAdapter(credential))
.build();
Bibliothèque cliente Cloud
StorageTransferServiceClient storageTransfer = StorageTransferServiceClient.create();
Compilateurs pour les classes de modèle
Les classes Model de la bibliothèque cliente Cloud utilisent des compilateurs plutôt que des constructeurs.
Bibliothèque cliente des API
TransferJob transferJob =
new TransferJob()
.setStatus("ENABLED");
Bibliothèque cliente Cloud
TransferJob transferJob =
TransferJob.newBuilder()
.setStatus(Status.ENABLED)
.build();
Les opérations de liste renvoient des itérables
Les opérations de liste de la bibliothèque cliente Cloud renvoient des itérables simples au lieu des résultats paginés dans la bibliothèque cliente des API.
Bibliothèque cliente des API
public class StoragetransferExample {
public static void main(String args[]) throws IOException, GeneralSecurityException {
Storagetransfer storagetransferService = createStoragetransferService();
Storagetransfer.TransferJobs.List request = storagetransferService.transferJobs().list();
ListTransferJobsResponse response;
do {
response = request.execute();
if (response.getTransferJobs() == null) {
continue;
}
for (TransferJob transferJob : response.getTransferJobs()) {
System.out.println(transferJob);
}
request.setPageToken(response.getNextPageToken());
} while (response.getNextPageToken() != null);
}
public static Storagetransfer createStoragetransferService()
throws IOException, GeneralSecurityException {
HttpTransport httpTransport = GoogleNetHttpTransport.newTrustedTransport();
JsonFactory jsonFactory = JacksonFactory.getDefaultInstance();
GoogleCredential credential = GoogleCredential.getApplicationDefault();
}
return new Storagetransfer.Builder(httpTransport, jsonFactory, credential)
.build();
}
}
Bibliothèque cliente Cloud
public class StoragetransferExample {
public static void main(String args[]) throws Exception {
StorageTransferServiceClient storageTransfer = StorageTransferServiceClient.create();
ListTransferJobsRequest request = ListTransferJobsRequest.newBuilder().build();
for (TransferJob job : client.listTransferJobs(request).iterateAll()) {
System.out.println(job);
}
}
}
Exemples de comparaisons
Ici, nous incluons les anciens exemples de la bibliothèque cliente des API, comparés aux exemples équivalents utilisant la bibliothèque cliente Cloud. Si vous avez déjà utilisé ces exemples, vous pouvez utiliser cette comparaison pour comprendre comment déplacer votre code vers la nouvelle bibliothèque cliente Cloud.
Transférer depuis Amazon S3
Bibliothèque cliente des API
Bibliothèque cliente Cloud
Transférer vers Nearline
Bibliothèque cliente des API
Bibliothèque cliente Cloud
Vérifier la dernière opération de transfert
Bibliothèque cliente des API
Bibliothèque cliente Cloud
Python
Mettre à jour les dépendances
Pour utiliser la nouvelle bibliothèque, ajoutez une dépendance à google-cloud-storage-transfer.
Il sera utilisé à la place du client de découverte de google-api-python-client.
pip install --upgrade google-cloud-storage-transfer
Instanciation du client
Utilisez le module storage_transfer au lieu de googleapiclient.discovery.
Bibliothèque cliente des API
Bibliothèque cliente Cloud
Exemples de comparaisons
Pour illustrer les différences entre les deux bibliothèques, voici les anciens exemples de clients API, côte à côte et leurs équivalents dans la bibliothèque cliente Cloud.
Transférer depuis Amazon S3
Bibliothèque cliente des API
Bibliothèque cliente Cloud
Transférer vers Nearline
Bibliothèque cliente des API
Bibliothèque cliente Cloud
Notez l'importation de google.protobuf.duration_pb2.Duration.
Vérifier la dernière opération de transfert
Bibliothèque cliente des API
Bibliothèque cliente Cloud
Notez l'utilisation de storage_transfer.TransferOperation.deserialize.