Implementation for accessing Elasticsearch
Amazon Elasticsearch Configuration ServiceUse the Amazon Elasticsearch Configuration API to create, configure, and manage Elasticsearch domains.
For sample code that uses the Configuration API, see the Amazon Elasticsearch Service Developer Guide. The guide also contains sample code for sending signed HTTP requests to the Elasticsearch 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 Regions and Endpoints.
Inheritance Hierarchy
Namespace: Amazon.Elasticsearch
Assembly: AWSSDK.Elasticsearch.dll
Version: 3.x.y.z
Syntax
public class AmazonElasticsearchClient : AmazonServiceClient IAmazonElasticsearch, IAmazonService, IDisposable
The AmazonElasticsearchClient type exposes the following members
Constructors
| Name | Description | |
|---|---|---|
|
AmazonElasticsearchClient() |
Constructs AmazonElasticsearchClient with the credentials loaded from the application's default configuration, and if unsuccessful from the Instance Profile service on an EC2 instance. Example App.config with credentials set.
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<appSettings>
<add key="AWSProfileName" value="AWS Default"/>
</appSettings>
</configuration>
|
|
|
AmazonElasticsearchClient(RegionEndpoint) |
Constructs AmazonElasticsearchClient with the credentials loaded from the application's default configuration, and if unsuccessful from the Instance Profile service on an EC2 instance. Example App.config with credentials set.
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<appSettings>
<add key="AWSProfileName" value="AWS Default"/>
</appSettings>
</configuration>
|
|
|
AmazonElasticsearchClient(AmazonElasticsearchConfig) |
Constructs AmazonElasticsearchClient with the credentials loaded from the application's default configuration, and if unsuccessful from the Instance Profile service on an EC2 instance. Example App.config with credentials set.
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<appSettings>
<add key="AWSProfileName" value="AWS Default"/>
</appSettings>
</configuration>
|
|
|
AmazonElasticsearchClient(AWSCredentials) |
Constructs AmazonElasticsearchClient with AWS Credentials |
|
|
AmazonElasticsearchClient(AWSCredentials, RegionEndpoint) |
Constructs AmazonElasticsearchClient with AWS Credentials |
|
|
AmazonElasticsearchClient(AWSCredentials, AmazonElasticsearchConfig) |
Constructs AmazonElasticsearchClient with AWS Credentials and an AmazonElasticsearchClient Configuration object. |
|
|
AmazonElasticsearchClient(string, string) |
Constructs AmazonElasticsearchClient with AWS Access Key ID and AWS Secret Key |
|
|
AmazonElasticsearchClient(string, string, RegionEndpoint) |
Constructs AmazonElasticsearchClient with AWS Access Key ID and AWS Secret Key |
|
|
AmazonElasticsearchClient(string, string, AmazonElasticsearchConfig) |
Constructs AmazonElasticsearchClient with AWS Access Key ID, AWS Secret Key and an AmazonElasticsearchClient Configuration object. |
|
|
AmazonElasticsearchClient(string, string, string) |
Constructs AmazonElasticsearchClient with AWS Access Key ID and AWS Secret Key |
|
|
AmazonElasticsearchClient(string, string, string, RegionEndpoint) |
Constructs AmazonElasticsearchClient with AWS Access Key ID and AWS Secret Key |
|
|
AmazonElasticsearchClient(string, string, string, AmazonElasticsearchConfig) |
Constructs AmazonElasticsearchClient with AWS Access Key ID, AWS Secret Key and an AmazonElasticsearchClient Configuration object. |
Properties
| Name | Type | Description | |
|---|---|---|---|
|
|
Config | Amazon.Runtime.IClientConfig | Inherited from Amazon.Runtime.AmazonServiceClient. |
|
|
Paginators | Amazon.Elasticsearch.Model.IElasticsearchPaginatorFactory |
Paginators for the service |
Methods
| Name | Description | |
|---|---|---|
|
|
AcceptInboundCrossClusterSearchConnection(AcceptInboundCrossClusterSearchConnectionRequest) |
Allows the destination domain owner to accept an inbound cross-cluster search connection request. |
|
|
AcceptInboundCrossClusterSearchConnectionAsync(AcceptInboundCrossClusterSearchConnectionRequest, CancellationToken) |
Allows the destination domain owner to accept an inbound cross-cluster search connection request. |
|
|
AddTags(AddTagsRequest) |
Attaches tags to an existing Elasticsearch domain. Tags are a set of case-sensitive key value pairs. An Elasticsearch domain may have up to 10 tags. See Tagging Amazon Elasticsearch Service Domains for more information. |
|
|
AddTagsAsync(AddTagsRequest, CancellationToken) |
Attaches tags to an existing Elasticsearch domain. Tags are a set of case-sensitive key value pairs. An Elasticsearch domain may have up to 10 tags. See Tagging Amazon Elasticsearch Service Domains for more information. |
|
|
AssociatePackage(AssociatePackageRequest) |
Associates a package with an Amazon ES domain. |
|
|
AssociatePackageAsync(AssociatePackageRequest, CancellationToken) |
Associates a package with an Amazon ES domain. |
|
|
AuthorizeVpcEndpointAccess(AuthorizeVpcEndpointAccessRequest) |
Provides access to an Amazon OpenSearch Service domain through the use of an interface VPC endpoint. |
|
|
AuthorizeVpcEndpointAccessAsync(AuthorizeVpcEndpointAccessRequest, CancellationToken) |
Provides access to an Amazon OpenSearch Service domain through the use of an interface VPC endpoint. |
|
|
CancelDomainConfigChange(CancelDomainConfigChangeRequest) |
Cancels a pending configuration change on an Amazon OpenSearch Service domain. |
|
|
CancelDomainConfigChangeAsync(CancelDomainConfigChangeRequest, CancellationToken) |
Cancels a pending configuration change on an Amazon OpenSearch Service domain. |
|
|
CancelElasticsearchServiceSoftwareUpdate(CancelElasticsearchServiceSoftwareUpdateRequest) |
Cancels a scheduled service software update for an Amazon ES domain. You can only
perform this operation before the |
|
|
CancelElasticsearchServiceSoftwareUpdateAsync(CancelElasticsearchServiceSoftwareUpdateRequest, CancellationToken) |
Cancels a scheduled service software update for an Amazon ES domain. You can only
perform this operation before the |
|
|
CreateElasticsearchDomain(CreateElasticsearchDomainRequest) |
Creates a new Elasticsearch domain. For more information, see Creating Elasticsearch Domains in the Amazon Elasticsearch Service Developer Guide. |
|
|
CreateElasticsearchDomainAsync(CreateElasticsearchDomainRequest, CancellationToken) |
Creates a new Elasticsearch domain. For more information, see Creating Elasticsearch Domains in the Amazon Elasticsearch Service Developer Guide. |
|
|
CreateOutboundCrossClusterSearchConnection(CreateOutboundCrossClusterSearchConnectionRequest) |
Creates a new cross-cluster search connection from a source domain to a destination domain. |
|
|
CreateOutboundCrossClusterSearchConnectionAsync(CreateOutboundCrossClusterSearchConnectionRequest, CancellationToken) |
Creates a new cross-cluster search connection from a source domain to a destination domain. |
|
|
CreatePackage(CreatePackageRequest) |
Create a package for use with Amazon ES domains. |
|
|
CreatePackageAsync(CreatePackageRequest, CancellationToken) |
Create a package for use with Amazon ES domains. |
|
|
CreateVpcEndpoint(CreateVpcEndpointRequest) |
Creates an Amazon OpenSearch Service-managed VPC endpoint. |
|
|
CreateVpcEndpointAsync(CreateVpcEndpointRequest, CancellationToken) |
Creates an Amazon OpenSearch Service-managed VPC endpoint. |
|
|
DeleteElasticsearchDomain(DeleteElasticsearchDomainRequest) |
Permanently deletes the specified Elasticsearch domain and all of its data. Once a domain is deleted, it cannot be recovered. |
|
|
DeleteElasticsearchDomainAsync(DeleteElasticsearchDomainRequest, CancellationToken) |
Permanently deletes the specified Elasticsearch domain and all of its data. Once a domain is deleted, it cannot be recovered. |
|
|
DeleteElasticsearchServiceRole(DeleteElasticsearchServiceRoleRequest) |
Deletes the service-linked role that Elasticsearch Service uses to manage and maintain VPC domains. Role deletion will fail if any existing VPC domains use the role. You must delete any such Elasticsearch domains before deleting the role. See Deleting Elasticsearch Service Role in VPC Endpoints for Amazon Elasticsearch Service Domains. |
|
|
DeleteElasticsearchServiceRoleAsync(DeleteElasticsearchServiceRoleRequest, CancellationToken) |
Deletes the service-linked role that Elasticsearch Service uses to manage and maintain VPC domains. Role deletion will fail if any existing VPC domains use the role. You must delete any such Elasticsearch domains before deleting the role. See Deleting Elasticsearch Service Role in VPC Endpoints for Amazon Elasticsearch Service Domains. |
|
|
DeleteInboundCrossClusterSearchConnection(DeleteInboundCrossClusterSearchConnectionRequest) |
Allows the destination domain owner to delete an existing inbound cross-cluster search connection. |
|
|
DeleteInboundCrossClusterSearchConnectionAsync(DeleteInboundCrossClusterSearchConnectionRequest, CancellationToken) |
Allows the destination domain owner to delete an existing inbound cross-cluster search connection. |
|
|
DeleteOutboundCrossClusterSearchConnection(DeleteOutboundCrossClusterSearchConnectionRequest) |
Allows the source domain owner to delete an existing outbound cross-cluster search connection. |
|
|
DeleteOutboundCrossClusterSearchConnectionAsync(DeleteOutboundCrossClusterSearchConnectionRequest, CancellationToken) |
Allows the source domain owner to delete an existing outbound cross-cluster search connection. |
|
|
DeletePackage(DeletePackageRequest) |
Delete the package. |
|
|
DeletePackageAsync(DeletePackageRequest, CancellationToken) |
Delete the package. |
|
|
DeleteVpcEndpoint(DeleteVpcEndpointRequest) |
Deletes an Amazon OpenSearch Service-managed interface VPC endpoint. |
|
|
DeleteVpcEndpointAsync(DeleteVpcEndpointRequest, CancellationToken) |
Deletes an Amazon OpenSearch Service-managed interface VPC endpoint. |
|
|
DescribeDomainAutoTunes(DescribeDomainAutoTunesRequest) |
Provides scheduled Auto-Tune action details for the Elasticsearch domain, such as Auto-Tune action type, description, severity, and scheduled date. |
|
|
DescribeDomainAutoTunesAsync(DescribeDomainAutoTunesRequest, CancellationToken) |
Provides scheduled Auto-Tune action details for the Elasticsearch domain, such as Auto-Tune action type, description, severity, and scheduled date. |
|
|
DescribeDomainChangeProgress(DescribeDomainChangeProgressRequest) |
Returns information about the current blue/green deployment happening on a domain, including a change ID, status, and progress stages. |
|
|
DescribeDomainChangeProgressAsync(DescribeDomainChangeProgressRequest, CancellationToken) |
Returns information about the current blue/green deployment happening on a domain, including a change ID, status, and progress stages. |
|
|
DescribeElasticsearchDomain(DescribeElasticsearchDomainRequest) |
Returns domain configuration information about the specified Elasticsearch domain, including the domain ID, domain endpoint, and domain ARN. |
|
|
DescribeElasticsearchDomainAsync(DescribeElasticsearchDomainRequest, CancellationToken) |
Returns domain configuration information about the specified Elasticsearch domain, including the domain ID, domain endpoint, and domain ARN. |
|
|
DescribeElasticsearchDomainConfig(DescribeElasticsearchDomainConfigRequest) |
Provides cluster configuration information about the specified Elasticsearch domain, such as the state, creation date, update version, and update date for cluster options. |
|
|
DescribeElasticsearchDomainConfigAsync(DescribeElasticsearchDomainConfigRequest, CancellationToken) |
Provides cluster configuration information about the specified Elasticsearch domain, such as the state, creation date, update version, and update date for cluster options. |
|
|
DescribeElasticsearchDomains(DescribeElasticsearchDomainsRequest) |
Returns domain configuration information about the specified Elasticsearch domains, including the domain ID, domain endpoint, and domain ARN. |
|
|
DescribeElasticsearchDomainsAsync(DescribeElasticsearchDomainsRequest, CancellationToken) |
Returns domain configuration information about the specified Elasticsearch domains, including the domain ID, domain endpoint, and domain ARN. |
|
|
DescribeElasticsearchInstanceTypeLimits(DescribeElasticsearchInstanceTypeLimitsRequest) |
Describe Elasticsearch Limits for a given InstanceType and ElasticsearchVersion.
When modifying existing Domain, specify the |
|
|
DescribeElasticsearchInstanceTypeLimitsAsync(DescribeElasticsearchInstanceTypeLimitsRequest, CancellationToken) |
Describe Elasticsearch Limits for a given InstanceType and ElasticsearchVersion.
When modifying existing Domain, specify the |
|
|
DescribeInboundCrossClusterSearchConnections(DescribeInboundCrossClusterSearchConnectionsRequest) |
Lists all the inbound cross-cluster search connections for a destination domain. |
|
|
DescribeInboundCrossClusterSearchConnectionsAsync(DescribeInboundCrossClusterSearchConnectionsRequest, CancellationToken) |
Lists all the inbound cross-cluster search connections for a destination domain. |
|
|
DescribeOutboundCrossClusterSearchConnections(DescribeOutboundCrossClusterSearchConnectionsRequest) |
Lists all the outbound cross-cluster search connections for a source domain. |
|
|
DescribeOutboundCrossClusterSearchConnectionsAsync(DescribeOutboundCrossClusterSearchConnectionsRequest, CancellationToken) |
Lists all the outbound cross-cluster search connections for a source domain. |
|
|
DescribePackages(DescribePackagesRequest) |
Describes all packages available to Amazon ES. Includes options for filtering, limiting the number of results, and pagination. |
|
|
DescribePackagesAsync(DescribePackagesRequest, CancellationToken) |
Describes all packages available to Amazon ES. Includes options for filtering, limiting the number of results, and pagination. |
|
|
DescribeReservedElasticsearchInstanceOfferings(DescribeReservedElasticsearchInstanceOfferingsRequest) |
Lists available reserved Elasticsearch instance offerings. |
|
|
DescribeReservedElasticsearchInstanceOfferingsAsync(DescribeReservedElasticsearchInstanceOfferingsRequest, CancellationToken) |
Lists available reserved Elasticsearch instance offerings. |
|
|
DescribeReservedElasticsearchInstances(DescribeReservedElasticsearchInstancesRequest) |
Returns information about reserved Elasticsearch instances for this account. |
|
|
DescribeReservedElasticsearchInstancesAsync(DescribeReservedElasticsearchInstancesRequest, CancellationToken) |
Returns information about reserved Elasticsearch instances for this account. |
|
|
DescribeVpcEndpoints(DescribeVpcEndpointsRequest) |
Describes one or more Amazon OpenSearch Service-managed VPC endpoints. |
|
|
DescribeVpcEndpointsAsync(DescribeVpcEndpointsRequest, CancellationToken) |
Describes one or more Amazon OpenSearch Service-managed VPC endpoints. |
|
|
DetermineServiceOperationEndpoint(AmazonWebServiceRequest) |
Returns the endpoint that will be used for a particular request. |
|
|
Dispose() | Inherited from Amazon.Runtime.AmazonServiceClient. |
|
|
DissociatePackage(DissociatePackageRequest) |
Dissociates a package from the Amazon ES domain. |
|
|
DissociatePackageAsync(DissociatePackageRequest, CancellationToken) |
Dissociates a package from the Amazon ES domain. |
|
|
GetCompatibleElasticsearchVersions(GetCompatibleElasticsearchVersionsRequest) |
Returns a list of upgrade compatible Elastisearch versions. You can optionally pass
a |
|
|
GetCompatibleElasticsearchVersionsAsync(GetCompatibleElasticsearchVersionsRequest, CancellationToken) |
Returns a list of upgrade compatible Elastisearch versions. You can optionally pass
a |
|
|
GetPackageVersionHistory(GetPackageVersionHistoryRequest) |
Returns a list of versions of the package, along with their creation time and commit message. |
|
|
GetPackageVersionHistoryAsync(GetPackageVersionHistoryRequest, CancellationToken) |
Returns a list of versions of the package, along with their creation time and commit message. |
|
|
GetUpgradeHistory(GetUpgradeHistoryRequest) |
Retrieves the complete history of the last 10 upgrades that were performed on the domain. |
|
|
GetUpgradeHistoryAsync(GetUpgradeHistoryRequest, CancellationToken) |
Retrieves the complete history of the last 10 upgrades that were performed on the domain. |
|
|
GetUpgradeStatus(GetUpgradeStatusRequest) |
Retrieves the latest status of the last upgrade or upgrade eligibility check that was performed on the domain. |
|
|
GetUpgradeStatusAsync(GetUpgradeStatusRequest, CancellationToken) |
Retrieves the latest status of the last upgrade or upgrade eligibility check that was performed on the domain. |
|
|
ListDomainNames(ListDomainNamesRequest) |
Returns the name of all Elasticsearch domains owned by the current user's account. |
|
|
ListDomainNamesAsync(ListDomainNamesRequest, CancellationToken) |
Returns the name of all Elasticsearch domains owned by the current user's account. |
|
|
ListDomainsForPackage(ListDomainsForPackageRequest) |
Lists all Amazon ES domains associated with the package. |
|
|
ListDomainsForPackageAsync(ListDomainsForPackageRequest, CancellationToken) |
Lists all Amazon ES domains associated with the package. |
|
|
ListElasticsearchInstanceTypes(ListElasticsearchInstanceTypesRequest) |
List all Elasticsearch instance types that are supported for given ElasticsearchVersion |
|
|
ListElasticsearchInstanceTypesAsync(ListElasticsearchInstanceTypesRequest, CancellationToken) |
List all Elasticsearch instance types that are supported for given ElasticsearchVersion |
|
|
ListElasticsearchVersions(ListElasticsearchVersionsRequest) |
List all supported Elasticsearch versions |
|
|
ListElasticsearchVersionsAsync(ListElasticsearchVersionsRequest, CancellationToken) |
List all supported Elasticsearch versions |
|
|
ListPackagesForDomain(ListPackagesForDomainRequest) |
Lists all packages associated with the Amazon ES domain. |
|
|
ListPackagesForDomainAsync(ListPackagesForDomainRequest, CancellationToken) |
Lists all packages associated with the Amazon ES domain. |
|
|
ListTags(ListTagsRequest) |
Returns all tags for the given Elasticsearch domain. |
|
|
ListTagsAsync(ListTagsRequest, CancellationToken) |
Returns all tags for the given Elasticsearch domain. |
|
|
ListVpcEndpointAccess(ListVpcEndpointAccessRequest) |
Retrieves information about each principal that is allowed to access a given Amazon OpenSearch Service domain through the use of an interface VPC endpoint. |
|
|
ListVpcEndpointAccessAsync(ListVpcEndpointAccessRequest, CancellationToken) |
Retrieves information about each principal that is allowed to access a given Amazon OpenSearch Service domain through the use of an interface VPC endpoint. |
|
|
ListVpcEndpoints(ListVpcEndpointsRequest) |
Retrieves all Amazon OpenSearch Service-managed VPC endpoints in the current account and Region. |
|
|
ListVpcEndpointsAsync(ListVpcEndpointsRequest, CancellationToken) |
Retrieves all Amazon OpenSearch Service-managed VPC endpoints in the current account and Region. |
|
|
ListVpcEndpointsForDomain(ListVpcEndpointsForDomainRequest) |
Retrieves all Amazon OpenSearch Service-managed VPC endpoints associated with a particular domain. |
|
|
ListVpcEndpointsForDomainAsync(ListVpcEndpointsForDomainRequest, CancellationToken) |
Retrieves all Amazon OpenSearch Service-managed VPC endpoints associated with a particular domain. |
|
|
PurchaseReservedElasticsearchInstanceOffering(PurchaseReservedElasticsearchInstanceOfferingRequest) |
Allows you to purchase reserved Elasticsearch instances. |
|
|
PurchaseReservedElasticsearchInstanceOfferingAsync(PurchaseReservedElasticsearchInstanceOfferingRequest, CancellationToken) |
Allows you to purchase reserved Elasticsearch instances. |
|
|
RejectInboundCrossClusterSearchConnection(RejectInboundCrossClusterSearchConnectionRequest) |
Allows the destination domain owner to reject an inbound cross-cluster search connection request. |
|
|
RejectInboundCrossClusterSearchConnectionAsync(RejectInboundCrossClusterSearchConnectionRequest, CancellationToken) |
Allows the destination domain owner to reject an inbound cross-cluster search connection request. |
|
|
RemoveTags(RemoveTagsRequest) |
Removes the specified set of tags from the specified Elasticsearch domain. |
|
|
RemoveTagsAsync(RemoveTagsRequest, CancellationToken) |
Removes the specified set of tags from the specified Elasticsearch domain. |
|
|
RevokeVpcEndpointAccess(RevokeVpcEndpointAccessRequest) |
Revokes access to an Amazon OpenSearch Service domain that was provided through an interface VPC endpoint. |
|
|
RevokeVpcEndpointAccessAsync(RevokeVpcEndpointAccessRequest, CancellationToken) |
Revokes access to an Amazon OpenSearch Service domain that was provided through an interface VPC endpoint. |
|
|
StartElasticsearchServiceSoftwareUpdate(StartElasticsearchServiceSoftwareUpdateRequest) |
Schedules a service software update for an Amazon ES domain. |
|
|
StartElasticsearchServiceSoftwareUpdateAsync(StartElasticsearchServiceSoftwareUpdateRequest, CancellationToken) |
Schedules a service software update for an Amazon ES domain. |
|
|
UpdateElasticsearchDomainConfig(UpdateElasticsearchDomainConfigRequest) |
Modifies the cluster configuration of the specified Elasticsearch domain, setting as setting the instance type and the number of instances. |
|
|
UpdateElasticsearchDomainConfigAsync(UpdateElasticsearchDomainConfigRequest, CancellationToken) |
Modifies the cluster configuration of the specified Elasticsearch domain, setting as setting the instance type and the number of instances. |
|
|
UpdatePackage(UpdatePackageRequest) |
Updates a package for use with Amazon ES domains. |
|
|
UpdatePackageAsync(UpdatePackageRequest, CancellationToken) |
Updates a package for use with Amazon ES domains. |
|
|
UpdateVpcEndpoint(UpdateVpcEndpointRequest) |
Modifies an Amazon OpenSearch Service-managed interface VPC endpoint. |
|
|
UpdateVpcEndpointAsync(UpdateVpcEndpointRequest, CancellationToken) |
Modifies an Amazon OpenSearch Service-managed interface VPC endpoint. |
|
|
UpgradeElasticsearchDomain(UpgradeElasticsearchDomainRequest) |
Allows you to either upgrade your domain or perform an Upgrade eligibility check to a compatible Elasticsearch version. |
|
|
UpgradeElasticsearchDomainAsync(UpgradeElasticsearchDomainRequest, CancellationToken) |
Allows you to either upgrade your domain or perform an Upgrade eligibility check to a compatible Elasticsearch version. |
Events
| Name | Description | |
|---|---|---|
|
|
AfterResponseEvent | Inherited from Amazon.Runtime.AmazonServiceClient. |
|
|
BeforeRequestEvent | Inherited from Amazon.Runtime.AmazonServiceClient. |
|
|
ExceptionEvent | Inherited from Amazon.Runtime.AmazonServiceClient. |
Version Information
.NET Core App:
Supported in: 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5, 4.0, 3.5