Gerenciando uma AWS IoT regra - AWS IoT Core
Marcar uma regraVisualizando uma regraComo excluir uma regra

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

Gerenciando uma AWS IoT regra

Você pode usar as ações a seguir para gerenciar suas AWS IoT regras.

Neste tópico:

Marcar uma regra

Para adicionar outra camada de especificidade às suas regras novas ou existentes, você pode aplicar a marcação. A marcação aproveita os pares de valores-chave em suas regras para fornecer maior controle sobre como e onde suas regras são aplicadas aos seus AWS IoT recursos e serviços. Por exemplo, você pode limitar o escopo da sua regra para aplicá-la somente em seu ambiente beta para testes de pré-lançamento (Key=environment, Value=beta) ou capturar todas as mensagens enviadas ao tópico iot/test de um endpoint específico e armazená-las em um bucket do Amazon S3.

Para ver um exemplo que mostra como conceder permissões de marcação para uma regra, considere um usuário que executa o comando a seguir para criar uma regra e marcá-la para aplicá-la somente ao ambiente beta.

No exemplo, substitua:

  • MyTopicRuleName com o nome da regra.

  • myrule.json com o nome do documento de política.

aws iot create-topic-rule 
    --rule-name MyTopicRuleName 
    --topic-rule-payload file://myrule.json
    --tags "environment=beta"

Neste exemplo, você deve usar a seguinte IAM política:

{
    "Version": "2012-10-17",
    "Statement": 
    {
        "Action": [ "iot:CreateTopicRule", "iot:TagResource" ],
        "Effect": "Allow",
        "Resource": [
            "arn:aws:iot:us-east-1:123456789012:rule/MyTopicRuleName"
        ]
    }
}

O exemplo acima mostra uma regra recém-criada chamada MyTopicRuleName que se aplica somente ao seu ambiente beta. A iot:TagResource declaração de política com a indicação MyTopicRuleName específica permite a marcação ao criar ou atualizar MyTopicRuleName. O parâmetro --tags "environment=beta" usado ao criar a regra limita o escopo de MyTopicRuleName somente ao seu ambiente beta. Se você remover o parâmetro --tags "environment=beta", então MyTopicRuleName será aplicado a todos os ambientes.

Para obter mais informações sobre a criação de IAM funções e políticas específicas para uma AWS IoT regra, consulte Conceder a uma AWS IoT regra o acesso que ela exige

Para obter informações gerais sobre a marcação de recursos, consulte Marcando seus recursos AWS IoT.

Visualizando uma regra

Use o list-topic-rulescomando para listar suas regras:

aws iot list-topic-rules

Use o get-topic-rulecomando para obter informações sobre uma regra:

aws iot get-topic-rule --rule-name myrule

Como excluir uma regra

Quando não precisar mais de uma regra, você poderá excluí-la.

Para excluir uma regra (AWS CLI)

Use o delete-topic-rulecomando para excluir uma regra:

aws iot delete-topic-rule --rule-name myrule