Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1483477323.4 KB

Get details of a managed thing including its attributes and capabilities.

get/managed-things/{Identifier}

Path parameters

Identifierstring required

The id of the managed thing.

Response

Success

Idstring

The id of the managed thing.

Arnstring

The Amazon Resource Name (ARN) of the managed thing.

Ownerstring password

Owner of the device, usually an indication of whom the device belongs to. This value should not contain personal identifiable information.

CredentialLockerIdstring

The identifier of the credential locker for the managed thing.

AdvertisedProductIdstring

The id of the advertised product.

Role'CONTROLLER' | 'DEVICE'

The type of device used. This will be the Amazon Web Services hub controller, cloud device, or IoT device.

ProvisioningStatus'UNASSOCIATED' | 'PRE_ASSOCIATED' | 'DISCOVERED' | 'ACTIVATED' | 'DELETION_FAILED' | 'DELETE_IN_PROGRESS' | 'ISOLATED' | 'DELETED'

The provisioning status of the device in the provisioning workflow for onboarding to IoT managed integrations. For more information, see <a href="https://docs.aws.amazon.com/iot-mi/latest/devguide/device-provisioning.html">Device Provisioning</a>.

Namestring

The name of the managed thing representing the physical device.

Modelstring password

The model of the device.

Brandstring password

The brand of the device.

SerialNumberstring password

The serial number of the device.

UniversalProductCodestring password

The universal product code (UPC) of the device model. The UPC is typically used in the United States of America and Canada.

InternationalArticleNumberstring password

The unique 13 digit number that identifies the managed thing.

ConnectorPolicyIdstring
<p>The id of the connector policy.</p> <note> <p>This parameter is used for cloud-to-cloud devices only.</p> </note>ConnectorPolicyId is deprecated
ConnectorDestinationIdstring

The identifier of the connector destination associated with this managed thing.

ConnectorDeviceIdstring password
<p>The third-party device id as defined by the connector. This device id must not contain personal identifiable information (PII).</p> <note> <p>This parameter is used for cloud-to-cloud devices only.</p> </note>
DeviceSpecificKeystring password
<p>A Zwave device-specific key used during device activation.</p> <note> <p>This parameter is used for Zwave devices only.</p> </note>
MacAddressstring password
<p>The media access control (MAC) address for the device represented by the managed thing.</p> <note> <p>This parameter is used for Zigbee devices only.</p> </note>
ParentControllerIdstring

Id of the controller device used for the discovery job.

Classificationstring password

The classification of the managed thing such as light bulb or thermostat.

CreatedAtstring date-time

The timestamp value of when the device creation request occurred.

UpdatedAtstring date-time

The timestamp value of when the managed thing was last updated at.

ActivatedAtstring date-time

The timestampe value of when the device was activated.

HubNetworkMode'STANDARD' | 'NETWORK_WIDE_EXCLUSION'

The network mode for the hub-connected device.

MetaDataobject

The metadata for the managed thing.

Tagsobject

A set of key/value pairs that are used to manage the managed thing.