為 Cloud Healthcare API 資料集啟用客戶管理加密金鑰 (CMEK)

控制台

1. 前往 Google Cloud 控制台的「Browser」頁面。

   前往瀏覽器

2. 按一下 add_box「建立資料集」。系統隨即會顯示「建立資料集」頁面。

3. 在「名稱」欄位中，輸入資料集的 ID，並遵守資料集允許的字元和大小限制。

4. 選取下列其中一種地點類型：

   • 區域。資料集會永久存放在一個 Google Cloud 區域中。 選取這個選項後，請在「區域」欄位中輸入或選取位置。

   • 多區域。資料集會永久存放在跨越多個 Google Cloud 區域的位置。選取這個選項後，請在「多區域」欄位中輸入或選取多區域位置。

5. 在「Encryption」(加密) 區段中，選取下列其中一種加密類型：

   • Google-managed encryption key：預設加密方法。 如果您希望 Google 管理加密金鑰，保護這個 Cloud Healthcare API 資料集中的資料，請使用這個方法。

   • Cloud KMS 金鑰：使用客戶自行管理的加密金鑰 (CMEK)。

6. 按一下「建立」，系統隨即會顯示「瀏覽器」頁面。新的資料集會顯示在資料集清單中。

gcloud

使用 gcloud healthcare datasets create 指令建立資料集。

使用下方的任何指令資料之前，請先替換以下項目：

• DATASET_ID：受資料集允許的字元和大小限制約束的 ID
• LOCATION：資料集的支援位置
• KEY_RESOURCE_ID：Cloud KMS 金鑰的資源 ID，格式為 projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY_NAME

執行下列指令：

gcloud healthcare datasets create DATASET_ID \
  --location=LOCATION \
  --encryption-key=KEY_RESOURCE_ID

gcloud healthcare datasets create DATASET_ID `
  --location=LOCATION `
  --encryption-key=KEY_RESOURCE_ID

gcloud healthcare datasets create DATASET_ID ^
  --location=LOCATION ^
  --encryption-key=KEY_RESOURCE_ID

您應該會收到類似以下的回應：

Create request issued for: [DATASET_ID]
Waiting for operation [projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID] to complete...
Created dataset [DATASET_ID].

REST

1. 使用 datasets.create 方法建立資料集。

   使用任何要求資料之前，請先替換以下項目：

   • PROJECT_ID：您的 Google Cloud 專案 ID
   • DATASET_ID：受資料集允許的字元和大小限制約束的 ID
   • LOCATION：資料集的支援位置
   • KEY_RESOURCE_ID：Cloud KMS 金鑰的資源 ID，格式為 projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY_NAME

   JSON 要求主體：

   {
     "encryptionSpec": {
       "kmsKeyName": "KEY_RESOURCE_ID"
     }
   }
   

   如要傳送要求，請選擇以下其中一個選項：

   curl

   將要求主體儲存在名為 request.json 的檔案中。 在終端機中執行下列指令，在目前目錄中建立或覆寫這個檔案：

   cat > request.json << 'EOF'
   {
     "encryptionSpec": {
       "kmsKeyName": "KEY_RESOURCE_ID"
     }
   }
   EOF

   接著，請執行下列指令來傳送 REST 要求：

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets?datasetId=DATASET_ID"

   PowerShell

   將要求主體儲存在名為 request.json 的檔案中。 在終端機中執行下列指令，在目前目錄中建立或覆寫這個檔案：

   @'
   {
     "encryptionSpec": {
       "kmsKeyName": "KEY_RESOURCE_ID"
     }
   }
   '@  | Out-File -FilePath request.json -Encoding utf8

   接著，請執行下列指令來傳送 REST 要求：

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets?datasetId=DATASET_ID" | Select-Object -Expand Content

   APIs Explorer

   複製要求內文並開啟方法參考資料頁面。系統會在頁面右側開啟 APIs Explorer 面板。您可以使用這項工具來傳送要求。將要求內文貼到這項工具中，並填妥其他必填欄位，然後按一下「Execute」(執行)。

   輸出內容如下所示。回應會包含長時間執行作業 (LRO) 的 ID。如果方法呼叫可能需要額外時間才能完成，系統會傳回長時間執行的作業。請記下 OPERATION_ID 的值。您會在下一個步驟中用到這個值。

   回應

   
   {
     "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"
   }
   
   

2. 使用 projects.locations.datasets.operations.get 方法取得長時間執行的作業狀態。

   使用任何要求資料之前，請先替換以下項目：

   • PROJECT_ID：您的 Google Cloud 專案 ID
   • LOCATION：資料集位置
   • DATASET_ID：資料集 ID
   • OPERATION_ID：長時間執行的作業傳回的 ID

   如要傳送要求，請選擇以下其中一個選項：

   curl

   執行下列指令：

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"

   PowerShell

   執行下列指令：

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand Content

   APIs Explorer

   開啟方法參考頁面。系統會在頁面右側開啟 APIs Explorer 面板。您可以使用這項工具來傳送要求。完成任何必填欄位，然後按一下「執行」。

   輸出內容如下所示。如果回應包含 "done": true，表示長時間執行的作業已完成。

   回應

   {
     "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata",
       "apiMethodName": "google.cloud.healthcare.v1.dataset.DatasetService.CreateDataset",
       "createTime": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ",
       "endTime": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ",
       "logsUrl": "https://console.cloud.google.com/CLOUD_LOGGING_URL"
       "counter": {
         "success": "SUCCESS_COUNT",
         // If there were any failures, they display in the `failure` field.
         "failure": "FAILURE_COUNT"
       }
     },
     "done": true,
     // The `response` field only displays if there were no errors.
     "response": {
       "@type": "type.googleapis.com/google.cloud.healthcare.v1.dataset.Dataset",
       "name": "PROJECT_ID/locations/LOCATION/datasets/DATASET_ID",
     },
     // If there were any errors, an `error` field displays instead of a `response` field.
     // See Troubleshooting long-running operations for a list of response codes.
     "error": {
       "code": ERROR_CODE,
       "message": "DESCRIPTION",
       "details": [
         {
           "@type": "...",
           FIELD1: ...,
           ...
         }
       ]
     }
   }