com.amazonaws.services.iotevents

Interface AWSIoTEvents

All Known Subinterfaces:

AWSIoTEventsAsync

All Known Implementing Classes:

AbstractAWSIoTEvents, AbstractAWSIoTEventsAsync, AWSIoTEventsAsyncClient, AWSIoTEventsClient

@Generated(value="com.amazonaws:aws-java-sdk-code-generator")
public interface AWSIoTEvents

Interface for accessing AWS IoT Events.

Note: Do not directly implement this interface, new methods are added to it regularly. Extend from AbstractAWSIoTEvents instead.

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

Modifier and Type	Field and Description
static String	ENDPOINT_PREFIX The region metadata service name for computing region endpoints.

Method Summary

Modifier and Type	Method and Description
CreateDetectorModelResult	createDetectorModel(CreateDetectorModelRequest createDetectorModelRequest) Creates a detector model.
CreateInputResult	createInput(CreateInputRequest createInputRequest) Creates an input.
DeleteDetectorModelResult	deleteDetectorModel(DeleteDetectorModelRequest deleteDetectorModelRequest) Deletes a detector model.
DeleteInputResult	deleteInput(DeleteInputRequest deleteInputRequest) Deletes an input.
DescribeDetectorModelResult	describeDetectorModel(DescribeDetectorModelRequest describeDetectorModelRequest) Describes a detector model.
DescribeInputResult	describeInput(DescribeInputRequest describeInputRequest) Describes an input.
DescribeLoggingOptionsResult	describeLoggingOptions(DescribeLoggingOptionsRequest describeLoggingOptionsRequest) 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 listDetectorModelsRequest) Lists the detector models you have created.
ListDetectorModelVersionsResult	listDetectorModelVersions(ListDetectorModelVersionsRequest listDetectorModelVersionsRequest) Lists all the versions of a detector model.
ListInputsResult	listInputs(ListInputsRequest listInputsRequest) Lists the inputs you have created.
ListTagsForResourceResult	listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) Lists the tags (metadata) you have assigned to the resource.
PutLoggingOptionsResult	putLoggingOptions(PutLoggingOptionsRequest putLoggingOptionsRequest) Sets or updates the AWS IoT Events logging options.
void	shutdown() Shuts down this client object, releasing any resources that might be held open.
TagResourceResult	tagResource(TagResourceRequest tagResourceRequest) Adds to or modifies the tags of the given resource.
UntagResourceResult	untagResource(UntagResourceRequest untagResourceRequest) Removes the given tags (metadata) from the resource.
UpdateDetectorModelResult	updateDetectorModel(UpdateDetectorModelRequest updateDetectorModelRequest) Updates a detector model.
UpdateInputResult	updateInput(UpdateInputRequest updateInputRequest) Updates an input.

Field Detail

ENDPOINT_PREFIX

static final String ENDPOINT_PREFIX

The region metadata service name for computing region endpoints. You can use this value to retrieve metadata (such as supported regions) of the service.

See Also:

RegionUtils.getRegionsForService(String), Constant Field Values

Method Detail

createDetectorModel

CreateDetectorModelResult createDetectorModel(CreateDetectorModelRequest createDetectorModelRequest)

Creates a detector model.

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

CreateInputResult createInput(CreateInputRequest createInputRequest)

Creates an input.

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

DeleteDetectorModelResult deleteDetectorModel(DeleteDetectorModelRequest deleteDetectorModelRequest)

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

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

DeleteInputResult deleteInput(DeleteInputRequest deleteInputRequest)

Deletes an input.

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

DescribeDetectorModelResult describeDetectorModel(DescribeDetectorModelRequest describeDetectorModelRequest)

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

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

DescribeInputResult describeInput(DescribeInputRequest describeInputRequest)

Describes an input.

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

DescribeLoggingOptionsResult describeLoggingOptions(DescribeLoggingOptionsRequest describeLoggingOptionsRequest)

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

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

ListDetectorModelVersionsResult listDetectorModelVersions(ListDetectorModelVersionsRequest listDetectorModelVersionsRequest)

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

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

ListDetectorModelsResult listDetectorModels(ListDetectorModelsRequest listDetectorModelsRequest)

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

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

ListInputsResult listInputs(ListInputsRequest listInputsRequest)

Lists the inputs you have created.

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

ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)

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

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

PutLoggingOptionsResult putLoggingOptions(PutLoggingOptionsRequest putLoggingOptionsRequest)

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.

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

TagResourceResult tagResource(TagResourceRequest tagResourceRequest)

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

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

UntagResourceResult untagResource(UntagResourceRequest untagResourceRequest)

Removes the given tags (metadata) from the resource.

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

UpdateDetectorModelResult updateDetectorModel(UpdateDetectorModelRequest updateDetectorModelRequest)

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

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

UpdateInputResult updateInput(UpdateInputRequest updateInputRequest)

Updates an input.

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

shutdown

void shutdown()

Shuts down this client object, releasing any resources that might be held open. This is an optional method, and callers are not expected to call it, but can if they want to explicitly release any open resources. Once a client has been shutdown, it should not be used to make any more requests.

getCachedResponseMetadata

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

Parameters:

request - The originally executed request.

Returns:

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