

 AWS Cloud9 ya no está disponible para nuevos clientes. Los clientes existentes de AWS Cloud9 pueden seguir utilizando el servicio con normalidad. [Más información](https://aws.amazon.com/blogs/devops/how-to-migrate-from-aws-cloud9-to-aws-ide-toolkits-or-aws-cloudshell/)

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.

# Trabajando con AWS IoT un AWS Cloud9 IDE
<a name="iot-start"></a>

Con AWS IoT el AWS Cloud9 IDE, puede interactuar con el AWS IoT servicio y, al mismo tiempo, minimizar las interrupciones en AWS Cloud9 su flujo de trabajo. Esta guía explica cómo puede empezar a utilizar las funciones del AWS IoT servicio que están disponibles en el AWS Cloud9 IDE. Para obtener más información, consulte [¿Qué es AWS IoT?](https://docs.aws.amazon.com/iot/latest/developerguide/what-is-aws-iot.html) en la *Guía para desarrolladores de AWS IoT *.

## AWS IoT requisitos previos
<a name="iot-cloud9-prereq"></a>

Para empezar a utilizar AWS IoT el AWS Cloud9 IDE, asegúrese de que su AWS Cloud9 configuración Cuenta de AWS y su equipo cumplen todos los requisitos. Para obtener información sobre los Cuenta de AWS requisitos y los permisos de AWS usuario específicos del AWS IoT servicio, consulte la [sección Introducción a AWS IoT Core](https://docs.aws.amazon.com/iot/latest/developerguide/setting-up.html) en la *Guía para AWS IoT desarrolladores*.

## AWS IoT Cosas
<a name="iot-cloud9-things"></a>

AWS IoT conecta los dispositivos Servicios de AWS y AWS los recursos. Puede conectar sus dispositivos AWS IoT mediante objetos llamados **cosas**. Un objeto es una representación de un determinado dispositivo o de una entidad lógica. Puede ser un dispositivo físico o un sensor (por ejemplo, una bombilla o un interruptor en la pared). Para obtener más información sobre AWS IoT las cosas, consulta [Administrar dispositivos con AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-thing-management.html) la *Guía para AWS IoT desarrolladores*. 

### Administrar AWS IoT cosas
<a name="iot-cloud9-things-actions"></a>

El AWS Cloud9 IDE tiene varias funciones que hacen que la administración de sus cosas sea eficiente. Para gestionar tus AWS IoT cosas, sigue estos pasos: 
+ [Create a thing](#thing-create)
+ [Attach a certificate to a thing](#thing-certificate-attach)
+ [Detach a certificate from a thing](#thing-certificate-detach)
+ [Delete a thing](#thing-delete)<a name="thing-create"></a>

**Crear un objeto**

1. Desde el AWS Explorador, amplíe la sección de servicios de **IoT**.

1. Abra el menú contextual (haga clic con el botón derecho) correspondiente al **objeto** y seleccione **Create Thing** (Crear objeto).

1. Introduzca un nombre para el **objeto** en el campo **Thing Name** (Nombre de objeto) y siga las instrucciones.

1. Cuando complete este paso, aparecerá un **icono de objeto** seguido del nombre que ha especificado que sea visible en la sección **Thing** (Objeto).<a name="thing-certificate-attach"></a>

**Para asociar un certificado a un objeto**

1. Desde el AWS Explorador, amplíe la sección de servicios de **IoT**.

1. En la subsección **Things** (Objetos), busque el **objeto** al que va a adjuntar el certificado. 

1. Abra el menú contextual (haga clic con el botón derecho) del **objeto** y elija **Attach Certificate** (Adjuntar certificado) para abrir un selector de entrada con una lista de certificados.

1. En la lista, elija el **ID de certificado** que corresponda al que desea adjuntar a su objeto.

1. Una vez completado este paso, su certificado estará accesible en el Explorador de AWS como un elemento del objeto al que lo haya adjuntado.<a name="thing-certificate-detach"></a>

**Para desasociar un certificado de un objeto**

1. Desde el AWS Explorador, amplíe la sección de servicios de **IoT**.

1. En la subsección **Things** (Objetos), localice el **objeto** del que desea desasociar un certificado. 

1. Abra el menú contextual (haga clic con el botón derecho) correspondiente al **objeto** y elija **Attach Certificate** (Asociar certificado).

1. Una vez completado este paso, el certificado asociado ya no se muestra debajo del objeto en el AWS Explorador. Sin embargo, aún se podrá acceder a él desde la subsección **Certificates** (Certificados).<a name="thing-delete"></a>

**Para eliminar un objeto**

1. Desde el AWS Explorador, amplíe la sección de servicios de **IoT**.

1. En la subsección **Things** (Objetos), localice el **objeto** que desea eliminar.

1. Abra el menú contextual (haga clic con el botón derecho) correspondiente al **objeto** y elija **Delete Thing** (Eliminar objeto).

1. Una vez completado este paso, el **objeto** eliminado ya no estará disponible en la subsección **Things** (Objetos).
**nota**  
Solo puede eliminar un objeto que no tenga un certificado asociado.

## AWS IoT certificados
<a name="iot-cloud9-cert"></a>

Los certificados son una forma habitual de crear una conexión segura entre sus servicios de AWS IoT y sus dispositivos. Los certificados X.509 son certificados digitales que utilizan el estándar de infraestructura de clave pública X.509 para asociar una clave pública a una identidad contenida en un certificado. Para obtener más información sobre AWS IoT los certificados, consulte [Autenticación (IoT)](https://docs.aws.amazon.com/iot/latest/developerguide/authentication.html) en la *Guía para AWS IoT desarrolladores*.

### Administración de certificados
<a name="iot-cloud9-cert-actions"></a>

El AWS kit de herramientas ofrece diversas formas de gestionar los AWS IoT certificados directamente desde el AWS Explorador. Se describen en los pasos siguientes:
+ [Create a certificate](#cert-create)
+ [Change a certificate status](#cert-status)
+ [Attach a policy to a certificate](#cert-attach-policy)
+ [Delete a certificate](#cert-delete)<a name="cert-create"></a>

**Para crear un certificado AWS IoT**

Se utiliza un certificado X.509 para conectarse a la instancia de AWS IoT. 

1. Desde el AWS Explorador, expanda la sección de servicios de **IoT** y abra (haga clic con el botón derecho) en **Certificados**.

1. Para abrir un cuadro de diálogo, seleccione **Create Certificate** (Crear certificado) en el menú contextual.

1. Para guardar su par de claves RSA y certificado X.509, seleccione un directorio en su sistema de archivos local.
**nota**  
Los nombres de archivo predeterminados contienen el ID de certificado como prefijo.
A través del AWS IoT servicio, solo el certificado X.509 se almacena con usted Cuenta de AWS.
Su par de claves RSA solo puede emitirse una vez. Guárdelo en una ubicación segura de su sistema de archivos cuando se le solicite.
Si el certificado o el key pair no se pueden guardar en su sistema de archivos, el AWS kit de herramientas eliminará el certificado de su sistema. Cuenta de AWS<a name="cert-status"></a>

**Para modificar el estado de un certificado**

**El estado de un certificado individual se muestra junto al ID del certificado en el AWS Explorador y se puede configurar como **activo, **inactivo**** o revocado.**
**nota**  
El certificado debe estar **activo** antes de poder usarlo para conectar el dispositivo al AWS IoT servicio.
Un certificado **inactivo** puede activarse, tanto si se ha desactivado previamente como si está inactivo de forma predeterminada.
Un certificado que se ha **revocado** no se puede reactivar.

1. Desde el AWS Explorador, amplíe la sección de servicios de **IoT**.

1. En la subsección **Certificates** (Certificados), busque el certificado que desee modificar.

1. Abra el menú contextual (haga clic con el botón derecho) del certificado que muestra las opciones de cambio de estado disponibles para ese certificado.
+ Si un certificado tiene el estado **inactive** (inactivo), elija **activate** (activar) para cambiar el estado a **active** (activo).
+ Si un certificado tiene el estado **active** (activo), elija **deactivate** (desactivar) para cambiar el estado a **inactive** (inactivo).
+ Si un certificado tiene el estado **active** (activo) o **inactive** (inactivo), elija **revoke** (revocar) para cambiar el estado a **revoked** (revocado).

**nota**  
Puede acceder a todas estas acciones de cambio de estado seleccionando un certificado asociado a un objeto en la subsección **Things** (Objetos).<a name="cert-attach-policy"></a>

**Para asociar una política de IoT a un certificado**

1. Desde el AWS Explorador, amplíe la sección de servicios de **IoT**.

1. En la subsección **Certificates** (Certificados), busque el certificado que desee modificar.

1. Abra el menú contextual (haga clic con el botón derecho) del certificado y elija **Attach Policy** (Asociar política) para abrir un selector de entrada con una lista de políticas disponibles.

1. Elija la política que desea asociar al certificado.

1. Una vez completado este paso, la política que haya seleccionado se agregará al certificado como un elemento del submenú.<a name="cert-detach-policy"></a>

**Para desasociar una política de IoT de un certificado**

1. Desde el AWS Explorador, amplíe la sección de servicios de **IoT**.

1. En la subsección **Certificates** (Certificados), busque el certificado que desee modificar.

1. Expanda el certificado y busque la política que desee desasociar.

1. Abra el menú contextual (haga clic con el botón derecho) y elija **Detach** (Desasociar) en dicho menú.

1. Una vez completado este paso, ya no podrá acceder a la política desde su certificado, sino desde la subsección **Policy** (Política).<a name="cert-delete"></a>

**Para eliminar un certificado**

1. Desde el AWS Explorador, amplíe el encabezado de servicio de **IoT**.

1. En la subsección **Certificates** (Certificados), busque el certificado que desee eliminar.

1. Abra el menú contextual (haga clic con el botón derecho del ratón) del certificado y elija **Delete Certificate** (Eliminar certificado).
**nota**  
No puede eliminar un certificado si está asociado a un objeto o tiene un estado activo. Puede eliminar un certificado que tenga políticas asociadas.

## AWS IoT políticas
<a name="iot-vsctoolkit-policy"></a>

AWS IoT Las políticas principales se definen a través de documentos JSON. Cada uno contiene al menos una declaración de política. Las políticas definen la forma AWS IoT en que los dispositivos pueden interactuar entre sí y de qué manera. AWS Para obtener más información sobre cómo crear un documento de políticas, consulte [IoT Polices](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html) (Políticas de IoT) en la *Guía para desarrolladores de AWS IoT *.

**nota**  
Las políticas con nombre tienen una versión para que pueda revertirlas. En el AWS Explorador, sus políticas de IoT aparecen en la subsección **Políticas del** servicio. AWS IoT Puede ver las versiones de una política si la expande. La versión predeterminada se indica con un asterisco (\$1).

### Administración de políticas
<a name="iot-vsctoolkit-policy-actions"></a>

El AWS Cloud9 IDE le ofrece varias formas de gestionar sus políticas de AWS IoT servicio. Estas son las formas en las que puede administrar o modificar sus políticas directamente desde el AWS Explorador de VS Code: 
+ [Create a policy](#policy-create)
+ [Upload a new policy version](#policy-version-upload)
+ [Edit a policy version](#policy-version-edit)
+ [Change the policy version defualt](#policy-version-default)
+ [Change the policy version defualt](#policy-delete)<a name="policy-create"></a>

**Para crear una AWS IoT política**
**nota**  
Puede crear una nueva política desde el AWS Explorador. Sin embargo, el documento JSON que define la política ya debe estar en el sistema de archivos.

1. Desde el AWS Explorador, amplíe la sección de servicios de **IoT**.

1. Abra el menú contextual (haga clic con el botón derecho) de la subsección **Policies** (Políticas) y, para abrir el campo de entrada **Policy Name** (Nombre de política), elija **Create Policy from Document** (Crear política a partir de un documento).

1. Introduzca un nombre y siga las instrucciones para abrir un cuadro de diálogo que le pedirá que seleccione un documento JSON de su sistema de archivos.

1. Elija el archivo JSON que contiene las definiciones de su política. La política estará disponible en el Explorador de AWS una vez completada esta operación.<a name="policy-version-upload"></a>

**Para cargar una nueva versión AWS IoT de la política**

Puede crear una nueva versión de una política si carga un documento JSON en la política.
**nota**  
El nuevo documento JSON debe estar presente en su sistema de archivos para poder crear una nueva versión con el AWS Explorador.

1. Desde el AWS Explorador, amplíe la sección de servicios de **IoT**.

1.  Expanda la subsección **Policies** (Políticas) para ver sus políticas de AWS IoT .

1. Abra el menú contextual (haga clic con el botón derecho) de la política que desea actualizar y elija **Create new version from Document** (Crear versión nueva a partir de un documento).

1. Cuando se abra el cuadro de diálogo, elija el archivo JSON que contiene las actualizaciones de las definiciones de la política. 

   Se puede acceder a la nueva versión desde su política en el Explorador de AWS .<a name="policy-version-edit"></a>

**Para editar una versión AWS IoT de la política**

Puede abrir y editar un documento de política utilizando AWS Cloud9. Cuando termine de editar el documento, guárdelo en el sistema de archivos. A continuación, cárguelo a su AWS IoT servicio desde el AWS Explorador.

1. Desde el AWS Explorador, amplíe la sección de servicios de **IoT**.

1. Expanda la subsección **Policies** (Políticas) y localice la política que desea actualizar.

1. Para abrir el campo **Policy Name** (Nombre de política), elija **Create Policy** from **Document** (Crear política a partir de un documento).

1. Expanda la política que desea actualizar y, a continuación, abra el menú contextual (haga clic con el botón derecho) de la versión de la política que desea editar.

1. Para abrir la versión de la política AWS Cloud9, seleccione **Ver** en el menú contextual para abrir la versión de la política.

1. Cuando se abra el documento de política, edite y guarde los cambios.
**nota**  
En este momento, los cambios realizados en la política solo se guardan en el sistema de archivos local. Para actualizar la versión y realizar un seguimiento de la misma con el AWS Explorador, repita los pasos que se indican. [Upload a new policy version](#policy-version-upload)<a name="policy-version-default"></a>

**Para seleccionar una nueva versión de política (predeterminada)**

1. Desde el AWS Explorador, amplíe la sección de servicios de **IoT**.

1. Expanda la subsección **Policies** (Políticas) y localice la política que desea actualizar.

1. Expanda la política que desea actualizar y, a continuación, abra el menú contextual (haga clic con el botón derecho) de la versión de la política que desea establecer y elija **Set as Default** (Establecer como predeterminada). 

   Cuando haya terminado, la nueva versión predeterminada que ha seleccionado tendrá una estrella junto a ella.<a name="policy-delete"></a>

**Para eliminar políticas**
**nota**  
Para poder eliminar una política o una versión de ella, asegúrese de que se cumplen las siguientes condiciones:  
No puede eliminar una política si está asociada a un certificado.
No puede eliminar una política si tiene versiones distintas de las predeterminadas.
Solo puede eliminar la versión predeterminada de una política si se selecciona una nueva versión predeterminada o si se elimina la política completa.
Para poder eliminar una política completa, debe eliminar todas las versiones no predeterminadas de ella.

1. Desde el AWS Explorador, amplíe la sección de servicios de **IoT**.

1. Expanda la subsección **Policies** (Políticas) y localice la política que desea actualizar.

1. Expanda la política que desea actualizar y abra el menú contextual (haga clic con el botón derecho) de la versión de la política que desea eliminar y elija **Delete** (Eliminar).

1. Cuando se elimina una versión, deja de estar visible en el AWS Explorador.

1. Si solo queda la versión predeterminada de una política, abra el menú contextual (haga clic con el botón derecho) de la política principal y elija **Delete** (Eliminar).