Copyright	(c) 2013-2021 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay <brendan.g.hay+amazonka@gmail.com>
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	None

Amazonka.IoT.DescribeThing

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Gets information about the specified thing.

Requires permission to access the DescribeThing action.

Synopsis

data DescribeThing = DescribeThing' {
- thingName :: Text
}
newDescribeThing :: Text -> DescribeThing
describeThing_thingName :: Lens' DescribeThing Text
data DescribeThingResponse = DescribeThingResponse' {
- defaultClientId :: Maybe Text
- thingTypeName :: Maybe Text
- thingArn :: Maybe Text
- attributes :: Maybe (HashMap Text Text)
- version :: Maybe Integer
- thingName :: Maybe Text
- billingGroupName :: Maybe Text
- thingId :: Maybe Text
- httpStatus :: Int
}
newDescribeThingResponse :: Int -> DescribeThingResponse
describeThingResponse_defaultClientId :: Lens' DescribeThingResponse (Maybe Text)
describeThingResponse_thingTypeName :: Lens' DescribeThingResponse (Maybe Text)
describeThingResponse_thingArn :: Lens' DescribeThingResponse (Maybe Text)
describeThingResponse_attributes :: Lens' DescribeThingResponse (Maybe (HashMap Text Text))
describeThingResponse_version :: Lens' DescribeThingResponse (Maybe Integer)
describeThingResponse_thingName :: Lens' DescribeThingResponse (Maybe Text)
describeThingResponse_billingGroupName :: Lens' DescribeThingResponse (Maybe Text)
describeThingResponse_thingId :: Lens' DescribeThingResponse (Maybe Text)
describeThingResponse_httpStatus :: Lens' DescribeThingResponse Int

Creating a Request

data DescribeThing Source #

The input for the DescribeThing operation.

See: newDescribeThing smart constructor.

Constructors

DescribeThing'
Fields thingName :: Text The name of the thing.

Instances

Instances details

Eq DescribeThing Source #
Instance details Defined in Amazonka.IoT.DescribeThing Methods (==) :: DescribeThing -> DescribeThing -> Bool # (/=) :: DescribeThing -> DescribeThing -> Bool #
Read DescribeThing Source #
Instance details Defined in Amazonka.IoT.DescribeThing Methods readsPrec :: Int -> ReadS DescribeThing # readList :: ReadS [DescribeThing] # readPrec :: ReadPrec DescribeThing # readListPrec :: ReadPrec [DescribeThing] #
Show DescribeThing Source #
Instance details Defined in Amazonka.IoT.DescribeThing Methods showsPrec :: Int -> DescribeThing -> ShowS # show :: DescribeThing -> String # showList :: [DescribeThing] -> ShowS #
Generic DescribeThing Source #
Instance details Defined in Amazonka.IoT.DescribeThing Associated Types type Rep DescribeThing :: Type -> Type # Methods from :: DescribeThing -> Rep DescribeThing x # to :: Rep DescribeThing x -> DescribeThing #
NFData DescribeThing Source #
Instance details Defined in Amazonka.IoT.DescribeThing Methods rnf :: DescribeThing -> () #
Hashable DescribeThing Source #
Instance details Defined in Amazonka.IoT.DescribeThing Methods hashWithSalt :: Int -> DescribeThing -> Int # hash :: DescribeThing -> Int #
AWSRequest DescribeThing Source #
Instance details Defined in Amazonka.IoT.DescribeThing Associated Types type AWSResponse DescribeThing # Methods request :: DescribeThing -> Request DescribeThing # response :: MonadResource m => Logger -> Service -> Proxy DescribeThing -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse DescribeThing))) #
ToHeaders DescribeThing Source #
Instance details Defined in Amazonka.IoT.DescribeThing Methods toHeaders :: DescribeThing -> [Header] #
ToPath DescribeThing Source #
Instance details Defined in Amazonka.IoT.DescribeThing Methods toPath :: DescribeThing -> ByteString #
ToQuery DescribeThing Source #
Instance details Defined in Amazonka.IoT.DescribeThing Methods toQuery :: DescribeThing -> QueryString #
type Rep DescribeThing Source #
Instance details Defined in Amazonka.IoT.DescribeThing type Rep DescribeThing = D1 ('MetaData "DescribeThing" "Amazonka.IoT.DescribeThing" "libZSservicesZSamazonka-iotZSamazonka-iot" 'False) (C1 ('MetaCons "DescribeThing'" 'PrefixI 'True) (S1 ('MetaSel ('Just "thingName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)))
type AWSResponse DescribeThing Source #
Instance details Defined in Amazonka.IoT.DescribeThing type AWSResponse DescribeThing = DescribeThingResponse

newDescribeThing Source #

Arguments

:: Text	`$sel:thingName:DescribeThing'`
-> DescribeThing

Create a value of DescribeThing with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:thingName:DescribeThing', describeThing_thingName - The name of the thing.

Request Lenses

describeThing_thingName :: Lens' DescribeThing Text Source #

The name of the thing.

Destructuring the Response

data DescribeThingResponse Source #

The output from the DescribeThing operation.

See: newDescribeThingResponse smart constructor.

Constructors

DescribeThingResponse'

Fields

defaultClientId :: Maybe Text
The default MQTT client ID. For a typical device, the thing name is also used as the default MQTT client ID. Although we don’t require a mapping between a thing's registry name and its use of MQTT client IDs, certificates, or shadow state, we recommend that you choose a thing name and use it as the MQTT client ID for the registry and the Device Shadow service.
This lets you better organize your IoT fleet without removing the flexibility of the underlying device certificate model or shadows.
thingTypeName :: Maybe Text
The thing type name.
thingArn :: Maybe Text
The ARN of the thing to describe.
attributes :: Maybe (HashMap Text Text)
The thing attributes.
version :: Maybe Integer
The current version of the thing record in the registry.
To avoid unintentional changes to the information in the registry, you can pass the version information in the expectedVersion parameter of the UpdateThing and DeleteThing calls.
thingName :: Maybe Text
The name of the thing.
billingGroupName :: Maybe Text
The name of the billing group the thing belongs to.
thingId :: Maybe Text
The ID of the thing to describe.
httpStatus :: Int
The response's http status code.

Instances

Instances details

Eq DescribeThingResponse Source #
Instance details Defined in Amazonka.IoT.DescribeThing Methods (==) :: DescribeThingResponse -> DescribeThingResponse -> Bool # (/=) :: DescribeThingResponse -> DescribeThingResponse -> Bool #
Read DescribeThingResponse Source #
Instance details Defined in Amazonka.IoT.DescribeThing Methods readsPrec :: Int -> ReadS DescribeThingResponse # readList :: ReadS [DescribeThingResponse] # readPrec :: ReadPrec DescribeThingResponse # readListPrec :: ReadPrec [DescribeThingResponse] #
Show DescribeThingResponse Source #
Instance details Defined in Amazonka.IoT.DescribeThing Methods showsPrec :: Int -> DescribeThingResponse -> ShowS # show :: DescribeThingResponse -> String # showList :: [DescribeThingResponse] -> ShowS #
Generic DescribeThingResponse Source #
Instance details Defined in Amazonka.IoT.DescribeThing Associated Types type Rep DescribeThingResponse :: Type -> Type # Methods from :: DescribeThingResponse -> Rep DescribeThingResponse x # to :: Rep DescribeThingResponse x -> DescribeThingResponse #
NFData DescribeThingResponse Source #
Instance details Defined in Amazonka.IoT.DescribeThing Methods rnf :: DescribeThingResponse -> () #
type Rep DescribeThingResponse Source #
Instance details Defined in Amazonka.IoT.DescribeThing type Rep DescribeThingResponse = D1 ('MetaData "DescribeThingResponse" "Amazonka.IoT.DescribeThing" "libZSservicesZSamazonka-iotZSamazonka-iot" 'False) (C1 ('MetaCons "DescribeThingResponse'" 'PrefixI 'True) (((S1 ('MetaSel ('Just "defaultClientId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "thingTypeName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :: (S1 ('MetaSel ('Just "thingArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "attributes") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe (HashMap Text Text))))) :: ((S1 ('MetaSel ('Just "version") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Integer)) :: S1 ('MetaSel ('Just "thingName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :: (S1 ('MetaSel ('Just "billingGroupName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: (S1 ('MetaSel ('Just "thingId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))))

newDescribeThingResponse Source #

Arguments

:: Int	`$sel:httpStatus:DescribeThingResponse'`
-> DescribeThingResponse

Create a value of DescribeThingResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:defaultClientId:DescribeThingResponse', describeThingResponse_defaultClientId - The default MQTT client ID. For a typical device, the thing name is also used as the default MQTT client ID. Although we don’t require a mapping between a thing's registry name and its use of MQTT client IDs, certificates, or shadow state, we recommend that you choose a thing name and use it as the MQTT client ID for the registry and the Device Shadow service.

This lets you better organize your IoT fleet without removing the flexibility of the underlying device certificate model or shadows.

$sel:thingTypeName:DescribeThingResponse', describeThingResponse_thingTypeName - The thing type name.

$sel:thingArn:DescribeThingResponse', describeThingResponse_thingArn - The ARN of the thing to describe.

$sel:attributes:DescribeThingResponse', describeThingResponse_attributes - The thing attributes.

$sel:version:DescribeThingResponse', describeThingResponse_version - The current version of the thing record in the registry.

To avoid unintentional changes to the information in the registry, you can pass the version information in the expectedVersion parameter of the UpdateThing and DeleteThing calls.

$sel:thingName:DescribeThing', describeThingResponse_thingName - The name of the thing.

$sel:billingGroupName:DescribeThingResponse', describeThingResponse_billingGroupName - The name of the billing group the thing belongs to.

$sel:thingId:DescribeThingResponse', describeThingResponse_thingId - The ID of the thing to describe.

$sel:httpStatus:DescribeThingResponse', describeThingResponse_httpStatus - The response's http status code.

Response Lenses

describeThingResponse_defaultClientId :: Lens' DescribeThingResponse (Maybe Text) Source #

The default MQTT client ID. For a typical device, the thing name is also used as the default MQTT client ID. Although we don’t require a mapping between a thing's registry name and its use of MQTT client IDs, certificates, or shadow state, we recommend that you choose a thing name and use it as the MQTT client ID for the registry and the Device Shadow service.

This lets you better organize your IoT fleet without removing the flexibility of the underlying device certificate model or shadows.

describeThingResponse_thingTypeName :: Lens' DescribeThingResponse (Maybe Text) Source #

The thing type name.

describeThingResponse_thingArn :: Lens' DescribeThingResponse (Maybe Text) Source #

The ARN of the thing to describe.

describeThingResponse_attributes :: Lens' DescribeThingResponse (Maybe (HashMap Text Text)) Source #

The thing attributes.

describeThingResponse_version :: Lens' DescribeThingResponse (Maybe Integer) Source #

The current version of the thing record in the registry.

To avoid unintentional changes to the information in the registry, you can pass the version information in the expectedVersion parameter of the UpdateThing and DeleteThing calls.

describeThingResponse_thingName :: Lens' DescribeThingResponse (Maybe Text) Source #

The name of the thing.

describeThingResponse_billingGroupName :: Lens' DescribeThingResponse (Maybe Text) Source #

The name of the billing group the thing belongs to.

describeThingResponse_thingId :: Lens' DescribeThingResponse (Maybe Text) Source #

The ID of the thing to describe.

describeThingResponse_httpStatus :: Lens' DescribeThingResponse Int Source #

The response's http status code.