Gerenciar destinos AWS IoT SiteWise do Edge - AWS IoT SiteWise
Editar um destinoExcluir um destinoBaixe todos os filtros de caminho em um destino (console)Editar um filtro de caminhoExcluir um filtro de caminho

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

Gerenciar destinos AWS IoT SiteWise do Edge

Depois de adicionar destinos, você pode realizar várias operações para gerenciá-los, como editar configurações de destino, excluir destinos e gerenciar filtros de caminho.

Editar um destino

Selecione o botão de rádio ao lado do destino na tabela e escolha o botão Editar para editar um destino.

Console
Para editar um destino usando o AWS IoT SiteWise console

  1. Abra o console de AWS IoT SiteWise.

  2. Na navegação à esquerda, escolha Gateways Edge na seção Edge.

  3. Selecione o gateway apropriado.

  4. Na seção Destinos, escolha o destino que você deseja editar e, em seguida, escolha Editar.

  5. Modifique o destino e escolha Salvar.

AWS CLI
Para editar um destino usando AWS CLI

  • Você pode editar um destino modificando as informações de configuração do recurso JSON.

    aws iotsitewise update-gateway-capability-configuration \
--gateway-id your-gateway-id \
--capability-namespace "iotsitewise:publisher:3" \
--capability-configuration '{
    "sources": [
        {
            "type": "MQTT"
        }
    ],
    "destinations": [
        {
            "id": "your-existing-destination-id",
            "type": "SITEWISE_REALTIME",
            "name": "your-updated-destination-name",
            "config": {
                "publishingOrder": "TIME_ORDER",
                "enableCompression": true,
                "dropPolicy": {
                    "cutoffAge": "10d",
                    "exportPolicy": {
                        "retentionPeriod": "10d",
                        "rotationPeriod": "6h",
                        "exportSizeLimitGB": 10
                    }
                },
                "maxBatchWaitTime": "15s"
            },
            "filters": [
                {
                  ...
                }
            ]
        }
    ]
}'
nota

Você não pode atualizar o destino type oucapability-namespace. Por exemplo, você não pode mudar de um tipo de SITEWISE_REALTIME paraSITEWISE_BUFFERED. Você pode ter um destino em tempo real para cada gateway habilitado para MQTT.

Excluir um destino

Se você não precisar mais de um destino, poderá excluí-lo do seu gateway SiteWise Edge.

Console
Para excluir um destino usando o AWS IoT SiteWise console

  1. Abra o console de AWS IoT SiteWise.

  2. Na navegação à esquerda, escolha Gateways Edge na seção Edge.

  3. Selecione o gateway apropriado.

  4. Na seção Destinos, escolha o destino que você deseja excluir e, em seguida, escolha Excluir. Uma tela de confirmação é exibida.

  5. Para confirmar sua escolha de excluir o destino, digite “excluir” na caixa de confirmação.

AWS CLI
Para excluir um destino usando AWS CLI

  • Exclua a configuração do recurso do gateway especificando o ID do gateway e modificando a configuração do recurso para remover o destino que você deseja excluir.

    aws iotsitewise update-gateway-capability-configuration \
  --gateway-id your-gateway-id \
  --capability-namespace "iotsitewise:publisher:3" \
  --capability-configuration '{
    "sources": [
        {
            "type": "MQTT"
        }
    ],
    "destinations": []
}'
nota

A matriz de destinos pode estar vazia ([]), mas o próprio objeto de destinos deve ser incluído na configuração do recurso.

Baixe todos os filtros de caminho em um destino (console)

Baixe um arquivo CSV contendo todos os seus filtros de caminho no AWS IoT SiteWise console. Você pode usar uma lista baixada de filtros de caminho para compartilhar facilmente listas de filtros de caminho entre destinos de gateway.

Para baixar um arquivo CSV de todos os filtros de caminho usando o console AWS IoT SiteWise

  1. Abra o console de AWS IoT SiteWise.

  2. Na navegação à esquerda, escolha Gateways Edge na seção Edge.

  3. Selecione o gateway que contém seus filtros de caminho.

  4. Escolha Adicionar destino ou Editar destino.

  5. Navegue até a seção Filtros de caminho e escolha Baixar CSV.

nota

O arquivo CSV inclui todos os filtros de caminho em um destino específico, independentemente de quais você selecionou na lista de filtros de caminho.

Editar um filtro de caminho

Você pode editar filtros de caminho individuais para refinar quais dados seu destino recebe.

Console

Usando o AWS IoT SiteWise console, você pode editar cada filtro de caminho individual em cada caixa de texto respectiva.

Para editar um filtro de caminho usando o AWS IoT SiteWise console

  1. Abra o console de AWS IoT SiteWise.

  2. Na navegação à esquerda, escolha Gateways Edge na seção Edge.

  3. Selecione o gateway que contém seus filtros de caminho.

  4. Selecione o destino apropriado.

  5. Escolha Editar.

  6. Escolha a caixa de texto para a linha que contém o filtro de caminho que você deseja editar.

  7. Atualize o texto do filtro de caminho, garantindo que a caixa de seleção do filtro de caminho editado esteja marcada.

  8. Escolha Salvar.

AWS CLI

Para editar filtros de caminho para um destino usando o AWS CLI, primeiro recupere a configuração atual, modifique-a e, em seguida, atualize-a usando o update-gateway-capability-configuration comando.

Para editar um filtro de caminho usando AWS CLI

  1. Recupere a configuração de capacidade atual:

    aws iotsitewise describe-gateway-capability-configuration \
  --gateway-id your-gateway-id \
  --capability-namespace "iotsitewise:publisher:3" \
  --query "capabilityConfiguration"

  2. Edite o JSON para modificar os filtros de caminho conforme necessário.

  3. Atualize a configuração do recurso com os filtros de caminho modificados:

    aws iotsitewise update-gateway-capability-configuration \
  --gateway-id your-gateway-id \
  --capability-namespace "iotsitewise:publisher:3" \
  --capability-configuration json-containing-your-updated-path-filters

Excluir um filtro de caminho

Você pode excluir filtros de caminho de um destino para controlar os dados que ele recebe das fontes do MQTT e dos pipelines de processamento de dados.

Console
Para excluir um filtro de caminho usando o AWS IoT SiteWise console

  1. Abra o console de AWS IoT SiteWise.

  2. Na navegação à esquerda, escolha Gateways Edge na seção Edge.

  3. Selecione o gateway que contém seus filtros de caminho.

  4. Selecione o destino apropriado.

  5. Escolha Editar.

  6. Na tela Editar destino, na seção Filtros de caminho, selecione um ou mais filtros de caminho a serem excluídos.

  7. Escolha Excluir. Uma mensagem de confirmação de exclusão é exibida. Se quiser continuar com a exclusão dos filtros de caminho, escolha Excluir na tela de confirmação.

AWS CLI
Para excluir um destino usando AWS CLI

  • Exclua um filtro de caminho removendo-o da configuração do recurso.

    aws iotsitewise update-gateway-capability-configuration \
  --gateway-id your-gateway-id \
  --capability-namespace "iotsitewise:publisher:3" \
  --capability-configuration '{
    "sources": [
        {
            "type": "MQTT"
        }
    ],
    "destinations": [
        {
            "id": "your-destination-id",
            "type": "SITEWISE_REALTIME",
            "name": "your-destination-name",
            "config": {
                ...
            },
            "filters": [
                {
                    "type": "PATH",
                    "config": {
                        "paths": [
                            "/path1",
                            "/path2",
                            "/delete-a-path-to-remove-it"
                        ]
                    }
                }
            ]
        }
    ]
}
nota

A matriz de filtros pode estar vazia ([]), mas o próprio objeto de filtros deve ser incluído na configuração do recurso.