AWS Cloud9 não está mais disponível para novos clientes. Os clientes atuais do AWS Cloud9 podem continuar usando o serviço normalmente. [Saiba mais](https://aws.amazon.com/blogs/devops/how-to-migrate-from-aws-cloud9-to-aws-ide-toolkits-or-aws-cloudshell/)
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á.
# Trabalhando com AWS IoT no AWS Cloud9 IDE
Com AWS IoT o AWS Cloud9 IDE, você pode interagir com o AWS IoT serviço enquanto minimiza as interrupções no fluxo de trabalho em. AWS Cloud9 Este guia explica como você pode começar a usar os recursos de AWS IoT serviço que estão disponíveis no AWS Cloud9 IDE. Para obter mais informações, consulte [O que é o AWS IoT?](https://docs.aws.amazon.com/iot/latest/developerguide/what-is-aws-iot.html) no *Guia do desenvolvedor do AWS IoT *.
## AWS IoT pré-requisitos
Para começar a usar AWS IoT no AWS Cloud9 IDE, certifique-se de que sua AWS Cloud9 configuração Conta da AWS e configuração atendam a todos os requisitos. Para obter informações sobre os Conta da AWS requisitos e as permissões de AWS usuário específicos do AWS IoT serviço, consulte [Introdução ao AWS IoT Core](https://docs.aws.amazon.com/iot/latest/developerguide/setting-up.html) no *Guia do AWS IoT desenvolvedor*.
## AWS IoT Coisas
AWS IoT conecta dispositivos Serviços da AWS e AWS recursos. Você pode conectar seus dispositivos AWS IoT usando objetos chamados **coisas**. Um item é uma representação de um dispositivo específico ou entidade lógica. Ela pode ser um dispositivo físico ou sensor (por exemplo, uma lâmpada ou um interruptor em uma parede). Para obter mais informações sobre AWS IoT coisas, consulte [Gerenciando dispositivos AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-thing-management.html) no *Guia do AWS IoT desenvolvedor*.
### Gerenciando AWS IoT coisas
O AWS Cloud9 IDE tem vários recursos que tornam o gerenciamento de suas coisas eficiente. Para gerenciar suas AWS IoT coisas, siga estas etapas:
+ [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)
**Como criar uma coisa**
1. No AWS Explorer, expanda a seção de serviços de **IoT**.
1. Abra o menu de contexto (clique com o botão direito do mouse) da **coisa** e selecione **Create Thing** (Criar coisa).
1. Digite um nome para a **coisa** no campo **Thing Name** (Nome da coisa) e siga as instruções.
1. Quando essa etapa for concluída, um **ícone de coisa** seguido pelo nome que você especificou ficará visível na seção **Thing** (Coisa).
**Como anexar um certificado a uma coisa**
1. No AWS Explorer, expanda a seção de serviços de **IoT**.
1. Na subseção **Things** (Coisas), localize a **coisa** à qual você está anexando o certificado.
1. Abra o menu de contexto (clique com o botão direito) da **coisa** e selecione **Attach Certificate** (Anexar certificado) no menu de contexto, para abrir um seletor de entrada com uma lista de seus certificados.
1. Na lista, selecione o **ID do certificado** correspondente ao certificado que você deseja anexar à sua coisa.
1. Depois de concluir essa etapa, seu certificado estará acessível no AWS Explorer como um item da coisa à qual você o anexou.
**Como desanexar um certificado de uma coisa**
1. No AWS Explorer, expanda a seção de serviços de **IoT**.
1. Na subseção **Things** (Coisas), localize a **coisa** da qual você deseja desanexar um certificado.
1. Abra o menu de contexto (clique com o botão direito do mouse) da **coisa** e selecione **Attach Certificate** (Anexar certificado).
1. Depois que essa etapa for concluída, o certificado separado não será mais exibido abaixo do item no AWS Explorer. No entanto, ele ainda pode ser acessado na subseção **Certificates** (Certificados).
**Como excluir uma coisa**
1. No AWS Explorer, expanda a seção de serviços de **IoT**.
1. Na subseção **Things** (Coisas), localize a **coisa** que você deseja excluir.
1. Abra o menu de contexto (clique com o botão direito do mouse) da **coisa** e selecione **Delete Thing** (Excluir coisa).
1. Depois de concluir essa etapa, a **coisa** excluída não estará mais disponível na subseção **Things** (Coisas).
**nota**
Você só pode excluir uma coisa que não tenha um certificado anexado.
## AWS IoT certificados
Os certificados são uma forma comum de criar uma conexão segura entre seus serviços e dispositivos de AWS IoT . Os certificados X.509 são certificados digitais que usam a infraestrutura de chave pública X.509 padrão para associar uma chave pública a uma identidade contida em um certificado. Para obter mais informações sobre AWS IoT certificados, consulte [Autenticação (IoT)](https://docs.aws.amazon.com/iot/latest/developerguide/authentication.html) no Guia do *AWS IoT desenvolvedor*.
### Gerenciar certificados
O AWS kit de ferramentas oferece várias maneiras de gerenciar seus AWS IoT certificados diretamente do AWS Explorer. Eles são descritos nas seguintes etapas:
+ [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)
**Para criar um AWS IoT certificado**
Um certificado X.509 é usado para se conectar à sua instância do. AWS IoT
1. **No AWS Explorer, expanda a seção de serviços de **IoT** e abra (clique com o botão direito do mouse) Certificados.**
1. Para abrir uma caixa de diálogo, selecione **Create Certificate** (Criar certificado) no menu de contexto.
1. Para salvar seu par de chaves RSA e o certificado X.509, selecione um diretório em seu sistema de arquivos local.
**nota**
Os nomes de arquivo padrão contêm o ID do certificado como prefixo.
Somente o certificado X.509 é armazenado com o seu Conta da AWS, por meio do AWS IoT serviço.
Seu par de chaves RSA só pode ser emitido uma vez, salve-o em um local seguro em seu sistema de arquivos quando solicitado.
Se o certificado ou o par de chaves não puderem ser salvos em seu sistema de arquivos, o AWS Toolkit excluirá o certificado do seu. Conta da AWS
**Como modificar o status de um certificado**
O status de um certificado individual é exibido ao lado da ID do certificado no AWS Explorer e pode ser definido como **ativo**, **inativo** ou **revogado**.
**nota**
Seu certificado precisa de um status **ativo** antes que você possa usá-lo para conectar seu dispositivo ao seu AWS IoT serviço.
Um certificado **inativo** pode ser ativado, independentemente de ter sido desativado anteriormente ou estar inativo por padrão.
Um certificado que foi **revogado** não pode ser reativado.
1. No AWS Explorer, expanda a seção de serviços de **IoT**.
1. Na subseção **Certificates** (Certificados), localize o certificado que você deseja modificar.
1. Abra o menu de contexto (clique com o botão direito do mouse) do certificado que exibe as opções de alteração de status disponíveis para esse certificado.
+ Se um certificado tiver o status **inativo**, selecione **activate** (ativar) para alterar o status para **ativo**.
+ Se um certificado tiver o status **ativo**, selecione **deactivate** (desativar) para alterar o status para **inativo**.
+ Se um certificado tiver o status **ativo** ou **inativo**, selecione **revoke** (revogar) para alterar o status para **revogado**.
**nota**
Cada uma dessas ações de alteração de status estará disponível se você selecionar um certificado anexado a uma coisa enquanto estiver exibida na subseção **Things** (Coisas).
**Como anexar uma política de IoT a um certificado**
1. No AWS Explorer, expanda a seção de serviços de **IoT**.
1. Na subseção **Certificados**, localize o certificado que você deseja modificar.
1. Abra o menu de contexto (clique com o botão direito do mouse) do certificado e selecione **Anexar política** para abrir um seletor de entrada com uma lista de suas políticas disponíveis.
1. Selecione a política que você deseja anexar ao certificado.
1. Quando essa etapa for concluída, a política selecionada será adicionada ao certificado como um item de submenu.
**Como anexar uma política de IoT de um certificado**
1. No AWS Explorer, expanda a seção de serviços de **IoT**.
1. Na subseção **Certificados**, localize o certificado que você deseja modificar.
1. Expanda o certificado e localize a política que você deseja desanexar.
1. Abra o menu de contexto (clique com o botão direito do mouse) da política e selecione **Detach** (Desanexar) no menu de contexto.
1. Quando essa etapa for concluída, a política não estará mais acessível em seu certificado, ela estará disponível na subseção **Policy** (Política).
**Para excluir um certificado**
1. No AWS Explorer, expanda o título do serviço de **IoT**.
1. Na subseção **Certificates** (Certificados), localize o certificado que você deseja excluir.
1. Abra o menu de contexto (clique com o botão direito do mouse) do certificado e selecione **Delete Certificate** (Excluir certificado) no menu de contexto.
**nota**
Não será possível excluir um certificado se ele estiver anexado a uma coisa ou tiver um status ativo. Você pode excluir um certificado que tenha políticas anexadas.
## AWS IoT políticas
AWS IoT As políticas principais são definidas por meio de documentos JSON. Cada uma deve incluir pelo menos uma instrução. As políticas definem como AWS IoT AWS, e seus dispositivos podem interagir uns com os outros. Para obter mais informações sobre como criar um documento de política, consulte [IoT Polices](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html) (Políticas de IoT) no *Guia do desenvolvedor de AWS IoT *.
**nota**
As políticas nomeadas são versionadas para que você possa revertê-las. No AWS Explorer, suas políticas de IoT estão listadas na subseção **Políticas do** serviço. AWS IoT Você pode visualizar as versões da política expandindo uma política. A versão padrão é indicada por um asterisco (\$1).
### Gerenciamento de políticas
O AWS Cloud9 IDE oferece várias maneiras de gerenciar suas políticas AWS IoT de serviço. Essas são as maneiras pelas quais você pode gerenciar ou modificar suas políticas diretamente do AWS Explorer no 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)
**Para criar uma AWS IoT política**
**nota**
Você pode criar uma nova política a partir do AWS Explorer. No entanto, o documento JSON que define a política já deve existir em seu sistema de arquivos.
1. No AWS Explorer, expanda a seção de serviços de **IoT**.
1. Abra o menu de contexto (clique com o botão direito) da subseção **Policies** (Políticas) e, para abrir o campo de entrada **Policy Name** (Nome da política), selecione **Create Policy from Document** (Criar política a partir do documento).
1. Digite um nome e siga as instruções para abrir uma caixa de diálogo solicitando que você selecione um documento JSON do seu sistema de arquivos.
1. Selecione o arquivo JSON que contém suas definições de política. A política estará disponível no AWS Explorer após a conclusão.
**Para carregar uma nova versão AWS IoT da política**
Você pode criar uma versão de uma política fazendo upload de um documento JSON para a política.
**nota**
O novo documento JSON deve estar presente em seu sistema de arquivos para criar uma nova versão usando o AWS Explorer.
1. No AWS Explorer, expanda a seção de serviços de **IoT**.
1. Expanda a subseção **Policies** (Políticas) para ver suas políticas de AWS IoT .
1. Abra o menu de contexto (clique com o botão direito do mouse) da política que você deseja atualizar e selecione **Create new version from Document** (Criar versão do documento).
1. Quando a caixa de diálogo for aberta, selecione o arquivo JSON que contém as atualizações de suas definições de política.
A nova versão pode ser acessada a partir de sua política no AWS Explorer.
**Para editar uma versão AWS IoT da política**
Você pode abrir e editar um documento de política usando AWS Cloud9 o. Ao terminar de editar o documento, salve-o em seu sistema de arquivos. Em seguida, faça o upload para o seu AWS IoT serviço a partir do AWS Explorer.
1. No AWS Explorer, expanda a seção de serviços de **IoT**.
1. Expanda a subseção **Policies** (Políticas) e localize a política que você deseja atualizar.
1. Para abrir o **Policy Name** (Nome da política), selecione **Create Policy** (Criar política) no **Document** (Documento).
1. Expanda a política que você deseja atualizar e abra o menu de contexto (clique com o botão direito do mouse) da versão da política que você deseja editar.
1. Para abrir a versão da política em AWS Cloud9, escolha **Exibir** no menu de contexto para abrir a versão da política.
1. Quando o documento de política for aberto, edite e salve as alterações.
**nota**
Nesse momento, as alterações feitas na política são salvas somente no sistema de arquivos local. Para atualizar a versão e rastreá-la com o AWS Explorer, repita as etapas em[Upload a new policy version](#policy-version-upload).
**Como selecionar uma nova versão da política como padrão**
1. No AWS Explorer, expanda a seção de serviços de **IoT**.
1. Expanda a subseção **Policies** (Políticas) e localize a política que você deseja atualizar.
1. Expanda a política que você deseja atualizar e abra o menu de contexto (clique com o botão direito do mouse) da versão da política que você deseja definir e selecione **Set as Default** (Definir como padrão).
Depois de terminar esse procedimento, a nova versão padrão que você selecionou terá uma estrela ao lado dela.
**Para excluir políticas do**
**nota**
Antes de excluir uma política ou uma versão da política, as seguintes condições devem ser atendidas:
Não será possível excluir uma política se ela estiver anexada a um certificado.
Você não poderá excluir uma política se ela tiver alguma versão não padrão.
Você só poderá excluir a versão padrão de uma política se uma nova versão padrão for selecionada ou se toda a política for excluída.
Antes de excluir uma política inteira, você deve excluir toda a versão não padrão dessa mesma política.
1. No AWS Explorer, expanda a seção de serviços de **IoT**.
1. Expanda a subseção **Policies** (Políticas) e localize a política que você deseja atualizar.
1. Expanda a política que você deseja atualizar e abra o menu de contexto (clique com o botão direito do mouse) da versão da política que você deseja excluir e selecione **Delete** (Excluir).
1. Quando uma versão é excluída, ela não fica mais visível no AWS Explorer.
1. Se apenas a versão padrão de uma política for mantida, abra o menu de contexto (clique com o botão direito do mouse) da política principal e selecione **Delete** (Excluir).