Mengelola izin antara Cloud Healthcare API dan produk Google Cloud lainnya

Cloud Healthcare API tidak memiliki akses otomatis ke resource Google Cloud lainnya di project Anda, seperti bucket Cloud Storage dan set data BigQuery. Saat mengakses resource ini, Cloud Healthcare API menggunakan akun layanan yang dikelola Google yang disebut Agen Layanan Cloud Healthcare.

Untuk menjalankan operasi seperti memberi tahu topik Perubahan Pub/Sub, mengimpor data dari bucket Cloud Storage, mengekspor data ke set data BigQuery, dan sebagainya, Anda harus terlebih dahulu memberikan izin Identity and Access Management (IAM) ke akun layanan untuk mengakses resource di luar Cloud Healthcare API. Halaman ini menjelaskan izin yang diperlukan untuk berbagai operasi, dan cara memberikannya.

Untuk mempelajari lebih lanjut cara menggunakan IAM guna mengonfigurasi izin dalam Cloud Healthcare API, lihat Kontrol akses.

Agen Layanan Cloud Healthcare

Akun layanan Agen Layanan Cloud Healthcare dibuat secara otomatis saat Anda mengaktifkan Cloud Healthcare API. Nama anggotanya adalah service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com. Untuk menemukan PROJECT_NUMBER project Google Cloud Anda, lihat Mengidentifikasi project.

Anda dapat melihat informasi mendetail tentang akun layanan Agen Layanan Cloud Healthcare, seperti peran yang telah diberikan, di halaman Identity and Access Management di Konsol Google Cloud.

Untuk mempelajari lebih lanjut Agen Layanan Cloud Healthcare dan interaksinya dengan peran dan izin Identity and Access Management (IAM), lihat Kontrol akses.

Izin Pub/Sub penyimpanan DICOM, FHIR, dan HL7v2

Perubahan dalam penyimpanan DICOM, FHIR, dan HL7v2 dapat dikirim ke topik Pub/Sub. Untuk mengetahui informasi selengkapnya, lihat Menggunakan Cloud Pub/Sub untuk Notifikasi.

Metode dalam penyimpanan ini memerlukan izin tambahan di akun layanan Agen Layanan Cloud Healthcare untuk memublikasikan perubahan pada topik Pub/Sub.

Gunakan Google Cloud Console atau gcloud CLI untuk menambahkan peran pubsub.publisher ke akun layanan project Anda:

Konsol

  1. Pastikan Anda telah mengaktifkan Cloud Healthcare API.
  2. Pada halaman IAM di Konsol Google Cloud, pastikan peran Healthcare Service Agent muncul di kolom Role untuk akun layanan Cloud Healthcare Service Agent. ID akun layanan adalah service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com.
  3. Di kolom Warisan yang cocok dengan peran, klik ikon pensil. Panel Edit izin akan terbuka.
  4. Klik Add another role, lalu cari peran Pub/Sub Publisher.
  5. Pilih peran, lalu klik Simpan. Peran pubsub.publisher ditambahkan ke akun layanan.

gcloud

Untuk menambahkan izin akun layanan, jalankan perintah gcloud projects add-iam-policy-binding. Untuk menemukan PROJECT_ID dan PROJECT_NUMBER, lihat Identifying projects.

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com \
    --role=roles/pubsub.publisher

Mengonfigurasi izin Pub/Sub antar-project

Untuk memublikasikan notifikasi Pub/Sub ke topik dalam project lain, berikan akun layanan Cloud Healthcare Service Agent peran pubsub.publisher pada topik tersebut. Untuk mengetahui informasi selengkapnya, lihat Mengontrol akses melalui Google Cloud Console dan Mengontrol akses melalui IAM API.

Untuk contoh publikasi notifikasi Pub/Sub antar-project, lihat Contoh kasus penggunaan: komunikasi lintas project.

Izin Cloud Storage DICOM menyimpan

Metode projects.locations.datasets.dicomStores.import dan projects.locations.datasets.dicomStores.export memerlukan izin tambahan di akun layanan Agen Layanan Cloud Healthcare untuk mengimpor data dari dan mengekspor data ke Cloud Storage.

Mengimpor data dari Cloud Storage

Anda dapat menggunakan Google Cloud Console atau gcloud CLI untuk menambahkan peran storage.objectViewer yang diperlukan ke akun layanan project Anda.

Konsol

  1. Pastikan Anda telah mengaktifkan Cloud Healthcare API.
  2. Pada halaman IAM di Konsol Google Cloud, pastikan peran Healthcare Service Agent muncul di kolom Role untuk akun layanan Cloud Healthcare Service Agent. ID akun layanan adalah service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com.
  3. Di kolom Warisan yang cocok dengan peran, klik ikon pensil. Panel Edit izin akan terbuka.
  4. Klik Add another role, lalu cari peran Storage Object Viewer.
  5. Pilih peran, lalu klik Simpan. Peran storage.objectViewer kemudian ditambahkan ke akun layanan.

gcloud

Untuk menambahkan izin akun layanan, jalankan perintah gcloud projects add-iam-policy-binding. Untuk menemukan PROJECT_ID dan PROJECT_NUMBER, lihat Identifying projects. 
gcloud projects add-iam-policy-binding PROJECT_ID \
    --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com \
    --role=roles/storage.objectViewer 

Mengekspor data ke Cloud Storage

Anda dapat menggunakan Google Cloud Console atau gcloud CLI untuk menambahkan peran storage.objectAdmin yang diperlukan ke akun layanan project Anda:

Konsol

  1. Pastikan Anda telah mengaktifkan Cloud Healthcare API.
  2. Pada halaman IAM di Konsol Google Cloud, pastikan peran Healthcare Service Agent muncul di kolom Role untuk akun layanan Cloud Healthcare Service Agent. ID akun layanan adalah service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com.
  3. Di kolom Warisan yang cocok dengan peran, klik ikon pensil. Panel Edit izin akan terbuka.
  4. Klik Add another role, lalu telusuri peran Storage Object Admin.
  5. Pilih peran, lalu klik Simpan. Peran storage.objectAdmin kemudian ditambahkan ke akun layanan.

gcloud

Untuk menambahkan izin akun layanan, jalankan perintah gcloud projects add-iam-policy-binding. Untuk menemukan PROJECT_ID dan PROJECT_NUMBER, lihat Identifying projects.

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com \
    --role=roles/storage.objectAdmin

Izin BigQuery penyimpanan DICOM

Metode projects.locations.datasets.dicomStores.export memerlukan izin tambahan di akun layanan Agen Layanan Cloud Healthcare untuk mengekspor metadata DICOM ke BigQuery. Anda juga harus memberi WRITER akses untuk set data BigQuery ke akun layanan Agen Layanan Cloud Healthcare.

Memberikan izin ke akun layanan Cloud Healthcare Service Agent

Anda dapat menggunakan Google Cloud Console atau gcloud CLI untuk menambahkan peran bigquery.dataEditor dan bigquery.jobUser yang diperlukan ke akun layanan project Anda.

Konsol

  1. Pastikan Anda telah mengaktifkan Cloud Healthcare API.
  2. Pada halaman IAM di Konsol Google Cloud, pastikan peran Healthcare Service Agent muncul di kolom Role untuk akun layanan Cloud Healthcare Service Agent. ID akun layanan adalah service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com.
  3. Di kolom Warisan yang cocok dengan peran, klik ikon pensil. Panel Edit izin akan terbuka.
  4. Klik Add another role, lalu cari peran BigQuery Data Editor dan BigQuery Job User.
  5. Pilih setiap peran, lalu klik Simpan. Peran bigquery.dataEditor dan bigquery.jobUser kemudian ditambahkan ke akun layanan.

gcloud

Untuk menambahkan izin akun layanan, jalankan perintah gcloud projects add-iam-policy-binding. Untuk menemukan PROJECT_ID dan PROJECT_NUMBER, lihat Identifying projects.

  1. Berikan peran roles/bigquery.dataEditor:

    Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

    • PROJECT_ID: ID project Google Cloud Anda
    • PROJECT_NUMBER: nomor project Google Cloud Anda

    Jalankan perintah berikut:

    Linux, macOS, atau Cloud Shell

    gcloud projects add-iam-policy-binding PROJECT_ID \
    --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com \
    --role=roles/bigquery.dataEditor

    Windows (PowerShell)

    gcloud projects add-iam-policy-binding PROJECT_ID `
    --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com `
    --role=roles/bigquery.dataEditor

    Windows (cmd.exe)

    gcloud projects add-iam-policy-binding PROJECT_ID ^
    --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com ^
    --role=roles/bigquery.dataEditor

    Anda akan melihat respons seperti berikut:

    Updated IAM policy for project [PROJECT_ID].
bindings:
...
- members:
  - serviceAccount:service-NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com
  role: roles/bigquery.dataEditor
...
etag: ETAG
version: VERSION

  2. Berikan peran roles/bigquery.jobUser:

    Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

    • PROJECT_ID: ID project Google Cloud Anda
    • PROJECT_NUMBER: nomor project Google Cloud Anda

    Jalankan perintah berikut:

    Linux, macOS, atau Cloud Shell

    gcloud projects add-iam-policy-binding PROJECT_ID \
    --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com \
    --role=roles/bigquery.jobUser

    Windows (PowerShell)

    gcloud projects add-iam-policy-binding PROJECT_ID `
    --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com `
    --role=roles/bigquery.jobUser

    Windows (cmd.exe)

    gcloud projects add-iam-policy-binding PROJECT_ID ^
    --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com ^
    --role=roles/bigquery.jobUser

    Anda akan melihat respons seperti berikut:

    Updated IAM policy for project [PROJECT_ID].
bindings:
...
- members:
  - serviceAccount:service-NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com
  role: roles/bigquery.jobUser
...
etag: ETAG
version: VERSION

Memberi WRITER akses ke set data BigQuery

Jika Anda telah menambahkan peran bigquery.dataEditor dan bigquery.jobUser ke akun layanan project, Anda akan memiliki akses WRITER untuk semua set data BigQuery. Namun, jika Anda belum menambahkan peran ini dan memerlukan akses WRITER ke satu set data BigQuery, Anda dapat memberikan akses WRITER hanya untuk set data tersebut. Untuk memberi WRITER akses ke set data BigQuery, selesaikan langkah-langkah berikut:
  1. Buka Mengontrol akses ke set data.
  2. Dengan menggunakan salah satu metode yang tersedia, beri Agen Layanan Cloud Healthcare alamat email WRITER akses ke set data BigQuery. (Cari alamat email yang diakhiri dengan @gcp-sa-healthcare.iam.gserviceaccount.com).

Misalnya, jika alamat email Agen Layanan Cloud Healthcare Anda adalah service-000000000000@gcp-sa-healthcare.iam.gserviceaccount.com, dan jika Anda menggunakan UI web BigQuery, Anda harus:

  1. Ikuti petunjuk Konsol.
  2. Di kolom Add principals, masukkan service-000000000000@gcp-sa-healthcare.iam.gserviceaccount.com, lalu pilih peran bigquery.dataEditor.

Mengekspor metadata DICOM di seluruh project Google Cloud

Untuk mengekspor metadata DICOM dari penyimpanan DICOM dalam satu project ke tabel BigQuery di project lain, Anda harus menambahkan akun layanan Cloud Healthcare Service Agent project sumber ke project tujuan dan memberi akun layanan peran bigquery.dataEditor dan bigquery.jobUser di project tujuan.

Untuk menemukan akun layanan Agen Layanan Cloud Healthcare project sumber, selesaikan langkah-langkah berikut:

  1. Pastikan Anda telah mengaktifkan Cloud Healthcare API.
  2. Pada halaman IAM di Konsol Google Cloud, pastikan peran Healthcare Service Agent muncul di kolom Role untuk akun layanan Cloud Healthcare Service Agent. ID akun layanan adalah service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com. Catat alamat ini di project sumber, karena akan digunakan pada langkah-langkah berikut.

Tambahkan akun layanan Cloud Healthcare Service Agent dari project sumber ke project tujuan dan berikan izin BigQuery yang diperlukan kepada akun layanan tersebut dengan menyelesaikan langkah-langkah berikut:

Konsol

  1. Buka halaman IAM project tujuan di Google Cloud Console.
  2. Klik Tambahkan.
  3. Di kolom Anggota baru, masukkan alamat akun layanan Agen Layanan Cloud Healthcare project sumber.
  4. Klik Add another role, lalu cari peran BigQuery Data Editor dan BigQuery Job User.
  5. Pilih peran, lalu klik Simpan. Akun layanan Cloud Healthcare Service Agent project sumber sekarang memiliki peran bigquery.dataEditor dan bigquery.jobUser di project tujuan.

gcloud

Untuk menambahkan akun layanan Agen Layanan Cloud Healthcare dari project sumber ke project tujuan dan memberikan izin BigQuery yang diperlukan kepada akun layanan, jalankan perintah gcloud projects add-iam-policy-binding. Untuk menemukan project ID dan nomor project untuk project sumber dan tujuan Anda, lihat Mengidentifikasi project.

gcloud projects add-iam-policy-binding DESTINATION_PROJECT_ID \
    --member=serviceAccount:service-SOURCE_PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com \
    --role=roles/bigquery.dataEditor

gcloud projects add-iam-policy-binding DESTINATION_PROJECT_ID \
    --member=serviceAccount:service-SOURCE_PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com \
    --role=roles/bigquery.jobUser

Selesaikan langkah-langkah di bagian Memberi WRITER akses ke set data BigQuery untuk mengizinkan project sumber menulis ke set data tujuan.

Izin Cloud Storage penyimpanan FHIR

Bagian berikut menjelaskan metode FHIR yang memerlukan izin tambahan di Agen Layanan Cloud Healthcare untuk membaca atau menulis ke Cloud Storage.

Mengimpor resource FHIR dari Cloud Storage

Metode projects.locations.datasets.fhirStores.import memerlukan izin berikut di akun layanan Agen Layanan Cloud Healthcare:

  • storage.objects.get
  • storage.objects.list

Izin ini disertakan dalam peran storage.objectViewer yang telah ditentukan.

Anda juga dapat menambahkan izin ke peran khusus, atau izin tersebut mungkin disertakan dalam peran dasar lainnya.

Anda dapat menggunakan Google Cloud Console atau gcloud CLI untuk menambahkan peran storage.objectViewer yang diperlukan ke akun layanan project Anda.

Konsol

  1. Pastikan Anda telah mengaktifkan Cloud Healthcare API.
  2. Pada halaman IAM di Konsol Google Cloud, pastikan peran Healthcare Service Agent muncul di kolom Role untuk akun layanan Cloud Healthcare Service Agent. ID akun layanan adalah service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com.
  3. Di kolom Warisan yang cocok dengan peran, klik ikon pensil. Panel Edit izin akan terbuka.
  4. Klik Add another role, lalu cari peran Storage Object Viewer.
  5. Pilih peran, lalu klik Simpan. Peran storage.objectViewer kemudian ditambahkan ke akun layanan.

gcloud

Untuk menambahkan izin akun layanan, jalankan perintah gcloud projects add-iam-policy-binding. Untuk menemukan PROJECT_ID dan PROJECT_NUMBER, lihat Identifying projects. 
gcloud projects add-iam-policy-binding PROJECT_ID \
    --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com \
    --role=roles/storage.objectViewer 

Mengekspor resource FHIR ke Cloud Storage

Untuk menggunakan metode projects.locations.datasets.fhirStores.export, diperlukan izin berikut di akun layanan Agen Layanan Cloud Healthcare:

  • storage.objects.create
  • storage.objects.delete
  • storage.objects.list

Izin ini disertakan dalam peran storage.objectAdmin yang telah ditentukan.

Anda juga dapat menambahkan izin ke peran khusus, atau izin tersebut mungkin disertakan dalam peran dasar lainnya.

Untuk memberikan peran storage.objectAdmin kepada akun layanan, ikuti langkah-langkah berikut:

Konsol

  1. Pastikan Anda mengaktifkan Cloud Healthcare API.
  2. Pada halaman IAM di Konsol Google Cloud, pastikan peran Healthcare Service Agent muncul di kolom Role untuk akun layanan Cloud Healthcare Service Agent. ID akun layanan adalah service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com.
  3. Di kolom Warisan yang cocok dengan peran, klik ikon pensil. Panel Edit izin akan terbuka.
  4. Klik Add another role, lalu telusuri peran Storage Object Creator.
  5. Pilih peran, lalu klik Simpan. Peran storage.objectAdmin kemudian ditambahkan ke akun layanan.

gcloud

Untuk menambahkan izin akun layanan, jalankan perintah gcloud projects add-iam-policy-binding. Untuk menemukan PROJECT_ID dan PROJECT_NUMBER, lihat Identifying projects.

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com \
    --role=roles/storage.objectAdmin

Membaca file filter dari Cloud Storage

Metode projects.locations.datasets.fhirStores.rollback memerlukan izin berikut di akun layanan Agen Layanan Cloud Healthcare untuk membaca file filter dari Cloud Storage:

  • storage.objects.get
  • storage.objects.list

Izin ini disertakan dalam peran storage.objectViewer yang telah ditentukan.

Anda juga dapat menambahkan izin ke peran khusus, atau izin tersebut mungkin disertakan dalam peran dasar lainnya.

Untuk memberikan peran storage.objectViewer ke akun layanan, ikuti langkah-langkah berikut:

Menulis file output ke Cloud Storage

Metode projects.locations.datasets.fhirStores.rollback memerlukan izin berikut di akun layanan Agen Layanan Cloud Healthcare untuk menulis file output ke Cloud Storage:

  • storage.objects.create
  • storage.objects.delete
  • storage.objects.get
  • storage.objects.list

Izin ini disertakan dalam peran storage.objectAdmin yang telah ditentukan.

Anda juga dapat menambahkan izin ke peran khusus, atau izin tersebut mungkin disertakan dalam peran dasar lainnya.

Untuk memberikan peran storage.objectAdmin ke akun layanan, ikuti langkah-langkah berikut:

Izin BigQuery penyimpanan FHIR

Metode projects.locations.datasets.fhirStores.export memerlukan izin tambahan di akun layanan Agen Layanan Cloud Healthcare untuk mengekspor resource FHIR ke BigQuery. Anda juga harus memberi WRITER akses untuk set data BigQuery ke akun layanan Agen Layanan Cloud Healthcare.

Memberikan izin ke akun layanan Cloud Healthcare Service Agent

Konsol

  1. Pastikan Anda telah mengaktifkan Cloud Healthcare API.
  2. Pada halaman IAM di Konsol Google Cloud, pastikan peran Healthcare Service Agent muncul di kolom Role untuk akun layanan Cloud Healthcare Service Agent. ID akun layanan adalah service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com.
  3. Di kolom Warisan yang cocok dengan peran, klik ikon pensil. Panel Edit izin akan terbuka.
  4. Klik Add another role, lalu cari peran BigQuery Data Editor dan BigQuery Job User.
  5. Pilih setiap peran, lalu klik Simpan. Peran bigquery.dataEditor dan bigquery.jobUser kemudian ditambahkan ke akun layanan.

gcloud

Untuk menambahkan izin akun layanan, jalankan perintah gcloud projects add-iam-policy-binding. Untuk menemukan PROJECT_ID dan PROJECT_NUMBER, lihat Identifying projects.

  1. Berikan peran roles/bigquery.dataEditor:

    Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

    • PROJECT_ID: ID project Google Cloud Anda
    • PROJECT_NUMBER: nomor project Google Cloud Anda

    Jalankan perintah berikut:

    Linux, macOS, atau Cloud Shell

    gcloud projects add-iam-policy-binding PROJECT_ID \
    --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com \
    --role=roles/bigquery.dataEditor

    Windows (PowerShell)

    gcloud projects add-iam-policy-binding PROJECT_ID `
    --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com `
    --role=roles/bigquery.dataEditor

    Windows (cmd.exe)

    gcloud projects add-iam-policy-binding PROJECT_ID ^
    --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com ^
    --role=roles/bigquery.dataEditor

    Anda akan melihat respons seperti berikut:

    Updated IAM policy for project [PROJECT_ID].
bindings:
...
- members:
  - serviceAccount:service-NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com
  role: roles/bigquery.dataEditor
...
etag: ETAG
version: VERSION

  2. Berikan peran roles/bigquery.jobUser:

    Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

    • PROJECT_ID: ID project Google Cloud Anda
    • PROJECT_NUMBER: nomor project Google Cloud Anda

    Jalankan perintah berikut:

    Linux, macOS, atau Cloud Shell

    gcloud projects add-iam-policy-binding PROJECT_ID \
    --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com \
    --role=roles/bigquery.jobUser

    Windows (PowerShell)

    gcloud projects add-iam-policy-binding PROJECT_ID `
    --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com `
    --role=roles/bigquery.jobUser

    Windows (cmd.exe)

    gcloud projects add-iam-policy-binding PROJECT_ID ^
    --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com ^
    --role=roles/bigquery.jobUser

    Anda akan melihat respons seperti berikut:

    Updated IAM policy for project [PROJECT_ID].
bindings:
...
- members:
  - serviceAccount:service-NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com
  role: roles/bigquery.jobUser
...
etag: ETAG
version: VERSION

Memberi WRITER akses ke set data BigQuery

Jika Anda telah menambahkan peran bigquery.dataEditor dan bigquery.jobUser ke akun layanan project, Anda akan memiliki akses WRITER untuk semua set data BigQuery. Namun, jika Anda belum menambahkan peran ini dan memerlukan akses WRITER ke satu set data BigQuery, Anda dapat memberikan akses WRITER hanya untuk set data tersebut. Untuk memberi WRITER akses ke set data BigQuery, selesaikan langkah-langkah berikut:
  1. Buka Mengontrol akses ke set data.
  2. Dengan menggunakan salah satu metode yang tersedia, beri Agen Layanan Cloud Healthcare alamat email WRITER akses ke set data BigQuery. (Cari alamat email yang diakhiri dengan @gcp-sa-healthcare.iam.gserviceaccount.com).

Misalnya, jika alamat email Agen Layanan Cloud Healthcare Anda adalah service-000000000000@gcp-sa-healthcare.iam.gserviceaccount.com, dan jika Anda menggunakan UI web BigQuery, Anda harus:

  1. Ikuti petunjuk Konsol.
  2. Di kolom Add principals, masukkan service-000000000000@gcp-sa-healthcare.iam.gserviceaccount.com, lalu pilih peran bigquery.dataEditor.

Izin Cloud Storage penyimpanan HL7v2

Metode projects.locations.datasets.hl7V2Stores.import dan projects.locations.datasets.hl7V2Stores.export memerlukan izin tambahan di akun layanan Agen Layanan Cloud Healthcare untuk mengimpor pesan HL7v2 dari dan mengekspor pesan HL7v2 ke Cloud Storage.

Tentukan izin yang diperlukan akun layanan berdasarkan tindakan yang dijalankan aplikasi:

  • Jika aplikasi mengimpor pesan HL7v2 dari Cloud Storage ke penyimpanan HL7v2, akun layanan memerlukan izin storage.objects.get dan storage.objects.list, yang disertakan dalam peran storage.objectViewer.
  • Jika aplikasi mengekspor pesan HL7v2 dari penyimpanan HL7v2 ke Cloud Storage, akun layanan memerlukan izin storage.objects.create, storage.objects.delete, dan storage.objects.list, yang disertakan dalam peran storage.objectCreator.

Mengimpor pesan HL7v2 dari Cloud Storage

Anda dapat menggunakan Google Cloud Console atau gcloud CLI untuk menambahkan peran storage.objectViewer yang diperlukan ke akun layanan project Anda.

Konsol

  1. Pastikan Anda telah mengaktifkan Cloud Healthcare API.
  2. Pada halaman IAM di Konsol Google Cloud, pastikan peran Healthcare Service Agent muncul di kolom Role untuk akun layanan Cloud Healthcare Service Agent. ID akun layanan adalah service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com.
  3. Di kolom Warisan yang cocok dengan peran, klik ikon pensil. Panel Edit izin akan terbuka.
  4. Klik Add another role, lalu cari peran Storage Object Viewer.
  5. Pilih peran, lalu klik Simpan. Peran storage.objectViewer kemudian ditambahkan ke akun layanan.

gcloud

Untuk menambahkan izin akun layanan, jalankan perintah gcloud projects add-iam-policy-binding. Untuk menemukan PROJECT_ID dan PROJECT_NUMBER, lihat Identifying projects. 
gcloud projects add-iam-policy-binding PROJECT_ID \
    --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com \
    --role=roles/storage.objectViewer 

Mengekspor pesan HL7v2 ke Cloud Storage

Anda dapat menggunakan Google Cloud Console atau gcloud CLI untuk menambahkan peran storage.objectCreator yang diperlukan ke akun layanan project Anda:

Konsol

  1. Pastikan Anda telah mengaktifkan Cloud Healthcare API.
  2. Pada halaman IAM di Konsol Google Cloud, pastikan peran Healthcare Service Agent muncul di kolom Role untuk akun layanan Cloud Healthcare Service Agent. ID akun layanan adalah service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com.
  3. Di kolom Warisan yang cocok dengan peran, klik ikon pensil. Panel Edit izin akan terbuka.
  4. Klik Add another role, lalu telusuri peran Storage Object Creator.
  5. Pilih peran, lalu klik Simpan. Peran storage.objectCreator kemudian ditambahkan ke akun layanan.

gcloud

Untuk menambahkan izin akun layanan, jalankan perintah gcloud projects add-iam-policy-binding. Untuk menemukan PROJECT_ID dan PROJECT_NUMBER, lihat Identifying projects.

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com \
    --role=roles/storage.objectCreator