本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
用戶端可以使用 1.0 或 1.1 HTTP 通訊協定向 提出請求RESTAPI,以發佈訊息。如需 HTTP請求使用的身分驗證和連接埠映射,請參閱 通訊協定、連接埠映射和身分驗證。
注意
HTTPS 不支援MQTT像 那樣clientId
的值。 在使用 時clientId
可以使用MQTT,但在使用 時無法使用HTTPS。
HTTPS 訊息 URL
裝置和用戶端透過向用戶端特定的端點和主題特定的 提出POST請求來發佈其訊息URL:
https://
IoT_data_endpoint
/topics/url_encoded_topic_name
?qos=1
-
IoT_data_endpoint
是AWS IoT 裝置資料端點。您可以使用 命令,在物件的詳細資訊頁面或用戶端 AWS CLI 的 AWS IoT 主控台中找到端點:aws iot describe-endpoint --endpoint-type iot:Data-ATS
此端點看起來如下:
a3qjEXAMPLEffp-ats.iot.us-west-2.amazonaws.com
-
url_encoded_topic_name
是所傳送訊息的完整主題名稱。
HTTPS 訊息程式碼範例
這些是如何傳送訊息的範例HTTPS AWS IoT。
import requests
import argparse
# define command-line parameters
parser = argparse.ArgumentParser(description="Send messages through an HTTPS connection.")
parser.add_argument('--endpoint', required=True, help="Your AWS IoT data custom endpoint, not including a port. " +
"Ex: \"abcdEXAMPLExyz-ats.iot.us-east-1.amazonaws.com\"")
parser.add_argument('--cert', required=True, help="File path to your client certificate, in PEM format.")
parser.add_argument('--key', required=True, help="File path to your private key, in PEM format.")
parser.add_argument('--topic', required=True, default="test/topic", help="Topic to publish messages to.")
parser.add_argument('--message', default="Hello World!", help="Message to publish. " +
"Specify empty string to publish nothing.")
# parse and load command-line parameter values
args = parser.parse_args()
# create and format values for HTTPS request
publish_url = 'https://' + args.endpoint + ':8443/topics/' + args.topic + '?qos=1'
publish_msg = args.message.encode('utf-8')
# make request
publish = requests.request('POST',
publish_url,
data=publish_msg,
cert=[args.cert, args.key])
# print results
print("Response status: ", str(publish.status_code))
if publish.status_code == 200:
print("Response body:", publish.text)