翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# PII リアルタイム分析 (API)
<a name="realtime-pii-api"></a>

Amazon Comprehend には、文書内の個人を特定できる情報 (PII) を分析するためのリアルタイム同期 API 演算機能があります。

**Topics**
+ [PII リアルタイムエンティティ (API) の検索](#realtime-pii-api-locate)
+ [PII リアルタイムエンティティのラベル付け (API)](#realtime-pii-api-labels)

## PII リアルタイムエンティティ (API) の検索
<a name="realtime-pii-api-locate"></a>

1 文書内の PII を検索するには、Amazon Comprehend の [DetectPIIEntities](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DetectPiiEntities.html) 演算機能を使用できます。入力テキストには、UTF-8 エンコード文字で 100 バイトまで含めることができます。サポートされている言語には、英語とスペイン語があります。

### (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 エンティティのラベル付け (CLI)
<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
        }
    ]
}
```