AWS IoT 使用 的範例 AWS CLI

接受從不同 AWS 帳戶轉移的裝置憑證

下列accept-certificate-transfer範例接受從另一個 AWS 帳戶轉移的裝置憑證。憑證會以其 ID 識別。

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

此命令不會產生任何輸出。

如需詳細資訊，請參閱 AWS IoT Core 開發人員指南中的將憑證轉移到另一個帳戶。

範例 1：依名稱將物件新增至帳單群組

下列add-thing-to-billing-group範例會將名為 的物件新增至名為 MyLightBulb的帳單群組GroupOne。

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

此命令不會產生輸出。

範例 2：將 ARN 的物件新增至帳單群組

下列add-thing-to-billing-group範例會將具有指定 ARN 的物件新增至具有指定 ARN 的帳單群組。如果您使用多個 AWS 區域或帳戶，指定 ARN 很有幫助。它有助於確保您將 新增至正確的區域和帳戶。

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"

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的帳單群組。

將物件新增至群組

下列add-thing-to-thing-group範例會將指定的物件新增至指定的物件群組。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的物件群組。

將物件群組與連續任務建立關聯

下列associate-targets-with-job範例會將指定的物件群組與指定的連續任務建立關聯。

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

輸出：

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

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的建立和管理任務 (CLI)。

範例 1：將政策連接至物件群組

下列attach-policy範例會將指定的政策連接至其 ARN 所識別的物件群組。

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

此命令不會產生任何輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的物件群組。

範例 2：將政策連接至憑證

下列attach-policy範例會將政策連接至憑證指定的UpdateDeviceCertPolicy主體。

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

此命令不會產生任何輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的將 IoT 政策連接至裝置憑證。 AWS IoT

將安全設定檔與所有未註冊裝置建立關聯

下列attach-security-profile範例會將名為 的 AWS IoT Device Defender 安全描述檔Testprofile與此 AWS 帳戶us-west-2區域中所有未註冊的裝置建立關聯。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的偵測命令。

將憑證連接至您的物件

下列attach-thing-principal範例會將憑證連接至 MyTemperatureSensor 物件。憑證由 ARN 識別。您可以在 AWS IoT 主控台中找到憑證的 ARN。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的如何使用登錄檔管理物件。

若要取消稽核緩解動作任務

下列cancel-audit-mitigations-action-task範例會取消指定任務的緩解動作應用程式。您無法取消已完成的任務。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的 CancelAuditMitigationActionsTask （緩解動作命令）。

取消稽核任務

下列cancel-audit-task範例會取消具有指定任務 ID 的稽核任務。您無法取消已完成的任務。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的稽核命令。

取消將憑證轉移到其他 AWS 帳戶

下列cancel-certificate-transfer範例會取消指定憑證傳輸的傳輸。憑證由憑證 ID 識別。您可以在 AWS IoT 主控台中找到憑證的 ID。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT Core 開發人員指南中的將憑證轉移到另一個帳戶。

取消裝置上的任務執行

下列cancel-job-execution範例會取消在裝置上執行指定的任務。如果任務未處於 QUEUED 狀態，您必須新增 --force 參數。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的建立和管理任務 (CLI)。

取消任務

下列cancel-job範例會取消指定的任務。

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

輸出：

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

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的建立和管理任務 (CLI)。

清除預設授權方

下列clear-default-authorizer範例會清除目前設定的預設自訂授權方。執行此命令後，沒有預設授權方。當您使用自訂授權方時，您必須在 HTTP 請求標頭中依名稱指定它。

aws iot clear-default-authorizer

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT API 參考中的 ClearDefaultAuthorizer。

確認主題規則目的地

下列confirm-topic-rule-destination範例使用 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"

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的確認主題規則目的地。

建立稽核問題清單禁止

下列create-audit-suppression範例會為名為 "virtualMachinePolicy" 的政策建立稽核調查結果禁止，該政策已標記為過度寬鬆。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的稽核問題清單隱藏。

建立自訂授權方

下列create-authorizer範例會建立自訂授權方，該授權方會使用指定的 Lambda 函數做為自訂身分驗證服務的一部分。

   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-----"

輸出：

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

如需詳細資訊，請參閱 AWS IoT API 參考中的 CreateAuthorizer。

建立帳單群組

下列create-billing-group範例會建立名為 的簡單帳單群組GroupOne。

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

輸出：

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

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的帳單群組。

從憑證簽署請求 (CSR) 建立裝置憑證

下列create-certificate-from-csr範例會從 CSR 建立裝置憑證。您可以使用 openssl命令來建立 CSR。

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

輸出：

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

如需詳細資訊，請參閱 AWS IoT API 參考中的 CreateCertificateFromCSR。

建立裝置發佈至 Device Defender 的自訂指標

下列create-custom-metric範例會建立測量電池百分比的自訂指標。

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"

輸出：

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

如需詳細資訊，請參閱 AWS IoT Core 開發人員指南中的自訂指標。

建立維度

以下使用名為 的單一主題篩選條件create-dimension建立維度TopicFilterForAuthMessages。

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

輸出：

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

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的偵測命令。

建立網域組態

下列create-domain-configuration範例會建立服務類型為 的受 AWS管網域組態DATA。

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

輸出：

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

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的可設定端點。

建立動態物件群組

下列create-dynamic-thing-group範例會建立動態物件群組，其中包含溫度屬性大於 60 度的任何物件。您必須啟用 AWS IoT 機群索引，才能使用動態物件群組。

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

輸出：

{
    "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"
}

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的動態物件群組。

範例 1：建立任務

下列create-job範例會建立將 JSON 文件傳送至MyRaspberryPi裝置的簡單 AWS IoT 任務。

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

輸出：

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

範例 2：建立連續任務

下列create-job範例會建立任務，在指定為目標的物件完成任務後，繼續執行該任務。在此範例中，目標為物件群組，因此當新裝置新增至群組時，連續任務會在這些新物件上執行。

aws iot create-job --job-id "example-job-04" --targets "arn：aws：iot：us-west-2：123456789012：thinggroup/DeadBulbs" --document file：/example-job.json --description "example continuous job" --target-selection CONTINUOUS

輸出：

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

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的建立和管理任務 (CLI)。

建立 RSA 金鑰對並發行 X.509 憑證

以下內容create-keys-and-certificate會建立 2048 位元 RSA 金鑰對，並使用發行的公有金鑰發行 X.509 憑證。由於這是 AWS IoT 為此憑證提供私有金鑰的唯一時間，請務必將其保存在安全的位置。

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

輸出：

{
    "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"
    }
}

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的建立和註冊 IoT 裝置憑證。 AWS IoT

建立緩解動作

下列create-mitigation-action範例定義了名為 的緩解動作，在套用時， AddThingsToQuarantineGroup1Action 會將物件移至名為 的物件群組QuarantineGroup1。此動作會覆寫動態物件群組。

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

params.json 的內容：

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

輸出：

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

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的 CreateMitigationAction （緩解動作命令）。

建立 OTA 更新以搭配 Amazon FreeRTOS 使用

下列create-ota-update範例會在物件或群組的目標群組上建立 AWS IoT OTAUpdate。這是 Amazon FreeRTOS over-the-air更新的一部分，可讓您將新的韌體映像部署到單一裝置或一組裝置。

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

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"
}

輸出：

{
     "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"
}

如需詳細資訊，請參閱 AWS IoT API 參考中的 CreateOTAUpdate。

使用新版本更新政策

下列create-policy-version範例會更新政策定義，建立新的政策版本。此範例也會將新版本設為預設版本。

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

policy.json 的內容：

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

輸出：

{
    "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
}

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的 IoT 政策。 AWS IoT

建立 AWS IoT 政策

下列create-policy範例會建立名為 TemperatureSensorPolicy 的 AWS IoT 政策。policy.json 檔案包含允許 AWS IoT 政策動作的陳述式。

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

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"
            ]
        }
    ]
}

輸出：

{
    "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"
}

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的 IoT 政策。 AWS IoT

建立佈建宣告

下列create-provisioning-claim範例會從佈建範本建立佈建宣告。

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

輸出：

{
    "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
}

如需詳細資訊，請參閱 AWS IoT Core 開發人員指南中的由信任的使用者佈建。

建立佈建範本版本

下列範例會為指定的佈建範本建立版本。新版本的內文提供於 檔案 template.json。

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

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"]}
        }
    }
}

輸出：

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

如需詳細資訊，請參閱 AWS IoT Core 開發人員指南中的 IoT 安全通道。 AWS IoT

建立佈建範本

下列create-provisioning-template範例會建立檔案 定義的佈建範本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

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"]}
        }
    }
}

輸出：

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

如需詳細資訊，請參閱 AWS IoT Core 開發人員指南中的 IoT 安全通道。 AWS IoT

建立角色別名

下列create-role-alias範例會建立名為 的角色別名，LightBulbRole以用於指定的角色。

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

輸出：

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

如需詳細資訊，請參閱 AWS IoT API 參考中的 CreateRoleAlias。

建立排定的稽核

下列create-scheduled-audit範例會建立排程稽核，每週在星期三執行，以檢查 CA 憑證或裝置憑證是否即將過期。

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

輸出：

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

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的稽核命令。

建立安全設定檔

下列create-security-profile範例會建立安全性描述檔，檢查行動頻寬是否超過閾值，或在五分鐘內發生超過 10 次授權失敗。

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}}]"

輸出：

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

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的偵測命令。

建立串流，以透過 MQTT 在區塊中交付一或多個大型檔案

下列create-stream範例會建立串流，以透過 MQTT 在區塊中交付一或多個大型檔案。串流自 S3 等來源傳輸的資料位元組區塊，會封包為 MQTT 訊息。一個串流可與一個或多個檔案建立關聯。

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

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"
}

輸出：

{
     "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"
}

如需詳細資訊，請參閱 AWS IoT API 參考中的 CreateStream。

範例 1：建立物件群組

下列create-thing-group範例會建立名為 的物件群組，LightBulbs其中包含描述和兩個屬性。

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

輸出：

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

範例 2：建立屬於父群組的物件群組

以下 會create-thing-group建立名為 的物件群組HalogenBulbs，其父物件群組名為 LightBulbs。

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

輸出：

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

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的物件群組。

定義物件類型

下列create-thing-type範例定義物件類型和相關聯的屬性。

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

輸出：

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

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的物件類型。

範例 1：在登錄檔中建立物件記錄

下列create-thing範例會在 AWS IoT 物件登錄檔中為裝置建立項目。

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

輸出：

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

範例 2：定義與物件類型相關聯的物件

下列create-thing範例會建立具有指定物件類型及其屬性的物件。

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

輸出：

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

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的如何使用登錄檔管理物件和物件類型。

建立主題規則目的地

下列create-topic-rule-destination範例會建立 HTTP 端點的主題規則目的地。

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

輸出：

{
    "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"
        }
    }
}

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的建立主題規則目的地。

建立傳送 Amazon SNS 提醒的規則

下列create-topic-rule範例會建立規則，在裝置陰影中發現土壤濕度等級讀數過低時傳送 Amazon SNS 訊息。

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

此範例需要將下列 JSON 程式碼儲存至名為 的檔案plant-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"
            }
    }]
}

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的建立 IoT 規則。 AWS IoT

停用您 AWS 帳戶的所有稽核檢查

下列delete-account-audit-configuration範例會還原此帳戶的 AWS IoT Device Defender 預設設定，停用所有稽核檢查並清除組態資料。它也會刪除此帳戶的任何排程稽核。請謹慎使用此命令。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的稽核命令。

刪除稽核問題清單禁止

下列delete-audit-suppression範例會刪除 DEVICE_CERTIFICATE_EXPIRING_CHECK 的稽核調查結果抑制。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的稽核問題清單隱藏。

刪除自訂授權方

下列delete-authorizer範例會刪除名為 的授權方CustomAuthorizer。自訂授權方必須處於 INACTIVE 狀態，您才能將其刪除。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的 DeleteAuthorizer。

刪除帳單群組

下列delete-billing-group範例會刪除指定的帳單群組。即使帳單群組包含一或多個物件，您也可以將其刪除。

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

此命令不會產生任何輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的帳單群組。

刪除 CA 憑證

下列delete-ca-certificate範例會刪除具有指定憑證 ID 的 CA 憑證。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT API 參考中的 DeleteCACertificate。

刪除裝置憑證

下列delete-certificate範例會刪除具有指定 ID 的裝置憑證。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT API 參考中的 DeleteCertificate。

刪除自訂指標

下列delete-custom-metric範例會刪除自訂指標。

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

輸出：

HTTP 200

如需詳細資訊，請參閱 AWS IoT Core 開發人員指南中的自訂指標。

刪除維度

下列delete-dimension範例會刪除名為 的維度TopicFilterForAuthMessages。

aws iot delete-dimension \
    --name TopicFilterForAuthMessages

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的偵測命令。

刪除網域組態

下列delete-domain-configuration範例additionalDataDomain會從您的帳戶刪除名為 的網域組態 AWS 。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的可設定端點。

刪除動態物件群組

下列delete-dynamic-thing-group範例會刪除指定的動態物件群組。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的動態物件群組。

刪除任務執行

下列delete-job-execution範例會刪除裝置上指定任務的任務執行。使用 describe-job-execution取得執行編號。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的建立和管理任務 (CLI)。

若要刪除工作

下列delete-job範例會刪除指定的任務。透過指定 --force選項，即使狀態為 ，任務也會遭到刪除IN_PROGRESS。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的建立和管理任務 (CLI)。

刪除緩解動作

下列delete-mitigation-action範例會刪除指定的緩解動作。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的 DeleteMitigationAction （緩解動作命令）。

刪除 OTA 更新

下列delete-ota-update範例會刪除指定的 OTA 更新。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT API 參考中的 DeleteOTAUpdate。

刪除政策版本

下列delete-policy-version範例會從您的帳戶刪除指定政策的第 2 版 AWS 。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的 IoT 政策。 AWS IoT

刪除政策

下列delete-policy範例會從您的帳戶刪除指定的政策 AWS 。

aws iot delete-policy --policy-name UpdateDeviceCertPolicy

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的 IoT 政策。 AWS IoT

刪除佈建範本版本

下列delete-provisioning-template-version範例會刪除指定佈建範本的第 2 版。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT Core 開發人員指南中的 IoT 安全通道。 AWS IoT

刪除佈建範本

下列delete-provisioning-template範例會刪除指定的佈建範本。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT Core 開發人員指南中的 IoT 安全通道。 AWS IoT

刪除您的註冊 cod

下列delete-registration-code範例會刪除 AWS IoT 帳戶特定的註冊碼。

aws iot delete-registration-code

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的使用您自己的憑證。

刪除 AWS IoT 角色別名

下列delete-role-alias範例會刪除名為 的 AWS IoT 角色別名LightBulbRole。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的授權直接呼叫 AWS 服務。

刪除排定的稽核

下列delete-scheduled-audit範例會刪除名為 的 AWS IoT Device Defender 排程稽核AWSIoTDeviceDefenderDailyAudit。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的稽核命令。

刪除安全設定檔

下列delete-security-profile範例會刪除名為 的安全設定檔PossibleIssue。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的偵測命令。

刪除串流

下列delete-stream範例會刪除指定的串流。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT API 參考中的 DeleteStream。

刪除物件群組

下列delete-thing-group範例會刪除指定的物件群組。如果物件群組包含子物件群組，則無法刪除該物件群組。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的物件群組。

範例 1：刪除物件類型

下列delete-thing-type範例會刪除已棄用物件類型。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的物件類型。

顯示物件的詳細資訊

下列delete-thing範例會從您 AWS 帳戶的 AWS IoT 登錄檔中刪除物件。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的如何使用登錄檔管理物件。

刪除主題規則目的地

下列delete-topic-rule-destination範例會刪除指定的主題規則目的地。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的刪除主題規則目的地。

刪除規則

下列delete-topic-rule範例會刪除指定的規則。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的刪除規則。

刪除物件群組的記錄層級

下列delete-v2-logging-level範例會刪除指定物件群組的記錄層級。

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

此命令不會產生輸出。

範例 1：棄用物件類型

下列deprecate-thing-type範例會棄用物件類型，讓使用者無法與其建立任何新物件的關聯。

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

此命令不會產生輸出。

範例 2：反轉物件類型的棄用

下列deprecate-thing-type範例會反轉物件類型的棄用，讓使用者可以再次將新物件與其建立關聯。

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

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的物件類型。

檢視目前的稽核組態設定

下列describe-account-audit-configuration範例列出 IoT AWS IoT Device Defender 稽核組態的目前設定。

aws iot describe-account-audit-configuration

輸出：

{
    "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
        }
    }
}

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的稽核命令。

列出稽核問題清單的詳細資訊

下列describe-audit-finding範例列出指定 AWS IoT Device Defender 稽核調查結果的詳細資訊。稽核可以產生多個調查結果。使用 list-audit-findings命令從稽核取得問題清單，以取得 findingId。

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

輸出：

{
    "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"
    }
}

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的檢查稽核結果 （稽核命令）。

顯示稽核緩解動作任務的詳細資訊

下列describe-audit-mitigation-actions-task範例顯示指定任務的詳細資訊，其中 ResetPolicyVersionAction已套用至問題清單。結果包括任務開始和結束的時間、目標調查結果數量 （和結果），以及作為此任務一部分套用的動作定義。

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

輸出：

{
    "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"
                }
            }
        }
    ]
}

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的 DescribeAuditMitigationActionsTask （緩解動作命令）。

若要取得稽核問題清單禁止的詳細資訊

下列describe-audit-suppression範例列出有關稽核問題清單禁止的詳細資訊。

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

輸出：

{
    "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
        }
    }
}

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的稽核問題清單隱藏。