기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 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>

단일 문서에서 PII를 찾으려면 Amazon 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 개체에 레이블 지정(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
        }
    ]
}
```