@Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AbstractAWSIotData extends Object implements AWSIotData
AWSIotData
. Convenient method forms pass through to the corresponding overload
that takes a request object, which throws an UnsupportedOperationException
.ENDPOINT_PREFIX
Modifier and Type | Method and Description |
---|---|
DeleteThingShadowResult |
deleteThingShadow(DeleteThingShadowRequest request)
Deletes the shadow for the specified thing.
|
ResponseMetadata |
getCachedResponseMetadata(AmazonWebServiceRequest request)
Returns additional metadata for a previously executed successful request, typically used for debugging issues
where a service isn't acting as expected.
|
GetRetainedMessageResult |
getRetainedMessage(GetRetainedMessageRequest request)
Gets the details of a single retained message for the specified topic.
|
GetThingShadowResult |
getThingShadow(GetThingShadowRequest request)
Gets the shadow for the specified thing.
|
ListNamedShadowsForThingResult |
listNamedShadowsForThing(ListNamedShadowsForThingRequest request)
Lists the shadows for the specified thing.
|
ListRetainedMessagesResult |
listRetainedMessages(ListRetainedMessagesRequest request)
Lists summary information about the retained messages stored for the account.
|
PublishResult |
publish(PublishRequest request)
Publishes an MQTT message.
|
void |
setEndpoint(String endpoint)
Overrides the default endpoint for this client ("https://data.iot.us-east-1.amazonaws.com").
|
void |
setRegion(Region region)
An alternative to
AWSIotData.setEndpoint(String) , sets the regional endpoint for this client's service
calls. |
void |
shutdown()
Shuts down this client object, releasing any resources that might be held open.
|
UpdateThingShadowResult |
updateThingShadow(UpdateThingShadowRequest request)
Updates the shadow for the specified thing.
|
public void setEndpoint(String endpoint)
AWSIotData
Callers can pass in just the endpoint (ex: "data.iot.us-east-1.amazonaws.com") or a full URL, including the
protocol (ex: "https://data.iot.us-east-1.amazonaws.com"). If the protocol is not specified here, the default
protocol from this client's ClientConfiguration
will be used, which by default is HTTPS.
For more information on using AWS regions with the AWS SDK for Java, and a complete list of all available endpoints for all AWS services, see: https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-region-selection.html#region-selection- choose-endpoint
This method is not threadsafe. An endpoint should be configured when the client is created and before any service requests are made. Changing it afterwards creates inevitable race conditions for any service requests in transit or retrying.
setEndpoint
in interface AWSIotData
endpoint
- The endpoint (ex: "data.iot.us-east-1.amazonaws.com") or a full URL, including the protocol (ex:
"https://data.iot.us-east-1.amazonaws.com") of the region specific AWS endpoint this client will
communicate with.public void setRegion(Region region)
AWSIotData
AWSIotData.setEndpoint(String)
, sets the regional endpoint for this client's service
calls. Callers can use this method to control which AWS region they want to work with.
By default, all service endpoints in all regions use the https protocol. To use http instead, specify it in the
ClientConfiguration
supplied at construction.
This method is not threadsafe. A region should be configured when the client is created and before any service requests are made. Changing it afterwards creates inevitable race conditions for any service requests in transit or retrying.
setRegion
in interface AWSIotData
region
- The region this client will communicate with. See Region.getRegion(com.amazonaws.regions.Regions)
for accessing a given region. Must not be null and must be a region where the service is available.Region.getRegion(com.amazonaws.regions.Regions)
,
Region.createClient(Class, com.amazonaws.auth.AWSCredentialsProvider, ClientConfiguration)
,
Region.isServiceSupported(String)
public DeleteThingShadowResult deleteThingShadow(DeleteThingShadowRequest request)
AWSIotData
Deletes the shadow for the specified thing.
Requires permission to access the DeleteThingShadow action.
For more information, see DeleteThingShadow in the IoT Developer Guide.
deleteThingShadow
in interface AWSIotData
request
- The input for the DeleteThingShadow operation.public GetRetainedMessageResult getRetainedMessage(GetRetainedMessageRequest request)
AWSIotData
Gets the details of a single retained message for the specified topic.
This action returns the message payload of the retained message, which can incur messaging costs. To list only the topic names of the retained messages, call ListRetainedMessages.
Requires permission to access the GetRetainedMessage action.
For more information about messaging costs, see Amazon Web Services IoT Core pricing - Messaging.
getRetainedMessage
in interface AWSIotData
request
- The input for the GetRetainedMessage operation.public GetThingShadowResult getThingShadow(GetThingShadowRequest request)
AWSIotData
Gets the shadow for the specified thing.
Requires permission to access the GetThingShadow action.
For more information, see GetThingShadow in the IoT Developer Guide.
getThingShadow
in interface AWSIotData
request
- The input for the GetThingShadow operation.public ListNamedShadowsForThingResult listNamedShadowsForThing(ListNamedShadowsForThingRequest request)
AWSIotData
Lists the shadows for the specified thing.
Requires permission to access the ListNamedShadowsForThing action.
listNamedShadowsForThing
in interface AWSIotData
public ListRetainedMessagesResult listRetainedMessages(ListRetainedMessagesRequest request)
AWSIotData
Lists summary information about the retained messages stored for the account.
This action returns only the topic names of the retained messages. It doesn't return any message payloads. Although this action doesn't return a message payload, it can still incur messaging costs.
To get the message payload of a retained message, call GetRetainedMessage with the topic name of the retained message.
Requires permission to access the ListRetainedMessages action.
For more information about messaging costs, see Amazon Web Services IoT Core pricing - Messaging.
listRetainedMessages
in interface AWSIotData
public PublishResult publish(PublishRequest request)
AWSIotData
Publishes an MQTT message.
Requires permission to access the Publish action.
For more information about MQTT messages, see MQTT Protocol in the IoT Developer Guide.
For more information about messaging costs, see Amazon Web Services IoT Core pricing - Messaging.
publish
in interface AWSIotData
request
- The input for the Publish operation.public UpdateThingShadowResult updateThingShadow(UpdateThingShadowRequest request)
AWSIotData
Updates the shadow for the specified thing.
Requires permission to access the UpdateThingShadow action.
For more information, see UpdateThingShadow in the IoT Developer Guide.
updateThingShadow
in interface AWSIotData
request
- The input for the UpdateThingShadow operation.public void shutdown()
AWSIotData
shutdown
in interface AWSIotData
public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
AWSIotData
Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing a request.
getCachedResponseMetadata
in interface AWSIotData
request
- The originally executed request.