更新 HealthLake 資料存放區

使用 UpdateFHIRDatastore更新現有 AWS HealthLake 資料存放區的組態。您可以更新資料存放區名稱、自然語言處理 (NLP) 組態、分析組態、預設 FHIR 驗證設定檔，以及身分提供者組態。您在建立資料存放區時選擇的加密組態無法變更。

注意

更新身分提供者組態會將其完全取代，包括您要保留的每個欄位。您省略的任何欄位都會清除。

下列選單提供 AWS CLI 和 AWS SDKs的範例。如需詳細資訊，請參閱 AWS HealthLake API 參考中的 UpdateFHIRDatastore。

Important (重要)

NLP 和分析變更會透過非同步工作流程套用：資料存放區狀態會變更為 UPDATING，並在更新完成ACTIVE時傳回，否則會顯示 UPDATE_FAILED 。資料存放區名稱、FHIR 驗證設定檔和身分提供者變更會立即生效，而且不會變更狀態。一次只能有一個資料存放區的更新正在進行中；當資料存放區執行時提交的第二個更新會傳回 ConflictException。使用 DescribeFHIRDatastore 追蹤更新的狀態。

更新 HealthLake 資料存放區

根據您的存取偏好設定選擇選單 AWS HealthLake。

AWS CLI

範例 1：重新命名資料存放區


aws healthlake update-fhir-datastore \
  --datastore-id "datastore-id" \
  --datastore-name "RenamedFhirDatastore"

範例 2：啟用 NLP


aws healthlake update-fhir-datastore \
  --datastore-id "datastore-id" \
  --nlp-configuration '{ "Status": "ENABLED" }'

範例 3：暫停分析


aws healthlake update-fhir-datastore \
  --datastore-id "datastore-id" \
  --analytics-configuration '{ "Status": "PAUSED" }'

範例 4：更新預設 FHIR 驗證設定檔


aws healthlake update-fhir-datastore \
  --datastore-id "datastore-id" \
  --profile-configuration '{ "DefaultProfiles": ["us-core-3.1.1", "carin-bb-2.0.0"] }'

回應會傳回完整 DatastoreProperties- 與傳回的形狀相同DescribeFHIRDatastore。


{
    "DatastoreProperties": {
        "DatastoreId": "datastore-id",
        "DatastoreArn": "arn:aws:healthlake:us-east-1:account-id:datastore/datastore-id",
        "DatastoreName": "RenamedFhirDatastore",
        "DatastoreStatus": "UPDATING",
        "DatastoreTypeVersion": "R4",
        "DatastoreEndpoint": "https://healthlake.us-east-1.amazonaws.com/datastore/datastore-id/r4/",
        "NlpConfiguration": { "Status": "ENABLING" },
        "AnalyticsConfiguration": { "Status": "PAUSING" },
        "ProfileConfiguration": { "DefaultProfiles": [ "us-core-3.1.1", "carin-bb-2.0.0" ] },
        "IdentityProviderConfiguration": {
            "AuthorizationStrategy": "SMART_ON_FHIR_V1",
            "FineGrainedAuthorizationEnabled": true
        }
    }
}

如需 API 詳細資訊，請參閱 AWS CLI 命令參考中的 update-fhir-datastore。

Python

適用於 Python 的 SDK (Boto3)


def update_fhir_datastore(
    self,
    datastore_id: str,
    **kwargs,
) -> dict[str, any]:
    """
    Updates the configuration of an existing HealthLake data store.

    Pass any of DatastoreName, NlpConfiguration, AnalyticsConfiguration,
    ProfileConfiguration, or IdentityProviderConfiguration as keyword
    arguments. Omitted fields are left unchanged.

    :param datastore_id: The ID of the data store to update.
    :return: The response, including the full DatastoreProperties.
    """
    try:
        return self.health_lake_client.update_fhir_datastore(
            DatastoreId=datastore_id, **kwargs
        )
    except ClientError as err:
        logger.exception(
            "Couldn't update data store %s. Here's why: %s",
            datastore_id,
            err.response["Error"]["Message"],
        )
        raise

如需 API 詳細資訊，請參閱《適用於 AWS Python (Boto3) 的 SDK API 參考》中的 UpdateFHIRDatastore。

可用性範例

找不到所需的內容嗎？使用此頁面右側的提供意見回饋連結來請求程式碼範例。

文件慣用形式

列出資料存放區

標記資料存放區