Untuk memastikan kualitas tinggi dan agar konsisten dengan library Cloud kami yang lain, dokumentasi untuk Storage Transfer Service kini menggunakan Library Klien Cloud, bukan Library Klien Google API. Baca Penjelasan library klien untuk mengetahui informasi selengkapnya tentang kedua opsi tersebut.
Library Klien Google API akan terus menerima update, tetapi tidak lagi direferensikan dalam dokumentasi.
Panduan ini membahas perbedaan utama yang berlaku untuk penggunaan Storage Transfer Service, dan memberikan petunjuk cara mengupdate klien saat bermigrasi ke Library Klien Cloud.
Java
Memperbarui dependensi
Untuk beralih ke library baru, ganti dependensi Anda pada
google-api-services-storagetransfer
dengan google-cloud-storage-transfer
.
<dependency> <groupId>com.google.cloud</groupId> <artifactId>google-cloud-storage-transfer</artifactId> <version>0.2.3</version> </dependency>
Jika Anda menggunakan Gradle tanpa BOM, tambahkan ini ke dependensi Anda:
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>
Umumnya, kode dapat dengan mudah dikonversi dari Library Klien API ke Library Klien Cloud. Berikut adalah beberapa perbedaan utama antara kedua klien Java ini
Pembuatan instance klien
Library Klien Cloud mengurangi banyak boilerplate yang terkait dengan pembuatan instance klien dengan menanganinya di balik layar.
Library Klien 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();
Library Klien Cloud
StorageTransferServiceClient storageTransfer = StorageTransferServiceClient.create();
Builder untuk class model
Class model di Library Klien Cloud menggunakan builder, bukan konstruktor.
Library Klien API
TransferJob transferJob =
new TransferJob()
.setStatus("ENABLED");
Library Klien Cloud
TransferJob transferJob =
TransferJob.newBuilder()
.setStatus(Status.ENABLED)
.build();
Operasi daftar menampilkan iterable
Operasi daftar di Library Klien Cloud menampilkan iterable sederhana, bukan hasil yang telah dipaginasi di Library Klien API.
Library Klien 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();
}
}
Library Klien 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);
}
}
}
Contoh perbandingan
Di sini, kami menyertakan contoh Library Klien API lama, dibandingkan dengan contoh padanannya menggunakan Library Klien Cloud. Jika sudah pernah menggunakan contoh ini, Anda dapat menggunakan perbandingan ini untuk memahami cara memindahkan kode ke Library Klien Cloud yang baru.
Transfer dari Amazon S3
Library Klien API
Library Klien Cloud
Transfer ke nearline
Library Klien API
Library Klien Cloud
Memeriksa operasi transfer terbaru
Library Klien API
Library Klien Cloud
Python
Memperbarui dependensi
Untuk menggunakan library baru, tambahkan dependensi pada google-cloud-storage-transfer
.
Ini akan digunakan, bukan klien discovery dari
google-api-python-client
.
pip install --upgrade google-cloud-storage-transfer
Pembuatan instance klien
Gunakan modul storage_transfer
, bukan googleapiclient.discovery
.
Library Klien API
Library Klien Cloud
Contoh perbandingan
Untuk menggambarkan perbedaan antara kedua library tersebut, berikut adalah Sampel Klien API lama secara berdampingan dengan padanannya di Library Klien Cloud.
Transfer dari Amazon S3
Library Klien API
Library Klien Cloud
Transfer ke nearline
Library Klien API
Library Klien Cloud
Perhatikan impor google.protobuf.duration_pb2.Duration
.
Memeriksa operasi transfer terbaru
Library Klien API
Library Klien Cloud
Perhatikan penggunaan storage_transfer.TransferOperation.deserialize