이 페이지에서는 projects.locations.datasets.hl7V2Stores.messages.batchGet 메서드를 사용하여 HL7v2 저장소에서 메시지를 대량으로 읽는 방법을 설명합니다.
batchGet을 사용하면 한 번의 호출로 최대 100개의 HL7v2 메시지를 검색할 수 있습니다.
projects.locations.datasets.hl7V2Stores.messages.get 메시지를 사용하여 한 번에 하나의 HL7v2 메시지를 검색할 수 있지만 메시지가 너무 많으면 과도한 네트워크 비용이 발생할 수 있습니다. API 호출 한 번으로 여러 메시지를 검색하려면 batchGet을 사용합니다.
HL7v2 메시지 일괄 가져오기
다음 샘플은 HL7v2 메시지의 콘텐츠를 일괄적으로 가져오는 방법을 보여줍니다.
자세한 내용은 projects.locations.datasets.hl7V2Stores.messages.batchGet를 참조하세요.
curl
HL7v2 메시지를 일괄적으로 가져오려면 GET 요청을 수행하고 다음 정보를 지정합니다.
- 상위 데이터 세트의 이름
- HL7v2 저장소의 이름
- 액세스 토큰
- 쿼리 매개변수
names는 검색하려는 HL7v2 메시지의 이름입니다. 각names값에 대해 메시지의 정규화된 경로를projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID형식으로 입력합니다.
다음 샘플은 curl을 사용하는 GET 요청을 보여줍니다.
curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID
/locations/LOCATION/datasets/DATASET_ID
/hl7V2Stores/HL7V2_STORE_ID/messages:batchGet?names=MESSAGE_NAME_1&names=MESSAGE_NAME_2&names=
MESSAGE_NAME_3&view=FULL"
요청이 성공하면 서버가 JSON 형식으로 응답을 반환합니다.
{
"messages" : [
{
"name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID"
}
]
}
PowerShell
HL7v2 메시지를 일괄적으로 가져오려면 GET 요청을 수행하고 다음 정보를 지정합니다.
- 상위 데이터 세트의 이름
- HL7v2 저장소의 이름
- 액세스 토큰
- 쿼리 매개변수
names는 검색하려는 HL7v2 메시지의 이름입니다. 각names값에 대해 메시지의 정규화된 경로를projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID형식으로 입력합니다.
다음 샘플은 Windows PowerShell을 사용한 GET 요청을 보여줍니다.
$cred = gcloud auth application-default print-access-token
$headers = @{ Authorization = "Bearer $cred" }
Invoke-WebRequest `
-Method Get `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages:batchGet?names=MESSAGE_NAME_1&names=MESSAGE_NAME_2&names=MESSAGE_NAME_3&view=FULL" | Select-Object -Expand Content
요청이 성공하면 서버가 JSON 형식으로 응답을 반환합니다.
{
"messages" : [
{
"name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID"
}
]
}