Opensearch

This page documents function available when using the Opensearch module, created with @service Opensearch.

Index

Documentation

Main.Opensearch.accept_inbound_connectionMethod
accept_inbound_connection(connection_id)
accept_inbound_connection(connection_id, params::Dict{String,<:Any})

Allows the remote domain owner to accept an inbound cross-cluster connection request.

Arguments

  • connection_id: The ID of the inbound connection you want to accept.
source
Main.Opensearch.add_tagsMethod
add_tags(arn, tag_list)
add_tags(arn, tag_list, params::Dict{String,<:Any})

Attaches tags to an existing domain. Tags are a set of case-sensitive key value pairs. An domain can have up to 10 tags. See Tagging Amazon OpenSearch Service domains for more information.

Arguments

  • arn: Specify the ARN of the domain you want to add tags to.
  • tag_list: List of Tag to add to the domain.
source
Main.Opensearch.associate_packageMethod
associate_package(domain_name, package_id)
associate_package(domain_name, package_id, params::Dict{String,<:Any})

Associates a package with an Amazon OpenSearch Service domain.

Arguments

  • domain_name: The name of the domain to associate the package with.
  • package_id: Internal ID of the package to associate with a domain. Use DescribePackages to find this value.
source
Main.Opensearch.cancel_service_software_updateMethod
cancel_service_software_update(domain_name)
cancel_service_software_update(domain_name, params::Dict{String,<:Any})

Cancels a scheduled service software update for an Amazon OpenSearch Service domain. You can only perform this operation before the AutomatedUpdateDate and when the UpdateStatus is in the PENDING_UPDATE state.

Arguments

  • domain_name: The name of the domain that you want to stop the latest service software update on.
source
Main.Opensearch.create_domainMethod
create_domain(domain_name)
create_domain(domain_name, params::Dict{String,<:Any})

Creates a new Amazon OpenSearch Service domain. For more information, see Creating and managing Amazon OpenSearch Service domains in the Amazon OpenSearch Service Developer Guide.

Arguments

  • domain_name: The name of the Amazon OpenSearch Service domain you're creating. Domain names are unique across the domains owned by an account within an AWS region. Domain names must start with a lowercase letter and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen).

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "AccessPolicies": IAM access policy as a JSON-formatted string.
  • "AdvancedOptions": 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 Advanced cluster parameters for more information.
  • "AdvancedSecurityOptions": Specifies advanced security options.
  • "AutoTuneOptions": Specifies Auto-Tune options.
  • "ClusterConfig": Configuration options for a domain. Specifies the instance type and number of instances in the domain.
  • "CognitoOptions": Options to specify the Cognito user and identity pools for OpenSearch Dashboards authentication. For more information, see Configuring Amazon Cognito authentication for OpenSearch Dashboards.
  • "DomainEndpointOptions": Options to specify configurations that will be applied to the domain endpoint.
  • "EBSOptions": Options to enable, disable, and specify the type and size of EBS storage volumes.
  • "EncryptionAtRestOptions": Options for encryption of data at rest.
  • "EngineVersion": String of format ElasticsearchX.Y or OpenSearchX.Y to specify the engine version for the Amazon OpenSearch Service domain. For example, "OpenSearch1.0" or "Elasticsearch7.9". For more information, see Creating and managing Amazon OpenSearch Service domains .
  • "LogPublishingOptions": Map of LogType and LogPublishingOption, each containing options to publish a given type of OpenSearch log.
  • "NodeToNodeEncryptionOptions": Node-to-node encryption options.
  • "SnapshotOptions": Option to set time, in UTC format, of the daily automated snapshot. Default value is 0 hours.
  • "TagList": A list of Tag added during domain creation.
  • "VPCOptions": Options to specify the subnets and security groups for a VPC endpoint. For more information, see Launching your Amazon OpenSearch Service domains using a VPC .
source
Main.Opensearch.create_outbound_connectionMethod
create_outbound_connection(connection_alias, local_domain_info, remote_domain_info)
create_outbound_connection(connection_alias, local_domain_info, remote_domain_info, params::Dict{String,<:Any})

Creates a new cross-cluster connection from a local OpenSearch domain to a remote OpenSearch domain.

Arguments

  • connection_alias: The connection alias used used by the customer for this cross-cluster connection.
  • local_domain_info: The AWSDomainInformation for the local OpenSearch domain.
  • remote_domain_info: The AWSDomainInformation for the remote OpenSearch domain.
source
Main.Opensearch.create_packageMethod
create_package(package_name, package_source, package_type)
create_package(package_name, package_source, package_type, params::Dict{String,<:Any})

Create a package for use with Amazon OpenSearch Service domains.

Arguments

  • package_name: Unique identifier for the package.
  • package_source: The Amazon S3 location from which to import the package.
  • package_type: Type of package. Currently supports only TXT-DICTIONARY.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "PackageDescription": Description of the package.
source
Main.Opensearch.delete_domainMethod
delete_domain(domain_name)
delete_domain(domain_name, params::Dict{String,<:Any})

Permanently deletes the specified domain and all of its data. Once a domain is deleted, it cannot be recovered.

Arguments

  • domain_name: The name of the domain you want to permanently delete.
source
Main.Opensearch.delete_inbound_connectionMethod
delete_inbound_connection(connection_id)
delete_inbound_connection(connection_id, params::Dict{String,<:Any})

Allows the remote domain owner to delete an existing inbound cross-cluster connection.

Arguments

  • connection_id: The ID of the inbound connection to permanently delete.
source
Main.Opensearch.delete_outbound_connectionMethod
delete_outbound_connection(connection_id)
delete_outbound_connection(connection_id, params::Dict{String,<:Any})

Allows the local domain owner to delete an existing outbound cross-cluster connection.

Arguments

  • connection_id: The ID of the outbound connection you want to permanently delete.
source
Main.Opensearch.delete_packageMethod
delete_package(package_id)
delete_package(package_id, params::Dict{String,<:Any})

Deletes the package.

Arguments

  • package_id: The internal ID of the package you want to delete. Use DescribePackages to find this value.
source
Main.Opensearch.describe_domainMethod
describe_domain(domain_name)
describe_domain(domain_name, params::Dict{String,<:Any})

Returns domain configuration information about the specified domain, including the domain ID, domain endpoint, and domain ARN.

Arguments

  • domain_name: The name of the domain for which you want information.
source
Main.Opensearch.describe_domain_auto_tunesMethod
describe_domain_auto_tunes(domain_name)
describe_domain_auto_tunes(domain_name, params::Dict{String,<:Any})

Provides scheduled Auto-Tune action details for the domain, such as Auto-Tune action type, description, severity, and scheduled date.

Arguments

  • domain_name: The domain name for which you want Auto-Tune action details.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "MaxResults": Set this value to limit the number of results returned. If not specified, defaults to 100.
  • "NextToken": NextToken is sent in case the earlier API call results contain the NextToken. Used for pagination.
source
Main.Opensearch.describe_domain_change_progressMethod
describe_domain_change_progress(domain_name)
describe_domain_change_progress(domain_name, params::Dict{String,<:Any})

Returns information about the current blue/green deployment happening on a domain, including a change ID, status, and progress stages.

Arguments

  • domain_name: The domain you want to get the progress information about.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "changeid": The specific change ID for which you want to get progress information. This is an optional parameter. If omitted, the service returns information about the most recent configuration change.
source
Main.Opensearch.describe_domain_configMethod
describe_domain_config(domain_name)
describe_domain_config(domain_name, params::Dict{String,<:Any})

Provides cluster configuration information about the specified domain, such as the state, creation date, update version, and update date for cluster options.

Arguments

  • domain_name: The domain you want to get information about.
source
Main.Opensearch.describe_domainsMethod
describe_domains(domain_names)
describe_domains(domain_names, params::Dict{String,<:Any})

Returns domain configuration information about the specified domains, including the domain ID, domain endpoint, and domain ARN.

Arguments

  • domain_names: The domains for which you want information.
source
Main.Opensearch.describe_inbound_connectionsMethod
describe_inbound_connections()
describe_inbound_connections(params::Dict{String,<:Any})

Lists all the inbound cross-cluster connections for a remote domain.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "Filters": A list of filters used to match properties for inbound cross-cluster connections. Available Filter values are: connection-id local-domain-info.domain-name local-domain-info.owner-id local-domain-info.region remote-domain-info.domain-name
  • "MaxResults": Set this value to limit the number of results returned. If not specified, defaults to 100.
  • "NextToken": If more results are available and NextToken is present, make the next request to the same API with the received NextToken to paginate the remaining results.
source
Main.Opensearch.describe_instance_type_limitsMethod
describe_instance_type_limits(engine_version, instance_type)
describe_instance_type_limits(engine_version, instance_type, params::Dict{String,<:Any})

Describe the limits for a given instance type and OpenSearch or Elasticsearch version. When modifying an existing domain, specify the DomainName to see which limits you can modify.

Arguments

  • engine_version: Version of OpenSearch for which Limits are needed.
  • instance_type: The instance type for an OpenSearch cluster for which OpenSearch Limits are needed.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "domainName": The name of the domain you want to modify. Only include this value if you're querying OpenSearch Limits for an existing domain.
source
Main.Opensearch.describe_outbound_connectionsMethod
describe_outbound_connections()
describe_outbound_connections(params::Dict{String,<:Any})

Lists all the outbound cross-cluster connections for a local domain.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "Filters": A list of filters used to match properties for outbound cross-cluster connections. Available Filter names for this operation are: connection-id remote-domain-info.domain-name remote-domain-info.owner-id remote-domain-info.region local-domain-info.domain-name
  • "MaxResults": Set this value to limit the number of results returned. If not specified, defaults to 100.
  • "NextToken": NextToken is sent in case the earlier API call results contain the NextToken parameter. Used for pagination.
source
Main.Opensearch.describe_packagesMethod
describe_packages()
describe_packages(params::Dict{String,<:Any})

Describes all packages available to Amazon OpenSearch Service domains. Includes options for filtering, limiting the number of results, and pagination.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "Filters": Only returns packages that match the DescribePackagesFilterList values.
  • "MaxResults": Limits results to a maximum number of packages.
  • "NextToken": Used for pagination. Only necessary if a previous API call includes a non-null NextToken value. If provided, returns results for the next page.
source
Main.Opensearch.describe_reserved_instance_offeringsMethod
describe_reserved_instance_offerings()
describe_reserved_instance_offerings(params::Dict{String,<:Any})

Lists available reserved OpenSearch instance offerings.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "maxResults": Set this value to limit the number of results returned. If not specified, defaults to 100.
  • "nextToken": Provides an identifier to allow retrieval of paginated results.
  • "offeringId": The offering identifier filter value. Use this parameter to show only the available offering that matches the specified reservation identifier.
source
Main.Opensearch.describe_reserved_instancesMethod
describe_reserved_instances()
describe_reserved_instances(params::Dict{String,<:Any})

Returns information about reserved OpenSearch instances for this account.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "maxResults": Set this value to limit the number of results returned. If not specified, defaults to 100.
  • "nextToken": Provides an identifier to allow retrieval of paginated results.
  • "reservationId": The reserved instance identifier filter value. Use this parameter to show only the reservation that matches the specified reserved OpenSearch instance ID.
source
Main.Opensearch.dissociate_packageMethod
dissociate_package(domain_name, package_id)
dissociate_package(domain_name, package_id, params::Dict{String,<:Any})

Dissociates a package from the Amazon OpenSearch Service domain.

Arguments

  • domain_name: The name of the domain to associate the package with.
  • package_id: The internal ID of the package to associate with a domain. Use DescribePackages to find this value.
source
Main.Opensearch.get_compatible_versionsMethod
get_compatible_versions()
get_compatible_versions(params::Dict{String,<:Any})

Returns a list of upgrade-compatible versions of OpenSearch/Elasticsearch. You can optionally pass a DomainName to get all upgrade-compatible versions of OpenSearch/Elasticsearch for that specific domain.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "domainName":
source
Main.Opensearch.get_package_version_historyMethod
get_package_version_history(package_id)
get_package_version_history(package_id, params::Dict{String,<:Any})

Returns a list of package versions, along with their creation time and commit message.

Arguments

  • package_id: Returns an audit history of package versions.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "maxResults": Limits results to a maximum number of package versions.
  • "nextToken": Used for pagination. Only necessary if a previous API call includes a non-null NextToken value. If provided, returns results for the next page.
source
Main.Opensearch.get_upgrade_historyMethod
get_upgrade_history(domain_name)
get_upgrade_history(domain_name, params::Dict{String,<:Any})

Retrieves the complete history of the last 10 upgrades performed on the domain.

Arguments

  • domain_name:

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "maxResults":
  • "nextToken":
source
Main.Opensearch.get_upgrade_statusMethod
get_upgrade_status(domain_name)
get_upgrade_status(domain_name, params::Dict{String,<:Any})

Retrieves the latest status of the last upgrade or upgrade eligibility check performed on the domain.

Arguments

  • domain_name:
source
Main.Opensearch.list_domain_namesMethod
list_domain_names()
list_domain_names(params::Dict{String,<:Any})

Returns the names of all domains owned by the current user's account.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "engineType": Optional parameter to filter the output by domain engine type. Acceptable values are 'Elasticsearch' and 'OpenSearch'.
source
Main.Opensearch.list_domains_for_packageMethod
list_domains_for_package(package_id)
list_domains_for_package(package_id, params::Dict{String,<:Any})

Lists all Amazon OpenSearch Service domains associated with the package.

Arguments

  • package_id: The package for which to list associated domains.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "maxResults": Limits the results to a maximum number of domains.
  • "nextToken": Used for pagination. Only necessary if a previous API call includes a non-null NextToken value. If provided, returns results for the next page.
source
Main.Opensearch.list_instance_type_detailsMethod
list_instance_type_details(engine_version)
list_instance_type_details(engine_version, params::Dict{String,<:Any})

Arguments

  • engine_version:

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "domainName":
  • "maxResults":
  • "nextToken":
source
Main.Opensearch.list_packages_for_domainMethod
list_packages_for_domain(domain_name)
list_packages_for_domain(domain_name, params::Dict{String,<:Any})

Lists all packages associated with the Amazon OpenSearch Service domain.

Arguments

  • domain_name: The name of the domain for which you want to list associated packages.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "maxResults": Limits results to a maximum number of packages.
  • "nextToken": Used for pagination. Only necessary if a previous API call includes a non-null NextToken value. If provided, returns results for the next page.
source
Main.Opensearch.list_tagsMethod
list_tags(arn)
list_tags(arn, params::Dict{String,<:Any})

Returns all tags for the given domain.

Arguments

  • arn: Specify the ARN of the domain that the tags you want to view are attached to.
source
Main.Opensearch.list_versionsMethod
list_versions()
list_versions(params::Dict{String,<:Any})

List all supported versions of OpenSearch and Elasticsearch.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "maxResults": Set this value to limit the number of results returned. Value must be greater than 10 or it won't be honored.
  • "nextToken":
source
Main.Opensearch.purchase_reserved_instance_offeringMethod
purchase_reserved_instance_offering(reservation_name, reserved_instance_offering_id)
purchase_reserved_instance_offering(reservation_name, reserved_instance_offering_id, params::Dict{String,<:Any})

Allows you to purchase reserved OpenSearch instances.

Arguments

  • reservation_name: A customer-specified identifier to track this reservation.
  • reserved_instance_offering_id: The ID of the reserved OpenSearch instance offering to purchase.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "InstanceCount": The number of OpenSearch instances to reserve.
source
Main.Opensearch.reject_inbound_connectionMethod
reject_inbound_connection(connection_id)
reject_inbound_connection(connection_id, params::Dict{String,<:Any})

Allows the remote domain owner to reject an inbound cross-cluster connection request.

Arguments

  • connection_id: The ID of the inbound connection to reject.
source
Main.Opensearch.remove_tagsMethod
remove_tags(arn, tag_keys)
remove_tags(arn, tag_keys, params::Dict{String,<:Any})

Removes the specified set of tags from the given domain.

Arguments

  • arn: The ARN of the domain from which you want to delete the specified tags.
  • tag_keys: The TagKey list you want to remove from the domain.
source
Main.Opensearch.start_service_software_updateMethod
start_service_software_update(domain_name)
start_service_software_update(domain_name, params::Dict{String,<:Any})

Schedules a service software update for an Amazon OpenSearch Service domain.

Arguments

  • domain_name: The name of the domain that you want to update to the latest service software.
source
Main.Opensearch.update_domain_configMethod
update_domain_config(domain_name)
update_domain_config(domain_name, params::Dict{String,<:Any})

Modifies the cluster configuration of the specified domain, such as setting the instance type and the number of instances.

Arguments

  • domain_name: The name of the domain you're updating.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "AccessPolicies": IAM access policy as a JSON-formatted string.
  • "AdvancedOptions": Modifies the advanced 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 Advanced options for more information.
  • "AdvancedSecurityOptions": Specifies advanced security options.
  • "AutoTuneOptions": Specifies Auto-Tune options.
  • "ClusterConfig": The type and number of instances to instantiate for the domain cluster.
  • "CognitoOptions": Options to specify the Cognito user and identity pools for OpenSearch Dashboards authentication. For more information, see Configuring Amazon Cognito authentication for OpenSearch Dashboards.
  • "DomainEndpointOptions": Options to specify configuration that will be applied to the domain endpoint.
  • "DryRun": This flag, when set to True, specifies whether the UpdateDomain request should return the results of validation checks (DryRunResults) without actually applying the change.
  • "EBSOptions": Specify the type and size of the EBS volume to use.
  • "EncryptionAtRestOptions": Specifies encryption of data at rest options.
  • "LogPublishingOptions": Map of LogType and LogPublishingOption, each containing options to publish a given type of OpenSearch log.
  • "NodeToNodeEncryptionOptions": Specifies node-to-node encryption options.
  • "SnapshotOptions": Option to set the time, in UTC format, for the daily automated snapshot. Default value is 0 hours.
  • "VPCOptions": Options to specify the subnets and security groups for the VPC endpoint. For more information, see Launching your Amazon OpenSearch Service domains using a VPC .
source
Main.Opensearch.update_packageMethod
update_package(package_id, package_source)
update_package(package_id, package_source, params::Dict{String,<:Any})

Updates a package for use with Amazon OpenSearch Service domains.

Arguments

  • package_id: The unique identifier for the package.
  • package_source:

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "CommitMessage": A commit message for the new version which is shown as part of GetPackageVersionHistoryResponse.
  • "PackageDescription": A new description of the package.
source
Main.Opensearch.upgrade_domainMethod
upgrade_domain(domain_name, target_version)
upgrade_domain(domain_name, target_version, params::Dict{String,<:Any})

Allows you to either upgrade your domain or perform an upgrade eligibility check to a compatible version of OpenSearch or Elasticsearch.

Arguments

  • domain_name:
  • target_version: The version of OpenSearch you intend to upgrade the domain to.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "AdvancedOptions":
  • "PerformCheckOnly": When true, indicates that an upgrade eligibility check needs to be performed. Does not actually perform the upgrade.
source