Halaman ini menjelaskan cara mengubah kelas penyimpanan objek dalam bucket dengan menulis ulang objek tersebut.
- Untuk mempelajari cara mengubah kelas penyimpanan objek tanpa menulis ulang objek, lihat fitur Object Lifecycle Management.
- Untuk mempelajari cara Cloud Storage dapat mengelola kelas penyimpanan objek Anda secara otomatis, lihat fitur Autoclass.
Izin yang diperlukan
Konsol
Kelas penyimpanan objek individual tidak dapat ditetapkan melalui Konsol Google Cloud. Sebagai gantinya, gunakan Google Cloud CLI.
Command line
Untuk menyelesaikan panduan ini menggunakan utilitas command line, Anda harus memiliki izin IAM yang tepat. Jika objek yang ingin Anda akses ada dalam project yang tidak Anda buat, Anda mungkin memerlukan project owner untuk memberi Anda peran yang berisi izin yang diperlukan.
Untuk mengetahui daftar izin yang diperlukan untuk tindakan tertentu, lihat Izin IAM untuk perintah gcloud storage
.
Untuk daftar peran yang relevan, lihat peran Cloud Storage. Atau, Anda dapat membuat peran khusus yang memiliki izin tertentu dan terbatas.
Library klien
Untuk menyelesaikan panduan ini menggunakan library klien Cloud Storage, Anda harus memiliki izin IAM yang tepat. Jika objek yang ingin Anda akses ada dalam project yang tidak Anda buat, Anda mungkin memerlukan project owner untuk memberi Anda peran yang berisi izin yang diperlukan.
Kecuali jika dinyatakan lain, permintaan library klien dibuat melalui JSON API dan memerlukan izin seperti yang tercantum dalam izin IAM untuk metode JSON. Untuk melihat metode JSON API mana yang dipanggil saat Anda membuat permintaan menggunakan library klien, buat log permintaan mentah.
Untuk daftar peran IAM yang relevan, lihat peran Cloud Storage. Atau, Anda dapat membuat peran khusus yang memiliki izin tertentu dan terbatas.
REST API
JSON API
Untuk menyelesaikan panduan ini menggunakan JSON API, Anda harus memiliki izin IAM yang sesuai. Jika objek yang ingin diakses ada dalam project yang tidak Anda buat, Anda mungkin perlu project owner untuk memberi Anda peran yang berisi izin yang diperlukan.
Untuk mengetahui daftar izin yang diperlukan untuk tindakan tertentu, lihat Izin IAM untuk metode JSON.
Untuk daftar peran yang relevan, lihat peran Cloud Storage. Atau, Anda dapat membuat peran khusus yang memiliki izin tertentu dan terbatas.
Mengubah kelas penyimpanan objek
Selesaikan langkah-langkah berikut untuk mengubah kelas penyimpanan objek:
Konsol
Kelas penyimpanan objek individual tidak dapat ditetapkan melalui Konsol Google Cloud. Sebagai gantinya, gunakan Google Cloud CLI.
Command line
Gunakan perintah gcloud storage objects update
dengan flag --storage-class
. Contoh:
gcloud storage objects update gs://BUCKET_NAME/OBJECT_NAME --storage-class=STORAGE_CLASS
Dengan keterangan:
BUCKET_NAME
adalah nama bucket yang berisi objek yang class-nya ingin Anda ubah. Contoh,my-bucket
.OBJECT_NAME
adalah nama objek yang class-nya ingin Anda ubah. Contoh,pets/dog.png
.STORAGE_CLASS
adalah kelas penyimpanan baru untuk objek Anda. Misalnya,nearline
.
Library klien
C++
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
C#
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C# API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Go
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Go API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Node.js API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
PHP
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage PHP API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Python API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Ruby
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Ruby API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
REST API
JSON API
Telah menginstal dan melakukan inisialisasigcloud CLI, agar dapat membuat token akses untuk header
Authorization
.Atau, Anda dapat membuat token akses menggunakan OAuth 2.0 Playground dan menyertakannya di header
Authorization
.Buat file JSON yang berisi informasi berikut:
{ "storageClass": "STORAGE_CLASS" }
Dengan keterangan:
STORAGE_CLASS
adalah kelas penyimpanan baru untuk objek Anda. Misalnya,nearline
.
Gunakan
cURL
untuk memanggil JSON API dengan permintaan ObjekPOST
:curl -X POST --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME/rewriteTo/b/BUCKET_NAME/o/OBJECT_NAME"
Dengan keterangan:
JSON_FILE_NAME
adalah jalur untuk file JSON yang Anda buat pada Langkah 2.BUCKET_NAME
adalah nama bucket yang berisi objek asli. Contoh,my-bucket
.OBJECT_NAME
adalah nama objek yang dienkode ke URL. Misalnya,pets/dog.png
, dienkode URL sebagaipets%2Fdog.png
.
XML API
Telah menginstal dan melakukan inisialisasigcloud CLI, agar dapat membuat token akses untuk header
Authorization
.Atau, Anda dapat membuat token akses menggunakan OAuth 2.0 Playground dan menyertakannya di header
Authorization
.Gunakan
cURL
untuk memanggil XML API dengan permintaanPUT
Object:curl -X PUT --data-binary @OBJECT \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: OBJECT_CONTENT_TYPE" \ -H "x-goog-storage-class: STORAGE_CLASS" \ "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
Dengan keterangan:
OBJECT
adalah jalur lokal ke objek yang kelas penyimpanannya ingin Anda ubah (Anda harus mengupload ulang objek saat mengubah kelas penyimpanan dengan XML API). Misalnya,Desktop/dog.png
.OBJECT_CONTENT_TYPE
adalah jenis konten objek. Contoh,image/png
.STORAGE_CLASS
adalah kelas penyimpanan baru untuk objek Anda. Contoh,nearline
.BUCKET_NAME
adalah nama bucket yang berisi objek yang Anda tulis ulang. Contoh,my-bucket
.OBJECT_NAME
adalah nama berenkode URL dari objek yang Anda tulis ulang. Contoh,pets/dog.png
, URL dienkode sebagaipets%2Fdog.png
.
Langkah selanjutnya
- Pelajari kelas penyimpanan yang tersedia.
- Mengubah kelas penyimpanan objek dengan Object Lifecycle Management.
- Pelajari fitur siklus proses data Cloud Storage lainnya.
- Pelajari metadata objek.
- Pelajari cara menggunakan prasyarat permintaan untuk mencegah kondisi race.