com.amazonaws.services.iotevents

Class AWSIoTEventsClient

java.lang.Object

com.amazonaws.AmazonWebServiceClient

com.amazonaws.services.iotevents.AWSIoTEventsClient

All Implemented Interfaces:

AWSIoTEvents

Direct Known Subclasses:

AWSIoTEventsAsyncClient

@ThreadSafe
 @Generated(value="com.amazonaws:aws-java-sdk-code-generator")
public class AWSIoTEventsClient
extends AmazonWebServiceClient
implements AWSIoTEvents

Client for accessing AWS IoT Events. All service calls made using this client are blocking, and will not return until the service call completes.

AWS IoT Events monitors your equipment or device fleets for failures or changes in operation, and triggers actions when such events occur. AWS IoT Events API commands enable you to create, read, update and delete inputs and detector models, and to list their versions.

Field Summary

Fields inherited from class com.amazonaws.AmazonWebServiceClient

LOGGING_AWS_REQUEST_METRIC

Fields inherited from interface com.amazonaws.services.iotevents.AWSIoTEvents

ENDPOINT_PREFIX

Method Summary

Modifier and Type	Method and Description
static AWSIoTEventsClientBuilder	builder()
CreateDetectorModelResult	createDetectorModel(CreateDetectorModelRequest request) Creates a detector model.
CreateInputResult	createInput(CreateInputRequest request) Creates an input.
DeleteDetectorModelResult	deleteDetectorModel(DeleteDetectorModelRequest request) Deletes a detector model.
DeleteInputResult	deleteInput(DeleteInputRequest request) Deletes an input.
DescribeDetectorModelResult	describeDetectorModel(DescribeDetectorModelRequest request) Describes a detector model.
DescribeInputResult	describeInput(DescribeInputRequest request) Describes an input.
DescribeLoggingOptionsResult	describeLoggingOptions(DescribeLoggingOptionsRequest request) Retrieves the current settings of the AWS IoT Events logging options.
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.
ListDetectorModelsResult	listDetectorModels(ListDetectorModelsRequest request) Lists the detector models you have created.
ListDetectorModelVersionsResult	listDetectorModelVersions(ListDetectorModelVersionsRequest request) Lists all the versions of a detector model.
ListInputsResult	listInputs(ListInputsRequest request) Lists the inputs you have created.
ListTagsForResourceResult	listTagsForResource(ListTagsForResourceRequest request) Lists the tags (metadata) you have assigned to the resource.
PutLoggingOptionsResult	putLoggingOptions(PutLoggingOptionsRequest request) Sets or updates the AWS IoT Events logging options.
TagResourceResult	tagResource(TagResourceRequest request) Adds to or modifies the tags of the given resource.
UntagResourceResult	untagResource(UntagResourceRequest request) Removes the given tags (metadata) from the resource.
UpdateDetectorModelResult	updateDetectorModel(UpdateDetectorModelRequest request) Updates a detector model.
UpdateInputResult	updateInput(UpdateInputRequest request) Updates an input.

Methods inherited from class com.amazonaws.AmazonWebServiceClient

addRequestHandler, addRequestHandler, configureRegion, getClientConfiguration, getEndpointPrefix, getMonitoringListeners, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, shutdown, withEndpoint, withRegion, withRegion, withTimeOffset

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.amazonaws.services.iotevents.AWSIoTEvents

shutdown

Method Detail

builder

public static AWSIoTEventsClientBuilder builder()

createDetectorModel

public CreateDetectorModelResult createDetectorModel(CreateDetectorModelRequest request)

Creates a detector model.

Specified by:

createDetectorModel in interface AWSIoTEvents

Parameters:

createDetectorModelRequest -

Returns:

Result of the CreateDetectorModel operation returned by the service.

Throws:

InvalidRequestException - The request was invalid.

ResourceInUseException - The resource is in use.

ResourceAlreadyExistsException - The resource already exists.

LimitExceededException - A limit was exceeded.

ThrottlingException - The request could not be completed due to throttling.

InternalFailureException - An internal failure occurred.

ServiceUnavailableException - The service is currently unavailable.

See Also:

AWS API Documentation

createInput

public CreateInputResult createInput(CreateInputRequest request)

Creates an input.

Specified by:

createInput in interface AWSIoTEvents

Parameters:

createInputRequest -

Returns:

Result of the CreateInput operation returned by the service.

Throws:

InvalidRequestException - The request was invalid.

ThrottlingException - The request could not be completed due to throttling.

InternalFailureException - An internal failure occurred.

ServiceUnavailableException - The service is currently unavailable.

ResourceAlreadyExistsException - The resource already exists.

See Also:

AWS API Documentation

deleteDetectorModel

public DeleteDetectorModelResult deleteDetectorModel(DeleteDetectorModelRequest request)

Deletes a detector model. Any active instances of the detector model are also deleted.

Specified by:

deleteDetectorModel in interface AWSIoTEvents

Parameters:

deleteDetectorModelRequest -

Returns:

Result of the DeleteDetectorModel operation returned by the service.

Throws:

InvalidRequestException - The request was invalid.

ResourceInUseException - The resource is in use.

ResourceNotFoundException - The resource was not found.

ThrottlingException - The request could not be completed due to throttling.

InternalFailureException - An internal failure occurred.

ServiceUnavailableException - The service is currently unavailable.

See Also:

AWS API Documentation

deleteInput

public DeleteInputResult deleteInput(DeleteInputRequest request)

Deletes an input.

Specified by:

deleteInput in interface AWSIoTEvents

Parameters:

deleteInputRequest -

Returns:

Result of the DeleteInput operation returned by the service.

Throws:

InvalidRequestException - The request was invalid.

ResourceNotFoundException - The resource was not found.

ThrottlingException - The request could not be completed due to throttling.

InternalFailureException - An internal failure occurred.

ServiceUnavailableException - The service is currently unavailable.

ResourceInUseException - The resource is in use.

See Also:

AWS API Documentation

describeDetectorModel

public DescribeDetectorModelResult describeDetectorModel(DescribeDetectorModelRequest request)

Describes a detector model. If the "version" parameter is not specified, information about the latest version is returned.

Specified by:

describeDetectorModel in interface AWSIoTEvents

Parameters:

describeDetectorModelRequest -

Returns:

Result of the DescribeDetectorModel operation returned by the service.

Throws:

InvalidRequestException - The request was invalid.

ResourceNotFoundException - The resource was not found.

ThrottlingException - The request could not be completed due to throttling.

InternalFailureException - An internal failure occurred.

ServiceUnavailableException - The service is currently unavailable.

See Also:

AWS API Documentation

describeInput

public DescribeInputResult describeInput(DescribeInputRequest request)

Describes an input.

Specified by:

describeInput in interface AWSIoTEvents

Parameters:

describeInputRequest -

Returns:

Result of the DescribeInput operation returned by the service.

Throws:

InvalidRequestException - The request was invalid.

ResourceNotFoundException - The resource was not found.

ThrottlingException - The request could not be completed due to throttling.

InternalFailureException - An internal failure occurred.

ServiceUnavailableException - The service is currently unavailable.

See Also:

AWS API Documentation

describeLoggingOptions

public DescribeLoggingOptionsResult describeLoggingOptions(DescribeLoggingOptionsRequest request)

Retrieves the current settings of the AWS IoT Events logging options.

Specified by:

describeLoggingOptions in interface AWSIoTEvents

Parameters:

describeLoggingOptionsRequest -

Returns:

Result of the DescribeLoggingOptions operation returned by the service.

Throws:

InvalidRequestException - The request was invalid.

ThrottlingException - The request could not be completed due to throttling.

InternalFailureException - An internal failure occurred.

ResourceNotFoundException - The resource was not found.

ServiceUnavailableException - The service is currently unavailable.

UnsupportedOperationException - The requested operation is not supported.

See Also:

AWS API Documentation

listDetectorModelVersions

public ListDetectorModelVersionsResult listDetectorModelVersions(ListDetectorModelVersionsRequest request)

Lists all the versions of a detector model. Only the metadata associated with each detector model version is returned.

Specified by:

listDetectorModelVersions in interface AWSIoTEvents

Parameters:

listDetectorModelVersionsRequest -

Returns:

Result of the ListDetectorModelVersions operation returned by the service.

Throws:

InvalidRequestException - The request was invalid.

ResourceNotFoundException - The resource was not found.

ThrottlingException - The request could not be completed due to throttling.

InternalFailureException - An internal failure occurred.

ServiceUnavailableException - The service is currently unavailable.

See Also:

AWS API Documentation

listDetectorModels

public ListDetectorModelsResult listDetectorModels(ListDetectorModelsRequest request)

Lists the detector models you have created. Only the metadata associated with each detector model is returned.

Specified by:

listDetectorModels in interface AWSIoTEvents

Parameters:

listDetectorModelsRequest -

Returns:

Result of the ListDetectorModels operation returned by the service.

Throws:

InvalidRequestException - The request was invalid.

ThrottlingException - The request could not be completed due to throttling.

InternalFailureException - An internal failure occurred.

ServiceUnavailableException - The service is currently unavailable.

See Also:

AWS API Documentation

listInputs

public ListInputsResult listInputs(ListInputsRequest request)

Lists the inputs you have created.

Specified by:

listInputs in interface AWSIoTEvents

Parameters:

listInputsRequest -

Returns:

Result of the ListInputs operation returned by the service.

Throws:

InvalidRequestException - The request was invalid.

ThrottlingException - The request could not be completed due to throttling.

InternalFailureException - An internal failure occurred.

ServiceUnavailableException - The service is currently unavailable.

See Also:

AWS API Documentation

listTagsForResource

public ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest request)

Lists the tags (metadata) you have assigned to the resource.

Specified by:

listTagsForResource in interface AWSIoTEvents

Parameters:

listTagsForResourceRequest -

Returns:

Result of the ListTagsForResource operation returned by the service.

Throws:

InvalidRequestException - The request was invalid.

ResourceNotFoundException - The resource was not found.

ResourceInUseException - The resource is in use.

ThrottlingException - The request could not be completed due to throttling.

InternalFailureException - An internal failure occurred.

See Also:

AWS API Documentation

putLoggingOptions

public PutLoggingOptionsResult putLoggingOptions(PutLoggingOptionsRequest request)

Sets or updates the AWS IoT Events logging options.

If you update the value of any "loggingOptions" field, it takes up to one minute for the change to take effect. Also, if you change the policy attached to the role you specified in the "roleArn" field (for example, to correct an invalid policy) it takes up to five minutes for that change to take effect.

Specified by:

putLoggingOptions in interface AWSIoTEvents

Parameters:

putLoggingOptionsRequest -

Returns:

Result of the PutLoggingOptions operation returned by the service.

Throws:

InvalidRequestException - The request was invalid.

ThrottlingException - The request could not be completed due to throttling.

InternalFailureException - An internal failure occurred.

ServiceUnavailableException - The service is currently unavailable.

UnsupportedOperationException - The requested operation is not supported.

ResourceInUseException - The resource is in use.

See Also:

AWS API Documentation

tagResource

public TagResourceResult tagResource(TagResourceRequest request)

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

Specified by:

tagResource in interface AWSIoTEvents

Parameters:

tagResourceRequest -

Returns:

Result of the TagResource operation returned by the service.

Throws:

InvalidRequestException - The request was invalid.

ResourceNotFoundException - The resource was not found.

ResourceInUseException - The resource is in use.

ThrottlingException - The request could not be completed due to throttling.

LimitExceededException - A limit was exceeded.

InternalFailureException - An internal failure occurred.

See Also:

AWS API Documentation

untagResource

public UntagResourceResult untagResource(UntagResourceRequest request)

Removes the given tags (metadata) from the resource.

Specified by:

untagResource in interface AWSIoTEvents

Parameters:

untagResourceRequest -

Returns:

Result of the UntagResource operation returned by the service.

Throws:

InvalidRequestException - The request was invalid.

ResourceNotFoundException - The resource was not found.

ResourceInUseException - The resource is in use.

ThrottlingException - The request could not be completed due to throttling.

InternalFailureException - An internal failure occurred.

See Also:

AWS API Documentation

updateDetectorModel

public UpdateDetectorModelResult updateDetectorModel(UpdateDetectorModelRequest request)

Updates a detector model. Detectors (instances) spawned by the previous version are deleted and then re-created as new inputs arrive.

Specified by:

updateDetectorModel in interface AWSIoTEvents

Parameters:

updateDetectorModelRequest -

Returns:

Result of the UpdateDetectorModel operation returned by the service.

Throws:

InvalidRequestException - The request was invalid.

ResourceInUseException - The resource is in use.

ResourceNotFoundException - The resource was not found.

ThrottlingException - The request could not be completed due to throttling.

InternalFailureException - An internal failure occurred.

ServiceUnavailableException - The service is currently unavailable.

See Also:

AWS API Documentation

updateInput

public UpdateInputResult updateInput(UpdateInputRequest request)

Updates an input.

Specified by:

updateInput in interface AWSIoTEvents

Parameters:

updateInputRequest -

Returns:

Result of the UpdateInput operation returned by the service.

Throws:

InvalidRequestException - The request was invalid.

ThrottlingException - The request could not be completed due to throttling.

ResourceNotFoundException - The resource was not found.

InternalFailureException - An internal failure occurred.

ServiceUnavailableException - The service is currently unavailable.

ResourceInUseException - The resource is in use.

See Also:

AWS API Documentation

getCachedResponseMetadata

public 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. This data isn't considered part of the result data returned by an operation, so it's available through this separate, diagnostic interface.

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 the request.

Specified by:

getCachedResponseMetadata in interface AWSIoTEvents

Parameters:

request - The originally executed request

Returns:

The response metadata for the specified request, or null if none is available.