總覽
Cloud Healthcare API 使用身分與存取權管理 (IAM) 控管存取權。
在 Cloud Healthcare API 中,您可在專案、資料集或資料儲存庫層級設定存取權控管。舉例來說,您可以授權一組開發人員,讓他們存取某個專案中的所有資料集。如要瞭解如何設定 IAM 並搭配 Cloud Healthcare API 使用,請參閱「控管存取權」和「控管其他產品的存取權」。
如需 IAM 和其功能的詳細說明,請參閱 IAM 說明文件。特別是管理 IAM 政策一節。
每個 Cloud Healthcare API 方法都會要求呼叫者具備必要權限,詳情請參閱「權限」和「角色」。
權限
下表列出與 Cloud Healthcare API 相關的 IAM 權限。表格中的方法名稱已縮短,每個方法的完整名稱開頭都是 projects.locations.。
同意聲明儲存庫方法
| 同意聲明儲存庫方法 | 所需權限 | 
|---|---|
datasets.consentStores.checkDataAccess | 
healthcare.consentStores.checkDataAccess。 | 
datasets.consentStores.create | 
父項資料集上的 healthcare.consentStores.create。 | 
datasets.consentStores.delete | 
healthcare.consentStores.delete。 | 
datasets.consentStores.evaluateUserConsents | 
healthcare.consentStores.evaluateUserConsents。 | 
datasets.consentStores.get | 
healthcare.consentStores.get。 | 
datasets.consentStores.getIamPolicy | 
healthcare.consentStores.getIamPolicy。 | 
datasets.consentStores.list | 
父項資料集上的 healthcare.consentStores.list。 | 
datasets.consentStores.patch | 
healthcare.consentStores.update。 | 
datasets.consentStores.queryAccessibleData | 
healthcare.consentStores.queryAccessibleData。 | 
datasets.consentStores.setIamPolicy | 
healthcare.consentStores.setIamPolicy。 | 
datasets.consentStores.attributeDefinitions.create | 
healthcare.attributeDefinitions.create 家長同意聲明商店。 | 
datasets.consentStores.attributeDefinitions.delete | 
healthcare.attributeDefinitions.delete 要求的屬性定義資源。 | 
datasets.consentStores.attributeDefinitions.get | 
healthcare.attributeDefinitions.get 要求的屬性定義資源。 | 
datasets.consentStores.attributeDefinitions.list | 
healthcare.attributeDefinitions.list 家長同意聲明商店。 | 
datasets.consentStores.attributeDefinitions.patch | 
healthcare.attributeDefinitions.update 要求的屬性定義資源。 | 
datasets.consentStores.consentArtifacts.create | 
healthcare.consentArtifacts.create 家長同意聲明商店。 | 
datasets.consentStores.consentArtifacts.delete | 
healthcare.consentArtifacts.delete 要求的同意聲明構件資源。 | 
datasets.consentStores.consentArtifacts.get | 
healthcare.consentArtifacts.get 要求的同意聲明構件資源。 | 
datasets.consentStores.consentArtifacts.list | 
healthcare.consentArtifacts.list 家長同意聲明商店。 | 
datasets.consentStores.consents.create | 
healthcare.consents.create 家長同意聲明商店。 | 
datasets.consentStores.consents.delete | 
healthcare.consents.delete 要求的同意聲明資源。 | 
datasets.consentStores.consents.get | 
healthcare.consents.get 要求的同意聲明資源。 | 
datasets.consentStores.consents.list | 
healthcare.consents.list 家長同意聲明商店。 | 
datasets.consentStores.consents.patch | 
healthcare.consents.update 要求的同意聲明資源。 | 
datasets.consentStores.consents.revoke | 
healthcare.consents.revoke 要求的同意聲明資源。 | 
datasets.consentStores.userDataMappings.archive | 
healthcare.userDataMappings.archive 要求的使用者資料對應資源。 | 
datasets.consentStores.userDataMappings.create | 
healthcare.userDataMappings.create 家長同意聲明商店。 | 
datasets.consentStores.userDataMappings.delete | 
healthcare.userDataMappings.delete 要求的使用者資料對應資源。 | 
datasets.consentStores.userDataMappings.get | 
healthcare.userDataMappings.get 要求的使用者資料對應資源。 | 
datasets.consentStores.userDataMappings.list | 
healthcare.userDataMappings.list 家長同意聲明商店。 | 
datasets.consentStores.userDataMappings.patch | 
healthcare.userDataMappings.update 要求的使用者資料對應資源。 | 
資料集方法
| 資料集方法 | 所需權限 | 
|---|---|
datasets.create | 
上層專案的 healthcare.datasets.create 權限。 Google Cloud  | 
datasets.deidentify | 
  | 
datasets.delete | 
healthcare.datasets.delete 要求的資料集。 | 
datasets.get | 
healthcare.datasets.get 要求的資料集。 | 
datasets.getIamPolicy | 
healthcare.datasets.getIamPolicy 要求的資料集。 | 
datasets.list | 
上層專案的 healthcare.datasets.list 權限。 Google Cloud  | 
datasets.patch | 
healthcare.datasets.update 要求的資料集。 | 
datasets.setIAMPolicy | 
healthcare.datasets.setIamPolicy 要求的資料集。 | 
DICOM 儲存庫方法
| DICOM 儲存庫方法 | 所需權限 | 
|---|---|
datasets.dicomStores.create | 
父項資料集上的 healthcare.dicomStores.create。 | 
datasets.dicomStores.deidentify | 
  | 
datasets.dicomStores.delete | 
要求的 DICOM 儲存庫。healthcare.dicomStores.delete | 
datasets.dicomStores.export | 
  | 
datasets.dicomStores.get | 
要求的 DICOM 儲存庫。healthcare.dicomStores.get | 
datasets.dicomStores.getIamPolicy | 
要求的 DICOM 儲存庫。healthcare.dicomStores.getIamPolicy | 
datasets.dicomStores.import | 
  | 
datasets.dicomStores.list | 
父項資料集上的 healthcare.dicomStores.list。 | 
datasets.dicomStores.patch | 
要求的 DICOM 儲存庫。healthcare.dicomStores.update | 
datasets.dicomStores.searchForInstances | 
要求的 DICOM 儲存庫。healthcare.dicomStores.dicomWebRead | 
datasets.dicomStores.searchForSeries | 
要求的 DICOM 儲存庫。healthcare.dicomStores.dicomWebRead | 
datasets.dicomStores.searchForStudies | 
要求的 DICOM 儲存庫。healthcare.dicomStores.dicomWebRead | 
datasets.dicomStores.setIamPolicy | 
要求的 DICOM 儲存庫。healthcare.dicomStores.setIamPolicy | 
datasets.dicomStores.storeInstances | 
要求的 DICOM 儲存庫。healthcare.dicomStores.dicomWebWrite | 
datasets.dicomStores.studies.delete | 
要求的 DICOM 儲存庫。healthcare.dicomStores.dicomWebDelete | 
datasets.dicomStores.studies.retrieveMetadata | 
要求的 DICOM 儲存庫。healthcare.dicomStores.dicomWebRead | 
datasets.dicomStores.studies.retrieveStudy | 
要求的 DICOM 儲存庫。healthcare.dicomStores.dicomWebRead | 
datasets.dicomStores.studies.searchForInstances | 
要求的 DICOM 儲存庫。healthcare.dicomStores.dicomWebRead | 
datasets.dicomStores.studies.searchForSeries | 
要求的 DICOM 儲存庫。healthcare.dicomStores.dicomWebRead | 
datasets.dicomStores.studies.storeInstances | 
要求的 DICOM 儲存庫。healthcare.dicomStores.dicomWebWrite | 
datasets.dicomStores.studies.updateInstances | 
要求的 DICOM 儲存庫。healthcare.dicomStores.dicomWebUpdate | 
datasets.dicomStores.studies.updateMetadata | 
要求的 DICOM 儲存庫。healthcare.dicomStores.dicomWebUpdate | 
datasets.dicomStores.studies.series.delete | 
要求的 DICOM 儲存庫。healthcare.dicomStores.dicomWebDelete | 
datasets.dicomStores.studies.series.retrieveMetadata | 
要求的 DICOM 儲存庫。healthcare.dicomStores.dicomWebRead | 
datasets.dicomStores.studies.series.retrieveSeries | 
要求的 DICOM 儲存庫。healthcare.dicomStores.dicomWebRead | 
datasets.dicomStores.studies.series.searchForInstances | 
要求的 DICOM 儲存庫。healthcare.dicomStores.dicomWebRead | 
datasets.dicomStores.studies.series.updateMetadata | 
要求的 DICOM 儲存庫。healthcare.dicomStores.dicomWebUpdate | 
datasets.dicomStores.studies.series.instances.delete | 
要求的 DICOM 儲存庫。healthcare.dicomStores.dicomWebDelete | 
datasets.dicomStores.studies.series.instances.retrieveInstance | 
要求的 DICOM 儲存庫。healthcare.dicomStores.dicomWebRead | 
datasets.dicomStores.studies.series.instances.retrieveMetadata | 
要求的 DICOM 儲存庫。healthcare.dicomStores.dicomWebRead | 
datasets.dicomStores.studies.series.instances.retrieveRendered | 
要求的 DICOM 儲存庫。healthcare.dicomStores.dicomWebRead | 
datasets.dicomStores.studies.series.instances.updateMetadata | 
要求的 DICOM 儲存庫。healthcare.dicomStores.dicomWebUpdate | 
datasets.dicomStores.studies.series.instances.frames.retrieveFrames | 
要求的 DICOM 儲存庫。healthcare.dicomStores.dicomWebRead | 
datasets.dicomStores.studies.series.instances.frames.retrieveRendered | 
要求的 DICOM 儲存庫。healthcare.dicomStores.dicomWebRead | 
datasets.dicomStores.studies.series.instances.bulkdata.retrieveBulkdata | 
要求的 DICOM 儲存庫。healthcare.dicomStores.dicomWebRead | 
FHIR 儲存庫方法
| FHIR 儲存庫方法 | 所需權限 | 
|---|---|
datasets.fhirStores.applyConsents | 
所要求的 FHIR 存放區資源。healthcare.fhirStores.applyConsents | 
datasets.fhirStores.applyAdminConsents | 
所要求的 FHIR 存放區資源。healthcare.fhirStores.applyConsents | 
datasets.fhirStores.configureSearch | 
healthcare.fhirStores.configureSearch。 | 
datasets.fhirStores.create | 
父項資料集上的 healthcare.fhirStores.create。 | 
datasets.fhirStores.deidentify | 
  | 
datasets.fhirStores.delete | 
healthcare.fhirStores.delete。 | 
datasets.fhirStores.explainDataAccess | 
所要求的 FHIR 存放區資源。healthcare.fhirStores.explainDataAccess | 
datasets.fhirStores.export | 
  | 
datasets.fhirStores.get | 
healthcare.fhirStores.get。 | 
datasets.fhirStores.getFHIRStoreMetrics | 
healthcare.fhirStores.get。 | 
datasets.fhirStores.getIamPolicy | 
healthcare.fhirStores.getIamPolicy。 | 
datasets.fhirStores.import | 
  | 
datasets.fhirStores.list | 
父項資料集上的 healthcare.fhirStores.list。 | 
datasets.fhirStores.patch | 
healthcare.fhirStores.update。 | 
datasets.fhirStores.rollback | 
healthcare.fhirStores.rollback。 | 
datasets.fhirStores.setIamPolicy | 
healthcare.fhirStores.setIamPolicy。 | 
datasets.fhirStores.fhir.Encounter-everything | 
對每個傳回的資源呼叫 healthcare.fhirResources.get。 | 
datasets.fhirStores.fhir.Observation-lastn | 
上層 FHIR 儲存庫的 healthcare.fhirStores.searchResources。 | 
datasets.fhirStores.fhir.Patient-everything | 
對每個傳回的資源呼叫 healthcare.fhirResources.get。 | 
datasets.fhirStores.fhir.Resource-purge | 
所要求的 FHIR 存放區資源。healthcare.fhirResources.purge | 
datasets.fhirStores.fhir.capabilities | 
healthcare.fhirStores.get。 | 
datasets.fhirStores.fhir.conditionalDelete | 
  | 
datasets.fhirStores.fhir.conditionalPatch | 
  | 
datasets.fhirStores.fhir.conditionalUpdate | 
  | 
datasets.fhirStores.fhir.create | 
  | 
datasets.fhirStores.fhir.delete | 
所要求的 FHIR 存放區資源。healthcare.fhirResources.delete | 
datasets.fhirStores.fhir.executeBundle | 
要求的 FHIR 存放區,以及與套件中個別作業對應的其他權限 (例如 healthcare.fhirResources.create 和 healthcare.fhirResources.update)。healthcare.fhirResources.executeBundle如果 API 呼叫者具有 healthcare.fhirResources.create 權限,但沒有 healthcare.fhirResources.update 權限,則呼叫者只能執行包含 healthcare.fhirResources.create 作業的套件。 | 
datasets.fhirStores.fhir.history | 
healthcare.fhirResources.get,以及每個版本。 | 
datasets.fhirStores.fhir.patch | 
所要求的 FHIR 存放區資源。healthcare.fhirResources.patch | 
datasets.fhirStores.fhir.read | 
所要求的 FHIR 存放區資源。healthcare.fhirResources.get | 
datasets.fhirStores.fhir.search | 
上層 FHIR 儲存庫的 healthcare.fhirStores.searchResources。 | 
datasets.fhirStores.fhir.update | 
所要求的 FHIR 存放區資源。healthcare.fhirResources.update | 
datasets.fhirStores.fhir.vread | 
healthcare.fhirResources.get。 | 
datasets.fhirStores.fhir.Patient-consent-enforcement-status | 
healthcare.fhirResources.get 要求的 FHIR 儲存庫病患資源。 | 
datasets.fhirStores.fhir.Consent-enforcement-status | 
在要求的 FHIR 存放區同意聲明資源上。healthcare.fhirResources.get | 
HL7v2 儲存庫方法
| HL7v2 儲存庫方法 | 所需權限 | 
|---|---|
datasets.hl7V2Stores.create | 
父項資料集上的 healthcare.hl7V2Stores.create。 | 
datasets.hl7V2Stores.delete | 
要求的 HL7v2 儲存庫上。healthcare.hl7V2Stores.delete | 
datasets.hl7V2Stores.export | 
要求的 HL7v2 儲存庫上。healthcare.hl7V2Stores.export | 
datasets.hl7V2Stores.get | 
要求的 HL7v2 儲存庫上。healthcare.hl7V2Stores.get | 
datasets.hl7V2Stores.import | 
要求的 HL7v2 儲存庫上。healthcare.hl7V2Stores.import | 
datasets.hl7V2Stores.list | 
父項資料集上的 healthcare.hl7V2Stores.list。 | 
datasets.hl7V2Stores.patch | 
要求的 HL7v2 儲存庫上。healthcare.hl7V2Stores.update | 
datasets.hl7V2Stores.getIamPolicy | 
要求的 HL7v2 儲存庫上。healthcare.hl7V2Stores.getIamPolicy | 
datasets.hl7V2Stores.setIamPolicy | 
要求的 HL7v2 儲存庫上。healthcare.hl7V2Stores.setIamPolicy | 
datasets.hl7V2Stores.messages.create | 
父項 HL7v2 儲存庫的 healthcare.hl7V2Messages.create。 | 
datasets.hl7V2Stores.messages.delete | 
要求的 HL7v2 儲存庫訊息。healthcare.hl7V2Messages.delete | 
datasets.hl7V2Stores.messages.get | 
要求的 HL7v2 儲存庫訊息。healthcare.hl7V2Messages.get | 
datasets.hl7V2Stores.messages.ingest | 
要求的 HL7v2 儲存庫訊息。healthcare.hl7V2Messages.ingest | 
datasets.hl7V2Stores.messages.list | 
父項 HL7v2 儲存庫的 healthcare.hl7V2Messages.list。 | 
datasets.hl7V2Stores.messages.patch | 
要求的 HL7v2 儲存庫訊息。healthcare.hl7V2Messages.update | 
位置方法
| 位置方法 | 所需權限 | 
|---|---|
locations.get | 
healthcare.locations.get 位於要求的位置。 | 
locations.list | 
上層專案的 healthcare.locations.list 權限。 Google Cloud  | 
Healthcare Natural Language API 方法
| Healthcare Natural Language API 方法 | 所需權限 | 
|---|---|
nlp.analyzeEntities | 
healthcare.nlpservice.analyzeEntities | 
操作方法
| 操作方法 | 必要權限 | 
|---|---|
datasets.operations.get | 
healthcare.operations.get 要求的資料集。 | 
datasets.operations.list | 
healthcare.operations.list 要求的資料集。 | 
datasets.operations.cancel | 
healthcare.operations.cancel 要求的資料集。 | 
去識別化方法
| 去識別化方法 | 必要權限 | 
|---|---|
services.deidentify.deidentifyDicomInstance | 
healthcare.deidentify.run | 
services.deidentify.deidentifyFhirResource | 
healthcare.deidentify.run | 
角色
下表列出 Cloud Healthcare API IAM 角色,以及與各角色相關聯的權限。roles/owner、roles/editor 和 roles/viewer 角色也具備其他 Google Cloud 服務的權限。如要進一步瞭解角色,請參閱「瞭解角色」。
同意聲明儲存庫角色
| 同意聲明儲存庫角色 | 權限 | 
|---|---|
Healthcare Consent Store Viewer( 可列出資料集中的同意聲明存放區。  | 
   
 
 
 
 
 
 
 
       
 
 
 
  | 
Healthcare 同意聲明庫管理員( 可管理同意聲明存放區。  | 
   
       
 
 
 
       
 
 
 
  | 
同意聲明角色
| 同意聲明角色 | 權限 | 
|---|---|
Healthcare 屬性定義讀取者( 可讀取同意聲明存放區中的 AttributeDefinition 物件。  | 
   
 
 
 
 
 
 
 
 
 
       
 
 
 
  | 
Healthcare 屬性定義編輯者( 可編輯 AttributeDefinition 物件。  | 
   
       
 
 
 
 
 
 
 
 
       
 
 
 
  | 
Healthcare 同意聲明構件讀取者( 可讀取同意聲明存放區中的 ConsentArtifact 物件。  | 
   
 
 
 
 
 
 
 
 
 
       
 
 
 
  | 
Healthcare 同意聲明構件編輯者( 編輯 ConsentArtifact 物件。  | 
   
 
 
 
 
 
 
 
 
 
 
       
 
 
 
  | 
Healthcare Consent Artifact Administrator( 管理 ConsentArtifact 物件。  | 
   
       
 
 
 
 
 
 
 
 
       
 
 
 
  | 
Healthcare Consent Reader( 可讀取同意聲明存放區中的同意聲明物件。  | 
   
 
 
 
 
 
 
 
 
 
       
 
 
 
  | 
Healthcare 同意聲明編輯者( 編輯 Consent 物件。  | 
   
 
 
 
 
 
       
 
 
 
       
 
 
 
  | 
Healthcare 使用者資料對應關係讀取者( 可讀取同意聲明存放區中的 UserDataMapping 物件。  | 
   
 
 
 
 
 
 
 
       
 
 
 
 
 
  | 
Healthcare 使用者資料對應關係編輯者( 可編輯 UserDataMapping 物件。  | 
   
 
 
 
 
 
 
 
       
 
 
       
 
 
  | 
資料集角色
| 資料集角色 | 權限 | 
|---|---|
Healthcare 資料集檢視者( 可在專案中列出 Healthcare 資料集。  | 
   
 
 
       
 
 
 
  | 
Healthcare 資料集管理員( 可管理 Healthcare 資料集。  | 
   
       
 
       
 
       
 
 
  | 
DICOM 儲存庫角色
| DICOM 儲存庫角色 | 權限 | 
|---|---|
Healthcare DICOM Store 檢視者( 可列出資料集中的 DICOM Store。  | 
   
 
 
 
 
       
 
 
 
  | 
Healthcare DICOM 存放區管理員( 可以管理 DICOM Store。  | 
   
 
 
 
 
 
 
 
 
 
 
 
       
 
 
 
 
  | 
Healthcare DICOM 檢視者( 可以從 DICOM Store 擷取 DICOM 映像檔。  | 
   
 
 
 
 
 
 
       
 
 
 
  | 
Healthcare DICOM 編輯者( 可個別以及大量編輯 DICOM 映像檔。  | 
   
 
 
 
 
 
 
 
 
 
 
       
 
 
 
 
  | 
FHIR 儲存庫角色
| FHIR 存放區角色 | 權限 | 
|---|---|
Healthcare FHIR Store 檢視者( 可列出資料集中的 FHIR Store。  | 
   
 
 
 
 
       
 
 
 
  | 
Healthcare FHIR 存放區管理員( 可管理 FHIR 資源存放區。  | 
   
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
       
 
 
 
 
  | 
Healthcare FHIR 資源讀取者( 讀取及搜尋 FHIR 資源。  | 
   
 
 
 
 
 
 
 
 
       
 
 
 
  | 
Healthcare FHIR 資源編輯者( 建立、刪除、更新、讀取及搜尋 FHIR 資源。  | 
   
 
 
 
 
 
 
 
 
 
 
 
 
       
 
 
 
 
  | 
HL7v2 儲存庫角色
| HL7v2 儲存庫角色 | 權限 | 
|---|---|
Healthcare HL7v2 Store 檢視者( 可檢視資料集中的 HL7v2 Store。  | 
   
 
 
 
 
       
 
 
 
  | 
Healthcare HL7v2 Store 管理員( 可管理 HL7v2 Store。  | 
   
 
 
       
 
       
 
 
 
 
  | 
Healthcare HL7v2 訊息擷取者( 可擷取來源網路發送的 HL7v2 訊息。  | 
   
 
 
 
 
 
       
 
 
 
  | 
Healthcare HL7v2 訊息使用者( 可列出和讀取 HL7v2 訊息、更新訊息標籤及發布新訊息。  | 
   
 
 
 
 
 
 
 
 
       
 
 
 
  | 
Healthcare HL7v2 訊息編輯者( 具備 HL7v2 訊息的讀取、寫入及刪除存取權。  | 
   
 
 
       
 
 
 
       
 
 
 
 
  | 
Healthcare Natural Language API 角色
| Healthcare Natural Language API 角色 | 權限 | 
|---|---|
醫療照護自然語言處理服務檢視者 Beta 版( 從指定的文字中擷取及分析醫學實體。  | 
   
       
 
 
 
  | 
Cloud Healthcare 服務代理人
Cloud Healthcare Service Agent 是專案中共用的服務帳戶,Cloud Healthcare API 會使用這個帳戶與Google Cloud中的其他資源互動。
舉例來說,這個服務代理程式可用於讀取及寫入 Cloud Storage 值區、寫入 BigQuery,以及從 Cloud Healthcare API 將訊息發布至 Pub/Sub。
如要執行上述任何動作,您必須授予Cloud Healthcare 服務代理相關 Cloud Storage bucket、BigQuery 資料集或 Pub/Sub 主題的存取權。
為專案建立權限模型時,請注意,授予下列任一角色,使用者就能以 Cloud Healthcare 服務代理的身分叫用作業,並存取該代理可存取的任何資料:
roles/healthcare.consentStoreAdminroles/healthcare.consentStoreViewerroles/healthcare.dicomStoreEditorroles/healthcare.dicomStoreViewerroles/healthcare.fhirStoreAdminroles/healthcare.hl7V2StoreAdmin
同樣地,將下列權限指派給自訂角色,也會允許使用者叫用以「Cloud Healthcare 服務代理」身分執行的作業:
healthcare.consentStores.queryAccessibleDatahealthcare.dicomStores.createhealthcare.dicomStores.updatehealthcare.dicomStores.importhealthcare.dicomStores.exporthealthcare.fhirStores.createhealthcare.fhirStores.updatehealthcare.fhirStores.importhealthcare.fhirStores.exporthealthcare.hl7V2Stores.createhealthcare.hl7V2Stores.update
例如:
- 如果使用者具備任何匯入權限,且作業會存取 Cloud Healthcare Service Agent 具有讀取權限的任何 Cloud Storage 值區,則使用者可以執行作業,充當 Cloud Healthcare Service Agent。
 - 如果使用者具備任何匯出權限,且作業會存取服務代理程式具有寫入權限的任何值區,則使用者可以執行作業,充當 Cloud Healthcare Service Agent。
 - 如果使用者具備建立或更新資料儲存庫的權限,就能設定 Pub/Sub 通知目標或 BigQuery 串流目的地,在資料儲存庫變更時,由 Cloud Healthcare Service Agent 傳送通知。
 
最佳做法是利用多個專案,進一步隔離授予 Cloud Healthcare 服務代理程式的權限。