# AWS IoT examples using AWS CLI
次のコード例では、AWS IoT で AWS Command Line Interface を使用してアクションを実行し、一般的なシナリオを実装する方法を示しています。
*アクション*はより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。
各例には完全なソースコードへのリンクが含まれており、コードの設定方法と実行方法に関する手順を確認できます。
**Topics**
+ [アクション](#actions)
## アクション
### `accept-certificate-transfer`
次のコード例は、`accept-certificate-transfer` を使用する方法を示しています。
**AWS CLI**
**別の AWS アカウントから転送されたデバイス証明書を受け入れるには**
次の `accept-certificate-transfer` の例では、別の AWS アカウントから転送されたデバイス証明書を受け入れます。証明書は ID で識別されます。
```
aws iot accept-certificate-transfer \
--certificate-id 488b6a7f2acdeb00a77384e63c4e40b18bEXAMPLEe57b7272ba44c45e3448142
```
このコマンドでは、出力が生成されません。
詳細については、「*AWSIoT Core デベロッパーガイド*」の「[証明書を別のアカウントに転送する](https://docs.aws.amazon.com/iot/latest/developerguide/transfer-cert.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[AcceptCertificateTransfer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/accept-certificate-transfer.html)」を参照してください。
### `add-thing-to-billing-group`
次のコード例は、`add-thing-to-billing-group` を使用する方法を示しています。
**AWS CLI**
**例 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 を持つ請求グループに追加します。ARN の指定は、複数の AWS リージョンまたはアカウントを操作する場合に役立ちます。これにより、適切なリージョンとアカウントに追加できます。
```
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 デベロッパーガイド*」の「[請求グループ](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot-billing-groups.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[AddThingToBillingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/add-thing-to-billing-group.html)」を参照してください。
### `add-thing-to-thing-group`
次のコード例は、`add-thing-to-thing-group` を使用する方法を示しています。
**AWS CLI**
**モノをグループに追加するには**
次の `add-thing-to-thing-group` の例では、指定されたモノを指定されたモノグループに追加します。
```
aws iot add-thing-to-thing-group \
--thing-name MyLightBulb \
--thing-group-name LightBulbs
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[モノのグループ](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[AddThingToThingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/add-thing-to-thing-group.html)」を参照してください。
### `associate-targets-with-job`
次のコード例は、`associate-targets-with-job` を使用する方法を示しています。
**AWS CLI**
**モノのグループを連続ジョブに関連付けるには**
次の `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) の作成と管理](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[AssociateTargetsWithJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/associate-targets-with-job.html)」を参照してください。
### `attach-policy`
次のコード例は、`attach-policy` を使用する方法を示しています。
**AWS CLI**
**例 1: モノのグループにポリシーをアタッチするには**
次の `attach-policy` の例では、指定されたポリシーを ARN で識別されるモノのグループにアタッチします。
```
aws iot attach-policy \
--target "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs" \
--policy-name "UpdateDeviceCertPolicy"
```
このコマンドでは、出力が生成されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[モノのグループ](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html)」を参照してください。
**例 2: ポリシーを証明書にアタッチするには**
次の `attach-policy` の例では、証明書で指定されたプリンシパルにポリシー `UpdateDeviceCertPolicy` をアタッチします。
```
aws iot attach-policy \
--policy-name UpdateDeviceCertPolicy \
--target "arn:aws:iot:us-west-2:123456789012:cert/4f0ba725787aa94d67d2fca420eca022242532e8b3c58e7465c7778b443fd65e"
```
このコマンドでは、出力が生成されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[AWS IoT ポリシーをデバイス証明書にアタッチする](https://docs.aws.amazon.com/iot/latest/developerguide/attach-policy-to-certificate.html)」を参照してください。
+ API の詳細については、AWS CLI コマンドリファレンスの「[AttachPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/attach-policy.html)」を参照してください。**
### `attach-security-profile`
次のコード例は、`attach-security-profile` を使用する方法を示しています。
**AWS CLI**
**セキュリティプロファイルをすべての未登録のデバイスに関連付けるには**
次の `attach-security-profile` の例では、`Testprofile` という名前の AWS IoT Device Defender セキュリティプロファイルを、この 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 デベロッパーガイド*」の「[Detect コマンド](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス」*の「[AttachSecurityProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/attach-security-profile.html)」を参照してください。
### `attach-thing-principal`
次のコード例は、`attach-thing-principal` を使用する方法を示しています。
**AWS CLI**
**モノに証明書をアタッチするには**
次の `attach-thing-principal` 例では、MyTemperatureSensor モノに証明書をアタッチします。証明書は ARN によって識別されます。証明書の ARN は AWS IoT コンソールで確認できます。
```
aws iot attach-thing-principal \
--thing-name MyTemperatureSensor \
--principal arn:aws:iot:us-west-2:123456789012:cert/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8
```
このコマンドでは何も出力されません。
詳細については、「AWS IoT ディベロッパーガイド」の「[レジストリによるモノの管理方法](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html)」を参照してください。**
+ API の詳細については、「*AWS CLI API リファレンス*」の「[AttachThingPrincipal](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/attach-thing-principal.html)」を参照してください。
### `cancel-audit-mitigation-actions-task`
次のコード例は、`cancel-audit-mitigation-actions-task` を使用する方法を示しています。
**AWS CLI**
**監査緩和アクションタスクをキャンセルするには**
次の `cancel-audit-mitigations-action-task` の例では、指定されたタスクの緩和アクションの適用をキャンセルします。すでに完了したタスクはキャンセルできません。
```
aws iot cancel-audit-mitigation-actions-task
--task-id "myActionsTaskId"
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[CancelAuditMitigationActionsTask (緩和アクションコマンド)](https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-CancelAuditMitigationActionsTask)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CancelAuditMitigationActionsTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/cancel-audit-mitigation-actions-task.html)」を参照してください。
### `cancel-audit-task`
次のコード例は、`cancel-audit-task` を使用する方法を示しています。
**AWS CLI**
**監査タスクをキャンセルするには**
次の `cancel-audit-task` の例では、指定されたタスク ID を持つ監査タスクをキャンセルします。完了したタスクをキャンセルできません。
```
aws iot cancel-audit-task \
--task-id a3aea009955e501a31b764abe1bebd3d
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[Audit コマンド](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CancelAuditTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/cancel-audit-task.html)」を参照してください。
### `cancel-certificate-transfer`
次のコード例は、`cancel-certificate-transfer` を使用する方法を示しています。
**AWS CLI**
**別の AWS のアカウントへの証明書の転送をキャンセルするには**
次の `cancel-certificate-transfer` の例では、指定された証明書転送の転送をキャンセルします。証明書は証明書 ID によって識別されます。AWS IoT コンソールで証明書の ID を確認できます。
```
aws iot cancel-certificate-transfer \
--certificate-id f0f33678c7c9a046e5cc87b2b1a58dfa0beec26db78addd5e605d630e05c7fc8
```
このコマンドでは何も出力されません。
詳細については、「*AWSIoT Core デベロッパーガイド*」の「[証明書を別のアカウントに転送する](https://docs.aws.amazon.com/iot/latest/developerguide/transfer-cert.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CancelCertificateTransfer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/cancel-certificate-transfer.html)」を参照してください。
### `cancel-job-execution`
次のコード例は、`cancel-job-execution` を使用する方法を示しています。
**AWS CLI**
**デバイスでジョブ実行をキャンセルするには**
次の `cancel-job-execution` の例では、デバイスで指定されたジョブの実行をキャンセルします。ジョブが `QUEUED` の状態にない場合は、`--force` パラメータを追加する必要があります。
```
aws iot cancel-job-execution \
--job-id "example-job-03" \
--thing-name "MyRPi"
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[ジョブ (CLI) の作成と管理](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CancelJobExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/cancel-job-execution.html)」を参照してください。
### `cancel-job`
次のコード例は、`cancel-job` を使用する方法を示しています。
**AWS 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) の作成と管理](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CancelJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/cancel-job.html)」を参照してください。
### `clear-default-authorizer`
次のコード例は、`clear-default-authorizer` を使用する方法を示しています。
**AWS CLI**
**デフォルトのオーソライザーをクリアするには**
次の `clear-default-authorizer` の例では、現在設定されているデフォルトのカスタムオーソライザーをクリアします。このコマンドを実行すると、デフォルトのオーソライザーはなくなります。カスタムオーソライザーを使用する場合は、HTTP リクエストヘッダーに名前で指定する必要があります。
```
aws iot clear-default-authorizer
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT API リファレンス*」の「[ClearDefaultAuthorizer](https://docs.aws.amazon.com/iot/latest/apireference/API_ClearDefaultAuthorizer.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ClearDefaultAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/clear-default-authorizer.html)」を参照してください。
### `confirm-topic-rule-destination`
次のコード例は、`confirm-topic-rule-destination` を使用する方法を示しています。
**AWS CLI**
**トピックルールの送信先を確認するには**
次の `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 デベロッパーガイド*」の「[トピックルールの送信先の確認](https://docs.aws.amazon.com/iot/latest/developerguide/rule-destination.html#confirm-destination)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ConfirmTopicRuleDestination](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/confirm-topic-rule-destination.html)」を参照してください。
### `create-audit-suppression`
次のコード例は、`create-audit-suppression` を使用する方法を示しています。
**AWS CLI**
**監査検出結果の抑制を作成するには**
次の `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 デベロッパーガイド*」の「[監査の検出結果の抑制](https://docs.aws.amazon.com/iot/latest/developerguide/audit-finding-suppressions.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CreateAuditSuppression](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-audit-suppression.html)」を参照してください。
### `create-authorizer`
次のコード例は、`create-authorizer` を使用する方法を示しています。
**AWS CLI**
**カスタムオーソライザーを作成するには**
次の `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](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateAuthorizer.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CreateAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-authorizer.html)」を参照してください。
### `create-billing-group`
次のコード例は、`create-billing-group` を使用する方法を示しています。
**AWS CLI**
**請求グループを作成するには**
次の `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 デベロッパーガイド*」の「[請求グループ](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot-billing-groups.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CreateBillingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-billing-group.html)」を参照してください。
### `create-certificate-from-csr`
次のコード例は、`create-certificate-from-csr` を使用する方法を示しています。
**AWS CLI**
**証明書署名リクエスト (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": ""
}
```
詳細については、「*AWS IoT API リファレンス*」の「[CreateCertificateFromCSR](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateCertificateFromCsr.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CreateCertificateFromCsr](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-certificate-from-csr.html)」を参照してください。
### `create-custom-metric`
次のコード例は、`create-custom-metric` を使用する方法を示しています。
**AWS CLI**
**デバイスが 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 デベロッパーガイド*」の「[カスタムメトリクス](https://docs.aws.amazon.com/iot/latest/developerguide/dd-detect-custom-metrics.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CreateCustomMetric](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-custom-metric.html)」を参照してください。
### `create-dimension`
次のコード例は、`create-dimension` を使用する方法を示しています。
**AWS CLI**
**ディメンションを作成するには**
次の `create-dimension` では、`TopicFilterForAuthMessages` という 1 つのトピックフィルターを使用してディメンションを作成します。
```
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 デベロッパーガイド*」の「[Detect コマンド](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CreateDimension](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-dimension.html)」を参照してください。
### `create-domain-configuration`
次のコード例は、`create-domain-configuration` を使用する方法を示しています。
**AWS CLI**
**ドメイン設定を作成するには**
次の `create-domain-configuration` の例では、サービスタイプが `DATA` の AWS マネージドドメイン設定を作成します。
```
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 デベロッパーガイド*」の「[設定可能なエンドポイント](https://docs.aws.amazon.com/iot/latest/developerguide/iot-custom-endpoints-configurable-aws.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CreateDomainConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-domain-configuration.html)」を参照してください。
### `create-dynamic-thing-group`
次のコード例は、`create-dynamic-thing-group` を使用する方法を示しています。
**AWS CLI**
**モノの動的グループを作成するには**
次の `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 デベロッパーガイド*」「[モノの動的グループ](https://docs.aws.amazon.com/iot/latest/developerguide/dynamic-thing-groups.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CreateDynamicThingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-dynamic-thing-group.html)」を参照してください。
### `create-job`
次のコード例は、`create-job` を使用する方法を示しています。
**AWS CLI**
**例 1: ジョブを作成するには**
次の `create-job` の例では、`MyRaspberryPi` デバイスに JSON ドキュメントを送信するシンプルな 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) の作成と管理](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html)」を参照してください。
+ API の詳細については、*AWS CLI コマンドリファレンス* の「[CreateJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-job.html)」を参照してください。
### `create-keys-and-certificate`
次のコード例は、`create-keys-and-certificate` を使用する方法を示しています。
**AWS 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 デベロッパーガイド**」の「[AWS IoT デバイス証明書の作成と登録](https://docs.aws.amazon.com/iot/latest/developerguide/device-certs-create.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CreateKeysAndCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-keys-and-certificate.html)」を参照してください。
### `create-mitigation-action`
次のコード例は、`create-mitigation-action` を使用する方法を示しています。
**AWS CLI**
**緩和アクションを作成するには**
次の `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"
}
```
詳細については、「*AWSIoT デベロッパーガイド*」の「[CreateMitigationAction (緩和アクションコマンド)](https://docs.aws.amazon.com/iot/latest/developerguide/iot/latest/developerguide/iot/latest/developerguide/mitigation-action-commands.html.html#dd-api-iot-CreateMitigationAction)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CreateMitigationAction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-mitigation-action.html)」を参照してください。
### `create-ota-update`
次のコード例は、`create-ota-update` を使用する方法を示しています。
**AWS CLI**
**Amazon FreeRTOS で使用する OTA 更新を作成するには**
次の `create-ota-update` の例では、ターゲットまたはグループのグループに AWS IoT OTAUpdate を作成します。これは Amazon FreeRTOS の無線通信更新の一部であり、新しいファームウェアイメージを単一のデバイスまたはデバイスのグループにデプロイできます。
```
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](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateOTAUpdate.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CreateOtaUpdate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-ota-update.html)」を参照してください。
### `create-policy-version`
次のコード例は、`create-policy-version` を使用する方法を示しています。
**AWS CLI**
**ポリシーを新しいバージョンで更新するには**
次の `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 デベロッパーガイド*」の「[AWS IoT ポリシー](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CreatePolicyVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-policy-version.html)」を参照してください。
### `create-policy`
次のコード例は、`create-policy` を使用する方法を示しています。
**AWS CLI**
**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 デベロッパーガイド*」の「[AWS IoT ポリシー](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CreatePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-policy.html)」を参照してください。
### `create-provisioning-claim`
次のコード例は、`create-provisioning-claim` を使用する方法を示しています。
**AWS CLI**
**プロビジョニングクレームを作成するには**
次の `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 デベロッパーガイド*」の「[信頼できるユーザーによるプロビジョニング](https://docs.aws.amazon.com/iot/latest/developerguide/provision-wo-cert.html#trusted-user)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CreateProvisioningClaim](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-provisioning-claim.html)」を参照してください。
### `create-provisioning-template-version`
次のコード例は、`create-provisioning-template-version` を使用する方法を示しています。
**AWS CLI**
**プロビジョニングテンプレートバージョンを作成するには**
次の例では、指定されたプロビジョニングテンプレートのバージョンを作成します。新しいバージョンの本文は `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 デベロッパーガイド*」の「[AWS セキュアトンネリング](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CreateProvisioningTemplateVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-provisioning-template-version.html)」を参照してください。
### `create-provisioning-template`
次のコード例は、`create-provisioning-template` を使用する方法を示しています。
**AWS CLI**
**プロビジョニングテンプレートを作成するには**
次の `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 デベロッパーガイド*」の「[AWS セキュアトンネリング](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CreateProvisioningTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-provisioning-template.html)」を参照してください。
### `create-role-alias`
次のコード例は、`create-role-alias` を使用する方法を示しています。
**AWS CLI**
**ロールエイリアスを作成するには**
次の `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](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateRoleAlias.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CreateRoleAlias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-role-alias.html)」を参照してください。
### `create-scheduled-audit`
次のコード例は、`create-scheduled-audit` を使用する方法を示しています。
**AWS CLI**
**スケジュールされた監査を作成するには**
次の `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 デベロッパーガイド*」の「[Audit コマンド](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CreateScheduledAudit](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-scheduled-audit.html)」を参照してください。
### `create-security-profile`
次のコード例は、`create-security-profile` を使用する方法を示しています。
**AWS CLI**
**セキュリティプロファイルを作成するには**
次の `create-security-profile` の例では、セルラー帯域幅がしきい値を超えているか、または 5 分以内に 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 デベロッパーガイド*」の「[Detect コマンド](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CreateSecurityProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-security-profile.html)」を参照してください。
### `create-stream`
次のコード例は、`create-stream` を使用する方法を示しています。
**AWS CLI**
**MQTT を介して 1 つ以上の大きなファイルをチャンクで配信するためのストリームを作成するには**
次の `create-stream` の例では、MQTT を介して 1 つ以上の大きなファイルをチャンクで配信するためのストリームを作成します。ストリームは、S3 のような送信元から MQTT メッセージとしてパッケージ化されたチャンクまたはブロックのデータバイトを転送します。1 つ以上のファイルをストリームに関連付けることができます。
```
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](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateStream.html)」を参照してください。
+ API の詳細については、AWS CLI コマンドリファレンスの「[CreateStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-stream.html)」を参照してください。**
### `create-thing-group`
次のコード例は、`create-thing-group` を使用する方法を示しています。
**AWS CLI**
**例 1: モノのグループを作成するには**
次の `create-thing-group` の例では、説明と 2 つの属性を持つ `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` は、`LightBulbs` という名前の親モノグループを持つ `HalogenBulbs` という名前のモノグループを作成します。
```
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 デベロッパーガイド*」の「[モノのグループ](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CreateThingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-thing-group.html)」を参照してください。
### `create-thing-type`
次のコード例は、`create-thing-type` を使用する方法を示しています。
**AWS CLI**
**モノのタイプを定義するには**
次の `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 デベロッパーガイド*」「[モノのタイプ](https://docs.aws.amazon.com/iot/latest/developerguide/thing-types.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CreateThingType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-thing-type.html)」を参照してください。
### `create-thing`
次のコード例は、`create-thing` を使用する方法を示しています。
**AWS CLI**
**例 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 ディベロッパーガイド*」の「[レジストリによるモノの管理方法](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html)」と「[モノのタイプ](https://docs.aws.amazon.com/iot/latest/developerguide/thing-types.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CreateThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-thing.html)」を参照してください。
### `create-topic-rule-destination`
次のコード例は、`create-topic-rule-destination` を使用する方法を示しています。
**AWS CLI**
**トピックルールの送信先を作成するには**
次の `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 デベロッパーガイド*」の「[トピックルールの送信先の作成](https://docs.aws.amazon.com/iot/latest/developerguide/rule-destination.html#create-destination)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CreateTopicRuleDestination](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-topic-rule-destination.html)」を参照してください。
### `create-topic-rule`
次のコード例は、`create-topic-rule` を使用する方法を示しています。
**AWS CLI**
**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 デベロッパーガイド*」の「[AWS IoT ルールの作成](https://docs.aws.amazon.com/iot/latest/developerguide/iot-create-rule.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CreateTopicRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-topic-rule.html)」を参照してください。
### `delete-account-audit-configuration`
次のコード例は、`delete-account-audit-configuration` を使用する方法を示しています。
**AWS CLI**
**AWS アカウントのすべての監査チェックを無効にするには**
次の `delete-account-audit-configuration` の例では、このアカウントの AWS IoT Device Defender のデフォルト設定を復元し、すべての監査チェックを無効にして設定データを消去します。また、このアカウントのスケジュールされた監査も削除されます。**このコマンドは注意して使用してください。**
```
aws iot delete-account-audit-configuration \
--delete-scheduled-audits
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[Audit コマンド](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteAccountAuditConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-account-audit-configuration.html)」を参照してください。
### `delete-audit-suppression`
次のコード例は、`delete-audit-suppression` を使用する方法を示しています。
**AWS CLI**
**監査検出結果の抑制を削除するには**
次の `delete-audit-suppression` の例では、DEVICE\$1CERTIFICATE\$1EXPIRING\$1CHECK の監査結果の抑制を削除します。
```
aws iot delete-audit-suppression \
--check-name DEVICE_CERTIFICATE_EXPIRING_CHECK \
--resource-identifier deviceCertificateId="c7691e"
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[監査の検出結果の抑制](https://docs.aws.amazon.com/iot/latest/developerguide/audit-finding-suppressions.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteAuditSuppression](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-audit-suppression.html)」を参照してください。
### `delete-authorizer`
次のコード例は、`delete-authorizer` を使用する方法を示しています。
**AWS CLI**
**カスタムオーソライザーを削除するには**
次の `delete-authorizer` の例では、`CustomAuthorizer` という名前のオーソライザーを削除します。カスタムオーソライザーは、削除する前に `INACTIVE` の状態にある必要があります。
```
aws iot delete-authorizer \
--authorizer-name CustomAuthorizer
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」「[DeleteAuthorizer](https://docs.aws.amazon.com/iot/latest/apireference/API_DeleteAuthorizer.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-authorizer.html)」を参照してください。
### `delete-billing-group`
次のコード例は、`delete-billing-group` を使用する方法を示しています。
**AWS CLI**
**請求グループを削除するには**
次の `delete-billing-group` の例は、指定された請求グループを削除します。請求グループは、1 つ以上のモノが含まれている場合でも削除できます。
```
aws iot delete-billing-group \
--billing-group-name BillingGroupTwo
```
このコマンドでは、出力が生成されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[請求グループ](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot-billing-groups.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteBillingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-billing-group.html)」を参照してください。
### `delete-ca-certificate`
次のコード例は、`delete-ca-certificate` を使用する方法を示しています。
**AWS CLI**
**CA 証明書を削除するには**
次の `delete-ca-certificate` の例では、指定された証明書 ID を持つ CA 証明書を削除します。
```
aws iot delete-ca-certificate \
--certificate-id f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT API リファレンス*」の「[DeleteCACertificate](https://docs.aws.amazon.com/iot/latest/apireference/API_DeleteCACertificate.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteCaCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-ca-certificate.html)」を参照してください。
### `delete-certificate`
次のコード例は、`delete-certificate` を使用する方法を示しています。
**AWS CLI**
**デバイス証明書を削除するには**
次の `delete-certificate` 例は、指定した ID のデバイス証明書を削除します。
```
aws iot delete-certificate \
--certificate-id c0c57bbc8baaf4631a9a0345c957657f5e710473e3ddbee1428d216d54d53ac9
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT API リファレンス*」の「[DeleteCertificate](https://docs.aws.amazon.com/iot/latest/apireference/API_DeleteCertificate.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-certificate.html)」を参照してください。
### `delete-custom-metric`
次のコード例は、`delete-custom-metric` を使用する方法を示しています。
**AWS CLI**
**カスタムメトリクスを削除するには**
次の `delete-custom-metric` の例では、カスタムメトリクスを削除します。
```
aws iot delete-custom-metric \
--metric-name batteryPercentage \
--region us-east-1
```
出力:
```
HTTP 200
```
詳細については、「*AWS IoT Core デベロッパーガイド*」の「[カスタムメトリクス](https://docs.aws.amazon.com/iot/latest/developerguide/dd-detect-custom-metrics.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteCustomMetric](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-custom-metric.html)」を参照してください。
### `delete-dimension`
次のコード例は、`delete-dimension` を使用する方法を示しています。
**AWS CLI**
**ディメンションを削除するには**
次の `delete-dimension` の例では、`TopicFilterForAuthMessages` というディメンションを削除します。
```
aws iot delete-dimension \
--name TopicFilterForAuthMessages
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[Detect コマンド](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteDimension](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-dimension.html)」を参照してください。
### `delete-domain-configuration`
次のコード例は、`delete-domain-configuration` を使用する方法を示しています。
**AWS CLI**
**ドメイン設定を削除するには**
次の `delete-domain-configuration` の例では、`additionalDataDomain` という名前のドメイン設定を AWS アカウントから削除します。
```
aws iot delete-domain-configuration \
--domain-configuration-name "additionalDataDomain" \
--domain-configuration-status "OK"
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[設定可能なエンドポイント](https://docs.aws.amazon.com/iot/latest/developerguide/iot-custom-endpoints-configurable-aws.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteDomainConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-domain-configuration.html)」を参照してください。
### `delete-dynamic-thing-group`
次のコード例は、`delete-dynamic-thing-group` を使用する方法を示しています。
**AWS CLI**
**モノの動的グループを削除するには**
次の `delete-dynamic-thing-group` の例は、指定されたモノの動的グループを削除します。
```
aws iot delete-dynamic-thing-group \
--thing-group-name "RoomTooWarm"
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」「[モノの動的グループ](https://docs.aws.amazon.com/iot/latest/developerguide/dynamic-thing-groups.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteDynamicThingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-dynamic-thing-group.html)」を参照してください。
### `delete-job-execution`
次のコード例は、`delete-job-execution` を使用する方法を示しています。
**AWS CLI**
**ジョブの実行を削除するには**
次の `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) の作成と管理](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteJobExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-job-execution.html)」を参照してください。
### `delete-job`
次のコード例は、`delete-job` を使用する方法を示しています。
**AWS CLI**
**ジョブを削除するには**
次の `delete-job` の例では、指定されたジョブを削除します。`--force` オプションを指定することで、ステータスが `IN_PROGRESS` であってもジョブは削除されます。
```
aws iot delete-job \
--job-id "example-job-04" \
--force
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[ジョブ (CLI) の作成と管理](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html)」を参照してください。
+ API の詳細については、*AWS CLI コマンドリファレンス* の「[DeleteJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-job.html)」を参照してください。
### `delete-mitigation-action`
次のコード例は、`delete-mitigation-action` を使用する方法を示しています。
**AWS CLI**
**緩和アクションを削除するには**
次の `delete-mitigation-action` 例は、指定された緩和アクションを削除します。
```
aws iot delete-mitigation-action \
--action-name AddThingsToQuarantineGroup1Action
```
このコマンドでは何も出力されません。
詳細については、「*AWSIoT デベロッパーガイド*」の「[DeleteMitigationAction (緩和アクションコマンド)](https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-DeleteMitigationAction)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteMitigationAction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-mitigation-action.html)」を参照してください。
### `delete-ota-update`
次のコード例は、`delete-ota-update` を使用する方法を示しています。
**AWS CLI**
**OTA 更新を削除するには**
次の `delete-ota-update` の例では、指定された OTA 更新を削除します。
```
aws iot delete-ota-update \
--ota-update-id ota12345 \
--delete-stream \
--force-delete-aws-job
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT API リファレンス*」の「[DeleteOTAUpdate](https://docs.aws.amazon.com/iot/latest/apireference/API_DeleteOTAUpdate.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteOtaUpdate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-ota-update.html)」を参照してください。
### `delete-policy-version`
次のコード例は、`delete-policy-version` を使用する方法を示しています。
**AWS CLI**
**ポリシーのバージョンを削除するには**
次の `delete-policy-version` の例では、指定されたポリシーのバージョン 2 を AWS アカウントから削除します。
```
aws iot delete-policy-version \
--policy-name UpdateDeviceCertPolicy \
--policy-version-id 2
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[AWS IoT ポリシー](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeletePolicyVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-policy-version.html)」を参照してください。
### `delete-policy`
次のコード例は、`delete-policy` を使用する方法を示しています。
**AWS CLI**
**ポリシーを削除するには**
次の `delete-policy` の例では、指定されたポリシーを AWS アカウントから削除します。
```
aws iot delete-policy --policy-name UpdateDeviceCertPolicy
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[AWS IoT ポリシー](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html)」を参照してください。
+ API の詳細については、「AWS CLI コマンドリファレンス」の「[DeletePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-policy.html)」を参照してください。
### `delete-provisioning-template-version`
次のコード例は、`delete-provisioning-template-version` を使用する方法を示しています。
**AWS CLI**
**プロビジョニングテンプレートのバージョンを削除するには**
次の `delete-provisioning-template-version` の例では、指定されたプロビジョニングテンプレートのバージョン 2 を削除します。
```
aws iot delete-provisioning-template-version \
--version-id 2 \
--template-name "widget-template"
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT Core デベロッパーガイド*」の「[AWS セキュアトンネリング](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteProvisioningTemplateVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-provisioning-template-version.html)」を参照してください。
### `delete-provisioning-template`
次のコード例は、`delete-provisioning-template` を使用する方法を示しています。
**AWS CLI**
**プロビジョニングテンプレートを削除するには**
次の `delete-provisioning-template` の例は、指定されたプロビジョニングテンプレートを削除します。
```
aws iot delete-provisioning-template \
--template-name widget-template
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT Core デベロッパーガイド*」の「[AWS セキュアトンネリング](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteProvisioningTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-provisioning-template.html)」を参照してください。
### `delete-registration-code`
次のコード例は、`delete-registration-code` を使用する方法を示しています。
**AWS CLI**
**登録コードを削除するには**
次の `delete-registration-code` の例では、AWS IoT アカウント固有の登録コードを削除します。
```
aws iot delete-registration-code
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[独自の証明書を使用する](https://docs.aws.amazon.com/iot/latest/developerguide/device-certs-your-own.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteRegistrationCode](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-registration-code.html)」を参照してください。
### `delete-role-alias`
次のコード例は、`delete-role-alias` を使用する方法を示しています。
**AWS CLI**
**AWS IoT ロールエイリアスを削除するには**
次の `delete-role-alias` の例では、`LightBulbRole` という名前の AWS IoT ロールエイリアスを削除します。
```
aws iot delete-role-alias \
--role-alias LightBulbRole
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[AWS サービスへの直接呼び出しの認証](https://docs.aws.amazon.com/iot/latest/developerguide/authorizing-direct-aws.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteRoleAlias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-role-alias.html)」を参照してください。
### `delete-scheduled-audit`
次のコード例は、`delete-scheduled-audit` を使用する方法を示しています。
**AWS CLI**
**スケジュールされた監査を削除するには**
次の `delete-scheduled-audit` の例では、`AWSIoTDeviceDefenderDailyAudit` という名前の AWS IoT Device Defender のスケジュールされた監査を削除します。
```
aws iot delete-scheduled-audit \
--scheduled-audit-name AWSIoTDeviceDefenderDailyAudit
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[Audit コマンド](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteScheduledAudit](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-scheduled-audit.html)」を参照してください。
### `delete-security-profile`
次のコード例は、`delete-security-profile` を使用する方法を示しています。
**AWS CLI**
**セキュリティプロファイルを削除するには**
次の `delete-security-profile` の例では、`PossibleIssue` という名前のセキュリティプロファイルを削除します。
```
aws iot delete-security-profile \
--security-profile-name PossibleIssue
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[Detect コマンド](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteSecurityProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-security-profile.html)」を参照してください。
### `delete-stream`
次のコード例は、`delete-stream` を使用する方法を示しています。
**AWS CLI**
**ストリームを削除するには**
以下の `delete-stream` 例は、指定されたストリームを削除します。
```
aws iot delete-stream \
--stream-id stream12345
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT API リファレンス*」の「[DeleteStream](https://docs.aws.amazon.com/iot/latest/apireference/API_DeleteStream.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-stream.html)」を参照してください。
### `delete-thing-group`
次のコード例は、`delete-thing-group` を使用する方法を示しています。
**AWS CLI**
**モノのグループを削除するには**
次の `delete-thing-group` の例は、指定されたモノのグループを削除します。モノの子グループが含まれている場合、モノのグループを削除することはできません。
```
aws iot delete-thing-group \
--thing-group-name DefectiveBulbs
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[モノのグループ](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteThingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-thing-group.html)」を参照してください。
### `delete-thing-type`
次のコード例は、`delete-thing-type` を使用する方法を示しています。
**AWS CLI**
**例 1: モノのタイプを削除するには**
次の `delete-thing-type` の例では、廃止されたモノのタイプを削除します。
```
aws iot delete-thing-type \
--thing-type-name "obsoleteThingType"
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」「[モノのタイプ](https://docs.aws.amazon.com/iot/latest/developerguide/thing-types.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteThingType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-thing-type.html)」を参照してください。
### `delete-thing`
次のコード例は、`delete-thing` を使用する方法を示しています。
**AWS CLI**
**モノに関する詳細情報を表示するには**
次の `delete-thing` 例では、AWS アカウントの AWS IoT レジストリからモノを削除します。
aws iot delete-thing --thing-name "FourthBulb"
このコマンドでは何も出力されません。
詳細については、「AWS IoT ディベロッパーガイド」の「[レジストリによるモノの管理方法](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html)」を参照してください。**
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-thing.html)」を参照してください。
### `delete-topic-rule-destination`
次のコード例は、`delete-topic-rule-destination` を使用する方法を示しています。
**AWS CLI**
**トピックルールの送信先を削除するには**
次の `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 デベロッパーガイド*」の「[トピックルールの送信先の削除](https://docs.aws.amazon.com/iot/latest/developerguide/rule-destination.html#delete-destination)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteTopicRuleDestination](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-topic-rule-destination.html)」を参照してください。
### `delete-topic-rule`
次のコード例は、`delete-topic-rule` を使用する方法を示しています。
**AWS CLI**
**ルールを削除するには**
次の `delete-topic-rule` の例は、指定されたルールを削除します。
```
aws iot delete-topic-rule \
--rule-name "LowMoistureRule"
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[ルールの削除](https://docs.aws.amazon.com/iot/latest/developerguide/iot-delete-rule.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteTopicRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-topic-rule.html)」を参照してください。
### `delete-v2-logging-level`
次のコード例は、`delete-v2-logging-level` を使用する方法を示しています。
**AWS CLI**
**モノのグループのログ記録レベルを削除するには**
次の `delete-v2-logging-level` の例は、指定されたモノのグループのログ記録レベルを削除します。
```
aws iot delete-v2-logging-level \
--target-type THING_GROUP \
--target-name LightBulbs
```
このコマンドでは何も出力されません。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteV2LoggingLevel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-v2-logging-level.html)」を参照してください。
### `deprecate-thing-type`
次のコード例は、`deprecate-thing-type` を使用する方法を示しています。
**AWS CLI**
**例 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 デベロッパーガイド*」「[モノのタイプ](https://docs.aws.amazon.com/iot/latest/developerguide/thing-types.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeprecateThingType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/deprecate-thing-type.html)」を参照してください。
### `describe-account-audit-configuration`
次のコード例は、`describe-account-audit-configuration` を使用する方法を示しています。
**AWS CLI**
**現在の監査設定を表示するには**
次の `describe-account-audit-configuration` の例では、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 デベロッパーガイド*」の「[Audit コマンド](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeAccountAuditConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-account-audit-configuration.html)」を参照してください。
### `describe-audit-finding`
次のコード例は、`describe-audit-finding` を使用する方法を示しています。
**AWS CLI**
**監査検出結果の詳細を一覧表示するには**
次の `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 デベロッパーガイド*」の「[監査結果をチェックする (Audit コマンド)](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html#device-defender-AuditCommandsFindings)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeAuditFinding](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-audit-finding.html)」を参照してください。
### `describe-audit-mitigation-actions-task`
次のコード例は、`describe-audit-mitigation-actions-task` を使用する方法を示しています。
**AWS CLI**
**監査緩和アクションタスクの詳細を表示するには**
次の `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"
}
}
}
]
}
```
詳細については、「*AWSIoT デベロッパーガイド*」の「[DescribeAuditMitigationActionsTask (緩和アクションコマンド)](https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-DescribeAuditMitigationActionsTask)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeAuditMitigationActionsTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-audit-mitigation-actions-task.html)」を参照してください。
### `describe-audit-suppression`
次のコード例は、`describe-audit-suppression` を使用する方法を示しています。
**AWS CLI**
**監査の検出結果の抑制の詳細を取得するには**
次の `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 デベロッパーガイド*」の「[監査の検出結果の抑制](https://docs.aws.amazon.com/iot/latest/developerguide/audit-finding-suppressions.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeAuditSuppression](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-audit-suppression.html)」を参照してください。
### `describe-audit-task`
次のコード例は、`describe-audit-task` を使用する方法を示しています。
**AWS CLI**
**監査インスタンスの情報を取得するには**
次の `describe-audit-task` の例では、AWS IoT Device Defender 監査のインスタンスに関する情報を取得します。監査が完了すると、結果に含まれる実行のサマリー統計が結果に含まれます。
```
aws iot describe-audit-task \
--task-id a3aea009955e501a31b764abe1bebd3d
```
出力:
```
{
"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
}
}
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[Audit コマンド](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeAuditTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-audit-task.html)」を参照してください。
### `describe-authorizer`
次のコード例は、`describe-authorizer` を使用する方法を示しています。
**AWS CLI**
**カスタムオーソライザーに関する情報を取得するには**
次の `describe-authorizer` の例は、指定されたカスタムオーソライザーのヘルスの詳細情報を表示します。
```
aws iot describe-authorizer \
--authorizer-name CustomAuthorizer
```
出力:
```
{
"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
}
}
```
詳細については、「*AWS IoT API リファレンス*」の「[DescribeAuthorizer](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeAuthorizer.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-authorizer.html)」を参照してください。
### `describe-billing-group`
次のコード例は、`describe-billing-group` を使用する方法を示しています。
**AWS CLI**
**請求グループに関する情報を取得するには**
次の `describe-billing-group` の例では、指定された請求グループの情報を取得します。
```
aws iot describe-billing-group --billing-group-name GroupOne
```
出力:
```
{
"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
}
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[請求グループ](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot-billing-groups.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeBillingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-billing-group.html)」を参照してください。
### `describe-ca-certificate`
次のコード例は、`describe-ca-certificate` を使用する方法を示しています。
**AWS CLI**
**CA 証明書の詳細を取得するには**
次の `describe-ca-certificate` の例では、指定された CA 証明書の詳細を表示します。
```
aws iot describe-ca-certificate \
--certificate-id f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467
```
出力:
```
{
"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
}
}
}
```
詳細については、「*AWS IoT API リファレンス*」の「[DescribeCACertificate](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeCACertificate.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeCaCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-ca-certificate.html)」を参照してください。
### `describe-certificate`
次のコード例は、`describe-certificate` を使用する方法を示しています。
**AWS CLI**
**証明書に関する情報を取得するには**
次の `describe-certificate` の例では、指定された証明書の詳細を表示します。
```
aws iot describe-certificate \
--certificate-id "4f0ba725787aa94d67d2fca420eca022242532e8b3c58e7465c7778b443fd65e"
```
出力:
```
{
"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
}
}
}
```
詳細については、「*AWS IoT API リファレンス*」の「[DescribeCertificate](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeCertificate.html)」を参照してください。
+ API の詳細については、**AWS CLI コマンドリファレンスの「[DescribeCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-certificate.html)」を参照してください。
### `describe-custom-metric`
次のコード例は、`describe-custom-metric` を使用する方法を示しています。
**AWS CLI**
**Device Defender カスタムメトリクスに関する情報を取得するには**
次の `describe-custom-metric` 例では、`myCustomMetric` という名前のカスタムメトリクスに関する情報を取得します。
```
aws iot describe-custom-metric \
--metric-name myCustomMetric
```
出力:
```
{
"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
}
```
詳細については、「*AWS IoT Core デベロッパーガイド*」の「[カスタムメトリクス](https://docs.aws.amazon.com/iot/latest/developerguide/dd-detect-custom-metrics.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeCustomMetric](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-custom-metric.html)」を参照してください。
### `describe-default-authorizer`
次のコード例は、`describe-default-authorizer` を使用する方法を示しています。
**AWS CLI**
**デフォルトのカスタムオーソライザーに関する情報を取得するには**
次の `describe-default-authorizer` の例は、デフォルトのカスタムオーソライザーのヘルスの詳細情報を表示します。
```
aws iot describe-default-authorizer
```
出力:
```
{
"authorizerName": "CustomAuthorizer",
"authorizerArn": "arn:aws:iot:us-west-2:123456789012:authorizer/CustomAuthorizer"
}
```
詳細については、「*AWS IoT API リファレンス*」の「[DescribeDefaultAuthorizer](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeDefautAuthorizer.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeDefaultAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-default-authorizer.html)」を参照してください。
### `describe-dimension`
次のコード例は、`describe-dimension` を使用する方法を示しています。
**AWS CLI**
**ディメンションに関する情報を取得するには**
次の `describe-dimension` の例では、`TopicFilterForAuthMessages` という名前のディメンションに関する情報を取得します。
```
aws iot describe-dimension \
--name TopicFilterForAuthMessages
```
出力:
```
{
"name": "TopicFilterForAuthMessages",
"arn": "arn:aws:iot:eu-west-2:123456789012:dimension/TopicFilterForAuthMessages",
"type": "TOPIC_FILTER",
"stringValues": [
"device/+/auth"
],
"creationDate": 1578620223.255,
"lastModifiedDate": 1578620223.255
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[Detect コマンド](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeDimension](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-dimension.html)」を参照してください。
### `describe-domain-configuration`
次のコード例は、`describe-domain-configuration` を使用する方法を示しています。
**AWS CLI**
**ドメイン設定を記述するには**
次の `describe-domain-configuration` の例は、指定されたドメイン設定の詳細を表示します。
```
aws iot describe-domain-configuration \
--domain-configuration-name "additionalDataDomain"
```
出力:
```
{
"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
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[設定可能なエンドポイント](https://docs.aws.amazon.com/iot/latest/developerguide/iot-custom-endpoints-configurable-aws.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeDomainConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-domain-configuration.html)」を参照してください。
### `describe-endpoint`
次のコード例は、`describe-endpoint` を使用する方法を示しています。
**AWS CLI**
**例 1: 現在の AWS エンドポイントを取得するには**
次の `describe-endpoint` の例は、すべてのコマンドが適用されるデフォルトの AWS エンドポイントを取得します。
```
aws iot describe-endpoint
```
出力:
```
{
"endpointAddress": "abc123defghijk.iot.us-west-2.amazonaws.com"
}
```
詳細については、「AWS IoT ディベロッパーガイド」の「[DescribeEndpoint](https://docs.aws.amazon.com/iot/latest/developerguide/iot-commands.html#api-iot-DescribeEndpoint)」を参照してください。**
**例 2: ATS エンドポイントを取得するには**
次の `describe-endpoint` の例は、Amazon Trust Services (ATS) エンドポイントを取得します。
```
aws iot describe-endpoint \
--endpoint-type iot:Data-ATS
```
出力:
```
{
"endpointAddress": "abc123defghijk-ats.iot.us-west-2.amazonaws.com"
}
```
詳細については、「AWS IoT ディベロッパーガイド」の「[X.509 証明書と AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/managing-device-certs.html)」を参照してください。**
+ API の詳細については、AWS CLI コマンドリファレンスの「[DescribeEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-endpoint.html)」を参照してください。**
### `describe-event-configurations`
次のコード例は、`describe-event-configurations` を使用する方法を示しています。
**AWS CLI**
**公開されるイベントタイプを表示するには**
次の `describe-event-configurations` の例では、何かを追加、更新、または削除したときに生成されるイベントを制御する設定を一覧表示します。
```
aws iot describe-event-configurations
```
出力:
```
{
"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
}
}
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[イベントメッセージ](https://docs.aws.amazon.com/iot/latest/developerguide/iot-events.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeEventConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-event-configurations.html)」を参照してください。
### `describe-index`
次のコード例は、`describe-index` を使用する方法を示しています。
**AWS CLI**
**モノのインデックスの現在のステータスを取得するには**
次の `describe-index` の例では、モノのインデックスの現在のステータスを取得します。
```
aws iot describe-index \
--index-name "AWS_Things"
```
出力:
```
{
"indexName": "AWS_Things",
"indexStatus": "ACTIVE",
"schema": "REGISTRY_AND_SHADOW_AND_CONNECTIVITY_STATUS"
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[モノのインデックス作成の管理](https://docs.aws.amazon.com/iot/latest/developerguide/managing-index.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeIndex](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-index.html)」を参照してください。
### `describe-job-execution`
次のコード例は、`describe-job-execution` を使用する方法を示しています。
**AWS CLI**
**デバイス上のジョブの実行の詳細を取得するには**
次の `describe-job-execution` の例では、指定されたジョブの実行の詳細を取得します。
```
aws iot describe-job-execution \
--job-id "example-job-01" \
--thing-name "MyRaspberryPi"
```
出力:
```
{
"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
}
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[ジョブ (CLI) の作成と管理](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeJobExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-job-execution.html)」を参照してください。
### `describe-job`
次のコード例は、`describe-job` を使用する方法を示しています。
**AWS CLI**
**ジョブの詳細なステータスを取得するには**
次の `describe-job` の例では、ID が `example-job-01` のジョブの詳細なステータスを取得します。
```
aws iot describe-job \
--job-id "example-job-01"
```
出力:
```
{
"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": {}
}
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[ジョブ (CLI) の作成と管理](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-job.html)」を参照してください。
### `describe-mitigation-action`
次のコード例は、`describe-mitigation-action` を使用する方法を示しています。
**AWS CLI**
**定義された緩和アクションの詳細を表示するには**
次の `describe-mitigation-action` 例では、指定された緩和アクションの詳細を表示します。
```
aws iot describe-mitigation-action \
--action-name AddThingsToQuarantineGroupAction
```
出力:
```
{
"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"
}
```
詳細については、「*AWSIoT デベロッパーガイド*」の「[DescribeMitigationAction (緩和アクションコマンド)](https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-DescribeMitigationAction)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeMitigationAction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-mitigation-action.html)」を参照してください。
### `describe-provisioning-template-version`
次のコード例は、`describe-provisioning-template-version` を使用する方法を示しています。
**AWS CLI**
**プロビジョニングテンプレートのバージョンを記述するには**
次の `describe-provisioning-template-version` の例では、プロビジョニングテンプレートのバージョンを記述します。
```
aws iot describe-provisioning-template-version \
--template-name MyTestProvisioningTemplate \
--version-id 1
```
出力:
```
{
"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
}
```
詳細については、「*AWS IoT Core デベロッパーガイド*」の「[フリートプロビジョニングを使用したデバイス証明書がないデバイスのプロビジョニング](https://docs.aws.amazon.com/iot/latest/developerguide/provision-wo-cert.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeProvisioningTemplateVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-provisioning-template-version.html)」を参照してください。
### `describe-provisioning-template`
次のコード例は、`describe-provisioning-template` を使用する方法を示しています。
**AWS CLI**
**プロビジョニングテンプレートを記述するには**
次の `describe-provisioning-template` の例では、プロビジョニングテンプレートを記述します。
```
aws iot describe-provisioning-template \
--template-name MyTestProvisioningTemplate
```
出力:
```
{
"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"
}
```
詳細については、「*AWS IoT Core デベロッパーガイド*」の「[フリートプロビジョニングを使用したデバイス証明書がないデバイスのプロビジョニング](https://docs.aws.amazon.com/iot/latest/developerguide/provision-wo-cert.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeProvisioningTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-provisioning-template.html)」を参照してください。
### `describe-role-alias`
次のコード例は、`describe-role-alias` を使用する方法を示しています。
**AWS CLI**
**AWS IoT ロールエイリアスに関する情報を取得するには**
次の `describe-role-alias` の例は、指定されたロールエイリアスの詳細情報を表示します。
```
aws iot describe-role-alias \
--role-alias LightBulbRole
```
出力:
```
{
"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
}
}
```
詳細については、「*AWS IoT API リファレンス*」の「[DescribeRoleAlias](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeRoleAlias.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeRoleAlias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-role-alias.html)」を参照してください。
### `describe-scheduled-audit`
次のコード例は、`describe-scheduled-audit` を使用する方法を示しています。
**AWS CLI**
**スケジュールされた監査に関する情報を取得するには**
次の`describe-scheduled-audit`例では、`AWSIoTDeviceDefenderDailyAudit` という名前の AWS IOT Device Defender スケジュールされた監査に関する詳細情報を取得します。
```
aws iot describe-scheduled-audit \
--scheduled-audit-name AWSIoTDeviceDefenderDailyAudit
```
出力:
```
{
"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"
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[Audit コマンド](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeScheduledAudit](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-scheduled-audit.html)」を参照してください。
### `describe-security-profile`
次のコード例は、`describe-security-profile` を使用する方法を示しています。
**AWS CLI**
**セキュリティプロファイルに関する情報を取得するには**
次の `describe-security-profile` の例では、`PossibleIssue.` という名前の AWS IoT Device Defender セキュリティプロファイルに関する情報を取得します。
```
aws iot describe-security-profile \
--security-profile-name PossibleIssue
```
出力:
```
{
"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
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[Detect コマンド](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeSecurityProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-security-profile.html)」を参照してください。
### `describe-stream`
次のコード例は、`describe-stream` を使用する方法を示しています。
**AWS CLI**
**ストリームに関する情報を取得するには**
次の `describe-stream` の例は、指定されたストリームの詳細を表示します。
```
aws iot describe-stream \
--stream-id stream12345
```
出力:
```
{
"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"
}
}
```
詳細については、「*AWS IoT API リファレンス*」の「[DescribeStream](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeStream.html)」を参照してください。
+ API の詳細については、AWS CLI コマンドリファレンスの「[DescribeStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-stream.html)」を参照してください。**
### `describe-thing-group`
次のコード例は、`describe-thing-group` を使用する方法を示しています。
**AWS CLI**
**モノのグループに関する情報を取得するには**
次の `describe-thing-group` の例では、`HalogenBulbs` という名前のモノのグループに関する情報を取得します。
```
aws iot describe-thing-group \
--thing-group-name HalogenBulbs
```
出力:
```
{
"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
}
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[モノのグループ](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeThingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-thing-group.html)」を参照してください。
### `describe-thing-type`
次のコード例は、`describe-thing-type` を使用する方法を示しています。
**AWS CLI**
**モノのタイプに関する情報を取得するには**
次の `describe-thing-type` の例では、AWS アカウントで定義されている指定されたモノのタイプに関する情報を表示します。
```
aws iot describe-thing-type \
--thing-type-name "LightBulb"
```
出力:
```
{
"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
}
}
```
詳細については、「*AWS IoT デベロッパーガイド*」「[モノのタイプ](https://docs.aws.amazon.com/iot/latest/developerguide/thing-types.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeThingType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-thing-type.html)」を参照してください。
### `describe-thing`
次のコード例は、`describe-thing` を使用する方法を示しています。
**AWS CLI**
**モノに関する詳細情報を表示するには**
次の `describe-thing` 例では、AWS アカウントの AWS IoT レジストリで定義されているモノ (デバイス) に関する情報を表示します。
aws iot describe-thing --thing-name "MyLightBulb"
出力:
```
{
"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
}
```
詳細については、「AWS IoT ディベロッパーガイド」の「[レジストリによるモノの管理方法](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html)」を参照してください。**
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-thing.html)」を参照してください。
### `detach-policy`
次のコード例は、`detach-policy` を使用する方法を示しています。
**AWS CLI**
**例 1: AWS IoT ポリシーをモノのグループからデタッチするには**
次の `detach-policy` の例では、指定されたポリシーをモノのグループからデタッチし、さらにそのグループとそのグループの子グループからすべてのモノをデタッチします。
```
aws iot detach-policy \
--target "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs" \
--policy-name "MyFirstGroup_Core-policy"
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[モノのグループ](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html)」を参照してください。
**例 2: デバイス証明書から AWS IoT ポリシーをデタッチするには**
次の `detach-policy` の例では、ARN によって識別されるデバイス証明書から TemperatureSensorPolicy ポリシーをデタッチします。
```
aws iot detach-policy \
--policy-name TemperatureSensorPolicy \
--target arn:aws:iot:us-west-2:123456789012:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142
```
このコマンドでは何も出力されません。
+ API の詳細については、AWS CLI コマンドリファレンスの「[DetachPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/detach-policy.html)」を参照してください。**
### `detach-security-profile`
次のコード例は、`detach-security-profile` を使用する方法を示しています。
**AWS CLI**
**ターゲットからセキュリティプロファイルの関連付けを解除するには**
次の `detach-security-profile` の例では、`Testprofile` という名前の AWS IoT Device Defender セキュリティプロファイルと、登録されたすべてのモノのターゲットとの関連付けを削除します。
```
aws iot detach-security-profile \
--security-profile-name Testprofile \
--security-profile-target-arn "arn:aws:iot:us-west-2:123456789012:all/registered-things"
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[Detect コマンド](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DetachSecurityProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/detach-security-profile.html)」を参照してください。
### `detach-thing-principal`
次のコード例は、`detach-thing-principal` を使用する方法を示しています。
**AWS CLI**
**モノから証明書/プリンシパルをデタッチするには**
次の `detach-thing-principal` 例では、指定されたモノからプリンシパルを表す証明書を削除します。
```
aws iot detach-thing-principal \
--thing-name "MyLightBulb" \
--principal "arn:aws:iot:us-west-2:123456789012:cert/604c48437a57b7d5fc5d137c5be75011c6ee67c9a6943683a1acb4b1626bac36"
```
このコマンドでは何も出力されません。
詳細については、「AWS IoT ディベロッパーガイド」の「[レジストリによるモノの管理方法](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html)」を参照してください。**
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DetachThingPrincipal](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/detach-thing-principal.html)」を参照してください。
### `disable-topic-rule`
次のコード例は、`disable-topic-rule` を使用する方法を示しています。
**AWS CLI**
**トピックルールを無効にするには**
次の `disable-topic-rule` の例では、指定したトピックルールを無効にします。
```
aws iot disable-topic-rule \
--rule-name "MyPlantPiMoistureAlertRule"
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[ルールの表示](https://docs.aws.amazon.com/iot/latest/developerguide/iot-view-rules.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DisableTopicRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/disable-topic-rule.html)」を参照してください。
### `enable-topic-rule`
次のコード例は、`enable-topic-rule` を使用する方法を示しています。
**AWS CLI**
**トピックルールを有効にするには**
次の `enable-topic-rule` の例では、指定されたトピックルールを有効化 (または再有効化) します。
```
aws iot enable-topic-rule \
--rule-name "MyPlantPiMoistureAlertRule"
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[ルールの表示](https://docs.aws.amazon.com/iot/latest/developerguide/iot-view-rules.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[EnableTopicRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/enable-topic-rule.html)」を参照してください。
### `get-behavior-model-training-summaries`
次のコード例は、`get-behavior-model-training-summaries` を使用する方法を示しています。
**AWS CLI**
**Device Defender の ML Detect Security Profile トレーニングモデルのステータスを一覧表示するには**
次の `get-behavior-model-training-summaries` の例では、選択したセキュリティプロファイルで設定された動作のモデルトレーニングのステータスを一覧表示します。動作ごとに、収集されたデータポイントの名前、モデルステータス、およびパーセンテージが一覧表示されます。
```
aws iot get-behavior-model-training-summaries \
--security-profile-name MySecuirtyProfileName
```
出力:
```
{
"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
}
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[GetBehaviorModelTrainingSummaries (Detect コマンド)](https://docs.aws.amazon.com/iot/latest/developerguide/detect-commands.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[GetBehaviorModelTrainingSummaries](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-behavior-model-training-summaries.html)」を参照してください。
### `get-cardinality`
次のコード例は、`get-cardinality` を使用する方法を示しています。
**AWS CLI**
**クエリに一致する一意の値のおおよその数を返すには**
次のセットアップスクリプトを使用して、10 個の温度センサーを表す 10 個のモノを作成できます。新しいモノにはそれぞれ 3 つの属性があります。
```
# 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
```
セットアップスクリプトの出力例:
```
{
"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-cardinality` の例では、セットアップスクリプトによって作成された 10 個のセンサーをクエリし、温度センサーが異常な温度値を報告しているラックの数を返します。温度値が 60 未満または 80 を超過する場合、温度センサーは異常な状態になります。
```
aws iot get-cardinality \
--aggregation-field "attributes.rackId" \
--query-string "thingName:TempSensor* AND attributes.stateNormal:false"
```
出力:
```
{
"cardinality": 2
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「集計データのクエリ」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[GetCardinality](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-cardinality.html)」を参照してください。
### `get-effective-policies`
次のコード例は、`get-effective-policies` を使用する方法を示しています。
**AWS CLI**
**モノに影響するポリシーを一覧表示するには**
次の `get-effective-policies` の例では、指定されたモノに影響するポリシーを一覧表示します。これには、それが属するすべてのグループにアタッチされたポリシーが含まれます。
```
aws iot get-effective-policies \
--thing-name TemperatureSensor-001 \
--principal arn:aws:iot:us-west-2:123456789012:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142
```
出力:
```
{
"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\"
]
}
]
}"
}
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の[「モノで有効なポリシーを取得する](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html#group-get-effective-policies)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[GetEffectivePolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-effective-policies.html)」を参照してください。
### `get-indexing-configuration`
次のコード例は、`get-indexing-configuration` を使用する方法を示しています。
**AWS CLI**
**モノのインデックス作成設定を取得するには**
次の `get-indexing-configuration` の例では、AWS IoT フリートインデックス作成の現在の設定データを取得します。
```
aws iot get-indexing-configuration
```
出力:
```
{
"thingIndexingConfiguration": {
"thingIndexingMode": "OFF",
"thingConnectivityIndexingMode": "OFF"
},
"thingGroupIndexingConfiguration": {
"thingGroupIndexingMode": "OFF"
}
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[モノのインデックス作成の管理](https://docs.aws.amazon.com/iot/latest/developerguide/managing-index.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[GetIndexingConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-indexing-configuration.html)」を参照してください。
### `get-job-document`
次のコード例は、`get-job-document` を使用する方法を示しています。
**AWS CLI**
**ジョブのドキュメントを取得するには**
次の `get-job-document` の例では、ID が `example-job-01` のジョブのドキュメントの詳細を表示します。
```
aws iot get-job-document \
--job-id "example-job-01"
```
出力:
```
{
"document": "\n{\n \"operation\":\"customJob\",\n \"otherInfo\":\"someValue\"\n}\n"
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[ジョブ (CLI) の作成と管理](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[GetJobDocument](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-job-document.html)」を参照してください。
### `get-logging-options`
次のコード例は、`get-logging-options` を使用する方法を示しています。
**AWS CLI**
**ログ記録オプションを取得するには**
次の `get-logging-options` の例では、AWS アカウントの現在のログ記録オプションを取得します。
```
aws iot get-logging-options
```
出力:
```
{
"roleArn": "arn:aws:iam::123456789012:role/service-role/iotLoggingRole",
"logLevel": "ERROR"
}
```
詳細については、「*AWS IoT デベロッパーガイド*」のタイトルを参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[GetLoggingOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-logging-options.html)」を参照してください。
### `get-ota-update`
次のコード例は、`get-ota-update` を使用する方法を示しています。
**AWS CLI**
**OTA 更新に関する情報を取得するには**
次の `get-ota-update` の例は、指定された OTA 更新の詳細を表示します。
```
aws iot get-ota-update \
--ota-update-id ota12345
```
出力:
```
{
"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": {
}
}
}
```
詳細については、「*AWS IoT API リファレンス*」の「[GetOTAUpdate](https://docs.aws.amazon.com/iot/latest/apireference/API_GetOTAUpdate.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[GetOtaUpdate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-ota-update.html)」を参照してください。
### `get-percentiles`
次のコード例は、`get-percentiles` を使用する方法を示しています。
**AWS CLI**
**クエリに一致する集計値をパーセンタイルグループにグループ化するには**
次のセットアップスクリプトを使用して、10 個の温度センサーを表す 10 個のモノを作成できます。新しいモノにはそれぞれ 1 つの属性があります。
```
# 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
```
セットアップスクリプトの出力例:
```
{
"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-percentiles` の例では、セットアップスクリプトによって作成された 10 個のセンサーをクエリし、指定されたパーセンタイルグループごとに値を返します。パーセンタイルグループ「10」には、クエリに一致する値の約 10 % に含まれる集計フィールド値が含まれます。次の出力では、\$1"percent": 10.0, "value": 67.7\$1 は、温度値の約 10.0% が 67.7 未満であることを意味します。
```
aws iot get-percentiles \
--aggregation-field "attributes.temperature" \
--query-string "thingName:TempSensor*" \
--percents 10 25 50 75 90
```
出力:
```
{
"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
}
]
}
```
詳細については、「*AWSIoT デベロッパーガイド*」の「[「集計データのクエリ](https://docs.aws.amazon.com/iot/latest/developerguide/index-aggregate.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[GetPercentiles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-percentiles.html)」を参照してください。
### `get-policy-version`
次のコード例は、`get-policy-version` を使用する方法を示しています。
**AWS CLI**
**ポリシーの特定のバージョンに関する情報を取得するには**
次の `get-policy-version` の例では、指定されたポリシーの最初のバージョンに関する情報を取得します。
```
aws iot get-policy \
--policy-name UpdateDeviceCertPolicy
--policy-version-id "1"
```
出力:
```
{
"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"
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[AWS IoT ポリシー](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[GetPolicyVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-policy-version.html)」を参照してください。
### `get-policy`
次のコード例は、`get-policy` を使用する方法を示しています。
**AWS CLI**
**ポリシーのデフォルトバージョンに関する情報を取得するには**
次の `get-policy` の例では、指定されたポリシーのデフォルトバージョンに関する情報を取得します。
```
aws iot get-policy \
--policy-name UpdateDeviceCertPolicy
```
出力:
```
{
"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"
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[AWS IoT ポリシー](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[GetPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-policy.html)」を参照してください。
### `get-registration-code`
次のコード例は、`get-registration-code` を使用する方法を示しています。
**AWS CLI**
**AWS アカウント固有の登録コードを取得するには**
次の `get-registration-code` の例では、AWS アカウント固有の登録コードを取得します。
```
aws iot get-registration-code
```
出力:
```
{
"registrationCode": "15c51ae5e36ba59ba77042df1115862076bea4bd15841c838fcb68d5010a614c"
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[独自の証明書を使用する](https://docs.aws.amazon.com/iot/latest/developerguide/device-certs-your-own.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[GetRegistrationCode](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-registration-code.html)」を参照してください。
### `get-statistics`
次のコード例は、`get-statistics` を使用する方法を示しています。
**AWS CLI**
**集計データのデバイスインデックスを検索するには**
次の `get-statistics` の例では、`connectivity.connected` というプロパティがデバイスシャドウで `false` に設定されているモノの数 (つまり、接続されていないデバイスの数) を返します。
```
aws iot get-statistics \
--index-name AWS_Things \
--query-string "connectivity.connected:false"
```
出力:
```
{
"statistics": {
"count": 6
}
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[デバイスフリートに関する統計の取得](https://docs.aws.amazon.com/iot/latest/developerguide/index-aggregate.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[GetStatistics](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-statistics.html)」を参照してください。
### `get-topic-rule-destination`
次のコード例は、`get-topic-rule-destination` を使用する方法を示しています。
**AWS CLI**
**トピックルールの送信先を取得するには**
次の `get-topic-rule-destination` の例では、トピックルールの送信先に関する情報を取得します。
```
aws iot get-topic-rule-destination \
--arn "arn:aws:iot:us-west-2:123456789012:ruledestination/http/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"
```
出力:
```
{
"topicRuleDestination": {
"arn": "arn:aws:iot:us-west-2:123456789012:ruledestination/http/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
"status": "DISABLED",
"httpUrlProperties": {
"confirmationUrl": "https://example.com"
}
}
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[トピックルールの送信先の操作](https://docs.aws.amazon.com/iot/latest/developerguide/rule-destination.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[GetTopicRuleDestination](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-topic-rule-destination.html)」を参照してください。
### `get-topic-rule`
次のコード例は、`get-topic-rule` を使用する方法を示しています。
**AWS CLI**
**ルールに関する情報を取得するには**
次の `get-topic-rule` の例では、指定されたルールに関する情報を取得します。
```
aws iot get-topic-rule \
--rule-name MyRPiLowMoistureAlertRule
```
出力:
```
{
"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"
}
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[ルールの表示](https://docs.aws.amazon.com/iot/latest/developerguide/iot-managae-rule.html#iot-view-rules)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[GetTopicRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-topic-rule.html)」を参照してください。
### `get-v2-logging-options`
次のコード例は、`get-v2-logging-options` を使用する方法を示しています。
**AWS CLI**
**現在のログ記録オプションを一覧表示するには**
次の `get-v2-logging-options` の例では、AWS IoT の現在のログ記録オプションを一覧表示します。
```
aws iot get-v2-logging-options
```
出力:
```
{
"roleArn": "arn:aws:iam::094249569039:role/service-role/iotLoggingRole",
"defaultLogLevel": "WARN",
"disableAllLogs": false
}
```
詳細については、「*AWS IoT デベロッパーガイド*」のタイトルを参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[GetV2LoggingOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-v2-logging-options.html)」を参照してください。
### `list-active-violations`
次のコード例は、`list-active-violations` を使用する方法を示しています。
**AWS CLI**
**アクティブな違反を一覧表示するには**
次の `list-active-violations` の例では、指定されたセキュリティプロファイルに対するすべての違反を一覧表示します。
```
aws iot list-active-violations \
--security-profile-name Testprofile
```
出力:
```
{
"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
}
]
}
```
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListActiveViolations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-active-violations.html)」を参照してください。
### `list-attached-policies`
次のコード例は、`list-attached-policies` を使用する方法を示しています。
**AWS CLI**
**例 1: グループにアタッチされるポリシーを一覧表示するには**
次の `list-attached-policies` の例では、指定されたグループにアタッチされているポリシーを一覧表示します。
```
aws iot list-attached-policies \
--target "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs"
```
出力:
```
{
"policies": [
{
"policyName": "UpdateDeviceCertPolicy",
"policyArn": "arn:aws:iot:us-west-2:123456789012:policy/UpdateDeviceCertPolicy"
}
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[モノのグループ](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html)」を参照してください。
**例 2: デバイス証明書にアタッチされたポリシーを一覧表示するには**
次の `list-attached-policies` の例では、デバイス証明書にアタッチされた AWS IoT ポリシーを一覧表示します。証明書は ARN によって識別されます。
```
aws iot list-attached-policies \
--target arn:aws:iot:us-west-2:123456789012:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142
```
出力:
```
{
"policies": [
{
"policyName": "TemperatureSensorPolicy",
"policyArn": "arn:aws:iot:us-west-2:123456789012:policy/TemperatureSensorPolicy"
}
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[モノのグループ](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListAttachedPolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-attached-policies.html)」を参照してください。
### `list-audit-findings`
次のコード例は、`list-audit-findings` を使用する方法を示しています。
**AWS CLI**
**例 1: 監査のすべての検出結果を一覧表示するには**
次の `list-audit-findings` の例では、指定されたタスク ID を持つ AWS IoT Device Defender 監査のすべての検出結果を一覧表示します。
```
aws iot list-audit-findings \
--task-id a3aea009955e501a31b764abe1bebd3d
```
出力:
```
{
"findings": []
}
```
**例 2: 監査チェックタイプの検出結果を一覧表示するには**
次の `list-audit-findings` の例では、デバイスがデバイス証明書を共有している 2019 年 6 月 5 日から 2019 年 6 月 19 日の間に実行された AWS IoT Device Defender 監査の検出結果を示しています。チェック名を指定するときは、開始時刻と終了時刻を指定する必要があります。
```
aws iot list-audit-findings \
--check-name DEVICE_CERTIFICATE_SHARED_CHECK \
--start-time 1559747125 \
--end-time 1560962028
```
出力:
```
{
"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"
}
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[Audit コマンド](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListAuditFindings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-audit-findings.html)」を参照してください。
### `list-audit-mitigation-actions-executions`
次のコード例は、`list-audit-mitigation-actions-executions` を使用する方法を示しています。
**AWS CLI**
**監査緩和アクションの実行の詳細を一覧表示するには**
監査緩和アクションタスクは、AWS IoT Device Defender 監査からの 1 つまたは複数の検出結果に緩和アクションを適用します。次の `list-audit-mitigation-actions-executions` の例では、指定された `taskId` と指定された検出結果の緩和アクションタスクの詳細を一覧表示します。
```
aws iot list-audit-mitigation-actions-executions \
--task-id myActionsTaskId \
--finding-id 0edbaaec-2fe1-4cf5-abc9-d4c3e51f7464
```
出力:
```
{
"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"
}
]
}
```
詳細については、「*AWSIoT デベロッパーガイド*」の「[ListAuditMitigationActionsExecutions (緩和アクションコマンド)](https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-ListAuditMitigationActionsExecutions)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListAuditMitigationActionsExecutions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-audit-mitigation-actions-executions.html)」を参照してください。
### `list-audit-mitigation-actions-tasks`
次のコード例は、`list-audit-mitigation-actions-tasks` を使用する方法を示しています。
**AWS CLI**
**監査緩和アクションタスクを一覧表示するには**
次の `list-audit-mitigation-actions-tasks` の例では、指定された期間内に検出結果に適用された緩和アクションを一覧表示します。
```
aws iot list-audit-mitigation-actions-tasks \
--start-time 1594157400 \
--end-time 1594157430
```
出力:
```
{
"tasks": [
{
"taskId": "0062f2d6-3999-488f-88c7-bef005414103",
"startTime": "2020-07-07T14:30:15.172000-07:00",
"taskStatus": "COMPLETED"
}
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[ListAuditMitigationActionsTasks (緩和アクションコマンド)](https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-ListAuditMitigationActionsTasks)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListAuditMitigationActionsTasks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-audit-mitigation-actions-tasks.html)」を参照してください。
### `list-audit-suppressions`
次のコード例は、`list-audit-suppressions` を使用する方法を示しています。
**AWS CLI**
**すべての監査検出結果の抑制を一覧表示するには**
次の `list-audit-suppressions` の例では、アクティブな監査検出結果の抑制をすべて一覧表示します。
```
aws iot list-audit-suppressions
```
出力:
```
{
"suppressions": [
{
"checkName": "DEVICE_CERTIFICATE_EXPIRING_CHECK",
"resourceIdentifier": {
"deviceCertificateId": "c7691e"
},
"expirationDate": 1597881600.0,
"suppressIndefinitely": false
}
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[監査の検出結果の抑制](https://docs.aws.amazon.com/iot/latest/developerguide/audit-finding-suppressions.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListAuditSuppressions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-audit-suppressions.html)」を参照してください。
### `list-audit-tasks`
次のコード例は、`list-audit-tasks` を使用する方法を示しています。
**AWS CLI**
**監査からのすべての検出結果を一覧表示するには**
次の `list-audit-tasks` の例では、2019 年 6 月 5 日から 2019 年 6 月 12 日の間に実行された監査タスクを一覧表示します。
```
aws iot list-audit-tasks \
--start-time 1559747125 \
--end-time 1560357228
```
出力:
```
{
"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"
}
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[Audit コマンド](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListAuditTasks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-audit-tasks.html)」を参照してください。
### `list-authorizers`
次のコード例は、`list-authorizers` を使用する方法を示しています。
**AWS CLI**
**カスタムオーソライザーを一覧表示するには**
次の `list-authorizers` の例では、AWS アカウントのカスタムオーソライザーを一覧表示します。
```
aws iot list-authorizers
```
出力:
```
{
"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"
}
]
}
```
詳細については、「*AWS IoT API リファレンス*」の「[ListAuthorizers](https://docs.aws.amazon.com/iot/latest/apireference/API_ListAuthorizers.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListAuthorizers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-authorizers.html)」を参照してください。
### `list-billing-groups`
次のコード例は、`list-billing-groups` を使用する方法を示しています。
**AWS CLI**
**AWS アカウントとリージョンの請求グループを一覧表示するには**
次の `list-billing-groups` の例では、AWS アカウントと AWS リージョンに定義されているすべての請求グループを一覧表示します。
```
aws iot list-billing-groups
```
出力:
```
{
"billingGroups": [
{
"groupName": "GroupOne",
"groupArn": "arn:aws:iot:us-west-2:123456789012:billinggroup/GroupOne"
}
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[請求グループ](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot-billing-groups.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListBillingGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-billing-groups.html)」を参照してください。
### `list-ca-certificates`
次のコード例は、`list-ca-certificates` を使用する方法を示しています。
**AWS CLI**
**AWS アカウントに登録済みの CA 証明書を一覧表示するには**
次の `list-ca-certificates` の例では、AWS アカウントに登録されている CA 証明書を一覧表示します。
```
aws iot list-ca-certificates
```
出力:
```
{
"certificates": [
{
"certificateArn": "arn:aws:iot:us-west-2:123456789012:cacert/f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467",
"certificateId": "f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467",
"status": "INACTIVE",
"creationDate": 1569365372.053
}
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[独自の証明書を使用する](https://docs.aws.amazon.com/iot/latest/developerguide/device-certs-your-own.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListCaCertificates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-ca-certificates.html)」を参照してください。
### `list-certificates-by-ca`
次のコード例は、`list-certificates-by-ca` を使用する方法を示しています。
**AWS CLI**
**CA 証明書で署名されたすべてのデバイス証明書を一覧表示するには**
次の `list-certificates-by-ca` の例では、指定された CA 証明書で署名された AWS アカウント内のすべてのデバイス証明書を一覧表示します。
```
aws iot list-certificates-by-ca \
--ca-certificate-id f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467
```
出力:
```
{
"certificates": [
{
"certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142",
"certificateId": "488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142",
"status": "ACTIVE",
"creationDate": 1569363250.557
}
]
}
```
詳細については、「*AWS IoT API リファレンス*」の「[ListCertificatesByCA](https://docs.aws.amazon.com/iot/latest/apireference/API_ListCertificatesByCA.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListCertificatesByCa](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-certificates-by-ca.html)」を参照してください。
### `list-certificates`
次のコード例は、`list-certificates` を使用する方法を示しています。
**AWS CLI**
**例 1: AWS アカウントに登録済みの証明書を一覧表示するには**
次の `list-certificates` 例では、アカウントに登録されているすべての証明書を一覧表示します。デフォルトのページング制限数が 25 を超える場合は、このコマンドの `nextMarker` レスポンス値を使用して次のコマンドに指定し、結果の次のバッチを取得できます。`nextMarker` が値なしで返すまで繰り返します。
```
aws iot list-certificates
```
出力:
```
{
"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
}
]
}
```
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListCertificates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-certificates.html)」を参照してください。
### `list-custom-metrics`
次のコード例は、`list-custom-metrics` を使用する方法を示しています。
**AWS CLI**
**カスタムメトリクスを一覧表示するには**
以下の `list-custom-metrics` 例では、すべてのカスタムメトリクスをリストアップします。
```
aws iot list-custom-metrics \
--region us-east-1
```
出力:
```
{
"metricNames": [
"batteryPercentage"
]
}
```
詳細については、「*AWS IoT Core デベロッパーガイド*」の「[カスタムメトリクス](https://docs.aws.amazon.com/iot/latest/developerguide/dd-detect-custom-metrics.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListCustomMetrics](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-custom-metrics.html)」を参照してください。
### `list-dimensions`
次のコード例は、`list-dimensions` を使用する方法を示しています。
**AWS CLI**
**AWS アカウントのディメンションを一覧表示するには**
次の `list-dimensions` の例では、AWS アカウントで定義されているすべての AWS IoT Device Defender ディメンションを一覧表示します。
```
aws iot list-dimensions
```
出力:
```
{
"dimensionNames": [
"TopicFilterForAuthMessages",
"TopicFilterForActivityMessages"
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[Detect コマンド](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListDimensions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-dimensions.html)」を参照してください。
### `list-domain-configurations`
次のコード例は、`list-domain-configurations` を使用する方法を示しています。
**AWS CLI**
**ドメイン設定を一覧表示するには**
次の `list-domain-configurations` の例では、指定されたサービスタイプを持つ AWS アカウントのドメイン設定を一覧表示します。
```
aws iot list-domain-configurations \
--service-type "DATA"
```
出力:
```
{
"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"
}
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[設定可能なエンドポイント](https://docs.aws.amazon.com/iot/latest/developerguide/iot-custom-endpoints-configurable-aws.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListDomainConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-domain-configurations.html)」を参照してください。
### `list-indices`
次のコード例は、`list-indices` を使用する方法を示しています。
**AWS CLI**
**設定された検索インデックスを一覧表示するには**
次の `list-indices` の例では、AWS アカウントで設定されたすべての検索インデックスを一覧表示します。モノのインデックス作成を有効にしていない場合は、インデックスがない可能性があります。
```
aws iot list-indices
```
出力:
```
{
"indexNames": [
"AWS_Things"
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[モノのインデックス作成の管理](https://docs.aws.amazon.com/iot/latest/developerguide/managing-index.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListIndices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-indices.html)」を参照してください。
### `list-job-executions-for-job`
次のコード例は、`list-job-executions-for-job` を使用する方法を示しています。
**AWS CLI**
**AWS アカウントのジョブを一覧表示するには**
次の `list-job-executions-for-job` の例では、jobId で指定された AWS アカウント内のジョブのすべてのジョブ実行を一覧表示します。
```
aws iot list-job-executions-for-job \
--job-id my-ota-job
```
出力:
```
{
"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
}
}
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[ジョブ (CLI) の作成と管理](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListJobExecutionsForJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-job-executions-for-job.html)」を参照してください。
### `list-job-executions-for-thing`
次のコード例は、`list-job-executions-for-thing` を使用する方法を示しています。
**AWS CLI**
**モノに対して実行されたジョブを一覧表示するには**
次の `list-job-executions-for-thing` の例では、`MyRaspberryPi` という名前のモノに対して実行されたすべてのジョブを一覧表示します。
```
aws iot list-job-executions-for-thing \
--thing-name "MyRaspberryPi"
```
出力:
```
{
"executionSummaries": [
{
"jobId": "example-job-01",
"jobExecutionSummary": {
"status": "QUEUED",
"queuedAt": 1560787023.636,
"lastUpdatedAt": 1560787023.636,
"executionNumber": 1
}
}
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[ジョブ (CLI) の作成と管理](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListJobExecutionsForThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-job-executions-for-thing.html)」を参照してください。
### `list-jobs`
次のコード例は、`list-jobs` を使用する方法を示しています。
**AWS CLI**
**AWS アカウントのジョブを一覧表示するには**
次の `list-jobs` の例では、ジョブステータスでソートされた AWS アカウント内のすべてのジョブを一覧表示します。
```
aws iot list-jobs
```
出力:
```
{
"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
}
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[ジョブ (CLI) の作成と管理](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-jobs.html)」を参照してください。
### `list-mitigation-actions`
次のコード例は、`list-mitigation-actions` を使用する方法を示しています。
**AWS CLI**
**定義されたすべての緩和アクションを一覧表示するには**
次の `list-mitigation-actions` の例では、リージョンの AWS アカウントに対して定義されたすべての緩和アクションを一覧表示します。アクションごとに、名前、ARN、作成日が一覧表示されます。
```
aws iot list-mitigation-actions
```
出力:
```
{
"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"
}
]
}
```
詳細については、「*AWSIoT デベロッパーガイド*」の「[ListMitigationActions (緩和アクションコマンド)](https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-ListMitigationActions)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListMitigationActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-mitigation-actions.html)」を参照してください。
### `list-mitigations-actions`
次のコード例は、`list-mitigations-actions` を使用する方法を示しています。
**AWS CLI**
**定義されたすべての緩和アクションを一覧表示するには**
次の `list-mitigations-actions` の例では、リージョンの AWS アカウントに対して定義されたすべての緩和アクションを一覧表示します。アクションごとに、名前、ARN、作成日が一覧表示されます。
```
aws iot list-mitigation-actions
```
出力:
```
{
"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"
}
]
}
```
詳細については、「*AWSIoT デベロッパーガイド*」の「[ListMitigationActions (緩和アクションコマンド)](https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-ListMitigationActions)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListMitigationsActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-mitigations-actions.html)」を参照してください。
### `list-ota-updates`
次のコード例は、`list-ota-updates` を使用する方法を示しています。
**AWS CLI**
**アカウントの OTA 更新を一覧表示するには**
次の `list-ota-updates` の例では、使用可能な OTA 更新を一覧表示します。
```
aws iot list-ota-updates
```
出力:
```
{
"otaUpdates": [
{
"otaUpdateId": "itsaupdate",
"otaUpdateArn": "arn:aws:iot:us-west-2:123456789012:otaupdate/itsaupdate",
"creationDate": 1557863215.995
}
]
}
```
詳細については、「*AWS IoT API リファレンス*」の「[ListOTAUpdates](https://docs.aws.amazon.com/iot/latest/apireference/API_ListOTAUpdates.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListOtaUpdates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-ota-updates.html)」を参照してください。
### `list-outgoing-certificates`
次のコード例は、`list-outgoing-certificates` を使用する方法を示しています。
**AWS CLI**
**別の AWS アカウントに転送される証明書を一覧表示するには**
次の `list-outgoing-certificates` の例では、`transfer-certificate` コマンドを使用して別の AWS アカウントに転送されているすべてのデバイス証明書を一覧表示します。
```
aws iot list-outgoing-certificates
```
出力:
```
{
"outgoingCertificates": [
{
"certificateArn": "arn:aws:iot:us-west-2:030714055129:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142",
"certificateId": "488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142",
"transferredTo": "030714055129",
"transferDate": 1569427780.441,
"creationDate": 1569363250.557
}
]
}
```
詳細については、「*AWS IoT API リファレンス*」の「[ListOutgoingCertificates](https://docs.aws.amazon.com/iot/latest/apireference/API_ListOutgoingCertificates.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListOutgoingCertificates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-outgoing-certificates.html)」を参照してください。
### `list-policies`
次のコード例は、`list-policies` を使用する方法を示しています。
**AWS CLI**
**AWS アカウントで定義されているポリシーを一覧表示するには**
次の `list-policies` の例では、AWS アカウントで定義されているすべてのポリシーを一覧表示します。
```
aws iot list-policies
```
出力:
```
{
"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"
}
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[AWS IoT ポリシー](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html)」を参照してください。
+ API の詳細については、「AWS CLI Command Reference」の「[ListPolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-policies.html)」を参照してください。**
### `list-policy-versions`
次のコード例は、`list-policy-versions` を使用する方法を示しています。
**AWS CLI**
**例 1: ポリシーのすべてのバージョンを表示するには**
次の `list-policy-versions` の例では、指定されたポリシーのすべてのバージョンとその作成日を一覧表示します。
```
aws iot list-policy-versions \
--policy-name LightBulbPolicy
```
出力:
```
{
"policyVersions": [
{
"versionId": "2",
"isDefaultVersion": true,
"createDate": 1559925941.924
},
{
"versionId": "1",
"isDefaultVersion": false,
"createDate": 1559925941.924
}
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[AWS IoT ポリシー](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListPolicyVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-policy-versions.html)」を参照してください。
### `list-principal-things`
次のコード例は、`list-principal-things` を使用する方法を示しています。
**AWS CLI**
**プリンシパルにアタッチされたモノを一覧表示するには**
次の `list-principal-things` の例では、ARN によって指定されたプリンシパルにアタッチされたモノを一覧表示します。
```
aws iot list-principal-things \
--principal arn:aws:iot:us-west-2:123456789012:cert/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8
```
出力:
```
{
"things": [
"DeskLamp",
"TableLamp"
]
}
```
詳細については、「*AWS IoT API リファレンス*」の「[ListPrincipalThings](https://docs.aws.amazon.com/iot/latest/apireference/API_ListPrincipleThings.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListPrincipalThings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-principal-things.html)」を参照してください。
### `list-provisioning-template-versions`
次のコード例は、`list-provisioning-template-versions` を使用する方法を示しています。
**AWS CLI**
**プロビジョニングテンプレートのバージョンを一覧表示するには**
次の `list-provisioning-template-versions` の例では、指定されたプロビジョニングテンプレートの使用可能なバージョンを一覧表示します。
```
aws iot list-provisioning-template-versions \
--template-name "widget-template"
```
出力:
```
{
"versions": [
{
"versionId": 1,
"creationDate": 1574800471.339,
"isDefaultVersion": true
},
{
"versionId": 2,
"creationDate": 1574801192.317,
"isDefaultVersion": false
}
]
}
```
詳細については、「*AWS IoT Core デベロッパーガイド*」の「[AWS セキュアトンネリング](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListProvisioningTemplateVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-provisioning-template-versions.html)」を参照してください。
### `list-provisioning-templates`
次のコード例は、`list-provisioning-templates` を使用する方法を示しています。
**AWS CLI**
**プロビジョニングテンプレートを一覧表示するには**
次の `list-provisioning-templates` の例では、AWS アカウント内のすべてのプロビジョニングテンプレートを一覧表示します。
```
aws iot list-provisioning-templates
```
出力:
```
{
"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
}
]
}
```
詳細については、「*AWS IoT Core デベロッパーガイド*」の「[AWS セキュアトンネリング](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListProvisioningTemplates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-provisioning-templates.html)」を参照してください。
### `list-role-aliases`
次のコード例は、`list-role-aliases` を使用する方法を示しています。
**AWS CLI**
**AWS アカウントの AWS IoT ロールエイリアスを一覧表示するには**
次の `list-role-aliases` 例では、AWS アカウントの AWS IoT ロールエイリアスを一覧表示します。
```
aws iot list-role-aliases
```
出力:
```
{
"roleAliases": [
"ResidentAlias",
"ElectricianAlias"
]
}
```
詳細については、「*AWS IoT API リファレンス*」の「[ListRoleAliases](https://docs.aws.amazon.com/iot/latest/apireference/API_ListRoleAliases.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListRoleAliases](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-role-aliases.html)」を参照してください。
### `list-scheduled-audits`
次のコード例は、`list-scheduled-audits` を使用する方法を示しています。
**AWS CLI**
**AWS アカウントのスケジュールされた監査を一覧表示するには**
次の `list-scheduled-audits` の例では、AWS アカウントにスケジュールされた監査を一覧表示します。
```
aws iot list-scheduled-audits
```
出力:
```
{
"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"
}
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[Audit コマンド](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListScheduledAudits](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-scheduled-audits.html)」を参照してください。
### `list-security-profiles-for-target`
次のコード例は、`list-security-profiles-for-target` を使用する方法を示しています。
**AWS CLI**
**ターゲットにアタッチされたセキュリティプロファイルを一覧表示するには**
次の `list-security-profiles-for-target` の例では、未登録のデバイスにアタッチされている AWS IoT Device Defender セキュリティプロファイルを一覧表示します。
```
aws iot list-security-profiles-for-target \
--security-profile-target-arn "arn:aws:iot:us-west-2:123456789012:all/unregistered-things"
```
出力:
```
{
"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"
}
}
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[Detect コマンド](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListSecurityProfilesForTarget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-security-profiles-for-target.html)」を参照してください。
### `list-security-profiles`
次のコード例は、`list-security-profiles` を使用する方法を示しています。
**AWS CLI**
**AWS アカウントのセキュリティプロファイルを一覧表示するには**
次の `list-security-profiles` の例では、AWS アカウントで定義されているすべての AWS IoT Device Defender セキュリティプロファイルを一覧表示します。
```
aws iot list-security-profiles
```
出力:
```
{
"securityProfileIdentifiers": [
{
"name": "Testprofile",
"arn": "arn:aws:iot:us-west-2:123456789012:securityprofile/Testprofile"
}
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[Detect コマンド](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListSecurityProfiles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-security-profiles.html)」を参照してください。
### `list-streams`
次のコード例は、`list-streams` を使用する方法を示しています。
**AWS CLI**
**アカウントのストリームを一覧表示するには**
次の `list-streams` の例では、AWS アカウント内のすべてのストリームを一覧表示します。
```
aws iot list-streams
```
出力:
```
{
"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."
}
]
}
```
詳細については、「*AWS IoT API リファレンス*」の「[ListStreams](https://docs.aws.amazon.com/iot/latest/apireference/API_ListStreams.html)」を参照してください。
+ API の詳細については、AWS CLI コマンドリファレンスの「[ListStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-streams.html)」を参照してください。**
### `list-tags-for-resource`
次のコード例は、`list-tags-for-resource` を使用する方法を示しています。
**AWS CLI**
**リソースに関連付けられたタグとその値を表示するには**
次の `list-tags-for-resource` の例では、モノのグループ `LightBulbs` に関連付けられたタグと値を表示します。
```
aws iot list-tags-for-resource \
--resource-arn "arn:aws:iot:us-west-2:094249569039:thinggroup/LightBulbs"
```
出力:
```
{
"tags": [
{
"Key": "Assembly",
"Value": "Fact1NW"
},
{
"Key": "MyTag",
"Value": "777"
}
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[AWS IoT リソースのタグ付け](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-tags-for-resource.html)」を参照してください。
### `list-targets-for-policy`
次のコード例は、`list-targets-for-policy` を使用する方法を示しています。
**AWS CLI**
**AWS IoT ポリシーに関連付けられているプリンシパルを一覧表示するには**
次の `list-targets-for-policy` の例では、指定されたポリシーがアタッチされているデバイス証明書を一覧表示します。
```
aws iot list-targets-for-policy \
--policy-name UpdateDeviceCertPolicy
```
出力:
```
{
"targets": [
"arn:aws:iot:us-west-2:123456789012:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142",
"arn:aws:iot:us-west-2:123456789012:cert/d1eb269fb55a628552143c8f96eb3c258fcd5331ea113e766ba0c82bf225f0be"
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[モノのグループ](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListTargetsForPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-targets-for-policy.html)」を参照してください。
### `list-targets-for-security-profile`
次のコード例は、`list-targets-for-security-profile` を使用する方法を示しています。
**AWS CLI**
**セキュリティプロファイルが適用されるターゲットを一覧表示するには**
次の `list-targets-for-security-profile` の例では、`PossibleIssue` という名前の AWS IoT Device Defender セキュリティプロファイルが適用されるターゲットを一覧表示します。
```
aws iot list-targets-for-security-profile \
--security-profile-name Testprofile
```
出力:
```
{
"securityProfileTargets": [
{
"arn": "arn:aws:iot:us-west-2:123456789012:all/unregistered-things"
},
{
"arn": "arn:aws:iot:us-west-2:123456789012:all/registered-things"
}
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[Detect コマンド](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListTargetsForSecurityProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-targets-for-security-profile.html)」を参照してください。
### `list-thing-groups-for-thing`
次のコード例は、`list-thing-groups-for-thing` を使用する方法を示しています。
**AWS CLI**
**モノが属するモノのグループを一覧表示するには**
次の `list-thing-groups-for-thing` の例では、指定されたモノが属するグループを一覧表示します。
```
aws iot list-thing-groups-for-thing \
--thing-name MyLightBulb
```
出力:
```
{
"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"
}
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[モノのグループ](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListThingGroupsForThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-thing-groups-for-thing.html)」を参照してください。
### `list-thing-groups`
次のコード例は、`list-thing-groups` を使用する方法を示しています。
**AWS CLI**
**AWS アカウントで定義されたモノのグループを一覧表示するには**
次の `describe-thing-group` の例では、AWS アカウントで定義されているすべてのモノのグループを一覧表示します。
```
aws iot list-thing-groups
```
出力:
```
{
"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"
}
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[モノのグループ](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListThingGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-thing-groups.html)」を参照してください。
### `list-thing-principals`
次のコード例は、`list-thing-principals` を使用する方法を示しています。
**AWS CLI**
**モノに関連付けられているプリンシパルを一覧表示するには**
次の `list-thing-principals` の例では、指定されたモノに関連付けられているプリンシパル (X.509 証明書、IAM ユーザー、グループ、ロール、Amazon Cognito ID、またはフェデレーティッド ID) を一覧表示します。
```
aws iot list-thing-principals \
--thing-name MyRaspberryPi
```
出力:
```
{
"principals": [
"arn:aws:iot:us-west-2:123456789012:cert/33475ac865079a5ffd5ecd44240640349293facc760642d7d8d5dbb6b4c86893"
]
}
```
詳細については、「*AWS IoT API リファレンス*」の「[ListThingPrincipals](https://docs.aws.amazon.com/iot/latest/apireference/API_ListThingPrincipals.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListThingPrincipals](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-thing-principals.html)」を参照してください。
### `list-thing-types`
次のコード例は、`list-thing-types` を使用する方法を示しています。
**AWS CLI**
**定義されたモノのタイプを一覧表示するには**
次の `list-thing-types` の例では、AWS アカウントで定義されているモノのタイプのリストを表示します。
```
aws iot list-thing-types
```
出力:
```
{
"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
}
}
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」「[モノのタイプ](https://docs.aws.amazon.com/iot/latest/developerguide/thing-types.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListThingTypes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-thing-types.html)」を参照してください。
### `list-things-in-billing-group`
次のコード例は、`list-things-in-billing-group` を使用する方法を示しています。
**AWS CLI**
**請求グループ内のモノを一覧表示するには**
次の `list-things-in-billing-group` の例では、指定された請求グループにあるモノを一覧表示します。
```
aws iot list-things-in-billing-group \
--billing-group-name GroupOne
```
出力:
```
{
"things": [
"MyOtherLightBulb",
"MyLightBulb"
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[請求グループ](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot-billing-groups.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListThingsInBillingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-things-in-billing-group.html)」を参照してください。
### `list-things-in-thing-group`
次のコード例は、`list-things-in-thing-group` を使用する方法を示しています。
**AWS CLI**
**グループに属するモノを一覧表示するには**
次の `list-things-in-thing-group` の例では、指定されたモノのグループに属するモノを一覧表示します。
```
aws iot list-things-in-thing-group \
--thing-group-name LightBulbs
```
出力:
```
{
"things": [
"MyLightBulb"
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[モノのグループ](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListThingsInThingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-things-in-thing-group.html)」を参照してください。
### `list-things`
次のコード例は、`list-things` を使用する方法を示しています。
**AWS CLI**
**例 1: レジストリ内のすべてのモノを一覧表示するには**
次の `list-things` の例は、AWS アカウント内の AWS IoT レジストリで定義されているモノ (デバイス) を一覧表示します。
```
aws iot list-things
```
出力:
```
{
"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
}
]
}
```
**例 2: 特定の属性を持つ定義済みのモノを一覧表示するには**
次の `list-things` の例は、`wattage` という名前の属性を持つモノのリストを表示します。
```
aws iot list-things \
--attribute-name wattage
```
出力:
```
{
"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
}
]
}
```
詳細については、「AWS IoT ディベロッパーガイド」の「[レジストリによるモノの管理方法](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html)」を参照してください。**
+ API の詳細については、AWS CLI コマンドリファレンスの「[ListThings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-things.html)」を参照してください。**
### `list-topic-rule-destinations`
次のコード例は、`list-topic-rule-destinations` を使用する方法を示しています。
**AWS CLI**
**トピックルールの送信先を一覧表示するには**
次の `list-topic-rule-destinations` の例では、現在の AWS リージョンで定義したすべてのトピックルールの送信先を一覧表示します。
```
aws iot list-topic-rule-destinations
```
出力:
```
{
"destinationSummaries": [
{
"arn": "arn:aws:iot:us-west-2:123456789012:ruledestination/http/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
"status": "ENABLED",
"httpUrlSummary": {
"confirmationUrl": "https://example.com"
}
}
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[トピックルールの送信先の操作](https://docs.aws.amazon.com/iot/latest/developerguide/rule-destination.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListTopicRuleDestinations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-topic-rule-destinations.html)」を参照してください。
### `list-topic-rules`
次のコード例は、`list-topic-rules` を使用する方法を示しています。
**AWS CLI**
**ルールを一覧表示するには**
次の `list-topic-rules` の例では、定義したすべてのルールを一覧表示します。
```
aws iot list-topic-rules
```
出力:
```
{
"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
}
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[ルールの表示](https://docs.aws.amazon.com/iot/latest/developerguide/iot-managae-rule.html#iot-view-rules)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListTopicRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-topic-rules.html)」を参照してください。
### `list-v2-logging-levels`
次のコード例は、`list-v2-logging-levels` を使用する方法を示しています。
**AWS CLI**
**ログ記録レベルを一覧表示するには**
次の `list-v2-logging-levels` の例では、設定されたログ記録レベルを一覧表示します。ログ記録レベルが設定されていない場合、このコマンドを実行すると `NotConfiguredException` が発生します。
```
aws iot list-v2-logging-levels
```
出力:
```
{
"logTargetConfigurations": [
{
"logTarget": {
"targetType": "DEFAULT"
},
"logLevel": "ERROR"
}
]
}
```
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListV2LoggingLevels](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-v2-logging-levels.html)」を参照してください。
### `list-violation-events`
次のコード例は、`list-violation-events` を使用する方法を示しています。
**AWS CLI**
**期間中のセキュリティプロファイル違反を一覧表示するには**
次の `list-violation-events` の例では、現在の AWS アカウントと AWS リージョンのすべての AWS IoT Device Defender セキュリティプロファイルについて、2019 年 6 月 5 日から 6 月 12 日の間に発生した違反を一覧表示します。
```
aws iot list-violation-events \
--start-time 1559747125 \
--end-time 1560351925
```
出力:
```
{
"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
}
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[Detect コマンド](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListViolationEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-violation-events.html)」を参照してください。
### `register-ca-certificate`
次のコード例は、`register-ca-certificate` を使用する方法を示しています。
**AWS CLI**
**認証局 (CA) 証明書を登録するには**
次の `register-ca-certificate` の例では、CA 証明書を登録します。このコマンドは、CA 証明書と、CA 証明書に関連付けられたプライベートキーを所有していることを証明するキー検証証明書を提供します。
```
aws iot register-ca-certificate \
--ca-certificate file://rootCA.pem \
--verification-cert file://verificationCert.pem
```
出力:
```
{
"certificateArn": "arn:aws:iot:us-west-2:123456789012:cacert/f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467",
"certificateId": "f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467"
}
```
詳細については、「*AWS IoT API リファレンス*」の「[RegisterCACertificate](https://docs.aws.amazon.com/iot/latest/apireference/API_RegisterCACertificate.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[RegisterCaCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/register-ca-certificate.html)」を参照してください。
### `register-certificate`
次のコード例は、`register-certificate` を使用する方法を示しています。
**AWS CLI**
**自己署名デバイス証明書を登録するには**
次の `register-certificate` の例では、`rootCA.pem` CA 証明書によって署名された `deviceCert.pem` デバイス証明書を登録します。CA 証明書は、自己署名デバイス証明書の登録に使用する前に登録する必要があります。自己署名証明書は、このコマンドに渡すのと同じ CA 証明書で署名する必要があります。
```
aws iot register-certificate \
--certificate-pem file://deviceCert.pem \
--ca-certificate-pem file://rootCA.pem
```
出力:
```
{
"certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142",
"certificateId": "488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142"
}
```
詳細については、「*AWS IoT API リファレンス*」の「[RegisterCertificate](https://docs.aws.amazon.com/iot/latest/apireference/API_RegisterCertificate.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[RegisterCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/register-certificate.html)」を参照してください。
### `register-thing`
次のコード例は、`register-thing` を使用する方法を示しています。
**AWS CLI**
**モノを登録するには**
次の `register-thing` の例では、プロビジョニングテンプレートを使用してモノを登録します。
```
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"}'
```
出力:
```
{
"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"
}
}
```
詳細については、「*AWS IoT Core デベロッパーガイド*」の「[信頼できるユーザーによるプロビジョニング](https://docs.aws.amazon.com/iot/latest/developerguide/provision-wo-cert.html#trusted-user)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[RegisterThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/register-thing.html)」を参照してください。
### `reject-certificate-transfer`
次のコード例は、`reject-certificate-transfer` を使用する方法を示しています。
**AWS CLI**
**証明書の転送を拒否するには**
次の `reject-certificate-transfer` の例では、別の AWS アカウントからの指定されたデバイス証明書の転送を拒否します。
```
aws iot reject-certificate-transfer \
--certificate-id f0f33678c7c9a046e5cc87b2b1a58dfa0beec26db78addd5e605d630e05c7fc8
```
このコマンドでは何も出力されません。
詳細については、「*AWSIoT Core デベロッパーガイド*」の「[証明書を別のアカウントに転送する](https://docs.aws.amazon.com/iot/latest/developerguide/transfer-cert.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[RejectCertificateTransfer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/reject-certificate-transfer.html)」を参照してください。
### `remove-thing-from-billing-group`
次のコード例は、`remove-thing-from-billing-group` を使用する方法を示しています。
**AWS CLI**
**請求グループからモノを削除するには**
次の `remove-thing-from-billing-group` の例では、請求グループから指定されたモノを削除します。
```
aws iot remove-thing-from-billing-group \
--billing-group-name GroupOne \
--thing-name MyOtherLightBulb
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[請求グループ](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot-billing-groups.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[RemoveThingFromBillingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/remove-thing-from-billing-group.html)」を参照してください。
### `remove-thing-from-thing-group`
次のコード例は、`remove-thing-from-thing-group` を使用する方法を示しています。
**AWS CLI**
**モノのグループからモノを削除するには**
次の `remove-thing-from-thing-group` 例では、モノのグループから指定されたモノを削除します。
```
aws iot remove-thing-from-thing-group \
--thing-name bulb7 \
--thing-group-name DeadBulbs
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「モノのグループ 」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[RemoveThingFromThingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/remove-thing-from-thing-group.html)」を参照してください。
### `replace-topic-rule`
次のコード例は、`replace-topic-rule` を使用する方法を示しています。
**AWS CLI**
**トピックのルール定義を更新するには**
次の `replace-topic-rule` の例では、土壌湿度レベルの読み取り値が低すぎると、指定されたルールを更新して SNS アラートを送信します。
```
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\"}"
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[AWS IoT ルールの作成](https://docs.aws.amazon.com/iot/latest/developerguide/iot-create-rule.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ReplaceTopicRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/replace-topic-rule.html)」を参照してください。
### `search-index`
次のコード例は、`search-index` を使用する方法を示しています。
**AWS CLI**
**モノのインデックスをクエリするには**
次の `search-index` 例では、`LightBulb` タイプを持つモノについて `AWS_Things` インデックスをクエリします。
```
aws iot search-index \
--index-name "AWS_Things" \
--query-string "thingTypeName:LightBulb"
```
出力:
```
{
"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
}
}
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[モノのインデックス作成の管理](https://docs.aws.amazon.com/iot/latest/developerguide/managing-index.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[SearchIndex](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/search-index.html)」を参照してください。
### `set-default-authorizer`
次のコード例は、`set-default-authorizer` を使用する方法を示しています。
**AWS CLI**
**デフォルトのオーソライザーを設定するには**
次の `set-default-authorizer` の例では、`CustomAuthorizer` という名前のカスタムオーソライザーをデフォルトのオーソライザーとして設定します。
```
aws iot set-default-authorizer \
--authorizer-name CustomAuthorizer
```
出力:
```
{
"authorizerName": "CustomAuthorizer",
"authorizerArn": "arn:aws:iot:us-west-2:123456789012:authorizer/CustomAuthorizer"
}
```
詳細については、「*AWS IoT API リファレンス*」の「[CreateDefaultAuthorizer](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateDefaultAuthorizer.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[SetDefaultAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/set-default-authorizer.html)」を参照してください。
### `set-default-policy-version`
次のコード例は、`set-default-policy-version` を使用する方法を示しています。
**AWS CLI**
**ポリシーのデフォルトバージョンを設定するには**
次の `set-default-policy-version` の例では、`UpdateDeviceCertPolicy` という名前のポリシーのデフォルトバージョンを `2` に設定します。
```
aws iot set-default-policy-version \
--policy-name UpdateDeviceCertPolicy \
--policy-version-id 2
```
このコマンドでは何も出力されません。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[SetDefaultPolicyVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/set-default-policy-version.html)」を参照してください。
### `set-v2-logging-level`
次のコード例は、`set-v2-logging-level` を使用する方法を示しています。
**AWS CLI**
**モノのグループのログ記録レベルを設定するには**
次の `set-v2-logging-level` の例では、指定されたモノのグループの警告をログに記録するようにログ記録レベルを設定します。
```
aws iot set-v2-logging-level \
--log-target "{\"targetType\":\"THING_GROUP\",\"targetName\":\"LightBulbs\"}" \
--log-level WARN
```
このコマンドでは何も出力されません。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[SetV2LoggingLevel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/set-v2-logging-level.html)」を参照してください。
### `set-v2-logging-options`
次のコード例は、`set-v2-logging-options` を使用する方法を示しています。
**AWS CLI**
**ログ記録オプションを設定するには**
次の `set-v2-logging-options` の例では、デフォルトのログ詳細レベルを ERROR に設定し、ログ記録に使用する ARN を指定します。
```
aws iot set-v2-logging-options \
--default-log-level ERROR \
--role-arn "arn:aws:iam::094249569039:role/service-role/iotLoggingRole"
```
このコマンドでは何も出力されません。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[SetV2LoggingOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/set-v2-logging-options.html)」を参照してください。
### `start-audit-mitigation-actions-task`
次のコード例は、`start-audit-mitigation-actions-task` を使用する方法を示しています。
**AWS CLI**
**監査検出結果に緩和アクションを適用するには**
次の `start-audit-mitigation-actions-task` の例では、`ResetPolicyVersionAction` アクション (ポリシーをクリアする) を指定された単一の検出結果に適用します。
```
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"
```
出力:
```
{
"taskId": "myActionsTaskId"
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[StartAuditMitigationActionsTask (緩和アクションコマンド)](https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-StartAuditMitigationActionsTask)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[StartAuditMitigationActionsTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/start-audit-mitigation-actions-task.html)」を参照してください。
### `start-on-demand-audit-task`
次のコード例は、`start-on-demand-audit-task` を使用する方法を示しています。
**AWS CLI**
**監査をすぐに開始するには**
次の `start-on-demand-audit-task` の例では、AWS IoT Device Defender 監査を開始し、3 つの証明書チェックを実行します。
```
aws iot start-on-demand-audit-task \
--target-check-names CA_CERTIFICATE_EXPIRING_CHECK DEVICE_CERTIFICATE_EXPIRING_CHECK REVOKED_CA_CERTIFICATE_STILL_ACTIVE_CHECK
```
出力:
```
{
"taskId": "a3aea009955e501a31b764abe1bebd3d"
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[Audit コマンド](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[StartOnDemandAuditTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/start-on-demand-audit-task.html)」を参照してください。
### `tag-resource`
次のコード例は、`tag-resource` を使用する方法を示しています。
**AWS CLI**
**リソースのタグキーと値を指定するには**
次の `tag-resource` の例では、`Assembly` キーと `Fact1NW` 値を持つタグをモノのグループ `LightBulbs` に適用します。
```
aws iot tag-resource \
--tags Key=Assembly,Value="Fact1NW" \
--resource-arn "arn:aws:iot:us-west-2:094249569039:thinggroup/LightBulbs"
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[AWS IoT リソースのタグ付け](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/tag-resource.html)」を参照してください。
### `test-authorization`
次のコード例は、`test-authorization` を使用する方法を示しています。
**AWS CLI**
**AWS IoT ポリシーをテストするには**
次の `test-authorization` の例では、指定されたプリンシパルに関連付けられた AWS IoT ポリシーをテストします。
```
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
```
出力:
```
{
"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": []
}
]
}
```
詳細については、「*AWS IoT API リファレンス*」の「[TestAuthorization](https://docs.aws.amazon.com/iot/latest/apireference/API_TestAuthorization.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[TestAuthorization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/test-authorization.html)」を参照してください。
### `test-invoke-authorizer`
次のコード例は、`test-invoke-authorizer` を使用する方法を示しています。
**AWS CLI**
**カスタムオーソライザーをテストするには**
次の `test-invoke-authorizer` の例では、カスタムオーソライザーをテストします。
```
aws iot test-invoke-authorizer \
--authorizer-name IoTAuthorizer \
--token allow \
--token-signature "mE0GvaHqy9nER/FdgtJX5lXYEJ3b3vE7t1gEszc0TKGgLKWXTnPkb2AbKnOAZ8lGyoN5dVtWDWVmr25m7++zjbYIMk2TBvyGXhOmvKFBPkdgyA43KL6SiZy0cTqlPMcQDsP7VX2rXr7CTowCxSNKphGXdQe0/I5dQ+JO6KUaHwCmupt0/MejKtaNwiia064j6wprOAUwG5S1IYFuRd0X+wfo8pb0DubAIX1Ua705kuhRUcTx4SxUShEYKmN4IDEvLB6FsIr0B2wvB7y4iPmcajxzGl02ExvyCUNctCV9dYlRRGJj0nsGzBIXOI4sGytPfqlA7obdgmN22pkDzYvwjQ=="
```
出力:
```
{
"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
}
```
詳細については、「*AWS IoT API リファレンス*」の「[TestInvokeAuthorizer](https://docs.aws.amazon.com/iot/latest/apireference/API_TestInvokeAuthorizers.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[TestInvokeAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/test-invoke-authorizer.html)」を参照してください。
### `transfer-certificate`
次のコード例は、`transfer-certificate` を使用する方法を示しています。
**AWS CLI**
**デバイス証明書を別の AWS アカウントに転送するには**
次の `transfer-certificate` の例では、デバイス証明書を別の AWS アカウントに転送します。証明書と AWS アカウントは ID で識別されます。
```
aws iot transfer-certificate \
--certificate-id 488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142 \
--target-aws-account 030714055129
```
出力:
```
{
"transferredCertificateArn": "arn:aws:iot:us-west-2:030714055129:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142"
}
```
詳細については、「*AWSIoT Core デベロッパーガイド*」の「[証明書を別のアカウントに転送する](https://docs.aws.amazon.com/iot/latest/developerguide/transfer-cert.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[TransferCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/transfer-certificate.html)」を参照してください。
### `untag-resource`
次のコード例は、`untag-resource` を使用する方法を示しています。
**AWS CLI**
**リソースからタグキーを削除するには**
次の `untag-resource` の例では、モノのグループ `LightBulbs` からタグ `MyTag` とその値を削除します。
```
command
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[AWS IoT リソースのタグ付け](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/untag-resource.html)」を参照してください。
### `update-account-audit-configuration`
次のコード例は、`update-account-audit-configuration` を使用する方法を示しています。
**AWS CLI**
**例 1: 監査通知の Amazon SNS 通知を有効にするには**
次の `update-account-audit-configuration` の例では、AWS IoT Device Defender 監査通知の Amazon SNS 通知を有効にし、ターゲットとそのターゲットへの書き込みに使用されるロールを指定します。
```
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}"
```
このコマンドでは何も出力されません。
**例 2: 監査チェックを有効にするには**
次の `update-account-audit-configuration` の例では、`AUTHENTICATED_COGNITO_ROLE_OVERLY_PERMISSIVE_CHECK` という名前の AWS IoT Device Defender 監査チェックを有効にします。AWS アカウントの 1 つまたは複数のスケジュールされた監査の `targetCheckNames` の一部である場合、監査チェックを無効にすることはできません。
```
aws iot update-account-audit-configuration \
--audit-check-configurations "{\"AUTHENTICATED_COGNITO_ROLE_OVERLY_PERMISSIVE_CHECK\":{\"enabled\":true}}"
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[Audit コマンド](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[UpdateAccountAuditConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-account-audit-configuration.html)」を参照してください。
### `update-audit-suppression`
次のコード例は、`update-audit-suppression` を使用する方法を示しています。
**AWS CLI**
**監査検出結果の抑制を更新するには**
次の `update-audit-suppression` の例では、監査検出結果の抑制の有効期限を 2020-09-21 に更新します。
```
aws iot update-audit-suppression \
--check-name DEVICE_CERTIFICATE_EXPIRING_CHECK \
--resource-identifier deviceCertificateId=c7691e \
--no-suppress-indefinitely \
--expiration-date 2020-09-21
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[監査の検出結果の抑制](https://docs.aws.amazon.com/iot/latest/developerguide/audit-finding-suppressions.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[UpdateAuditSuppression](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-audit-suppression.html)」を参照してください。
### `update-authorizer`
次のコード例は、`update-authorizer` を使用する方法を示しています。
**AWS CLI**
**カスタムオーソライザーを更新するには**
次の `update-authorizer` の例では、状態を `CustomAuthorizer2` から `INACTIVE` にします。
```
aws iot update-authorizer \
--authorizer-name CustomAuthorizer2 \
--status INACTIVE
```
出力:
```
{
"authorizerName": "CustomAuthorizer2",
"authorizerArn": "arn:aws:iot:us-west-2:123456789012:authorizer/CustomAuthorizer2"
}
```
詳細については、「*AWS IoT API リファレンス*」の「[UpdateAuthorizer](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateAuthorizer.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[UpdateAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-authorizer.html)」を参照してください。
### `update-billing-group`
次のコード例は、`update-billing-group` を使用する方法を示しています。
**AWS CLI**
**請求グループに関する情報を更新するには**
次の `update-billing-group` の例では、指定された請求グループの説明を更新します。
```
aws iot update-billing-group \
--billing-group-name GroupOne \
--billing-group-properties "billingGroupDescription=\"Primary bulb billing group\""
```
出力:
```
{
"version": 2
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[請求グループ](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot-billing-groups.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[UpdateBillingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-billing-group.html)」を参照してください。
### `update-ca-certificate`
次のコード例は、`update-ca-certificate` を使用する方法を示しています。
**AWS CLI**
**認証局 (CA) 証明書を更新するには**
次の `update-ca-certificate` の例では、指定された CA 証明書を ACTIVE ステータスに設定します。
```
aws iot update-ca-certificate \
--certificate-id f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467 \
--new-status ACTIVE
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT API リファレンス*」の「[UpdateCACertificate](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateCACertificate.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[UpdateCaCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-ca-certificate.html)」を参照してください。
### `update-certificate`
次のコード例は、`update-certificate` を使用する方法を示しています。
**AWS CLI**
**デバイス証明書を更新するには**
次の `update-certificate` の例では、指定されたデバイス証明書を INACTIVE ステータスに設定します。
```
aws iot update-certificate \
--certificate-id d1eb269fb55a628552143c8f96eb3c258fcd5331ea113e766ba0c82bf225f0be \
--new-status INACTIVE
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT API リファレンス*」の「[UpdateCertificate](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateCertificate.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[UpdateCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-certificate.html)」を参照してください。
### `update-custom-metric`
次のコード例は、`update-custom-metric` を使用する方法を示しています。
**AWS CLI**
**カスタムメトリクスを更新するには**
次の `update-custom-metric` の例では、カスタムメトリクスを更新して新しい `display-name` を取得します。
```
aws iot update-custom-metric \
--metric-name batteryPercentage \
--display-name 'remaining battery percentage on device' \
--region us-east-1
```
出力:
```
{
"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"
}
```
詳細については、「*AWS IoT Core デベロッパーガイド*」の「[カスタムメトリクス](https://docs.aws.amazon.com/iot/latest/developerguide/dd-detect-custom-metrics.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[UpdateCustomMetric](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-custom-metric.html)」を参照してください。
### `update-dimension`
次のコード例は、`update-dimension` を使用する方法を示しています。
**AWS CLI**
**ディメンションを更新するには**
次の `update-dimension` の例では、ディメンションを更新します。
```
aws iot update-dimension \
--name TopicFilterForAuthMessages \
--string-values device/${iot:ClientId}/auth
```
出力:
```
{
"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"
}
```
詳細については、「*AWS IoT Core デベロッパーガイド*」の「[ディメンションを使用したセキュリティプロファイルでのメトリクスの範囲設定](https://docs.aws.amazon.com/iot/latest/developerguide/scoping-security-behavior.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[UpdateDimension](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-dimension.html)」を参照してください。
### `update-domain-configuration`
次のコード例は、`update-domain-configuration` を使用する方法を示しています。
**AWS CLI**
**ドメイン設定を更新するには**
次の `update-domain-configuration` の例では、指定されたドメイン設定を無効にします。
```
aws iot update-domain-configuration \
--domain-configuration-name "additionalDataDomain" \
--domain-configuration-status "DISABLED"
```
出力:
```
{
"domainConfigurationName": "additionalDataDomain",
"domainConfigurationArn": "arn:aws:iot:us-west-2:123456789012:domainconfiguration/additionalDataDomain/dikMh"
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[設定可能なエンドポイント](https://docs.aws.amazon.com/iot/latest/developerguide/iot-custom-endpoints-configurable-aws.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[UpdateDomainConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-domain-configuration.html)」を参照してください。
### `update-dynamic-thing-group`
次のコード例は、`update-dynamic-thing-group` を使用する方法を示しています。
**AWS CLI**
**モノの動的グループを更新するには**
次の `update-dynamic-thing-group` の例では、指定されたモノの動的グループを更新します。説明を提供し、クエリ文字列を更新してグループのメンバーシップ条件を変更します。
```
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"
```
出力:
```
{
"version": 2
}
```
詳細については、「*AWS IoT デベロッパーガイド*」「[モノの動的グループ](https://docs.aws.amazon.com/iot/latest/developerguide/dynamic-thing-groups.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[UpdateDynamicThingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-dynamic-thing-group.html)」を参照してください。
### `update-event-configurations`
次のコード例は、`update-event-configurations` を使用する方法を示しています。
**AWS CLI**
**公開されるイベントタイプを表示するには**
次の `update-event-configurations` の例では、CA 証明書が追加、更新、または削除されたときにメッセージを有効にするように設定を更新します。
```
aws iot update-event-configurations \
--event-configurations "{\"CA_CERTIFICATE\":{\"Enabled\":true}}"
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[イベントメッセージ](https://docs.aws.amazon.com/iot/latest/developerguide/iot-events.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[UpdateEventConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-event-configurations.html)」を参照してください。
### `update-indexing-configuration`
次のコード例は、`update-indexing-configuration` を使用する方法を示しています。
**AWS CLI**
**モノのインデックス作成を有効にするには**
以下の `update-indexing-configuration` 例は、AWS\$1Things インデックスを使用して、モノのインデックス作成に、レジストリーデータ、シャドウデータ、およびモノの接続ステータスの検索サポートをさせます。
```
aws iot update-indexing-configuration
--thing-indexing-configuration thingIndexingMode=REGISTRY_AND_SHADOW,thingConnectivityIndexingMode=STATUS
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[モノのインデックス作成の管理](https://docs.aws.amazon.com/iot/latest/developerguide/managing-index.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[UpdateIndexingConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-indexing-configuration.html)」を参照してください。
### `update-job`
次のコード例は、`update-job` を使用する方法を示しています。
**AWS CLI**
**ジョブの詳細なステータスを取得するには**
次の `update-job` の例では、ID が `example-job-01` のジョブの詳細なステータスを取得します。
```
aws iot describe-job \
--job-id "example-job-01"
```
出力:
```
{
"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": {}
}
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[ジョブ (CLI) の作成と管理](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[UpdateJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-job.html)」を参照してください。
### `update-mitigation-action`
次のコード例は、`update-mitigation-action` を使用する方法を示しています。
**AWS CLI**
**緩和アクションを更新するには**
次の `update-mitigation-action` の例では、`AddThingsToQuarantineGroupAction` という名前の指定された緩和アクションを更新し、モノのグループ名を変更して、`overrideDynamicGroups` を `false` に設定します。変更は `describe-mitigation-action` コマンドを使用して確認できます。
```
aws iot update-mitigation-action \
--cli-input-json "{ \"actionName\": \"AddThingsToQuarantineGroupAction\", \"actionParams\": { \"addThingsToThingGroupParams\": {\"thingGroupNames\":[\"QuarantineGroup2\"],\"overrideDynamicGroups\": false}}}"
```
出力:
```
{
"actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/AddThingsToQuarantineGroupAction",
"actionId": "2fd2726d-98e1-4abf-b10f-09465ccd6bfa"
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[UpdateMitigationAction (緩和アクションコマンド)](https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-UpdateMitigationAction)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[UpdateMitigationAction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-mitigation-action.html)」を参照してください。
### `update-provisioning-template`
次のコード例は、`update-provisioning-template` を使用する方法を示しています。
**AWS CLI**
**プロビジョニングテンプレートを更新するには**
次の `update-provisioning-template` の例では、指定されたプロビジョニングテンプレートの説明とロール ARN を変更し、テンプレートを有効にします。
```
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
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT Core デベロッパーガイド*」の「[AWS セキュアトンネリング](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[UpdateProvisioningTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-provisioning-template.html)」を参照してください。
### `update-role-alias`
次のコード例は、`update-role-alias` を使用する方法を示しています。
**AWS CLI**
**ロールエイリアスを更新するには**
次の `update-role-alias` 例では、`LightBulbRole` ロールを更新します。
```
aws iot update-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 リファレンス*」の「[UpdateRoleAlias](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateRoleAlias.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[UpdateRoleAlias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-role-alias.html)」を参照してください。
### `update-scheduled-audit`
次のコード例は、`update-scheduled-audit` を使用する方法を示しています。
**AWS CLI**
**スケジュールされた監査定義を更新するには**
次の `update-scheduled-audit` の例では、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
```
出力:
```
{
"scheduledAuditArn": "arn:aws:iot:us-west-2:123456789012:scheduledaudit/WednesdayCertCheck"
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[Audit コマンド](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[UpdateScheduledAudit](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-scheduled-audit.html)」を参照してください。
### `update-security-profile`
次のコード例は、`update-security-profile` を使用する方法を示しています。
**AWS CLI**
**セキュリティプロファイルを更新するには**
次の `update-security-profile` の例では、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}}]"
```
出力:
```
{
"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
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[Detect コマンド](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[UpdateSecurityProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-security-profile.html)」を参照してください。
### `update-stream`
次のコード例は、`update-stream` を使用する方法を示しています。
**AWS CLI**
**ストリームを更新するには**
次の `update-stream` の例では、既存のストリームを更新します。ストリームのバージョンが 1 ずつ増えていきます。
```
aws iot update-stream \
--cli-input-json file://update-stream.json
```
`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"
}
```
出力:
```
{
"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
}
```
詳細については、「*AWS IoT API リファレンス*」の「[UpdateStream](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateStream.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[UpdateStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-stream.html)」を参照してください。
### `update-thing-group`
次のコード例は、`update-thing-group` を使用する方法を示しています。
**AWS CLI**
**モノのグループの定義を更新するには**
次の `update-thing-group` の例では、指定されたモノのグループの定義を更新し、説明と 2 つの属性を変更します。
```
aws iot update-thing-group \
--thing-group-name HalogenBulbs \
--thing-group-properties "thingGroupDescription=\"Halogen bulb group\", attributePayload={attributes={Manufacturer=AnyCompany,wattage=60}}"
```
出力:
```
{
"version": 2
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[モノのグループ](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[UpdateThingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-thing-group.html)」を参照してください。
### `update-thing-groups-for-thing`
次のコード例は、`update-thing-groups-for-thing` を使用する方法を示しています。
**AWS CLI**
**モノが属するグループを変更するには**
次の `update-thing-groups-for-thing` の例では、`MyLightBulb` という名前のモノを `DeadBulbs` という名前のグループから削除し、同時に `replaceableItems` という名前のグループに追加します。
```
aws iot update-thing-groups-for-thing \
--thing-name MyLightBulb \
--thing-groups-to-add "replaceableItems" \
--thing-groups-to-remove "DeadBulbs"
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[モノのグループ](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[UpdateThingGroupsForThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-thing-groups-for-thing.html)」を参照してください。
### `update-thing`
次のコード例は、`update-thing` を使用する方法を示しています。
**AWS CLI**
**モノのタイプにモノを関連付けるには**
次の `update-thing` 例では、AWS IoT レジストリ内のモノをモノのタイプに関連付けます。関連付けを行うときは、モノのタイプで定義された属性の値を指定します。
```
aws iot update-thing \
--thing-name "MyOtherLightBulb" \
--thing-type-name "LightBulb" \
--attribute-payload "{"attributes": {"wattage":"75", "model":"123"}}"
```
このコマンドでは、出力が生成されません。`describe-thing` コマンドを使用して結果を表示します。
詳細については、「*AWS IoT デベロッパーガイド*」「[モノのタイプ](https://docs.aws.amazon.com/iot/latest/developerguide/thing-types.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[UpdateThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-thing.html)」を参照してください。
### `update-topic-rule-destination`
次のコード例は、`update-topic-rule-destination` を使用する方法を示しています。
**AWS CLI**
**例 1: トピックルールの送信先を有効にするには**
次の `update-topic-rule-destination` の例では、トピックルールの送信先へのトラフィックを有効にします。
```
aws iot update-topic-rule-destination \
--arn "arn:aws:iot:us-west-2:123456789012:ruledestination/http/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" \
--status ENABLED
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[トピックルールの送信先の有効化](https://docs.aws.amazon.com/iot/latest/developerguide/rule-destination.html#enable-destination)」を参照してください。
**例 2: トピックルールの送信先を無効にするには**
次の `update-topic-rule-destination` の例では、トピックルールの送信先へのトラフィックを無効にします。
```
aws iot update-topic-rule-destination \
--arn "arn:aws:iot:us-west-2:123456789012:ruledestination/http/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" \
--status DISABLED
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[トピックルールの送信先の無効化](https://docs.aws.amazon.com/iot/latest/developerguide/rule-destination.html#disable-destination)」を参照してください。
**例 3: 新しい確認メッセージを送信するには**
次の `update-topic-rule-destination` の例では、トピックルールの送信先に関する新しい確認メッセージを送信します。
```
aws iot update-topic-rule-destination \
--arn "arn:aws:iot:us-west-2:123456789012:ruledestination/http/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" \
--status IN_PROGRESS
```
このコマンドでは何も出力されません。
詳細については、「*AWS IoT デベロッパーガイド*」の「[新しい確認メッセージの送信](https://docs.aws.amazon.com/iot/latest/developerguide/rule-destination.html#trigger-confirm)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[UpdateTopicRuleDestination](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-topic-rule-destination.html)」を参照してください。
### `validate-security-profile-behaviors`
次のコード例は、`validate-security-profile-behaviors` を使用する方法を示しています。
**AWS CLI**
**例 1: セキュリティプロファイルの動作パラメータを検証するには**
次の `validate-security-profile-behaviors` の例では、AWS IoT Device Defender セキュリティプロファイルに対して、適切に形成された正しい動作のセットを検証します。
```
aws iot validate-security-profile-behaviors \
--behaviors "[{\"name\":\"CellularBandwidth\",\"metric\":\"aws:message-byte-size\",\"criteria\":{\"comparisonOperator\":\"greater-than\",\"value\":{\"count\":128},\"consecutiveDatapointsToAlarm\":1,\"consecutiveDatapointsToClear\":1}},{\"name\":\"Authorization\",\"metric\":\"aws:num-authorization-failures\",\"criteria\":{\"comparisonOperator\":\"greater-than\",\"value\":{\"count\":12},\"durationSeconds\":300,\"consecutiveDatapointsToAlarm\":1,\"consecutiveDatapointsToClear\":1}}]"
```
出力:
```
{
"valid": true,
"validationErrors": []
}
```
**例 2: セキュリティプロファイルの不正な動作パラメータを検証するには**
次の `validate-security-profile-behaviors` の例では、AWS IoT Device Defender セキュリティプロファイルのエラーを含む一連の動作を検証します。
```
aws iot validate-security-profile-behaviors \
--behaviors "[{\"name\":\"CellularBandwidth\",\"metric\":\"aws:message-byte-size\",\"criteria\":{\"comparisonOperator\":\"greater-than\",\"value\":{\"count\":128},\"consecutiveDatapointsToAlarm\":1,\"consecutiveDatapointsToClear\":1}},{\"name\":\"Authorization\",\"metric\":\"aws:num-authorization-failures\",\"criteria\":{\"comparisonOperator\":\"greater-than\",\"value\":{\"count\":12},\"durationSeconds\":300,\"consecutiveDatapointsToAlarm\":100000,\"consecutiveDatapointsToClear\":1}}]"
```
出力:
```
{
"valid": false,
"validationErrors": [
{
"errorMessage": "Behavior Authorization is malformed. consecutiveDatapointsToAlarm 100000 should be in range[1,10]"
}
]
}
```
詳細については、「*AWS IoT デベロッパーガイド*」の「[Detect コマンド](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ValidateSecurityProfileBehaviors](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/validate-security-profile-behaviors.html)」を参照してください。