View a markdown version of this page

Atualizando um armazenamento HealthLake de dados - AWS HealthLake

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Atualizando um armazenamento HealthLake de dados

Use UpdateFHIRDatastore para atualizar a configuração de um armazenamento de AWS HealthLake dados existente. Você pode atualizar o nome do armazenamento de dados, a configuração de processamento de linguagem natural (NLP), a configuração de análise, os perfis de validação FHIR padrão e a configuração do provedor de identidade. A configuração de criptografia que você escolheu ao criar o armazenamento de dados não pode ser alterada.

nota

A atualização da configuração do provedor de identidade a substitui por completo — inclua todos os campos que você deseja manter. Qualquer campo que você omitir será limpo.

O menu a seguir fornece exemplos dos AWS SDKs AWS CLI e. Para obter mais informações, consulte UpdateFHIRDatastore na Referência de APIs do AWS HealthLake .

Importante

As alterações de PNL e de análise são aplicadas por meio de um fluxo de trabalho assíncrono: o status do armazenamento de dados muda UPDATING e retorna ACTIVE quando a atualização é concluída, ou mostra UPDATE_FAILED se não. As alterações no nome do armazenamento de dados, no perfil de validação do FHIR e no provedor de identidade entram em vigor imediatamente e não alteram o status. Somente uma atualização pode estar em andamento para um armazenamento de dados por vez; uma segunda atualização enviada enquanto a outra está em execução retornaConflictException. Use DescribeFHIRDatastore para rastrear o status de uma atualização.

Para atualizar um armazenamento HealthLake de dados

Escolha um menu com base na sua preferência de acesso AWS HealthLake a.

AWS CLI

Exemplo 1: Renomear um armazenamento de dados

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

Exemplo 2: Habilitar a PNL

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

Exemplo 3: Pausar a análise

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

Exemplo 4: Atualizar perfis de validação FHIR padrão

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

A resposta retorna o valor completo DatastoreProperties — a mesma forma retornada porDescribeFHIRDatastore.

{
    "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
        }
    }
}

Para obter detalhes da API, consulte update-fhir-datastore na Referência de comandos da CLI.AWS

Python

SDK para 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

Para obter detalhes da API, consulte UpdateFhirDatastore na Referência da API SDK for AWS Python (Boto3).

Exemplo de disponibilidade

Não consegue encontrar o que precisa? Solicite um exemplo de código usando o link Fornecer feedback na barra lateral direita desta página.