Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Análisis de PII en tiempo real (API)
<a name="realtime-pii-api"></a>

Amazon Comprehend proporciona operaciones de API sincrónicas en tiempo real para analizar la información de identificación personal (PII) de un documento.

**Topics**
+ [Localización de entidades de PII en tiempo real (API)](#realtime-pii-api-locate)
+ [Etiquetado de entidades de PII en tiempo real (API)](#realtime-pii-api-labels)

## Localización de entidades de PII en tiempo real (API)
<a name="realtime-pii-api-locate"></a>

Para localizar la información de identificación personal en un único documento, puede utilizar la operación Amazon [DetectPiiEntities](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DetectPiiEntities.html)Comprehend. El texto introducido puede incluir hasta 100 kilobytes de caracteres codificados en UTF-8. Los idiomas admitidos incluyen inglés y español.

### Localización de PII mediante (CLI)
<a name="realtime-pii-api-cli"></a>

En el siguiente ejemplo, se utiliza la operación `DetectPiiEntities` con la AWS CLI.

El ejemplo está formateado para Unix, Linux y macOS. Para Windows, sustituya la barra diagonal invertida (\$1) utilizada como carácter de continuación de Unix al final de cada línea por el signo de intercalación (^).

```
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 responde con lo siguiente:

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

## Etiquetado de entidades de PII en tiempo real (API)
<a name="realtime-pii-api-labels"></a>

Puede utilizar operaciones de API sincrónicas en tiempo real para devolver las etiquetas de los tipos de entidades de PII identificados. Para obtener más información, consulte [Etiquetado de entidades de PII](how-pii-labels.md).

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

En el siguiente ejemplo, se utiliza la operación `ContainsPiiEntities` con la AWS CLI.

El ejemplo está formateado para Unix, Linux y macOS. Para Windows, sustituya la barra diagonal invertida (\$1) utilizada como carácter de continuación de Unix al final de cada línea por el signo de intercalación (^).

```
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 responde con lo siguiente:

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