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.

# Amazon SNS
<a name="sns-component"></a>

El componente Amazon SNS (`aws.greengrass.SNS`) publica mensajes en un tema de Amazon Simple Notification Service (Amazon SNS). Puede usar este componente para enviar eventos desde los dispositivos principales de Greengrass a servidores web, direcciones de correo electrónico y otros suscriptores de mensajes. Para obtener más información, consulte [¿Qué es Amazon SNS?](https://docs.aws.amazon.com/sns/latest/dg/welcome.html) en la *Guía para desarrolladores de Amazon Simple Notification Service*.

Para publicar en un tema de Amazon SNS con este componente, publique un mensaje en un tema al que se suscriba este componente. De forma predeterminada, este componente se suscribe al tema `sns/message` [de publicación/suscripción local](ipc-publish-subscribe.md). Puede especificar otros temas, incluidos los de AWS IoT Core MQTT, al implementar este componente.

En su componente personalizado, puede que desee implementar una lógica de filtrado o formato para procesar los mensajes de otros orígenes antes de publicarlos en este componente. Esto le permite centralizar la lógica de procesamiento de mensajes en un único componente.

**nota**  
Este componente proporciona una funcionalidad similar a la del conector Amazon SNS de la versión 1. AWS IoT Greengrass Para obtener información, consulte [Amazon SNS connector](https://docs.aws.amazon.com/greengrass/latest/developerguide/sns-connector.html) en la *Guía para desarrolladores de AWS IoT Greengrass V1*.

**Topics**
+ [Versiones](#sns-component-versions)
+ [Tipo](#sns-component-type)
+ [Sistema operativo](#sns-component-os-support)
+ [Requisitos](#sns-component-requirements)
+ [Dependencias](#sns-component-dependencies)
+ [Configuración](#sns-component-configuration)
+ [Datos de entrada](#sns-component-input-data)
+ [Datos de salida](#sns-component-output-data)
+ [Archivo de registro local](#sns-component-log-file)
+ [Licencias](#sns-component-licenses)
+ [Registros de cambios](#sns-component-changelog)

## Versiones
<a name="sns-component-versions"></a>

Este componente tiene las siguientes versiones:
+ 2.1.x
+ 2.0.x

## Tipo
<a name="sns-component-type"></a>

<a name="public-component-type-lambda"></a>Este <a name="public-component-type-lambda-phrase"></a>componente es un componente de Lambda (`aws.greengrass.lambda`). El [núcleo de Greengrass](greengrass-nucleus-component.md) ejecuta la función de Lambda de este componente mediante el [componente lanzador de Lambda](lambda-launcher-component.md).

<a name="public-component-type-more-information"></a>Para obtener más información, consulte [Tipos de componentes](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="sns-component-os-support"></a>

Este componente solo se puede instalar en los dispositivos principales de Linux.

## Requisitos
<a name="sns-component-requirements"></a>

Este componente tiene los siguientes requisitos:
+ <a name="core-device-lambda-function-requirements"></a>El dispositivo principal debe cumplir los requisitos para ejecutar las funciones de Lambda. Si desea que el dispositivo principal ejecute funciones de Lambda en contenedores, el dispositivo debe cumplir los requisitos para hacerlo. Para obtener más información, consulte [Requisitos de la función de Lambda](setting-up.md#greengrass-v2-lambda-requirements).
+ <a name="public-component-python3-requirement"></a>Versión 3.7 de [Python](https://www.python.org/) instalada en el dispositivo principal y agregada a la variable de entorno PATH.
+ Un tema de Amazon SNS. Para obtener instrucciones, consulte el [tema Creación de un tema de Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-create-topic.html) en la *Guía para desarrolladores de Amazon Simple Notification Service*.
+ El [rol del dispositivo de Greengrass](device-service-role.md) debe permitir la acción `sns:Publish`, tal como se muestra en la siguiente política de IAM de ejemplo.

------
#### [ JSON ]

****  

  ```
  {
    "Version":"2012-10-17",		 	 	 
    "Statement": [
      {
        "Action": [
          "sns:Publish"
        ],
        "Effect": "Allow",
        "Resource": [
          "arn:aws:sns:us-east-1:123456789012:topic-name"
        ]
      }
    ]
  }
  ```

------

  Puede anular dinámicamente el tema predeterminado en la carga útil del mensaje de entrada para este componente. Si su aplicación utiliza esta característica, la política de IAM debe incluir todos los temas de destino como recursos. Puede conceder acceso granular o condicional a recursos (por ejemplo, utilizando un esquema de nomenclatura con comodín `*`)
+ <a name="connector-component-legacy-subscription-router-dependency"></a>Para recibir los datos de salida de este componente, debe combinar la siguiente actualización de configuración para el [componente del enrutador de suscripción antiguo](legacy-subscription-router-component.md) (`aws.greengrass.LegacySubscriptionRouter`) cuando implemente este componente. Esta configuración especifica el tema en el que este componente publica las respuestas.

------
#### [ Legacy subscription router v2.1.x ]

  ```
  {
    "subscriptions": {
      "aws-greengrass-sns": {
        "id": "aws-greengrass-sns",
        "source": "component:aws.greengrass.SNS",
        "subject": "sns/message/status",
        "target": "cloud"
      }
    }
  }
  ```

------
#### [ Legacy subscription router v2.0.x ]

  ```
  {
    "subscriptions": {
      "aws-greengrass-sns": {
        "id": "aws-greengrass-sns",
        "source": "arn:aws:lambda:region:aws:function:aws-greengrass-sns:version",
        "subject": "sns/message/status",
        "target": "cloud"
      }
    }
  }
  ```<a name="connector-component-legacy-subscription-router-dependency-replace"></a>
  + *region*Sustitúyalo por el Región de AWS que utilice.
  + *version*Sustitúyala por la versión de la función Lambda que ejecuta este componente. Para encontrar la versión de la función de Lambda, debe ver la receta de la versión de este componente que desee implementar. Abra la página de detalles de este componente en la [consola de AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) y busque el par clave-valor de la **función de Lambda**. Este par clave-valor contiene el nombre y la versión de la función de Lambda.

**importante**  <a name="connector-component-legacy-subscription-router-dependency-note"></a>
Debe actualizar la versión de la función de Lambda en el enrutador de suscripción antiguo cada vez que implemente este componente. Esto garantiza que utilice la versión correcta de la función de Lambda para la versión del componente que implemente.

------

  <a name="connector-component-create-deployments"></a>Para obtener más información, consulte [Crear implementaciones](create-deployments.md).
+ Se admite la ejecución del componente Amazon SNS en una VPC. Para implementar este componente en una VPC, se requiere lo siguiente.
  + El componente Amazon SNS debe tener una conectividad con `sns.region.amazonaws.com` que tenga el punto de conexión de VPC de `com.amazonaws.us-east-1.sns`.

### Puntos de conexión y puertos
<a name="sns-component-endpoints"></a>

Este componente debe poder realizar solicitudes salientes a los siguientes puntos de conexión y puertos, además de a los puntos de conexión y puertos necesarios para el funcionamiento básico. Para obtener más información, consulte [Cómo permitir el tráfico del dispositivo a través de un proxy o firewall](allow-device-traffic.md).


| punto de enlace | Puerto | Obligatorio | Description (Descripción) | 
| --- | --- | --- | --- | 
|  `sns.region.amazonaws.com`  | 443 | Sí |  Publicar mensajes en Amazon SNS.  | 

## Dependencias
<a name="sns-component-dependencies"></a>

Al implementar un componente, AWS IoT Greengrass también despliega versiones compatibles de sus dependencias. Esto significa que debe cumplir los requisitos del componente y de todas sus dependencias para poder implementar el componente correctamente. En esta sección, se enumeran las dependencias de las [versiones publicadas](#sns-component-changelog) de este componente y las restricciones de las versiones semánticas que definen las versiones de los componentes para cada dependencia. También puede ver las dependencias de cada versión del componente en la [consola de AWS IoT Greengrass](https://console.aws.amazon.com//greengrass). En la página de detalles del componente, busque la lista de **Dependencias**.

------
#### [ 2.1.10 ]

En la siguiente tabla, se muestran las dependencias de la versión 2.1.10 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.16.0  | Rígido | 
| [Lanzador de Lambda](lambda-launcher-component.md) | ^2.0.0  | Rígido | 
| [Tiempos de ejecución de Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flexible | 
| [Servicio de intercambio de token](token-exchange-service-component.md) | ^2.0.0  | Rígido | 

------
#### [ 2.1.9 ]

En la siguiente tabla, se muestran las dependencias de la versión 2.1.9 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.0.0 =2.0.0 <2.15.0  | Rígido | 
| [Lanzador de Lambda](lambda-launcher-component.md) | ^2.0.0  | Rígido | 
| [Tiempos de ejecución de Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flexible | 
| [Servicio de intercambio de token](token-exchange-service-component.md) | ^2.0.0  | Rígido | 

------
#### [ 2.1.8 ]

En la siguiente tabla, se muestran las dependencias de la versión 2.1.8 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.14.0  | Rígido | 
| [Lanzador de Lambda](lambda-launcher-component.md) | ^2.0.0  | Rígido | 
| [Tiempos de ejecución de Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flexible | 
| [Servicio de intercambio de token](token-exchange-service-component.md) | ^2.0.0  | Rígido | 

------
#### [ 2.1.7 ]

En la siguiente tabla, se muestran las dependencias de la versión 2.1.7 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0  | Rígido | 
| [Lanzador de Lambda](lambda-launcher-component.md) | ^2.0.0  | Rígido | 
| [Tiempos de ejecución de Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flexible | 
| [Servicio de intercambio de token](token-exchange-service-component.md) | ^2.0.0  | Rígido | 

------
#### [ 2.1.6 ]

En la siguiente tabla, se muestran las dependencias de la versión 2.1.6 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0  | Rígido | 
| [Lanzador de Lambda](lambda-launcher-component.md) | ^2.0.0  | Rígido | 
| [Tiempos de ejecución de Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flexible | 
| [Servicio de intercambio de token](token-exchange-service-component.md) | ^2.0.0  | Rígido | 

------
#### [ 2.1.5 ]

En la siguiente tabla, se muestran las dependencias de la versión 2.1.5 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0  | Rígido | 
| [Lanzador de Lambda](lambda-launcher-component.md) | ^2.0.0  | Rígido | 
| [Tiempos de ejecución de Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flexible | 
| [Servicio de intercambio de token](token-exchange-service-component.md) | ^2.0.0  | Rígido | 

------
#### [ 2.1.4 ]

En la siguiente tabla, se muestran las dependencias de la versión 2.1.4 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0  | Rígido | 
| [Lanzador de Lambda](lambda-launcher-component.md) | ^2.0.0  | Rígido | 
| [Tiempos de ejecución de Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flexible | 
| [Servicio de intercambio de token](token-exchange-service-component.md) | ^2.0.0  | Rígido | 

------
#### [ 2.1.3 ]

En la siguiente tabla, se muestran las dependencias de la versión 2.1.3 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0  | Rígido | 
| [Lanzador de Lambda](lambda-launcher-component.md) | ^2.0.0  | Rígido | 
| [Tiempos de ejecución de Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flexible | 
| [Servicio de intercambio de token](token-exchange-service-component.md) | ^2.0.0  | Rígido | 

------
#### [ 2.1.2 ]

En la siguiente tabla, se muestran las dependencias de la versión 2.1.2 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0  | Rígido | 
| [Lanzador de Lambda](lambda-launcher-component.md) | ^2.0.0  | Rígido | 
| [Tiempos de ejecución de Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flexible | 
| [Servicio de intercambio de token](token-exchange-service-component.md) | ^2.0.0  | Rígido | 

------
#### [ 2.1.1 ]

En la siguiente tabla, se muestran las dependencias de la versión 2.1.1 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0  | Rígido | 
| [Lanzador de Lambda](lambda-launcher-component.md) | ^2.0.0  | Rígido | 
| [Tiempos de ejecución de Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flexible | 
| [Servicio de intercambio de token](token-exchange-service-component.md) | ^2.0.0  | Rígido | 

------
#### [ 2.0.8 - 2.1.0 ]

En la siguiente tabla, se muestran las dependencias de las versiones 2.0.8 y 2.1.0 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0  | Rígido | 
| [Lanzador de Lambda](lambda-launcher-component.md) | ^2.0.0  | Rígido | 
| [Tiempos de ejecución de Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flexible | 
| [Servicio de intercambio de token](token-exchange-service-component.md) | ^2.0.0  | Rígido | 

------
#### [ 2.0.7 ]

En la siguiente tabla, se muestran las dependencias de la versión 2.0.7 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0  | Rígido | 
| [Lanzador de Lambda](lambda-launcher-component.md) | ^2.0.0  | Rígido | 
| [Tiempos de ejecución de Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flexible | 
| [Servicio de intercambio de token](token-exchange-service-component.md) | ^2.0.0  | Rígido | 

------
#### [ 2.0.6 ]

En la siguiente tabla, se muestran las dependencias de la versión 2.0.6 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0  | Rígido | 
| [Lanzador de Lambda](lambda-launcher-component.md) | ^2.0.0  | Rígido | 
| [Tiempos de ejecución de Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flexible | 
| [Servicio de intercambio de token](token-exchange-service-component.md) | ^2.0.0  | Rígido | 

------
#### [ 2.0.5 ]

En la siguiente tabla, se muestran las dependencias de la versión 2.0.5 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0  | Rígido | 
| [Lanzador de Lambda](lambda-launcher-component.md) | ^2.0.0  | Rígido | 
| [Tiempos de ejecución de Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flexible | 
| [Servicio de intercambio de token](token-exchange-service-component.md) | ^2.0.0  | Rígido | 

------
#### [ 2.0.4 ]

En la siguiente tabla, se muestran las dependencias de la versión 2.0.4 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0  | Rígido | 
| [Lanzador de Lambda](lambda-launcher-component.md) | ^2.0.0  | Rígido | 
| [Tiempos de ejecución de Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flexible | 
| [Servicio de intercambio de token](token-exchange-service-component.md) | ^2.0.0  | Rígido | 

------
#### [ 2.0.3 ]

En la siguiente tabla, se muestran las dependencias de la versión 2.0.3 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0  | Rígido | 
| [Lanzador de Lambda](lambda-launcher-component.md) | >=1.0.0  | Rígido | 
| [Tiempos de ejecución de Lambda](lambda-runtimes-component.md) | >=1.0.0  | Flexible | 
| [Servicio de intercambio de token](token-exchange-service-component.md) | >=1.0.0  | Rígido | 

------

Para obtener más información sobre las dependencias del componente, consulte la [referencia de receta de componentes](component-recipe-reference.md#recipe-reference-component-dependencies).

## Configuración
<a name="sns-component-configuration"></a>

Este componente ofrece los siguientes parámetros de configuración que puede personalizar cuando implemente el componente.

**nota**  <a name="connector-component-lambda-parameters"></a>
La configuración predeterminada de este componente incluye los parámetros de la función de Lambda. Le recomendamos que edite solo los siguientes parámetros para configurar este componente en sus dispositivos.

`lambdaParams`  
Un objeto que contiene los parámetros de la función de Lambda de este componente. Este objeto contiene la siguiente información:    
`EnvironmentVariables`  
Un objeto que contiene los parámetros de la función de Lambda. Este objeto contiene la siguiente información:    
`DEFAULT_SNS_ARN`  
El ARN del tema predeterminado de Amazon SNS en el que este componente publica los mensajes. Puede anular el tema de destino con la propiedad `sns_topic_arn` en la carga útil de mensajes de entrada.

`containerMode`  <a name="connector-component-container-mode-parameter"></a>
(Opcional) El modo de almacenamiento en contenedores de este componente. Puede elegir entre las siguientes opciones:  <a name="lambda-function-component-container-mode-parameter"></a>
+ `NoContainer`: el componente no se ejecuta en un entorno de tiempo de ejecución aislado.
+ `GreengrassContainer`— El componente se ejecuta en un entorno de ejecución aislado dentro del contenedor. AWS IoT Greengrass 
Valor predeterminado: `GreengrassContainer`

`containerParams`  
<a name="connector-component-container-params-description"></a>(Opcional) Un objeto que contiene los parámetros de contenedor de este componente. El componente utiliza estos parámetros si se especifica `GreengrassContainer` para `containerMode`.  
Este objeto contiene la siguiente información:    
`memorySize`  
<a name="connector-component-container-params-memory-size-description"></a>(Opcional) La cantidad de memoria (en kilobytes) que se va a asignar al componente.  
Predeterminado de 512 MB (525 312 KB).

`pubsubTopics`  <a name="connector-component-pubsub-topics-parameter"></a>
(Opcional) Un objeto que contiene los temas a los que el componente se suscribe para recibir mensajes. Puede especificar cada tema y si el componente se suscribe a temas de MQTT AWS IoT Core o a temas locales publish/subscribe .  
Este objeto contiene la siguiente información:    
`0`: se trata de un índice de matriz en forma de cadena.  
Un objeto que contiene la siguiente información:    
`type`  
(Opcional) El tipo de publish/subscribe mensajes que utiliza este componente para suscribirse a los mensajes. Puede elegir entre las siguientes opciones:  
+ `PUB_SUB` — Suscribirse a la mensajería de publicación/suscripción local. Si elige esta opción, el tema no podrá contener caracteres comodín de MQTT. Para obtener más información sobre cómo enviar mensajes desde un componente personalizado cuando especifique esta opción, consulte [Publicar/suscribir mensajes locales](ipc-publish-subscribe.md).
+ `IOT_CORE`— Suscríbase a los mensajes de AWS IoT Core MQTT. Si elige esta opción, el tema puede contener caracteres comodín de MQTT. Para obtener más información sobre cómo enviar mensajes desde componentes personalizados cuando especifique esta opción, consulte [Publicar/suscribir mensajes MQTT AWS IoT Core](ipc-iot-core-mqtt.md).
Valor predeterminado: `PUB_SUB`  
`topic`  
(Opcional) El tema al que se suscribe el componente para recibir mensajes. Si especifica `IotCore` para `type`, puede usar los comodines de MQTT (`+` y `#`) en este tema.

**Example Ejemplo: actualización de la combinación de configuraciones (modo en contenedor)**  

```
{
  "lambdaExecutionParameters": {
    "EnvironmentVariables": {
      "DEFAULT_SNS_ARN": "arn:aws:sns:us-west-2:123456789012:mytopic"
    }
  },
  "containerMode": "GreengrassContainer"
}
```

**Example Ejemplo: actualización de la combinación de configuraciones (modo sin contenedor)**  

```
{
  "lambdaExecutionParameters": {
    "EnvironmentVariables": {
      "DEFAULT_SNS_ARN": "arn:aws:sns:us-west-2:123456789012:mytopic"
    }
  },
  "containerMode": "NoContainer"
}
```

## Datos de entrada
<a name="sns-component-input-data"></a>

Este componente acepta mensajes sobre el siguiente tema y publica el mensaje tal cual en el tema de Amazon SNS de destino. <a name="connector-component-local-publish"></a>De forma predeterminada, este componente se suscribe a los mensajes locales publish/subscribe . Para obtener más información sobre cómo publicar mensajes en este componente desde sus componentes personalizados, consulte [Publicar/suscribir mensajes locales](ipc-publish-subscribe.md). 

**Tema predeterminado (publicación/suscripción local):** `sns/message`

<a name="connector-component-input-properties"></a>El mensaje acepta las siguientes propiedades. Los mensajes de entrada deben tener un formato JSON válido.

`request`  
Información sobre los mensajes que se envían al tema de Amazon SNS.  
Tipo: `object` que contiene la siguiente información:    
`message`  
El contenido del mensaje como una cadena.  
Para enviar un objeto JSON, serialícelo como una cadena y especifique `json` para la propiedad `message_structure`.  
Tipo: `string`  
`subject`  
(Opcional) El asunto del mensaje.  
Tipo: `string`  
El asunto puede ser texto ASCII y tener hasta 100 caracteres. Debe empezar por una letra, un número o un signo de puntuación. No debe incluir saltos de línea ni caracteres de control.  
`sns_topic_arn`  
(Opcional) El ARN del tema de Amazon SNS en el que este componente publica los mensajes. Especifique esta propiedad para anular el tema predeterminado de Amazon SNS.  
Tipo: `string`  
`message_structure`  
(Opcional) La estructura del mensaje. Especifique `json` que se envíe un mensaje JSON que se serialice como una cadena en la propiedad `content`.  
Tipo: `string`  
Valores válidos: `json`

`id`  <a name="connector-component-input-property-id"></a>
Un ID arbitrario para la solicitud. Use esta propiedad para asignar una solicitud de entrada a una respuesta de salida. Si especifica esta propiedad, el componente establece la propiedad `id` en el objeto de respuesta para este valor.  
Tipo: `string`

**nota**  
El tamaño del mensaje puede ser de 256 KB como máximo.

**Example Ejemplo de entrada: mensaje en cadena**  

```
{
  "request": {
    "subject": "Message subject",
    "message": "Message data",
    "sns_topic_arn": "arn:aws:sns:region:account-id:topic2-name"
  },
  "id": "request123"
}
```

**Example Ejemplo de entrada: mensaje JSON**  

```
{
  "request": {
    "subject": "Message subject",
    "message": "{ \"default\": \"Message data\" }",
    "message_structure": "json"
  },
  "id": "request123"
}
```

## Datos de salida
<a name="sns-component-output-data"></a>

 <a name="connector-component-output-data"></a>Este componente publica las respuestas como datos de salida sobre el siguiente tema MQTT de forma predeterminada. Debe especificar este tema como parte de `subject` en la configuración del [componente antiguo del enrutador de suscripciones](legacy-subscription-router-component.md). Para obtener más información sobre cómo suscribirse a los mensajes sobre este tema en sus componentes personalizados, consulte [Publicar/suscribir mensajes MQTT AWS IoT Core](ipc-iot-core-mqtt.md). 

**Tema predeterminado (AWS IoT Core MQTT):** `sns/message/status`

**Example Ejemplo de salida: Correcto**  

```
{
  "response": {
    "sns_message_id": "f80a81bc-f44c-56f2-a0f0-d5af6a727c8a",
    "status": "success"
  },
  "id": "request123"
}
```

**Example Ejemplo de salida: Error**  

```
{
  "response" : {
    "error": "InvalidInputException",
    "error_message": "SNS Topic Arn is invalid",
    "status": "fail"
  },
  "id": "request123"
}
```

## Archivo de registro local
<a name="sns-component-log-file"></a>

Este componente usa el siguiente archivo de registro.

```
/greengrass/v2/logs/aws.greengrass.SNS.log
```

**Visualización de los registros de este componente**
+ Ejecute el siguiente comando en el dispositivo de núcleo para ver el archivo de registro de este componente en tiempo real. `/greengrass/v2`Sustitúyalo por la ruta a la carpeta AWS IoT Greengrass raíz.

  ```
  sudo tail -f /greengrass/v2/logs/aws.greengrass.SNS.log
  ```

## Licencias
<a name="sns-component-licenses"></a>

Este componente incluye las siguientes licencias o software de terceros:<a name="boto-3-licenses"></a>
+ [AWS SDK para Python (Boto3)](https://pypi.org/project/boto3/)/Apache License 2.0
+ [botocore](https://pypi.org/project/botocore/)/Apache License 2.0
+ [dateutil](https://pypi.org/project/python-dateutil/1.4/)/PSF License
+ [docutils](https://pypi.org/project/docutils/)/BSD License, GNU General Public License (GPL), Python Software Foundation License, Public Domain
+ [jmespath](https://pypi.org/project/jmespath/)/MIT License
+ [s3transfer](https://pypi.org/project/s3transfer/)/Apache License 2.0
+ [urllib3](https://pypi.org/project/urllib3/)/MIT License

<a name="component-core-software-license"></a>Este conector se publica en el [Contrato de Licencia de Software de Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf).

## Registros de cambios
<a name="sns-component-changelog"></a>

En la siguiente tabla, se describen los cambios en cada versión del componente.


|  **Versión**  |  **Cambios**  | 
| --- | --- | 
|  2.1.10  | Versión actualizada para la versión 2.15.0 de Greengrass nucleus. | 
|  2.1.9  | Versión actualizada para la versión 2.14.0 de Greengrass nucleus. | 
|  2.1.8  | Versión actualizada para el lanzamiento de la versión 2.13.0 del núcleo de Greengrass. | 
|  2.1.7  | Versión actualizada para el lanzamiento de la versión 2.12.0 del núcleo de Greengrass. | 
|  2.1.6  | Versión actualizada para el lanzamiento de la versión 2.11.0 del núcleo de Greengrass. | 
|  2.1.5  | Versión actualizada para el lanzamiento de la versión 2.10.0 del núcleo de Greengrass. | 
|  2.1.4  | Versión actualizada para el lanzamiento de la versión 2.9.0 del núcleo de Greengrass. | 
|  2.1.3  | Versión actualizada para el lanzamiento de la versión 2.8.0 del núcleo de Greengrass. | 
|  2.1.2  |  Versión actualizada para el lanzamiento de la versión 2.7.0 del núcleo de Greengrass.  | 
|  2.1.1  |  Versión actualizada para el lanzamiento de la versión 2.6.0 del núcleo de Greengrass.  | 
|  2.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/sns-component.html)  | 
|  2.0.8  |  Versión actualizada para el lanzamiento de la versión 2.5.0 del núcleo de Greengrass.  | 
|  2.0.7  |  Versión actualizada para el lanzamiento de la versión 2.4.0 del núcleo de Greengrass.  | 
|  2.0.6  |  Versión actualizada para el lanzamiento de la versión 2.3.0 del núcleo de Greengrass.  | 
|  2.0.5  |  Versión actualizada para el lanzamiento de la versión 2.2.0 del núcleo de Greengrass.  | 
|  2.0.4  |  Versión actualizada para el lanzamiento de la versión 2.1.0 del núcleo de Greengrass.  | 
|  2.0.3  |  Versión inicial.  |