@ThreadSafe @Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AmazonOpenSearchClient extends AmazonWebServiceClient implements AmazonOpenSearch
Use the Amazon OpenSearch Service configuration API to create, configure, and manage OpenSearch Service domains.
For sample code that uses the configuration API, see the Amazon OpenSearch Service Developer Guide . The guide also contains sample code for sending signed HTTP requests to the OpenSearch APIs. 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 Amazon Web Services service endpoints.
Modifier and Type | Field and Description |
---|---|
protected static ClientConfigurationFactory |
configFactory
Client configuration factory providing ClientConfigurations tailored to this client
|
client, clientConfiguration, endpoint, isEndpointOverridden, LOGGING_AWS_REQUEST_METRIC, requestHandler2s, timeOffset
ENDPOINT_PREFIX
Modifier and Type | Method and Description |
---|---|
AcceptInboundConnectionResult |
acceptInboundConnection(AcceptInboundConnectionRequest request)
Allows the destination Amazon OpenSearch Service domain owner to accept an inbound cross-cluster search
connection request.
|
AddTagsResult |
addTags(AddTagsRequest request)
Attaches tags to an existing Amazon OpenSearch Service domain.
|
AssociatePackageResult |
associatePackage(AssociatePackageRequest request)
Associates a package with an Amazon OpenSearch Service domain.
|
AuthorizeVpcEndpointAccessResult |
authorizeVpcEndpointAccess(AuthorizeVpcEndpointAccessRequest request)
Provides access to an Amazon OpenSearch Service domain through the use of an interface VPC endpoint.
|
static AmazonOpenSearchClientBuilder |
builder() |
CancelServiceSoftwareUpdateResult |
cancelServiceSoftwareUpdate(CancelServiceSoftwareUpdateRequest request)
Cancels a scheduled service software update for an Amazon OpenSearch Service domain.
|
CreateDomainResult |
createDomain(CreateDomainRequest request)
Creates an Amazon OpenSearch Service domain.
|
CreateOutboundConnectionResult |
createOutboundConnection(CreateOutboundConnectionRequest request)
Creates a new cross-cluster search connection from a source Amazon OpenSearch Service domain to a destination
domain.
|
CreatePackageResult |
createPackage(CreatePackageRequest request)
Creates a package for use with Amazon OpenSearch Service domains.
|
CreateVpcEndpointResult |
createVpcEndpoint(CreateVpcEndpointRequest request)
Creates an Amazon OpenSearch Service-managed VPC endpoint.
|
DeleteDomainResult |
deleteDomain(DeleteDomainRequest request)
Deletes an Amazon OpenSearch Service domain and all of its data.
|
DeleteInboundConnectionResult |
deleteInboundConnection(DeleteInboundConnectionRequest request)
Allows the destination Amazon OpenSearch Service domain owner to delete an existing inbound cross-cluster search
connection.
|
DeleteOutboundConnectionResult |
deleteOutboundConnection(DeleteOutboundConnectionRequest request)
Allows the source Amazon OpenSearch Service domain owner to delete an existing outbound cross-cluster search
connection.
|
DeletePackageResult |
deletePackage(DeletePackageRequest request)
Deletes an Amazon OpenSearch Service package.
|
DeleteVpcEndpointResult |
deleteVpcEndpoint(DeleteVpcEndpointRequest request)
Deletes an Amazon OpenSearch Service-managed interface VPC endpoint.
|
DescribeDomainResult |
describeDomain(DescribeDomainRequest request)
Describes the domain configuration for the specified Amazon OpenSearch Service domain, including the domain ID,
domain service endpoint, and domain ARN.
|
DescribeDomainAutoTunesResult |
describeDomainAutoTunes(DescribeDomainAutoTunesRequest request)
Returns the list of optimizations that Auto-Tune has made to an Amazon OpenSearch Service domain.
|
DescribeDomainChangeProgressResult |
describeDomainChangeProgress(DescribeDomainChangeProgressRequest request)
Returns information about the current blue/green deployment happening on an Amazon OpenSearch Service domain.
|
DescribeDomainConfigResult |
describeDomainConfig(DescribeDomainConfigRequest request)
Returns the configuration of an Amazon OpenSearch Service domain.
|
DescribeDomainsResult |
describeDomains(DescribeDomainsRequest request)
Returns domain configuration information about the specified Amazon OpenSearch Service domains.
|
DescribeInboundConnectionsResult |
describeInboundConnections(DescribeInboundConnectionsRequest request)
Lists all the inbound cross-cluster search connections for a destination (remote) Amazon OpenSearch Service
domain.
|
DescribeInstanceTypeLimitsResult |
describeInstanceTypeLimits(DescribeInstanceTypeLimitsRequest request)
Describes the instance count, storage, and master node limits for a given OpenSearch or Elasticsearch version and
instance type.
|
DescribeOutboundConnectionsResult |
describeOutboundConnections(DescribeOutboundConnectionsRequest request)
Lists all the outbound cross-cluster connections for a local (source) Amazon OpenSearch Service domain.
|
DescribePackagesResult |
describePackages(DescribePackagesRequest request)
Describes all packages available to OpenSearch Service.
|
DescribeReservedInstanceOfferingsResult |
describeReservedInstanceOfferings(DescribeReservedInstanceOfferingsRequest request)
Describes the available Amazon OpenSearch Service Reserved Instance offerings for a given Region.
|
DescribeReservedInstancesResult |
describeReservedInstances(DescribeReservedInstancesRequest request)
Describes the Amazon OpenSearch Service instances that you have reserved in a given Region.
|
DescribeVpcEndpointsResult |
describeVpcEndpoints(DescribeVpcEndpointsRequest request)
Describes one or more Amazon OpenSearch Service-managed VPC endpoints.
|
DissociatePackageResult |
dissociatePackage(DissociatePackageRequest request)
Removes a package from the specified Amazon OpenSearch Service domain.
|
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.
|
GetCompatibleVersionsResult |
getCompatibleVersions(GetCompatibleVersionsRequest request)
Returns a map of OpenSearch or Elasticsearch versions and the versions you can upgrade them to.
|
GetPackageVersionHistoryResult |
getPackageVersionHistory(GetPackageVersionHistoryRequest request)
Returns a list of Amazon OpenSearch Service package versions, along with their creation time and commit message.
|
GetUpgradeHistoryResult |
getUpgradeHistory(GetUpgradeHistoryRequest request)
Retrieves the complete history of the last 10 upgrades performed on an Amazon OpenSearch Service domain.
|
GetUpgradeStatusResult |
getUpgradeStatus(GetUpgradeStatusRequest request)
Returns the most recent status of the last upgrade or upgrade eligibility check performed on an Amazon OpenSearch
Service domain.
|
ListDomainNamesResult |
listDomainNames(ListDomainNamesRequest request)
Returns the names of all Amazon OpenSearch Service domains owned by the current user in the active Region.
|
ListDomainsForPackageResult |
listDomainsForPackage(ListDomainsForPackageRequest request)
Lists all Amazon OpenSearch Service domains associated with a given package.
|
ListInstanceTypeDetailsResult |
listInstanceTypeDetails(ListInstanceTypeDetailsRequest request)
Lists all instance types and available features for a given OpenSearch or Elasticsearch version.
|
ListPackagesForDomainResult |
listPackagesForDomain(ListPackagesForDomainRequest request)
Lists all packages associated with an Amazon OpenSearch Service domain.
|
ListTagsResult |
listTags(ListTagsRequest request)
Returns all resource tags for an Amazon OpenSearch Service domain.
|
ListVersionsResult |
listVersions(ListVersionsRequest request)
Lists all versions of OpenSearch and Elasticsearch that Amazon OpenSearch Service supports.
|
ListVpcEndpointAccessResult |
listVpcEndpointAccess(ListVpcEndpointAccessRequest request)
Retrieves information about each Amazon Web Services principal that is allowed to access a given Amazon
OpenSearch Service domain through the use of an interface VPC endpoint.
|
ListVpcEndpointsResult |
listVpcEndpoints(ListVpcEndpointsRequest request)
Retrieves all Amazon OpenSearch Service-managed VPC endpoints in the current Amazon Web Services account and
Region.
|
ListVpcEndpointsForDomainResult |
listVpcEndpointsForDomain(ListVpcEndpointsForDomainRequest request)
Retrieves all Amazon OpenSearch Service-managed VPC endpoints associated with a particular domain.
|
PurchaseReservedInstanceOfferingResult |
purchaseReservedInstanceOffering(PurchaseReservedInstanceOfferingRequest request)
Allows you to purchase Amazon OpenSearch Service Reserved Instances.
|
RejectInboundConnectionResult |
rejectInboundConnection(RejectInboundConnectionRequest request)
Allows the remote Amazon OpenSearch Service domain owner to reject an inbound cross-cluster connection request.
|
RemoveTagsResult |
removeTags(RemoveTagsRequest request)
Removes the specified set of tags from an Amazon OpenSearch Service domain.
|
RevokeVpcEndpointAccessResult |
revokeVpcEndpointAccess(RevokeVpcEndpointAccessRequest request)
Revokes access to an Amazon OpenSearch Service domain that was provided through an interface VPC endpoint.
|
void |
shutdown()
Shuts down this client object, releasing any resources that might be held open.
|
StartServiceSoftwareUpdateResult |
startServiceSoftwareUpdate(StartServiceSoftwareUpdateRequest request)
Schedules a service software update for an Amazon OpenSearch Service domain.
|
UpdateDomainConfigResult |
updateDomainConfig(UpdateDomainConfigRequest request)
Modifies the cluster configuration of the specified Amazon OpenSearch Service domain.
|
UpdatePackageResult |
updatePackage(UpdatePackageRequest request)
Updates a package for use with Amazon OpenSearch Service domains.
|
UpdateVpcEndpointResult |
updateVpcEndpoint(UpdateVpcEndpointRequest request)
Modifies an Amazon OpenSearch Service-managed interface VPC endpoint.
|
UpgradeDomainResult |
upgradeDomain(UpgradeDomainRequest request)
Allows you to either upgrade your Amazon OpenSearch Service domain or perform an upgrade eligibility check to a
compatible version of OpenSearch or Elasticsearch.
|
addRequestHandler, addRequestHandler, beforeClientExecution, beforeMarshalling, calculateCRC32FromCompressedData, checkMutability, configureRegion, createExecutionContext, createExecutionContext, createExecutionContext, createSignerProvider, endClientExecution, endClientExecution, getClientConfiguration, getClientId, getEndpointPrefix, getMonitoringListeners, getRequestMetricsCollector, getServiceAbbreviation, getServiceName, getServiceNameIntern, getSigner, getSignerByURI, getSignerOverride, getSignerProvider, getSignerRegionOverride, getSigningRegion, getTimeOffset, isCsmEnabled, isEndpointOverridden, isProfilingEnabled, isRequestMetricsEnabled, makeImmutable, removeRequestHandler, removeRequestHandler, requestMetricCollector, setEndpoint, setEndpoint, setEndpointPrefix, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, shouldGenerateClientSideMonitoringEvents, useStrictHostNameVerification, withEndpoint, withRegion, withRegion, withTimeOffset
protected static final ClientConfigurationFactory configFactory
public static AmazonOpenSearchClientBuilder builder()
public AcceptInboundConnectionResult acceptInboundConnection(AcceptInboundConnectionRequest request)
Allows the destination Amazon OpenSearch Service domain owner to accept an inbound cross-cluster search connection request. For more information, see Cross-cluster search for Amazon OpenSearch Service.
acceptInboundConnection
in interface AmazonOpenSearch
acceptInboundConnectionRequest
- Container for the parameters to the AcceptInboundConnection
operation.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.LimitExceededException
- An exception for trying to create more than allowed resources or sub-resources. Gives http status code of
409.DisabledOperationException
- An error occured because the client wanted to access a not supported operation. Gives http status code of
409.public AddTagsResult addTags(AddTagsRequest request)
Attaches tags to an existing Amazon OpenSearch Service domain. Tags are a set of case-sensitive key-value pairs. An domain can have up to 10 tags. For more information, see Tagging Amazon OpenSearch Service domains.
addTags
in interface AmazonOpenSearch
addTagsRequest
- Container for the parameters to the AddTags
operation. Specifies the tags to attach to the
domain.BaseException
- An error occurred while processing the request.LimitExceededException
- An exception for trying to create more than allowed resources or sub-resources. Gives http status code of
409.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.InternalException
- 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.public AssociatePackageResult associatePackage(AssociatePackageRequest request)
Associates a package with an Amazon OpenSearch Service domain. For more information, see Custom packages for Amazon OpenSearch Service.
associatePackage
in interface AmazonOpenSearch
associatePackageRequest
- Container for the request parameters to the AssociatePackage
operation.BaseException
- An error occurred while processing the request.InternalException
- 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.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.AccessDeniedException
- An error occurred because user does not have permissions to access the resource. Returns HTTP status code
403.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.ConflictException
- An error occurred because the client attempts to remove a resource that is currently in use. Returns HTTP
status code 409.public AuthorizeVpcEndpointAccessResult authorizeVpcEndpointAccess(AuthorizeVpcEndpointAccessRequest request)
Provides access to an Amazon OpenSearch Service domain through the use of an interface VPC endpoint.
authorizeVpcEndpointAccess
in interface AmazonOpenSearch
authorizeVpcEndpointAccessRequest
- ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.DisabledOperationException
- An error occured because the client wanted to access a not supported operation. Gives http status code of
409.LimitExceededException
- An exception for trying to create more than allowed resources or sub-resources. Gives http status code of
409.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.InternalException
- 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.BaseException
- An error occurred while processing the request.public CancelServiceSoftwareUpdateResult cancelServiceSoftwareUpdate(CancelServiceSoftwareUpdateRequest request)
Cancels a scheduled service software update for an Amazon OpenSearch Service domain. You can only perform this
operation before the AutomatedUpdateDate
and when the domain's UpdateStatus
is
PENDING_UPDATE
. For more information, see Service
software updates in Amazon OpenSearch Service.
cancelServiceSoftwareUpdate
in interface AmazonOpenSearch
cancelServiceSoftwareUpdateRequest
- Container for the request parameters to cancel a service software update.BaseException
- An error occurred while processing the request.InternalException
- 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.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.public CreateDomainResult createDomain(CreateDomainRequest request)
Creates an Amazon OpenSearch Service domain. For more information, see Creating and managing Amazon OpenSearch Service domains.
createDomain
in interface AmazonOpenSearch
createDomainRequest
- BaseException
- An error occurred while processing the request.DisabledOperationException
- An error occured because the client wanted to access a not supported operation. Gives http status code of
409.InternalException
- 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
- An exception for trying to create or access sub-resource that is either invalid or not supported. Gives
http status code of 409.LimitExceededException
- An exception for trying to create more than allowed resources or sub-resources. Gives http status code of
409.ResourceAlreadyExistsException
- An exception for creating a resource that already exists. Gives http status code of 400.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.public CreateOutboundConnectionResult createOutboundConnection(CreateOutboundConnectionRequest request)
Creates a new cross-cluster search connection from a source Amazon OpenSearch Service domain to a destination domain. For more information, see Cross-cluster search for Amazon OpenSearch Service.
createOutboundConnection
in interface AmazonOpenSearch
createOutboundConnectionRequest
- Container for the parameters to the CreateOutboundConnection
operation.LimitExceededException
- An exception for trying to create more than allowed resources or sub-resources. Gives http status code of
409.InternalException
- 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.ResourceAlreadyExistsException
- An exception for creating a resource that already exists. Gives http status code of 400.DisabledOperationException
- An error occured because the client wanted to access a not supported operation. Gives http status code of
409.public CreatePackageResult createPackage(CreatePackageRequest request)
Creates a package for use with Amazon OpenSearch Service domains. For more information, see Custom packages for Amazon OpenSearch Service.
createPackage
in interface AmazonOpenSearch
createPackageRequest
- Container for request parameters to the CreatePackage
operation.BaseException
- An error occurred while processing the request.InternalException
- 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.LimitExceededException
- An exception for trying to create more than allowed resources or sub-resources. Gives http status code of
409.InvalidTypeException
- An exception for trying to create or access sub-resource that is either invalid or not supported. Gives
http status code of 409.ResourceAlreadyExistsException
- An exception for creating a resource that already exists. Gives http status code of 400.AccessDeniedException
- An error occurred because user does not have permissions to access the resource. Returns HTTP status code
403.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.public CreateVpcEndpointResult createVpcEndpoint(CreateVpcEndpointRequest request)
Creates an Amazon OpenSearch Service-managed VPC endpoint.
createVpcEndpoint
in interface AmazonOpenSearch
createVpcEndpointRequest
- ConflictException
- An error occurred because the client attempts to remove a resource that is currently in use. Returns HTTP
status code 409.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.LimitExceededException
- An exception for trying to create more than allowed resources or sub-resources. Gives http status code of
409.InternalException
- 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.DisabledOperationException
- An error occured because the client wanted to access a not supported operation. Gives http status code of
409.BaseException
- An error occurred while processing the request.public DeleteDomainResult deleteDomain(DeleteDomainRequest request)
Deletes an Amazon OpenSearch Service domain and all of its data. You can't recover a domain after you delete it.
deleteDomain
in interface AmazonOpenSearch
deleteDomainRequest
- Container for the parameters to the DeleteDomain
operation.BaseException
- An error occurred while processing the request.InternalException
- 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.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.public DeleteInboundConnectionResult deleteInboundConnection(DeleteInboundConnectionRequest request)
Allows the destination Amazon OpenSearch Service domain owner to delete an existing inbound cross-cluster search connection. For more information, see Cross-cluster search for Amazon OpenSearch Service.
deleteInboundConnection
in interface AmazonOpenSearch
deleteInboundConnectionRequest
- Container for the parameters to the DeleteInboundConnection
operation.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.DisabledOperationException
- An error occured because the client wanted to access a not supported operation. Gives http status code of
409.public DeleteOutboundConnectionResult deleteOutboundConnection(DeleteOutboundConnectionRequest request)
Allows the source Amazon OpenSearch Service domain owner to delete an existing outbound cross-cluster search connection. For more information, see Cross-cluster search for Amazon OpenSearch Service.
deleteOutboundConnection
in interface AmazonOpenSearch
deleteOutboundConnectionRequest
- Container for the parameters to the DeleteOutboundConnection
operation.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.DisabledOperationException
- An error occured because the client wanted to access a not supported operation. Gives http status code of
409.public DeletePackageResult deletePackage(DeletePackageRequest request)
Deletes an Amazon OpenSearch Service package. For more information, see Custom packages for Amazon OpenSearch Service.
deletePackage
in interface AmazonOpenSearch
deletePackageRequest
- Deletes a package from OpenSearch Service. The package can't be associated with any OpenSearch Service
domain.BaseException
- An error occurred while processing the request.InternalException
- 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.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.AccessDeniedException
- An error occurred because user does not have permissions to access the resource. Returns HTTP status code
403.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.ConflictException
- An error occurred because the client attempts to remove a resource that is currently in use. Returns HTTP
status code 409.public DeleteVpcEndpointResult deleteVpcEndpoint(DeleteVpcEndpointRequest request)
Deletes an Amazon OpenSearch Service-managed interface VPC endpoint.
deleteVpcEndpoint
in interface AmazonOpenSearch
deleteVpcEndpointRequest
- ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.DisabledOperationException
- An error occured because the client wanted to access a not supported operation. Gives http status code of
409.InternalException
- 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.BaseException
- An error occurred while processing the request.public DescribeDomainResult describeDomain(DescribeDomainRequest request)
Describes the domain configuration for the specified Amazon OpenSearch Service domain, including the domain ID, domain service endpoint, and domain ARN.
describeDomain
in interface AmazonOpenSearch
describeDomainRequest
- Container for the parameters to the DescribeDomain
operation.BaseException
- An error occurred while processing the request.InternalException
- 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.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.public DescribeDomainAutoTunesResult describeDomainAutoTunes(DescribeDomainAutoTunesRequest request)
Returns the list of optimizations that Auto-Tune has made to an Amazon OpenSearch Service domain. For more information, see Auto-Tune for Amazon OpenSearch Service.
describeDomainAutoTunes
in interface AmazonOpenSearch
describeDomainAutoTunesRequest
- Container for the parameters to the DescribeDomainAutoTunes
operation.BaseException
- An error occurred while processing the request.InternalException
- 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.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.public DescribeDomainChangeProgressResult describeDomainChangeProgress(DescribeDomainChangeProgressRequest request)
Returns information about the current blue/green deployment happening on an Amazon OpenSearch Service domain. For more information, see Making configuration changes in Amazon OpenSearch Service.
describeDomainChangeProgress
in interface AmazonOpenSearch
describeDomainChangeProgressRequest
- Container for the parameters to the DescribeDomainChangeProgress
operation.BaseException
- An error occurred while processing the request.InternalException
- 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.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.public DescribeDomainConfigResult describeDomainConfig(DescribeDomainConfigRequest request)
Returns the configuration of an Amazon OpenSearch Service domain.
describeDomainConfig
in interface AmazonOpenSearch
describeDomainConfigRequest
- Container for the parameters to the DescribeDomainConfig
operation.BaseException
- An error occurred while processing the request.InternalException
- 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.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.public DescribeDomainsResult describeDomains(DescribeDomainsRequest request)
Returns domain configuration information about the specified Amazon OpenSearch Service domains.
describeDomains
in interface AmazonOpenSearch
describeDomainsRequest
- Container for the parameters to the DescribeDomains
operation.BaseException
- An error occurred while processing the request.InternalException
- 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.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.public DescribeInboundConnectionsResult describeInboundConnections(DescribeInboundConnectionsRequest request)
Lists all the inbound cross-cluster search connections for a destination (remote) Amazon OpenSearch Service domain. For more information, see Cross-cluster search for Amazon OpenSearch Service.
describeInboundConnections
in interface AmazonOpenSearch
describeInboundConnectionsRequest
- Container for the parameters to the DescribeInboundConnections
operation.InvalidPaginationTokenException
- The request processing has failed because of invalid pagination token provided by customer. Returns an
HTTP status code of 400.DisabledOperationException
- An error occured because the client wanted to access a not supported operation. Gives http status code of
409.public DescribeInstanceTypeLimitsResult describeInstanceTypeLimits(DescribeInstanceTypeLimitsRequest request)
Describes the instance count, storage, and master node limits for a given OpenSearch or Elasticsearch version and instance type.
describeInstanceTypeLimits
in interface AmazonOpenSearch
describeInstanceTypeLimitsRequest
- Container for the parameters to the DescribeInstanceTypeLimits
operation.BaseException
- An error occurred while processing the request.InternalException
- 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
- An exception for trying to create or access sub-resource that is either invalid or not supported. Gives
http status code of 409.LimitExceededException
- An exception for trying to create more than allowed resources or sub-resources. Gives http status code of
409.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.public DescribeOutboundConnectionsResult describeOutboundConnections(DescribeOutboundConnectionsRequest request)
Lists all the outbound cross-cluster connections for a local (source) Amazon OpenSearch Service domain. For more information, see Cross-cluster search for Amazon OpenSearch Service.
describeOutboundConnections
in interface AmazonOpenSearch
describeOutboundConnectionsRequest
- Container for the parameters to the DescribeOutboundConnections
operation.InvalidPaginationTokenException
- The request processing has failed because of invalid pagination token provided by customer. Returns an
HTTP status code of 400.DisabledOperationException
- An error occured because the client wanted to access a not supported operation. Gives http status code of
409.public DescribePackagesResult describePackages(DescribePackagesRequest request)
Describes all packages available to OpenSearch Service. For more information, see Custom packages for Amazon OpenSearch Service.
describePackages
in interface AmazonOpenSearch
describePackagesRequest
- Container for the request parameters to the DescribePackage
operation.BaseException
- An error occurred while processing the request.InternalException
- 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.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.AccessDeniedException
- An error occurred because user does not have permissions to access the resource. Returns HTTP status code
403.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.public DescribeReservedInstanceOfferingsResult describeReservedInstanceOfferings(DescribeReservedInstanceOfferingsRequest request)
Describes the available Amazon OpenSearch Service Reserved Instance offerings for a given Region. For more information, see Reserved Instances in Amazon OpenSearch Service.
describeReservedInstanceOfferings
in interface AmazonOpenSearch
describeReservedInstanceOfferingsRequest
- Container for the request parameters to a DescribeReservedInstanceOfferings
operation.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.DisabledOperationException
- An error occured because the client wanted to access a not supported operation. Gives http status code of
409.InternalException
- 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.public DescribeReservedInstancesResult describeReservedInstances(DescribeReservedInstancesRequest request)
Describes the Amazon OpenSearch Service instances that you have reserved in a given Region. For more information, see Reserved Instances in Amazon OpenSearch Service.
describeReservedInstances
in interface AmazonOpenSearch
describeReservedInstancesRequest
- Container for the request parameters to the DescribeReservedInstances
operation.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.InternalException
- 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.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.DisabledOperationException
- An error occured because the client wanted to access a not supported operation. Gives http status code of
409.public DescribeVpcEndpointsResult describeVpcEndpoints(DescribeVpcEndpointsRequest request)
Describes one or more Amazon OpenSearch Service-managed VPC endpoints.
describeVpcEndpoints
in interface AmazonOpenSearch
describeVpcEndpointsRequest
- ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.InternalException
- 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.DisabledOperationException
- An error occured because the client wanted to access a not supported operation. Gives http status code of
409.BaseException
- An error occurred while processing the request.public DissociatePackageResult dissociatePackage(DissociatePackageRequest request)
Removes a package from the specified Amazon OpenSearch Service domain. The package can't be in use with any OpenSearch index for the dissociation to succeed. The package is still available in OpenSearch Service for association later. For more information, see Custom packages for Amazon OpenSearch Service.
dissociatePackage
in interface AmazonOpenSearch
dissociatePackageRequest
- Container for the request parameters to the DissociatePackage
operation.BaseException
- An error occurred while processing the request.InternalException
- 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.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.AccessDeniedException
- An error occurred because user does not have permissions to access the resource. Returns HTTP status code
403.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.ConflictException
- An error occurred because the client attempts to remove a resource that is currently in use. Returns HTTP
status code 409.public GetCompatibleVersionsResult getCompatibleVersions(GetCompatibleVersionsRequest request)
Returns a map of OpenSearch or Elasticsearch versions and the versions you can upgrade them to.
getCompatibleVersions
in interface AmazonOpenSearch
getCompatibleVersionsRequest
- Container for the request parameters to GetCompatibleVersions
operation.BaseException
- An error occurred while processing the request.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.DisabledOperationException
- An error occured because the client wanted to access a not supported operation. Gives http status code of
409.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.InternalException
- 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.public GetPackageVersionHistoryResult getPackageVersionHistory(GetPackageVersionHistoryRequest request)
Returns a list of Amazon OpenSearch Service package versions, along with their creation time and commit message. For more information, see Custom packages for Amazon OpenSearch Service.
getPackageVersionHistory
in interface AmazonOpenSearch
getPackageVersionHistoryRequest
- Container for the request parameters to the GetPackageVersionHistory
operation.BaseException
- An error occurred while processing the request.InternalException
- 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.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.AccessDeniedException
- An error occurred because user does not have permissions to access the resource. Returns HTTP status code
403.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.public GetUpgradeHistoryResult getUpgradeHistory(GetUpgradeHistoryRequest request)
Retrieves the complete history of the last 10 upgrades performed on an Amazon OpenSearch Service domain.
getUpgradeHistory
in interface AmazonOpenSearch
getUpgradeHistoryRequest
- Container for the request parameters to the GetUpgradeHistory
operation.BaseException
- An error occurred while processing the request.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.DisabledOperationException
- An error occured because the client wanted to access a not supported operation. Gives http status code of
409.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.InternalException
- 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.public GetUpgradeStatusResult getUpgradeStatus(GetUpgradeStatusRequest request)
Returns the most recent status of the last upgrade or upgrade eligibility check performed on an Amazon OpenSearch Service domain.
getUpgradeStatus
in interface AmazonOpenSearch
getUpgradeStatusRequest
- Container for the request parameters to the GetUpgradeStatus
operation.BaseException
- An error occurred while processing the request.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.DisabledOperationException
- An error occured because the client wanted to access a not supported operation. Gives http status code of
409.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.InternalException
- 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.public ListDomainNamesResult listDomainNames(ListDomainNamesRequest request)
Returns the names of all Amazon OpenSearch Service domains owned by the current user in the active Region.
listDomainNames
in interface AmazonOpenSearch
listDomainNamesRequest
- Container for the parameters to the ListDomainNames
operation.BaseException
- An error occurred while processing the request.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.public ListDomainsForPackageResult listDomainsForPackage(ListDomainsForPackageRequest request)
Lists all Amazon OpenSearch Service domains associated with a given package. For more information, see Custom packages for Amazon OpenSearch Service.
listDomainsForPackage
in interface AmazonOpenSearch
listDomainsForPackageRequest
- Container for the request parameters to the ListDomainsForPackage
operation.BaseException
- An error occurred while processing the request.InternalException
- 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.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.AccessDeniedException
- An error occurred because user does not have permissions to access the resource. Returns HTTP status code
403.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.public ListInstanceTypeDetailsResult listInstanceTypeDetails(ListInstanceTypeDetailsRequest request)
Lists all instance types and available features for a given OpenSearch or Elasticsearch version.
listInstanceTypeDetails
in interface AmazonOpenSearch
listInstanceTypeDetailsRequest
- BaseException
- An error occurred while processing the request.InternalException
- 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.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.public ListPackagesForDomainResult listPackagesForDomain(ListPackagesForDomainRequest request)
Lists all packages associated with an Amazon OpenSearch Service domain. For more information, see Custom packages for Amazon OpenSearch Service.
listPackagesForDomain
in interface AmazonOpenSearch
listPackagesForDomainRequest
- Container for the request parameters to the ListPackagesForDomain
operation.BaseException
- An error occurred while processing the request.InternalException
- 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.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.AccessDeniedException
- An error occurred because user does not have permissions to access the resource. Returns HTTP status code
403.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.public ListTagsResult listTags(ListTagsRequest request)
Returns all resource tags for an Amazon OpenSearch Service domain. For more information, see Tagging Amazon OpenSearch Service domains.
listTags
in interface AmazonOpenSearch
listTagsRequest
- Container for the parameters to the ListTags
operation.BaseException
- An error occurred while processing the request.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.InternalException
- 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.public ListVersionsResult listVersions(ListVersionsRequest request)
Lists all versions of OpenSearch and Elasticsearch that Amazon OpenSearch Service supports.
listVersions
in interface AmazonOpenSearch
listVersionsRequest
- Container for the request parameters to the ListVersions
operation.BaseException
- An error occurred while processing the request.InternalException
- 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.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.public ListVpcEndpointAccessResult listVpcEndpointAccess(ListVpcEndpointAccessRequest request)
Retrieves information about each Amazon Web Services principal that is allowed to access a given Amazon OpenSearch Service domain through the use of an interface VPC endpoint.
listVpcEndpointAccess
in interface AmazonOpenSearch
listVpcEndpointAccessRequest
- ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.DisabledOperationException
- An error occured because the client wanted to access a not supported operation. Gives http status code of
409.InternalException
- 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.BaseException
- An error occurred while processing the request.public ListVpcEndpointsResult listVpcEndpoints(ListVpcEndpointsRequest request)
Retrieves all Amazon OpenSearch Service-managed VPC endpoints in the current Amazon Web Services account and Region.
listVpcEndpoints
in interface AmazonOpenSearch
listVpcEndpointsRequest
- InternalException
- 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.DisabledOperationException
- An error occured because the client wanted to access a not supported operation. Gives http status code of
409.BaseException
- An error occurred while processing the request.public ListVpcEndpointsForDomainResult listVpcEndpointsForDomain(ListVpcEndpointsForDomainRequest request)
Retrieves all Amazon OpenSearch Service-managed VPC endpoints associated with a particular domain.
listVpcEndpointsForDomain
in interface AmazonOpenSearch
listVpcEndpointsForDomainRequest
- InternalException
- 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.DisabledOperationException
- An error occured because the client wanted to access a not supported operation. Gives http status code of
409.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.BaseException
- An error occurred while processing the request.public PurchaseReservedInstanceOfferingResult purchaseReservedInstanceOffering(PurchaseReservedInstanceOfferingRequest request)
Allows you to purchase Amazon OpenSearch Service Reserved Instances.
purchaseReservedInstanceOffering
in interface AmazonOpenSearch
purchaseReservedInstanceOfferingRequest
- Container for request parameters to the PurchaseReservedInstanceOffering
operation.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.ResourceAlreadyExistsException
- An exception for creating a resource that already exists. Gives http status code of 400.LimitExceededException
- An exception for trying to create more than allowed resources or sub-resources. Gives http status code of
409.DisabledOperationException
- An error occured because the client wanted to access a not supported operation. Gives http status code of
409.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.InternalException
- 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.public RejectInboundConnectionResult rejectInboundConnection(RejectInboundConnectionRequest request)
Allows the remote Amazon OpenSearch Service domain owner to reject an inbound cross-cluster connection request.
rejectInboundConnection
in interface AmazonOpenSearch
rejectInboundConnectionRequest
- Container for the request parameters to the RejectInboundConnection
operation.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.DisabledOperationException
- An error occured because the client wanted to access a not supported operation. Gives http status code of
409.public RemoveTagsResult removeTags(RemoveTagsRequest request)
Removes the specified set of tags from an Amazon OpenSearch Service domain. For more information, see Tagging Amazon OpenSearch Service domains.
removeTags
in interface AmazonOpenSearch
removeTagsRequest
- Container for the request parameters to the RemoveTags
operation.BaseException
- An error occurred while processing the request.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.InternalException
- 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.public RevokeVpcEndpointAccessResult revokeVpcEndpointAccess(RevokeVpcEndpointAccessRequest request)
Revokes access to an Amazon OpenSearch Service domain that was provided through an interface VPC endpoint.
revokeVpcEndpointAccess
in interface AmazonOpenSearch
revokeVpcEndpointAccessRequest
- ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.DisabledOperationException
- An error occured because the client wanted to access a not supported operation. Gives http status code of
409.InternalException
- 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.BaseException
- An error occurred while processing the request.public StartServiceSoftwareUpdateResult startServiceSoftwareUpdate(StartServiceSoftwareUpdateRequest request)
Schedules a service software update for an Amazon OpenSearch Service domain. For more information, see Service software updates in Amazon OpenSearch Service.
startServiceSoftwareUpdate
in interface AmazonOpenSearch
startServiceSoftwareUpdateRequest
- Container for the request parameters to the StartServiceSoftwareUpdate
operation.BaseException
- An error occurred while processing the request.InternalException
- 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.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.public UpdateDomainConfigResult updateDomainConfig(UpdateDomainConfigRequest request)
Modifies the cluster configuration of the specified Amazon OpenSearch Service domain.
updateDomainConfig
in interface AmazonOpenSearch
updateDomainConfigRequest
- Container for the request parameters to the UpdateDomain
operation.BaseException
- An error occurred while processing the request.InternalException
- 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
- An exception for trying to create or access sub-resource that is either invalid or not supported. Gives
http status code of 409.LimitExceededException
- An exception for trying to create more than allowed resources or sub-resources. Gives http status code of
409.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.public UpdatePackageResult updatePackage(UpdatePackageRequest request)
Updates a package for use with Amazon OpenSearch Service domains. For more information, see Custom packages for Amazon OpenSearch Service.
updatePackage
in interface AmazonOpenSearch
updatePackageRequest
- Container for request parameters to the UpdatePackage
operation.BaseException
- An error occurred while processing the request.InternalException
- 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.LimitExceededException
- An exception for trying to create more than allowed resources or sub-resources. Gives http status code of
409.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.AccessDeniedException
- An error occurred because user does not have permissions to access the resource. Returns HTTP status code
403.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.public UpdateVpcEndpointResult updateVpcEndpoint(UpdateVpcEndpointRequest request)
Modifies an Amazon OpenSearch Service-managed interface VPC endpoint.
updateVpcEndpoint
in interface AmazonOpenSearch
updateVpcEndpointRequest
- ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.DisabledOperationException
- An error occured because the client wanted to access a not supported operation. Gives http status code of
409.InternalException
- 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.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.ConflictException
- An error occurred because the client attempts to remove a resource that is currently in use. Returns HTTP
status code 409.BaseException
- An error occurred while processing the request.public UpgradeDomainResult upgradeDomain(UpgradeDomainRequest request)
Allows you to either upgrade your Amazon OpenSearch Service domain or perform an upgrade eligibility check to a compatible version of OpenSearch or Elasticsearch.
upgradeDomain
in interface AmazonOpenSearch
upgradeDomainRequest
- Container for the request parameters to the UpgradeDomain
operation.BaseException
- An error occurred while processing the request.ResourceNotFoundException
- An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.ResourceAlreadyExistsException
- An exception for creating a resource that already exists. Gives http status code of 400.DisabledOperationException
- An error occured because the client wanted to access a not supported operation. Gives http status code of
409.ValidationException
- An exception for missing / invalid input fields. Gives http status code of 400.InternalException
- 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.public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
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.
getCachedResponseMetadata
in interface AmazonOpenSearch
request
- The originally executed requestpublic void shutdown()
AmazonOpenSearch
shutdown
in interface AmazonOpenSearch
shutdown
in class AmazonWebServiceClient
Copyright © 2023. All rights reserved.