View a markdown version of this page

HealthLake データストアの更新 - AWS HealthLake

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

HealthLake データストアの更新

を使用してUpdateFHIRDatastore、既存の AWS HealthLake データストアの設定を更新します。データストア名、自然言語処理 (NLP) 設定、分析設定、デフォルトの FHIR 検証プロファイル、ID プロバイダー設定を更新できます。データストアの作成時に選択した暗号化設定は変更できません。

注記

ID プロバイダー設定を更新すると、保持するすべてのフィールドを含め、ID プロバイダー設定が完全に置き換えられます。省略したフィールドはクリアされます。

次のメニューは、 AWS CLI および AWS SDKsの例を示しています。詳細については、「AWS HealthLake API リファレンス」の「UpdateFHIRDatastore」を参照してください。

[重要]

NLP と分析の変更は非同期ワークフローを通じて適用されます。データストアのステータスは に変わり、ACTIVE更新が完了すると UPDATING に戻ります。そうUPDATE_FAILEDでない場合は が表示されます。データストア名、FHIR 検証プロファイル、ID プロバイダーの変更はすぐに有効になり、ステータスは変更されません。データストアに対して一度に実行できる更新は 1 つだけです。1 つの の実行中に送信される 2 番目の更新は を返します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

SDK for Python (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 SDK for Python (Boto3) API リファレンスのUpdateFHIRDatastore」を参照してください。

可用性の例

必要なものが見つからなかった場合。このページの右側サイドバーにあるフィードバックを提供するリンクを使用して、コード例をリクエストします。