Per garantire un'alta qualità e la coerenza con le altre librerie Cloud, la documentazione di Storage Transfer Service ora utilizza le librerie client di Cloud anziché le librerie client delle API di Google. Per saperne di più sulle due opzioni, consulta Descrizione delle librerie client.
La libreria client delle API di Google continua a ricevere aggiornamenti, ma non è più presente nella documentazione.
Questa guida illustra le principali differenze relative all'utilizzo di Storage Transfer Service e fornisce istruzioni sull'aggiornamento dei client durante la migrazione alla libreria client di Cloud.
Java
Aggiorna le dipendenze
Per passare alla nuova libreria, sostituisci la dipendenza da google-api-services-storagetransfer con google-cloud-storage-transfer.
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-storage-transfer</artifactId>
<version>1.80.0</version>
</dependency>Se utilizzi Gradle senza BOM, aggiungi quanto segue alle tue dipendenze:
implementation 'com.google.cloud:google-cloud-storage-transfer:1.80.0'
Se utilizzi Maven con una BOM, aggiungi quanto segue al file pom.xml:
<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>
</dependencies>
Nella maggior parte dei casi, il codice può essere convertito abbastanza facilmente dalla libreria client API alla libreria client di Cloud. Di seguito sono riportate alcune differenze chiave tra i due client Java.
Creazione di un'istanza client
La libreria client di Cloud riduce gran parte del codice boilerplate associato alla creazione di istanze client gestendolo dietro le quinte.
Libreria client 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();
Libreria client di Cloud
StorageTransferServiceClient storageTransfer = StorageTransferServiceClient.create();
Builder per le classi di modelli
Le classi di modelli nella libreria client di Cloud utilizzano i builder anziché i costruttori.
Libreria client API
TransferJob transferJob =
new TransferJob()
.setStatus("ENABLED");
Libreria client di Cloud
TransferJob transferJob =
TransferJob.newBuilder()
.setStatus(Status.ENABLED)
.build();
Le operazioni di elenco restituiscono iterabili
Le operazioni di elenco nella libreria client di Cloud restituiscono iterabili semplici anziché i risultati impaginati nella libreria client dell'API.
Libreria client 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();
}
}
Libreria client di Cloud
public class StoragetransferExample {
public static void main(String args[]) throws Exception {
StorageTransferServiceClient storageTransfer = StorageTransferServiceClient.create();
ListTransferJobsRequest request =
ListTransferJobsRequest.newBuilder().setFilter("{\"projectId\": \"my-project-id\"}").build();
for (TransferJob job : storageTransfer.listTransferJobs(request).iterateAll()) {
System.out.println(job);
}
}
}
Confronti di esempio
Di seguito sono riportati gli esempi della libreria client API precedente, confrontati con gli esempi equivalenti che utilizzano la libreria client Cloud. Se hai già utilizzato questi esempi, puoi utilizzare questo confronto per capire come spostare il codice nella nuova libreria client di Cloud.
Trasferimento da Amazon S3
Libreria client API
Libreria client di Cloud
Trasferisci a Nearline
Libreria client API
Libreria client di Cloud
Controlla l'ultima operazione di trasferimento
Libreria client API
Libreria client di Cloud
Python
Aggiorna le dipendenze
Per utilizzare la nuova libreria, aggiungi una dipendenza su google-cloud-storage-transfer.
Verrà utilizzato al posto del client di rilevamento di google-api-python-client.
pip install --upgrade google-cloud-storage-transfer
Creazione di un'istanza client
Utilizza il modulo storage_transfer anziché googleapiclient.discovery.
Libreria client API
Libreria client di Cloud
Confronti di esempio
Per illustrare le differenze tra le due librerie, di seguito sono riportati gli esempi di client API precedenti affiancati ai loro equivalenti nella libreria client di Cloud.
Trasferimento da Amazon S3
Libreria client API
Libreria client di Cloud
Trasferisci a Nearline
Libreria client API
Libreria client di Cloud
Nota l'importazione di google.protobuf.duration_pb2.Duration.
Controlla l'ultima operazione di trasferimento
Libreria client API
Libreria client di Cloud
Nota l'utilizzo di storage_transfer.TransferOperation.deserialize