{ "version":"2.0", "metadata":{ "apiVersion":"2020-11-03", "endpointPrefix":"api.fleethub.iot", "jsonVersion":"1.1", "protocol":"rest-json", "serviceFullName":"AWS IoT Fleet Hub", "serviceId":"IoTFleetHub", "signatureVersion":"v4", "signingName":"iotfleethub", "uid":"iotfleethub-2020-11-03" }, "operations":{ "CreateApplication":{ "name":"CreateApplication", "http":{ "method":"POST", "requestUri":"/applications", "responseCode":201 }, "input":{"shape":"CreateApplicationRequest"}, "output":{"shape":"CreateApplicationResponse"}, "errors":[ {"shape":"InvalidRequestException"}, {"shape":"InternalFailureException"}, {"shape":"ThrottlingException"}, {"shape":"LimitExceededException"} ], "documentation":"

Creates a Fleet Hub for AWS IoT Device Management web application.

Fleet Hub for AWS IoT Device Management is in public preview and is subject to change.

" }, "DeleteApplication":{ "name":"DeleteApplication", "http":{ "method":"DELETE", "requestUri":"/applications/{applicationId}", "responseCode":204 }, "input":{"shape":"DeleteApplicationRequest"}, "output":{"shape":"DeleteApplicationResponse"}, "errors":[ {"shape":"InvalidRequestException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InternalFailureException"}, {"shape":"ThrottlingException"} ], "documentation":"

Deletes a Fleet Hub for AWS IoT Device Management web application.

Fleet Hub for AWS IoT Device Management is in public preview and is subject to change.

" }, "DescribeApplication":{ "name":"DescribeApplication", "http":{ "method":"GET", "requestUri":"/applications/{applicationId}", "responseCode":200 }, "input":{"shape":"DescribeApplicationRequest"}, "output":{"shape":"DescribeApplicationResponse"}, "errors":[ {"shape":"InvalidRequestException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InternalFailureException"}, {"shape":"ThrottlingException"} ], "documentation":"

Gets information about a Fleet Hub for AWS IoT Device Management web application.

Fleet Hub for AWS IoT Device Management is in public preview and is subject to change.

" }, "ListApplications":{ "name":"ListApplications", "http":{ "method":"GET", "requestUri":"/applications", "responseCode":200 }, "input":{"shape":"ListApplicationsRequest"}, "output":{"shape":"ListApplicationsResponse"}, "errors":[ {"shape":"InvalidRequestException"}, {"shape":"InternalFailureException"}, {"shape":"ThrottlingException"} ], "documentation":"

Gets a list of Fleet Hub for AWS IoT Device Management web applications for the current account.

Fleet Hub for AWS IoT Device Management is in public preview and is subject to change.

" }, "ListTagsForResource":{ "name":"ListTagsForResource", "http":{ "method":"GET", "requestUri":"/tags/{resourceArn}" }, "input":{"shape":"ListTagsForResourceRequest"}, "output":{"shape":"ListTagsForResourceResponse"}, "errors":[ {"shape":"InternalFailureException"}, {"shape":"InvalidRequestException"}, {"shape":"ResourceNotFoundException"} ], "documentation":"

Lists the tags for the specified resource.

Fleet Hub for AWS IoT Device Management is in public preview and is subject to change.

" }, "TagResource":{ "name":"TagResource", "http":{ "method":"POST", "requestUri":"/tags/{resourceArn}" }, "input":{"shape":"TagResourceRequest"}, "output":{"shape":"TagResourceResponse"}, "errors":[ {"shape":"InternalFailureException"}, {"shape":"InvalidRequestException"}, {"shape":"ResourceNotFoundException"} ], "documentation":"

Adds to or modifies the tags of the specified resource. Tags are metadata which can be used to manage a resource.

Fleet Hub for AWS IoT Device Management is in public preview and is subject to change.

" }, "UntagResource":{ "name":"UntagResource", "http":{ "method":"DELETE", "requestUri":"/tags/{resourceArn}" }, "input":{"shape":"UntagResourceRequest"}, "output":{"shape":"UntagResourceResponse"}, "errors":[ {"shape":"InternalFailureException"}, {"shape":"InvalidRequestException"}, {"shape":"ResourceNotFoundException"} ], "documentation":"

Removes the specified tags (metadata) from the resource.

Fleet Hub for AWS IoT Device Management is in public preview and is subject to change.

" }, "UpdateApplication":{ "name":"UpdateApplication", "http":{ "method":"PATCH", "requestUri":"/applications/{applicationId}", "responseCode":202 }, "input":{"shape":"UpdateApplicationRequest"}, "output":{"shape":"UpdateApplicationResponse"}, "errors":[ {"shape":"InvalidRequestException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InternalFailureException"}, {"shape":"ConflictException"}, {"shape":"ThrottlingException"} ], "documentation":"

Updates information about a Fleet Hub for a AWS IoT Device Management web application.

Fleet Hub for AWS IoT Device Management is in public preview and is subject to change.

" } }, "shapes":{ "ApplicationState":{ "type":"string", "enum":[ "CREATING", "DELETING", "ACTIVE", "CREATE_FAILED", "DELETE_FAILED" ] }, "ApplicationSummaries":{ "type":"list", "member":{"shape":"ApplicationSummary"} }, "ApplicationSummary":{ "type":"structure", "required":[ "applicationId", "applicationName", "applicationUrl" ], "members":{ "applicationId":{ "shape":"Id", "documentation":"

The unique Id of the web application.

" }, "applicationName":{ "shape":"Name", "documentation":"

The name of the web application.

" }, "applicationDescription":{ "shape":"Description", "documentation":"

An optional description of the web application.

" }, "applicationUrl":{ "shape":"Url", "documentation":"

The URL of the web application.

" }, "applicationCreationDate":{ "shape":"Timestamp", "documentation":"

The date (in Unix epoch time) when the web application was created.

" }, "applicationLastUpdateDate":{ "shape":"Timestamp", "documentation":"

The date (in Unix epoch time) when the web application was last updated.

" }, "applicationState":{ "shape":"ApplicationState", "documentation":"

The current state of the web application.

" } }, "documentation":"

A summary of information about a AWS IoT Device Management web application.

Fleet Hub for AWS IoT Device Management is in public preview and is subject to change.

" }, "Arn":{ "type":"string", "max":1600, "min":1, "pattern":"^arn:[!-~]+$" }, "ClientRequestToken":{ "type":"string", "max":64, "min":1, "pattern":"^[a-zA-Z0-9-_]+$" }, "ConflictException":{ "type":"structure", "members":{ "message":{"shape":"errorMessage"} }, "documentation":"

The request conflicts with the current state of the resource.

", "error":{"httpStatusCode":409}, "exception":true }, "CreateApplicationRequest":{ "type":"structure", "required":[ "applicationName", "roleArn" ], "members":{ "applicationName":{ "shape":"Name", "documentation":"

The name of the web application.

" }, "applicationDescription":{ "shape":"Description", "documentation":"

An optional description of the web application.

" }, "clientToken":{ "shape":"ClientRequestToken", "documentation":"

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.

", "idempotencyToken":true }, "roleArn":{ "shape":"Arn", "documentation":"

The ARN of the role that the web application assumes when it interacts with AWS IoT Core.

The name of the role must be in the form AWSIotFleetHub_random_string .

" }, "tags":{ "shape":"TagMap", "documentation":"

A set of key/value pairs that you can use to manage the web application resource.

" } } }, "CreateApplicationResponse":{ "type":"structure", "required":[ "applicationId", "applicationArn" ], "members":{ "applicationId":{ "shape":"Id", "documentation":"

The unique Id of the web application.

" }, "applicationArn":{ "shape":"Arn", "documentation":"

The ARN of the web application.

" } } }, "DeleteApplicationRequest":{ "type":"structure", "required":["applicationId"], "members":{ "applicationId":{ "shape":"Id", "documentation":"

The unique Id of the web application.

", "location":"uri", "locationName":"applicationId" }, "clientToken":{ "shape":"ClientRequestToken", "documentation":"

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.

", "idempotencyToken":true, "location":"querystring", "locationName":"clientToken" } } }, "DeleteApplicationResponse":{ "type":"structure", "members":{ } }, "DescribeApplicationRequest":{ "type":"structure", "required":["applicationId"], "members":{ "applicationId":{ "shape":"Id", "documentation":"

The unique Id of the web application.

", "location":"uri", "locationName":"applicationId" } } }, "DescribeApplicationResponse":{ "type":"structure", "required":[ "applicationId", "applicationArn", "applicationName", "applicationUrl", "applicationState", "applicationCreationDate", "applicationLastUpdateDate", "roleArn" ], "members":{ "applicationId":{ "shape":"Id", "documentation":"

The unique Id of the web application.

" }, "applicationArn":{ "shape":"Arn", "documentation":"

The ARN of the web application.

" }, "applicationName":{ "shape":"Name", "documentation":"

The name of the web application.

" }, "applicationDescription":{ "shape":"Description", "documentation":"

An optional description of the web application.

" }, "applicationUrl":{ "shape":"Url", "documentation":"

The URL of the web application.

" }, "applicationState":{ "shape":"ApplicationState", "documentation":"

The current state of the web application.

" }, "applicationCreationDate":{ "shape":"Timestamp", "documentation":"

The date (in Unix epoch time) when the application was created.

" }, "applicationLastUpdateDate":{ "shape":"Timestamp", "documentation":"

The date (in Unix epoch time) when the application was last updated.

" }, "roleArn":{ "shape":"Arn", "documentation":"

The ARN of the role that the web application assumes when it interacts with AWS IoT Core.

" }, "ssoClientId":{ "shape":"SsoClientId", "documentation":"

The Id of the single sign-on client that you use to authenticate and authorize users on the web application.

" }, "errorMessage":{ "shape":"ErrorMessage", "documentation":"

A message indicating why the DescribeApplication API failed.

" }, "tags":{ "shape":"TagMap", "documentation":"

A set of key/value pairs that you can use to manage the web application resource.

" } } }, "Description":{ "type":"string", "max":2048, "min":1, "pattern":"^[ -~]*$" }, "ErrorMessage":{"type":"string"}, "Id":{ "type":"string", "max":36, "min":36, "pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$" }, "InternalFailureException":{ "type":"structure", "members":{ "message":{"shape":"errorMessage"} }, "documentation":"

An unexpected error has occurred.

", "error":{"httpStatusCode":500}, "exception":true, "fault":true }, "InvalidRequestException":{ "type":"structure", "members":{ "message":{"shape":"errorMessage"} }, "documentation":"

The request is not valid.

", "error":{"httpStatusCode":400}, "exception":true }, "LimitExceededException":{ "type":"structure", "members":{ "message":{"shape":"errorMessage"} }, "documentation":"

A limit has been exceeded.

", "error":{"httpStatusCode":410}, "exception":true }, "ListApplicationsRequest":{ "type":"structure", "members":{ "nextToken":{ "shape":"NextToken", "documentation":"

A token used to get the next set of results.

", "location":"querystring", "locationName":"nextToken" } } }, "ListApplicationsResponse":{ "type":"structure", "members":{ "applicationSummaries":{ "shape":"ApplicationSummaries", "documentation":"

An array of objects that provide summaries of information about the web applications in the list.

" }, "nextToken":{ "shape":"NextToken", "documentation":"

A token used to get the next set of results.

" } } }, "ListTagsForResourceRequest":{ "type":"structure", "required":["resourceArn"], "members":{ "resourceArn":{ "shape":"ResourceArn", "documentation":"

The ARN of the resource.

", "location":"uri", "locationName":"resourceArn" } } }, "ListTagsForResourceResponse":{ "type":"structure", "members":{ "tags":{ "shape":"TagMap", "documentation":"

The list of tags assigned to the resource.

" } } }, "Name":{ "type":"string", "max":100, "min":1, "pattern":"^[ -~]*$" }, "NextToken":{ "type":"string", "max":2048, "min":1, "pattern":"^[A-Za-z0-9+/=]+$" }, "ResourceArn":{"type":"string"}, "ResourceNotFoundException":{ "type":"structure", "members":{ "message":{"shape":"errorMessage"} }, "documentation":"

The specified resource does not exist.

", "error":{"httpStatusCode":404}, "exception":true }, "SsoClientId":{"type":"string"}, "TagKey":{ "type":"string", "max":128, "min":1, "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" }, "TagKeyList":{ "type":"list", "member":{"shape":"TagKey"} }, "TagMap":{ "type":"map", "key":{"shape":"TagKey"}, "value":{"shape":"TagValue"}, "max":50, "min":1 }, "TagResourceRequest":{ "type":"structure", "required":[ "resourceArn", "tags" ], "members":{ "resourceArn":{ "shape":"ResourceArn", "documentation":"

The ARN of the resource.

", "location":"uri", "locationName":"resourceArn" }, "tags":{ "shape":"TagMap", "documentation":"

The new or modified tags for the resource.

" } } }, "TagResourceResponse":{ "type":"structure", "members":{ } }, "TagValue":{ "type":"string", "max":256, "min":1 }, "ThrottlingException":{ "type":"structure", "members":{ "message":{"shape":"errorMessage"} }, "documentation":"

The rate exceeds the limit.

", "error":{"httpStatusCode":400}, "exception":true }, "Timestamp":{"type":"long"}, "UntagResourceRequest":{ "type":"structure", "required":[ "resourceArn", "tagKeys" ], "members":{ "resourceArn":{ "shape":"ResourceArn", "documentation":"

The ARN of the resource.

", "location":"uri", "locationName":"resourceArn" }, "tagKeys":{ "shape":"TagKeyList", "documentation":"

A list of the keys of the tags to be removed from the resource.

", "location":"querystring", "locationName":"tagKeys" } } }, "UntagResourceResponse":{ "type":"structure", "members":{ } }, "UpdateApplicationRequest":{ "type":"structure", "required":["applicationId"], "members":{ "applicationId":{ "shape":"Id", "documentation":"

The unique Id of the web application.

", "location":"uri", "locationName":"applicationId" }, "applicationName":{ "shape":"Name", "documentation":"

The name of the web application.

" }, "applicationDescription":{ "shape":"Description", "documentation":"

An optional description of the web application.

" }, "clientToken":{ "shape":"ClientRequestToken", "documentation":"

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.

", "idempotencyToken":true } } }, "UpdateApplicationResponse":{ "type":"structure", "members":{ } }, "Url":{ "type":"string", "max":256, "min":1, "pattern":"^https\\://\\S+$" }, "errorMessage":{"type":"string"} }, "documentation":"

With Fleet Hub for AWS IoT Device Management you can build stand-alone web applications for monitoring the health of your device fleets.

Fleet Hub for AWS IoT Device Management is in public preview and is subject to change.

" }