AWS cli documentation change

Service: cli · 2025-06-28 · Documentation medium

File: cli/latest/reference/iot-managed-integrations/start-device-discovery.md

Summary

Added new parameters (--custom-protocol-detail and --account-association-id), updated device discovery scope description, and navigation links

Security assessment

Introduces documentation for authentication requirements (install code usage) and account association controls for third-party devices, but does not indicate remediation of a specific vulnerability. The --custom-protocol-detail parameter enforces security controls for custom discovery types by requiring a 'Name' key.

Diff

diff --git a/cli/latest/reference/iot-managed-integrations/start-device-discovery.md b/cli/latest/reference/iot-managed-integrations/start-device-discovery.md
index 3c0f5e21c..01a7a2286 100644
--- a//cli/latest/reference/iot-managed-integrations/start-device-discovery.md
+++ b//cli/latest/reference/iot-managed-integrations/start-device-discovery.md
@@ -13,3 +13,3 @@
-  * [next](update-destination.html "update-destination") |
-  * [previous](send-managed-thing-command.html "send-managed-thing-command") |
-  * [AWS CLI 2.27.42 Command Reference](../../index.html) »
+  * [next](tag-resource.html "tag-resource") |
+  * [previous](start-account-association-refresh.html "start-account-association-refresh") |
+  * [AWS CLI 2.27.45 Command Reference](../../index.html) »
@@ -22,2 +22,2 @@
-  * [← send-managed-thing-command](send-managed-thing-command.html "previous chapter \(use the left arrow\)") /
-  * [update-destination →](update-destination.html "next chapter \(use the right arrow\)")
+  * [← start-account-association-refresh](start-account-association-refresh.html "previous chapter \(use the left arrow\)") /
+  * [tag-resource →](tag-resource.html "next chapter \(use the right arrow\)")
@@ -59 +59 @@ First time using the AWS CLI? See the [User Guide](https://docs.aws.amazon.com/c
-During user-guided setup, this is used to start device discovery. The authentication material (install code) is passed as a message to the controller telling it to start the discovery.
+This API is used to start device discovery for hub-connected and third-party-connected devices. The authentication material (install code) is passed as a message to the controller telling it to start the discovery.
@@ -67,0 +68 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/iot-ma
+    [--custom-protocol-detail <value>]
@@ -69,0 +71 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/iot-ma
+    [--account-association-id <value>]
@@ -100 +102 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/iot-ma
-> The discovery type supporting the type of device to be discovered in the device discovery job request.
+> The discovery type supporting the type of device to be discovered in the device discovery task request.
@@ -106,0 +109 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/iot-ma
+>   * `CUSTOM`
@@ -109,0 +113,25 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/iot-ma
+`--custom-protocol-detail` (map)
+
+> Additional protocol-specific details required for device discovery, which vary based on the discovery type.
+> 
+> ### Note
+> 
+> For a `DiscoveryType` of `CUSTOM` , the string-to-string map must have a key value of `Name` set to a non-empty-string.
+> 
+> key -> (string)
+> 
+> value -> (string)
+
+Shorthand Syntax:
+    
+    
+    KeyName1=string,KeyName2=string
+    
+
+JSON Syntax:
+    
+    
+    {"string": "string"
+      ...}
+    
+
@@ -117,0 +146,4 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/iot-ma
+`--account-association-id` (string)
+
+> The identifier of the cloud-to-cloud account association to use for discovery of third-party devices.
+
@@ -264,2 +296,2 @@ StartedAt -> (timestamp)
-  * [← send-managed-thing-command](send-managed-thing-command.html "previous chapter \(use the left arrow\)") /
-  * [update-destination →](update-destination.html "next chapter \(use the right arrow\)")
+  * [← start-account-association-refresh](start-account-association-refresh.html "previous chapter \(use the left arrow\)") /
+  * [tag-resource →](tag-resource.html "next chapter \(use the right arrow\)")
@@ -272,3 +304,3 @@ StartedAt -> (timestamp)
-  * [next](update-destination.html "update-destination") |
-  * [previous](send-managed-thing-command.html "send-managed-thing-command") |
-  * [AWS CLI 2.27.42 Command Reference](../../index.html) »
+  * [next](tag-resource.html "tag-resource") |
+  * [previous](start-account-association-refresh.html "start-account-association-refresh") |
+  * [AWS CLI 2.27.45 Command Reference](../../index.html) »