HTTP アクションの送信先 - AWS IoT Core
概要:HTTP アクションの送信先の管理認証機関のサポート

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

HTTP アクションの送信先

HTTP アクションの送信先は、ルールエンジンがトピックルールからデータをルーティングできるウェブサービスです。 AWS IoT Core リソースは、 のウェブサービスを記述します AWS IoT。送信先リソースは、異なるルールで共有できます。

AWS IoT Core が別のウェブサービスにデータを送信する前に、サービスのエンドポイントにアクセスできることを確認する必要があります。

概要:

HTTP アクションの送信先は、確認 URL と 1 つ以上のデータ収集 URLs。送信先リソースには、ウェブサービスの確認 URL が含まれています。HTTP アクションを設定するときは、データを受信するエンドポイントの実際の URL とウェブサービスの確認 URL を指定します。送信先が確認されると、トピックルールは、SQL ステートメントの結果を HTTPS エンドポイントに送信します (確認 URL ではない)。

HTTP アクションの送信先は、次のいずれかの状態になります。

有効

送信先は確認済みで、ルールアクションによって使用できます。送信先をルールで使用するには、送信先は、ENABLEDの状態である必要があります。有効にできるのは、「DISABLED」ステータスの送信先のみです。

無効

送信先は確認されましたが、ルールアクションでは使用できません。これは、確認プロセスを再度実行することなく、エンドポイントへのトラフィックを一時的に防止する場合に便利です。無効にできるのは、有効ステータスの送信先のみです。

IN_PROGRESS

送信先の確認は進行中です。

ERROR

送信先の確認がタイムアウトしました。

HTTP アクションの送信先を確認して有効にすると、アカウントの任意のルールで使用できます。

HTTP アクションの送信先の管理

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

HTTP アクションの送信先の作成

HTTP アクションの送信先を作成するには、 CreateTopicRuleDestinationオペレーションを呼び出すか、 AWS IoT コンソールを使用します。

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

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

確認する HTTP アクションの送信先の Amazon リソースネーム (ARN)。

confirmationToken

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

enableUrl

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

messageType

メッセージのタイプ。

HTTP アクションの送信先の確認

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

  1. 送信先がメッセージを受信する準備ができていることを確認する

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

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

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

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

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

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

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

HTTP アクションの送信先の無効化と削除

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

HTTP アクションの送信先を削除するには、 を呼び出しますDeleteTopicRuleDestination。

認証機関のサポート

注記

自己署名証明書はサポートされていません。

HTTP アクションの送信先の HTTPS エンドポイントは、AWS プライベート認証機関と Lets Encrypt の両方によって発行された証明書をサポートします。