

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á.

# Gerencie gateways SiteWise Edge
<a name="manage-gateways-ggv2"></a>

Você pode usar o AWS IoT SiteWise console e as operações da API para gerenciar os gateways do AWS IoT SiteWise Edge. Você também pode usar o aplicativo [AWS OpsHub for AWS IoT SiteWise for Windows para](https://aws-iot-sitewise.s3.amazonaws.com/gateway/OpsHub+for+AWS+IoT+SiteWise.exe) gerenciar alguns aspectos do gateway SiteWise Edge a partir do seu dispositivo local.

É altamente recomendável que você use o AWS IoT SiteWise aplicativo AWS OpsHub for para monitorar o uso do disco em seu dispositivo local. Você também pode monitorar as CloudWatch métricas da `Gateway.UsedPercentageDiskSpace` Amazon `Gateway.AvailableDiskSpace` e criar alarmes para ser notificado quando o espaço em disco estiver ficando baixo. Para obter mais informações sobre CloudWatch os alarmes da Amazon, consulte [Criar um CloudWatch alarme com base em um limite estático](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ConsoleAlarms.html).

Certifique-se de que seu dispositivo tenha espaço suficiente para os próximos dados. Quando você está prestes a ficar sem espaço no dispositivo local, o serviço exclui automaticamente um pequeno volume de dados com os carimbos de data/hora mais antigos para abrir espaço para os próximos dados.

Para verificar se o serviço excluiu seus dados, faça o seguinte:

1. Faça login no AWS IoT SiteWise formulário AWS OpsHub de inscrição.

1. Escolha **Configurações**.

1. Em **Logs**, especifique um intervalo de tempo e escolha **Baixar**.

1. Descompacte o arquivo de log.

1. Se o arquivo de log contiver a seguinte mensagem, o serviço excluiu seus dados: {{number}}bytes de dados foram excluídos para evitar que o armazenamento do SiteWise Edge Gateway fique sem espaço. 

## Gerencie seu gateway SiteWise Edge com o AWS IoT SiteWise console
<a name="cloud-console"></a>

Você pode usar o AWS IoT SiteWise console para configurar, atualizar e monitorar todos os gateways do SiteWise Edge em sua AWS conta. 

[Você pode visualizar seus gateways do SiteWise Edge navegando até a página **Edge Gateways** no console.AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) Para acessar a página **Detalhes do gateway de borda** de um gateway específico, escolha o nome de um gateway do Edge.

Na guia **Visão geral** da página **Detalhes do gateway de borda**, você pode fazer o seguinte:
+ Na seção **Fontes de dados**, atualize a configuração de fontes de dados e configure fontes de dados adicionais.
+ Escolha **Abrir CloudWatch métricas** para visualizar o número de pontos de dados ingeridos por fonte de dados no console de CloudWatch métricas
+ **Na seção **Recursos do Edge**, adicione pacotes de dados ao seu gateway do SiteWise Edge clicando em Editar**
+ Na seção **Configuração do gateway**, visualize o status de conectividade dos seus gateways SiteWise Edge
+ Na seção **Configuração do editor**, visualize o status de sincronização do gateway SiteWise Edge e a configuração do componente do AWS IoT SiteWise editor

Na guia **Atualizações** da página **Detalhes do gateway de borda**, você pode ver as versões atuais do componente e do pacote implantadas no gateway do Edge. Também é onde você implanta novas versões quando são disponibilizadas.

## Gerencie gateways SiteWise Edge usando AWS OpsHub para AWS IoT SiteWise
<a name="opshub-app"></a>

Você usa o AWS IoT SiteWise aplicativo AWS OpsHub for para gerenciar e monitorar seus gateways SiteWise Edge auto-hospedados. Esse aplicativo fornece as seguintes opções de monitoramento e gerenciamento:
+ Em **Visão geral**, você pode fazer o seguinte:
  + Veja os detalhes do gateway SiteWise Edge que ajudam você a obter informações sobre os dados do dispositivo do gateway SiteWise Edge, identificar problemas e melhorar o desempenho do gateway SiteWise Edge.
  + Veja SiteWise os portais do Monitor que monitoram os dados de servidores e equipamentos locais na borda. Para obter mais informações, consulte [O que é o AWS IoT SiteWise Monitor](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/what-is-monitor-app.html) no *Guia do aplicativo do AWS IoT SiteWise Monitor *.
+ Em **Health**, há um painel que exibe dados do seu gateway SiteWise Edge. Especialistas no domínio, como engenheiros de processo, podem usar o painel para ter uma visão geral do comportamento do gateway SiteWise Edge.
+ Em **Ativos**, veja os ativos implantados no dispositivo local e o último valor coletado ou calculado para propriedades de ativo.
+ Em **Configurações**, faça o seguinte:
  + Se o Pacote de Processamento de Dados estiver instalado, visualize as informações de configuração do gateway SiteWise Edge e sincronize os recursos com a AWS nuvem.
  + Baixe os arquivos de autenticação que você pode usar para acessar o gateway SiteWise Edge usando outras ferramentas. 
  + Baixe registros que você pode usar para solucionar problemas no gateway SiteWise Edge.
  + Veja os AWS IoT SiteWise componentes implantados no gateway SiteWise Edge.

**Importante**  
É necessário usar o seguinte AWS OpsHub para AWS IoT SiteWise:  
Seu dispositivo local e o AWS IoT SiteWise aplicativo AWS OpsHub for devem estar conectados à mesma rede.
O pacote de processamento de dados deve estar habilitado.

**Para gerenciar gateways SiteWise Edge usando AWS OpsHub**

1. Baixe e instale o aplicativo [AWS OpsHubAWS IoT SiteWise for for Windows](https://aws-iot-sitewise.s3.amazonaws.com/gateway/OpsHub+for+AWS+IoT+SiteWise.exe).

1. Abra o aplicativo .

1. Se você não tiver credenciais locais configuradas para o gateway, siga as etapas em [Acesse seu gateway SiteWise Edge usando as credenciais do sistema operacional local](#create-user-pool) para configurá-las.

1. Você pode entrar no seu gateway SiteWise Edge com suas credenciais Linux ou Lightweight Directory Access Protocol (LDAP). Para entrar no seu gateway SiteWise Edge, faça o seguinte:

------
#### [ Linux ]

   1. Em **Nome do host ou endereço IP**, insira o nome do host ou o endereço IP do dispositivo local.

   1. Para **Autenticação**, escolha **Linux**.

   1. Em **Nome de usuário**, insira o nome de usuário do sistema operacional Linux.

   1. Em **Senha**, insira a senha do sistema operacional Linux.

   1. Escolha **Logon**.

------
#### [ LDAP ]

   1. Em **Nome do host ou endereço IP**, insira o nome do host ou o endereço IP do dispositivo local.

   1. Para **Autenticação**, escolha **LDAP**.

   1. Em **Nome de usuário**, insira o nome de usuário do LDAP.

   1. Em **Senha**, insira a senha do LDAP.

   1. Escolha **Logon**.

------

## Acesse seu gateway SiteWise Edge usando as credenciais do sistema operacional local
<a name="create-user-pool"></a>

Além do Lightweight Directory Access Protocol (LDAP), você pode usar as credenciais do Linux ou do Windows para acessar seu gateway Edge SiteWise auto-hospedado.

**Importante**  
Para acessar seu gateway SiteWise Edge com credenciais Linux, você deve ativar o pacote de processamento de dados para seu gateway SiteWise Edge.

### Acesse seu gateway SiteWise Edge usando as credenciais do sistema operacional Linux
<a name="linux-user-pool"></a>

 Essas etapas a seguir presumem que você usa um dispositivo com Ubuntu. Se você usa uma distribuição Linux diferente, consulte a documentação relevante do seu dispositivo.

**Para criar um grupo de usuários Linux**

1. Execute um dos comandos a seguir para criar um grupo de administradores.

   ```
   sudo groupadd --system SWE_ADMIN_GROUP
   ```

   Os usuários do `SWE_ADMIN_GROUP` grupo podem permitir acesso de administrador ao gateway SiteWise Edge.

1. Execute um dos comandos a seguir para criar um grupo de usuário.

   ```
   sudo groupadd --system SWE_USER_GROUP
   ```

   Os usuários do `SWE_USER_GROUP` grupo podem permitir acesso somente de leitura ao gateway SiteWise Edge.

1. Execute o seguinte comando para adicionar um usuário ao grupo de administradores. {{password}}Substitua {{user-name}} e pelo nome de usuário e senha que você deseja adicionar.

   ```
   sudo useradd -p $(openssl passwd -1 {{password}}) {{user-name}}
   ```

1. Para adicionar um usuário a um `SWE_ADMIN_GROUP` ou`SWE_USER_GROUP`, {{user-name}} substitua pelo nome de usuário que você adicionou na etapa anterior.

   ```
   sudo usermod -a -G SWE_ADMIN_GROUP {{user-name}}
   ```

Agora você pode usar o nome de usuário e a senha para entrar no gateway SiteWise Edge no AWS IoT SiteWise aplicativo AWS OpsHub for.

### Acesse seu gateway SiteWise Edge usando as credenciais do Windows
<a name="windows-user-pool"></a>

 Essas etapas a seguir presumem que você usa um dispositivo com Windows.

**Importante**  
A segurança é uma responsabilidade compartilhada entre você AWS e você. Crie uma política de senha forte com pelo menos 12 caracteres e uma combinação de maiúscula, minúscula, números e símbolos. Além disso, defina as regras do Firewall do Windows para permitir o tráfego de entrada na porta 443 e bloquear o tráfego de entrada em todas as outras portas.

**Para criar um grupo de usuários no Windows Server**

1. Execute PowerShell como administrador.

   1. No servidor Windows em que você deseja instalar o SiteWise Edge Gateway, faça login como administrador.

   1. Entre **PowerShell**na barra de pesquisa do Windows.

   1. Nos resultados da pesquisa, clique com o botão direito do mouse no PowerShell aplicativo do Windows. Escolha **Executar como administrador**.

1. Execute um dos comandos a seguir para criar um grupo de administradores.

   ```
   net localgroup SWE_ADMIN_GROUP /add
   ```

   Você deve ser um usuário do `SWE_ADMIN_GROUP` grupo para permitir o acesso de administrador ao gateway SiteWise Edge.

1. Execute um dos comandos a seguir para criar um grupo de usuário.

   ```
   net localgroup SWE_USER_GROUP /add
   ```

   Você deve ser um usuário do `SWE_USER_GROUP` grupo para permitir acesso imediato ao gateway SiteWise Edge.

1. Execute o seguinte comando para adicionar usuário. {{password}}Substitua {{user-name}} e pelo nome de usuário e pela senha que você deseja criar.

   ```
   net user {{user-name password}} /add
   ```

1. Execute o seguinte comando para adicionar um usuário ao grupo de administradores. {{user-name}}Substitua pelo nome de usuário que você deseja adicionar.

   ```
   net localgroup SWE_ADMIN_GROUP {{user-name}} /add
   ```

Agora você pode usar o nome de usuário e a senha para entrar no gateway SiteWise Edge no AWS IoT SiteWise aplicativo AWS OpsHub for.

## Gerenciar o certificado de gateway SiteWise Edge
<a name="manage-gateway-certificate"></a>

Você pode usar o SiteWise Monitor e aplicativos de terceiros, como o Grafana, em seus dispositivos de gateway SiteWise Edge. Esses aplicativos exigem uma conexão TLS com o serviço. SiteWise Atualmente, os gateways Edge usam um certificado autoassinado. Se você usar um navegador para abrir os aplicativos, como um portal do SiteWise Monitor, poderá receber um aviso de certificado não confiável.

A seguir, mostramos como baixar o certificado confiável do AWS IoT SiteWise aplicativo AWS OpsHub for.

1. Faça login no aplicativo. 

1. Escolha **Configurações**.

1. Em **Autenticação**, escolha **Baixar certificado**.

O seguinte pressupõe que você usa o Google Chrome ou FireFox. Se você usa um outro navegador, consulte a documentação relevante do seu navegador. Para adicionar o certificado baixado na etapa anterior ao navegador, faça o seguinte:
+ Se você usa o Google Chrome, vá até [Configurar certificados](https://support.google.com/chrome/a/answer/3505249?hl=en) na *documentação de ajuda do Google Chrome Enterprise*.
+ Se você usa o Firefox, vá até [Para carregar o certificado no navegador Mozilla ou Firefox](https://docs.oracle.com/cd/E19528-01/819-4639/gaesv/index.html) na *documentação da Oracle*.

## Alterar a versão dos pacotes de componentes do SiteWise Edge Gateway
<a name="manage-gateway-update-packs"></a>

Você pode usar o AWS IoT SiteWise console para alterar a versão dos pacotes de componentes em seus gateways SiteWise Edge.

**Para alterar a versão de um pacote de componentes do SiteWise Edge Gateway**

1. Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. No painel de navegação à esquerda, escolha **Gateways**.

1. Selecione o gateway SiteWise Edge para o qual você gostaria de alterar as versões do pacote.

1. Em **Configuração do gateway**, escolha **Visualizar versões do software**.

1. Na página **Editar versões do software**, para o pacote cuja versão você quer atualizar, selecione a versão desejada e escolha **Implantar**.

1. Selecione **Concluído**.

## Listar gateways SiteWise Edge
<a name="manage-gateway-list-gateways"></a>

------
#### [ Console ]

**Para listar os gateways SiteWise do Edge**

1. <a name="sitewise-open-console"></a>Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. No painel de navegação, escolha **Gateways de borda**.

1. Veja a lista de todos os seus gateways SiteWise do Edge.

------
#### [ AWS CLI ]

Para listar seus gateways usando AWS CLI, siga estas etapas:
+ Use o comando list-gateways para visualizar todos os seus gateways:

  ```
  aws iotsitewise list-gateways
  ```

  Esse comando retorna uma lista dos seus gateways com seus IDs nomes e outras informações.

  Você também pode especificar os parâmetros de paginação:

  ```
  aws iotsitewise list-gateways --max-results {{10}} --next-token {{your-token}}
  ```

Para obter mais informações, consulte [list-gateways](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/list-gateways.html) na Referência de Comandos. AWS CLI 

------

## Descreva um gateway SiteWise Edge
<a name="manage-gateway-describe-gateway"></a>

------
#### [ Console ]

**Para ver os detalhes do gateway**

1. <a name="sitewise-open-console"></a>Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. No painel de navegação, escolha **Gateways de borda**.

1. Escolha o nome do gateway do qual você deseja ver os detalhes.

1. Veja os detalhes do gateway na página de **detalhes do gateway Edge**.

------
#### [ AWS CLI ]

Para obter informações detalhadas sobre o uso de um gateway específico AWS CLI, siga estas etapas:
+ Use o comando describe-gateway com o ID do gateway:

  ```
  aws iotsitewise describe-gateway --gateway-id {{a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE}}
  ```

  Esse comando retorna informações detalhadas sobre o gateway.

Para obter mais informações, consulte [describe-gateway](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/describe-gateway.html) na Referência de Comandos. AWS CLI 

------

## Crie um gateway SiteWise Edge
<a name="manage-gateway-create-gateway"></a>

------
#### [ Console ]

**Para criar um gateway SiteWise Edge**

1. <a name="sitewise-open-console"></a>Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. No painel de navegação, escolha **Gateways de borda**.

1. Escolha **Criar gateway**.

1. Insira um nome para seu gateway.

1. Selecione o grupo Greengrass para seu gateway.

1. Opcionalmente, adicione tags ao seu gateway.

1. Escolha **Criar**.

------
#### [ AWS CLI ]

Para criar um novo SiteWise gateway de IoT usando AWS CLI, siga estas etapas:
+ Use o comando create-gateway para criar um novo gateway:

  ```
  aws iotsitewise create-gateway \
      --gateway-name "NewSiteWiseGateway" \
      --gateway-platform '{
          "greengrass": {
              "groupArn": "arn:aws:greengrass:us-east-1:123456789012:group/a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE"
          }
      }' \
      --tags '{
          "Environment": "Production",
          "Location": "Factory1"
      }'
  ```

  Esse comando retorna o ID e o ARN do novo gateway:

  ```
  {
      "gatewayId": "a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE",
      "gatewayArn": "arn:aws:iotsitewise:us-east-1:123456789012:gateway/a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE"
  }
  ```

Para obter mais informações, consulte [create-gateway](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/create-gateway.html) na Referência de Comandos. AWS CLI 

------

## Atualizar um gateway SiteWise Edge
<a name="manage-gateway-update-gateway"></a>

------
#### [ Console ]

**Para atualizar um gateway SiteWise Edge**

1. <a name="sitewise-open-console"></a>Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. No painel de navegação, escolha **Gateways de borda**.

1. Selecione o gateway que você deseja atualizar.

1. Escolha **Editar**.

1. Atualize o nome do gateway ou outras configurações conforme necessário.

1. Escolha **Salvar**.

------
#### [ AWS CLI ]

Para atualizar um gateway existente usando AWS CLI, siga estas etapas:
+ Use o comando update-gateway para atualizar o nome de um gateway:

  ```
  aws iotsitewise update-gateway \
      --gateway-id a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE \
      --gateway-name "UpdatedGatewayName"
  ```

  Esse comando não gera nenhuma saída quando é bem-sucedido.

Para obter mais informações, consulte [update-gateway na Referência](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/update-gateway.html) de AWS CLI Comandos.

------

## Atualizar a configuração da capacidade do gateway
<a name="manage-gateway-update-capability"></a>

------
#### [ Console ]

**Para atualizar a configuração da capacidade do gateway**

1. <a name="sitewise-open-console"></a>Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. No painel de navegação, escolha **Gateways de borda**.

1. Escolha o nome do gateway que você deseja atualizar.

1. Na seção **Fontes de dados**, escolha **Editar**.

1. Atualize a configuração da fonte de dados conforme necessário.

1. Escolha **Salvar**.

------
#### [ AWS CLI ]

Para atualizar a configuração de capacidade de um gateway usando AWS CLI, siga estas etapas:
+ Use o update-gateway-capability-configuration comando para atualizar a configuração do recurso:

  ```
  aws iotsitewise update-gateway-capability-configuration \
      --gateway-id a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE \
      --capability-namespace "iotsitewise:opcuacollector:1" \
      --capability-configuration '{
          "sources": [
              {
                  "name": "OPC-UA Server",
                  "endpoint": {
                      "certificateTrust": {
                          "type": "TrustAny"
                      },
                      "endpointUri": "opc.tcp://10.0.0.1:4840",
                      "securityPolicy": "NONE",
                      "messageSecurityMode": "NONE",
                      "identityProvider": {
                          "type": "Anonymous"
                      }
                  },
                  "measurementDataStreamPrefix": ""
              }
          ]
      }'
  ```

  Esse comando retorna o namespace da capacidade e o status de sincronização:

  ```
  {
      "capabilityNamespace": "iotsitewise:opcuacollector:1",
      "capabilitySyncStatus": "CONFIGURING"
  }
  ```

Para obter mais informações, consulte [update-gateway-capability-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/update-gateway-capability-configuration.html)na Referência de AWS CLI Comandos.

------

## Tag: recursos do gateway
<a name="manage-gateway-tag-resources"></a>

------
#### [ Console ]

**Para marcar um recurso de gateway**

1. <a name="sitewise-open-console"></a>Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. No painel de navegação, escolha **Gateways de borda**.

1. Escolha o nome do gateway que você deseja marcar.

1. Escolha a guia **Tags**.

1. Selecione **Gerenciar tags**.

1. Escolha **Adicionar nova tag** e insira uma chave e um valor para cada tag.

1. Escolha **Salvar**.

------
#### [ AWS CLI ]

Para adicionar tags a um gateway usando AWS CLI, siga estas etapas:
+ Use o comando tag-resource para adicionar tags a um gateway:

  ```
  aws iotsitewise tag-resource \
      --resource-arn "arn:aws:iotsitewise:us-east-1:123456789012:gateway/a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE" \
      --tags '{
          "Department": "Operations",
          "Project": "FactoryAutomation"
      }'
  ```

  Esse comando não gera nenhuma saída quando é bem-sucedido.

Para obter mais informações, consulte [tag-resource na Referência de](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/tag-resource.html) AWS CLI Comandos.

------

## Listar tags para um gateway
<a name="manage-gateway-list-tags"></a>

------
#### [ Console ]

**Para listar tags para um gateway**

1. <a name="sitewise-open-console"></a>Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. No painel de navegação, escolha **Gateways de borda**.

1. Escolha o nome do gateway para o qual você deseja visualizar as tags.

1. Escolha a guia **Tags**.

1. Veja a lista de tags associadas ao gateway.

------
#### [ AWS CLI ]

Para listar as tags associadas a um gateway usando AWS CLI, siga estas etapas:
+ Use o list-tags-for-resource comando para listar as tags de um gateway:

  ```
  aws iotsitewise list-tags-for-resource \
      --resource-arn "arn:aws:iotsitewise:us-east-1:123456789012:gateway/a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE"
  ```

  Esse comando retorna as tags associadas ao gateway:

  ```
  {
      "tags": {
          "Environment": "Production",
          "Location": "Factory1",
          "Department": "Operations",
          "Project": "FactoryAutomation"
      }
  }
  ```

Para obter mais informações, consulte [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/list-tags-for-resource.html)na Referência de AWS CLI Comandos.

------

## Remover tags de um gateway
<a name="manage-gateway-untag-resources"></a>

------
#### [ Console ]

**Para remover tags de um gateway**

1. <a name="sitewise-open-console"></a>Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. No painel de navegação, escolha **Gateways de borda**.

1. Escolha o nome do gateway do qual você deseja remover as tags.

1. Escolha a guia **Tags**.

1. Selecione **Gerenciar tags**.

1. Escolha o ícone de remoção (X) ao lado de cada tag que você deseja remover.

1. Escolha **Salvar**.

------
#### [ AWS CLI ]

Para remover tags de um gateway usando AWS CLI, siga estas etapas:
+ Use o comando untag-resource para remover tags de um gateway:

  ```
  aws iotsitewise untag-resource \
      --resource-arn "arn:aws:iotsitewise:us-east-1:123456789012:gateway/a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE" \
      --tag-keys '["Project", "Department"]'
  ```

  Esse comando não gera nenhuma saída quando é bem-sucedido.

Para obter mais informações, consulte [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/untag-resource.html) na Referência de Comandos. AWS CLI 

------

## Atualizar a versão de um AWS IoT SiteWise componente
<a name="update-component-version"></a>

Atualize o componente de AWS IoT SiteWise gateway em seu dispositivo AWS IoT Greengrass principal para garantir seu acesso aos recursos mais recentes, melhorias de desempenho e patches de segurança.

**Para atualizar um AWS IoT SiteWise componente no AWS IoT Greengrass**

1. Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. No painel de navegação esquerdo, escolha **Edge gateways**.

1. Selecione o gateway a ser editado e escolha **Editar**.

1. Em **Capacidades do Edge**, em **Versões de software**, escolha **Atualizações de software disponíveis**. A página **Editar versões do software** é exibida.

1. Escolha a versão do componente.
**nota**  
É recomendável selecionar a versão mais recente disponível. Manter os componentes do gateway up-to-date ajuda você a manter a funcionalidade ideal para coleta e processamento de dados industriais.

1. Escolha **Implantar**. Isso inicia uma AWS IoT Greengrass V2 implantação para atualizar o AWS IoT SiteWise componente no gateway.

## Excluir um gateway SiteWise Edge
<a name="manage-gateway-delete-gateway"></a>

------
#### [ Console ]

**Para excluir o gateway SiteWise Edge**

1. <a name="sitewise-open-console"></a>Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. No painel de navegação, escolha **Gateways de borda**.

1. Escolha o gateway que você deseja excluir.

1. Escolha **Excluir**.

1. Para confirmar que você deseja excluir o gateway, digite “delete” e escolha **Delete** na janela que aparece.

------
#### [ AWS CLI ]

Para excluir um gateway usando AWS CLI, siga estas etapas:

1. Liste seus gateways para identificar o ID do gateway que você deseja excluir.

   ```
   aws iotsitewise list-gateways
   ```

   Esse comando retorna uma lista dos seus gateways com seus IDs nomes e outras informações:

   ```
   {
       "gatewaySummaries": [
           {
               "gatewayId": "a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE",
               "gatewayName": "ExampleCorpGateway",
               "gatewayCapabilitySummaries": [
                   {
                       "capabilityNamespace": "iotsitewise:opcuacollector:1",
                       "capabilitySyncStatus": "IN_SYNC"
                   }
               ],
               "creationDate": 1588369971.457,
               "lastUpdateDate": 1588369971.457
           }
       ]
   }
   ```

1. Exclua o gateway especificando seu ID:

   ```
   aws iotsitewise delete-gateway --gateway-id a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE
   ```

   Esse comando não gera nenhuma saída quando é bem-sucedido.
**nota**  
Quando você exclui um gateway, alguns dos arquivos do gateway permanecem no sistema de arquivos do gateway.

1. Para verificar se o gateway foi excluído, você pode listar seus gateways novamente:

   ```
   aws iotsitewise list-gateways
   ```

   O gateway excluído não deve mais aparecer na lista.

Para obter mais informações, consulte [delete-gateway](https://docs.aws.amazon.com/cli/latest/reference/storagegateway/delete-gateway.html) na Referência de Comandos. AWS CLI 

------