Sebagian atau seluruh informasi di halaman ini mungkin tidak berlaku untuk Trusted Cloud dari S3NS. Lihat Perbedaan dari Google Cloud untuk mengetahui detail selengkapnya.

Halaman ini diterjemahkan oleh Cloud Translation API.

Menemukan penyimpanan objek dengan alat gcloud

Halaman ini menunjukkan cara melakukan tugas-tugas dasar di Cloud Storage menggunakan alat command line gcloud.

Biaya yang dikenakan di Cloud Storage didasarkan pada resource yang Anda gunakan. Panduan memulai ini biasanya menggunakan resource Cloud Storage senilai kurang dari $0,01 USD.

Sebelum memulai

Install the Google Cloud CLI.
Konfigurasi gcloud CLI untuk menggunakan identitas gabungan Anda.

Untuk mengetahui informasi selengkapnya, lihat Login ke gcloud CLI dengan identitas gabungan Anda.
Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:
```
gcloud init
```
Create or select a Trusted Cloud project.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.
- Create a Trusted Cloud project:
```
gcloud projects create PROJECT_ID
```
  Replace PROJECT_ID with a name for the Trusted Cloud project you are creating.
- Select the Trusted Cloud project that you created:
```
gcloud config set project PROJECT_ID
```
  Replace PROJECT_ID with your Trusted Cloud project name.
Verify that billing is enabled for your Trusted Cloud project.
Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/storage.admin
```
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
```
Replace the following:
- PROJECT_ID: your project ID.
- USER_IDENTIFIER: the identifier for your user account. For examples, see Represent workforce pool users in IAM policies.
- ROLE: the IAM role that you grant to your user account.

Membuat bucket

Bucket adalah container dasar yang menyimpan data Anda di Cloud Storage.

Untuk membuat bucket:

Buka jendela terminal.
Gunakan perintah gcloud storage buckets create dan nama unik untuk membuat bucket:
```
gcloud storage buckets create gs://my-awesome-bucket/ --uniform-bucket-level-access --location=LOCATION_NAME
```
Kode ini menggunakan bucket bernama "my-awesome-bucket". Anda harus memilih sendiri nama bucket yang unik secara global.
Lihat persyaratan penamaan bucket.
- Nama bucket hanya boleh berisi huruf kecil, karakter numerik, tanda hubung (-), dan garis bawah (_). Tidak diperbolehkan ada spasi.
- Nama bucket harus diawali dan diakhiri dengan angka atau huruf.
- Nama bucket harus berisi 3-63 karakter. Nama yang mengandung titik dapat berisi hingga 222 karakter, tetapi masing-masing komponen yang dipisahkan titik dapat berisi lebih dari 63 karakter.
- Nama bucket tidak dapat direpresentasikan sebagai alamat IP dalam notasi desimal bertitik (misalnya, 192.168.5.4).
- Nama bucket tidak boleh dimulai dengan awalan "goog".
- Nama bucket tidak boleh berisi "google" atau kesalahan ejaan yang menyerupainya, seperti "g00gle".
Perhatian: Jangan menyertakan informasi sensitif di nama bucket, karena namespace bucket bersifat global dan dapat dilihat publik.

Jika berhasil, perintah menampilkan:
```
Creating gs://my-awesome-bucket/...
```

Anda berhasil membuat bucket tempat Anda bisa menyimpan data!

Creating gs://my-awesome-bucket/...
ServiceException: 409 Bucket my-awesome-bucket already exists.

Coba lagi dengan nama bucket yang berbeda.

Mengupload objek ke dalam bucket

Gambar anak kucing yang akan diupload ke bucket.

Klik kanan gambar di atas dan simpan di mana saja di komputer, misalnya di desktop.

Catatan: Jika Anda menggunakan instance Compute Engine, download image menggunakan perintah berikut: wget https://cloud.google.com/storage/images/kitten.png

Gunakan perintah gcloud storage cp untuk menyalin gambar dari lokasi tempat Anda menyimpannya ke bucket yang Anda buat:

gcloud storage cp Desktop/kitten.png gs://my-awesome-bucket

Jika berhasil, perintah menampilkan:

Copying file://Desktop/kitten.png [Content-Type=image/png]...
Uploading   gs://my-awesome-bucket/kitten.png:       0 B/164.3 KiB
Uploading   gs://my-awesome-bucket/kitten.png:       164.3 KiB/164.3 KiB

Anda berhasil menyimpan objek di dalam bucket.

Mendownload objek dari bucket Anda

Gunakan perintah gcloud storage cp untuk mendownload gambar yang Anda simpan di bucket ke suatu tempat di komputer, seperti desktop:

gcloud storage cp gs://my-awesome-bucket/kitten.png Desktop/kitten2.png

Jika berhasil, perintah menampilkan:

Copying gs://my-awesome-bucket/kitten.png...
Downloading file://Desktop/kitten2.png:               0 B/164.3 KiB
Downloading file://Desktop/kitten2.png:               164.3 KiB/164.3 KiB

Anda baru saja mendownload sesuatu dari bucket Anda.

Menyalin objek ke folder di dalam bucket

Gunakan perintah gcloud storage cp untuk membuat folder dan menyalin gambar ke dalamnya:
```
gcloud storage cp gs://my-awesome-bucket/kitten.png gs://my-awesome-bucket/just-a-folder/kitten3.png
```
Catatan: Folder di Cloud Storage memiliki batasan dibandingkan dengan sistem file lokal, tetapi banyak operasi yang sama didukung.

Jika berhasil, perintah menampilkan:
```
Copying gs://my-awesome-bucket/kitten.png [Content-Type=image/png]...
Copying     ...my-awesome-bucket/just-a-folder/kitten3.png: 164.3 KiB/164.3 KiB
```
Anda baru saja menyalin gambar ke dalam folder baru di bucket Anda.

Mencantumkan konten dari bucket atau folder

Gunakan perintah gcloud storage ls untuk menampilkan daftar konten di level teratas bucket Anda:
```
gcloud storage ls gs://my-awesome-bucket
```
Jika berhasil, perintah menampilkan pesan yang mirip dengan:
```
gs://my-awesome-bucket/kitten.png
gs://my-awesome-bucket/just-a-folder/
```
Anda baru saja melihat konten di level atas bucket Anda.

Mencantumkan detail untuk objek

Gunakan perintah gcloud storage ls, dengan flag --long untuk mendapatkan beberapa detail tentang salah satu gambar Anda:
```
gcloud storage ls gs://my-awesome-bucket/kitten.png --long
```
Jika berhasil, perintah menampilkan pesan yang mirip dengan:
```
2638  2016-02-26T23:05:14Z  gs://my-awesome-bucket/kitten.png
TOTAL: 1 objects, 168243.2 bytes (164.3 KiB)
```
Anda baru saja memperoleh informasi tentang ukuran dan tanggal pembuatan image.

Membuat objek dapat diakses secara publik

Gunakan perintah gcloud storage buckets add-iam-policy-binding untuk memberikan izin kepada semua pengguna untuk membaca gambar yang disimpan di bucket Anda:
```
gcloud storage buckets add-iam-policy-binding gs://my-awesome-bucket --member=allUsers --role=roles/storage.objectViewer
```
Perintah tersebut berhasil jika respons Anda berisi berikut ini:
```
bindings:
  - members:
    - allUsers
    role: roles/storage.objectViewer
```
Sekarang, siapa saja bisa mendapatkan image Anda.
Untuk menghapus akses ini, gunakan perintah:
```
gcloud storage buckets remove-iam-policy-binding gs://my-awesome-bucket --member=allUsers --role=roles/storage.objectViewer
```
Perintah berhasil jika tidak ada error yang ditampilkan.

Anda telah menghapus akses publik ke gambar di bucket Anda.

Memberi seseorang akses ke bucket Anda

Gunakan perintah gcloud storage buckets add-iam-policy-binding untuk memberikan izin ke alamat email tertentu untuk menambahkan objek ke bucket Anda:

gcloud storage buckets add-iam-policy-binding gs://my-awesome-bucket --member=user:example-service-account@example-project.s3ns-system.iam.gserviceaccount.com --role=roles/storage.objectCreator

Perintah tersebut berhasil jika respons Anda berisi berikut ini:

bindings:
  - members:
    - user:example-service-account@example-project.s3ns-system.iam.gserviceaccount.com
    role: roles/storage.objectCreator

Sekarang, orang lain dapat menambahkan item ke bucket Anda.

Untuk menghapus izin ini, gunakan perintah:

gcloud storage buckets remove-iam-policy-binding gs://my-awesome-bucket --member=user:example-service-account@example-project.s3ns-system.iam.gserviceaccount.com --role=roles/storage.objectCreator

Perintah berhasil jika tidak ada error yang ditampilkan.

Anda telah menghapus akses pengguna ke bucket ini.

Menghapus objek

Gunakan perintah gcloud storage rm untuk menghapus salah satu image Anda:
```
gcloud storage rm gs://my-awesome-bucket/kitten.png
```
Jika berhasil, perintah menampilkan:
```
Removing gs://my-awesome-bucket/kitten.png...
```
Salinan gambar ini tidak lagi disimpan di Cloud Storage (meskipun salinan yang Anda buat di folder just-a-folder/ masih ada).

Pembersihan

Agar tidak menimbulkan biaya pada akun Trusted Cloud Anda untuk resource yang digunakan di halaman ini, hapus project Trusted Cloud yang berisi resource tersebut.

Buka jendela terminal (jika belum terbuka).
Gunakan perintah gcloud storage rm dengan flag --recursive untuk menghapus bucket dan apa pun yang ada di dalamnya:
```
gcloud storage rm gs://my-awesome-bucket --recursive
```
Jika berhasil, perintah menampilkan pesan yang mirip dengan:
```
Removing gs://my-awesome-bucket/just-a-folder/cloud-storage.logo.png#1456530077282000...
Removing gs://my-awesome-bucket/...
```
Bucket Anda beserta isinya dihapus.

Langkah berikutnya

Lihat halaman referensi untuk perintah Google Cloud CLI, seperti make bucket (buckets create), copy (cp), list (ls), add access (buckets add-iam-policy-binding), dan remove (rm).