View a markdown version of this page

AWS IoT contoh menggunakan AWS CLI - AWS Command Line Interface
Tindakan

Dokumentasi ini AWS CLI hanya untuk Versi 1.

Kami mengumumkan akhir dukungan yang akan datang untuk AWS CLI versi 1. Kami menyarankan Anda bermigrasi ke AWS CLI versi 2. Untuk tanggal, detail tambahan, dan informasi tentang cara bermigrasi, lihat pengumuman. Untuk dokumentasi yang terkait dengan Versi 2 AWS CLI, lihat Panduan Pengguna Versi 2.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

AWS IoT contoh menggunakan AWS CLI

Contoh kode berikut menunjukkan cara melakukan tindakan dan menerapkan skenario umum dengan menggunakan AWS Command Line Interface with AWS IoT.

Tindakan merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.

Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.

Tindakan

Contoh kode berikut menunjukkan cara menggunakanaccept-certificate-transfer.

AWS CLI

Untuk menerima sertifikat perangkat yang ditransfer dari AWS akun lain

accept-certificate-transferContoh berikut menerima sertifikat perangkat yang ditransfer dari AWS akun lain. Sertifikat diidentifikasi oleh ID-nya.

aws iot accept-certificate-transfer \
    --certificate-id 488b6a7f2acdeb00a77384e63c4e40b18bEXAMPLEe57b7272ba44c45e3448142

Perintah ini tidak menghasilkan output apa pun.

Untuk informasi selengkapnya, lihat Men transfer sertifikat ke akun lain di Panduan Pengembang AWS IoT Core.

Contoh kode berikut menunjukkan cara menggunakanadd-thing-to-billing-group.

AWS CLI

Contoh 1: Untuk menambahkan sesuatu berdasarkan nama ke grup penagihan

add-thing-to-billing-groupContoh berikut menambahkan hal yang diberi nama MyLightBulb ke grup penagihan bernamaGroupOne.

aws iot add-thing-to-billing-group \
    --billing-group-name GroupOne \
    --thing-name MyLightBulb

Perintah ini tidak menghasilkan output.

Contoh 2: Untuk menambahkan sesuatu dengan ARN ke grup penagihan

add-thing-to-billing-groupContoh berikut menambahkan sesuatu dengan ARN tertentu ke grup penagihan dengan ARN yang ditentukan. Menentukan ARN sangat membantu jika Anda bekerja dengan beberapa Wil AWS ayah atau akun. Ini dapat membantu memastikan bahwa Anda menambahkan ke Wilayah dan akun yang tepat.

aws iot add-thing-to-thing-group \
    --billing-group-arn "arn:aws:iot:us-west-2:123456789012:billinggroup/GroupOne" \
    --thing-arn "arn:aws:iot:us-west-2:123456789012:thing/MyOtherLightBulb"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Grup Penagihan di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanadd-thing-to-thing-group.

AWS CLI

Untuk menambahkan sesuatu ke grup

add-thing-to-thing-groupContoh berikut menambahkan hal yang ditentukan ke grup hal yang ditentukan.

aws iot add-thing-to-thing-group \
    --thing-name MyLightBulb \
    --thing-group-name LightBulbs

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Grup Hal di Panduan AWS Pengembang IoT.

Contoh kode berikut menunjukkan cara menggunakanassociate-targets-with-job.

AWS CLI

Untuk mengaitkan kelompok benda dengan pekerjaan berkelanjutan

associate-targets-with-jobContoh berikut mengaitkan grup hal yang ditentukan dengan pekerjaan kontinu yang ditentukan.

aws iot associate-targets-with-job \
    --targets "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs" \
    --job-id "example-job-04"

Output:

{
    "jobArn": "arn:aws:iot:us-west-2:123456789012:job/example-job-04",
    "jobId": "example-job-04",
    "description": "example continuous job"
}

Untuk informasi selengkapnya, lihat Membuat dan Mengelola Pekerjaan (CLI) di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanattach-policy.

AWS CLI

Contoh 1: Untuk melampirkan kebijakan ke grup benda

attach-policyContoh berikut melampirkan kebijakan yang ditentukan ke grup benda yang diidentifikasi oleh ARN-nya.

aws iot attach-policy \
    --target "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs" \
    --policy-name "UpdateDeviceCertPolicy"

Perintah ini tidak menghasilkan output apa pun.

Untuk informasi selengkapnya, lihat Grup Hal di Panduan AWS Pengembang IoT.

Contoh 2: Untuk melampirkan kebijakan ke sertifikat

attach-policyContoh berikut melampirkan kebijakan UpdateDeviceCertPolicy ke prinsipal yang ditentukan oleh sertifikat.

aws iot attach-policy \
    --policy-name UpdateDeviceCertPolicy \
    --target "arn:aws:iot:us-west-2:123456789012:cert/4f0ba725787aa94d67d2fca420eca022242532e8b3c58e7465c7778b443fd65e"

Perintah ini tidak menghasilkan output apa pun.

Untuk informasi selengkapnya, lihat Melamp irkan Kebijakan AWS IoT ke Sertifikat Perangkat di Panduan AWS Pengembang IoT.

  • Untuk detail API, lihat AttachPolicy di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanattach-security-profile.

AWS CLI

Untuk mengaitkan profil keamanan dengan semua perangkat yang tidak terdaftar

attach-security-profileContoh berikut mengaitkan profil keamanan AWS IoT Device Defender yang dinam Testprofile ai dengan semua perangkat yang tidak terdaftar di us-west-2 wilayah untuk AWS akun ini.

aws iot attach-security-profile \
    --security-profile-name Testprofile \
    --security-profile-target-arn "arn:aws:iot:us-west-2:123456789012:all/unregistered-things"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mendeteksi Perintah di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanattach-thing-principal.

AWS CLI

Untuk melampirkan sertifikat ke barang Anda

attach-thing-principalContoh berikut melampirkan sertifikat ke MyTemperatureSensor benda itu. Sertifikat diidentifikasi oleh ARN. Anda dapat menemukan ARN untuk sertifikat di konsol AWS IoT.

aws iot attach-thing-principal \
    --thing-name MyTemperatureSensor \
    --principal arn:aws:iot:us-west-2:123456789012:cert/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Cara Mengelola Hal dengan Registr i di Panduan AWS Pengembang IoT.

Contoh kode berikut menunjukkan cara menggunakancancel-audit-mitigation-actions-task.

AWS CLI

Untuk membatalkan tugas tindakan mitigasi audit

cancel-audit-mitigations-action-taskContoh berikut membatalkan penerapan tindakan mitigasi untuk tugas yang ditentukan. Anda tidak dapat membatalkan tugas yang sudah selesai.

aws iot cancel-audit-mitigation-actions-task
    --task-id "myActionsTaskId"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat CancelAuditMitigationActionsTask (Perintah Tindakan Miti gasi) di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakancancel-audit-task.

AWS CLI

Untuk membatalkan tugas audit

cancel-audit-taskContoh berikut membatalkan tugas audit dengan ID tugas yang ditentukan. Anda tidak dapat membatalkan tugas yang sudah selesai.

aws iot cancel-audit-task \
    --task-id a3aea009955e501a31b764abe1bebd3d

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Perintah Audit di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakancancel-certificate-transfer.

AWS CLI

Untuk membatalkan transfer sertifikat ke AWS akun lain

cancel-certificate-transferContoh berikut membatalkan transfer transfer sertifikat yang ditentukan. Sertifikat diidentifikasi oleh ID sertifikat. Anda dapat menemukan ID untuk sertifikat di konsol AWS IoT.

aws iot cancel-certificate-transfer \
    --certificate-id f0f33678c7c9a046e5cc87b2b1a58dfa0beec26db78addd5e605d630e05c7fc8

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Men transfer sertifikat ke akun lain di Panduan Pengembang AWS IoT Core.

Contoh kode berikut menunjukkan cara menggunakancancel-job-execution.

AWS CLI

Untuk membatalkan eksekusi pekerjaan di perangkat

cancel-job-executionContoh berikut membatalkan eksekusi pekerjaan yang ditentukan pada perangkat. Jika pekerjaan tidak dalam QUEUED status, Anda harus menambahkan --force parameter.

aws iot cancel-job-execution \
    --job-id "example-job-03" \
    --thing-name "MyRPi"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Membuat dan Mengelola Pekerjaan (CLI) di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakancancel-job.

AWS CLI

Untuk membatalkan pekerjaan

cancel-jobContoh berikut membatalkan pekerjaan yang ditentukan.

aws iot cancel-job \
    --job-id "example-job-03"

Output:

{
    "jobArn": "arn:aws:iot:us-west-2:123456789012:job/example-job-03",
    "jobId": "example-job-03",
    "description": "example job test"
}

Untuk informasi selengkapnya, lihat Membuat dan Mengelola Pekerjaan (CLI) di Panduan Pengembang AWS IoT.

  • Untuk detail API, lihat CancelJob di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanclear-default-authorizer.

AWS CLI

Untuk menghapus otorisasi default

clear-default-authorizerContoh berikut menghapus otorisasi kustom default yang saat ini dikonfigurasi. Setelah Anda menjalankan perintah ini, tidak ada otorisasi default. Saat Anda menggunakan otorisasi khusus, Anda harus menentukannya berdasarkan nama di header permintaan HTTP.

aws iot clear-default-authorizer

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat ClearDefaultAuthorizer di Refer AWS ensi API IoT.

Contoh kode berikut menunjukkan cara menggunakanconfirm-topic-rule-destination.

AWS CLI

Untuk mengonfirmasi tujuan aturan topik

confirm-topic-rule-destinationContoh berikut mengonfirmasi tujuan aturan topik dengan token konfirmasi yang diterima di titik akhir HTTP.

aws iot confirm-topic-rule-destination \
    --confirmation-token "AYADeIcmtq-ZkxfpiWIQqHWM5ucAXwABABVhd3MtY3J5cHRvLXB1YmxpYy1rZXkAREFxY1E0UmlGeDg0V21BZWZ1VjZtZWFRVUJJUktUYXJaN09OZlJOczJhRENSZmZYL3JHZC9PR3NNcis5T3ZlSitnQT09AAEAB2F3cy1rbXMAS2Fybjphd3M6a21zOnVzLWVhc3QtMTo5ODc5NTE4NTI0OTk6a2V5L2U4YmU3ODViLTU5NWMtNDcxYi1iOWJmLWQ2Y2I4ZjQxODlmNwC4AQIBAHhwz48UWTGWE1ua0P8U1hj27nsFzEaAdf6Hs2K_7wBheAF62zwMuk_A4dPiC6eyPGuMAAAAfjB8BgkqhkiG9w0BBwagbzBtAgEAMGgGCSqGSIb3DQEHATAeBglghkgBZQMEAS4wEQQM9vtRMpf9D3CiZ8sMAgEQgDuFd0Txy-aywpPqg8YEsa1lD4B40aJ2s1wEHKMybiF1RoOZzYisI0IvslzQY5UmCkqq3tV-3f7-nKfosgIAAAAADAAAEAAAAAAAAAAAAAAAAAAi9RMgy-V19V9m6Iw2xfbw_____wAAAAEAAAAAAAAAAAAAAAEAAAB1hw4SokgUcxiJ3gTO6n50NLJVpzyQR1UmPIj5sShqXEQGcOsWmXzpYOOx_PWyPVNsIFHApyK7Cc3g4bW8VaLVwOLkC83g6YaZAh7dFEl2-iufgrzTePl8RZYOWr0O6Aj9DiVzJZx-1iD6Pu-G6PUw1kaO7Knzs2B4AD0qfrHUF4pYRTvyUgBnMGUCMQC8ZRmhKqntd_c6Kgrow3bMUDBvNqo2qZr8Z8Jm2rzgseROlAnLgFLGpGShr99oSZkCMEd1v62NBRKX9HQXnybyF3fkg__-PIetJ803Z4IlIlF8xXlcdPGP-PV1dOXFemyL8g"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mengonfirmasi tujuan aturan topik di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakancreate-audit-suppression.

AWS CLI

Untuk membuat penekanan temuan audit

create-audit-suppressionContoh berikut membuat penekanan temuan audit untuk kebijakan bernama “MachinePolicyvirtual” yang telah ditandai karena terlalu permisif.

aws iot create-audit-suppression \
    --check-name IOT_POLICY_OVERLY_PERMISSIVE_CHECK \
    --resource-identifier policyVersionIdentifier={"policyName"="virtualMachinePolicy","policyVersionId"="1"} \
    --no-suppress-indefinitely \
    --expiration-date 2020-10-20

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Penekanan pencarian audit di Panduan Peng AWS embang IoT.

Contoh kode berikut menunjukkan cara menggunakancreate-authorizer.

AWS CLI

Untuk membuat otorisasi kustom

create-authorizerContoh berikut membuat otorisasi kustom yang menggunakan fungsi Lambda yang ditentukan sebagai bagian dari layanan otentikasi kustom.

   aws iot create-authorizer \
       --authorizer-name "CustomAuthorizer" \
       --authorizer-function-arn "arn:aws:lambda:us-west-2:123456789012:function:CustomAuthorizerFunction" \
       --token-key-name "MyAuthToken" \
       --status ACTIVE \
       --token-signing-public-keys FIRST_KEY="-----BEGIN PUBLIC KEY-----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA1uJOB4lQPgG/lM6ZfIwo
Z+7ENxAio9q6QD4FFqjGZsvjtYwjoe1RKK0U8Eq9xb5O3kRSmyIwTzwzm/f4Gf0Y
ZUloJ+t3PUUwHrmbYTAgTrCUgRFygjfgVwGCPs5ZAX4Eyqt5cr+AIHIiUDbxSa7p
zwOBKPeic0asNJpqT8PkBbRaKyleJh5oo81NDHHmVtbBm5A5YiJjqYXLaVAowKzZ
+GqsNvAQ9Jy1wI2VrEa1OfL8flDB/BJLm7zjpfPOHDJQgID0XnZwAlNnZcOhCwIx
50g2LW2Oy9R/dmqtDmJiVP97Z4GykxPvwlYHrUXY0iW1R3AR/Ac1NhCTGZMwVDB1
lQIDAQAB
-----END PUBLIC KEY-----"

Output:

{
    "authorizerName": "CustomAuthorizer",
    "authorizerArn": "arn:aws:iot:us-west-2:123456789012:authorizer/CustomAuthorizer2"
}

Untuk informasi selengkapnya, lihat CreateAuthorizer di Refer AWS ensi API IoT.

Contoh kode berikut menunjukkan cara menggunakancreate-billing-group.

AWS CLI

Cara membuat grup penagihan

create-billing-groupContoh berikut membuat grup penagihan sederhana bernamaGroupOne.

aws iot create-billing-group \
    --billing-group-name GroupOne

Output:

{
    "billingGroupName": "GroupOne",
    "billingGroupArn": "arn:aws:iot:us-west-2:123456789012:billinggroup/GroupOne",
    "billingGroupId": "103de383-114b-4f51-8266-18f209ef5562"
}

Untuk informasi selengkapnya, lihat Grup Penagihan di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakancreate-certificate-from-csr.

AWS CLI

Untuk membuat sertifikat perangkat dari permintaan penandatanganan sertifikat (CSR)

create-certificate-from-csrContoh berikut membuat sertifikat perangkat dari CSR. Anda dapat menggunakan openssl perintah untuk membuat CSR.

aws iot create-certificate-from-csr \
    --certificate-signing-request=file://certificate.csr

Output:

{
    "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/c0c57bbc8baaf4631a9a0345c957657f5e710473e3ddbee1428d216d54d53ac9",
        "certificateId": "c0c57bbc8baaf4631a9a0345c957657f5e710473e3ddbee1428d216d54d53ac9",
        "certificatePem": "<certificate-text>"
}

Untuk informasi selengkapnya, lihat CreateCertificateFromCSR di Refer AWS ensi API IoT.

Contoh kode berikut menunjukkan cara menggunakancreate-custom-metric.

AWS CLI

Untuk membuat metrik khusus yang diterbitkan oleh perangkat Anda ke Device Defender

create-custom-metricContoh berikut membuat metrik khusus yang mengukur persentase baterai.

aws iot create-custom-metric \
    --metric-name "batteryPercentage" \
    --metric-type "number" \
    --display-name "Remaining battery percentage." \
    --region us-east-1 \
    --client-request-token "02ccb92b-33e8-4dfa-a0c1-35b181ed26b0"

Output:

{
    "metricName": "batteryPercentage",
    "metricArn": "arn:aws:iot:us-east-1:1234564789012:custommetric/batteryPercentage"
}

Untuk informasi selengkapnya, lihat Metrik khusus di Panduan Pengembang Inti AWS IoT.

Contoh kode berikut menunjukkan cara menggunakancreate-dimension.

AWS CLI

Untuk membuat dimensi

Berikut ini create-dimension menciptakan dimensi dengan filter topik tunggal yang disebutTopicFilterForAuthMessages.

aws iot create-dimension \
    --name TopicFilterForAuthMessages \
    --type TOPIC_FILTER \
    --string-values device/+/auth

Output:

{
    "name": "TopicFilterForAuthMessages",
    "arn": "arn:aws:iot:eu-west-2:123456789012:dimension/TopicFilterForAuthMessages"
}

Untuk informasi selengkapnya, lihat Mendeteksi Perintah di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakancreate-domain-configuration.

AWS CLI

Untuk membuat konfigurasi domain

create-domain-configurationContoh berikut membuat konfigurasi domain yang AWS dikelola dengan jenis DATA layanan.

aws iot create-domain-configuration \
    --domain-configuration-name "additionalDataDomain" \
    --service-type "DATA"

Output:

{
    "domainConfigurationName": "additionalDataDomain",
    "domainConfigurationArn": "arn:aws:iot:us-west-2:123456789012:domainconfiguration/additionalDataDomain/dikMh"
}

Untuk informasi selengkapnya, lihat T itik Akhir yang Dapat Dikonfigurasi di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakancreate-dynamic-thing-group.

AWS CLI

Untuk membuat grup benda dinamis

create-dynamic-thing-groupContoh berikut membuat grup benda dinamis yang berisi benda apa pun dengan atribut suhu yang lebih besar dari 60 derajat. Anda harus mengaktifkan pengindeksan armada AWS IoT sebelum dapat menggunakan grup benda dinamis.

aws iot create-dynamic-thing-group \
    --thing-group-name "RoomTooWarm" \
    --query-string "attributes.temperature>60"

Output:

{
    "thingGroupName": "RoomTooWarm",
    "thingGroupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/RoomTooWarm",
    "thingGroupId": "9d52492a-fc87-43f4-b6e2-e571d2ffcad1",
    "indexName": "AWS_Things",
    "queryString": "attributes.temperature>60",
    "queryVersion": "2017-09-30"
}

Untuk informasi selengkapnya, lihat Grup Hal Din amis di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakancreate-job.

AWS CLI

Contoh 1: Untuk membuat pekerjaan

create-jobContoh berikut membuat pekerjaan AWS IoT sederhana yang mengirimkan dokumen JSON ke MyRaspberryPi perangkat.

aws iot create-job \
    --job-id "example-job-01" \
    --targets "arn:aws:iot:us-west-2:123456789012:thing/MyRaspberryPi" \
    --document file://example-job.json \
    --description "example job test" \
    --target-selection SNAPSHOT

Output:

{
    "jobArn": "arn:aws:iot:us-west-2:123456789012:job/example-job-01",
    "jobId": "example-job-01",
    "description": "example job test"
}

Contoh 2: Untuk membuat pekerjaan berkelanjutan

create-jobContoh berikut membuat pekerjaan yang terus berjalan setelah hal-hal yang ditentukan sebagai target telah menyelesaikan pekerjaan. Dalam contoh ini, targetnya adalah grup benda, jadi ketika perangkat baru ditambahkan ke grup, pekerjaan berkelanjutan berjalan pada hal-hal baru tersebut.

aws iot create-job --job-id “example-job-04" --target “arn:aws:iot:us-west- 2:123456789012:" --file dokumen: //example-job.json --description “contoh pekerjaan berkelanjutan” --target-selection BERKELANJUTAN thinggroup/DeadBulbs

Output:

{
    "jobArn": "arn:aws:iot:us-west-2:123456789012:job/example-job-04",
    "jobId": "example-job-04",
    "description": "example continuous job"
}

Untuk informasi selengkapnya, lihat Membuat dan Mengelola Pekerjaan (CLI) di Panduan Pengembang AWS IoT.

  • Untuk detail API, lihat CreateJob di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakancreate-keys-and-certificate.

AWS CLI

Untuk membuat pasangan kunci RSA dan mengeluarkan sertifikat X.509

Berikut ini create-keys-and-certificate membuat pasangan kunci RSA 2048-bit dan mengeluarkan X.509 sertifikat menggunakan kunci publik yang dikeluarkan. Karena ini adalah satu-satunya waktu AWS IoT menyediakan kunci pribadi untuk sertifikat ini, pastikan untuk menyimpannya di lokasi yang aman.

aws iot create-keys-and-certificate \
    --certificate-pem-outfile "myTest.cert.pem" \
    --public-key-outfile "myTest.public.key" \
    --private-key-outfile "myTest.private.key"

Output:

{
    "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/9894ba17925e663f1d29c23af4582b8e3b7619c31f3fbd93adcb51ae54b83dc2",
    "certificateId": "9894ba17925e663f1d29c23af4582b8e3b7619c31f3fbd93adcb51ae54b83dc2",
    "certificatePem": "
-----BEGIN CERTIFICATE-----
MIICiTCCEXAMPLE6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC
VVMxCzAJBgNVBAgEXAMPLEAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6
b24xFDASBgNVBAsTC0lBTSEXAMPLE2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd
BgkqhkiG9w0BCQEWEG5vb25lQGFtYEXAMPLEb20wHhcNMTEwNDI1MjA0NTIxWhcN
MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCEXAMPLEJBgNVBAgTAldBMRAwDgYD
VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDAEXAMPLEsTC0lBTSBDb25z
b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEXAMPLE25lQGFt
YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+aEXAMPLE
EXAMPLEfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T
rDHudUZEXAMPLELG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE
Ibb3OhjZnzcvQAEXAMPLEWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4
nUhVVxYUntneD9+h8Mg9qEXAMPLEyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb
FFBjvSfpJIlJ00zbhNYS5f6GuoEDEXAMPLEBHjJnyp378OD8uTs7fLvjx79LjSTb
NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE=
-----END CERTIFICATE-----\n",
    "keyPair": {
        "PublicKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkEXAMPLEQEFAAOCAQ8AMIIBCgKCAQEAEXAMPLE1nnyJwKSMHw4h\nMMEXAMPLEuuN/dMAS3fyce8DW/4+EXAMPLEyjmoF/YVF/gHr99VEEXAMPLE5VF13\n59VK7cEXAMPLE67GK+y+jikqXOgHh/xJTwo+sGpWEXAMPLEDz18xOd2ka4tCzuWEXAMPLEahJbYkCPUBSU8opVkR7qkEXAMPLE1DR6sx2HocliOOLtu6Fkw91swQWEXAMPLE\GB3ZPrNh0PzQYvjUStZeccyNCx2EXAMPLEvp9mQOUXP6plfgxwKRX2fEXAMPLEDa\nhJLXkX3rHU2xbxJSq7D+XEXAMPLEcw+LyFhI5mgFRl88eGdsAEXAMPLElnI9EesG\nFQIDAQAB\n-----END PUBLIC KEY-----\n",
        "PrivateKey": "-----BEGIN RSA PRIVATE KEY-----\nkey omittted for security reasons\n-----END RSA PRIVATE KEY-----\n"
    }
}

Untuk informasi selengkapnya, lihat Membuat dan Mendaf AWS tarkan Sertifikat Perangkat AWS IoT di Panduan Pengembang IoT.

Contoh kode berikut menunjukkan cara menggunakancreate-mitigation-action.

AWS CLI

Untuk membuat tindakan mitigasi

create-mitigation-actionContoh berikut mendefinisikan tindakan mitigasi bernama AddThingsToQuarantineGroup1Action yang, ketika diterapkan, memindahkan hal-hal ke dalam grup benda bernamaQuarantineGroup1. Tindakan ini mengesampingkan grup benda dinamis.

aws iot create-mitigation-action --cli-input-json file::params.json

Isi dari params.json:

{
    "actionName": "AddThingsToQuarantineGroup1Action",
    "actionParams": {
        "addThingsToThingGroupParams": {
            "thingGroupNames": [
                "QuarantineGroup1"
            ],
            "overrideDynamicGroups": true
        }
    },
    "roleArn": "arn:aws:iam::123456789012:role/service-role/MoveThingsToQuarantineGroupRole"
}

Output:

{
    "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/AddThingsToQuarantineGroup1Action",
    "actionId": "992e9a63-a899-439a-aa50-4e20c52367e1"
}

Untuk informasi selengkapnya, lihat CreateMitigationAction (Perintah Tindakan Miti gasi) di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakancreate-ota-update.

AWS CLI

Untuk membuat pembaruan OTA untuk digunakan dengan Amazon FreeRTOS

create-ota-updateContoh berikut membuat AWS IoT OTAUpdate pada kelompok sasaran hal atau grup. Ini adalah bagian dari pembaruan over-the-air Amazon FreeRTOS yang memungkinkan Anda untuk menerapkan gambar firmware baru ke satu perangkat atau sekelompok perangkat.

aws iot create-ota-update \
    --cli-input-json file://create-ota-update.json

Isi dari create-ota-update.json:

{
    "otaUpdateId": "ota12345",
    "description": "A critical update needed right away.",
    "targets": [
        "device1",
        "device2",
        "device3",
        "device4"
    ],
    "targetSelection": "SNAPSHOT",
    "awsJobExecutionsRolloutConfig": {
        "maximumPerMinute": 10
    },
    "files": [
        {
          "fileName": "firmware.bin",
          "fileLocation": {
            "stream": {
              "streamId": "004",
              "fileId":123
            }
          },
          "codeSigning": {
            "awsSignerJobId": "48c67f3c-63bb-4f92-a98a-4ee0fbc2bef6"
          }
        }
    ]
    "roleArn": "arn:aws:iam:123456789012:role/service-role/my_ota_role"
}

Output:

{
     "otaUpdateId": "ota12345",
     "awsIotJobId": "job54321",
     "otaUpdateArn": "arn:aws:iot:us-west-2:123456789012:otaupdate/itsaupdate",
     "awsIotJobArn": "arn:aws:iot:us-west-2:123456789012:job/itsajob",
     "otaUpdateStatus": "CREATE_IN_PROGRESS"
}

Untuk informasi selengkapnya, lihat CreateOtaUpdate di Referensi API AWS IoT.

Contoh kode berikut menunjukkan cara menggunakancreate-policy-version.

AWS CLI

Untuk memperbarui kebijakan dengan versi baru

create-policy-versionContoh berikut memperbarui definisi kebijakan, membuat versi kebijakan baru. Contoh ini juga menjadikan versi baru default.

aws iot create-policy-version \
    --policy-name UpdateDeviceCertPolicy \
    --policy-document file://policy.json \
    --set-as-default

Isi dari policy.json:

{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action":  "iot:UpdateCertificate",
            "Resource": "*"
        }
    ]
}

Output:

{
    "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/UpdateDeviceCertPolicy",
    "policyDocument": "{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Effect\": \"Allow\", \"Action\":  \"iot:UpdateCertificate\", \"Resource\": \"*\" } ] }",
    "policyVersionId": "2",
    "isDefaultVersion": true
}

Untuk informasi selengkapnya, lihat Kebijakan AWS IoT di Panduan AWS Pengembang IoT.

Contoh kode berikut menunjukkan cara menggunakancreate-policy.

AWS CLI

Untuk membuat kebijakan AWS IoT

create-policyContoh berikut membuat kebijakan AWS IoT bernama TemperatureSensorPolicy. policy.jsonFile berisi pernyataan yang memungkinkan tindakan kebijakan AWS IoT.

aws iot create-policy \
    --policy-name TemperatureSensorPolicy \
    --policy-document file://policy.json

Isi dari policy.json:

{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "iot:Publish",
                "iot:Receive"
            ],
            "Resource": [
                "arn:aws:iot:us-west-2:123456789012:topic/topic_1",
                "arn:aws:iot:us-west-2:123456789012:topic/topic_2"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "iot:Subscribe"
            ],
            "Resource": [
                "arn:aws:iot:us-west-2:123456789012:topicfilter/topic_1",
                "arn:aws:iot:us-west-2:123456789012:topicfilter/topic_2"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "iot:Connect"
            ],
            "Resource": [
                "arn:aws:iot:us-west-2:123456789012:client/basicPubSub"
            ]
        }
    ]
}

Output:

{
    "policyName": "TemperatureSensorPolicy",
    "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/TemperatureSensorPolicy",
    "policyDocument": "{
        \"Version\": \"2012-10-17\",
        \"Statement\": [
            {
                \"Effect\": \"Allow\",
                \"Action\": [
                    \"iot:Publish\",
                    \"iot:Receive\"
                ],
                \"Resource\": [
                    \"arn:aws:iot:us-west-2:123456789012:topic/topic_1\",
                    \"arn:aws:iot:us-west-2:123456789012:topic/topic_2\"
                ]
            },
            {
                \"Effect\": \"Allow\",
                \"Action\": [
                    \"iot:Subscribe\"
                ],
                \"Resource\": [
                    \"arn:aws:iot:us-west-2:123456789012:topicfilter/topic_1\",
                    \"arn:aws:iot:us-west-2:123456789012:topicfilter/topic_2\"
                ]
            },
            {
                \"Effect\": \"Allow\",
                \"Action\": [
                    \"iot:Connect\"
                ],
                \"Resource\": [
                    \"arn:aws:iot:us-west-2:123456789012:client/basicPubSub\"
                ]
            }
        ]
    }",
    "policyVersionId": "1"
}

Untuk informasi selengkapnya, lihat Kebijakan AWS IoT di Panduan AWS Pengembang IoT.

  • Untuk detail API, lihat CreatePolicy di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakancreate-provisioning-claim.

AWS CLI

Untuk membuat klaim penyediaan

create-provisioning-claimContoh berikut membuat klaim penyediaan dari template penyediaan.

aws iot create-provisioning-claim \
    --template-name MyTestProvisioningTemplate

Output:

{
    "certificateId": "78de02184b2ce80cf8fb709bda59e62b19fb83513590483eb0434589476ab09f",
    "certificatePem": "-----BEGIN CERTIFICATE-----\nMIIDdzCCAl+gAwIBAgIUXSZhEBLztMLZ2fHG
14gV0NymYY0wDQYJKoZIhvcNAQEL\nBQAwfjELMAkGA1UEBhMCVVMxEzARBgNVBAgMCldhc2hpbmd0b24xEDAOBg
VBAcM\nB1NlYXR0bGUxGDAWBgNVBAoMD0FtYXpvbi5jb20gSW5jLjEgMB4GA1UECwwXQW1h\nem9uIElvVCBQcm9
2aXNpb25pbmcxDDAKBgNVBAUTAzEuMDAeFw0yMDA3MjgxNjQ0\nMDZaFw0yMDA3MjgxNjUxMDZaMEsxSTBHBgNVB
AMMQDFhNDEyM2VkNmIxYjU3MzE3\nZTgzMTJmY2MzN2FiNTdhY2MzYTZkZGVjOGQ5OGY3NzUwMWRlMjc0YjhmYTQ
xN2Iw\nggEiMA0GCSqGSIb3EXAMPLEAA4IBDwAwggEKAoIBAQDBhKI94ktKLqTwnj+ayOq1\nTAJt/N6s6IJDZvl
rYjkC0E7wzaeY3TprWk03S29vUzVuEOXHXQXZbihgpg2m6fza\nkWm9/wpjzE9ny5+xkPGVH4Wnwz7yK5m8S0agL
T96cRBSWnWmonOWdY0GKVzni0CA\n+iyGudgrFKm7Eae/v18oXrf82KtOAGO4xG0KE2WKYHsT1fx3c9xZhlXP/eX
Lhv00\n+lGp0WVw9PbhKfrxliKJ5q6sL5nVUaUHq6hlQPYwsATeOvAp3u0ak5zgTyL0fg7Y\nPyKk6VYwLW62r+V
YBSForEMOAhkq3LsP/rjxpEKmi2W4lPVS6oFZRKcD+H1Kyil5\nAgMBAAGjIDAeMAwGA1UdEwEB/wQCMAAwDgYDV
R0PAQH/BAQDAgeAMA0GCSqGSIb3\nDQEBCwUAA4IBAQAGgix2k6nVqbZFKq97/fZBzLGS0dyz5rT/E41cDIRX+1j
EPW41\nw0D+2sXheCZLZZnSkvIiP74IToNeXDrjdcaodeGFVHIElRjhMIq+4ZebPbRLtidF\nRc2hfcTAlqq9Z6v
5Vk6BeM1tu0RqH1wPoVUccLPya8EjNCbnJZUmGdOfrN/Y9pho\n5ikV+HPeZhG/k6dhE2GsQJyKFVHL/uBgKSily
1bRyWU1r6qcpWBNBHjUoD7HgOwD\nnzMh4XRb2FQDsqFalkCSYmeL8IVC49sgPD9Otyp5uteGMTy62usAAUQdq/f
ZvrWg\nOkFpwMVnGKVKT7Kg0kKOLzKWOBB2Jm4/gmrJ\n-----END CERTIFICATE-----\n",
    "keyPair": {
        "PublicKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCg
KCAQEAwYSiPeJLSi6k8J4/msjq\ntUwCbfzerOiCQ2b5a2I5AtBO8M2nmN06a1pNN0tvb1M1bhDlx10F2W4oYKYN
pun8\n2pFpvf8KY8xPZ8ufsZDxlR+Fp8M+8iuZvEtGoC0/enEQUlp1pqJzlnWNBilc54tA\ngPoshrnYKxSpuxGn
v79fKF63/NirTgBjuMRtChNlimEXAMPLE3PcWYZVz/3ly4b9\nNPpRqdFlcPT24Sn68ZYiieaurC+Z1VGlB6uoZU
D2MLAE3jrwKd7tGpOc4E8i9H4O\n2D8ipOlWMC1utq/lWAUhaKxDDgIZKty7D/648aRCpotluJT1UuqBWUSnA/h9
Ssop\neQIDAQAB\n-----END PUBLIC KEY-----\n",
        "PrivateKey": "-----BEGIN RSA PRIVATE KEY-----\nMIIEowIBAAKCAQEAwYSiPeJLSi6k8J4/
msjqtUwCbfzerOiCQ2b5a2I5AtBO8M2n\nmN06a1pNN0tvb1M1bhDlx10F2W4oYKYNpun82pFpvf8KY8xPZ8ufsZ
DxlR+Fp8M+\n8iuZvEtGoC0/enEQUlp1pqJzlnWNBilc54tAgPoshrnYKxSpuxGnv79fKF63/Nir\nTgBjuMRtCh
NlimB7E9X8d3PcWYZVz/3ly4b9NPpRqdFlcPT24Sn68ZYiieaurC+Z\n1VGlB6uoZUD2MLAE3jrwKd7tGpOc4E8i
9H4O2D8ipOlWMC1utq/lWAUhaKxDDgIZ\nKty7D/648aRCpotluJT1UuqBWUSnA/h9SsopeQIDAQABAoIBAEAybN
QUtx9T2/nK\ntZT2pA4iugecxI4dz+DmT0XVXs5VJmrx/nBSq6ejXExEpSIMO4RY7LE3ZdJcnd56\nF7tQkkY7yR
VzfxHeXFU1krOIPuxWebNOrRoPZr+1RSer+wv2aBC525+88pVuR6tM\nm3pgkrR2ycCj9FdOUoQxdjHBHaM5PDmJ
9aSxCKdg3nReepeGwsR2TQA+m2vVxWk7\nou0+91eTOP+/QfP7P8ZjOIkO2XivlRcVDyN/E4QXPKuIkM/8vS8VK+
E9pATQ0MtB\n2lw8R/YU5AJd6jlEXAMPLEGU2UzRzInNWiLtkPPPqgqXXhxOf+mxByjcMalVJk0L\nhOG2ROUCgY
EA+ROcHNHy/XbsP7FihOhEh+6Q2QxQ2ncBUPYbBazrR8Hn+7SCICQK\nVyYfd8Ajfq3e7RsKVL5SlMBp7Slidxak
bIn28fKfPn62DaemGCIoyDgLpF+eUxBx\ngzbCiBZga8brfurza43UZjKZLpg3hq721+FeAiXi1Nma4Yr9YWEHEN
8CgYEAxuWt\npzdWWmsiFzfsAw0sy9ySDA/xr5WRWzJyAqUsjsks6rxNzWebpufnYHcmtW7pLdqM\nkboHwN2pXa
kmZvrk2nKkEMq5brBYGDXuxDe+V369Bianx8aZFyIsckA7OwXW1w1h\ngRC5rQ4XOgp3+Jmw7eAO8LRYDjaN846+
QbtO2KcCgYAWS0UL51bijQR0ZwI0dz27\nFQVuCAYsp748aurcRTACCj8jbnK/QbqTNlxWsaH7ssBjZKo2D5sAqY
BRtASWODab\naHXsDhVm2Jye+ESLoHMaCLoyCkT3ll8yqXIcEDStMO7fO1Ryag164EiJvSIrMfny\nNL/fXVjCSH
/udCxdzPt+7QKBgQC+LAD7rxdr4J9538hTqpc4XK9vxRbrMXEH55XH\nHbMa2xONZXpmeTgEQBukyohCVceyRhK9
i0e6irZTjVXghOeoTpC8VXkzcnzouTiQ\neFQQSGfnp7Ioe6UIz23715pKduzSNkMSKrG924ktv7CyDBF1gBQI5g
aDoHnddJBJ\nPRTIZQKBgA8MASXtTxQntRwXXzR92U0vAighiuRkB/mx9jQpUcK1qiqHbkAMqgNF\nPFCBYIUbFT
iYKKKeJNbyJQvjfsJCkAnaFJ+RnTxk0Q6Wjm20peJ/ii4QiDdnigoE\nvdlc5cFQewWb4/zqAtPdinkPlN94ileI
79XQdc7RlJ0jpgTimL+V\n-----END RSA PRIVATE KEY-----\n"
    },
    "expiration": 1595955066.0
}

Untuk informasi selengkapnya, lihat Penyediaan oleh pengguna tepercaya di Panduan Peng AWS embang Inti IoT.

Contoh kode berikut menunjukkan cara menggunakancreate-provisioning-template-version.

AWS CLI

Untuk membuat versi templat penyediaan

Contoh berikut membuat versi untuk template penyediaan yang ditentukan. Tubuh versi baru disediakan dalam filetemplate.json.

aws iot create-provisioning-template-version \
    --template-name widget-template \
    --template-body file://template.json

Isi dari template.json:

{
    "Parameters" : {
        "DeviceLocation": {
            "Type": "String"
        }
    },
    "Mappings": {
        "LocationTable": {
            "Seattle": {
                "LocationUrl": "https://example.aws"
            }
        }
    },
    "Resources" : {
        "thing" : {
            "Type" : "AWS::IoT::Thing",
            "Properties" : {
                "AttributePayload" : {
                    "version" : "v1",
                    "serialNumber" : "serialNumber"
                },
                "ThingName" : {"Fn::Join":["",["ThingPrefix_",{"Ref":"SerialNumber"}]]},
                "ThingTypeName" : {"Fn::Join":["",["ThingTypePrefix_",{"Ref":"SerialNumber"}]]},
                "ThingGroups" : ["widgets", "WA"],
                "BillingGroup": "BillingGroup"
            },
            "OverrideSettings" : {
                "AttributePayload" : "MERGE",
                "ThingTypeName" : "REPLACE",
                "ThingGroups" : "DO_NOTHING"
            }
        },
        "certificate" : {
            "Type" : "AWS::IoT::Certificate",
            "Properties" : {
                "CertificateId": {"Ref": "AWS::IoT::Certificate::Id"},
                "Status" : "Active"
            }
        },
        "policy" : {
            "Type" : "AWS::IoT::Policy",
            "Properties" : {
                "PolicyDocument" : {
                    "Version":"2012-10-17",
                    "Statement": [{
                        "Effect": "Allow",
                        "Action":["iot:Publish"],
                        "Resource": ["arn:aws:iot:us-east-1:123456789012:topic/foo/bar"]
                    }]
                }
            }
        }
    },
    "DeviceConfiguration": {
        "FallbackUrl": "https://www.example.com/test-site",
        "LocationUrl": {
            "Fn::FindInMap": ["LocationTable",{"Ref": "DeviceLocation"}, "LocationUrl"]}
        }
    }
}

Output:

{
    "templateArn": "arn:aws:iot:us-east-1:123456789012:provisioningtemplate/widget-template",
    "templateName": "widget-template",
    "versionId": 2,
    "isDefaultVersion": false
}

Untuk informasi selengkapnya, lihat AWS IoT Secure Tunneling di Panduan Pengembang AWS IoT Core.

Contoh kode berikut menunjukkan cara menggunakancreate-provisioning-template.

AWS CLI

Untuk membuat templat penyediaan

create-provisioning-templateContoh berikut membuat template penyediaan seperti yang didefinisikan oleh filetemplate.json.

aws iot create-provisioning-template \
    --template-name widget-template \
    --description "A provisioning template for widgets" \
    --provisioning-role-arn arn:aws:iam::123456789012:role/Provision_role \
    --template-body file://template.json

Isi dari template.json:

{
    "Parameters" : {
        "DeviceLocation": {
            "Type": "String"
        }
    },
    "Mappings": {
        "LocationTable": {
            "Seattle": {
                "LocationUrl": "https://example.aws"
            }
        }
    },
    "Resources" : {
        "thing" : {
            "Type" : "AWS::IoT::Thing",
            "Properties" : {
                "AttributePayload" : {
                    "version" : "v1",
                    "serialNumber" : "serialNumber"
                },
                "ThingName" : {"Fn::Join":["",["ThingPrefix_",{"Ref":"SerialNumber"}]]},
                "ThingTypeName" : {"Fn::Join":["",["ThingTypePrefix_",{"Ref":"SerialNumber"}]]},
                "ThingGroups" : ["widgets", "WA"],
                "BillingGroup": "BillingGroup"
            },
            "OverrideSettings" : {
                "AttributePayload" : "MERGE",
                "ThingTypeName" : "REPLACE",
                "ThingGroups" : "DO_NOTHING"
            }
        },
        "certificate" : {
            "Type" : "AWS::IoT::Certificate",
            "Properties" : {
                "CertificateId": {"Ref": "AWS::IoT::Certificate::Id"},
                "Status" : "Active"
            }
        },
        "policy" : {
            "Type" : "AWS::IoT::Policy",
            "Properties" : {
                "PolicyDocument" : {
                    "Version":"2012-10-17",
                    "Statement": [{
                        "Effect": "Allow",
                        "Action":["iot:Publish"],
                        "Resource": ["arn:aws:iot:us-east-1:504350838278:topic/foo/bar"]
                    }]
                }
            }
        }
    },
    "DeviceConfiguration": {
        "FallbackUrl": "https://www.example.com/test-site",
        "LocationUrl": {
            "Fn::FindInMap": ["LocationTable",{"Ref": "DeviceLocation"}, "LocationUrl"]}
        }
    }
}

Output:

{
    "templateArn": "arn:aws:iot:us-east-1:123456789012:provisioningtemplate/widget-template",
    "templateName": "widget-template",
    "defaultVersionId": 1
}

Untuk informasi selengkapnya, lihat AWS IoT Secure Tunneling di Panduan Pengembang AWS IoT Core.

Contoh kode berikut menunjukkan cara menggunakancreate-role-alias.

AWS CLI

Untuk membuat alias peran

create-role-aliasContoh berikut membuat alias peran yang dipanggil LightBulbRole untuk peran yang ditentukan.

aws iot create-role-alias \
    --role-alias LightBulbRole \
    --role-arn arn:aws:iam::123456789012:role/lightbulbrole-001

Output:

{
    "roleAlias": "LightBulbRole",
    "roleAliasArn": "arn:aws:iot:us-west-2:123456789012:rolealias/LightBulbRole"
}

Untuk informasi selengkapnya, lihat CreateRoleAlias di Refer AWS ensi API IoT.

Contoh kode berikut menunjukkan cara menggunakancreate-scheduled-audit.

AWS CLI

Untuk membuat audit terjadwal

create-scheduled-auditContoh berikut membuat audit terjadwal yang berjalan setiap minggu, pada hari Rabu, untuk memeriksa apakah sertifikat CA atau sertifikat perangkat kedaluwarsa.

aws iot create-scheduled-audit \
    --scheduled-audit-name WednesdayCertCheck \
    --frequency WEEKLY \
    --day-of-week WED \
    --target-check-names CA_CERTIFICATE_EXPIRING_CHECK DEVICE_CERTIFICATE_EXPIRING_CHECK

Output:

{
    "scheduledAuditArn": "arn:aws:iot:us-west-2:123456789012:scheduledaudit/WednesdayCertCheck"
}

Untuk informasi selengkapnya, lihat Perintah Audit di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakancreate-security-profile.

AWS CLI

Untuk membuat profil keamanan

create-security-profileContoh berikut membuat profil keamanan yang memeriksa apakah bandwidth seluler melebihi ambang batas atau jika lebih dari 10 kegagalan otorisasi terjadi dalam periode lima menit.

aws iot create-security-profile \
    --security-profile-name PossibleIssue \
    --security-profile-description "Check to see if authorization fails 10 times in 5 minutes or if cellular bandwidth exceeds 128"  \
    --behaviors "[{\"name\":\"CellularBandwidth\",\"metric\":\"aws:message-byte-size\",\"criteria\":{\"comparisonOperator\":\"greater-than\",\"value\":{\"count\":128},\"consecutiveDatapointsToAlarm\":1,\"consecutiveDatapointsToClear\":1}},{\"name\":\"Authorization\",\"metric\":\"aws:num-authorization-failures\",\"criteria\":{\"comparisonOperator\":\"less-than\",\"value\":{\"count\":10},\"durationSeconds\":300,\"consecutiveDatapointsToAlarm\":1,\"consecutiveDatapointsToClear\":1}}]"

Output:

{
    "securityProfileName": "PossibleIssue",
    "securityProfileArn": "arn:aws:iot:us-west-2:123456789012:securityprofile/PossibleIssue"
}

Untuk informasi selengkapnya, lihat Mendeteksi Perintah di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakancreate-stream.

AWS CLI

Untuk membuat aliran untuk mengirimkan satu atau lebih file besar dalam potongan melalui MQTT

create-streamContoh berikut membuat aliran untuk mengirimkan satu atau lebih file besar dalam potongan melalui MQTT. Aliran mengangkut byte data dalam potongan atau blok yang dikemas sebagai pesan MQTT dari sumber seperti S3. Anda dapat memiliki satu atau lebih file yang terkait dengan aliran.

aws iot create-stream \
    --cli-input-json file://create-stream.json

Isi dari create-stream.json:

{
    "streamId": "stream12345",
    "description": "This stream is used for Amazon FreeRTOS OTA Update 12345.",
    "files": [
        {
            "fileId": 123,
            "s3Location": {
                "bucket":"codesign-ota-bucket",
                "key":"48c67f3c-63bb-4f92-a98a-4ee0fbc2bef6"
            }
        }
    ],
    "roleArn": "arn:aws:iam:123456789012:role/service-role/my_ota_stream_role"
}

Output:

{
     "streamId": "stream12345",
     "streamArn": "arn:aws:iot:us-west-2:123456789012:stream/stream12345",
     "description": "This stream is used for Amazon FreeRTOS OTA Update 12345.",
     "streamVersion": "1"
}

Untuk informasi selengkapnya, lihat CreateStream di Refer AWS ensi API IoT.

  • Untuk detail API, lihat CreateStream di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakancreate-thing-group.

AWS CLI

Contoh 1: Untuk membuat grup benda

create-thing-groupContoh berikut membuat grup benda bernama LightBulbs dengan deskripsi dan dua atribut.

aws iot create-thing-group \
    --thing-group-name LightBulbs \
    --thing-group-properties "thingGroupDescription=\"Generic bulb group\", attributePayload={attributes={Manufacturer=AnyCompany,wattage=60}}"

Output:

{
    "thingGroupName": "LightBulbs",
    "thingGroupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs",
    "thingGroupId": "9198bf9f-1e76-4a88-8e8c-e7140142c331"
}

Contoh 2: Untuk membuat grup benda yang merupakan bagian dari grup induk

Berikut ini create-thing-group membuat grup benda bernama HalogenBulbs yang memiliki nama grup benda indukLightBulbs.

aws iot create-thing-group \
    --thing-group-name HalogenBulbs \
    --parent-group-name LightBulbs

Output:

{
    "thingGroupName": "HalogenBulbs",
    "thingGroupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/HalogenBulbs",
    "thingGroupId": "f4ec6b84-b42b-499d-9ce1-4dbd4d4f6f6e"
}

Untuk informasi selengkapnya, lihat Grup Hal di Panduan AWS Pengembang IoT.

Contoh kode berikut menunjukkan cara menggunakancreate-thing-type.

AWS CLI

Untuk mendefinisikan jenis benda

create-thing-typeContoh berikut mendefinisikan jenis benda dan atribut terkait.

aws iot create-thing-type \
    --thing-type-name "LightBulb" \
    --thing-type-properties "thingTypeDescription=light bulb type, searchableAttributes=wattage,model"

Output:

{
    "thingTypeName": "LightBulb",
    "thingTypeArn": "arn:aws:iot:us-west-2:123456789012:thingtype/LightBulb",
    "thingTypeId": "ce3573b0-0a3c-45a7-ac93-4e0ce14cd190"
}

Untuk informasi selengkapnya, lihat Jenis Hal di Panduan AWS Pengembang IoT.

Contoh kode berikut menunjukkan cara menggunakancreate-thing.

AWS CLI

Contoh 1: Untuk membuat catatan sesuatu di registri

create-thingContoh berikut membuat entri untuk perangkat di registri benda AWS IoT.

aws iot create-thing \
    --thing-name SampleIoTThing

Output:

{
    "thingName": "SampleIoTThing",
    "thingArn": "arn:aws:iot:us-west-2: 123456789012:thing/SampleIoTThing",
    "thingId": " EXAMPLE1-90ab-cdef-fedc-ba987EXAMPLE "
}

Contoh 2: Untuk mendefinisikan sesuatu yang terkait dengan tipe benda

create-thingContoh berikut membuat sesuatu yang memiliki tipe benda yang ditentukan dan atributnya.

aws iot create-thing \
    --thing-name "MyLightBulb" \
    --thing-type-name "LightBulb" \
    --attribute-payload "{"attributes": {"wattage":"75", "model":"123"}}"

Output:

{
    "thingName": "MyLightBulb",
    "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyLightBulb",
    "thingId": "40da2e73-c6af-406e-b415-15acae538797"
}

Untuk informasi selengkapnya, lihat Cara Mengelola Hal-hal dengan Jenis Registr i dan Hal di Panduan Pengembang AWS IoT.

  • Untuk detail API, lihat CreateThing di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakancreate-topic-rule-destination.

AWS CLI

Untuk membuat tujuan aturan topik

create-topic-rule-destinationContoh berikut membuat tujuan aturan topik untuk titik akhir HTTP.

aws iot create-topic-rule-destination \
    --destination-configuration httpUrlConfiguration={confirmationUrl=https://example.com}

Output:

{
    "topicRuleDestination": {
        "arn": "arn:aws:iot:us-west-2:123456789012:ruledestination/http/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
        "status": "IN_PROGRESS",
        "statusReason": "Awaiting confirmation. Confirmation message sent on 2020-07-09T22:47:54.154Z; no response received from the endpoint.",
        "httpUrlProperties": {
            "confirmationUrl": "https://example.com"
        }
    }
}

Untuk informasi selengkapnya, lihat Membuat tujuan aturan topik di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakancreate-topic-rule.

AWS CLI

Untuk membuat aturan yang mengirimkan peringatan Amazon SNS

create-topic-ruleContoh berikut membuat aturan yang mengirimkan pesan Amazon SNS saat pembacaan tingkat kelembaban tanah, seperti yang ditemukan dalam bayangan perangkat, rendah.

aws iot create-topic-rule \
    --rule-name "LowMoistureRule" \
    --topic-rule-payload file://plant-rule.json

Contoh membutuhkan kode JSON berikut untuk disimpan ke file bernamaplant-rule.json:

{
    "sql": "SELECT * FROM '$aws/things/MyRPi/shadow/update/accepted' WHERE state.reported.moisture = 'low'\n",
    "description": "Sends an alert whenever soil moisture level readings are too low.",
    "ruleDisabled": false,
    "awsIotSqlVersion": "2016-03-23",
    "actions": [{
            "sns": {
                "targetArn": "arn:aws:sns:us-west-2:123456789012:MyRPiLowMoistureTopic",
                "roleArn": "arn:aws:iam::123456789012:role/service-role/MyRPiLowMoistureTopicRole",
                "messageFormat": "RAW"
            }
    }]
}

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Membuat AWS Aturan IoT di Panduan AWS Pengembang IoT.

Contoh kode berikut menunjukkan cara menggunakandelete-account-audit-configuration.

AWS CLI

Untuk menonaktifkan semua pemeriksaan audit untuk AWS akun Anda

delete-account-audit-configurationContoh berikut mengembalikan pengaturan default untuk AWS IoT Device Defender untuk akun ini, menonaktifkan semua pemeriksaan audit dan menghapus data konfigurasi. Ini juga menghapus audit terjadwal untuk akun ini. Gunakan perintah ini dengan hati-hati. 

aws iot delete-account-audit-configuration \
    --delete-scheduled-audits

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Perintah Audit di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandelete-audit-suppression.

AWS CLI

Untuk menghapus penekanan temuan audit

delete-audit-suppressionContoh berikut menghapus penekanan penemuan audit untuk DEVICE_CERTIFICATE_EXPIRING_CHECK.

aws iot delete-audit-suppression \
    --check-name DEVICE_CERTIFICATE_EXPIRING_CHECK \
    --resource-identifier deviceCertificateId="c7691e<shortened>"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Penekanan pencarian audit di Panduan Peng AWS embang IoT.

Contoh kode berikut menunjukkan cara menggunakandelete-authorizer.

AWS CLI

Untuk menghapus otorisasi kustom

delete-authorizerContoh berikut menghapus otorizer bernama. CustomAuthorizer Authorizer kustom harus berada dalam INACTIVE status sebelum Anda dapat menghapusnya.

aws iot delete-authorizer \
    --authorizer-name CustomAuthorizer

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat DeleteAuthorizer di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandelete-billing-group.

AWS CLI

Untuk menghapus grup penagihan

delete-billing-groupContoh berikut menghapus grup penagihan yang ditentukan. Anda dapat menghapus grup penagihan meskipun berisi satu atau lebih hal.

aws iot delete-billing-group \
    --billing-group-name BillingGroupTwo

Perintah ini tidak menghasilkan output apa pun.

Untuk informasi selengkapnya, lihat Grup Penagihan di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandelete-ca-certificate.

AWS CLI

Untuk menghapus sertifikat CA

delete-ca-certificateContoh berikut menghapus sertifikat CA dengan ID sertifikat yang ditentukan.

aws iot delete-ca-certificate \
    --certificate-id f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat DeleteCacertificate di Referensi API IoT. AWS

Contoh kode berikut menunjukkan cara menggunakandelete-certificate.

AWS CLI

Untuk menghapus sertifikat perangkat

delete-certificateContoh berikut menghapus sertifikat perangkat dengan ID yang ditentukan.

aws iot delete-certificate \
    --certificate-id c0c57bbc8baaf4631a9a0345c957657f5e710473e3ddbee1428d216d54d53ac9

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat DeleteCertificate di Refer AWS ensi API IoT.

Contoh kode berikut menunjukkan cara menggunakandelete-custom-metric.

AWS CLI

Untuk menghapus metrik khusus

delete-custom-metricContoh berikut menghapus metrik kustom.

aws iot delete-custom-metric \
    --metric-name batteryPercentage \
    --region us-east-1

Output:

HTTP 200

Untuk informasi selengkapnya, lihat Metrik khusus di Panduan Pengembang AWS IoT Core.

Contoh kode berikut menunjukkan cara menggunakandelete-dimension.

AWS CLI

Untuk menghapus dimensi

delete-dimensionContoh berikut menghapus dimensi yang disebutTopicFilterForAuthMessages.

aws iot delete-dimension \
    --name TopicFilterForAuthMessages

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mendeteksi Perintah di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandelete-domain-configuration.

AWS CLI

Untuk menghapus konfigurasi domain

delete-domain-configurationContoh berikut menghapus konfigurasi domain bernama additionalDataDomain dari AWS akun Anda.

aws iot delete-domain-configuration \
    --domain-configuration-name "additionalDataDomain" \
    --domain-configuration-status "OK"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat T itik Akhir yang Dapat Dikonfigurasi di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandelete-dynamic-thing-group.

AWS CLI

Untuk menghapus grup benda dinamis

delete-dynamic-thing-groupContoh berikut menghapus grup benda dinamis yang ditentukan.

aws iot delete-dynamic-thing-group \
    --thing-group-name "RoomTooWarm"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Grup Hal Din amis di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandelete-job-execution.

AWS CLI

Untuk menghapus eksekusi pekerjaan

delete-job-executionContoh berikut menghapus eksekusi pekerjaan dari pekerjaan yang ditentukan pada perangkat. Gunakan describe-job-execution untuk mendapatkan nomor eksekusi.

aws iot delete-job-execution
    --job-id "example-job-02"
    --thing-name "MyRaspberryPi"
    --execution-number 1

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Membuat dan Mengelola Pekerjaan (CLI) di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandelete-job.

AWS CLI

Untuk menghapus pekerjaan

delete-jobContoh berikut menghapus pekerjaan yang ditentukan. Dengan menentukan --force opsi, pekerjaan akan dihapus meskipun statusnya adaIN_PROGRESS.

aws iot delete-job \
    --job-id "example-job-04" \
    --force

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Membuat dan Mengelola Pekerjaan (CLI) di Panduan Pengembang AWS IoT.

  • Untuk detail API, lihat DeleteJob di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakandelete-mitigation-action.

AWS CLI

Untuk menghapus tindakan mitigasi

delete-mitigation-actionContoh berikut menghapus tindakan mitigasi yang ditentukan.

aws iot delete-mitigation-action \
    --action-name AddThingsToQuarantineGroup1Action

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat DeleteMitigationAction (Perintah Tindakan Miti gasi) di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandelete-ota-update.

AWS CLI

Untuk menghapus pembaruan OTA

delete-ota-updateContoh berikut menghapus pembaruan OTA yang ditentukan.

aws iot delete-ota-update \
    --ota-update-id ota12345 \
    --delete-stream \
    --force-delete-aws-job

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat DeMeteotaUpdate di Referensi API AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandelete-policy-version.

AWS CLI

Untuk menghapus versi kebijakan

delete-policy-versionContoh berikut menghapus versi 2 dari kebijakan yang ditentukan dari AWS akun Anda.

aws iot delete-policy-version \
    --policy-name UpdateDeviceCertPolicy \
    --policy-version-id 2

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Kebijakan AWS IoT di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandelete-policy.

AWS CLI

Untuk menghapus kebijakan

delete-policyContoh berikut menghapus kebijakan yang ditentukan dari AWS akun Anda.

aws iot delete-policy --policy-name UpdateDeviceCertPolicy

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Kebijakan AWS IoT di Panduan AWS Pengembang IoT.

  • Untuk detail API, lihat DeletePolicy di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakandelete-provisioning-template-version.

AWS CLI

Untuk menghapus versi templat penyediaan

delete-provisioning-template-versionContoh berikut menghapus versi 2 dari template penyediaan yang ditentukan.

aws iot delete-provisioning-template-version \
    --version-id 2 \
    --template-name "widget-template"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat AWS IoT Secure Tunneling di Panduan Pengembang AWS IoT Core.

Contoh kode berikut menunjukkan cara menggunakandelete-provisioning-template.

AWS CLI

Untuk menghapus templat penyediaan

delete-provisioning-templateContoh berikut menghapus template penyediaan yang ditentukan.

aws iot delete-provisioning-template \
    --template-name widget-template

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat AWS IoT Secure Tunneling di Panduan Pengembang AWS IoT Core.

Contoh kode berikut menunjukkan cara menggunakandelete-registration-code.

AWS CLI

Untuk menghapus kode pendaftaran Anda

delete-registration-codeContoh berikut menghapus kode pendaftaran khusus akun AWS IoT.

aws iot delete-registration-code

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menggunakan Sertifikat Sen diri di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandelete-role-alias.

AWS CLI

Untuk menghapus alias peran AWS IoT

delete-role-aliasContoh berikut menghapus nama LightBulbRole alias peran AWS IoT.

aws iot delete-role-alias \
    --role-alias LightBulbRole

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mengotorisasi Panggilan Langsung ke AWS Layanan di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandelete-scheduled-audit.

AWS CLI

Untuk menghapus audit terjadwal

delete-scheduled-auditContoh berikut menghapus audit terjadwal AWS IoT Device Defender bernamaAWSIoTDeviceDefenderDailyAudit.

aws iot delete-scheduled-audit \
    --scheduled-audit-name AWSIoTDeviceDefenderDailyAudit

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Perintah Audit di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandelete-security-profile.

AWS CLI

Untuk menghapus profil keamanan

delete-security-profileContoh berikut menghapus profil keamanan bernamaPossibleIssue.

aws iot delete-security-profile \
    --security-profile-name PossibleIssue

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mendeteksi Perintah di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandelete-stream.

AWS CLI

Untuk menghapus aliran

delete-streamContoh berikut menghapus aliran yang ditentukan.

aws iot delete-stream \
    --stream-id stream12345

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat DeleteStream di Refer AWS ensi API IoT.

  • Untuk detail API, lihat DeleteStream di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakandelete-thing-group.

AWS CLI

Untuk menghapus grup benda

delete-thing-groupContoh berikut menghapus grup hal yang ditentukan. Anda tidak dapat menghapus grup benda jika berisi grup benda anak.

aws iot delete-thing-group \
    --thing-group-name DefectiveBulbs

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Grup Hal di Panduan AWS Pengembang IoT.

Contoh kode berikut menunjukkan cara menggunakandelete-thing-type.

AWS CLI

Contoh 1: Untuk menghapus jenis benda

delete-thing-typeContoh berikut menghapus jenis benda yang tidak digunakan lagi.

aws iot delete-thing-type \
    --thing-type-name "obsoleteThingType"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Jenis Hal di Panduan AWS Pengembang IoT.

Contoh kode berikut menunjukkan cara menggunakandelete-thing.

AWS CLI

Untuk menampilkan informasi terperinci tentang sesuatu

delete-thingContoh berikut menghapus sesuatu dari registri AWS IoT untuk AWS akun Anda.

aws iot menghapus-benda --nama-benda "” FourthBulb

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Cara Mengelola Hal dengan Registr i di Panduan AWS Pengembang IoT.

  • Untuk detail API, lihat DeleteThing di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakandelete-topic-rule-destination.

AWS CLI

Untuk menghapus tujuan aturan topik

delete-topic-rule-destinationContoh berikut menghapus tujuan aturan topik yang ditentukan.

aws iot delete-topic-rule-destination \
    --arn "arn:aws:iot:us-west-2:123456789012:ruledestination/http/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menghapus tujuan aturan topik di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandelete-topic-rule.

AWS CLI

Untuk menghapus aturan

delete-topic-ruleContoh berikut menghapus aturan yang ditentukan.

aws iot delete-topic-rule \
    --rule-name "LowMoistureRule"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menghapus Aturan di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandelete-v2-logging-level.

AWS CLI

Untuk menghapus level logging untuk grup benda

delete-v2-logging-levelContoh berikut menghapus level logging untuk grup benda yang ditentukan.

aws iot delete-v2-logging-level \
    --target-type THING_GROUP \
    --target-name LightBulbs

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakandeprecate-thing-type.

AWS CLI

Contoh 1: Untuk menghentikan jenis benda

deprecate-thing-typeContoh berikut menghentikan jenis benda sehingga pengguna tidak dapat mengaitkan hal baru dengannya.

aws iot deprecate-thing-type \
    --thing-type-name "obsoleteThingType"

Perintah ini tidak menghasilkan output.

Contoh 2: Untuk membalikkan penghentian jenis benda

deprecate-thing-typeContoh berikut membalikkan penghentian jenis benda, yang memungkinkan pengguna untuk mengaitkan hal-hal baru dengannya lagi.

aws iot deprecate-thing-type \
    --thing-type-name "obsoleteThingType" \
    --undo-deprecate

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Jenis Hal di Panduan AWS Pengembang IoT.

Contoh kode berikut menunjukkan cara menggunakandescribe-account-audit-configuration.

AWS CLI

Untuk melihat setelan konfigurasi audit saat ini

describe-account-audit-configurationContoh berikut mencantumkan pengaturan saat ini untuk konfigurasi audit AWS IoT Device Defender Anda.

aws iot describe-account-audit-configuration

Output:

{
    "roleArn": "arn:aws:iam::123456789012:role/service-role/AWSIoTDeviceDefenderAudit_1551201085996",
    "auditNotificationTargetConfigurations": {
        "SNS": {
            "targetArn": "arn:aws:sns:us-west-2:123456789012:ddaudits",
            "roleArn": "arn:aws:iam::123456789012:role/service-role/AWSIoTDeviceDefenderAudit",
            "enabled": true
        }
    },
    "auditCheckConfigurations": {
        "AUTHENTICATED_COGNITO_ROLE_OVERLY_PERMISSIVE_CHECK": {
            "enabled": true
        },
        "CA_CERTIFICATE_EXPIRING_CHECK": {
            "enabled": true
        },
        "CONFLICTING_CLIENT_IDS_CHECK": {
            "enabled": true
        },
        "DEVICE_CERTIFICATE_EXPIRING_CHECK": {
            "enabled": true
        },
        "DEVICE_CERTIFICATE_SHARED_CHECK": {
            "enabled": true
        },
        "IOT_POLICY_OVERLY_PERMISSIVE_CHECK": {
            "enabled": true
        },
        "LOGGING_DISABLED_CHECK": {
            "enabled": true
        },
        "REVOKED_CA_CERTIFICATE_STILL_ACTIVE_CHECK": {
            "enabled": true
        },
        "REVOKED_DEVICE_CERTIFICATE_STILL_ACTIVE_CHECK": {
            "enabled": true
        },
        "UNAUTHENTICATED_COGNITO_ROLE_OVERLY_PERMISSIVE_CHECK": {
            "enabled": true
        }
    }
}

Untuk informasi selengkapnya, lihat Perintah Audit di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandescribe-audit-finding.

AWS CLI

Untuk membuat daftar detail untuk temuan audit

describe-audit-findingContoh berikut mencantumkan detail untuk temuan audit AWS IoT Device Defender yang ditentukan. Audit dapat menghasilkan beberapa temuan. Gunakan list-audit-findings perintah untuk mendapatkan daftar temuan dari audit untuk mendapatkanfindingId.

aws iot describe-audit-finding \
    --finding-id "ef4826b8-e55a-44b9-b460-5c485355371b"

Output:

{
    "finding": {
        "findingId": "ef4826b8-e55a-44b9-b460-5c485355371b",
        "taskId": "873ed69c74a9ec8fa9b8e88e9abc4661",
        "checkName": "IOT_POLICY_OVERLY_PERMISSIVE_CHECK",
        "taskStartTime": 1576012045.745,
        "findingTime": 1576012046.168,
        "severity": "CRITICAL",
        "nonCompliantResource": {
            "resourceType": "IOT_POLICY",
            "resourceIdentifier": {
                "policyVersionIdentifier": {
                    "policyName": "smp-ggrass-group_Core-policy",
                    "policyVersionId": "1"
                }
            }
         },
        "reasonForNonCompliance": "Policy allows broad access to IoT data plane actions: [iot:Subscribe, iot:Connect, iot:GetThingShadow, iot:DeleteThingShadow, iot:UpdateThingShadow, iot:Publish].",
        "reasonForNonComplianceCode": "ALLOWS_BROAD_ACCESS_TO_IOT_DATA_PLANE_ACTIONS"
    }
}

Untuk informasi selengkapnya, lihat Periksa Hasil Audit (Perintah Audit) di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandescribe-audit-mitigation-actions-task.

AWS CLI

Untuk menampilkan rincian tugas tindakan mitigasi audit

describe-audit-mitigation-actions-taskContoh berikut menunjukkan detail untuk tugas yang ditentukan, di mana ResetPolicyVersionAction itu diterapkan pada temuan. Hasilnya termasuk kapan tugas dimulai dan berakhir, berapa banyak temuan yang ditargetkan (dan hasilnya), dan definisi tindakan yang diterapkan sebagai bagian dari tugas ini.

aws iot describe-audit-mitigation-actions-task \
    --task-id ResetPolicyTask01

Output:

{
    "taskStatus": "COMPLETED",
    "startTime": "2019-12-10T15:13:19.457000-08:00",
    "endTime": "2019-12-10T15:13:19.947000-08:00",
    "taskStatistics": {
        "IOT_POLICY_OVERLY_PERMISSIVE_CHECK": {
            "totalFindingsCount": 1,
            "failedFindingsCount": 0,
            "succeededFindingsCount": 1,
            "skippedFindingsCount": 0,
            "canceledFindingsCount": 0
        }
    },
    "target": {
        "findingIds": [
            "ef4826b8-e55a-44b9-b460-5c485355371b"
        ]
    },
    "auditCheckToActionsMapping": {
        "IOT_POLICY_OVERLY_PERMISSIVE_CHECK": [
            "ResetPolicyVersionAction"
        ]
    },
    "actionsDefinition": [
        {
            "name": "ResetPolicyVersionAction",
            "id": "1ea0b415-bef1-4a01-bd13-72fb63c59afb",
            "roleArn": "arn:aws:iam::123456789012:role/service-role/ReplacePolicyVersionRole",
            "actionParams": {
                "replaceDefaultPolicyVersionParams": {
                    "templateName": "BLANK_POLICY"
                }
            }
        }
    ]
}

Untuk informasi selengkapnya, lihat DescribeAuditMitigationActionsTask (Perintah Tindakan Miti gasi) di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandescribe-audit-suppression.

AWS CLI

Untuk mendapatkan detail tentang penekanan temuan audit

describe-audit-suppressionContoh berikut mencantumkan detail tentang penindasan temuan audit.

aws iot describe-audit-task \
    --task-id "787ed873b69cb4d6cdbae6ddd06996c5"

Output:

{
    "taskStatus": "COMPLETED",
    "taskType": "SCHEDULED_AUDIT_TASK",
    "taskStartTime": 1596168096.157,
    "taskStatistics": {
        "totalChecks": 1,
        "inProgressChecks": 0,
        "waitingForDataCollectionChecks": 0,
        "compliantChecks": 0,
        "nonCompliantChecks": 1,
        "failedChecks": 0,
        "canceledChecks": 0
    },
    "scheduledAuditName": "AWSIoTDeviceDefenderDailyAudit",
    "auditDetails": {
        "DEVICE_CERTIFICATE_EXPIRING_CHECK": {
            "checkRunStatus": "COMPLETED_NON_COMPLIANT",
            "checkCompliant": false,
            "totalResourcesCount": 195,
            "nonCompliantResourcesCount": 2
        }
    }
}

Untuk informasi selengkapnya, lihat Penekanan pencarian audit di Panduan Peng AWS embang IoT.

Contoh kode berikut menunjukkan cara menggunakandescribe-audit-task.

AWS CLI

Untuk mendapatkan informasi tentang instance audit

describe-audit-taskContoh berikut mendapatkan informasi tentang instance audit AWS IoT Device Defender. Jika audit selesai, statistik ringkasan untuk proses disertakan dalam hasil.

aws iot describe-audit-task \
    --task-id a3aea009955e501a31b764abe1bebd3d

Output:

 {
    "taskStatus": "COMPLETED",
    "taskType": "ON_DEMAND_AUDIT_TASK",
    "taskStartTime": 1560356923.434,
    "taskStatistics": {
        "totalChecks": 3,
        "inProgressChecks": 0,
        "waitingForDataCollectionChecks": 0,
        "compliantChecks": 3,
        "nonCompliantChecks": 0,
        "failedChecks": 0,
        "canceledChecks": 0
    },
    "auditDetails": {
        "CA_CERTIFICATE_EXPIRING_CHECK": {
            "checkRunStatus": "COMPLETED_COMPLIANT",
            "checkCompliant": true,
            "totalResourcesCount": 0,
            "nonCompliantResourcesCount": 0
        },
        "DEVICE_CERTIFICATE_EXPIRING_CHECK": {
            "checkRunStatus": "COMPLETED_COMPLIANT",
            "checkCompliant": true,
            "totalResourcesCount": 6,
            "nonCompliantResourcesCount": 0
        },
        "REVOKED_CA_CERTIFICATE_STILL_ACTIVE_CHECK": {
            "checkRunStatus": "COMPLETED_COMPLIANT",
            "checkCompliant": true,
            "totalResourcesCount": 0,
            "nonCompliantResourcesCount": 0
        }
    }
}

Untuk informasi selengkapnya, lihat Perintah Audit di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandescribe-authorizer.

AWS CLI

Untuk mendapatkan informasi tentang otorizer kustom

describe-authorizerContoh berikut menampilkan detail untuk otorizer kustom yang ditentukan.

aws iot describe-authorizer \
    --authorizer-name CustomAuthorizer

Output:

{
    "authorizerDescription": {
        "authorizerName": "CustomAuthorizer",
        "authorizerArn": "arn:aws:iot:us-west-2:123456789012:authorizer/CustomAuthorizer",
        "authorizerFunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:CustomAuthorizerFunction",
        "tokenKeyName": "MyAuthToken",
        "tokenSigningPublicKeys": {
            "FIRST_KEY": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA1uJOB4lQPgG/lM6ZfIwo\nZ+7ENxAio9q6QD4FFqjGZsvjtYwjoe1RKK0U8Eq9xb5O3kRSmyIwTzwzm/f4Gf0Y\nZUloJ+t3PUUwHrmbYTAgTrCUgRFygjfgVwGCPs5ZAX4Eyqt5cr+AIHIiUDbxSa7p\nzwOBKPeic0asNJpqT8PkBbRaKyleJh5oo81NDHHmVtbBm5A5YiJjqYXLaVAowKzZ\n+GqsNvAQ9Jy1wI2VrEa1OfL8flDB/BJLm7zjpfPOHDJQgID0XnZwAlNnZcOhCwIx\n50g2LW2Oy9R/dmqtDmJiVP97Z4GykxPvwlYHrUXY0iW1R3AR/Ac1NhCTGZMwVDB1\nlQIDAQAB\n-----END PUBLIC KEY-----"
        },
        "status": "ACTIVE",
        "creationDate": 1571245658.069,
        "lastModifiedDate": 1571245658.069
    }
}

Untuk informasi selengkapnya, lihat DescribeAuthorizer di Refer AWS ensi API IoT.

Contoh kode berikut menunjukkan cara menggunakandescribe-billing-group.

AWS CLI

Untuk mendapatkan informasi tentang grup penagihan

describe-billing-groupContoh berikut mendapatkan informasi untuk grup penagihan yang ditentukan.

aws iot describe-billing-group --billing-group-name GroupOne

Output:

{
    "billingGroupName": "GroupOne",
    "billingGroupId": "103de383-114b-4f51-8266-18f209ef5562",
    "billingGroupArn": "arn:aws:iot:us-west-2:123456789012:billinggroup/GroupOne",
    "version": 1,
    "billingGroupProperties": {},
    "billingGroupMetadata": {
        "creationDate": 1560199355.378
    }
}

Untuk informasi selengkapnya, lihat Grup Penagihan di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandescribe-ca-certificate.

AWS CLI

Untuk mendapatkan detail tentang sertifikat CA

describe-ca-certificateContoh berikut menampilkan detail untuk sertifikat CA yang ditentukan.

aws iot describe-ca-certificate \
    --certificate-id f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467

Output:

{
    "certificateDescription": {
        "certificateArn": "arn:aws:iot:us-west-2:123456789012:cacert/f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467",
        "certificateId": "f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467",
        "status": "INACTIVE",
        "certificatePem": "-----BEGIN CERTIFICATE-----\nMIICzzCCAbegEXAMPLEJANVEPWXl8taPMA0GCSqGSIb3DQEBBQUAMB4xCzAJBgNV\nBAYTAlVTMQ8wDQYDVQQKDAZBbWF6b24wHhcNMTkwOTI0MjEzMTE1WhcNMjkwOTIx\nMjEzMTE1WjAeMQswCQYDVQQGEwJVUzEPMA0GA1UECgwGQW1hem9uMIIBIjANBgkq\nhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAzd3R3ioalCS0MhFWfBrVGR036EK07UAf\nVdz9EXAMPLE1VczICbADnATK522kEIB51/18VzlFtAhQL5V5eybXKnB7QebNer5m\n4Yibx7shR5oqNzFsrXWxuugN5+w5gEfqNMawOjhF4LsculKG49yuqjcDU19/13ua\n3B2gxs1Pe7TiWWvUskzxnbO1F2WCshbEJvqY8fIWtGYCjTeJAgQ9hvZx/69XhKen\nwV9LJwOQxrsUS0Ty8IHwbB8fRy72VM3u7fJoaU+nO4jD5cqaoEPtzoeFUEXAMPLE\nyVAJpqHwgbYbcUfn7V+AB6yh1+0Fa1rEQGuZDPGyJslxwr5vh8nRewIDAQABoxAw\nDjAMBgNVHRMEBTADAQH/MA0GCSqGSIb3DQEBBQUAA4IBAQA+3a5CV3IJgOnd0AgI\nBgVMtmYzTvqAngx26aG9/spvCjXckh2SBF+EcBlCFwH1yakwjJL1dR4yarnrfxgI\nEqP4AOYVimAVoQ5FBwnloHe16+3qtDiblU9DeXBUCtS55EcfrEXAMPLEYtXdqU5C\nU9ia4KAjV0dxW1+EFYMwX5eGeb0gDTNHBylV6B/fOSZiQAwDYp4x3B+gAP+a/bWB\nu1umOqtBdWe6L6/83L+JhaTByqV25iVJ4c/UZUnG8926wUlDM9zQvEXuEVvzZ7+m\n4PSNqst/nVOvnLpoG4e0WgcJgANuB33CSWtjWSuYsbhmqQRknGhREXAMPLEZT4fm\nfo0e\n-----END CERTIFICATE-----\n",
        "ownedBy": "123456789012",
        "creationDate": 1569365372.053,
        "autoRegistrationStatus": "DISABLE",
        "lastModifiedDate": 1569365372.053,
        "customerVersion": 1,
        "generationId": "c5c2eb95-140b-4f49-9393-6aaac85b2a90",
        "validity": {
            "notBefore": 1569360675.0,
            "notAfter": 1884720675.0
        }
    }
}

Untuk informasi selengkapnya, lihat Des kripsiCertificate di Referensi API IoT. AWS

Contoh kode berikut menunjukkan cara menggunakandescribe-certificate.

AWS CLI

Untuk mendapatkan informasi tentang sertifikat

describe-certificateContoh berikut menampilkan detail untuk sertifikat yang ditentukan.

aws iot describe-certificate \
    --certificate-id "4f0ba725787aa94d67d2fca420eca022242532e8b3c58e7465c7778b443fd65e"

Output:

{
    "certificateDescription": {
        "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/4f0ba725787aa94d67d2fca420eca022242532e8b3c58e7465c7778b443fd65e",
        "certificateId": "4f0ba725787aa94d67d2fca420eca022242532e8b3c58e7465c7778b443fd65e",
        "status": "ACTIVE",
        "certificatePem": "-----BEGIN CERTIFICATE-----
MIICiTEXAMPLEQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC
VVMxCzAJBgNVBEXAMPLEMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6
b24xFDASBgNVBAsTC0lBTSBDEXAMPLElMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd
BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5EXAMPLEcNMTEwNDI1MjA0NTIxWhcN
MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNEXAMPLEdBMRAwDgYD
VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBEXAMPLEz
b2xEXAMPLEYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt
YXpvbi5jb20wgZ8EXAMPLEZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ
21uUSfwfEvySWtC2XADZ4nB+BLYEXAMPLEpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T
rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7EXAMPLEGBzZswY6786m86gpE
Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFEXAMPLEAtCu4
nUhVVxYUnEXAMPLE8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb
FFBjvSfpJIlJ00zbhNYS5f6GEXAMPLEl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb
NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE=
-----END CERTIFICATE-----",
        "ownedBy": "123456789012",
        "creationDate": 1541022751.983,
        "lastModifiedDate": 1541022751.983,
        "customerVersion": 1,
        "transferData": {},
        "generationId": "6974fbed-2e61-4114-bc5e-4204cc79b045",
        "validity": {
            "notBefore": 1541022631.0,
            "notAfter": 2524607999.0
        }
    }
}

Untuk informasi selengkapnya, lihat DescribeCertificate di Refer AWS ensi API IoT.

Contoh kode berikut menunjukkan cara menggunakandescribe-custom-metric.

AWS CLI

Untuk mendapatkan informasi tentang metrik kustom Device Defender

describe-custom-metricContoh berikut mendapatkan informasi tentang metrik khusus bernamamyCustomMetric.

aws iot describe-custom-metric \
    --metric-name myCustomMetric

Output:

{
    "metricName": "myCustomMetric",
    "metricArn": "arn:aws:iot:us-east-1:1234564789012:custommetric/myCustomMetric",
    "metricType": "number",
    "displayName": "My custom metric",
    "creationDate": 2020-11-17T23:02:12.879000-09:00,
    "lastModifiedDate": 2020-11-17T23:02:12.879000-09:00
}

Untuk informasi selengkapnya, lihat Metrik khusus di Panduan Pengembang Inti AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandescribe-default-authorizer.

AWS CLI

Untuk mendapatkan informasi tentang otorisasi kustom default

describe-default-authorizerContoh berikut menampilkan detail untuk otorisasi kustom default.

aws iot describe-default-authorizer

Output:

{
    "authorizerName": "CustomAuthorizer",
    "authorizerArn": "arn:aws:iot:us-west-2:123456789012:authorizer/CustomAuthorizer"
}

Untuk informasi selengkapnya, lihat DescribeDefaultAuthorizer di Refer AWS ensi API IoT.

Contoh kode berikut menunjukkan cara menggunakandescribe-dimension.

AWS CLI

Untuk mendapatkan informasi tentang dimensi

describe-dimensionContoh berikut mendapatkan informasi tentang dimensi bernamaTopicFilterForAuthMessages.

aws iot describe-dimension \
    --name TopicFilterForAuthMessages

Output:

{
    "name": "TopicFilterForAuthMessages",
    "arn": "arn:aws:iot:eu-west-2:123456789012:dimension/TopicFilterForAuthMessages",
    "type": "TOPIC_FILTER",
    "stringValues": [
        "device/+/auth"
    ],
    "creationDate": 1578620223.255,
    "lastModifiedDate": 1578620223.255
}

Untuk informasi selengkapnya, lihat Mendeteksi Perintah di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandescribe-domain-configuration.

AWS CLI

Untuk mendeskripsikan konfigurasi domain

describe-domain-configurationContoh berikut menampilkan detail tentang konfigurasi domain yang ditentukan.

aws iot describe-domain-configuration \
    --domain-configuration-name "additionalDataDomain"

Output:

{
    "domainConfigurationName": "additionalDataDomain",
    "domainConfigurationArn": "arn:aws:iot:us-east-1:758EXAMPLE143:domainconfiguration/additionalDataDomain/norpw",
    "domainName": "d055exampleed74y71zfd-ats.beta.us-east-1.iot.amazonaws.com",
    "serverCertificates": [],
    "domainConfigurationStatus": "ENABLED",
    "serviceType": "DATA",
    "domainType": "AWS_MANAGED",
    "lastStatusChangeDate": 1601923783.774
}

Untuk informasi selengkapnya, lihat T itik Akhir yang Dapat Dikonfigurasi di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandescribe-endpoint.

AWS CLI

Contoh 1: Untuk mendapatkan titik akhir Anda saat AWS ini

describe-endpointContoh berikut mengambil titik akhir default AWS di mana semua perintah diterapkan.

aws iot describe-endpoint

Output:

{
    "endpointAddress": "abc123defghijk.iot.us-west-2.amazonaws.com"
}

Untuk informasi selengkapnya, lihat DescribeEndpoint di Panduan Pengembang AWS IoT.

Contoh 2: Untuk mendapatkan titik akhir ATS Anda

describe-endpointContoh berikut mengambil titik akhir Amazon Trust Services (ATS).

aws iot describe-endpoint \
    --endpoint-type iot:Data-ATS

Output:

{
    "endpointAddress": "abc123defghijk-ats.iot.us-west-2.amazonaws.com"
}

Untuk informasi selengkapnya, lihat X.509 Sertifikat dan AWSAWS IoT di Panduan Pengembang IoT.

Contoh kode berikut menunjukkan cara menggunakandescribe-event-configurations.

AWS CLI

Untuk menunjukkan jenis acara yang dipublikasikan

describe-event-configurationsContoh berikut mencantumkan konfigurasi yang mengontrol peristiwa mana yang dihasilkan ketika sesuatu ditambahkan, diperbarui, atau dihapus.

aws iot describe-event-configurations

Output:

{
    "eventConfigurations": {
        "CA_CERTIFICATE": {
            "Enabled": false
        },
        "CERTIFICATE": {
            "Enabled": false
        },
        "JOB": {
            "Enabled": false
        },
        "JOB_EXECUTION": {
            "Enabled": false
        },
        "POLICY": {
            "Enabled": false
        },
        "THING": {
            "Enabled": false
        },
        "THING_GROUP": {
            "Enabled": false
        },
        "THING_GROUP_HIERARCHY": {
            "Enabled": false
        },
        "THING_GROUP_MEMBERSHIP": {
            "Enabled": false
        },
        "THING_TYPE": {
            "Enabled": false
        },
        "THING_TYPE_ASSOCIATION": {
            "Enabled": false
        }
    }
}

Untuk informasi selengkapnya, lihat Pesan A cara di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandescribe-index.

AWS CLI

Untuk mengambil status indeks benda saat ini

describe-indexContoh berikut mengambil status indeks benda saat ini.

aws iot describe-index \
    --index-name "AWS_Things"

Output:

{
    "indexName": "AWS_Things",
    "indexStatus": "ACTIVE",
    "schema": "REGISTRY_AND_SHADOW_AND_CONNECTIVITY_STATUS"
}

Untuk informasi selengkapnya, lihat Mengelola Pengindeksan Hal di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandescribe-job-execution.

AWS CLI

Untuk mendapatkan detail eksekusi untuk pekerjaan di perangkat

describe-job-executionContoh berikut mendapatkan detail eksekusi untuk pekerjaan yang ditentukan.

aws iot describe-job-execution \
    --job-id "example-job-01" \
    --thing-name "MyRaspberryPi"

Output:

{
    "execution": {
        "jobId": "example-job-01",
        "status": "QUEUED",
        "statusDetails": {},
        "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyRaspberryPi",
        "queuedAt": 1560787023.636,
        "lastUpdatedAt": 1560787023.636,
        "executionNumber": 1,
        "versionNumber": 1
    }
}

Untuk informasi selengkapnya, lihat Membuat dan Mengelola Pekerjaan (CLI) di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandescribe-job.

AWS CLI

Untuk mendapatkan status rinci untuk pekerjaan

describe-jobContoh berikut mendapatkan status rinci untuk pekerjaan yang ID-nyaexample-job-01.

aws iot describe-job \
    --job-id "example-job-01"

Output:

{
    "job": {
        "jobArn": "arn:aws:iot:us-west-2:123456789012:job/example-job-01",
        "jobId": "example-job-01",
        "targetSelection": "SNAPSHOT",
        "status": "IN_PROGRESS",
        "targets": [
            "arn:aws:iot:us-west-2:123456789012:thing/MyRaspberryPi"
        ],
        "description": "example job test",
        "presignedUrlConfig": {},
        "jobExecutionsRolloutConfig": {},
        "createdAt": 1560787022.733,
        "lastUpdatedAt": 1560787026.294,
        "jobProcessDetails": {
            "numberOfCanceledThings": 0,
            "numberOfSucceededThings": 0,
            "numberOfFailedThings": 0,
            "numberOfRejectedThings": 0,
            "numberOfQueuedThings": 1,
            "numberOfInProgressThings": 0,
            "numberOfRemovedThings": 0,
            "numberOfTimedOutThings": 0
        },
        "timeoutConfig": {}
    }
}

Untuk informasi selengkapnya, lihat Membuat dan Mengelola Pekerjaan (CLI) di Panduan Pengembang AWS IoT.

  • Untuk detail API, lihat DescribeJob di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakandescribe-mitigation-action.

AWS CLI

Untuk melihat detail untuk tindakan mitigasi yang ditentukan

describe-mitigation-actionContoh berikut menampilkan detail untuk tindakan mitigasi yang ditentukan.

aws iot describe-mitigation-action \
    --action-name AddThingsToQuarantineGroupAction

Output:

{
    "actionName": "AddThingsToQuarantineGroupAction",
    "actionType": "ADD_THINGS_TO_THING_GROUP",
    "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/AddThingsToQuarantineGroupAction",
    "actionId": "2fd2726d-98e1-4abf-b10f-09465ccd6bfa",
    "roleArn": "arn:aws:iam::123456789012:role/service-role/MoveThingsToQuarantineGroupRole",
    "actionParams": {
        "addThingsToThingGroupParams": {
            "thingGroupNames": [
                "QuarantineGroup1"
            ],
            "overrideDynamicGroups": true
        }
    },
    "creationDate": "2019-12-10T11:09:35.999000-08:00",
    "lastModifiedDate": "2019-12-10T11:09:35.999000-08:00"
}

Untuk informasi selengkapnya, lihat DescribeMitigationAction (Perintah Tindakan Miti gasi) di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandescribe-provisioning-template-version.

AWS CLI

Untuk menjelaskan versi template penyediaan

describe-provisioning-template-versionContoh berikut menjelaskan versi template penyediaan.

aws iot describe-provisioning-template-version \
    --template-name MyTestProvisioningTemplate \
    --version-id 1

Output:

{
    "versionId": 1,
    "creationDate": 1589308310.574,
    "templateBody": "{
        \"Parameters\":{
            \"SerialNumber\":{
                \"Type\":\"String\"
            },
            \"AWS::IoT::Certificate::Id\":{
                \"Type\":\"String\"
            }
        },
        \"Resources\":{
            \"certificate\":{
                \"Properties\":{
                    \"CertificateId\":{
                        \"Ref\":\"AWS::IoT::Certificate::Id\"
                    },
                    \"Status\":\"Active\"
                },
                \"Type\":\"AWS::IoT::Certificate\"
            },
            \"policy\":{
                \"Properties\":{
                    \"PolicyName\":\"MyIotPolicy\"
                },
                \"Type\":\"AWS::IoT::Policy\"
            },
            \"thing\":{
                \"OverrideSettings\":{
                    \"AttributePayload\":\"MERGE\",
                    \"ThingGroups\":\"DO_NOTHING\",
                    \"ThingTypeName\":\"REPLACE\"
                },
                \"Properties\":{
                    \"AttributePayload\":{},
                    \"ThingGroups\":[],
                    \"ThingName\":{
                        \"Fn::Join\":[
                            \"\",
                            [
                                \"DemoGroup_\",
                                {\"Ref\":\"SerialNumber\"}
                            ]
                        ]
                    },
                    \"ThingTypeName\":\"VirtualThings\"
                },
                \"Type\":\"AWS::IoT::Thing\"
            }
        }
    }",
    "isDefaultVersion": true
}

Untuk informasi selengkapnya, lihat Penyediaan perangkat yang tidak memiliki sertifikat perangkat menggunakan penyediaan armada di Panduan Pengembang AWS Inti IoT.

Contoh kode berikut menunjukkan cara menggunakandescribe-provisioning-template.

AWS CLI

Untuk menjelaskan templat penyediaan

describe-provisioning-templateContoh berikut menjelaskan template penyediaan.

aws iot describe-provisioning-template \
    --template-name MyTestProvisioningTemplate

Output:

{
    "templateArn": "arn:aws:iot:us-west-2:57EXAMPLE833:provisioningtemplate/MyTestProvisioningTemplate",
    "templateName": "MyTestProvisioningTemplate",
    "creationDate": 1589308310.574,
    "lastModifiedDate": 1589308345.539,
    "defaultVersionId": 1,
    "templateBody": "{
        \"Parameters\":{
            \"SerialNumber\":{
                \"Type\":\"String\"
            },
            \"AWS::IoT::Certificate::Id\":{
                \"Type\":\"String\"
            }
        },
        \"Resources\":{
            \"certificate\":{
                \"Properties\":{
                    \"CertificateId\":{
                        \"Ref\":\"AWS::IoT::Certificate::Id\"
                    },
                    \"Status\":\"Active\"
                },
                \"Type\":\"AWS::IoT::Certificate\"
            },
            \"policy\":{
                \"Properties\":{
                    \"PolicyName\":\"MyIotPolicy\"
                },
                \"Type\":\"AWS::IoT::Policy\"
            },
            \"thing\":{
                \"OverrideSettings\":{
                    \"AttributePayload\":\"MERGE\",
                    \"ThingGroups\":\"DO_NOTHING\",
                    \"ThingTypeName\":\"REPLACE\"
                },
                \"Properties\":{
                    \"AttributePayload\":{},
                    \"ThingGroups\":[],
                    \"ThingName\":{
                        \"Fn::Join\":[
                            \"\",
                            [
                                \"DemoGroup_\",
                                {\"Ref\":\"SerialNumber\"}
                            ]
                        ]
                    },
                    \"ThingTypeName\":\"VirtualThings\"
                },
                \"Type\":\"AWS::IoT::Thing\"
            }
        }
    }",
    "enabled": true,
    "provisioningRoleArn": "arn:aws:iam::571032923833:role/service-role/IoT_access"
}

Untuk informasi selengkapnya, lihat Penyediaan perangkat yang tidak memiliki sertifikat perangkat menggunakan penyediaan armada di Panduan Pengembang AWS Inti IoT.

Contoh kode berikut menunjukkan cara menggunakandescribe-role-alias.

AWS CLI

Untuk mendapatkan informasi tentang alias peran AWS IoT

describe-role-aliasContoh berikut menampilkan detail untuk alias peran yang ditentukan.

aws iot describe-role-alias \
    --role-alias LightBulbRole

Output:

{
    "roleAliasDescription": {
        "roleAlias": "LightBulbRole",
        "roleAliasArn": "arn:aws:iot:us-west-2:123456789012:rolealias/LightBulbRole",
        "roleArn": "arn:aws:iam::123456789012:role/light_bulb_role_001",
        "owner": "123456789012",
        "credentialDurationSeconds": 3600,
        "creationDate": 1570558643.221,
        "lastModifiedDate": 1570558643.221
    }
}

Untuk informasi selengkapnya, lihat DescribeRoleAlias di Refer AWS ensi API IoT.

Contoh kode berikut menunjukkan cara menggunakandescribe-scheduled-audit.

AWS CLI

Untuk mendapatkan informasi tentang audit terjadwal

describe-scheduled-auditContoh berikut mendapatkan informasi terperinci tentang audit terjadwal AWS IOT Device Defender bernamaAWSIoTDeviceDefenderDailyAudit.

aws iot describe-scheduled-audit \
    --scheduled-audit-name AWSIoTDeviceDefenderDailyAudit

Output:

{
    "frequency": "DAILY",
    "targetCheckNames": [
        "AUTHENTICATED_COGNITO_ROLE_OVERLY_PERMISSIVE_CHECK",
        "CONFLICTING_CLIENT_IDS_CHECK",
        "DEVICE_CERTIFICATE_SHARED_CHECK",
        "IOT_POLICY_OVERLY_PERMISSIVE_CHECK",
        "REVOKED_CA_CERTIFICATE_STILL_ACTIVE_CHECK",
        "UNAUTHENTICATED_COGNITO_ROLE_OVERLY_PERMISSIVE_CHECK"
    ],
    "scheduledAuditName": "AWSIoTDeviceDefenderDailyAudit",
    "scheduledAuditArn": "arn:aws:iot:us-west-2:123456789012:scheduledaudit/AWSIoTDeviceDefenderDailyAudit"
}

Untuk informasi selengkapnya, lihat Perintah Audit di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandescribe-security-profile.

AWS CLI

Untuk mendapatkan informasi tentang profil keamanan

describe-security-profileContoh berikut mendapatkan informasi tentang profil keamanan AWS IoT Device Defender bernama PossibleIssue.

aws iot describe-security-profile \
    --security-profile-name PossibleIssue

Output:

{
    "securityProfileName": "PossibleIssue",
    "securityProfileArn": "arn:aws:iot:us-west-2:123456789012:securityprofile/PossibleIssue",
    "securityProfileDescription": "check to see if authorization fails 10 times in 5 minutes or if cellular bandwidth exceeds 128",
    "behaviors": [
        {
            "name": "CellularBandwidth",
            "metric": "aws:message-byte-size",
            "criteria": {
                "comparisonOperator": "greater-than",
                "value": {
                    "count": 128
                },
                "consecutiveDatapointsToAlarm": 1,
                "consecutiveDatapointsToClear": 1
            }
        },
        {
            "name": "Authorization",
            "metric": "aws:num-authorization-failures",
            "criteria": {
                "comparisonOperator": "greater-than",
                "value": {
                    "count": 10
                },
                "durationSeconds": 300,
                "consecutiveDatapointsToAlarm": 1,
                "consecutiveDatapointsToClear": 1
            }
        }
    ],
    "version": 1,
    "creationDate": 1560278102.528,
    "lastModifiedDate": 1560278102.528
}

Untuk informasi selengkapnya, lihat Mendeteksi Perintah di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandescribe-stream.

AWS CLI

Untuk mendapatkan informasi tentang aliran

describe-streamContoh berikut menampilkan rincian tentang aliran yang ditentukan.

aws iot describe-stream \
    --stream-id stream12345

Output:

{
    "streamInfo": {
        "streamId": "stream12345",
        "streamArn": "arn:aws:iot:us-west-2:123456789012:stream/stream12345",
        "streamVersion": 1,
        "description": "This stream is used for Amazon FreeRTOS OTA Update 12345.",
        "files": [
            {
                "fileId": "123",
                "s3Location": {
                    "bucket":"codesign-ota-bucket",
                    "key":"48c67f3c-63bb-4f92-a98a-4ee0fbc2bef6"
                }
            }
        ],
        "createdAt": 1557863215.995,
        "lastUpdatedAt": 1557863215.995,
        "roleArn": "arn:aws:iam:123456789012:role/service-role/my_ota_stream_role"
    }
}

Untuk informasi selengkapnya, lihat DescribeStream di Refer AWS ensi API IoT.

Contoh kode berikut menunjukkan cara menggunakandescribe-thing-group.

AWS CLI

Untuk mendapatkan informasi tentang kelompok benda

describe-thing-groupContoh berikut mendapatkan informasi tentang kelompok benda bernamaHalogenBulbs.

aws iot describe-thing-group \
    --thing-group-name HalogenBulbs

Output:

{
    "thingGroupName": "HalogenBulbs",
    "thingGroupId": "f4ec6b84-b42b-499d-9ce1-4dbd4d4f6f6e",
    "thingGroupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/HalogenBulbs",
    "version": 1,
    "thingGroupProperties": {},
    "thingGroupMetadata": {
        "parentGroupName": "LightBulbs",
        "rootToParentThingGroups": [
            {
                "groupName": "LightBulbs",
                "groupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs"
            }
        ],
        "creationDate": 1559927609.897
    }
}

Untuk informasi selengkapnya, lihat Grup Hal di Panduan AWS Pengembang IoT.

Contoh kode berikut menunjukkan cara menggunakandescribe-thing-type.

AWS CLI

Untuk mendapatkan informasi tentang jenis benda

describe-thing-typeContoh berikut menampilkan informasi tentang jenis hal yang ditentukan yang ditentukan di AWS akun Anda.

aws iot describe-thing-type \
    --thing-type-name "LightBulb"

Output:

{
    "thingTypeName": "LightBulb",
    "thingTypeId": "ce3573b0-0a3c-45a7-ac93-4e0ce14cd190",
    "thingTypeArn": "arn:aws:iot:us-west-2:123456789012:thingtype/LightBulb",
    "thingTypeProperties": {
        "thingTypeDescription": "light bulb type",
        "searchableAttributes": [
            "model",
            "wattage"
        ]
    },
    "thingTypeMetadata": {
        "deprecated": false,
        "creationDate": 1559772562.498
    }
}

Untuk informasi selengkapnya, lihat Jenis Hal di Panduan AWS Pengembang IoT.

Contoh kode berikut menunjukkan cara menggunakandescribe-thing.

AWS CLI

Untuk menampilkan informasi terperinci tentang sesuatu

describe-thingContoh berikut menampilkan informasi tentang sesuatu (perangkat) yang didefinisikan dalam registri AWS IoT untuk AWS akun Anda.

aws iot mendeskripsikan-hal --nama-benda "” MyLightBulb

Output:

{
    "defaultClientId": "MyLightBulb",
    "thingName": "MyLightBulb",
    "thingId": "40da2e73-c6af-406e-b415-15acae538797",
    "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyLightBulb",
    "thingTypeName": "LightBulb",
    "attributes": {
        "model": "123",
        "wattage": "75"
    },
    "version": 1
}

Untuk informasi selengkapnya, lihat Cara Mengelola Hal dengan Registr i di Panduan AWS Pengembang IoT.

Contoh kode berikut menunjukkan cara menggunakandetach-policy.

AWS CLI

Contoh 1: Untuk melepaskan kebijakan AWS IoT dari grup benda

detach-policyContoh berikut melepaskan kebijakan yang ditentukan dari grup benda dan, secara ekstensi, dari semua hal dalam grup itu dan salah satu grup turunan grup.

aws iot detach-policy \
    --target "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs" \
    --policy-name "MyFirstGroup_Core-policy"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Grup Hal di Panduan AWS Pengembang IoT.

Contoh 2: Untuk melepaskan kebijakan AWS IoT dari sertifikat perangkat

detach-policyContoh berikut melepaskan TemperatureSensorPolicy kebijakan dari sertifikat perangkat yang diidentifikasi oleh ARN.

aws iot detach-policy \
    --policy-name TemperatureSensorPolicy \
    --target arn:aws:iot:us-west-2:123456789012:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142

Perintah ini tidak menghasilkan output.

  • Untuk detail API, lihat DetachPolicy di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakandetach-security-profile.

AWS CLI

Untuk memisahkan profil keamanan dari target

detach-security-profileContoh berikut menghapus hubungan antara profil keamanan AWS IoT Device Defender bernama Testprofile dan target semua hal terdaftar.

aws iot detach-security-profile \
    --security-profile-name Testprofile \
    --security-profile-target-arn "arn:aws:iot:us-west-2:123456789012:all/registered-things"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mendeteksi Perintah di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakandetach-thing-principal.

AWS CLI

Untuk melepaskan sesuatu certificate/principal dari sesuatu

detach-thing-principalContoh berikut menghapus sertifikat yang mewakili prinsipal dari hal yang ditentukan.

aws iot detach-thing-principal \
    --thing-name "MyLightBulb" \
    --principal "arn:aws:iot:us-west-2:123456789012:cert/604c48437a57b7d5fc5d137c5be75011c6ee67c9a6943683a1acb4b1626bac36"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Cara Mengelola Hal dengan Registr i di Panduan AWS Pengembang IoT.

Contoh kode berikut menunjukkan cara menggunakandisable-topic-rule.

AWS CLI

Menonaktifkan aturan topik

disable-topic-ruleContoh berikut menonaktifkan aturan topik yang ditentukan.

aws iot disable-topic-rule \
    --rule-name "MyPlantPiMoistureAlertRule"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Melihat Aturan Anda di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanenable-topic-rule.

AWS CLI

Untuk mengaktifkan aturan topik

enable-topic-ruleContoh berikut mengaktifkan (atau mengaktifkan kembali) aturan topik yang ditentukan.

aws iot enable-topic-rule \
    --rule-name "MyPlantPiMoistureAlertRule"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Melihat Aturan Anda di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanget-behavior-model-training-summaries.

AWS CLI

Untuk mencantumkan status model pelatihan Profil Keamanan ML Detect Device Defender

get-behavior-model-training-summariesContoh berikut mencantumkan status pelatihan model untuk perilaku yang dikonfigurasi di Profil Keamanan yang dipilih. Untuk setiap perilaku, nama, status model, dan persentase titik data yang dikumpulkan terdaftar.

aws iot get-behavior-model-training-summaries \
    --security-profile-name MySecuirtyProfileName

Output:

{
    "summaries": [
        {
            "securityProfileName": "MySecuirtyProfileName",
            "behaviorName": "Messages_sent_ML_behavior",
            "modelStatus": "PENDING_BUILD",
            "datapointsCollectionPercentage": 0.0
        },
        {
            "securityProfileName": "MySecuirtyProfileName",
            "behaviorName": "Messages_received_ML_behavior",
            "modelStatus": "PENDING_BUILD",
            "datapointsCollectionPercentage": 0.0
        },
        {
            "securityProfileName": "MySecuirtyProfileName",
            "behaviorName": "Authorization_failures_ML_behavior",
            "modelStatus": "PENDING_BUILD",
            "datapointsCollectionPercentage": 0.0
        },
        {
            "securityProfileName": "MySecuirtyProfileName",
            "behaviorName": "Message_size_ML_behavior",
            "modelStatus": "PENDING_BUILD",
            "datapointsCollectionPercentage": 0.0
        },
        {
            "securityProfileName": "MySecuirtyProfileName",
            "behaviorName": "Connection_attempts_ML_behavior",
            "modelStatus": "PENDING_BUILD",
            "datapointsCollectionPercentage": 0.0
        },
        {
            "securityProfileName": "MySPNoALerts",
            "behaviorName": "Disconnects_ML_behavior",
            "modelStatus": "PENDING_BUILD",
            "datapointsCollectionPercentage": 0.0
        }
    ]
}

Untuk informasi selengkapnya, lihat GetBehaviorModelTrainingSummaries (Deteksi Perintah) di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanget-cardinality.

AWS CLI

Untuk mengembalikan perkiraan jumlah nilai unik yang cocok dengan kueri

Anda dapat menggunakan skrip pengaturan berikut untuk membuat 10 hal yang mewakili 10 sensor suhu. Setiap hal baru memiliki 3 atribut.

# Bash script. If in other shells, type `bash` before running
Temperatures=(70 71 72 73 74 75 47 97 98 99)
Racks=(Rack1 Rack1 Rack2 Rack2 Rack3 Rack4 Rack5 Rack6 Rack6 Rack6)
IsNormal=(true true true true true true false false false false)
for ((i=0; i<10 ; i++))
do
  thing=$(aws iot create-thing --thing-name "TempSensor$i" --attribute-payload attributes="{temperature=${Temperatures[i]},rackId=${Racks[i]},stateNormal=${IsNormal[i]}}")
  aws iot describe-thing --thing-name "TempSensor$i"
done

Contoh keluaran skrip pengaturan:

{
    "version": 1,
    "thingName": "TempSensor0",
    "defaultClientId": "TempSensor0",
    "attributes": {
        "rackId": "Rack1",
        "stateNormal": "true",
        "temperature": "70"
    },
    "thingArn": "arn:aws:iot:us-east-1:123456789012:thing/TempSensor0",
    "thingId": "example1-90ab-cdef-fedc-ba987example"
}

get-cardinalityContoh berikut menanyakan 10 sensor yang dibuat oleh skrip pengaturan dan mengembalikan jumlah rak yang memiliki sensor suhu melaporkan nilai suhu abnormal. Jika nilai suhu di bawah 60 atau di atas 80, sensor suhu dalam keadaan abnormal.

aws iot get-cardinality \
    --aggregation-field "attributes.rackId" \
    --query-string "thingName:TempSensor* AND attributes.stateNormal:false"

Output:

{
    "cardinality": 2
}

Untuk informasi selengkapnya, lihat Mengkueri Data Agregat< https://docs.aws.amazon.com/iot/latest/developerguide/index-aggregate.html > di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanget-effective-policies.

AWS CLI

Untuk membuat daftar kebijakan yang mempengaruhi sesuatu

get-effective-policiesContoh berikut mencantumkan kebijakan yang mempengaruhi hal yang ditentukan, termasuk kebijakan yang dilampirkan ke grup mana pun yang dimilikinya.

aws iot get-effective-policies \
    --thing-name TemperatureSensor-001 \
    --principal arn:aws:iot:us-west-2:123456789012:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142

Output:

{
    "effectivePolicies": [
        {
            "policyName": "TemperatureSensorPolicy",
            "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/TemperatureSensorPolicy",
            "policyDocument": "{
                \"Version\": \"2012-10-17\",
                \"Statement\": [
                    {
                        \"Effect\": \"Allow\",
                        \"Action\": [
                            \"iot:Publish\",
                            \"iot:Receive\"
                        ],
                        \"Resource\": [
                            \"arn:aws:iot:us-west-2:123456789012:topic/topic_1\",
                            \"arn:aws:iot:us-west-2:123456789012:topic/topic_2\"
                        ]
                    },
                    {
                        \"Effect\": \"Allow\",
                        \"Action\": [
                            \"iot:Subscribe\"
                        ],
                        \"Resource\": [
                            \"arn:aws:iot:us-west-2:123456789012:topicfilter/topic_1\",
                            \"arn:aws:iot:us-west-2:123456789012:topicfilter/topic_2\"
                        ]
                    },
                    {
                        \"Effect\": \"Allow\",
                        \"Action\": [
                            \"iot:Connect\"
                        ],
                        \"Resource\": [
                            \"arn:aws:iot:us-west-2:123456789012:client/basicPubSub\"
                        ]
                    }
                ]
            }"
        }
    ]
}

Untuk informasi selengkapnya, lihat Mendapatkan Kebijakan Efektif untuk Su atu Hal di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanget-indexing-configuration.

AWS CLI

Untuk mendapatkan konfigurasi pengindeksan benda

get-indexing-configurationContoh berikut mendapatkan data konfigurasi saat ini untuk pengindeksan armada AWS IoT.

aws iot get-indexing-configuration

Output:

{
    "thingIndexingConfiguration": {
        "thingIndexingMode": "OFF",
        "thingConnectivityIndexingMode": "OFF"
    },
    "thingGroupIndexingConfiguration": {
        "thingGroupIndexingMode": "OFF"
    }
}

Untuk informasi selengkapnya, lihat Mengelola Pengindeksan Hal di Panduan AWS Pengembang IoT.

Contoh kode berikut menunjukkan cara menggunakanget-job-document.

AWS CLI

Untuk mengambil dokumen untuk pekerjaan

get-job-documentContoh berikut menampilkan detail tentang dokumen untuk pekerjaan yang ID-nyaexample-job-01.

aws iot get-job-document \
    --job-id "example-job-01"

Output:

{
    "document": "\n{\n    \"operation\":\"customJob\",\n    \"otherInfo\":\"someValue\"\n}\n"
}

Untuk informasi selengkapnya, lihat Membuat dan Mengelola Pekerjaan (CLI) di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanget-logging-options.

AWS CLI

Untuk mendapatkan opsi logging

get-logging-optionsContoh berikut mendapatkan opsi logging saat ini untuk AWS akun Anda.

aws iot get-logging-options

Output:

{
    "roleArn": "arn:aws:iam::123456789012:role/service-role/iotLoggingRole",
    "logLevel": "ERROR"
}

Untuk informasi selengkapnya, lihat judul di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanget-ota-update.

AWS CLI

Untuk mengambil informasi tentang Pembaruan OTA

get-ota-updateContoh berikut menampilkan detail tentang Pembaruan OTA yang ditentukan.

aws iot get-ota-update \
    --ota-update-id ota12345

Output:

{
    "otaUpdateInfo": {
        "otaUpdateId": "ota12345",
        "otaUpdateArn": "arn:aws:iot:us-west-2:123456789012:otaupdate/itsaupdate",
        "creationDate": 1557863215.995,
        "lastModifiedDate": 1557863215.995,
        "description": "A critical update needed right away.",
        "targets": [
           "device1",
           "device2",
           "device3",
           "device4"
        ],
        "targetSelection": "SNAPSHOT",
        "protocols": ["HTTP"],
        "awsJobExecutionsRolloutConfig": {
           "maximumPerMinute": 10
        },
        "otaUpdateFiles": [
            {
                "fileName": "firmware.bin",
                "fileLocation": {
                    "stream": {
                        "streamId": "004",
                        "fileId":123
                    }
                },
                "codeSigning": {
                    "awsSignerJobId": "48c67f3c-63bb-4f92-a98a-4ee0fbc2bef6"
                }
            }
        ],
        "roleArn": "arn:aws:iam:123456789012:role/service-role/my_ota_role"
        "otaUpdateStatus": "CREATE_COMPLETE",
        "awsIotJobId": "job54321",
        "awsIotJobArn": "arn:aws:iot:us-west-2:123456789012:job/job54321",
        "errorInfo": {
        }
    }
}

Untuk informasi selengkapnya, lihat GetotaUpdate di Referensi API AWS IoT.

  • Untuk detail API, lihat GetOtaUpdate di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-percentiles.

AWS CLI

Untuk mengelompokkan nilai agregat yang cocok dengan kueri ke dalam pengelompokan persentil

Anda dapat menggunakan skrip pengaturan berikut untuk membuat 10 hal yang mewakili 10 sensor suhu. Setiap hal baru memiliki 1 atribut.

# Bash script. If in other shells, type `bash` before running
Temperatures=(70 71 72 73 74 75 47 97 98 99)
for ((i=0; i<10 ; i++))
do
    thing=$(aws iot create-thing --thing-name "TempSensor$i" --attribute-payload attributes="{temperature=${Temperatures[i]}}")
    aws iot describe-thing --thing-name "TempSensor$i"
done

Contoh keluaran skrip pengaturan:

{
    "version": 1,
    "thingName": "TempSensor0",
    "defaultClientId": "TempSensor0",
    "attributes": {
        "temperature": "70"
    },
    "thingArn": "arn:aws:iot:us-east-1:123456789012:thing/TempSensor0",
    "thingId": "example1-90ab-cdef-fedc-ba987example"
}

get-percentilesContoh berikut menanyakan 10 sensor yang dibuat oleh skrip pengaturan dan mengembalikan nilai untuk setiap grup persentil yang ditentukan. Grup persentil “10" berisi nilai bidang agregat yang terjadi di sekitar 10 persen dari nilai yang cocok dengan kueri. Dalam output berikut, {"persen”: 10.0, “nilai”: 67,7} berarti sekitar 10,0% dari nilai suhu di bawah 67,7.

aws iot get-percentiles \
    --aggregation-field "attributes.temperature" \
    --query-string "thingName:TempSensor*" \
    --percents 10 25 50 75 90

Output:

{
    "percentiles": [
        {
            "percent": 10.0,
            "value": 67.7
        },
        {
            "percent": 25.0,
            "value": 71.25
        },
        {
            "percent": 50.0,
            "value": 73.5
        },
        {
            "percent": 75.0,
            "value": 91.5
        },
        {
            "percent": 90.0,
            "value": 98.1
        }
    ]
}

Untuk informasi selengkapnya, lihat Mengkueri Data Agregat di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanget-policy-version.

AWS CLI

Untuk mendapatkan informasi tentang versi kebijakan tertentu

get-policy-versionContoh berikut mendapatkan informasi tentang versi pertama dari kebijakan yang ditentukan.

aws iot get-policy \
    --policy-name UpdateDeviceCertPolicy
    --policy-version-id "1"

Output:

{
    "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/UpdateDeviceCertPolicy",
    "policyName": "UpdateDeviceCertPolicy",
    "policyDocument": "{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Effect\": \"Allow\", \"Action\":  \"iot:UpdateCertificate\", \"Resource\": \"*\" } ] }",
    "policyVersionId": "1",
    "isDefaultVersion": false,
    "creationDate": 1559925941.924,
    "lastModifiedDate": 1559926175.458,
    "generationId": "5066f1b6712ce9d2a1e56399771649a272d6a921762fead080e24fe52f24e042"
}

Untuk informasi selengkapnya, lihat Kebijakan AWS IoT di Panduan AWS Pengembang IoT.

Contoh kode berikut menunjukkan cara menggunakanget-policy.

AWS CLI

Untuk mendapatkan informasi tentang versi default kebijakan

get-policyContoh berikut mengambil informasi tentang versi default dari kebijakan yang ditentukan.

aws iot get-policy \
    --policy-name UpdateDeviceCertPolicy

Output:

{
    "policyName": "UpdateDeviceCertPolicy",
    "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/UpdateDeviceCertPolicy",
    "policyDocument": "{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Effect\": \"Allow\", \"Action\":  \"iot:UpdateCertificate\", \"Resource\": \"*\" } ] }",
    "defaultVersionId": "2",
    "creationDate": 1559925941.924,
    "lastModifiedDate": 1559925941.924,
    "generationId": "5066f1b6712ce9d2a1e56399771649a272d6a921762fead080e24fe52f24e042"
}

Untuk informasi selengkapnya, lihat Kebijakan AWS IoT di Panduan AWS Pengembang IoT.

  • Untuk detail API, lihat GetPolicy di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-registration-code.

AWS CLI

Untuk mendapatkan kode pendaftaran AWS khusus akun Anda

get-registration-codeContoh berikut mengambil kode pendaftaran AWS khusus akun Anda.

aws iot get-registration-code

Output:

{
    "registrationCode": "15c51ae5e36ba59ba77042df1115862076bea4bd15841c838fcb68d5010a614c"
}

Untuk informasi selengkapnya, lihat Menggunakan Sertifikat Sen diri di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanget-statistics.

AWS CLI

Untuk mencari indeks perangkat untuk data agregat

get-statisticsContoh berikut mengembalikan jumlah hal yang memiliki properti yang disebut connectivity.connected set ke false (yaitu, jumlah perangkat yang tidak terhubung) dalam bayangan perangkat mereka.

aws iot get-statistics \
    --index-name AWS_Things \
    --query-string "connectivity.connected:false"

Output:

{
    "statistics": {
        "count": 6
    }
}

Untuk informasi selengkapnya, lihat Mendapatkan Statistik Tentang Armada Perangkat Anda di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanget-topic-rule-destination.

AWS CLI

Untuk mendapatkan tujuan aturan topik

get-topic-rule-destinationContoh berikut mendapatkan informasi tentang tujuan aturan topik.

aws iot get-topic-rule-destination \
    --arn "arn:aws:iot:us-west-2:123456789012:ruledestination/http/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"

Output:

{
    "topicRuleDestination": {
        "arn": "arn:aws:iot:us-west-2:123456789012:ruledestination/http/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
        "status": "DISABLED",
        "httpUrlProperties": {
            "confirmationUrl": "https://example.com"
        }
    }
}

Untuk informasi selengkapnya, lihat Bek erja dengan tujuan aturan topik di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanget-topic-rule.

AWS CLI

Untuk mendapatkan informasi tentang aturan

get-topic-ruleContoh berikut mendapatkan informasi tentang aturan yang ditentukan.

aws iot get-topic-rule \
    --rule-name MyRPiLowMoistureAlertRule

Output:

{
    "ruleArn": "arn:aws:iot:us-west-2:123456789012:rule/MyRPiLowMoistureAlertRule",
    "rule": {
        "ruleName": "MyRPiLowMoistureAlertRule",
        "sql": "SELECT * FROM '$aws/things/MyRPi/shadow/update/accepted' WHERE state.reported.moisture = 'low'\n                    ",
        "description": "Sends an alert whenever soil moisture level readings are too low.",
        "createdAt": 1558624363.0,
        "actions": [
            {
                "sns": {
                    "targetArn": "arn:aws:sns:us-west-2:123456789012:MyRPiLowMoistureTopic",
                    "roleArn": "arn:aws:iam::123456789012:role/service-role/MyRPiLowMoistureTopicRole",
                    "messageFormat": "RAW"
                }
            }
        ],
        "ruleDisabled": false,
        "awsIotSqlVersion": "2016-03-23"
    }
}

Untuk informasi selengkapnya, lihat Melihat Aturan Anda di Panduan Pengembang AWS IoT.

  • Untuk detail API, lihat GetTopicRule di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-v2-logging-options.

AWS CLI

Untuk membuat daftar opsi logging saat ini

get-v2-logging-optionsContoh berikut mencantumkan opsi logging saat ini untuk AWS IoT.

aws iot get-v2-logging-options

Output:

{
    "roleArn": "arn:aws:iam::094249569039:role/service-role/iotLoggingRole",
    "defaultLogLevel": "WARN",
    "disableAllLogs": false
}

Untuk informasi selengkapnya, lihat judul di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-active-violations.

AWS CLI

Untuk membuat daftar pelanggaran aktif

list-active-violationsContoh berikut mencantumkan semua pelanggaran untuk profil keamanan yang ditentukan.

aws iot list-active-violations \
    --security-profile-name Testprofile

Output:

{
    "activeViolations": [
        {
            "violationId": "174db59167fa474c80a652ad1583fd44",
            "thingName": "iotconsole-1560269126751-1",
            "securityProfileName": "Testprofile",
            "behavior": {
                "name": "Authorization",
                "metric": "aws:num-authorization-failures",
                "criteria": {
                    "comparisonOperator": "greater-than",
                    "value": {
                        "count": 10
                    },
                    "durationSeconds": 300,
                    "consecutiveDatapointsToAlarm": 1,
                    "consecutiveDatapointsToClear": 1
                }
            },
            "lastViolationValue": {
                "count": 0
            },
            "lastViolationTime": 1560293700.0,
            "violationStartTime": 1560279000.0
        },
        {
            "violationId": "c8a9466a093d3b7b35cd44ca58bdbeab",
            "thingName": "TvnQoEoU",
            "securityProfileName": "Testprofile",
            "behavior": {
                "name": "CellularBandwidth",
                "metric": "aws:message-byte-size",
                "criteria": {
                    "comparisonOperator": "greater-than",
                    "value": {
                        "count": 128
                    },
                    "consecutiveDatapointsToAlarm": 1,
                    "consecutiveDatapointsToClear": 1
                }
            },
            "lastViolationValue": {
                "count": 110
            },
            "lastViolationTime": 1560369000.0,
            "violationStartTime": 1560276600.0
        },
        {
            "violationId": "74aa393adea02e6648f3ac362beed55e",
            "thingName": "iotconsole-1560269232412-2",
            "securityProfileName": "Testprofile",
            "behavior": {
                "name": "Authorization",
                "metric": "aws:num-authorization-failures",
                "criteria": {
                    "comparisonOperator": "greater-than",
                    "value": {
                        "count": 10
                    },
                    "durationSeconds": 300,
                    "consecutiveDatapointsToAlarm": 1,
                    "consecutiveDatapointsToClear": 1
                }
            },
            "lastViolationValue": {
                "count": 0
            },
            "lastViolationTime": 1560276600.0,
            "violationStartTime": 1560276600.0
        },
        {
            "violationId": "1e6ab5f7cf39a1466fcd154e1377e406",
            "thingName": "TvnQoEoU",
            "securityProfileName": "Testprofile",
            "behavior": {
                "name": "Authorization",
                "metric": "aws:num-authorization-failures",
                "criteria": {
                    "comparisonOperator": "greater-than",
                    "value": {
                        "count": 10
                    },
                    "durationSeconds": 300,
                    "consecutiveDatapointsToAlarm": 1,
                    "consecutiveDatapointsToClear": 1
                }
            },
            "lastViolationValue": {
                "count": 0
            },
            "lastViolationTime": 1560369000.0,
            "violationStartTime": 1560276600.0
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakanlist-attached-policies.

AWS CLI

Contoh 1: Untuk membuat daftar kebijakan yang dilampirkan ke grup

list-attached-policiesContoh berikut mencantumkan kebijakan yang dilampirkan ke grup yang ditentukan.

aws iot list-attached-policies \
    --target "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs"

Output:

{
    "policies": [
        {
            "policyName": "UpdateDeviceCertPolicy",
            "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/UpdateDeviceCertPolicy"
        }
    ]
}

Untuk informasi selengkapnya, lihat Grup Hal di Panduan AWS Pengembang IoT.

Contoh 2: Untuk membuat daftar kebijakan yang dilampirkan ke sertifikat perangkat

list-attached-policiesContoh berikut mencantumkan kebijakan AWS IoT yang dilampirkan ke sertifikat perangkat. Sertifikat diidentifikasi oleh ARN-nya.

aws iot list-attached-policies \
    --target arn:aws:iot:us-west-2:123456789012:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142

Output:

{
    "policies": [
        {
            "policyName": "TemperatureSensorPolicy",
            "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/TemperatureSensorPolicy"
        }
    ]
}

Untuk informasi selengkapnya, lihat Grup Hal di Panduan AWS Pengembang IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-audit-findings.

AWS CLI

Contoh 1: Untuk membuat daftar semua temuan dari audit

list-audit-findingsContoh berikut mencantumkan semua temuan dari audit AWS IoT Device Defender dengan ID tugas tertentu.

aws iot list-audit-findings \
    --task-id a3aea009955e501a31b764abe1bebd3d

Output:

{
    "findings": []
}

Contoh 2: Untuk membuat daftar temuan untuk jenis pemeriksaan audit

list-audit-findingsContoh berikut menunjukkan temuan dari audit AWS IoT Device Defender yang berjalan antara 5 Juni 2019 dan 19 Juni 2019 di mana perangkat berbagi sertifikat perangkat. Saat Anda menentukan nama cek, Anda harus memberikan waktu mulai dan akhir.

aws iot list-audit-findings \
    --check-name DEVICE_CERTIFICATE_SHARED_CHECK \
    --start-time 1559747125 \
    --end-time 1560962028

Output:

{
    "findings": [
        {
            "taskId": "eeef61068b0eb03c456d746c5a26ee04",
            "checkName": "DEVICE_CERTIFICATE_SHARED_CHECK",
            "taskStartTime": 1560161017.172,
            "findingTime": 1560161017.592,
            "severity": "CRITICAL",
            "nonCompliantResource": {
                "resourceType": "DEVICE_CERTIFICATE",
                "resourceIdentifier": {
                    "deviceCertificateId": "b193ab7162c0fadca83246d24fa090300a1236fe58137e121b011804d8ac1d6b"
                }
            },
            "relatedResources": [
                {
                    "resourceType": "CLIENT_ID",
                    "resourceIdentifier": {
                        "clientId": "ZipxgAIl"
                    },
                    "additionalInfo": {
                        "CONNECTION_TIME": "1560086374068"
                    }
                },
                {
                    "resourceType": "CLIENT_ID",
                    "resourceIdentifier": {
                        "clientId": "ZipxgAIl"
                    },
                    "additionalInfo": {
                        "CONNECTION_TIME": "1560081552187",
                        "DISCONNECTION_TIME": "1560086371552"
                    }
                },
                {
                    "resourceType": "CLIENT_ID",
                    "resourceIdentifier": {
                        "clientId": "ZipxgAIl"
                    },
                    "additionalInfo": {
                        "CONNECTION_TIME": "1559289863631",
                        "DISCONNECTION_TIME": "1560081532716"
                    }
                }
            ],
            "reasonForNonCompliance": "Certificate shared by one or more devices.",
            "reasonForNonComplianceCode": "CERTIFICATE_SHARED_BY_MULTIPLE_DEVICES"
        },
        {
            "taskId": "bade6b5efd2e1b1569822f6021b39cf5",
            "checkName": "DEVICE_CERTIFICATE_SHARED_CHECK",
            "taskStartTime": 1559988217.27,
            "findingTime": 1559988217.655,
            "severity": "CRITICAL",
            "nonCompliantResource": {
                "resourceType": "DEVICE_CERTIFICATE",
                "resourceIdentifier": {
                    "deviceCertificateId": "b193ab7162c0fadca83246d24fa090300a1236fe58137e121b011804d8ac1d6b"
                }
            },
            "relatedResources": [
                {
                    "resourceType": "CLIENT_ID",
                    "resourceIdentifier": {
                        "clientId": "xShGENLW"
                    },
                    "additionalInfo": {
                        "CONNECTION_TIME": "1559972350825"
                    }
                },
                {
                    "resourceType": "CLIENT_ID",
                    "resourceIdentifier": {
                        "clientId": "xShGENLW"
                    },
                    "additionalInfo": {
                        "CONNECTION_TIME": "1559255062002",
                        "DISCONNECTION_TIME": "1559972350616"
                    }
                }
            ],
            "reasonForNonCompliance": "Certificate shared by one or more devices.",
            "reasonForNonComplianceCode": "CERTIFICATE_SHARED_BY_MULTIPLE_DEVICES"
        },
        {
            "taskId": "c23f6233ba2d35879c4bb2810fb5ffd6",
            "checkName": "DEVICE_CERTIFICATE_SHARED_CHECK",
            "taskStartTime": 1559901817.31,
            "findingTime": 1559901817.767,
            "severity": "CRITICAL",
            "nonCompliantResource": {
                "resourceType": "DEVICE_CERTIFICATE",
                "resourceIdentifier": {
                    "deviceCertificateId": "b193ab7162c0fadca83246d24fa090300a1236fe58137e121b011804d8ac1d6b"
                }
            },
            "relatedResources": [
                {
                    "resourceType": "CLIENT_ID",
                    "resourceIdentifier": {
                        "clientId": "TvnQoEoU"
                    },
                    "additionalInfo": {
                        "CONNECTION_TIME": "1559826729768"
                    }
                },
                {
                    "resourceType": "CLIENT_ID",
                    "resourceIdentifier": {
                        "clientId": "TvnQoEoU"
                    },
                    "additionalInfo": {
                        "CONNECTION_TIME": "1559345920964",
                        "DISCONNECTION_TIME": "1559826728402"
                    }
                }
            ],
            "reasonForNonCompliance": "Certificate shared by one or more devices.",
            "reasonForNonComplianceCode": "CERTIFICATE_SHARED_BY_MULTIPLE_DEVICES"
        }
    ]
}

Untuk informasi selengkapnya, lihat Perintah Audit di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-audit-mitigation-actions-executions.

AWS CLI

Untuk mencantumkan rincian pelaksanaan tindakan mitigasi audit

Tugas tindakan mitigasi audit menerapkan tindakan mitigasi ke satu atau lebih temuan dari audit AWS IoT Device Defender. list-audit-mitigation-actions-executionsContoh berikut mencantumkan detail untuk tugas tindakan mitigasi dengan yang ditentukan taskId dan untuk temuan yang ditentukan.

aws iot list-audit-mitigation-actions-executions \
    --task-id myActionsTaskId \
    --finding-id 0edbaaec-2fe1-4cf5-abc9-d4c3e51f7464

Output:

{
    "actionsExecutions": [
        {
            "taskId": "myActionsTaskId",
            "findingId": "0edbaaec-2fe1-4cf5-abc9-d4c3e51f7464",
            "actionName": "ResetPolicyVersionAction",
            "actionId": "1ea0b415-bef1-4a01-bd13-72fb63c59afb",
            "status": "COMPLETED",
            "startTime": "2019-12-10T15:19:13.279000-08:00",
            "endTime": "2019-12-10T15:19:13.337000-08:00"
        }
    ]
}

Untuk informasi selengkapnya, lihat ListAuditMitigationActionsExecutions (Perintah Tindakan Miti gasi) di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-audit-mitigation-actions-tasks.

AWS CLI

Untuk membuat daftar tugas tindakan mitigasi audit

list-audit-mitigation-actions-tasksContoh berikut mencantumkan tindakan mitigasi yang diterapkan pada temuan dalam periode waktu yang ditentukan.

aws iot list-audit-mitigation-actions-tasks \
    --start-time 1594157400 \
    --end-time 1594157430

Output:

{
    "tasks": [
        {
                "taskId": "0062f2d6-3999-488f-88c7-bef005414103",
                "startTime": "2020-07-07T14:30:15.172000-07:00",
            "taskStatus": "COMPLETED"
        }
    ]
}

Untuk informasi selengkapnya, lihat ListAuditMitigationActionsTasks (Perintah Tindakan Miti gasi) di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-audit-suppressions.

AWS CLI

Untuk mencantumkan semua penekanan temuan audit

list-audit-suppressionsContoh berikut mencantumkan semua penekanan penemuan audit aktif.

aws iot list-audit-suppressions

Output:

{
    "suppressions": [
        {
        "checkName": "DEVICE_CERTIFICATE_EXPIRING_CHECK",
            "resourceIdentifier": {
                "deviceCertificateId": "c7691e<shortened>"
            },
        "expirationDate": 1597881600.0,
        "suppressIndefinitely": false
        }
    ]
}

Untuk informasi selengkapnya, lihat Penekanan pencarian audit di Panduan Peng AWS embang IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-audit-tasks.

AWS CLI

Untuk membuat daftar semua temuan dari audit

list-audit-tasksContoh berikut mencantumkan tugas audit yang berjalan antara 5 Juni 2019 dan 12 Juni 2019.

aws iot list-audit-tasks \
    --start-time 1559747125 \
    --end-time 1560357228

Output:

{
    "tasks": [
        {
            "taskId": "a3aea009955e501a31b764abe1bebd3d",
            "taskStatus": "COMPLETED",
            "taskType": "ON_DEMAND_AUDIT_TASK"
        },
        {
            "taskId": "f76b4b5102b632cd9ae38a279c266da1",
            "taskStatus": "COMPLETED",
            "taskType": "SCHEDULED_AUDIT_TASK"
        },
        {
            "taskId": "51d9967d9f9ff4d26529505f6d2c444a",
            "taskStatus": "COMPLETED",
            "taskType": "SCHEDULED_AUDIT_TASK"
        },
        {
            "taskId": "eeef61068b0eb03c456d746c5a26ee04",
            "taskStatus": "COMPLETED",
            "taskType": "SCHEDULED_AUDIT_TASK"
        },
        {
            "taskId": "041c49557b7c7b04c079a49514b55589",
            "taskStatus": "COMPLETED",
            "taskType": "SCHEDULED_AUDIT_TASK"
        },
        {
            "taskId": "82c7f2afac1562d18a4560be73998acc",
            "taskStatus": "COMPLETED",
            "taskType": "SCHEDULED_AUDIT_TASK"
        },
        {
            "taskId": "bade6b5efd2e1b1569822f6021b39cf5",
            "taskStatus": "COMPLETED",
            "taskType": "SCHEDULED_AUDIT_TASK"
        },
        {
            "taskId": "c23f6233ba2d35879c4bb2810fb5ffd6",
            "taskStatus": "COMPLETED",
            "taskType": "SCHEDULED_AUDIT_TASK"
        },
        {
            "taskId": "ac9086b7222a2f5e2e17bb6fd30b3aeb",
            "taskStatus": "COMPLETED",
            "taskType": "SCHEDULED_AUDIT_TASK"
        }
    ]
}

Untuk informasi selengkapnya, lihat Perintah Audit di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-authorizers.

AWS CLI

Untuk membuat daftar otorisasi kustom Anda

list-authorizersContoh berikut mencantumkan otorisasi khusus di AWS akun Anda.

aws iot list-authorizers

Output:

{
    "authorizers": [
        {
            "authorizerName": "CustomAuthorizer",
            "authorizerArn": "arn:aws:iot:us-west-2:123456789012:authorizer/CustomAuthorizer"
        },
        {
            "authorizerName": "CustomAuthorizer2",
            "authorizerArn": "arn:aws:iot:us-west-2:123456789012:authorizer/CustomAuthorizer2"
        },
        {
            "authorizerName": "CustomAuthorizer3",
            "authorizerArn": "arn:aws:iot:us-west-2:123456789012:authorizer/CustomAuthorizer3"
        }
    ]
}

Untuk informasi selengkapnya, lihat ListAuthorizers di Refer AWS ensi API IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-billing-groups.

AWS CLI

Untuk membuat daftar grup penagihan untuk AWS akun dan wilayah Anda

list-billing-groupsContoh berikut mencantumkan semua grup penagihan yang ditentukan untuk AWS akun dan Wil AWS ayah Anda.

aws iot list-billing-groups

Output:

{
    "billingGroups": [
        {
            "groupName": "GroupOne",
            "groupArn": "arn:aws:iot:us-west-2:123456789012:billinggroup/GroupOne"
        }
    ]
}

Untuk informasi selengkapnya, lihat Grup Penagihan di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-ca-certificates.

AWS CLI

Untuk mencantumkan sertifikat CA yang terdaftar di AWS akun Anda

list-ca-certificatesContoh berikut mencantumkan sertifikat CA yang terdaftar di AWS akun Anda.

aws iot list-ca-certificates

Output:

{
    "certificates": [
        {
            "certificateArn": "arn:aws:iot:us-west-2:123456789012:cacert/f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467",
            "certificateId": "f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467",
            "status": "INACTIVE",
            "creationDate": 1569365372.053
        }
    ]
}

Untuk informasi selengkapnya, lihat Menggunakan Sertifikat Sen diri di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-certificates-by-ca.

AWS CLI

Untuk mencantumkan semua sertifikat perangkat yang ditandatangani dengan sertifikat CA

list-certificates-by-caContoh berikut mencantumkan semua sertifikat perangkat di AWS akun Anda yang ditandatangani dengan sertifikat CA yang ditentukan.

aws iot list-certificates-by-ca \
    --ca-certificate-id f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467

Output:

{
    "certificates": [
        {
            "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142",
            "certificateId": "488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142",
            "status": "ACTIVE",
            "creationDate": 1569363250.557
        }
    ]
}

Untuk informasi selengkapnya, lihat ListCertificatesByCA di Refer AWS ensi API IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-certificates.

AWS CLI

Contoh 1: Untuk membuat daftar sertifikat yang terdaftar di AWS akun Anda

list-certificatesContoh berikut mencantumkan semua sertifikat yang terdaftar di akun Anda. Jika Anda memiliki lebih dari batas paging default 25, Anda dapat menggunakan nilai nextMarker respons dari perintah ini dan menyediakannya ke perintah berikutnya untuk mendapatkan kumpulan hasil berikutnya. Ulangi sampai nextMarker kembali tanpa nilai.

aws iot list-certificates

Output:

{
    "certificates": [
        {
            "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/604c48437a57b7d5fc5d137c5be75011c6ee67c9a6943683a1acb4b1626bac36",
            "certificateId": "604c48437a57b7d5fc5d137c5be75011c6ee67c9a6943683a1acb4b1626bac36",
            "status": "ACTIVE",
            "creationDate": 1556810537.617
        },
        {
            "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/262a1ac8a7d8aa72f6e96e365480f7313aa9db74b8339ec65d34dc3074e1c31e",
            "certificateId": "262a1ac8a7d8aa72f6e96e365480f7313aa9db74b8339ec65d34dc3074e1c31e",
            "status": "ACTIVE",
            "creationDate": 1546447050.885
        },
        {
            "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/b193ab7162c0fadca83246d24fa090300a1236fe58137e121b011804d8ac1d6b",
            "certificateId": "b193ab7162c0fadca83246d24fa090300a1236fe58137e121b011804d8ac1d6b",
            "status": "ACTIVE",
            "creationDate": 1546292258.322
        },
        {
            "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/7aebeea3845d14a44ec80b06b8b78a89f3f8a706974b8b34d18f5adf0741db42",
            "certificateId": "7aebeea3845d14a44ec80b06b8b78a89f3f8a706974b8b34d18f5adf0741db42",
            "status": "ACTIVE",
            "creationDate": 1541457693.453
        },
        {
            "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/54458aa39ebb3eb39c91ffbbdcc3a6ca1c7c094d1644b889f735a6fc2cd9a7e3",
            "certificateId": "54458aa39ebb3eb39c91ffbbdcc3a6ca1c7c094d1644b889f735a6fc2cd9a7e3",
            "status": "ACTIVE",
            "creationDate": 1541113568.611
        },
        {
            "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/4f0ba725787aa94d67d2fca420eca022242532e8b3c58e7465c7778b443fd65e",
            "certificateId": "4f0ba725787aa94d67d2fca420eca022242532e8b3c58e7465c7778b443fd65e",
            "status": "ACTIVE",
            "creationDate": 1541022751.983
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakanlist-custom-metrics.

AWS CLI

Untuk membuat daftar metrik kustom Anda

list-custom-metricsContoh berikut mencantumkan semua metrik kustom Anda.

aws iot list-custom-metrics \
    --region us-east-1

Output:

{
    "metricNames": [
        "batteryPercentage"
    ]
}

Untuk informasi selengkapnya, lihat Metrik khusus di Panduan Pengembang Inti AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-dimensions.

AWS CLI

Untuk mencantumkan dimensi untuk AWS akun Anda

list-dimensionsContoh berikut mencantumkan semua dimensi AWS IoT Device Defender yang ditentukan di AWS akun Anda.

aws iot list-dimensions

Output:

{
    "dimensionNames": [
        "TopicFilterForAuthMessages",
        "TopicFilterForActivityMessages"
    ]
}

Untuk informasi selengkapnya, lihat Mendeteksi Perintah di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-domain-configurations.

AWS CLI

Untuk mencantumkan konfigurasi domain

list-domain-configurationsContoh berikut mencantumkan konfigurasi domain di AWS akun Anda yang memiliki jenis layanan yang ditentukan.

aws iot list-domain-configurations \
    --service-type "DATA"

Output:

{
    "domainConfigurations":
    [
        {
            "domainConfigurationName": "additionalDataDomain",
            "domainConfigurationArn": "arn:aws:iot:us-west-2:123456789012:domainconfiguration/additionalDataDomain/dikMh",
            "serviceType": "DATA"
        },

        {
            "domainConfigurationName": "iot:Jobs",
            "domainConfigurationArn": "arn:aws:iot:us-west-2:123456789012:domainconfiguration/iot:Jobs",
            "serviceType": "JOBS"
        },
        {
            "domainConfigurationName": "iot:Data-ATS",
            "domainConfigurationArn": "arn:aws:iot:us-west-2:123456789012:domainconfiguration/iot:Data-ATS",
            "serviceType": "DATA"
        },
        {
            "domainConfigurationName": "iot:CredentialProvider",
            "domainConfigurationArn": "arn:aws:iot:us-west-2:123456789012:domainconfiguration/iot:CredentialProvider",
            "serviceType": "CREDENTIAL_PROVIDER"
        }
    ]
}

Untuk informasi selengkapnya, lihat T itik Akhir yang Dapat Dikonfigurasi di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-indices.

AWS CLI

Untuk membuat daftar indeks pencarian yang dikonfigurasi

list-indicesContoh berikut mencantumkan semua indeks pencarian yang dikonfigurasi di AWS akun Anda. Jika Anda belum mengaktifkan pengindeksan sesuatu, Anda mungkin tidak memiliki indeks apa pun.

aws iot list-indices

Output:

{
    "indexNames": [
        "AWS_Things"
    ]
}

Untuk informasi selengkapnya, lihat Mengelola Pengindeksan Hal di Panduan Pengembang AWS IoT.

  • Untuk detail API, lihat ListIndices di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-job-executions-for-job.

AWS CLI

Untuk membuat daftar pekerjaan di AWS akun Anda

list-job-executions-for-jobContoh berikut mencantumkan semua eksekusi pekerjaan untuk pekerjaan di AWS akun Anda, yang ditentukan oleh JobID.

aws iot list-job-executions-for-job \
    --job-id my-ota-job

Output:

{
     "executionSummaries": [
         {
             "thingArn": "arn:aws:iot:us-east-1:123456789012:thing/my_thing",
             "jobExecutionSummary": {
                 "status": "QUEUED",
                 "queuedAt": "2022-03-07T15:58:42.195000-08:00",
                 "lastUpdatedAt": "2022-03-07T15:58:42.195000-08:00",
                 "executionNumber": 1,
                 "retryAttempt": 0
             }
         }
     ]
 }

Untuk informasi selengkapnya, lihat Membuat dan Mengelola Pekerjaan (CLI) di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-job-executions-for-thing.

AWS CLI

Untuk membuat daftar pekerjaan yang dieksekusi untuk suatu hal

list-job-executions-for-thingContoh berikut mencantumkan semua pekerjaan yang dieksekusi untuk hal bernamaMyRaspberryPi.

aws iot list-job-executions-for-thing \
    --thing-name "MyRaspberryPi"

Output:

{
    "executionSummaries": [
        {
            "jobId": "example-job-01",
            "jobExecutionSummary": {
                "status": "QUEUED",
                "queuedAt": 1560787023.636,
                "lastUpdatedAt": 1560787023.636,
                "executionNumber": 1
            }
        }
    ]
}

Untuk informasi selengkapnya, lihat Membuat dan Mengelola Pekerjaan (CLI) di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-jobs.

AWS CLI

Untuk membuat daftar pekerjaan di AWS akun Anda

list-jobsContoh berikut mencantumkan semua pekerjaan di AWS akun Anda, diurutkan berdasarkan status pekerjaan.

aws iot list-jobs

Output:

{
    "jobs": [
        {
            "jobArn": "arn:aws:iot:us-west-2:123456789012:job/example-job-01",
            "jobId": "example-job-01",
            "targetSelection": "SNAPSHOT",
            "status": "IN_PROGRESS",
            "createdAt": 1560787022.733,
            "lastUpdatedAt": 1560787026.294
        }
    ]
}

Untuk informasi selengkapnya, lihat Membuat dan Mengelola Pekerjaan (CLI) di Panduan Pengembang AWS IoT.

  • Untuk detail API, lihat ListJobs di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-mitigation-actions.

AWS CLI

Untuk membuat daftar semua tindakan mitigasi yang ditentukan

list-mitigation-actionsContoh berikut mencantumkan semua tindakan mitigasi yang ditentukan untuk AWS akun dan Wilayah Anda. Untuk setiap tindakan, nama, ARN, dan tanggal pembuatan terdaftar.

aws iot list-mitigation-actions

Output:

{
    "actionIdentifiers": [
        {
            "actionName": "DeactivateCACertAction",
            "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/DeactivateCACertAction",
            "creationDate": "2019-12-10T11:12:47.574000-08:00"
        },
        {
            "actionName": "ResetPolicyVersionAction",
            "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/ResetPolicyVersionAction",
            "creationDate": "2019-12-10T11:11:48.920000-08:00"
        },
        {
            "actionName": "PublishFindingToSNSAction",
            "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/PublishFindingToSNSAction",
            "creationDate": "2019-12-10T11:10:49.546000-08:00"
        },
        {
            "actionName": "AddThingsToQuarantineGroupAction",
            "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/AddThingsToQuarantineGroupAction",
            "creationDate": "2019-12-10T11:09:35.999000-08:00"
        },
        {
            "actionName": "UpdateDeviceCertAction",
            "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/UpdateDeviceCertAction",
            "creationDate": "2019-12-10T11:08:44.263000-08:00"
        },
        {
            "actionName": "SampleMitigationAction",
            "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/SampleMitigationAction",
            "creationDate": "2019-12-10T11:03:41.840000-08:00"
        }
    ]
}

Untuk informasi selengkapnya, lihat ListMitigationActions (Perintah Tindakan Miti gasi) di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-mitigations-actions.

AWS CLI

Untuk membuat daftar semua tindakan mitigasi yang ditentukan

list-mitigations-actionsContoh berikut mencantumkan semua tindakan mitigasi yang ditentukan untuk AWS akun dan Wilayah Anda. Untuk setiap tindakan, nama, ARN, dan tanggal pembuatan terdaftar.

aws iot list-mitigation-actions

Output:

{
    "actionIdentifiers": [
        {
            "actionName": "DeactivateCACertAction",
            "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/DeactivateCACertAction",
            "creationDate": "2019-12-10T11:12:47.574000-08:00"
        },
        {
            "actionName": "ResetPolicyVersionAction",
            "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/ResetPolicyVersionAction",
            "creationDate": "2019-12-10T11:11:48.920000-08:00"
        },
        {
            "actionName": "PublishFindingToSNSAction",
            "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/PublishFindingToSNSAction",
            "creationDate": "2019-12-10T11:10:49.546000-08:00"
        },
        {
            "actionName": "AddThingsToQuarantineGroupAction",
            "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/AddThingsToQuarantineGroupAction",
            "creationDate": "2019-12-10T11:09:35.999000-08:00"
        },
        {
            "actionName": "UpdateDeviceCertAction",
            "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/UpdateDeviceCertAction",
            "creationDate": "2019-12-10T11:08:44.263000-08:00"
        },
        {
            "actionName": "SampleMitigationAction",
            "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/SampleMitigationAction",
            "creationDate": "2019-12-10T11:03:41.840000-08:00"
        }
    ]
}

Untuk informasi selengkapnya, lihat ListMitigationActions (Perintah Tindakan Miti gasi) di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-ota-updates.

AWS CLI

Untuk mencantumkan Pembaruan OTA untuk akun

list-ota-updatesContoh berikut mencantumkan pembaruan OTA yang tersedia.

aws iot list-ota-updates

Output:

{
    "otaUpdates": [
        {
            "otaUpdateId": "itsaupdate",
            "otaUpdateArn": "arn:aws:iot:us-west-2:123456789012:otaupdate/itsaupdate",
            "creationDate": 1557863215.995
        }
    ]
}

Untuk informasi selengkapnya, lihat ListotaUpdates di Referensi API AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-outgoing-certificates.

AWS CLI

Untuk mencantumkan sertifikat yang ditransfer ke AWS akun lain

list-outgoing-certificatesContoh berikut mencantumkan semua sertifikat perangkat yang sedang dalam proses ditransfer ke AWS akun yang berbeda menggunakan transfer-certificate perintah.

aws iot list-outgoing-certificates

Output:

{
    "outgoingCertificates": [
        {
            "certificateArn": "arn:aws:iot:us-west-2:030714055129:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142",
            "certificateId": "488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142",
            "transferredTo": "030714055129",
            "transferDate": 1569427780.441,
            "creationDate": 1569363250.557
        }
    ]
}

Untuk informasi selengkapnya, lihat ListOutgoingCertificates di Refer AWS ensi API IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-policies.

AWS CLI

Untuk membuat daftar kebijakan yang ditentukan di AWS akun Anda

list-policiesContoh berikut mencantumkan semua kebijakan yang ditentukan di AWS akun Anda.

aws iot list-policies

Output:

{
    "policies": [
        {
            "policyName": "UpdateDeviceCertPolicy",
            "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/UpdateDeviceCertPolicy"
        },
        {
            "policyName": "PlantIoTPolicy",
            "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/PlantIoTPolicy"
        },
        {
            "policyName": "MyPiGroup_Core-policy",
            "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/MyPiGroup_Core-policy"
        }
    ]
}

Untuk informasi selengkapnya, lihat Kebijakan AWS IoT di Panduan AWS Pengembang IoT.

  • Untuk detail API, lihat ListPolicies di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-policy-versions.

AWS CLI

Contoh 1: Untuk melihat semua versi kebijakan

list-policy-versionsContoh berikut mencantumkan semua versi kebijakan yang ditentukan dan tanggal pembuatannya.

aws iot list-policy-versions \
    --policy-name LightBulbPolicy

Output:

{
    "policyVersions": [
        {
            "versionId": "2",
            "isDefaultVersion": true,
            "createDate": 1559925941.924
        },
        {
            "versionId": "1",
            "isDefaultVersion": false,
            "createDate": 1559925941.924
        }
    ]
}

Untuk informasi selengkapnya, lihat Kebijakan AWS IoT di Panduan AWS Pengembang IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-principal-things.

AWS CLI

Untuk membuat daftar hal-hal yang dilampirkan dengan kepala sekolah

list-principal-thingsContoh berikut mencantumkan hal-hal yang melekat pada prinsipal yang ditentukan oleh ARN.

aws iot list-principal-things \
    --principal arn:aws:iot:us-west-2:123456789012:cert/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8

Output:

{
    "things": [
        "DeskLamp",
        "TableLamp"
    ]
}

Untuk informasi selengkapnya, lihat ListPrincipalThings di Refer AWS ensi API IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-provisioning-template-versions.

AWS CLI

Untuk mencantumkan versi templat penyediaan

list-provisioning-template-versionsContoh berikut mencantumkan versi yang tersedia dari template penyediaan yang ditentukan.

aws iot list-provisioning-template-versions \
    --template-name "widget-template"

Output:

{
    "versions": [
        {
            "versionId": 1,
            "creationDate": 1574800471.339,
            "isDefaultVersion": true
        },
        {
            "versionId": 2,
            "creationDate": 1574801192.317,
            "isDefaultVersion": false
        }
    ]
}

Untuk informasi selengkapnya, lihat AWS IoT Secure Tunneling di Panduan Pengembang AWS IoT Core.

Contoh kode berikut menunjukkan cara menggunakanlist-provisioning-templates.

AWS CLI

Untuk membuat daftar templat penyediaan

list-provisioning-templatesContoh berikut mencantumkan semua templat penyediaan di AWS akun Anda.

aws iot list-provisioning-templates

Output:

{
    "templates": [
        {
            "templateArn": "arn:aws:iot:us-east-1:123456789012:provisioningtemplate/widget-template",
            "templateName": "widget-template",
            "description": "A provisioning template for widgets",
            "creationDate": 1574800471.367,
            "lastModifiedDate": 1574801192.324,
            "enabled": false
        }
    ]
}

Untuk informasi selengkapnya, lihat AWS IoT Secure Tunneling di Panduan Pengembang AWS IoT Core.

Contoh kode berikut menunjukkan cara menggunakanlist-role-aliases.

AWS CLI

Untuk mencant AWS umkan alias peran IoT di akun Anda AWS

list-role-aliasesContoh berikut mencantumkan AWS alias peran IoT di AWS akun Anda.

aws iot list-role-aliases

Output:

{
    "roleAliases": [
        "ResidentAlias",
        "ElectricianAlias"
    ]
}

Untuk informasi selengkapnya, lihat ListRoleAliases di Refer AWS ensi API IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-scheduled-audits.

AWS CLI

Untuk membuat daftar audit yang dijadwalkan untuk AWS akun Anda

list-scheduled-auditsContoh berikut mencantumkan audit apa pun yang dijadwalkan untuk AWS akun Anda.

aws iot list-scheduled-audits

Output:

{
    "scheduledAudits": [
        {
            "scheduledAuditName": "AWSIoTDeviceDefenderDailyAudit",
            "scheduledAuditArn": "arn:aws:iot:us-west-2:123456789012:scheduledaudit/AWSIoTDeviceDefenderDailyAudit",
            "frequency": "DAILY"
        },
        {
            "scheduledAuditName": "AWSDeviceDefenderWeeklyAudit",
            "scheduledAuditArn": "arn:aws:iot:us-west-2:123456789012:scheduledaudit/AWSDeviceDefenderWeeklyAudit",
            "frequency": "WEEKLY",
            "dayOfWeek": "SUN"
        }
    ]
}

Untuk informasi selengkapnya, lihat Perintah Audit di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-security-profiles-for-target.

AWS CLI

Untuk membuat daftar profil keamanan yang dilampirkan ke target

list-security-profiles-for-targetContoh berikut mencantumkan profil keamanan AWS IoT Device Defender yang dilampirkan ke perangkat yang tidak terdaftar.

aws iot list-security-profiles-for-target  \
    --security-profile-target-arn "arn:aws:iot:us-west-2:123456789012:all/unregistered-things"

Output:

{
    "securityProfileTargetMappings": [
        {
            "securityProfileIdentifier": {
                "name": "Testprofile",
                "arn": "arn:aws:iot:us-west-2:123456789012:securityprofile/Testprofile"
            },
            "target": {
                "arn": "arn:aws:iot:us-west-2:123456789012:all/unregistered-things"
            }
        }
    ]
}

Untuk informasi selengkapnya, lihat Mendeteksi Perintah di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-security-profiles.

AWS CLI

Untuk membuat daftar profil keamanan untuk AWS akun Anda

list-security-profilesContoh berikut mencantumkan semua profil keamanan AWS IoT Device Defender yang ditentukan di AWS akun Anda.

aws iot list-security-profiles

Output:

{
    "securityProfileIdentifiers": [
        {
            "name": "Testprofile",
            "arn": "arn:aws:iot:us-west-2:123456789012:securityprofile/Testprofile"
        }
    ]
}

Untuk informasi selengkapnya, lihat Mendeteksi Perintah di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-streams.

AWS CLI

Untuk membuat daftar aliran di akun

list-streamsContoh berikut mencantumkan semua aliran di AWS akun Anda.

aws iot list-streams

Output:

{
    "streams": [
        {
            "streamId": "stream12345",
            "streamArn": "arn:aws:iot:us-west-2:123456789012:stream/stream12345",
            "streamVersion": 1,
            "description": "This stream is used for Amazon FreeRTOS OTA Update 12345."
        },
        {
            "streamId": "stream54321",
            "streamArn": "arn:aws:iot:us-west-2:123456789012:stream/stream54321",
            "streamVersion": 1,
            "description": "This stream is used for Amazon FreeRTOS OTA Update 54321."
        }
    ]
}

Untuk informasi selengkapnya, lihat ListStreams di Refer AWS ensi API IoT.

  • Untuk detail API, lihat ListStreams di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-tags-for-resource.

AWS CLI

Untuk menampilkan tag dan nilainya yang terkait dengan sumber daya

list-tags-for-resourceContoh berikut menampilkan tag dan nilai yang terkait dengan kelompok bendaLightBulbs.

aws iot list-tags-for-resource \
    --resource-arn "arn:aws:iot:us-west-2:094249569039:thinggroup/LightBulbs"

Output:

{
    "tags": [
        {
            "Key": "Assembly",
            "Value": "Fact1NW"
        },
        {
            "Key": "MyTag",
            "Value": "777"
        }
    ]
}

Untuk informasi selengkapnya, lihat Menandai Sumber AWS Daya IoT Anda di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-targets-for-policy.

AWS CLI

Untuk membuat daftar prinsipal yang terkait dengan kebijakan AWS IoT

list-targets-for-policyContoh berikut mencantumkan sertifikat perangkat yang dilampirkan kebijakan yang ditentukan.

aws iot list-targets-for-policy \
    --policy-name UpdateDeviceCertPolicy

Output:

{
    "targets": [
        "arn:aws:iot:us-west-2:123456789012:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142",
        "arn:aws:iot:us-west-2:123456789012:cert/d1eb269fb55a628552143c8f96eb3c258fcd5331ea113e766ba0c82bf225f0be"
    ]
}

Untuk informasi selengkapnya, lihat Grup Hal di Panduan AWS Pengembang IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-targets-for-security-profile.

AWS CLI

Untuk mencantumkan target yang diterapkan profil keamanan

list-targets-for-security-profileContoh berikut mencantumkan target yang diberi nama profil keamanan AWS IoT Device Defender PossibleIssue diterapkan.

aws iot list-targets-for-security-profile \
    --security-profile-name Testprofile

Output:

{
    "securityProfileTargets": [
        {
            "arn": "arn:aws:iot:us-west-2:123456789012:all/unregistered-things"
        },
        {
            "arn": "arn:aws:iot:us-west-2:123456789012:all/registered-things"
        }
    ]
}

Untuk informasi selengkapnya, lihat Mendeteksi Perintah di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-thing-groups-for-thing.

AWS CLI

Untuk membuat daftar kelompok-kelompok yang dimiliki suatu benda

list-thing-groups-for-thingContoh berikut mencantumkan grup yang dimiliki benda yang ditentukan.

aws iot list-thing-groups-for-thing \
    --thing-name MyLightBulb

Output:

{
    "thingGroups": [
        {
            "groupName": "DeadBulbs",
            "groupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/DeadBulbs"
        },
        {
            "groupName": "LightBulbs",
            "groupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs"
        }
    ]
}

Untuk informasi selengkapnya, lihat Grup Hal di Panduan AWS Pengembang IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-thing-groups.

AWS CLI

Untuk membuat daftar grup hal yang ditentukan di AWS akun Anda

describe-thing-groupContoh berikut mencantumkan semua grup hal yang ditentukan di AWS akun Anda.

aws iot list-thing-groups

Output:

{
    "thingGroups": [
        {
            "groupName": "HalogenBulbs",
            "groupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/HalogenBulbs"
        },
        {
            "groupName": "LightBulbs",
            "groupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs"
        }
    ]
}

Untuk informasi selengkapnya, lihat Grup Hal di Panduan AWS Pengembang IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-thing-principals.

AWS CLI

Untuk membuat daftar prinsip-prinsip yang terkait dengan sesuatu

list-thing-principalsContoh berikut mencantumkan prinsipal (X.509 sertifikat, pengguna IAM, grup, peran, identitas Amazon Cognito, atau identitas federasi) yang terkait dengan hal yang ditentukan.

aws iot list-thing-principals \
    --thing-name MyRaspberryPi

Output:

{
    "principals": [
        "arn:aws:iot:us-west-2:123456789012:cert/33475ac865079a5ffd5ecd44240640349293facc760642d7d8d5dbb6b4c86893"
    ]
}

Untuk informasi selengkapnya, lihat ListThingPrincipals di Refer AWS ensi API IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-thing-types.

AWS CLI

Untuk membuat daftar jenis benda yang ditentukan

list-thing-typesContoh berikut menampilkan daftar jenis hal yang ditentukan dalam AWS akun Anda.

aws iot list-thing-types

Output:

{
    "thingTypes": [
        {
            "thingTypeName": "LightBulb",
            "thingTypeArn": "arn:aws:iot:us-west-2:123456789012:thingtype/LightBulb",
            "thingTypeProperties": {
                "thingTypeDescription": "light bulb type",
                "searchableAttributes": [
                    "model",
                    "wattage"
                ]
            },
            "thingTypeMetadata": {
            "deprecated": false,
            "creationDate": 1559772562.498
            }
        }
    ]
}

Untuk informasi selengkapnya, lihat Jenis Hal di Panduan AWS Pengembang IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-things-in-billing-group.

AWS CLI

Untuk membuat daftar hal-hal dalam grup penagihan

list-things-in-billing-groupContoh berikut mencantumkan hal-hal yang ada dalam grup penagihan yang ditentukan.

aws iot list-things-in-billing-group \
    --billing-group-name GroupOne

Output:

{
    "things": [
        "MyOtherLightBulb",
        "MyLightBulb"
    ]
}

Untuk informasi selengkapnya, lihat Grup Penagihan di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-things-in-thing-group.

AWS CLI

Untuk membuat daftar hal-hal yang termasuk dalam kelompok

list-things-in-thing-groupContoh berikut mencantumkan hal-hal yang termasuk dalam kelompok benda yang ditentukan.

aws iot list-things-in-thing-group \
    --thing-group-name LightBulbs

Output:

{
    "things": [
        "MyLightBulb"
    ]
}

Untuk informasi selengkapnya, lihat Grup Hal di Panduan AWS Pengembang IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-things.

AWS CLI

Contoh 1: Untuk membuat daftar semua hal dalam registri

list-thingsContoh berikut mencantumkan hal-hal (perangkat) yang didefinisikan dalam registri AWS IoT untuk AWS akun Anda.

aws iot list-things

Output:

{
    "things": [
        {
            "thingName": "ThirdBulb",
            "thingTypeName": "LightBulb",
            "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/ThirdBulb",
            "attributes": {
                "model": "123",
                "wattage": "75"
            },
            "version": 2
        },
        {
            "thingName": "MyOtherLightBulb",
            "thingTypeName": "LightBulb",
            "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyOtherLightBulb",
            "attributes": {
                "model": "123",
                "wattage": "75"
            },
            "version": 3
        },
        {
            "thingName": "MyLightBulb",
            "thingTypeName": "LightBulb",
            "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyLightBulb",
            "attributes": {
                "model": "123",
                "wattage": "75"
            },
            "version": 1
        },
        {
        "thingName": "SampleIoTThing",
        "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/SampleIoTThing",
        "attributes": {},
        "version": 1
        }
    ]
}

Contoh 2: Untuk membuat daftar hal-hal yang ditentukan yang memiliki atribut tertentu

list-thingsContoh berikut menampilkan daftar hal-hal yang memiliki atribut bernamawattage.

aws iot list-things \
    --attribute-name wattage

Output:

{
    "things": [
        {
            "thingName": "MyLightBulb",
            "thingTypeName": "LightBulb",
            "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyLightBulb",
            "attributes": {
                "model": "123",
                "wattage": "75"
            },
            "version": 1
        },
        {
            "thingName": "MyOtherLightBulb",
            "thingTypeName": "LightBulb",
            "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyOtherLightBulb",
            "attributes": {
                "model": "123",
                "wattage": "75"
            },
            "version": 3
        }
    ]
}

Untuk informasi selengkapnya, lihat Cara Mengelola Hal dengan Registr i di Panduan AWS Pengembang IoT.

  • Untuk detail API, lihat ListThings di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-topic-rule-destinations.

AWS CLI

Untuk mencantumkan tujuan aturan topik

list-topic-rule-destinationsContoh berikut mencantumkan semua tujuan aturan topik yang telah Anda tentukan di Wil AWS ayah saat ini.

aws iot list-topic-rule-destinations

Output:

{
    "destinationSummaries": [
        {
            "arn": "arn:aws:iot:us-west-2:123456789012:ruledestination/http/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
            "status": "ENABLED",
            "httpUrlSummary": {
                "confirmationUrl": "https://example.com"
            }
        }
    ]
}

Untuk informasi selengkapnya, lihat Bek erja dengan tujuan aturan topik di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-topic-rules.

AWS CLI

Untuk membuat daftar aturan Anda

list-topic-rulesContoh berikut mencantumkan semua aturan yang telah Anda tetapkan.

aws iot list-topic-rules

Output:

{
    "rules": [
        {
            "ruleArn": "arn:aws:iot:us-west-2:123456789012:rule/MyRPiLowMoistureAlertRule",
            "ruleName": "MyRPiLowMoistureAlertRule",
            "topicPattern": "$aws/things/MyRPi/shadow/update/accepted",
            "createdAt": 1558624363.0,
            "ruleDisabled": false
        },
        {
            "ruleArn": "arn:aws:iot:us-west-2:123456789012:rule/MyPlantPiMoistureAlertRule",
            "ruleName": "MyPlantPiMoistureAlertRule",
            "topicPattern": "$aws/things/MyPlantPi/shadow/update/accepted",
            "createdAt": 1541458459.0,
            "ruleDisabled": false
        }
    ]
}

Untuk informasi selengkapnya, lihat Melihat Aturan Anda di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-v2-logging-levels.

AWS CLI

Untuk mencantumkan tingkat pencatatan

list-v2-logging-levelsContoh berikut mencantumkan level logging yang dikonfigurasi. Jika level logging tidak disetel, a NotConfiguredException terjadi saat Anda menjalankan perintah ini.

aws iot list-v2-logging-levels

Output:

{
    "logTargetConfigurations": [
        {
            "logTarget": {
                "targetType": "DEFAULT"
            },
            "logLevel": "ERROR"
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakanlist-violation-events.

AWS CLI

Untuk membuat daftar pelanggaran profil keamanan selama periode waktu

list-violation-eventsContoh berikut mencantumkan pelanggaran yang terjadi antara 5 Juni 2019 dan 12 Juni 2019 untuk semua profil keamanan AWS IoT Device Defender untuk AWS akun saat ini dan Wil AWS ayah.

aws iot list-violation-events \
    --start-time 1559747125 \
    --end-time 1560351925

Output:

{
    "violationEvents": [
        {
            "violationId": "174db59167fa474c80a652ad1583fd44",
            "thingName": "iotconsole-1560269126751-1",
            "securityProfileName": "Testprofile",
            "behavior": {
                "name": "Authorization",
                "metric": "aws:num-authorization-failures",
                "criteria": {
                    "comparisonOperator": "greater-than",
                    "value": {
                        "count": 10
                    },
                    "durationSeconds": 300,
                    "consecutiveDatapointsToAlarm": 1,
                    "consecutiveDatapointsToClear": 1
                }
            },
            "metricValue": {
                "count": 0
            },
            "violationEventType": "in-alarm",
            "violationEventTime": 1560279000.0
        },
        {
            "violationId": "c8a9466a093d3b7b35cd44ca58bdbeab",
            "thingName": "TvnQoEoU",
            "securityProfileName": "Testprofile",
            "behavior": {
                "name": "CellularBandwidth",
                "metric": "aws:message-byte-size",
                "criteria": {
                    "comparisonOperator": "greater-than",
                    "value": {
                        "count": 128
                    },
                    "consecutiveDatapointsToAlarm": 1,
                    "consecutiveDatapointsToClear": 1
                }
            },
            "metricValue": {
                "count": 110
            },
            "violationEventType": "in-alarm",
            "violationEventTime": 1560276600.0
        },
        {
            "violationId": "74aa393adea02e6648f3ac362beed55e",
            "thingName": "iotconsole-1560269232412-2",
            "securityProfileName": "Testprofile",
            "behavior": {
                "name": "Authorization",
                "metric": "aws:num-authorization-failures",
                "criteria": {
                    "comparisonOperator": "greater-than",
                    "value": {
                        "count": 10
                    },
                    "durationSeconds": 300,
                    "consecutiveDatapointsToAlarm": 1,
                    "consecutiveDatapointsToClear": 1
                }
            },
            "metricValue": {
                "count": 0
            },
            "violationEventType": "in-alarm",
            "violationEventTime": 1560276600.0
        },
        {
            "violationId": "1e6ab5f7cf39a1466fcd154e1377e406",
            "thingName": "TvnQoEoU",
            "securityProfileName": "Testprofile",
            "behavior": {
                "name": "Authorization",
                "metric": "aws:num-authorization-failures",
                "criteria": {
                    "comparisonOperator": "greater-than",
                    "value": {
                        "count": 10
                    },
                    "durationSeconds": 300,
                    "consecutiveDatapointsToAlarm": 1,
                    "consecutiveDatapointsToClear": 1
                }
            },
            "metricValue": {
                "count": 0
            },
            "violationEventType": "in-alarm",
            "violationEventTime": 1560276600.0
        }
    ]
}

Untuk informasi selengkapnya, lihat Mendeteksi Perintah di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanregister-ca-certificate.

AWS CLI

Untuk mendaftarkan sertifikat otoritas sertifikat (CA)

register-ca-certificateContoh berikut mendaftarkan sertifikat CA. Perintah ini menyediakan sertifikat CA dan sertifikat verifikasi kunci yang membuktikan bahwa Anda memiliki kunci pribadi yang terkait dengan sertifikat CA.

aws iot register-ca-certificate \
    --ca-certificate file://rootCA.pem \
    --verification-cert file://verificationCert.pem

Output:

{
    "certificateArn": "arn:aws:iot:us-west-2:123456789012:cacert/f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467",
    "certificateId": "f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467"
 }

Untuk informasi selengkapnya, lihat RegisterCACertificate di Referensi API IoT. AWS

Contoh kode berikut menunjukkan cara menggunakanregister-certificate.

AWS CLI

Untuk mendaftarkan sertifikat perangkat yang ditandatangani sendiri

register-certificateContoh berikut mendaftarkan sertifikat deviceCert.pem perangkat yang ditandatangani oleh sertifikat rootCA.pem CA. Sertifikat CA harus didaftarkan sebelum Anda menggunakannya untuk mendaftarkan sertifikat perangkat yang ditandatangani sendiri. Sertifikat yang ditandatangani sendiri harus ditandatangani oleh sertifikat CA yang sama yang Anda berikan ke perintah ini.

aws iot register-certificate \
    --certificate-pem file://deviceCert.pem \
    --ca-certificate-pem file://rootCA.pem

Output:

{
    "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142",
    "certificateId": "488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142"
 }

Untuk informasi selengkapnya, lihat RegisterCertificate di Refer AWS ensi API IoT.

Contoh kode berikut menunjukkan cara menggunakanregister-thing.

AWS CLI

Untuk mendaftarkan sesuatu

register-thingContoh berikut mendaftarkan sesuatu menggunakan template penyediaan.

aws iot register-thing \
    --template-body '{"Parameters":{"ThingName":{"Type":"String"},"AWS::IoT::Certificate::Id":{"Type":"String"}},"Resources": {"certificate":{"Properties":{"CertificateId":{"Ref":"AWS::IoT::Certificate::Id"},"Status":"Active"},"Type":"AWS::IoT::Certificate"},"policy":{"Properties":{"PolicyName":"MyIotPolicy"},"Type":"AWS::IoT::Policy"},"thing":{"OverrideSettings":{"AttributePayload":"MERGE","ThingGroups":"DO_NOTHING","ThingTypeName":"REPLACE"},"Properties":{"AttributePayload":{},"ThingGroups":[],"ThingName":{"Ref":"ThingName"},"ThingTypeName":"VirtualThings"},"Type":"AWS::IoT::Thing"}}}' \
    --parameters '{"ThingName":"Register-thing-trial-1","AWS::IoT::Certificate::Id":"799a9ea048a1e6aea42b55EXAMPLEf8697b4bafcd77a318a3068e30404b9233c"}'

Output:

{
    "certificatePem": "-----BEGIN CERTIFICATE-----\nMIIDWTCCAkGgAwIBAgIUYLk81I35cIppobpw
HiOJ2jNjboIwDQYJKoZIhvcNAQEL\nBQAwTTFLMEkGA1UECwxCQW1hem9uIFdlYiBTZXJ2aWNlcyBPPUFtYXpvbi
5jb20g\nSW5jLiBMPVNlYXR0bGUgU1Q9V2FzaGluZ3RvbiBDPVVTMB4XDTIwMDcyMzE2NDUw\nOVoXDTQ5MTIzMT
IzNTk1OVowHjEcMBoGA1UEAwwTQVdTIElvVCBDZXJ0aWZpY2F0\nZTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCC
AQoCggEBAO71uADhdBajqTmgrMV5\nmCFfBZQRMo1MdtVoZr2X+M4MzL+RARrtUzH9a2SMAckeX8KeblIOTKzORI
RDXnyE\n6lVOwjgAsd0ku22rFxex4eG2ikha7pYYkvuToqA7L3TxItRvfKrxRI4ZfJoFPip4\nKqiuBJVNOGKTcQ
Hd1RNOrddwwu6kFJLeKDmEXAMPLEdUF0N+qfR9yKnZQkm+g6Q2\nGXu7u0W3hn6nlRN8qVoka0uW12p53xM7oHVz
Gf+cxKBxlbOhGkp6yCfTSkUBm3Sp\n9zLw35kiHXVm4EVpwgNlnk6XcIGIkw8a/iy4pzmvuGAANY1/uU/zgCjymw
ZT5S30\nBV0CAwEAAaNgMF4wHwYDVR0jBBgwFoAUGx0tCcU3q2n1WXAuUCv6hugXjKswHQYD\nVR0OBBYEFOVtvZ
9Aj2RYFnkX7Iu01XTRUdxgMAwGA1UdEwEB/wQCMAAwDgYDVR0P\nAQH/BAQDAgeAMA0GCSqGSIb3DQEBCwUAA4IB
AQCXCQcpOtubS5ftOsDMTcpP/jNX\nDHyArxmjpSc2aCdmm7WX59lTKWyAdxGAvqaDVWqTo0oXI7tZ8w7aINlGi5
pXnifx\n3SBebMUoBbTktrC97yUaeL025mCFv8emDnTR/fE7PTsBKjW0g/rrfpwBxZLXDFwN\nnqkQjy3EDfifj2
6j0xYIqqWMPogyn4srOCKynS5wMJuQZlHQOnabVwnwK4Y0Mflp\np9+4susFUR9aT3BT1AcIwqSpzhlKhh4Iz7ND
kRn4amsUT210jg/zOO1Ow+BTHcVQ\nJly8XDu0CWSu04q6SnaBzHmlySIajxuRTP/AdfRouP1OXe+qlbPOBcvVvF
8o\n-----END CERTIFICATE-----\n",
    "resourceArns": {
        "certificate": "arn:aws:iot:us-west-2:571032923833:cert/799a9ea048a1e6aea42b55EXAMPLEf8697b4bafcd77a318a3068e30404b9233c",
        "thing": "arn:aws:iot:us-west-2:571032923833:thing/Register-thing-trial-1"
    }
}

Untuk informasi selengkapnya, lihat Penyediaan oleh pengguna tepercaya di Panduan Peng AWS embang Inti IoT.

Contoh kode berikut menunjukkan cara menggunakanreject-certificate-transfer.

AWS CLI

Menolak transfer sertifikat

reject-certificate-transferContoh berikut menolak transfer sertifikat perangkat yang ditentukan dari AWS akun lain.

aws iot reject-certificate-transfer \
    --certificate-id f0f33678c7c9a046e5cc87b2b1a58dfa0beec26db78addd5e605d630e05c7fc8

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Men transfer sertifikat ke akun lain di Panduan Pengembang AWS IoT Core.

Contoh kode berikut menunjukkan cara menggunakanremove-thing-from-billing-group.

AWS CLI

Untuk menghapus sesuatu dari grup penagihan

remove-thing-from-billing-groupContoh berikut menghapus hal yang ditentukan dari grup penagihan.

aws iot remove-thing-from-billing-group \
    --billing-group-name GroupOne \
    --thing-name MyOtherLightBulb

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Grup Penagihan di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanremove-thing-from-thing-group.

AWS CLI

Untuk menghapus sesuatu dari grup benda

remove-thing-from-thing-groupContoh berikut menghapus hal yang ditentukan dari grup benda.

aws iot remove-thing-from-thing-group \
    --thing-name bulb7 \
    --thing-group-name DeadBulbs

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Grup Hal < https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html > di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanreplace-topic-rule.

AWS CLI

Untuk memperbarui definisi aturan topik

replace-topic-ruleContoh berikut memperbarui aturan yang ditentukan untuk mengirim peringatan SNS ketika pembacaan tingkat kelembaban tanah terlalu rendah.

aws iot replace-topic-rule \
    --rule-name MyRPiLowMoistureAlertRule \
    --topic-rule-payload "{\"sql\": \"SELECT * FROM '$aws/things/MyRPi/shadow/update/accepted' WHERE state.reported.moisture = 'low'\", \"description\": \"Sends an alert when soil moisture level readings are too low.\",\"actions\": [{\"sns\":{\"targetArn\":\"arn:aws:sns:us-west-2:123456789012:MyRPiLowMoistureTopic\",\"roleArn\":\"arn:aws:iam::123456789012:role/service-role/MyRPiLowMoistureTopicRole\",\"messageFormat\": \"RAW\"}}],\"ruleDisabled\": false,\"awsIotSqlVersion\":\"2016-03-23\"}"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Membuat AWS Aturan IoT di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakansearch-index.

AWS CLI

Untuk menanyakan indeks benda

search-indexContoh berikut menanyakan AWS_Things indeks untuk hal-hal yang memiliki tipeLightBulb.

aws iot search-index \
    --index-name "AWS_Things" \
    --query-string "thingTypeName:LightBulb"

Output:

{
    "things": [
        {
            "thingName": "MyLightBulb",
            "thingId": "40da2e73-c6af-406e-b415-15acae538797",
            "thingTypeName": "LightBulb",
            "thingGroupNames": [
                "LightBulbs",
                "DeadBulbs"
            ],
            "attributes": {
                "model": "123",
                "wattage": "75"
            },
            "connectivity": {
                "connected": false
            }
        },
        {
            "thingName": "ThirdBulb",
            "thingId": "615c8455-33d5-40e8-95fd-3ee8b24490af",
            "thingTypeName": "LightBulb",
            "attributes": {
                "model": "123",
                "wattage": "75"
            },
            "connectivity": {
                "connected": false
            }
        },
        {
            "thingName": "MyOtherLightBulb",
            "thingId": "6dae0d3f-40c1-476a-80c4-1ed24ba6aa11",
            "thingTypeName": "LightBulb",
            "attributes": {
                "model": "123",
                "wattage": "75"
            },
            "connectivity": {
                "connected": false
            }
        }
    ]
}

Untuk informasi selengkapnya, lihat Mengelola Pengindeksan Hal di Panduan Pengembang AWS IoT.

  • Untuk detail API, lihat SearchIndex di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanset-default-authorizer.

AWS CLI

Untuk menyetel otorisasi default

set-default-authorizerContoh berikut menetapkan otorizer kustom bernama CustomAuthorizer sebagai otorizer default.

aws iot set-default-authorizer \
    --authorizer-name CustomAuthorizer

Output:

{
    "authorizerName": "CustomAuthorizer",
    "authorizerArn": "arn:aws:iot:us-west-2:123456789012:authorizer/CustomAuthorizer"
}

Untuk informasi selengkapnya, lihat CreateDefaultAuthorizer di Refer AWS ensi API IoT.

Contoh kode berikut menunjukkan cara menggunakanset-default-policy-version.

AWS CLI

Untuk menyetel versi default untuk kebijakan

set-default-policy-versionContoh berikut menetapkan versi default 2 untuk kebijakan bernamaUpdateDeviceCertPolicy.

aws iot set-default-policy-version \
    --policy-name UpdateDeviceCertPolicy \
    --policy-version-id 2

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakanset-v2-logging-level.

AWS CLI

Untuk mengatur level logging untuk grup benda

set-v2-logging-levelContoh berikut menetapkan tingkat logging untuk peringatan log untuk grup hal yang ditentukan.

aws iot set-v2-logging-level \
    --log-target "{\"targetType\":\"THING_GROUP\",\"targetName\":\"LightBulbs\"}" \
    --log-level WARN

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakanset-v2-logging-options.

AWS CLI

Untuk mengatur opsi pencatatan

set-v2-logging-optionsContoh berikut menetapkan tingkat verbositas logging default ke ERROR dan menentukan ARN yang akan digunakan untuk logging.

aws iot set-v2-logging-options \
    --default-log-level ERROR \
    --role-arn "arn:aws:iam::094249569039:role/service-role/iotLoggingRole"

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakanstart-audit-mitigation-actions-task.

AWS CLI

Untuk menerapkan tindakan mitigasi terhadap temuan dari audit

start-audit-mitigation-actions-taskContoh berikut menerapkan ResetPolicyVersionAction tindakan (yang menghapus kebijakan) ke temuan tunggal yang ditentukan.

aws iot start-audit-mitigation-actions-task \
    --task-id "myActionsTaskId" \
    --target "findingIds=[\"0edbaaec-2fe1-4cf5-abc9-d4c3e51f7464\"]" \
    --audit-check-to-actions-mapping "IOT_POLICY_OVERLY_PERMISSIVE_CHECK=[\"ResetPolicyVersionAction\"]" \
    --client-request-token "adhadhahda"

Output:

{
    "taskId": "myActionsTaskId"
}

Untuk informasi selengkapnya, lihat StartAuditMitigationActionsTask (Perintah Tindakan Miti gasi) di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanstart-on-demand-audit-task.

AWS CLI

Untuk memulai audit segera

start-on-demand-audit-taskContoh berikut memulai audit AWS IoT Device Defender dan melakukan tiga pemeriksaan sertifikat.

aws iot start-on-demand-audit-task \
    --target-check-names CA_CERTIFICATE_EXPIRING_CHECK DEVICE_CERTIFICATE_EXPIRING_CHECK REVOKED_CA_CERTIFICATE_STILL_ACTIVE_CHECK

Output:

{
    "taskId": "a3aea009955e501a31b764abe1bebd3d"
}

Untuk informasi selengkapnya, lihat Perintah Audit di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakantag-resource.

AWS CLI

Untuk menentukan kunci tag dan nilai untuk sumber daya

tag-resourceContoh berikut menerapkan tag dengan kunci Assembly dan nilai Fact1NW ke grup bendaLightBulbs.

aws iot tag-resource \
    --tags Key=Assembly,Value="Fact1NW" \
    --resource-arn "arn:aws:iot:us-west-2:094249569039:thinggroup/LightBulbs"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menandai Sumber AWS Daya IoT Anda di Panduan Pengembang AWS IoT.

  • Untuk detail API, lihat TagResource di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakantest-authorization.

AWS CLI

Untuk menguji kebijakan AWS IoT Anda

test-authorizationContoh berikut menguji kebijakan AWS IoT yang terkait dengan prinsip yang ditentukan.

aws iot test-authorization \
    --auth-infos actionType=CONNECT,resources=arn:aws:iot:us-east-1:123456789012:client/client1 \
    --principal arn:aws:iot:us-west-2:123456789012:cert/aab1068f7f43ac3e3cae4b3a8aa3f308d2a750e6350507962e32c1eb465d9775

Output:

{
    "authResults": [
        {
            "authInfo": {
                "actionType": "CONNECT",
                "resources": [
                    "arn:aws:iot:us-east-1:123456789012:client/client1"
                ]
            },
            "allowed": {
                "policies": [
                    {
                        "policyName": "TestPolicyAllowed",
                        "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/TestPolicyAllowed"
                    }
                ]
            },
            "denied": {
                "implicitDeny": {
                    "policies": [
                        {
                            "policyName": "TestPolicyDenied",
                            "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/TestPolicyDenied"
                        }
                    ]
                },
                "explicitDeny": {
                    "policies": [
                        {
                            "policyName": "TestPolicyExplicitDenied",
                            "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/TestPolicyExplicitDenied"
                        }
                    ]
                }
            },
            "authDecision": "IMPLICIT_DENY",
            "missingContextValues": []
        }
    ]
}

Untuk informasi selengkapnya, lihat TestAuthorization di Refer AWS ensi API IoT.

Contoh kode berikut menunjukkan cara menggunakantest-invoke-authorizer.

AWS CLI

Untuk menguji otorisasi kustom Anda

test-invoke-authorizerContoh berikut Menguji otorisasi kustom Anda.

aws iot test-invoke-authorizer \
    --authorizer-name IoTAuthorizer \
    --token allow \
    --token-signature "mE0GvaHqy9nER/FdgtJX5lXYEJ3b3vE7t1gEszc0TKGgLKWXTnPkb2AbKnOAZ8lGyoN5dVtWDWVmr25m7++zjbYIMk2TBvyGXhOmvKFBPkdgyA43KL6SiZy0cTqlPMcQDsP7VX2rXr7CTowCxSNKphGXdQe0/I5dQ+JO6KUaHwCmupt0/MejKtaNwiia064j6wprOAUwG5S1IYFuRd0X+wfo8pb0DubAIX1Ua705kuhRUcTx4SxUShEYKmN4IDEvLB6FsIr0B2wvB7y4iPmcajxzGl02ExvyCUNctCV9dYlRRGJj0nsGzBIXOI4sGytPfqlA7obdgmN22pkDzYvwjQ=="

Output:

{
    "isAuthenticated": true,
    "principalId": "principalId",
    "policyDocuments": [
        "{"Version":"2012-10-17","Statement":[{"Action":"iot:Publish","Effect":"Allow","Resource":"arn:aws:iot:us-west-2:123456789012:topic/customauthtesting"}]}"
    ],
    "refreshAfterInSeconds": 600,
    "disconnectAfterInSeconds": 3600
}

Untuk informasi selengkapnya, lihat TestInvokeAuthorizer di Refer AWS ensi API IoT.

Contoh kode berikut menunjukkan cara menggunakantransfer-certificate.

AWS CLI

Untuk mentransfer sertifikat perangkat ke AWS akun lain

transfer-certificateContoh berikut mentransfer sertifikat perangkat ke AWS akun lain. Sertifikat dan AWS akun diidentifikasi dengan ID.

aws iot transfer-certificate \
    --certificate-id 488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142 \
    --target-aws-account 030714055129

Output:

{
    "transferredCertificateArn": "arn:aws:iot:us-west-2:030714055129:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142"
}

Untuk informasi selengkapnya, lihat Men transfer sertifikat ke akun lain di Panduan Pengembang AWS IoT Core.

Contoh kode berikut menunjukkan cara menggunakanuntag-resource.

AWS CLI

Untuk menghapus kunci tag dari sumber daya

untag-resourceContoh berikut menghapus tag MyTag dan nilainya dari grup bendaLightBulbs.

command

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menandai Sumber AWS Daya IoT Anda di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanupdate-account-audit-configuration.

AWS CLI

Contoh 1: Untuk mengaktifkan notifikasi Amazon SNS untuk notifikasi audit

update-account-audit-configurationContoh berikut mengaktifkan notifikasi Amazon SNS untuk notifikasi audit AWS IoT Device Defender, menentukan target dan peran yang digunakan untuk menulis ke target tersebut.

aws iot update-account-audit-configuration \
    --audit-notification-target-configurations "SNS={targetArn=\"arn:aws:sns:us-west-2:123456789012:ddaudits\",roleArn=\"arn:aws:iam::123456789012:role/service-role/AWSIoTDeviceDefenderAudit\",enabled=true}"

Perintah ini tidak menghasilkan output.

Contoh 2: Untuk mengaktifkan pemeriksaan audit

update-account-audit-configurationContoh berikut mengaktifkan pemeriksaan audit AWS IoT Device Defender bernamaAUTHENTICATED_COGNITO_ROLE_OVERLY_PERMISSIVE_CHECK. Anda tidak dapat menonaktifkan pemeriksaan audit jika itu adalah bagian dari audit targetCheckNames untuk satu atau lebih audit terjadwal untuk AWS akun.

aws iot update-account-audit-configuration \
    --audit-check-configurations "{\"AUTHENTICATED_COGNITO_ROLE_OVERLY_PERMISSIVE_CHECK\":{\"enabled\":true}}"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Perintah Audit di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanupdate-audit-suppression.

AWS CLI

Untuk memperbarui penekanan temuan audit

update-audit-suppressionContoh berikut memperbarui tanggal kedaluwarsa penindasan temuan audit menjadi 2020-09-21.

aws iot update-audit-suppression \
    --check-name DEVICE_CERTIFICATE_EXPIRING_CHECK \
    --resource-identifier deviceCertificateId=c7691e<shortened> \
    --no-suppress-indefinitely \
    --expiration-date 2020-09-21

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Penekanan pencarian audit di Panduan Peng AWS embang IoT.

Contoh kode berikut menunjukkan cara menggunakanupdate-authorizer.

AWS CLI

Untuk memperbarui otorisasi kustom

update-authorizerContoh berikut dia ny CustomAuthorizer2 atakanINACTIVE.

aws iot update-authorizer \
    --authorizer-name CustomAuthorizer2 \
    --status INACTIVE

Output:

{
    "authorizerName": "CustomAuthorizer2",
    "authorizerArn": "arn:aws:iot:us-west-2:123456789012:authorizer/CustomAuthorizer2"
}

Untuk informasi selengkapnya, lihat UpdateAuthorizer di Refer AWS ensi API IoT.

Contoh kode berikut menunjukkan cara menggunakanupdate-billing-group.

AWS CLI

Untuk memperbarui informasi tentang grup penagihan

update-billing-groupContoh berikut memperbarui deskripsi untuk grup penagihan yang ditentukan.

aws iot update-billing-group \
    --billing-group-name GroupOne \
    --billing-group-properties "billingGroupDescription=\"Primary bulb billing group\""

Output:

{
    "version": 2
}

Untuk informasi selengkapnya, lihat Grup Penagihan di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanupdate-ca-certificate.

AWS CLI

Untuk memperbarui sertifikat otoritas sertifikat (CA)

update-ca-certificateContoh berikut menetapkan sertifikat CA yang ditentukan ke status AKTIF.

aws iot update-ca-certificate \
    --certificate-id f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467 \
    --new-status ACTIVE

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat UpdateCacertificate di Referensi API IoT. AWS

Contoh kode berikut menunjukkan cara menggunakanupdate-certificate.

AWS CLI

Untuk memperbarui sertifikat perangkat

update-certificateContoh berikut menetapkan sertifikat perangkat yang ditentukan ke status TIDAK AKTIF.

aws iot update-certificate \
    --certificate-id d1eb269fb55a628552143c8f96eb3c258fcd5331ea113e766ba0c82bf225f0be \
    --new-status INACTIVE

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat UpdateCertificate di Refer AWS ensi API IoT.

Contoh kode berikut menunjukkan cara menggunakanupdate-custom-metric.

AWS CLI

Untuk memperbarui metrik khusus

update-custom-metricContoh berikut memperbarui metrik kustom untuk memiliki yang barudisplay-name.

aws iot update-custom-metric \
    --metric-name batteryPercentage \
    --display-name 'remaining battery percentage on device' \
    --region us-east-1

Output:

{
    "metricName": "batteryPercentage",
    "metricArn": "arn:aws:iot:us-east-1:1234564789012:custommetric/batteryPercentage",
    "metricType": "number",
    "displayName": "remaining battery percentage on device",
    "creationDate": "2020-11-17T23:01:35.110000-08:00",
    "lastModifiedDate": "2020-11-17T23:02:12.879000-08:00"
}

Untuk informasi selengkapnya, lihat Metrik khusus di Panduan Pengembang Inti AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanupdate-dimension.

AWS CLI

Untuk memperbarui dimensi

update-dimensionContoh berikut memperbarui dimensi.

aws iot update-dimension \
    --name TopicFilterForAuthMessages \
    --string-values device/${iot:ClientId}/auth

Output:

{
    "name": "TopicFilterForAuthMessages",
    "lastModifiedDate": 1585866222.317,
    "stringValues": [
        "device/${iot:ClientId}/auth"
    ],
    "creationDate": 1585854500.474,
    "type": "TOPIC_FILTER",
    "arn": "arn:aws:iot:us-west-2:1234564789012:dimension/TopicFilterForAuthMessages"
}

Untuk informasi selengkapnya, lihat Mencakup metrik dalam profil keamanan menggunakan dimensi di Panduan Pengembang Inti AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanupdate-domain-configuration.

AWS CLI

Untuk memperbarui konfigurasi domain

update-domain-configurationContoh berikut menonaktifkan konfigurasi domain yang ditentukan.

aws iot update-domain-configuration \
    --domain-configuration-name "additionalDataDomain" \
    --domain-configuration-status "DISABLED"

Output:

{
    "domainConfigurationName": "additionalDataDomain",
    "domainConfigurationArn": "arn:aws:iot:us-west-2:123456789012:domainconfiguration/additionalDataDomain/dikMh"
}

Untuk informasi selengkapnya, lihat T itik Akhir yang Dapat Dikonfigurasi di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanupdate-dynamic-thing-group.

AWS CLI

Untuk memperbarui grup benda dinamis

update-dynamic-thing-groupContoh berikut memperbarui grup benda dinamis yang ditentukan. Ini memberikan deskripsi dan memperbarui string kueri untuk mengubah kriteria keanggotaan grup.

aws iot update-dynamic-thing-group \
    --thing-group-name "RoomTooWarm"
    --thing-group-properties "thingGroupDescription=\"This thing group contains rooms warmer than 65F.\"" \
    --query-string "attributes.temperature>65"

Output:

{
    "version": 2
}

Untuk informasi selengkapnya, lihat Grup Hal Din amis di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanupdate-event-configurations.

AWS CLI

Untuk menunjukkan jenis acara yang dipublikasikan

update-event-configurationsContoh berikut memperbarui konfigurasi untuk mengaktifkan pesan saat sertifikat CA ditambahkan, diperbarui, atau dihapus.

aws iot update-event-configurations \
    --event-configurations "{\"CA_CERTIFICATE\":{\"Enabled\":true}}"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Pesan A cara di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanupdate-indexing-configuration.

AWS CLI

Untuk mengaktifkan pengindeksan benda

update-indexing-configurationContoh berikut memungkinkan pengindeksan benda untuk mendukung pencarian data registri, data bayangan, dan status konektivitas benda menggunakan indeks AWS_Things.

aws iot update-indexing-configuration
    --thing-indexing-configuration thingIndexingMode=REGISTRY_AND_SHADOW,thingConnectivityIndexingMode=STATUS

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mengelola Pengindeksan Hal di Panduan AWS Pengembang IoT.

Contoh kode berikut menunjukkan cara menggunakanupdate-job.

AWS CLI

Untuk mendapatkan status rinci untuk pekerjaan

update-jobContoh berikut mendapatkan status rinci untuk pekerjaan yang ID-nyaexample-job-01.

aws iot describe-job \
    --job-id "example-job-01"

Output:

{
    "job": {
        "jobArn": "arn:aws:iot:us-west-2:123456789012:job/example-job-01",
        "jobId": "example-job-01",
        "targetSelection": "SNAPSHOT",
        "status": "IN_PROGRESS",
        "targets": [
            "arn:aws:iot:us-west-2:123456789012:thing/MyRaspberryPi"
        ],
        "description": "example job test",
        "presignedUrlConfig": {},
        "jobExecutionsRolloutConfig": {},
        "createdAt": 1560787022.733,
        "lastUpdatedAt": 1560787026.294,
        "jobProcessDetails": {
            "numberOfCanceledThings": 0,
            "numberOfSucceededThings": 0,
            "numberOfFailedThings": 0,
            "numberOfRejectedThings": 0,
            "numberOfQueuedThings": 1,
            "numberOfInProgressThings": 0,
            "numberOfRemovedThings": 0,
            "numberOfTimedOutThings": 0
        },
        "timeoutConfig": {}
    }
}

Untuk informasi selengkapnya, lihat Membuat dan Mengelola Pekerjaan (CLI) di Panduan Pengembang AWS IoT.

  • Untuk detail API, lihat UpdateJob di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanupdate-mitigation-action.

AWS CLI

Untuk memperbarui tindakan mitigasi

update-mitigation-actionContoh berikut memperbarui tindakan mitigasi yang ditentukan bernamaAddThingsToQuarantineGroupAction, mengubah nama grup benda, dan menyetel overrideDynamicGroups kefalse. Anda dapat memverifikasi perubahan Anda dengan menggunakan describe-mitigation-action perintah.

aws iot update-mitigation-action \
    --cli-input-json "{ \"actionName\": \"AddThingsToQuarantineGroupAction\", \"actionParams\": { \"addThingsToThingGroupParams\": {\"thingGroupNames\":[\"QuarantineGroup2\"],\"overrideDynamicGroups\": false}}}"

Output:

{
    "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/AddThingsToQuarantineGroupAction",
    "actionId": "2fd2726d-98e1-4abf-b10f-09465ccd6bfa"
}

Untuk informasi selengkapnya, lihat UpdateMitigationAction (Perintah Tindakan Miti gasi) di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanupdate-provisioning-template.

AWS CLI

Untuk memperbarui templat penyediaan

update-provisioning-templateContoh berikut memodifikasi deskripsi dan peran arn untuk template penyediaan yang ditentukan dan mengaktifkan template.

aws iot update-provisioning-template \
    --template-name widget-template \
    --enabled \
    --description "An updated provisioning template for widgets" \
    --provisioning-role-arn arn:aws:iam::504350838278:role/Provision_role

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat AWS IoT Secure Tunneling di Panduan Pengembang AWS IoT Core.

Contoh kode berikut menunjukkan cara menggunakanupdate-role-alias.

AWS CLI

Untuk memperbarui alias peran

update-role-aliasContoh berikut memperbarui alias LightBulbRole peran.

aws iot update-role-alias \
    --role-alias LightBulbRole \
    --role-arn arn:aws:iam::123456789012:role/lightbulbrole-001

Output:

{
    "roleAlias": "LightBulbRole",
    "roleAliasArn": "arn:aws:iot:us-west-2:123456789012:rolealias/LightBulbRole"
}

Untuk informasi selengkapnya, lihat UpdateRoleAlias di Refer AWS ensi API IoT.

Contoh kode berikut menunjukkan cara menggunakanupdate-scheduled-audit.

AWS CLI

Untuk memperbarui definisi audit terjadwal

update-scheduled-auditContoh berikut mengubah nama pemeriksaan target untuk audit terjadwal AWS IoT Device Defender.

aws iot update-scheduled-audit \
    --scheduled-audit-name WednesdayCertCheck \
    --target-check-names CA_CERTIFICATE_EXPIRING_CHECK DEVICE_CERTIFICATE_EXPIRING_CHECK REVOKED_CA_CERTIFICATE_STILL_ACTIVE_CHECK

Output:

{
    "scheduledAuditArn": "arn:aws:iot:us-west-2:123456789012:scheduledaudit/WednesdayCertCheck"
}

Untuk informasi selengkapnya, lihat Perintah Audit di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanupdate-security-profile.

AWS CLI

Untuk mengubah profil keamanan

update-security-profileContoh berikut memperbarui deskripsi dan perilaku untuk profil keamanan AWS IoT Device Defender.

aws iot update-security-profile \
    --security-profile-name PossibleIssue \
    --security-profile-description "Check to see if authorization fails 12 times in 5 minutes or if cellular bandwidth exceeds 128"  \
    --behaviors "[{\"name\":\"CellularBandwidth\",\"metric\":\"aws:message-byte-size\",\"criteria\":{\"comparisonOperator\":\"greater-than\",\"value\":{\"count\":128},\"consecutiveDatapointsToAlarm\":1,\"consecutiveDatapointsToClear\":1}},{\"name\":\"Authorization\",\"metric\":\"aws:num-authorization-failures\",\"criteria\":{\"comparisonOperator\":\"less-than\",\"value\":{\"count\":12},\"durationSeconds\":300,\"consecutiveDatapointsToAlarm\":1,\"consecutiveDatapointsToClear\":1}}]"

Output:

{
    "securityProfileName": "PossibleIssue",
    "securityProfileArn": "arn:aws:iot:us-west-2:123456789012:securityprofile/PossibleIssue",
    "securityProfileDescription": "check to see if authorization fails 12 times in 5 minutes or if cellular bandwidth exceeds 128",
    "behaviors": [
        {
            "name": "CellularBandwidth",
            "metric": "aws:message-byte-size",
            "criteria": {
                "comparisonOperator": "greater-than",
                "value": {
                    "count": 128
                },
                "consecutiveDatapointsToAlarm": 1,
                "consecutiveDatapointsToClear": 1
            }
        },
        {
            "name": "Authorization",
            "metric": "aws:num-authorization-failures",
            "criteria": {
                "comparisonOperator": "less-than",
                "value": {
                    "count": 12
                },
                "durationSeconds": 300,
                "consecutiveDatapointsToAlarm": 1,
                "consecutiveDatapointsToClear": 1
            }
        }
    ],
    "version": 2,
    "creationDate": 1560278102.528,
    "lastModifiedDate": 1560352711.207
}

Untuk informasi selengkapnya, lihat Mendeteksi Perintah di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanupdate-stream.

AWS CLI

Untuk memperbarui aliran

update-streamContoh berikut memperbarui aliran yang ada. Versi streaming bertambah satu.

aws iot update-stream \
    --cli-input-json file://update-stream.json

Isi dari update-stream.json:

{
    "streamId": "stream12345",
    "description": "This stream is used for Amazon FreeRTOS OTA Update 12345.",
    "files": [
        {
            "fileId": 123,
            "s3Location": {
                "bucket":"codesign-ota-bucket",
                "key":"48c67f3c-63bb-4f92-a98a-4ee0fbc2bef6"
            }
        }
    ]
    "roleArn": "arn:aws:iam:us-west-2:123456789012:role/service-role/my_ota_stream_role"
}

Output:

{
    "streamId": "stream12345",
    "streamArn": "arn:aws:iot:us-west-2:123456789012:stream/stream12345",
    "description": "This stream is used for Amazon FreeRTOS OTA Update 12345.",
    "streamVersion": 2
}

Untuk informasi selengkapnya, lihat UpdateStream di Refer AWS ensi API IoT.

  • Untuk detail API, lihat UpdateStream di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanupdate-thing-group.

AWS CLI

Untuk memperbarui definisi untuk grup benda

update-thing-groupContoh berikut memperbarui definisi untuk grup hal yang ditentukan, mengubah deskripsi dan dua atribut.

aws iot update-thing-group \
    --thing-group-name HalogenBulbs \
    --thing-group-properties "thingGroupDescription=\"Halogen bulb group\", attributePayload={attributes={Manufacturer=AnyCompany,wattage=60}}"

Output:

{
    "version": 2
}

Untuk informasi selengkapnya, lihat Grup Hal di Panduan AWS Pengembang IoT.

Contoh kode berikut menunjukkan cara menggunakanupdate-thing-groups-for-thing.

AWS CLI

Untuk mengubah kelompok yang menjadi milik suatu benda

update-thing-groups-for-thingContoh berikut menghapus hal yang diberi nama MyLightBulb dari grup bernama DeadBulbs dan menambahkannya ke grup bernama replaceableItems pada saat yang sama.

aws iot update-thing-groups-for-thing \
    --thing-name MyLightBulb \
    --thing-groups-to-add "replaceableItems" \
    --thing-groups-to-remove "DeadBulbs"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Grup Hal di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanupdate-thing.

AWS CLI

Untuk mengasosiasikan sesuatu dengan tipe benda

update-thingContoh berikut mengaitkan sesuatu dalam registri AWS IoT dengan tipe benda. Ketika Anda membuat asosiasi, Anda memberikan nilai untuk atribut yang ditentukan oleh jenis benda.

aws iot update-thing \
    --thing-name "MyOtherLightBulb" \
    --thing-type-name "LightBulb" \
    --attribute-payload "{"attributes": {"wattage":"75", "model":"123"}}"

Perintah ini tidak menghasilkan output. Gunakan describe-thing perintah untuk melihat hasilnya.

Untuk informasi selengkapnya, lihat Jenis Hal di Panduan AWS Pengembang IoT.

  • Untuk detail API, lihat UpdateThing di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanupdate-topic-rule-destination.

AWS CLI

Contoh 1: Untuk mengaktifkan tujuan aturan topik

update-topic-rule-destinationContoh berikut memungkinkan lalu lintas ke tujuan aturan topik.

aws iot update-topic-rule-destination \
    --arn "arn:aws:iot:us-west-2:123456789012:ruledestination/http/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" \
    --status ENABLED

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Meng aktifkan tujuan aturan topik di Panduan Pengembang AWS IoT.

Contoh 2: Untuk menonaktifkan tujuan aturan topik

update-topic-rule-destinationContoh berikut menonaktifkan lalu lintas ke tujuan aturan topik.

aws iot update-topic-rule-destination \
    --arn "arn:aws:iot:us-west-2:123456789012:ruledestination/http/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" \
    --status DISABLED

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menon aktifkan tujuan aturan topik di Panduan Pengembang AWS IoT.

Contoh 3: Untuk mengirim pesan konfirmasi baru

update-topic-rule-destinationContoh berikut mengirimkan pesan konfirmasi baru untuk tujuan aturan topik.

aws iot update-topic-rule-destination \
    --arn "arn:aws:iot:us-west-2:123456789012:ruledestination/http/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" \
    --status IN_PROGRESS

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mengi rim pesan konfirmasi baru di Panduan Pengembang AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanvalidate-security-profile-behaviors.

AWS CLI

Contoh 1: Untuk memvalidasi parameter perilaku untuk profil keamanan

validate-security-profile-behaviorsContoh berikut memvalidasi serangkaian perilaku yang terbentuk dengan baik dan benar untuk profil keamanan AWS IoT Device Defender.

aws iot validate-security-profile-behaviors \
    --behaviors "[{\"name\":\"CellularBandwidth\",\"metric\":\"aws:message-byte-size\",\"criteria\":{\"comparisonOperator\":\"greater-than\",\"value\":{\"count\":128},\"consecutiveDatapointsToAlarm\":1,\"consecutiveDatapointsToClear\":1}},{\"name\":\"Authorization\",\"metric\":\"aws:num-authorization-failures\",\"criteria\":{\"comparisonOperator\":\"greater-than\",\"value\":{\"count\":12},\"durationSeconds\":300,\"consecutiveDatapointsToAlarm\":1,\"consecutiveDatapointsToClear\":1}}]"

Output:

{
    "valid": true,
    "validationErrors": []
}

Contoh 2: Untuk memvalidasi parameter perilaku yang salah untuk profil keamanan

validate-security-profile-behaviorsContoh berikut memvalidasi serangkaian perilaku yang berisi kesalahan untuk profil keamanan AWS IoT Device Defender.

aws iot validate-security-profile-behaviors \
    --behaviors "[{\"name\":\"CellularBandwidth\",\"metric\":\"aws:message-byte-size\",\"criteria\":{\"comparisonOperator\":\"greater-than\",\"value\":{\"count\":128},\"consecutiveDatapointsToAlarm\":1,\"consecutiveDatapointsToClear\":1}},{\"name\":\"Authorization\",\"metric\":\"aws:num-authorization-failures\",\"criteria\":{\"comparisonOperator\":\"greater-than\",\"value\":{\"count\":12},\"durationSeconds\":300,\"consecutiveDatapointsToAlarm\":100000,\"consecutiveDatapointsToClear\":1}}]"

Output:

{
    "valid": false,
    "validationErrors": [
        {
            "errorMessage": "Behavior Authorization is malformed. consecutiveDatapointsToAlarm 100000 should be in range[1,10]"
        }
    ]
}

Untuk informasi selengkapnya, lihat Mendeteksi Perintah di Panduan Pengembang AWS IoT.