Gerencie gateways SiteWise Edge

Para listar os gateways SiteWise do Edge

1. Navegue até o console do AWS IoT SiteWise.

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

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

• 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 ver os detalhes do gateway

1. Navegue até o console do AWS IoT SiteWise.

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

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

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

• 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 criar um gateway SiteWise Edge

1. Navegue até o console do AWS IoT SiteWise.

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

3. Escolha Criar gateway.

4. Insira um nome para seu gateway.

5. Selecione o grupo Greengrass para seu gateway.

6. Opcionalmente, adicione tags ao seu gateway.

7. Escolha Criar.

• 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 atualizar um gateway SiteWise Edge

1. Navegue até o console do AWS IoT SiteWise.

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

3. Selecione o gateway que você deseja atualizar.

4. Escolha Editar.

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

6. Escolha Salvar.

• 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 atualizar a configuração da capacidade do gateway

1. Navegue até o console do AWS IoT SiteWise.

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

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

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

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

6. Escolha Salvar.

• 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 marcar um recurso de gateway

1. Navegue até o console do AWS IoT SiteWise.

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

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

4. Escolha a guia Tags.

5. Selecione Gerenciar tags.

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

7. Escolha Salvar.

• 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 listar tags para um gateway

1. Navegue até o console do AWS IoT SiteWise.

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

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

4. Escolha a guia Tags.

5. Veja a lista de tags associadas ao gateway.

• 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 remover tags de um gateway

1. Navegue até o console do AWS IoT SiteWise.

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

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

4. Escolha a guia Tags.

5. Selecione Gerenciar tags.

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

7. Escolha Salvar.

• 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 excluir o gateway SiteWise Edge

1. Navegue até o console do AWS IoT SiteWise.

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

3. Escolha o gateway que você deseja excluir.

4. Escolha Excluir.

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

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
           }
       ]
   }

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

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