Dokumen ini menunjukkan cara memperbarui bucket Cloud Storage untuk pengguna Cloud FTP, termasuk bucket yang dapat diakses pengguna dan izin yang dimiliki pengguna.
Secara umum, berikut adalah langkah-langkah untuk memperbarui bucket pengguna:
- Perbarui peran IAM untuk akun layanan pengguna.
- Petakan direktori pengguna ke bucket yang diperbarui.
Sebelum memulai
Buat satu atau beberapa bucket Cloud Storage untuk menyimpan data yang akan digunakan pengguna, jika bucket belum ada. Anda dapat memberi pengguna akses ke maksimum 10 bucket.
Peran yang diperlukan
Untuk mendapatkan izin yang
diperlukan guna memperbarui pengguna SFTP,
minta administrator untuk memberi Anda
peran IAM FTP Admin (roles/ftp.admin) di project Anda.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Peran bawaan ini berisi izin
ftp.users.update,
yang diperlukan untuk
memperbarui pengguna SFTP.
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Memperbarui peran IAM untuk akun layanan pengguna
Jika Anda mengubah bucket yang dapat diakses pengguna, atau jika Anda mengubah izin yang dimiliki pengguna untuk pemetaan direktori yang ada, Anda harus memperbarui akun layanan pengguna dengan peran IAM yang relevan. Lakukan hal berikut:
Dapatkan alamat email akun layanan pengguna. Untuk mengetahui langkah-langkahnya, lihat Mendapatkan detail tentang pengguna.
Jika Anda menambahkan bucket baru ke pemetaan direktori atau meningkatkan akses ke bucket yang ada, lakukan hal berikut:
Beri diri Anda sendiri peran Storage Bucket Viewer (
roles/storage.bucketViewer) di bucket, jika Anda belum memiliki peran tersebut:gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME \ --member="user:ADMINISTRATOR_EMAIL" \ --role="roles/storage.bucketViewer"
Ganti kode berikut:
ADMINISTRATOR_EMAIL: alamat email principal yang membuat pengguna SFTP. Jika Anda membuat pengguna (bukan aplikasi), nilai ini adalah alamat email yang Anda gunakan untuk mengakses Google Cloud.BUCKET_NAME: nama bucket.
Berikan peran Storage Object Viewer (
roles/storage.objectViewer) kepada diri Anda sendiri di bucket, jika Anda belum memiliki peran tersebut:gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME \ --member="user:ADMINISTRATOR_EMAIL" \ --role="roles/storage.objectViewer"
Berikan peran IAM yang diperlukan untuk mengakses bucket kepada akun layanan pengguna:
gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME \ --member="serviceAccount:SERVICE_ACCOUNT" \ --role="ROLE_TO_GRANT"
Ganti kode berikut:
SERVICE_ACCOUNT: alamat email akun layanan pengguna.ROLE_TO_GRANT: peran IAM yang akan diberikan. Tentukan salah satu peran berikut:- Untuk akses hanya baca, gunakan peran
roles/storage.objectViewer. - Untuk akses baca dan tulis, gunakan peran
roles/storage.objectAdmin.
- Untuk akses hanya baca, gunakan peran
Ulangi langkah sebelumnya untuk setiap bucket yang perlu diakses pengguna.
Jika Anda menghapus bucket dari pemetaan direktori atau mengurangi akses ke bucket yang ada, batalkan akses dari akun layanan pengguna:
gcloud storage buckets remove-iam-policy-binding gs://BUCKET_NAME \ --member="serviceAccount:SERVICE_ACCOUNT" \ --role="ROLE_TO_REVOKE"
Ganti
ROLE_TO_REVOKEdengan peran IAM yang ingin Anda cabut.Ulangi langkah ini untuk setiap bucket dan peran IAM yang tidak boleh lagi diakses oleh pengguna.
Memperbarui bucket pengguna
gcloud
Untuk memperbarui bucket bagi pengguna SFTP, jalankan
perintah gcloud alpha storage ftp users update.
Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:
- USERNAME: nama pengguna SFTP pengguna.
- LOCATION_ID: lokasi server, seperti
us-west1. - SERVER_ID: ID server.
- BUCKET_NAME: nama bucket yang dapat diakses oleh pengguna SFTP, seperti
example-bucket. Hilangkangs://. - (Opsional) BUCKET_PREFIX: jalur folder dalam bucket yang akan ditetapkan sebagai
direktori root untuk pemetaan direktori ini.
Jika Anda menghapus properti
bucket_prefix, maka Cloud FTP akan menggunakan root bucket. -
DIRECTORY: jalur direktori landing logis yang ditampilkan kepada pengguna SFTP. Contoh,
/home/uploads.Jika Anda memetakan beberapa bucket atau folder, berikan jalur direktori unik untuk setiap pemetaan.
Direktori logis bertingkat tidak didukung. Jika Anda menyediakan beberapa pemetaan untuk sebuah direktori, sediakan direktori dalam struktur datar, bukan struktur bertingkat. Misalnya, gunakan
/dir1dan/dir2, bukan/dir1dan/dir1/dir2. - SFTP_PERMISSION: tingkat akses untuk direktori. Untuk akses hanya baca, tetapkan
nilai ini ke
READ_ONLY. Untuk akses baca dan tulis, tetapkan nilai ini keREAD_WRITE.
Untuk memberi pengguna akses ke beberapa bucket, berikan flag --storage-directory-mapping
beberapa kali, dengan pemetaan direktori untuk setiap bucket.
Jalankan perintah berikut:
Linux, macOS, atau Cloud Shell
gcloud alpha storage ftp users update USERNAME --location=LOCATION_ID \ --server=SERVER_ID \ --storage-directory-mapping=bucket=BUCKET_NAME,bucket_prefix=BUCKET_PREFIX,directory=DIRECTORY,permission=SFTP_PERMISSION
Windows (PowerShell)
gcloud alpha storage ftp users update USERNAME --location=LOCATION_ID ` --server=SERVER_ID ` --storage-directory-mapping=bucket=BUCKET_NAME,bucket_prefix=BUCKET_PREFIX,directory=DIRECTORY,permission=SFTP_PERMISSION
Windows (cmd.exe)
gcloud alpha storage ftp users update USERNAME --location=LOCATION_ID ^ --server=SERVER_ID ^ --storage-directory-mapping=bucket=BUCKET_NAME,bucket_prefix=BUCKET_PREFIX,directory=DIRECTORY,permission=SFTP_PERMISSION
Jika pengguna memiliki koneksi SFTP yang aktif, mereka mungkin perlu memutuskan koneksi, lalu menghubungkannya kembali agar setelan bucket yang diperbarui berlaku.
REST
Untuk memperbarui bucket pengguna SFTP, gunakan
metode servers.users.patch.
Dalam parameter kueri updateMask, berikan kolom storageDirectoryMappings.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_ID: project ID Google Cloud server.
- LOCATION_ID: lokasi
server, seperti
us-west1. - SERVER_ID: ID server.
- USERNAME: nama pengguna SFTP.
- BUCKET_NAME: nama bucket yang aksesnya diberikan kepada pengguna SFTP, seperti
example-bucket. Hilangkangs://. - (Opsional) BUCKET_PREFIX: jalur folder dalam bucket yang akan ditetapkan sebagai direktori root untuk pemetaan direktori ini. Jika Anda menghapus nilai ini, Cloud FTP akan menggunakan root bucket.
-
DIRECTORY: jalur direktori landing logis yang ditampilkan kepada pengguna SFTP. Contoh,
/home/uploads. Jika Anda menghapus nilai ini, Cloud FTP akan menetapkan direktori landing ke/.Jika Anda memetakan beberapa bucket atau folder, berikan jalur direktori unik untuk setiap pemetaan.
Direktori logis bertingkat tidak didukung. Jika Anda menyediakan beberapa pemetaan untuk sebuah direktori, sediakan direktori dalam struktur datar, bukan struktur bertingkat. Misalnya, gunakan
/dir1dan/dir2, bukan/dir1dan/dir1/dir2. - SFTP_PERMISSION: tingkat akses untuk direktori. Untuk akses hanya baca, tetapkan nilai ini ke
READ_ONLY. Untuk akses baca dan tulis, tetapkan nilai ini keREAD_WRITE.
Untuk memberi pengguna akses ke beberapa bucket, berikan beberapa pemetaan bucket dalam daftar storageDirectoryMappings.
Metode HTTP dan URL:
PATCH https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID/users/USERNAME?updateMask=storageDirectoryMappings
Meminta isi JSON:
{
"storageDirectoryMappings": [
{
"bucket": "BUCKET_NAME",
"bucketPrefix": "BUCKET_PREFIX",
"directory": "DIRECTORY",
"permission": "SFTP_PERMISSION"
}
]
}
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Respons mengidentifikasi operasi yang berjalan lama. Perlu waktu beberapa detik untuk memperbarui pengguna.Jika pengguna memiliki koneksi SFTP yang aktif, mereka mungkin perlu memutuskan koneksi, lalu menghubungkannya kembali agar setelan bucket yang diperbarui berlaku.
Library klien
C#
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud FTP, lihat Library klien Cloud FTP. Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API C# Cloud FTP.
Untuk melakukan autentikasi ke Cloud FTP, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Go
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud FTP, lihat Library klien Cloud FTP. Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API Go Cloud FTP.
Untuk melakukan autentikasi ke Cloud FTP, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud FTP, lihat Library klien Cloud FTP. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Java Cloud FTP.
Untuk melakukan autentikasi ke Cloud FTP, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud FTP, lihat Library klien Cloud FTP. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Node.js Cloud FTP.
Untuk melakukan autentikasi ke Cloud FTP, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
PHP
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud FTP, lihat Library klien Cloud FTP. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API PHP Cloud FTP.
Untuk melakukan autentikasi ke Cloud FTP, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud FTP, lihat Library klien Cloud FTP. Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API Python Cloud FTP.
Untuk melakukan autentikasi ke Cloud FTP, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Ruby
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud FTP, lihat Library klien Cloud FTP. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Ruby Cloud FTP.
Untuk melakukan autentikasi ke Cloud FTP, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.