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

# PII 实时分析 (API)
<a name="realtime-pii-api"></a>

Amazon Comprehend 提供实时同步 API 操作，用于分析文档中的个人身份信息 (PII)。

**Topics**
+ [

## 查找 PII 实时实体 (API)
](#realtime-pii-api-locate)
+ [

## 标注 PII 实时实体 (API)
](#realtime-pii-api-labels)

## 查找 PII 实时实体 (API)
<a name="realtime-pii-api-locate"></a>

要在单个文档中找到 PII，您可以使用亚马逊 Comprehend 操作[DetectPiiEntities](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DetectPiiEntities.html)。您的输入文本最多可包含 100 千字节 UTF-8 编码的字符。支持的语言包括英语和西班牙语。

### 使用 (CLI) 查找 PII
<a name="realtime-pii-api-cli"></a>

以下示例使用 AWS CLI的 `DetectPiiEntities` 操作。

此示例的格式适用于 Unix、Linux 和 macOS。对于 Windows，请将每行末尾的反斜杠 (\$1) Unix 行继续符替换为脱字号 (^)。

```
aws comprehend detect-pii-entities \
  --text "Hello Paul Santos. The latest statement for your credit card \
  account 1111-0000-1111-0000 was mailed to 123 Any Street, Seattle, WA \
   98109." \
  --language-code en
```

Amazon Comprehend 的响应如下：

```
{
      "Entities": [
          {
              "Score": 0.9999669790267944,
              "Type": "NAME",
              "BeginOffset": 6,
              "EndOffset": 18
          },
          {
              "Score": 0.8905550241470337,
              "Type": "CREDIT_DEBIT_NUMBER",
              "BeginOffset": 69,
              "EndOffset": 88
          },
          {
              "Score": 0.9999889731407166,
              "Type": "ADDRESS",
              "BeginOffset": 103,
              "EndOffset": 138
          }
      ]
  }
```

## 标注 PII 实时实体 (API)
<a name="realtime-pii-api-labels"></a>

您可以使用实时同步 API 操作来返回已识别的 PII 实体类型的标签。有关更多信息，请参阅 [标注 PII 实体](how-pii-labels.md)。

### 标注 PII 实体 (CLT)
<a name="realtime-pii-api-label-cli"></a>

以下示例使用 AWS CLI的 `ContainsPiiEntities` 操作。

此示例的格式适用于 Unix、Linux 和 macOS。对于 Windows，请将每行末尾的反斜杠 (\$1) Unix 行继续符替换为脱字号 (^)。

```
aws comprehend contains-pii-entities \
--text "Hello Paul Santos. The latest statement for your credit card \
account 1111-0000-1111-0000 was mailed to 123 Any Street, Seattle, WA \
 98109." \
--language-code en
```

Amazon Comprehend 的响应如下：

```
{
    "Labels": [
        {
            "Name": "NAME",
            "Score": 0.9149109721183777
        },
        {
            "Name": "CREDIT_DEBIT_NUMBER",
            "Score": 0.8905550241470337
        }
         {
            "Name": "ADDRESS",
            "Score": 0.9951046109199524
        }
    ]
}
```