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

# 使用检索概念细节 `$lookup`
<a name="reference-fhir-operations-lookup"></a>

AWS HealthLake 现在支持 CodeSystem 资源`$lookup`操作，使您能够通过提供代码等识别信息来检索有关代码系统中特定概念的详细信息。当您需要执行以下操作时，此操作特别有用：
+ 检索有关特定医疗法规的详细信息
+ 验证代码含义和属性
+ 访问概念定义和关系
+ 利用准确的术语数据支持临床决策

## 用法
<a name="lookup-usage"></a>

可以使用 GET 和 POST 方法对 CodeSystem 资源调用该`$lookup`操作：

**支持的操作**  


```
GET [base]/CodeSystem/$lookup?system=http://snomed.info/sct&code=73211009&version=20230901
POST [base]/CodeSystem/$lookup
```

## 支持的参数
<a name="lookup-parameters"></a>

HealthLake 支持 FHIR R4 `$lookup` 参数的子集：


| 参数 | Type | 必需 | 说明 | 
| --- | --- | --- | --- | 
| code | 代码 | 是 | 你正在查找的概念代码（例如，康涅狄格州 SNOMED 中的 “716200000”） | 
| system | uri | 是 | 代码系统的权威网址（例如，“[http://snomed.info/sct](http://snomed.info/sct)”） | 
| version | 字符串 | 否 | 代码系统的特定版本 | 

## 示例
<a name="lookup-examples"></a>

**获取请求**  


```
GET [base]/CodeSystem/$lookup?system=http://snomed.info/sct&code=71620000&version=2023-09
```

**POST 请求**  


```
POST [base]/CodeSystem/$lookup
Content-Type: application/fhir+json

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "system",
      "valueUri": "http://snomed.info/sct"
    },
    {
      "name": "code",
      "valueCode": "71620000"
    },
    {
      "name": "version",
      "valueString": "2023-09"
    }
  ]
}
```

**示例响应**  
该操作返回一个包含概念详细信息的参数资源：

```
{
    "resourceType": "Parameters",
    "parameter": [{
            "name": "name",
            "valueString": "SNOMED CT Fractures"
        },
        {
            "name": "version",
            "valueString": "2023-09"
        },
        {
            "name": "display",
            "valueString": "Fracture of femur"
        },
        {
            "name": "property",
            "part": [{
                    "name": "code",
                    "valueCode": "child"
                },
                {
                    "name": "value",
                    "valueCode": "263225007"
                },
                {
                    "name": "description",
                    "valueString": "Fracture of neck of femur"
                }
            ]
        },
        {
            "name": "property",
            "part": [{
                    "name": "code",
                    "valueCode": "child"
                },
                {
                    "name": "value",
                    "valueCode": "263227004"
                },
                {
                    "name": "description",
                    "valueString": "Fracture of shaft of femur"
                }
            ]
        }
    ]
}
```

## 响应参数
<a name="lookup-response-parameters"></a>

响应包括以下参数（如果有）：


| 参数 | 类型 | 说明 | 
| --- | --- | --- | 
| name | 字符串 | 代码系统的名称 | 
| version | 字符串 | 代码系统的版本 | 
| display | 字符串 | 概念的显示名称 | 
| designation | BackboneElement | 此概念的其他表述。 | 
| property | BackboneElement | 概念的其他属性（定义、关系等） | 

## 行为
<a name="lookup-behavior"></a>

该`$lookup`操作：

1. 验证所需的参数（`code`和`system`）

1. 在存储在数据存储中的指定代码系统中搜索概念

1. 返回详细的概念信息，包括显示名称、名称和属性。

1. 提供参数时支持特定版本的`version`查找

1. 仅在显式存储在 HealthLake 数据存储中的代码系统上运行

## 错误处理
<a name="lookup-error-handling"></a>

该操作处理以下错误情况：
+ 400 错误请求：`$lookup`操作无效（请求不符合要求或缺少必填参数）
+ 404 未找到：未找到代码系统或在指定的代码系统中找不到代码

## 警告
<a name="lookup-caveats"></a>

此版本不支持以下内容：
+ `$lookup`通过调用外部术语服务器进行操作
+ `$lookup`操作由 CodeSystems 管理 HealthLake 但未显式存储在数据存储中

有关`$lookup`操作规范的更多信息，请参阅 [FHIR R4 文档 CodeSystem `$lookup`](https://www.hl7.org/fhir/R4/codesystem-operation-lookup.html)。