View a markdown version of this page

更新 HealthLake 数据存储 - AWS HealthLake

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

更新 HealthLake 数据存储

UpdateFHIRDatastore用于更新现有 AWS HealthLake 数据存储的配置。您可以更新数据存储名称、自然语言处理 (NLP) 配置、分析配置、默认 FHIR 验证配置文件和身份提供者配置。无法更改您在创建数据存储时选择的加密配置。

注意

更新身份提供商配置会将其全部替换，包括您要保留的每个字段。您省略的任何字段都将被清除。

以下菜单提供了 AWS CLI 和 AWS 软件开发工具包的示例。有关更多信息，请参阅《AWS HealthLake API Reference》中的 UpdateFHIRDatastore。

重要提示

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 的详细信息，请参阅 CLI 命令参考中的 update-fhir-datastore。AWS

Python

适用于 Python (Boto3) 的 SDK

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 的详细信息，请参阅 Python SD AWS K (Boto3) API 参考中的 updateFhirDataStore。

示例可用性

找不到所需的内容？ 使用本页右侧边栏上的 “提供反馈” 链接请求代码示例。