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.IoTSiteWise.CreateAssetModel

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Creates an asset model from specified property and hierarchy definitions. You create assets from asset models. With asset models, you can easily create assets of the same type that have standardized definitions. Each asset created from a model inherits the asset model's property and hierarchy definitions. For more information, see Defining asset models in the IoT SiteWise User Guide.

Synopsis

Creating a Request

data CreateAssetModel Source #

See: newCreateAssetModel smart constructor.

Constructors

CreateAssetModel'

Fields

clientToken :: Maybe Text
A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.
assetModelDescription :: Maybe Text
A description for the asset model.
assetModelProperties :: Maybe [AssetModelPropertyDefinition]
The property definitions of the asset model. For more information, see Asset properties in the IoT SiteWise User Guide.
You can specify up to 200 properties per asset model. For more information, see Quotas in the IoT SiteWise User Guide.
assetModelCompositeModels :: Maybe [AssetModelCompositeModelDefinition]
The composite asset models that are part of this asset model. Composite asset models are asset models that contain specific properties. Each composite model has a type that defines the properties that the composite model supports. Use composite asset models to define alarms on this asset model.
assetModelHierarchies :: Maybe [AssetModelHierarchyDefinition]
The hierarchy definitions of the asset model. Each hierarchy specifies an asset model whose assets can be children of any other assets created from this asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.
You can specify up to 10 hierarchies per asset model. For more information, see Quotas in the IoT SiteWise User Guide.
tags :: Maybe (HashMap Text Text)
A list of key-value pairs that contain metadata for the asset model. For more information, see Tagging your IoT SiteWise resources in the IoT SiteWise User Guide.
assetModelName :: Text
A unique, friendly name for the asset model.

Instances

Instances details

Eq CreateAssetModel Source #
Instance details Defined in Amazonka.IoTSiteWise.CreateAssetModel Methods (==) :: CreateAssetModel -> CreateAssetModel -> Bool # (/=) :: CreateAssetModel -> CreateAssetModel -> Bool #
Read CreateAssetModel Source #
Instance details Defined in Amazonka.IoTSiteWise.CreateAssetModel Methods readsPrec :: Int -> ReadS CreateAssetModel # readList :: ReadS [CreateAssetModel] # readPrec :: ReadPrec CreateAssetModel # readListPrec :: ReadPrec [CreateAssetModel] #
Show CreateAssetModel Source #
Instance details Defined in Amazonka.IoTSiteWise.CreateAssetModel Methods showsPrec :: Int -> CreateAssetModel -> ShowS # show :: CreateAssetModel -> String # showList :: [CreateAssetModel] -> ShowS #
Generic CreateAssetModel Source #
Instance details Defined in Amazonka.IoTSiteWise.CreateAssetModel Associated Types type Rep CreateAssetModel :: Type -> Type # Methods from :: CreateAssetModel -> Rep CreateAssetModel x # to :: Rep CreateAssetModel x -> CreateAssetModel #
NFData CreateAssetModel Source #
Instance details Defined in Amazonka.IoTSiteWise.CreateAssetModel Methods rnf :: CreateAssetModel -> () #
Hashable CreateAssetModel Source #
Instance details Defined in Amazonka.IoTSiteWise.CreateAssetModel Methods hashWithSalt :: Int -> CreateAssetModel -> Int # hash :: CreateAssetModel -> Int #
ToJSON CreateAssetModel Source #
Instance details Defined in Amazonka.IoTSiteWise.CreateAssetModel Methods toJSON :: CreateAssetModel -> Value # toEncoding :: CreateAssetModel -> Encoding # toJSONList :: [CreateAssetModel] -> Value # toEncodingList :: [CreateAssetModel] -> Encoding #
AWSRequest CreateAssetModel Source #
Instance details Defined in Amazonka.IoTSiteWise.CreateAssetModel Associated Types type AWSResponse CreateAssetModel # Methods request :: CreateAssetModel -> Request CreateAssetModel # response :: MonadResource m => Logger -> Service -> Proxy CreateAssetModel -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse CreateAssetModel))) #
ToHeaders CreateAssetModel Source #
Instance details Defined in Amazonka.IoTSiteWise.CreateAssetModel Methods toHeaders :: CreateAssetModel -> [Header] #
ToPath CreateAssetModel Source #
Instance details Defined in Amazonka.IoTSiteWise.CreateAssetModel Methods toPath :: CreateAssetModel -> ByteString #
ToQuery CreateAssetModel Source #
Instance details Defined in Amazonka.IoTSiteWise.CreateAssetModel Methods toQuery :: CreateAssetModel -> QueryString #
type Rep CreateAssetModel Source #
Instance details Defined in Amazonka.IoTSiteWise.CreateAssetModel type Rep CreateAssetModel = D1 ('MetaData "CreateAssetModel" "Amazonka.IoTSiteWise.CreateAssetModel" "libZSservicesZSamazonka-iotsitewiseZSamazonka-iotsitewise" 'False) (C1 ('MetaCons "CreateAssetModel'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "clientToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: (S1 ('MetaSel ('Just "assetModelDescription") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "assetModelProperties") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [AssetModelPropertyDefinition])))) :: ((S1 ('MetaSel ('Just "assetModelCompositeModels") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [AssetModelCompositeModelDefinition])) :: S1 ('MetaSel ('Just "assetModelHierarchies") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [AssetModelHierarchyDefinition]))) :: (S1 ('MetaSel ('Just "tags") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe (HashMap Text Text))) :: S1 ('MetaSel ('Just "assetModelName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)))))
type AWSResponse CreateAssetModel Source #
Instance details Defined in Amazonka.IoTSiteWise.CreateAssetModel type AWSResponse CreateAssetModel = CreateAssetModelResponse

newCreateAssetModel Source #

Arguments

:: Text	`$sel:assetModelName:CreateAssetModel'`
-> CreateAssetModel

Create a value of CreateAssetModel 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:clientToken:CreateAssetModel', createAssetModel_clientToken - A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

$sel:assetModelDescription:CreateAssetModel', createAssetModel_assetModelDescription - A description for the asset model.

$sel:assetModelProperties:CreateAssetModel', createAssetModel_assetModelProperties - The property definitions of the asset model. For more information, see Asset properties in the IoT SiteWise User Guide.

You can specify up to 200 properties per asset model. For more information, see Quotas in the IoT SiteWise User Guide.

$sel:assetModelCompositeModels:CreateAssetModel', createAssetModel_assetModelCompositeModels - The composite asset models that are part of this asset model. Composite asset models are asset models that contain specific properties. Each composite model has a type that defines the properties that the composite model supports. Use composite asset models to define alarms on this asset model.

$sel:assetModelHierarchies:CreateAssetModel', createAssetModel_assetModelHierarchies - The hierarchy definitions of the asset model. Each hierarchy specifies an asset model whose assets can be children of any other assets created from this asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

You can specify up to 10 hierarchies per asset model. For more information, see Quotas in the IoT SiteWise User Guide.

$sel:tags:CreateAssetModel', createAssetModel_tags - A list of key-value pairs that contain metadata for the asset model. For more information, see Tagging your IoT SiteWise resources in the IoT SiteWise User Guide.

$sel:assetModelName:CreateAssetModel', createAssetModel_assetModelName - A unique, friendly name for the asset model.

Request Lenses

createAssetModel_clientToken :: Lens' CreateAssetModel (Maybe Text) Source #

A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

createAssetModel_assetModelDescription :: Lens' CreateAssetModel (Maybe Text) Source #

A description for the asset model.

createAssetModel_assetModelProperties :: Lens' CreateAssetModel (Maybe [AssetModelPropertyDefinition]) Source #

The property definitions of the asset model. For more information, see Asset properties in the IoT SiteWise User Guide.

You can specify up to 200 properties per asset model. For more information, see Quotas in the IoT SiteWise User Guide.

createAssetModel_assetModelCompositeModels :: Lens' CreateAssetModel (Maybe [AssetModelCompositeModelDefinition]) Source #

The composite asset models that are part of this asset model. Composite asset models are asset models that contain specific properties. Each composite model has a type that defines the properties that the composite model supports. Use composite asset models to define alarms on this asset model.

createAssetModel_assetModelHierarchies :: Lens' CreateAssetModel (Maybe [AssetModelHierarchyDefinition]) Source #

The hierarchy definitions of the asset model. Each hierarchy specifies an asset model whose assets can be children of any other assets created from this asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

You can specify up to 10 hierarchies per asset model. For more information, see Quotas in the IoT SiteWise User Guide.

createAssetModel_tags :: Lens' CreateAssetModel (Maybe (HashMap Text Text)) Source #

A list of key-value pairs that contain metadata for the asset model. For more information, see Tagging your IoT SiteWise resources in the IoT SiteWise User Guide.

createAssetModel_assetModelName :: Lens' CreateAssetModel Text Source #

A unique, friendly name for the asset model.

Destructuring the Response

data CreateAssetModelResponse Source #

See: newCreateAssetModelResponse smart constructor.

Constructors

CreateAssetModelResponse'

Fields

httpStatus :: Int
The response's http status code.
assetModelId :: Text
The ID of the asset model. You can use this ID when you call other IoT SiteWise APIs.

assetModelArn :: Text

The ARN of the asset model, which has the following format.

arn:${Partition}:iotsitewise:${Region}:${Account}:asset-model/${AssetModelId}

assetModelStatus :: AssetModelStatus
The status of the asset model, which contains a state (CREATING after successfully calling this operation) and any error message.

Instances

Instances details

Eq CreateAssetModelResponse Source #
Instance details Defined in Amazonka.IoTSiteWise.CreateAssetModel Methods (==) :: CreateAssetModelResponse -> CreateAssetModelResponse -> Bool # (/=) :: CreateAssetModelResponse -> CreateAssetModelResponse -> Bool #
Read CreateAssetModelResponse Source #
Instance details Defined in Amazonka.IoTSiteWise.CreateAssetModel Methods readsPrec :: Int -> ReadS CreateAssetModelResponse # readList :: ReadS [CreateAssetModelResponse] # readPrec :: ReadPrec CreateAssetModelResponse # readListPrec :: ReadPrec [CreateAssetModelResponse] #
Show CreateAssetModelResponse Source #
Instance details Defined in Amazonka.IoTSiteWise.CreateAssetModel Methods showsPrec :: Int -> CreateAssetModelResponse -> ShowS # show :: CreateAssetModelResponse -> String # showList :: [CreateAssetModelResponse] -> ShowS #
Generic CreateAssetModelResponse Source #
Instance details Defined in Amazonka.IoTSiteWise.CreateAssetModel Associated Types type Rep CreateAssetModelResponse :: Type -> Type # Methods from :: CreateAssetModelResponse -> Rep CreateAssetModelResponse x # to :: Rep CreateAssetModelResponse x -> CreateAssetModelResponse #
NFData CreateAssetModelResponse Source #
Instance details Defined in Amazonka.IoTSiteWise.CreateAssetModel Methods rnf :: CreateAssetModelResponse -> () #
type Rep CreateAssetModelResponse Source #
Instance details Defined in Amazonka.IoTSiteWise.CreateAssetModel type Rep CreateAssetModelResponse = D1 ('MetaData "CreateAssetModelResponse" "Amazonka.IoTSiteWise.CreateAssetModel" "libZSservicesZSamazonka-iotsitewiseZSamazonka-iotsitewise" 'False) (C1 ('MetaCons "CreateAssetModelResponse'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int) :: S1 ('MetaSel ('Just "assetModelId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)) :: (S1 ('MetaSel ('Just "assetModelArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "assetModelStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 AssetModelStatus))))

newCreateAssetModelResponse Source #

Arguments

:: Int	`$sel:httpStatus:CreateAssetModelResponse'`
-> Text	`$sel:assetModelId:CreateAssetModelResponse'`
-> Text	`$sel:assetModelArn:CreateAssetModelResponse'`
-> AssetModelStatus	`$sel:assetModelStatus:CreateAssetModelResponse'`
-> CreateAssetModelResponse

Create a value of CreateAssetModelResponse 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:httpStatus:CreateAssetModelResponse', createAssetModelResponse_httpStatus - The response's http status code.

$sel:assetModelId:CreateAssetModelResponse', createAssetModelResponse_assetModelId - The ID of the asset model. You can use this ID when you call other IoT SiteWise APIs.

$sel:assetModelArn:CreateAssetModelResponse', createAssetModelResponse_assetModelArn - The ARN of the asset model, which has the following format.

arn:${Partition}:iotsitewise:${Region}:${Account}:asset-model/${AssetModelId}

$sel:assetModelStatus:CreateAssetModelResponse', createAssetModelResponse_assetModelStatus - The status of the asset model, which contains a state (CREATING after successfully calling this operation) and any error message.

Response Lenses

createAssetModelResponse_httpStatus :: Lens' CreateAssetModelResponse Int Source #

The response's http status code.

createAssetModelResponse_assetModelId :: Lens' CreateAssetModelResponse Text Source #

The ID of the asset model. You can use this ID when you call other IoT SiteWise APIs.

createAssetModelResponse_assetModelArn :: Lens' CreateAssetModelResponse Text Source #

The ARN of the asset model, which has the following format.

arn:${Partition}:iotsitewise:${Region}:${Account}:asset-model/${AssetModelId}

createAssetModelResponse_assetModelStatus :: Lens' CreateAssetModelResponse AssetModelStatus Source #

The status of the asset model, which contains a state (CREATING after successfully calling this operation) and any error message.