HTTP トピックルールの送信先の管理 - AWS IoT Core
HTTP トピックルールの送信先の作成HTTP トピックルールの送信先の確認新しい確認リクエストの送信トピックルールの送信先の無効化

HTTP トピックルールの送信先の管理

次のオペレーションを使用して、HTTP トピックルールの送信先を管理できます。

HTTP トピックルールの送信先の作成

HTTP トピックルール送信先は、CreateTopicRuleDestination オペレーションを呼び出す、または AWS IoT コンソールを使用することによって作成します。

送信先を作成した後、AWS IoTは、確認リクエストを確認 URL に送信します。確認リクエストの形式は次のとおりです。

HTTP POST {confirmationUrl}/?confirmationToken={confirmationToken}
Headers:
x-amz-rules-engine-message-type: DestinationConfirmation
x-amz-rules-engine-destination-arn:"arn:aws:iot:us-east-1:123456789012:ruledestination/http/7a280e37-b9c6-47a2-a751-0703693f46e4"
Content-Type: application/json
Body:
{
    "arn":"arn:aws:iot:us-east-1:123456789012:ruledestination/http/7a280e37-b9c6-47a2-a751-0703693f46e4",  
    "confirmationToken": "AYADeMXLrPrNY2wqJAKsFNn-…NBJndA",
    "enableUrl": "https://iot.us-east-1.amazonaws.com/confirmdestination/AYADeMXLrPrNY2wqJAKsFNn-…NBJndA",
    "messageType": "DestinationConfirmation"
}

確認リクエストの内容には、以下の情報が含まれます。

arn

確認するトピックルール送信先の Amazon リソースネーム (ARN)。

confirmationToken

AWS IoT Coreによって送信された確認トークン。この例のトークンは切り捨てられます。トークンは長くなります。AWS IoT Coreで目的地を確認するには、このトークンが必要です。

enableUrl

トピックルールの送信先を確認するために参照する URL。

messageType

メッセージのタイプ。

HTTP トピックルールの送信先の確認

エンドポイントの確認プロセスを完了するには、AWS CLI を使用している場合、確認 URL が確認リクエストを受信した後、次のいずれかの手順を実施する必要があります。

  1. 送信先がメッセージを受信する意思があることを確認する

    トピックルールの送信先が IoT メッセージを受信する意思があることを確認するには、確認リクエストで enableUrl を呼び出すか、ConfirmTopicRuleDestination API オペレーションを実行して確認リクエストから confirmationToken を渡します。

  2. トピックルールのステータスを有効に設定する

    送信先がメッセージを受信できることを確認したら、UpdateTopicRuleDestination API オペレーションを実行してトピックルールのステータスを ENABLED に設定する必要があります。

AWS IoT コンソールを使用する場合、confirmationToken をコピーし、AWS IoT コンソールで送信先の確認ダイアログに貼り付けます。その後、トピックルールを有効にできます。

新しい確認リクエストの送信

送信先の新しい確認メッセージをアクティブ化するには、UpdateTopicRuleDestination を呼び出 して、トピックルールの送信先のステータスを IN_PROGRESS に設定します。

新しい確認リクエストを送信した後、確認プロセスを繰り返します。

トピックルールの送信先の無効化

送信先を無効にするには、UpdateTopicRuleDestinationを呼び出して、トピックルールの送信先のステータスを DISABLED に設定します。無効状態のトピックルールは、新しい確認要求を送信しなくても、再度有効にすることができます。

トピックルールの送信先を削除するには、DeleteTopicRuleDestination を呼び出します。