HealthLake 사용 예제 AWS CLI - AWS Command Line Interface
작업

이 설명서는 의 버전 1 AWS CLI 전용입니다. 의 버전 2와 관련된 설명서는 버전 2 사용 설명서 를 AWS CLI참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

HealthLake 사용 예제 AWS CLI

다음 코드 예제에서는 AWS Command Line Interface 와 함께 를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다 HealthLake.

작업은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.

각 예제에는 컨텍스트에서 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있는 전체 소스 코드에 대한 링크가 포함되어 있습니다.

주제

작업

다음 코드 예시에서는 create-fhir-datastore을 사용하는 방법을 보여 줍니다.

AWS CLI

FHIR 데이터 스토어를 생성합니다.

다음 create-fhir-datastore 예제에서는 Amazon 에서 새 데이터 스토어를 생성하는 방법을 보여줍니다 HealthLake.

aws healthlake create-fhir-datastore \
    --region us-east-1 \
    --datastore-type-version R4 \
    --datastore-type-version R4 \
    --datastore-name "FhirTestDatastore"

출력:

{
    "DatastoreEndpoint": "https://healthlake.us-east-1.amazonaws.com/datastore/(Datastore ID)/r4/",
    "DatastoreArn": "arn:aws:healthlake:us-east-1:(AWS Account ID):datastore/(Datastore ID)",
    "DatastoreStatus": "CREATING",
    "DatastoreId": "(Datastore ID)"
}

자세한 내용은 Amazon HealthLake 개발자 안내서의 FHIR 데이터 스토어 생성 및 모니터링을 참조하세요.

  • 자세한 API 내용은 명령 참조CreateFhirDatastore의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 delete-fhir-datastore을 사용하는 방법을 보여 줍니다.

AWS CLI

FHIR 데이터 스토어를 삭제하려면

다음 delete-fhir-datastore 예제에서는 Amazon 에서 데이터 스토어와 해당 콘텐츠를 모두 삭제하는 방법을 보여줍니다 HealthLake.

aws healthlake delete-fhir-datastore \
    --datastore-id (Data Store ID) \
    --region us-east-1

출력:

{
    "DatastoreEndpoint": "https://healthlake.us-east-1.amazonaws.com/datastore/(Datastore ID)/r4/",
    "DatastoreArn": "arn:aws:healthlake:us-east-1:(AWS Account ID):datastore/(Datastore ID)",
    "DatastoreStatus": "DELETING",
    "DatastoreId": "(Datastore ID)"
}

자세한 내용은 Amazon HealthLake 개발자 안내서의 <https://docs.aws.amazon.com/healthlake/latest/devguide/working-with-FHIR-healthlake.html> FHIR 데이터 스토어 생성 및 모니터링을 참조하세요.

  • 자세한 API 내용은 명령 참조DeleteFhirDatastore의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 describe-fhir-datastore을 사용하는 방법을 보여 줍니다.

AWS CLI

FHIR 데이터 스토어를 설명하려면

다음 describe-fhir-datastore 예제에서는 Amazon 에서 데이터 스토어의 속성을 찾는 방법을 보여줍니다 HealthLake.

aws healthlake describe-fhir-datastore \
    --datastore-id "1f2f459836ac6c513ce899f9e4f66a59" \
    --region us-east-1

출력:

{
    "DatastoreProperties": {
        "PreloadDataConfig": {
            "PreloadDataType": "SYNTHEA"
        },
        "DatastoreName": "FhirTestDatastore",
        "DatastoreArn": "arn:aws:healthlake:us-east-1:(AWS Account ID):datastore/(Datastore ID)",
        "DatastoreEndpoint": "https://healthlake.us-east-1.amazonaws.com/datastore/(Datastore ID)/r4/",
        "DatastoreStatus": "CREATING",
        "DatastoreTypeVersion": "R4",
        "DatastoreId": "(Datastore ID)"
    }
}

자세한 내용은 Amazon HealthLake 개발자 안내서의 FHIR 데이터 스토어 생성 및 모니터링을 참조하세요.

다음 코드 예시에서는 describe-fhir-export-job을 사용하는 방법을 보여 줍니다.

AWS CLI

FHIR 내보내기 작업을 설명하려면

다음 describe-fhir-export-job 예제는 Amazon 에서 FHIR 내보내기 작업의 속성을 찾는 방법을 보여줍니다 HealthLake.

aws healthlake describe-fhir-export-job \
    --datastore-id (Datastore ID) \
    --job-id 9b9a51943afaedd0a8c0c26c49135a31

출력:

{
    "ExportJobProperties": {
        "DataAccessRoleArn": "arn:aws:iam::(AWS Account ID):role/(Role Name)",
        "JobStatus": "IN_PROGRESS",
        "JobId": "9009813e9d69ba7cf79bcb3468780f16",
        "SubmitTime": 1609175692.715,
        "OutputDataConfig": {
            "S3Uri": "s3://(Bucket Name)/(Prefix Name)/59593b2d0367ce252b5e66bf5fd6b574-FHIR_EXPORT-9009813e9d69ba7cf79bcb3468780f16/"
        },
        "DatastoreId": "(Datastore ID)"
    }
}

자세한 내용은 Amazon HealthLake 개발자 안내서의 FHIR 데이터 스토어에서 파일 내보내기를 참조하세요.

다음 코드 예시에서는 describe-fhir-import-job을 사용하는 방법을 보여 줍니다.

AWS CLI

FHIR 가져오기 작업을 설명하려면

다음 describe-fhir-import-job 예제에서는 Amazon 를 사용하여 FHIR 가져오기 작업의 속성을 학습하는 방법을 보여줍니다 HealthLake.

aws healthlake describe-fhir-import-job \
    --datastore-id (Datastore ID) \
    --job-id c145fbb27b192af392f8ce6e7838e34f \
    --region us-east-1

출력:

{
    "ImportJobProperties": {
    "InputDataConfig": {
        "S3Uri": "s3://(Bucket Name)/(Prefix Name)/"
        { "arrayitem2": 2 }
    },
    "DataAccessRoleArn": "arn:aws:iam::(AWS Account ID):role/(Role Name)",
    "JobStatus": "COMPLETED",
    "JobId": "c145fbb27b192af392f8ce6e7838e34f",
    "SubmitTime": 1606272542.161,
    "EndTime": 1606272609.497,
    "DatastoreId": "(Datastore ID)"
    }
}

자세한 내용은 Amazon HealthLake 개발자 안내서의 FHIR 데이터 스토어로 파일 가져오기를 참조하세요.

다음 코드 예시에서는 list-fhir-datastores을 사용하는 방법을 보여 줍니다.

AWS CLI

FHIR 데이터 스토어를 나열하려면

다음 list-fhir-datastores 예제에서는 명령을 사용하는 방법과 사용자가 Amazon 의 Data Store 상태를 기반으로 결과를 필터링하는 방법을 보여줍니다 HealthLake.

aws healthlake list-fhir-datastores \
    --region us-east-1 \
    --filter DatastoreStatus=ACTIVE

출력:

{
    "DatastorePropertiesList": [
    {
        "PreloadDataConfig": {
            "PreloadDataType": "SYNTHEA"
        },
        "DatastoreName": "FhirTestDatastore",
        "DatastoreArn": "arn:aws:healthlake:us-east-1:<AWS Account ID>:datastore/<Datastore ID>",
        "DatastoreEndpoint": "https://healthlake.us-east-1.amazonaws.com/datastore/<Datastore ID>/r4/",
        "DatastoreStatus": "ACTIVE",
        "DatastoreTypeVersion": "R4",
        "CreatedAt": 1605574003.209,
        "DatastoreId": "<Datastore ID>"
    },
    {
        "DatastoreName": "Demo",
        "DatastoreArn": "arn:aws:healthlake:us-east-1:<AWS Account ID>:datastore/<Datastore ID>",
        "DatastoreEndpoint": "https://healthlake.us-east-1.amazonaws.com/datastore/<Datastore ID>/r4/",
        "DatastoreStatus": "ACTIVE",
        "DatastoreTypeVersion": "R4",
        "CreatedAt": 1603761064.881,
        "DatastoreId": "<Datastore ID>"
    }
    ]
}

자세한 내용은 Amazon HealthLake 개발자 안내서의 FHIR 데이터 스토어 생성 및 모니터링을 참조하세요.

  • 자세한 API 내용은 명령 참조ListFhirDatastores의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 list-fhir-export-jobs을 사용하는 방법을 보여 줍니다.

AWS CLI

모든 FHIR 내보내기 작업을 나열하려면

다음 list-fhir-export-jobs 예제에서는 명령을 사용하여 계정과 연결된 내보내기 작업 목록을 보는 방법을 보여줍니다.

aws healthlake list-fhir-export-jobs \
    --datastore-id (Datastore ID) \
    --submitted-before (DATE like 2024-10-13T19:00:00Z)\
    --submitted-after (DATE like 2020-10-13T19:00:00Z )\
    --job-name "FHIR-EXPORT" \
    --job-status SUBMITTED  \
    --max-results (Integer between 1 and 500)

출력:

{
    "ExportJobProperties": {
        "OutputDataConfig": {
            "S3Uri": "s3://(Bucket Name)/(Prefix Name)/"
                "S3Configuration": {
                "S3Uri": "s3://(Bucket Name)/(Prefix Name)/",
                "KmsKeyId" : "(KmsKey Id)"
        },
    },
    "DataAccessRoleArn": "arn:aws:iam::(AWS Account ID):role/(Role Name)",
    "JobStatus": "COMPLETED",
    "JobId": "c145fbb27b192af392f8ce6e7838e34f",
    "JobName" "FHIR-EXPORT",
    "SubmitTime": 1606272542.161,
    "EndTime": 1606272609.497,
    "DatastoreId": "(Datastore ID)"
    }
}
"NextToken": String

자세한 내용은 Amazon HealthLake 개발자 안내서의 FHIR 데이터 스토어에서 파일 내보내기를 참조하세요.

  • 자세한 API 내용은 명령 참조ListFhirExportJobs의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 list-fhir-import-jobs을 사용하는 방법을 보여 줍니다.

AWS CLI

모든 FHIR 가져오기 작업을 나열하려면

다음 list-fhir-import-jobs 예제에서는 명령을 사용하여 계정과 연결된 모든 가져오기 작업 목록을 보는 방법을 보여줍니다.

aws healthlake list-fhir-import-jobs \
    --datastore-id (Datastore ID) \
    --submitted-before (DATE like 2024-10-13T19:00:00Z) \
    --submitted-after (DATE like 2020-10-13T19:00:00Z ) \
    --job-name "FHIR-IMPORT" \
    --job-status SUBMITTED  \
    -max-results (Integer between 1 and 500)

출력:

{
    "ImportJobProperties": {
        "OutputDataConfig": {
            "S3Uri": "s3://(Bucket Name)/(Prefix Name)/",
                "S3Configuration": {
                    "S3Uri": "s3://(Bucket Name)/(Prefix Name)/",
                    "KmsKeyId" : "(KmsKey Id)"
    },
    },
        "DataAccessRoleArn": "arn:aws:iam::(AWS Account ID):role/(Role Name)",
        "JobStatus": "COMPLETED",
        "JobId": "c145fbb27b192af392f8ce6e7838e34f",
        "JobName" "FHIR-IMPORT",
        "SubmitTime": 1606272542.161,
        "EndTime": 1606272609.497,
        "DatastoreId": "(Datastore ID)"
    }
}
"NextToken": String

자세한 내용은 Amazon HealthLake 개발자 안내서의 FHIR Data Store로 파일 가져오기를 참조하세요.

  • 자세한 API 내용은 명령 참조ListFhirImportJobs의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 list-tags-for-resource을 사용하는 방법을 보여 줍니다.

AWS CLI

데이터 스토어의 태그를 나열하려면

다음 list-tags-for-resource 예제에서는 지정된 데이터 스토어와 연결된 태그를 나열합니다.

aws healthlake list-tags-for-resource \
    --resource-arn "arn:aws:healthlake:us-east-1:674914422125:datastore/fhir/0725c83f4307f263e16fd56b6d8ebdbe" \
    --region us-east-1

출력:

{
    "tags": {
        "key": "value",
        "key1": "value1"
    }
}

자세한 내용은 Amazon 개발자 안내서의 Amazon에서 리소스 태그 지정 HealthLake을 참조하세요. HealthLake

  • 자세한 API 내용은 명령 참조ListTagsForResource의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 start-fhir-export-job을 사용하는 방법을 보여 줍니다.

AWS CLI

FHIR 내보내기 작업을 시작하려면

다음 start-fhir-export-job 예제에서는 Amazon 를 사용하여 FHIR 내보내기 작업을 시작하는 방법을 보여줍니다 HealthLake.

aws healthlake start-fhir-export-job \
    --output-data-config S3Uri="s3://(Bucket Name)/(Prefix Name)/" \
    --datastore-id (Datastore ID) \
    --data-access-role-arn arn:aws:iam::(AWS Account ID):role/(Role Name)

출력:

{
    "DatastoreId": "(Datastore ID)",
    "JobStatus": "SUBMITTED",
    "JobId": "9b9a51943afaedd0a8c0c26c49135a31"
}

자세한 내용은 Amazon HealthLake 개발자 안내서의 FHIR 데이터 스토어에서 파일 내보내기를 참조하세요.

  • 자세한 API 내용은 명령 참조StartFhirExportJob의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 start-fhir-import-job을 사용하는 방법을 보여 줍니다.

AWS CLI

FHIR 가져오기 작업을 시작하려면

다음 start-fhir-import-job 예제에서는 Amazon 를 사용하여 FHIR 가져오기 작업을 시작하는 방법을 보여줍니다 HealthLake.

aws healthlake start-fhir-import-job \
    --input-data-config S3Uri="s3://(Bucket Name)/(Prefix Name)/" \
    --datastore-id (Datastore ID) \
    --data-access-role-arn "arn:aws:iam::(AWS Account ID):role/(Role Name)" \
    --region us-east-1

출력:

{
    "DatastoreId": "(Datastore ID)",
    "JobStatus": "SUBMITTED",
    "JobId": "c145fbb27b192af392f8ce6e7838e34f"
}

자세한 내용은 Amazon HeatlhLake 개발자 안내서의 FHIR Data Store 'https://docs.aws.amazon.com/healthlake/latest/devguide/import-datastore.html로 파일 가져오기를 참조하세요.

  • 자세한 API 내용은 명령 참조StartFhirImportJob의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 tag-resource을 사용하는 방법을 보여 줍니다.

AWS CLI

Data Store에 태그를 추가하려면

다음 tag-resource 예제에서는 Data Store에 태그를 추가하는 방법을 보여줍니다.

aws healthlake tag-resource \
    --resource-arn "arn:aws:healthlake:us-east-1:691207106566:datastore/fhir/0725c83f4307f263e16fd56b6d8ebdbe" \
    --tags '[{"Key": "key1", "Value": "value1"}]' \
    --region us-east-1

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon 개발자 안내서의 '데이터 스토어에 태그 추가 <https://docs.aws.amazon.com/healthlake/latest/devguide/add-a-tag.html>'__를 참조하세요. HealthLake

  • 자세한 API 내용은 명령 참조TagResource의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 untag-resource을 사용하는 방법을 보여 줍니다.

AWS CLI

데이터 스토어에서 태그를 제거합니다.

다음 untag-resource 예제에서는 데이터 스토어에서 태그를 제거하는 방법을 보여줍니다.

aws healthlake untag-resource \
    --resource-arn "arn:aws:healthlake:us-east-1:674914422125:datastore/fhir/b91723d65c6fdeb1d26543a49d2ed1fa" \
    --tag-keys '["key1"]' \
    --region us-east-1

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon HealthLake 개발자 안내서의 데이터 스토어에서 태그 제거를 참조하세요.

  • 자세한 API 내용은 명령 참조UntagResource의 섹션을 참조하세요. AWS CLI