amazonka-elasticsearch-1.4.0: Amazon Elasticsearch Service SDK.

Copyright(c) 2013-2016 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone
LanguageHaskell2010

Network.AWS.ElasticSearch

Contents

Description

Amazon Elasticsearch Configuration Service

Use the Amazon Elasticsearch configuration API to create, configure, and manage Elasticsearch domains.

The endpoint for configuration service requests is region-specific: es.region.amazonaws.com. For example, es.us-east-1.amazonaws.com. For a current list of supported regions and endpoints, see Regions and Endpoints.

Synopsis

Service Configuration

elasticSearch :: Service Source

API version '2015-01-01' of the Amazon Elasticsearch Service SDK configuration.

Errors

Error matchers are designed for use with the functions provided by Control.Exception.Lens. This allows catching (and rethrowing) service specific errors returned by ElasticSearch.

ValidationException

_ValidationException :: AsError a => Getting (First ServiceError) a ServiceError Source

An exception for missing / invalid input fields. Gives http status code of 400.

ResourceAlreadyExistsException

_ResourceAlreadyExistsException :: AsError a => Getting (First ServiceError) a ServiceError Source

An exception for creating a resource that already exists. Gives http status code of 400.

BaseException

_BaseException :: AsError a => Getting (First ServiceError) a ServiceError Source

An error occurred while processing the request.

DisabledOperationException

_DisabledOperationException :: AsError a => Getting (First ServiceError) a ServiceError Source

An error occured because the client wanted to access a not supported operation. Gives http status code of 409.

InternalException

_InternalException :: AsError a => Getting (First ServiceError) a ServiceError Source

The request processing has failed because of an unknown error, exception or failure (the failure is internal to the service) . Gives http status code of 500.

InvalidTypeException

_InvalidTypeException :: AsError a => Getting (First ServiceError) a ServiceError Source

An exception for trying to create or access sub-resource that is either invalid or not supported. Gives http status code of 409.

ResourceNotFoundException

_ResourceNotFoundException :: AsError a => Getting (First ServiceError) a ServiceError Source

An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.

LimitExceededException

_LimitExceededException :: AsError a => Getting (First ServiceError) a ServiceError Source

An exception for trying to create more than allowed resources or sub-resources. Gives http status code of 409.

Waiters

Waiters poll by repeatedly sending a request until some remote success condition configured by the Wait specification is fulfilled. The Wait specification determines how many attempts should be made, in addition to delay and retry strategies.

Operations

Some AWS operations return results that are incomplete and require subsequent requests in order to obtain the entire result set. The process of sending subsequent requests to continue where a previous request left off is called pagination. For example, the ListObjects operation of Amazon S3 returns up to 1000 objects at a time, and you must send subsequent requests with the appropriate Marker in order to retrieve the next page of results.

Operations that have an AWSPager instance can transparently perform subsequent requests, correctly setting Markers and other request facets to iterate through the entire result set of a truncated API operation. Operations which support this have an additional note in the documentation.

Many operations have the ability to filter results on the server side. See the individual operation parameters for details.

CreateElasticsearchDomain

RemoveTags

DescribeElasticsearchDomains

DescribeElasticsearchDomain

ListDomainNames

DescribeElasticsearchDomainConfig

DeleteElasticsearchDomain

UpdateElasticsearchDomainConfig

AddTags

ListTags

Types

ESPartitionInstanceType

OptionState

data OptionState Source

The state of a requested change. One of the following:

  • Processing: The request change is still in-process.
  • Active: The request change is processed and deployed to the Elasticsearch domain.

VolumeType

AccessPoliciesStatus

accessPoliciesStatus Source

Creates a value of AccessPoliciesStatus with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

apsOptions :: Lens' AccessPoliciesStatus Text Source

The access policy configured for the Elasticsearch domain. Access policies may be resource-based, IP-based, or IAM-based. See Configuring Access Policiesfor more information.

apsStatus :: Lens' AccessPoliciesStatus OptionStatus Source

The status of the access policy for the Elasticsearch domain. See OptionStatus for the status information that's included.

AdvancedOptionsStatus

data AdvancedOptionsStatus Source

Status of the advanced options for the specified Elasticsearch domain. Currently, the following advanced options are available:

  • Option to allow references to indices in an HTTP request body. Must be false when configuring access to individual sub-resources. By default, the value is true. See Configuration Advanced Options for more information.
  • Option to specify the percentage of heap space that is allocated to field data. By default, this setting is unbounded.

For more information, see Configuring Advanced Options.

See: advancedOptionsStatus smart constructor.

advancedOptionsStatus Source

Creates a value of AdvancedOptionsStatus with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

aosOptions :: Lens' AdvancedOptionsStatus (HashMap Text Text) Source

Specifies the status of advanced options for the specified Elasticsearch domain.

aosStatus :: Lens' AdvancedOptionsStatus OptionStatus Source

Specifies the status of OptionStatus for advanced options for the specified Elasticsearch domain.

DomainInfo

domainInfo :: DomainInfo Source

Creates a value of DomainInfo with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

diDomainName :: Lens' DomainInfo (Maybe Text) Source

Specifies the DomainName.

EBSOptions

data EBSOptions Source

Options to enable, disable, and specify the properties of EBS storage volumes. For more information, see Configuring EBS-based Storage.

See: ebsOptions smart constructor.

ebsOptions :: EBSOptions Source

Creates a value of EBSOptions with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

eoVolumeSize :: Lens' EBSOptions (Maybe Int) Source

Integer to specify the size of an EBS volume.

eoIOPS :: Lens' EBSOptions (Maybe Int) Source

Specifies the IOPD for a Provisioned IOPS EBS volume (SSD).

eoVolumeType :: Lens' EBSOptions (Maybe VolumeType) Source

Specifies the volume type for EBS-based storage.

eoEBSEnabled :: Lens' EBSOptions (Maybe Bool) Source

Specifies whether EBS-based storage is enabled.

EBSOptionsStatus

ebsOptionsStatus Source

Creates a value of EBSOptionsStatus with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

eosOptions :: Lens' EBSOptionsStatus EBSOptions Source

Specifies the EBS options for the specified Elasticsearch domain.

eosStatus :: Lens' EBSOptionsStatus OptionStatus Source

Specifies the status of the EBS options for the specified Elasticsearch domain.

ElasticsearchClusterConfig

elasticsearchClusterConfig :: ElasticsearchClusterConfig Source

Creates a value of ElasticsearchClusterConfig with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

eccDedicatedMasterCount :: Lens' ElasticsearchClusterConfig (Maybe Int) Source

Total number of dedicated master nodes, active and on standby, for the cluster.

eccDedicatedMasterEnabled :: Lens' ElasticsearchClusterConfig (Maybe Bool) Source

A boolean value to indicate whether a dedicated master node is enabled. See About Dedicated Master Nodes for more information.

eccInstanceCount :: Lens' ElasticsearchClusterConfig (Maybe Int) Source

The number of instances in the specified domain cluster.

eccZoneAwarenessEnabled :: Lens' ElasticsearchClusterConfig (Maybe Bool) Source

A boolean value to indicate whether zone awareness is enabled. See About Zone Awareness for more information.

eccInstanceType :: Lens' ElasticsearchClusterConfig (Maybe ESPartitionInstanceType) Source

The instance type for an Elasticsearch cluster.

ElasticsearchClusterConfigStatus

elasticsearchClusterConfigStatus Source

Creates a value of ElasticsearchClusterConfigStatus with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

eccsOptions :: Lens' ElasticsearchClusterConfigStatus ElasticsearchClusterConfig Source

Specifies the cluster configuration for the specified Elasticsearch domain.

eccsStatus :: Lens' ElasticsearchClusterConfigStatus OptionStatus Source

Specifies the status of the configuration for the specified Elasticsearch domain.

ElasticsearchDomainConfig

elasticsearchDomainConfig :: ElasticsearchDomainConfig Source

Creates a value of ElasticsearchDomainConfig with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

edcEBSOptions :: Lens' ElasticsearchDomainConfig (Maybe EBSOptionsStatus) Source

Specifies the EBSOptions for the Elasticsearch domain.

edcAccessPolicies :: Lens' ElasticsearchDomainConfig (Maybe AccessPoliciesStatus) Source

IAM access policy as a JSON-formatted string.

edcAdvancedOptions :: Lens' ElasticsearchDomainConfig (Maybe AdvancedOptionsStatus) Source

Specifies the AdvancedOptions for the domain. See Configuring Advanced Options for more information.

ElasticsearchDomainStatus

edsAccessPolicies :: Lens' ElasticsearchDomainStatus (Maybe Text) Source

IAM access policy as a JSON-formatted string.

edsCreated :: Lens' ElasticsearchDomainStatus (Maybe Bool) Source

The domain creation status. True if the creation of an Elasticsearch domain is complete. False if domain creation is still in progress.

edsDeleted :: Lens' ElasticsearchDomainStatus (Maybe Bool) Source

The domain deletion status. True if a delete request has been received for the domain but resource cleanup is still in progress. False if the domain has not been deleted. Once domain deletion is complete, the status of the domain is no longer returned.

edsProcessing :: Lens' ElasticsearchDomainStatus (Maybe Bool) Source

The status of the Elasticsearch domain configuration. True if Amazon Elasticsearch Service is processing configuration changes. False if the configuration is active.

edsEndpoint :: Lens' ElasticsearchDomainStatus (Maybe Text) Source

The Elasticsearch domain endpoint that you use to submit index and search requests.

edsAdvancedOptions :: Lens' ElasticsearchDomainStatus (HashMap Text Text) Source

Specifies the status of the AdvancedOptions

edsDomainId :: Lens' ElasticsearchDomainStatus Text Source

The unique identifier for the specified Elasticsearch domain.

edsDomainName :: Lens' ElasticsearchDomainStatus Text Source

The name of an Elasticsearch domain. Domain names are unique across the domains owned by an account within an AWS region. Domain names start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen).

edsARN :: Lens' ElasticsearchDomainStatus Text Source

The Amazon resource name (ARN) of an Elasticsearch domain. See Identifiers for IAM Entities in Using AWS Identity and Access Management for more information.

edsElasticsearchClusterConfig :: Lens' ElasticsearchDomainStatus ElasticsearchClusterConfig Source

The type and number of instances in the domain cluster.

OptionStatus

optionStatus Source

Creates a value of OptionStatus with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

osPendingDeletion :: Lens' OptionStatus (Maybe Bool) Source

Indicates whether the Elasticsearch domain is being deleted.

osUpdateVersion :: Lens' OptionStatus (Maybe Natural) Source

Specifies the latest version for the entity.

osCreationDate :: Lens' OptionStatus UTCTime Source

Timestamp which tells the creation date for the entity.

osUpdateDate :: Lens' OptionStatus UTCTime Source

Timestamp which tells the last updated time for the entity.

osState :: Lens' OptionStatus OptionState Source

Provides the OptionState for the Elasticsearch domain.

SnapshotOptions

data SnapshotOptions Source

Specifies the time, in UTC format, when the service takes a daily automated snapshot of the specified Elasticsearch domain. Default value is '0' hours.

See: snapshotOptions smart constructor.

snapshotOptions :: SnapshotOptions Source

Creates a value of SnapshotOptions with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

soAutomatedSnapshotStartHour :: Lens' SnapshotOptions (Maybe Int) Source

Specifies the time, in UTC format, when the service takes a daily automated snapshot of the specified Elasticsearch domain. Default value is '0' hours.

SnapshotOptionsStatus

snapshotOptionsStatus Source

Creates a value of SnapshotOptionsStatus with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

sosOptions :: Lens' SnapshotOptionsStatus SnapshotOptions Source

Specifies the daily snapshot options specified for the Elasticsearch domain.

sosStatus :: Lens' SnapshotOptionsStatus OptionStatus Source

Specifies the status of a daily automated snapshot.

Tag

data Tag Source

Specifies a key value pair for a resource tag.

See: tag smart constructor.

tag Source

Arguments

:: Text

tagKey

-> Text

tagValue

-> Tag 

Creates a value of Tag with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

tagKey :: Lens' Tag Text Source

Specifies the TagKey, the name of the tag. Tag keys must be unique for the Elasticsearch domain to which they are attached.

tagValue :: Lens' Tag Text Source

Specifies the TagValue, the value assigned to the corresponding tag key. Tag values can be null and do not have to be unique in a tag set. For example, you can have a key value pair in a tag set of 'project : Trinity' and 'cost-center : Trinity'