AWS IoT contoh menggunakan 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 Mentransfer sertifikat ke akun lain di Panduan Pengembang Inti AWS IoT.

Contoh 1: Untuk menambahkan sesuatu dengan nama ke grup penagihan

add-thing-to-billing-groupContoh berikut menambahkan hal bernama 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 oleh 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 AWS beberapa Wilayah 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.

Untuk menambahkan sesuatu ke grup

add-thing-to-thing-groupContoh berikut menambahkan hal yang ditentukan ke kelompok 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 Thing Groups di Panduan Pengembang AWS IoT.

Untuk mengasosiasikan kelompok sesuatu dengan pekerjaan berkelanjutan

associate-targets-with-jobContoh berikut mengaitkan kelompok hal yang ditentukan dengan pekerjaan berkelanjutan 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 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 Thing Groups di Panduan Pengembang AWS IoT.

Contoh 2: Untuk melampirkan kebijakan ke sertifikat

attach-policyContoh berikut melampirkan kebijakan UpdateDeviceCertPolicy ke kepala sekolah 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 Melampirkan Kebijakan AWS IoT ke Sertifikat Perangkat di Panduan Pengembang AWS IoT.

Untuk mengaitkan profil keamanan dengan semua perangkat yang tidak terdaftar

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

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.

Untuk melampirkan sertifikat ke barang Anda

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

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 Sesuatu dengan Registri di Panduan Pengembang AWS IoT.

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 Mitigasi) di Panduan Pengembang AWS IoT.

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.

Untuk membatalkan transfer sertifikat ke AWS akun yang berbeda

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 Mentransfer sertifikat ke akun lain di Panduan Pengembang Inti AWS IoT.

Untuk membatalkan eksekusi pekerjaan di perangkat

cancel-job-executionContoh berikut membatalkan eksekusi pekerjaan yang ditentukan pada perangkat. Jika pekerjaan tidak dalam QUEUED keadaan, 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.

Untuk membatalkan pekerjaan

cancel-jobContoh berikut membatalkan pekerjaan yang ditentukan.

aws iot cancel-job \
    --job-job "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 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 dengan nama di header permintaan HTTP.

aws iot clear-default-authorizer

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat ClearDefaultAuthorizerdi Referensi API AWS IoT.

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.

Untuk membuat penindasan temuan audit

create-audit-suppressionContoh berikut membuat penindasan temuan audit untuk kebijakan bernama "virtualMachinePolicy" 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 Audit menemukan penekanan di Panduan Pengembang AWS IoT.

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 CreateAuthorizerdi Referensi API AWS IoT.

Untuk 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.

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 Referensi AWS API IoT.

Untuk membuat metrik kustom 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.

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.

Untuk membuat konfigurasi domain

create-domain-configurationContoh berikut membuat konfigurasi domain AWS-managed 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 Titik Akhir yang Dapat Dikonfigurasi di Panduan Pengembang AWS IoT.

Untuk membuat grup hal yang 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 Dynamic Thing Groups di AWS Panduan Pengembang IoT.

Contoh 1: Untuk membuat pekerjaan

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

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 menciptakan 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" --targets “arn:aws:iot:us-west- 2:123456789012: -job.json --description “contoh pekerjaan berkelanjutan” --target-selection CONTINUOUS thinggroup/DeadBulbs" --document file://example

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 membuat key pair RSA dan mengeluarkan sertifikat X.509

Berikut ini create-keys-and-certificate membuat key pair RSA 2048-bit dan mengeluarkan sertifikat X.509 menggunakan kunci publik yang diterbitkan. 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 Mendaftarkan Sertifikat Perangkat AWS IoT di Panduan Pengembang AWS IoT.

Untuk membuat tindakan mitigasi

create-mitigation-actionContoh berikut mendefinisikan tindakan mitigasi bernama AddThingsToQuarantineGroup1Action bahwa, ketika diterapkan, memindahkan hal-hal ke dalam kelompok hal bernama. QuarantineGroup1 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 Mitigasi) di Panduan Pengembang AWS IoT.

Untuk membuat pembaruan OTA untuk digunakan dengan Amazon FreeRTOS

create-ota-updateContoh berikut membuat AWS IoT OTAUpdate pada kelompok target hal atau kelompok. Ini adalah bagian dari pembaruan Amazon over-the-air FreeRTOS yang memungkinkan Anda untuk menyebarkan 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 Membuat OTAUpdate di Referensi API AWS IoT.

Untuk memperbarui kebijakan dengan versi baru

create-policy-versionContoh berikut memperbarui definisi kebijakan, membuat versi kebijakan baru. Contoh ini juga menjadikan versi baru sebagai 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 Pengembang AWS IoT.

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 Pengembang AWS IoT.

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 Pengembang Inti AWS IoT.

Untuk membuat versi template 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 IoT Core Developer AWS Guide.

Untuk membuat template penyediaan

create-provisioning-templateContoh berikut membuat template provisioning seperti yang didefinisikan oleh file. template.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 IoT Core Developer AWS Guide.

Untuk membuat alias peran

create-role-aliasContoh berikut menciptakan alias peran yang dipanggil LightBulbRole untuk peran tertentu.

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 CreateRoleAliasdi Referensi API AWS IoT.

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.

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.

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 CreateStreamdi Referensi API AWS IoT.

Contoh 1: Untuk membuat grup benda

create-thing-groupContoh berikut membuat grup hal 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 hal bernama HalogenBulbs yang memiliki kelompok hal induk bernamaLightBulbs.

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 Thing Groups di Panduan Pengembang AWS IoT.

Untuk mendefinisikan tipe benda

create-thing-typeContoh berikut mendefinisikan tipe 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 Tipe Hal di Panduan Pengembang AWS IoT.

Contoh 1: Untuk membuat catatan sesuatu di registri

create-thingContoh berikut membuat entri untuk perangkat di registri hal 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 jenis hal 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 Sesuatu dengan Registri dan Jenis Hal di Panduan Pengembang AWS IoT.

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.

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 ini memerlukan 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 Aturan AWS IoT di Panduan Pengembang AWS IoT.

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.

Untuk menghapus penindasan temuan audit

delete-audit-suppressionContoh berikut menghapus penekanan pencarian 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 Audit menemukan penekanan di Panduan Pengembang AWS IoT.

Untuk menghapus otorisasi kustom

delete-authorizerContoh berikut menghapus authorizer bernama. CustomAuthorizer Authorizer khusus harus dalam INACTIVE status sebelum Anda dapat menghapusnya.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat DeleteAuthorizerdi Panduan Pengembang AWS IoT.

Untuk menghapus grup penagihan

delete-billing-groupContoh berikut menghapus grup penagihan yang ditentukan. Anda dapat menghapus grup penagihan meskipun berisi satu atau beberapa 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.

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 Menghapus CACertificate di Referensi API AWS IoT.

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 DeleteCertificatedi Referensi API AWS IoT.

Untuk menghapus metrik kustom

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 Inti AWS IoT.

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.

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 Titik Akhir yang Dapat Dikonfigurasi di Panduan Pengembang AWS IoT.

Untuk menghapus grup hal dinamis

delete-dynamic-thing-groupContoh berikut menghapus kelompok hal dinamis yang ditentukan.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Dynamic Thing Groups di AWS Panduan Pengembang IoT.

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.

Untuk menghapus pekerjaan

delete-jobContoh berikut menghapus pekerjaan yang ditentukan. Dengan menentukan --force opsi, pekerjaan dihapus bahkan jika statusnyaIN_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 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 Mitigasi) di Panduan Pengembang AWS IoT.

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 Menghapus OTAUpdate di Referensi API AWS IoT.

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.

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 Pengembang AWS IoT.

Untuk menghapus versi template 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 IoT Core Developer AWS Guide.

Untuk menghapus template 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 IoT Core Developer AWS Guide.

Untuk menghapus cod pendaftaran Anda

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

aws iot delete-registration-code

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menggunakan Sertifikat Anda Sendiri di Panduan Pengembang AWS IoT.

Untuk menghapus AWS alias peran IoT

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

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.

Untuk menghapus audit terjadwal

delete-scheduled-auditContoh berikut menghapus audit terjadwal AWS IoT Device Defender yang diberi nama. AWSIoTDeviceDefenderDailyAudit

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.

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.

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 DeleteStreamdi Referensi API AWS IoT.

Untuk menghapus grup benda

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

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Thing Groups di Panduan Pengembang AWS IoT.

Contoh 1: Untuk menghapus tipe benda

delete-thing-typeContoh berikut menghapus jenis hal usang.

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

Perintah ini tidak menghasilkan output.

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

Untuk menampilkan informasi rinci tentang suatu hal

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

aws iot delete-thing --thing-name "” FourthBulb

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Cara Mengelola Sesuatu dengan Registri di Panduan Pengembang AWS IoT.

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.

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.

Untuk menghapus level logging untuk grup sesuatu

delete-v2-logging-levelContoh berikut menghapus tingkat logging untuk kelompok hal yang ditentukan.

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

Perintah ini tidak menghasilkan output.

Contoh 1: Untuk menghentikan tipe benda

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

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

Perintah ini tidak menghasilkan output.

Contoh 2: Untuk membalikkan penghentian tipe benda

deprecate-thing-typeContoh berikut membalikkan penghentian tipe 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 Tipe Hal di Panduan Pengembang AWS IoT.

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.

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 banyak 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.

Untuk menunjukkan rincian tugas tindakan mitigasi audit

describe-audit-mitigation-actions-taskContoh berikut menunjukkan rincian untuk tugas yang ditentukan, di ResetPolicyVersionAction mana diterapkan untuk temuan. Hasilnya meliputi 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 Mitigasi) di Panduan Pengembang AWS IoT.

Untuk mendapatkan detail tentang penindasan temuan audit

describe-audit-suppressionContoh berikut mencantumkan rincian 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 Audit menemukan penekanan di Panduan Pengembang AWS IoT.

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 menjalankan 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.

Untuk mendapatkan informasi tentang otorisasi khusus

describe-authorizerContoh berikut menampilkan rincian untuk authorizer 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 DescribeAuthorizerdi Referensi API AWS IoT.

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.

Untuk mendapatkan detail tentang sertifikat CA

describe-ca-certificateContoh berikut menampilkan rincian 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 Menjelaskan CACertificate di Referensi API AWS IoT.

Untuk mendapatkan informasi tentang sertifikat

describe-certificateContoh berikut menampilkan rincian 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 DescribeCertificatedi Referensi API AWS IoT.

Untuk mendapatkan informasi tentang metrik kustom Device Defender

describe-custom-metricContoh berikut mendapatkan informasi tentang metrik kustom 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.

Untuk mendapatkan informasi tentang otorisasi kustom default

describe-default-authorizerContoh berikut menampilkan rincian untuk authorizer kustom default.

aws iot describe-default-authorizer

Output:

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

Untuk informasi selengkapnya, lihat DescribeDefaultAuthorizerdi Referensi API AWS IoT.

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.

Untuk mendeskripsikan konfigurasi domain

describe-domain-configurationContoh berikut menampilkan rincian tentang konfigurasi domain tertentu.

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 Titik Akhir yang Dapat Dikonfigurasi di Panduan Pengembang AWS IoT.

Contoh 1: Untuk mendapatkan titik AWS akhir Anda saat ini

describe-endpointContoh berikut mengambil AWS endpoint default yang semua perintah diterapkan.

aws iot describe-endpoint

Output:

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

Untuk informasi selengkapnya, lihat DescribeEndpointdi Panduan Pengembang AWS IoT.

Contoh 2: Untuk mendapatkan titik akhir ATS

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 Sertifikat X.509 dan IoT di Panduan Pengembang AWSAWS IoT.

Untuk menunjukkan jenis acara mana yang diterbitkan

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 Acara di Panduan Pengembang AWS IoT.

Untuk mengambil status saat ini dari indeks benda

describe-indexContoh berikut mengambil status saat ini dari indeks hal.

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.

Untuk mendapatkan detail eksekusi untuk pekerjaan di perangkat

describe-job-executionContoh berikut mendapatkan rincian 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.

Untuk mendapatkan status terperinci untuk suatu 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 melihat detail untuk tindakan mitigasi yang ditentukan

describe-mitigation-actionContoh berikut menampilkan rincian untuk tindakan mitigasi tertentu.

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 Mitigasi) di Panduan Pengembang AWS IoT.

Untuk mendeskripsikan 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 Menyediakan perangkat yang tidak memiliki sertifikat perangkat menggunakan penyediaan armada di Panduan Pengembang Inti IoT AWS .

Untuk mendeskripsikan template 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 Menyediakan perangkat yang tidak memiliki sertifikat perangkat menggunakan penyediaan armada di Panduan Pengembang Inti IoT AWS .

Untuk mendapatkan informasi tentang AWS alias peran IoT

describe-role-aliasContoh berikut menampilkan rincian untuk alias peran tertentu.

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 DescribeRoleAliasdi Referensi API AWS IoT.

Untuk mendapatkan informasi tentang audit terjadwal

describe-scheduled-auditContoh berikut mendapatkan informasi rinci tentang audit terjadwal AWS IOT Device Defender bernama. AWSIoTDeviceDefenderDailyAudit

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.

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.

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 DescribeStreamdi Referensi API AWS IoT.

Untuk mendapatkan informasi tentang grup sesuatu

describe-thing-groupContoh berikut mendapat informasi tentang kelompok hal 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 Thing Groups di Panduan Pengembang AWS IoT.

Untuk mendapatkan informasi tentang tipe benda

describe-thing-typeContoh berikut menampilkan informasi tentang jenis hal yang ditentukan ditentukan dalam 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 Tipe Hal di Panduan Pengembang AWS IoT.

Untuk menampilkan informasi rinci tentang suatu hal

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

aws iot mendeskripsikan-hal --thing-name "” 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 Sesuatu dengan Registri di Panduan Pengembang AWS IoT.

Contoh 1: Untuk melepaskan kebijakan AWS IoT dari grup benda

detach-policyContoh berikut melepaskan kebijakan yang ditentukan dari grup benda dan, dengan ekstensi, dari semua hal dalam grup itu dan salah satu grup anak 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 Thing Groups di Panduan Pengembang AWS 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 memisahkan profil keamanan dari target

detach-security-profileContoh berikut menghapus hubungan antara Testprofile profil keamanan AWS IoT Device Defender yang bernama dan target semua hal yang 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.

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 Sesuatu dengan Registri di Panduan Pengembang AWS IoT.

Untuk 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.

Untuk mengaktifkan aturan topik

enable-topic-ruleContoh berikut memungkinkan (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.

Untuk mencantumkan status model pelatihan Profil Keamanan Deteksi MM Device Defender

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

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 (Mendeteksi Perintah) di Panduan Pengembang AWS IoT.

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 output dari 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 yang 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 Menanyakan Data Agregate< https://docs.aws.amazon.com/iot/ latest/developerguide/index -aggregate.html> di Panduan Pengembang IoT.AWS

Untuk membuat daftar kebijakan yang mempengaruhi sesuatu

get-effective-policiesContoh berikut mencantumkan kebijakan yang mempengaruhi hal yang ditentukan, termasuk kebijakan yang dilampirkan pada grup mana pun yang menjadi miliknya.

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 Sesuatu di Panduan Pengembang AWS IoT.

Untuk mendapatkan konfigurasi pengindeksan hal

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 Pengembang AWS IoT.

Untuk mengambil dokumen untuk pekerjaan

get-job-documentContoh berikut menampilkan rincian tentang dokumen untuk pekerjaan yang ID adalahexample-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.

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.

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 OTAUpdateMasuk ke Referensi API AWS IoT.

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 output dari 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 Menanyakan Data Agregat di Panduan Pengembang AWS IoT.

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 Pengembang AWS IoT.

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 Pengembang AWS IoT.

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 Anda Sendiri di Panduan Pengembang AWS IoT.

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.

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 Bekerja dengan tujuan aturan topik di Panduan Pengembang AWS IoT.

Untuk mendapatkan informasi tentang aturan

get-topic-ruleContoh berikut mendapat 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 membuat daftar opsi pencatatan 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.

Untuk 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 1: Untuk mencantumkan 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 Thing Groups di Panduan Pengembang AWS IoT.

Contoh 2: Untuk mencantumkan kebijakan yang dilampirkan pada sertifikat perangkat

list-attached-policiesContoh berikut mencantumkan kebijakan AWS IoT yang dilampirkan pada 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 Thing Groups di Panduan Pengembang AWS IoT.

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 yang ditentukan.

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 berlangsung antara 5 Juni 2019 dan 19 Juni 2019 di mana perangkat berbagi sertifikat perangkat. Ketika Anda menentukan nama cek, Anda harus memberikan waktu mulai dan berakhir.

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.

Untuk membuat daftar rincian pelaksanaan tindakan mitigasi audit

Tugas tindakan mitigasi audit menerapkan tindakan mitigasi untuk satu atau beberapa temuan dari audit IoT Device AWS Defender. list-audit-mitigation-actions-executionsContoh berikut mencantumkan rincian 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 Mitigasi) di Panduan Pengembang AWS IoT.

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 Mitigasi) di Panduan Pengembang AWS IoT.

Untuk membuat daftar semua penekanan temuan audit

list-audit-suppressionsContoh berikut mencantumkan semua penekanan pencarian 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 Audit menemukan penekanan di Panduan Pengembang AWS IoT.

Untuk membuat daftar semua temuan dari audit

list-audit-tasksContoh berikut mencantumkan tugas audit yang berlangsung 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.

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 ListAuthorizersdi Referensi API AWS IoT.

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 AWS Wilayah 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.

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 Anda Sendiri di Panduan Pengembang AWS IoT.

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 Referensi API AWS IoT.

Contoh 1: Untuk mencantumkan 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 memasoknya ke perintah berikutnya untuk mendapatkan batch 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
        }
    ]
}

Untuk mencantumkan 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.

Untuk membuat daftar dimensi untuk AWS akun Anda

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

aws iot list-dimensions

Output:

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

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

Untuk membuat daftar 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 Titik Akhir yang Dapat Dikonfigurasi di Panduan Pengembang AWS IoT.

Untuk mencantumkan indeks pencarian yang dikonfigurasi

list-indicesContoh berikut mencantumkan semua indeks pencarian yang dikonfigurasi di AWS akun Anda. Jika Anda belum mengaktifkan pengindeksan hal, 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 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.

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.

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 mencantumkan 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 tercantum.

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 Mitigasi) di Panduan Pengembang AWS IoT.

Untuk mencantumkan 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 tercantum.

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 Mitigasi) di Panduan Pengembang AWS IoT.

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 Daftar OTAUpdates di Referensi API AWS IoT.

Untuk membuat daftar 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 ListOutgoingCertificatesdi Referensi API AWS IoT.

Untuk mencantumkan 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 Pengembang AWS IoT.

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 Pengembang AWS IoT.

Untuk membuat daftar hal-hal yang dilampirkan dengan kepala sekolah

list-principal-thingsContoh berikut mencantumkan hal-hal yang dilampirkan 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 ListPrincipalThingsdi Referensi API AWS IoT.

Untuk membuat daftar 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 IoT Core Developer AWS Guide.

Untuk membuat daftar templat penyediaan

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

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 IoT Core Developer AWS Guide.

Untuk membuat daftar alias peran AWS IoT di akun Anda AWS

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

aws iot list-role-aliases

Output:

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

Untuk informasi selengkapnya, lihat ListRoleAliasesdi Referensi API AWS IoT.

Untuk membuat daftar audit terjadwal untuk akun Anda AWS

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.

Untuk membuat daftar profil keamanan yang dilampirkan pada 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.

Untuk membuat daftar profil keamanan untuk AWS akun Anda

list-security-profilesContoh berikut mencantumkan semua profil keamanan AWS IoT Device Defender yang ditentukan AWS di 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.

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 ListStreamsdi Referensi API AWS IoT.

Untuk menampilkan tag dan nilainya yang terkait dengan sumber daya

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

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 Daya AWS IoT Anda di Panduan Pengembang AWS IoT.

Untuk membuat daftar prinsipal yang terkait dengan kebijakan IoT AWS

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 Thing Groups di Panduan Pengembang AWS IoT.

Untuk membuat daftar target di mana profil keamanan diterapkan

list-targets-for-security-profileContoh berikut mencantumkan target yang diberi nama PossibleIssue profil keamanan AWS IoT Device Defender 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.

Untuk membuat daftar kelompok-kelompok yang menjadi milik suatu benda

list-thing-groups-for-thingContoh berikut mencantumkan kelompok-kelompok yang menjadi milik 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 Thing Groups di Panduan Pengembang AWS IoT.

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 Thing Groups di Panduan Pengembang AWS IoT.

Untuk membuat daftar kepala sekolah yang terkait dengan suatu hal

list-thing-principalsContoh berikut mencantumkan prinsipal (sertifikat X.509, 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 ListThingPrincipalsdi Referensi API AWS IoT.

Untuk membuat daftar jenis hal yang ditentukan

list-thing-typesContoh berikut menampilkan daftar jenis hal yang didefinisikan 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 Tipe Hal di Panduan Pengembang AWS IoT.

Untuk membuat daftar hal-hal dalam grup penagihan

list-things-in-billing-groupContoh berikut mencantumkan hal-hal yang ada di 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.

Untuk membuat daftar hal-hal yang termasuk dalam grup

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

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

Output:

{
    "things": [
        "MyLightBulb"
    ]
}

Untuk informasi selengkapnya, lihat Thing Groups di Panduan Pengembang AWS IoT.

Contoh 1: Untuk membuat daftar semua hal dalam registri

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

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 Sesuatu dengan Registri di Panduan Pengembang AWS IoT.

Untuk mencantumkan tujuan aturan topik

list-topic-rule-destinationsContoh berikut mencantumkan semua tujuan aturan topik yang telah Anda tetapkan di AWS Wilayah 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 Bekerja dengan tujuan aturan topik di Panduan Pengembang AWS IoT.

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.

Untuk daftar tingkat logging

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

aws iot list-v2-logging-levels

Output:

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

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 dan Wilayah saat ini AWS .

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.

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 Mendaftar CACertificate di Referensi API AWS IoT.

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 RegisterCertificatedi Referensi API AWS IoT.

Untuk mendaftarkan sesuatu

register-thingContoh berikut mendaftarkan sesuatu menggunakan template provisioning.

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 Pengembang Inti AWS IoT.

Untuk 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 Mentransfer sertifikat ke akun lain di Panduan Pengembang Inti AWS IoT.

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.

Untuk menghapus sesuatu dari grup benda

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

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

Perintah ini tidak menghasilkan output.

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

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 Aturan AWS IoT di Panduan Pengembang AWS IoT.

Untuk menanyakan indeks benda

search-indexContoh berikut query AWS_Things indeks untuk hal-hal yang memiliki jenis. LightBulb

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 menetapkan otorisasi default

set-default-authorizerContoh berikut menetapkan authorizer kustom bernama CustomAuthorizer sebagai authorizer 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 CreateDefaultAuthorizerdi Referensi API AWS IoT.

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.

Untuk mengatur tingkat logging untuk grup sesuatu

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

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

Perintah ini tidak menghasilkan output.

Untuk mengatur opsi logging

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.

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 Mitigasi) di Panduan Pengembang AWS IoT.

Untuk segera memulai audit

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.

Untuk menentukan kunci tag dan nilai untuk sumber daya

tag-resourceContoh berikut menerapkan tag dengan kunci Assembly dan nilai Fact1NW untuk kelompok halLightBulbs.

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 Daya AWS IoT Anda di Panduan Pengembang AWS IoT.

Untuk menguji kebijakan AWS IoT Anda

test-authorizationContoh berikut menguji kebijakan AWS IoT yang terkait dengan prinsipal 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 TestAuthorizationdi Referensi API AWS IoT.

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 TestInvokeAuthorizerdi Referensi API AWS IoT.

Untuk mentransfer sertifikat perangkat ke AWS akun lain

transfer-certificateContoh berikut mentransfer sertifikat perangkat ke AWS akun lain. Sertifikat dan AWS akun diidentifikasi oleh 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 Mentransfer sertifikat ke akun lain di Panduan Pengembang Inti AWS IoT.

Untuk menghapus kunci tag dari sumber daya

untag-resourceContoh berikut menghapus tag MyTag dan nilainya dari kelompok halLightBulbs.

command

Perintah ini tidak menghasilkan output.

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

Contoh 1: Untuk mengaktifkan notifikasi Amazon SNS untuk notifikasi audit

update-account-audit-configurationContoh berikut memungkinkan notifikasi Amazon SNS untuk AWS notifikasi audit 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 memungkinkan pemeriksaan audit AWS IoT Device Defender bernama. AUTHENTICATED_COGNITO_ROLE_OVERLY_PERMISSIVE_CHECK Anda tidak dapat menonaktifkan pemeriksaan audit jika itu adalah bagian dari targetCheckNames untuk satu atau beberapa audit terjadwal untuk AWS akun tersebut.

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.

Untuk memperbarui penindasan temuan audit

update-audit-suppressionContoh berikut memperbarui tanggal kedaluwarsa penindasan temuan audit ke 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 Audit menemukan penekanan di Panduan Pengembang AWS IoT.

Untuk memperbarui otorisasi kustom

update-authorizerContoh berikut dia nyatakan CustomAuthorizer2 untukINACTIVE.

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 UpdateAuthorizerdi Referensi API AWS IoT.

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.

Untuk memperbarui sertifikat otoritas sertifikat (CA)

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

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Memperbarui CACertificate di Referensi API AWS IoT.

Untuk memperbarui sertifikat perangkat

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

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat UpdateCertificatedi Referensi API AWS IoT.

Untuk memperbarui metrik kustom

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.

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 Metrik pelingkupan di profil keamanan menggunakan dimensi di Panduan Pengembang Inti AWS IoT.

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 Titik Akhir yang Dapat Dikonfigurasi di Panduan Pengembang AWS IoT.

Untuk memperbarui grup hal dinamis

update-dynamic-thing-groupContoh berikut memperbarui kelompok hal 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 Dynamic Thing Groups di AWS Panduan Pengembang IoT.

Untuk menunjukkan jenis acara mana yang diterbitkan

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 Acara di Panduan Pengembang AWS IoT.

Untuk mengaktifkan pengindeksan hal

update-indexing-configurationContoh berikut memungkinkan pengindeksan hal 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 Pengembang AWS IoT.

Untuk mendapatkan status terperinci untuk suatu 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 memperbarui tindakan mitigasi

update-mitigation-actionContoh berikut memperbarui tindakan mitigasi yang ditentukan bernamaAddThingsToQuarantineGroupAction, mengubah nama grup hal, dan menetapkan overrideDynamicGroups ke. false 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 Mitigasi) di Panduan Pengembang AWS IoT.

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 IoT Core Developer AWS Guide.

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 UpdateRoleAliasdi Referensi API AWS IoT.

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.

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.

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 UpdateStreamdi Referensi API AWS IoT.

Untuk memperbarui definisi untuk grup sesuatu

update-thing-groupContoh berikut memperbarui definisi untuk kelompok 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 Thing Groups di Panduan Pengembang AWS IoT.

Untuk mengubah kelompok-kelompok yang menjadi milik suatu benda

update-thing-groups-for-thingContoh berikut menghapus hal yang dinamai 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 Thing Groups di Panduan Pengembang AWS IoT.