Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# HTTPS mempublikasikan
Klien dapat mempublikasikan pesan dengan membuat permintaan ke REST API menggunakan protokol HTTP 1.0 atau 1.1. Untuk otentikasi dan pemetaan port yang digunakan oleh permintaan HTTP, lihat. [Protokol, pemetaan port, dan otentikasi](protocols.md#protocol-mapping)
**catatan**
HTTPS tidak mendukung `clientId` nilai seperti yang dilakukan MQTT. `clientId`tersedia saat menggunakan MQTT, tetapi tidak tersedia saat menggunakan HTTPS.
## URL pesan HTTPS
Perangkat dan klien mempublikasikan pesan mereka dengan membuat permintaan POST ke titik akhir khusus klien dan URL khusus topik:
```
https://IoT_data_endpoint/topics/url_encoded_topic_name?qos=1
```
+ *IoT\$1data\$1endpoint*adalah [titik akhir data AWS IoT perangkat](iot-connect-devices.md#iot-connect-device-endpoints). Anda dapat menemukan titik akhir di AWS IoT konsol di halaman detail benda atau di klien dengan menggunakan AWS CLI perintah:
```
aws iot describe-endpoint --endpoint-type iot:Data-ATS
```
Titik akhir akan terlihat seperti ini: `a3qjEXAMPLEffp-ats.iot.us-west-2.amazonaws.com`
+ *url\$1encoded\$1topic\$1name*adalah [nama topik](topics.md#topicnames) lengkap dari pesan yang dikirim.
## Contoh kode pesan HTTPS
Ini adalah beberapa contoh cara mengirim pesan HTTPS ke AWS IoT.
------
#### [ Python (port 8443) ]
```
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)
```
------
#### [ Python (port 443) ]
```
import requests
import http.client
import json
import ssl
ssl_context = ssl.SSLContext(protocol=ssl.PROTOCOL_TLS_CLIENT)
ssl_context.minimum_version = ssl.TLSVersion.TLSv1_2
# note the use of ALPN
ssl_context.set_alpn_protocols(["x-amzn-http-ca"])
ssl_context.load_verify_locations(cafile="./")
# update the certificate and the AWS endpoint
ssl_context.load_cert_chain("./", "")
connection = http.client.HTTPSConnection('', 443, context=ssl_context)
message = {'data': 'Hello, I'm using TLS Client authentication!'}
json_data = json.dumps(message)
connection.request('POST', '/topics/device%2Fmessage?qos=1', json_data)
# make request
response = connection.getresponse()
# print results
print(response.read().decode())
```
------
#### [ CURL ]
Anda dapat menggunakan [curl](https://curl.haxx.se) dari klien atau perangkat untuk mengirim pesan ke AWS IoT.
**Untuk menggunakan curl untuk mengirim pesan dari perangkat AWS IoT klien**
1. Periksa **curl** versinya.
1. Pada klien Anda, jalankan perintah ini pada command prompt.
**curl --help**
Dalam teks bantuan, cari opsi TLS. Anda harus melihat `--tlsv1.2` opsi.
1. Jika Anda melihat `--tlsv1.2` opsi, lanjutkan.
1. Jika Anda tidak melihat `--tlsv1.2` opsi atau Anda mendapatkan `command not found` kesalahan, Anda mungkin perlu memperbarui atau menginstal curl pada klien Anda atau menginstal `openssl` sebelum melanjutkan.
1. Instal sertifikat pada klien Anda.
Salin file sertifikat yang Anda buat saat Anda mendaftarkan klien Anda (benda) di AWS IoT konsol. Pastikan Anda memiliki tiga file sertifikat ini di klien Anda sebelum melanjutkan.
+ File sertifikat CA (*Amazon-root-CA-1.pem*dalam contoh ini).
+ File sertifikat klien (*device.pem.crt*dalam contoh ini).
+ File kunci pribadi klien (*private.pem.key*dalam contoh ini).
1. Buat baris **curl** perintah, ganti nilai yang dapat diganti untuk akun dan sistem Anda.
```
curl --tlsv1.2 \
--cacert Amazon-root-CA-1.pem \
--cert device.pem.crt \
--key private.pem.key \
--request POST \
--data "{ \"message\": \"Hello, world\" }" \
"https://IoT_data_endpoint:8443/topics/topic?qos=1"
```
--tlsv1.2
Gunakan TLS 1.2 (SSL).
--cacert *Amazon-root-CA-1.pem*
Nama file dan jalur, jika perlu, dari sertifikat CA untuk memverifikasi rekan.
--sertifikat *device.pem.crt*
Nama file sertifikat klien dan jalur, jika perlu.
--kunci *private.pem.key*
Nama file kunci pribadi klien dan jalur, jika perlu.
--permintaan POST
Jenis permintaan HTTP (dalam hal ini, POST).
--data "” *\$1 \$1"message\$1": \$1"Hello, world\$1" \$1*
Data HTTP POST yang ingin Anda publikasikan. Dalam hal ini, ini adalah string JSON, dengan tanda kutip internal lolos dengan karakter garis miring terbalik (\$1).
“https: *IoT\$1data\$1endpoint* //:8443/topik/? *topic* qos=1"
URL titik akhir data AWS IoT perangkat klien Anda, diikuti oleh port HTTPS`:8443`, yang kemudian diikuti oleh kata kunci, `/topics/` dan nama topik`topic`, dalam hal ini. Tentukan Kualitas Layanan sebagai parameter kueri,`?qos=1`.
1. Buka klien pengujian MQTT di konsol. AWS IoT
Ikuti petunjuk [Lihat pesan MQTT dengan klien MQTT AWS IoT](view-mqtt-messages.md) dan konfigurasikan konsol untuk berlangganan pesan dengan nama topik yang *topic* digunakan dalam **curl** perintah Anda, atau gunakan filter topik wildcard dari`#`.
1. Uji perintahnya.
Saat memantau topik di klien pengujian AWS IoT konsol, buka klien Anda dan keluarkan baris perintah curl yang Anda buat di langkah 3. Anda akan melihat pesan klien Anda di konsol.
------