As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Análise em tempo real (API) de PII
<a name="realtime-pii-api"></a>

O Amazon Comprehend fornece operações de API síncronas em tempo real para analisar informações de identificação pessoal (PII) em um documento.

**Topics**
+ [Localizando entidades de PII em tempo real (API)](#realtime-pii-api-locate)
+ [Rotular entidades de PII em tempo real (API)](#realtime-pii-api-labels)

## Localizando entidades de PII em tempo real (API)
<a name="realtime-pii-api-locate"></a>

Para localizar PII em um único documento, você pode usar a operação Amazon Comprehend [DetectPiiEntities](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DetectPiiEntities.html). Seu texto de entrada pode incluir até 100 kilobytes de caracteres codificados em UTF-8. Os idiomas suportados incluem inglês e espanhol.

### Localizar PII usando (CLI)
<a name="realtime-pii-api-cli"></a>

O exemplo a seguir usa a operação `DetectPiiEntities` com o AWS CLI.

O exemplo é formatado para Unix, Linux e macOS. Para Windows, substitua o caractere de continuação Unix de barra invertida (\$1) no final de cada linha por um circunflexo (^).

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

O Amazon Comprehend responde com o seguinte:

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

## Rotular entidades de PII em tempo real (API)
<a name="realtime-pii-api-labels"></a>

Você pode usar operações de API síncronas em tempo real para retornar os rótulos dos tipos de entidades de PII identificados. Para obter mais informações, consulte [Rotular entidades de PII](how-pii-labels.md).

### Rotular entidades PII (CLI)
<a name="realtime-pii-api-label-cli"></a>

O exemplo a seguir usa a operação `ContainsPiiEntities` com o AWS CLI.

O exemplo é formatado para Unix, Linux e macOS. Para Windows, substitua o caractere de continuação Unix de barra invertida (\$1) no final de cada linha por um circunflexo (^).

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

O Amazon Comprehend responde com o seguinte:

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