本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 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，您可以使用 Amazon Comprehend [DetectPiiEntities](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DetectPiiEntities.html) 操作。您的輸入文字最多可包含 100 KB 的 UTF-8 編碼字元。支援的語言包括英文和西班牙文。

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

下列範例使用 `DetectPiiEntities`操作搭配 AWS CLI。

此範例格式適用於 Unix、Linux 和 macOS。用於 Windows 時，請以插入號 (^) 取代每一行結尾處的 Unix 接續字元斜線 (\$1)。

```
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 實體 (CLI)
<a name="realtime-pii-api-label-cli"></a>

下列範例使用 `ContainsPiiEntities`操作搭配 AWS CLI。

此範例格式適用於 Unix、Linux 和 macOS。用於 Windows 時，請以插入號 (^) 取代每一行結尾處的 Unix 接續字元斜線 (\$1)。

```
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
        }
    ]
}
```