Halaman ini menjelaskan cara mencantumkan dan mengedit akun layanan menggunakan
Identity and Access Management (IAM) API, konsol Trusted Cloud , dan alat command line gcloud
.
Sebelum memulai
Enable the IAM API.
Menyiapkan autentikasi.
Select the tab for how you plan to use the samples on this page:
Console
When you use the Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.
gcloud
Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:
gcloud init
C#
Untuk menggunakan contoh .NET di halaman ini dalam lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.
Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda.
Create local authentication credentials for your user account:
gcloud auth application-default login
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Untuk mengetahui informasi selengkapnya, lihat Menyiapkan ADC untuk lingkungan pengembangan lokal dalam dokumentasi autentikasi Trusted Cloud .
C++
Untuk menggunakan contoh C++ di halaman ini dalam lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.
Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda.
Create local authentication credentials for your user account:
gcloud auth application-default login
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Untuk mengetahui informasi selengkapnya, lihat Menyiapkan ADC untuk lingkungan pengembangan lokal dalam dokumentasi autentikasi Trusted Cloud .
Go
Untuk menggunakan contoh Go di halaman ini dalam lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.
Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda.
Create local authentication credentials for your user account:
gcloud auth application-default login
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Untuk mengetahui informasi selengkapnya, lihat Menyiapkan ADC untuk lingkungan pengembangan lokal dalam dokumentasi autentikasi Trusted Cloud .
Java
Untuk menggunakan contoh Java di halaman ini dalam lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.
Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda.
Create local authentication credentials for your user account:
gcloud auth application-default login
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Untuk mengetahui informasi selengkapnya, lihat Menyiapkan ADC untuk lingkungan pengembangan lokal dalam dokumentasi autentikasi Trusted Cloud .
Python
Untuk menggunakan contoh Python di halaman ini dalam lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.
Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda.
Create local authentication credentials for your user account:
gcloud auth application-default login
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Untuk mengetahui informasi selengkapnya, lihat Menyiapkan ADC untuk lingkungan pengembangan lokal dalam dokumentasi autentikasi Trusted Cloud .
REST
Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, Anda menggunakan kredensial yang Anda berikan ke gcloud CLI.
Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda.
Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Trusted Cloud .
Memahami akun layanan IAM
Peran yang diperlukan
Untuk mendapatkan izin yang diperlukan untuk mengelola akun layanan, minta administrator untuk memberi Anda peran IAM berikut pada project:
-
Untuk melihat akun layanan:
Lihat Akun Layanan (
roles/iam.serviceAccountViewer
) -
Untuk mengedit akun layanan:
Admin Akun Layanan (
roles/iam.serviceAccountAdmin
)
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.
Untuk mempelajari lebih lanjut tentang peran ini, lihat Peran Akun Layanan.
Peran dasar IAM juga berisi izin untuk mengelola akun layanan. Anda tidak boleh memberikan peran dasar dalam lingkungan produksi, tetapi Anda dapat memberikannya dalam lingkungan pengembangan atau pengujian.
Mencantumkan akun layanan
Anda dapat mencantumkan akun layanan yang dikelola pengguna dalam sebuah project untuk membantu Anda mengaudit akun layanan dan kunci, atau sebagai bagian dari alat khusus untuk mengelola akun layanan.
Anda tidak dapat mencantumkan agen layanan yang mungkin muncul di log audit dan kebijakan yang diizinkan project Anda. Agen layanan tidak berada di project Anda, dan Anda tidak dapat mengaksesnya secara langsung.
Konsol
Di konsol Trusted Cloud , buka halaman Service accounts.
Pilih project.
Halaman Akun layanan mencantumkan semua akun layanan yang dikelola pengguna dalam project yang Anda pilih.
gcloud
-
In the Trusted Cloud console, activate Cloud Shell.
At the bottom of the Trusted Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
-
Jalankan perintah
gcloud iam service-accounts list
untuk menampilkan daftar semua akun layanan dalam sebuah project.Perintah:
gcloud iam service-accounts list
Outputnya adalah daftar semua akun layanan yang dikelola pengguna dalam project:
NAME EMAIL SA_DISPLAY_NAME_1 SA_NAME_1@PROJECT_ID.s3ns-system.iam.gserviceaccount.com SA_DISPLAY_NAME_2 SA_NAME_2@PROJECT_ID.s3ns-system.iam.gserviceaccount.com
PROJECT_ID
: ID project Trusted Cloud Anda. Project ID adalah string alfanumerik, sepertimy-project
.
C++
Untuk mempelajari cara menginstal dan menggunakan library klien untuk IAM, lihat library klien IAM. Untuk informasi selengkapnya, lihat dokumentasi referensi API C++ IAM.
Untuk melakukan autentikasi ke IAM, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Sebelum memulai.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan
GOOGLE_CLOUD_UNIVERSE_DOMAIN
kes3nsapis.fr
.C#
Untuk mempelajari cara menginstal dan menggunakan library klien untuk IAM, lihat library klien IAM. Untuk informasi selengkapnya, lihat dokumentasi referensi API C# IAM.
Untuk melakukan autentikasi ke IAM, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Sebelum memulai.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan
GOOGLE_CLOUD_UNIVERSE_DOMAIN
kes3nsapis.fr
.Go
Untuk mempelajari cara menginstal dan menggunakan library klien untuk IAM, lihat library klien IAM. Untuk informasi selengkapnya, lihat dokumentasi referensi API Go IAM.
Untuk melakukan autentikasi ke IAM, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Sebelum memulai.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan
GOOGLE_CLOUD_UNIVERSE_DOMAIN
kes3nsapis.fr
.Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk IAM, lihat library klien IAM. Untuk informasi selengkapnya, lihat dokumentasi referensi API Java IAM.
Untuk melakukan autentikasi ke IAM, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Sebelum memulai.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan
GOOGLE_CLOUD_UNIVERSE_DOMAIN
kes3nsapis.fr
.Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk IAM, lihat library klien IAM. Untuk informasi selengkapnya, lihat dokumentasi referensi API Python IAM.
Untuk melakukan autentikasi ke IAM, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Sebelum memulai.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan
GOOGLE_CLOUD_UNIVERSE_DOMAIN
kes3nsapis.fr
.REST
Metode
serviceAccounts.list
mencantumkan setiap akun layanan yang dikelola pengguna di project Anda.Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
Metode HTTP dan URL:
GET https://iam.googleapis.com/v1/projects/PROJECT_ID/serviceAccounts
Untuk mengirim permintaan, perluas salah satu opsi berikut:
Anda akan melihat respons JSON seperti berikut:
{ "accounts": [ { "name": "projects/my-project/serviceAccounts/sa-1@my-project.s3ns-system.iam.gserviceaccount.com", "projectId": "my-project", "uniqueId": "123456789012345678901", "email": "sa-1@my-project.s3ns-system.iam.gserviceaccount.com", "description": "My first service account", "displayName": "Service account 1", "etag": "BwUpTsLVUkQ=", "oauth2ClientId": "987654321098765432109" }, { "name": "projects/my-project/serviceAccounts/sa-2@my-project.s3ns-system.iam.gserviceaccount.com", "projectId": "my-project", "uniqueId": "234567890123456789012", "email": "sa-2@my-project.s3ns-system.iam.gserviceaccount.com", "description": "My second service account", "displayName": "Service account 2", "etag": "UkQpTwBVUsL=", "oauth2ClientId": "876543210987654321098" } ] }
Mengedit akun layanan
Nama tampilan (nama yang dikenal) dan deskripsi akun layanan biasanya digunakan untuk mengambil informasi tambahan tentang akun layanan, seperti tujuan akun layanan atau narahubung untuk akun tersebut.
Konsol
Di konsol Trusted Cloud , buka halaman Service accounts.
Pilih project.
Klik alamat email akun layanan yang ingin diganti namanya.
Masukkan nama baru di kotak Nama, lalu klik Simpan.
gcloud
-
In the Trusted Cloud console, activate Cloud Shell.
At the bottom of the Trusted Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
-
Jalankan perintah
gcloud iam service-accounts update
untuk memperbarui akun layanan.Perintah:
gcloud iam service-accounts update
SA_NAME@PROJECT_ID.s3ns-system.iam.gserviceaccount.com
--description="UPDATED_SA_DESCRIPTION"
--display-name="UPDATED_DISPLAY_NAME"Output-nya adalah akun layanan yang diganti namanya:
description: UPDATED_SA_DESCRIPTION displayName: UPDATED_DISPLAY_NAME name: projects/PROJECT_ID/serviceAccounts/SA_NAME@PROJECT_ID.s3ns-system.iam.gserviceaccount.com
PROJECT_ID
: ID project Trusted Cloud Anda. Project ID adalah string alfanumerik, sepertimy-project
.SA_ID
: ID akun layanan Anda. Ini dapat berupa alamat email akun layanan dalam formatSA_NAME@PROJECT_ID.s3ns-system.iam.gserviceaccount.com
, atau ID numerik unik akun layanan.SA_NAME
: ID alfanumerik akun layanan Anda. Panjang nama ini harus antara 6 dan 30 karakter, serta dapat berisi karakter alfanumerik huruf kecil dan tanda pisah.- Ganti setidaknya salah satu dari berikut ini:
UPDATED_DISPLAY_NAME
: Nama tampilan baru untuk akun layanan Anda.UPDATED_DESCRIPTION
: Deskripsi baru untuk akun layanan Anda.
C++
Untuk mempelajari cara menginstal dan menggunakan library klien untuk IAM, lihat library klien IAM. Untuk informasi selengkapnya, lihat dokumentasi referensi API C++ IAM.
Untuk melakukan autentikasi ke IAM, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Sebelum memulai.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan
GOOGLE_CLOUD_UNIVERSE_DOMAIN
kes3nsapis.fr
.C#
Untuk mempelajari cara menginstal dan menggunakan library klien untuk IAM, lihat library klien IAM. Untuk informasi selengkapnya, lihat dokumentasi referensi API C# IAM.
Untuk melakukan autentikasi ke IAM, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Sebelum memulai.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan
GOOGLE_CLOUD_UNIVERSE_DOMAIN
kes3nsapis.fr
.Go
Untuk mempelajari cara menginstal dan menggunakan library klien untuk IAM, lihat library klien IAM. Untuk informasi selengkapnya, lihat dokumentasi referensi API Go IAM.
Untuk melakukan autentikasi ke IAM, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Sebelum memulai.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan
GOOGLE_CLOUD_UNIVERSE_DOMAIN
kes3nsapis.fr
.Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk IAM, lihat library klien IAM. Untuk informasi selengkapnya, lihat dokumentasi referensi API Java IAM.
Untuk melakukan autentikasi ke IAM, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Sebelum memulai.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan
GOOGLE_CLOUD_UNIVERSE_DOMAIN
kes3nsapis.fr
.Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk IAM, lihat library klien IAM. Untuk informasi selengkapnya, lihat dokumentasi referensi API Python IAM.
Untuk melakukan autentikasi ke IAM, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Sebelum memulai.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan
GOOGLE_CLOUD_UNIVERSE_DOMAIN
kes3nsapis.fr
.REST
Metode
serviceAccounts.patch
memperbarui akun layanan.Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
Metode HTTP dan URL:
PATCH https://iam.googleapis.com/v1/projects/PROJECT_ID/serviceAccounts/SA_ID
Meminta isi JSON:
{ "serviceAccount": { "email": "SA_NAME@PROJECT_ID.s3ns-system.iam.gserviceaccount.com", "displayName": "UPDATED_DISPLAY_NAME", "description": "UPDATED_DESCRIPTION" }, "updateMask": "displayName,description" }
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Anda akan melihat respons JSON seperti berikut:
{ "name": "projects/my-project/serviceAccounts/my-service-account@my-project.s3ns-system.iam.gserviceaccount.com", "displayName": "My updated service account", "description": "An updated description of my service account" }
Langkah berikutnya
- Pelajari cara menonaktifkan dan mengaktifkan akun layanan.
- Tinjau proses untuk memberikan peran IAM ke semua jenis akun utama, termasuk akun layanan.
- Pahami cara melampirkan akun layanan ke resource.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-20 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-08-20 UTC."],[[["This document outlines how to manage service accounts, specifically listing and editing them, using the IAM API, Google Cloud console, and the `gcloud` command-line tool."],["Before managing service accounts, users must enable the IAM API and set up authentication, which varies depending on whether they are using the console, `gcloud`, or a local development environment with various language-specific setups like C#, C++, Go, Java, or Python."],["Listing service accounts can be accomplished through the Google Cloud console's Service accounts page or via the `gcloud iam service-accounts list` command in Cloud Shell, displaying all user-managed service accounts within a selected project."],["Editing a service account, such as changing its display name or description, can be done through the Google Cloud console or with the `gcloud iam service-accounts update` command, using the specific email or ID of the account to be updated."],["The IAM roles of View Service Accounts (`roles/iam.serviceAccountViewer`) and Service Account Admin (`roles/iam.serviceAccountAdmin`) are required for viewing and editing service accounts, respectively, but other custom or predefined roles may also provide these permissions."]]],[]]