Amazon OpenSearch Service¶
Description¶
Use the Amazon OpenSearch Service configuration API to create, configure, and manage OpenSearch Service domains. The endpoint for configuration service requests is Region specific: es.region.amazonaws.com. For example, es.us-east-1.amazonaws.com. For a current list of supported Regions and endpoints, see Amazon Web Services service endpoints.
Usage¶
Arguments¶
-
configOptional configuration of credentials, endpoint, and/or region.
- credentials:
- creds:
- access_key_id: AWS access key ID
- secret_access_key: AWS secret access key
- session_token: AWS temporary session token
- profile: The name of a profile to use. If not given, then the default profile is used.
- anonymous: Set anonymous credentials.
- creds:
- endpoint: The complete URL to use for the constructed client.
- region: The AWS Region used in instantiating the client.
- close_connection: Immediately close all HTTP connections.
- timeout: The time in seconds till a timeout exception is thrown when attempting to make a connection. The default is 60 seconds.
- s3_force_path_style: Set this to
trueto force the request to use path-style addressing, i.e.http://s3.amazonaws.com/BUCKET/KEY. - sts_regional_endpoint: Set sts regional endpoint resolver to regional or legacy https://docs.aws.amazon.com/sdkref/latest/guide/feature-sts-regionalized-endpoints.html
- use_dual_stack: Set this to
trueto use the dualstack (IPv4 and IPv6) endpoint for a service, where available, falling back to the regular endpoint when it isn't. Defaults to theAWS_USE_DUALSTACK_ENDPOINTenvironment variable when unset.
- credentials:
-
credentialsOptional credentials shorthand for the config parameter
- creds:
- access_key_id: AWS access key ID
- secret_access_key: AWS secret access key
- session_token: AWS temporary session token
- profile: The name of a profile to use. If not given, then the default profile is used.
- anonymous: Set anonymous credentials.
- creds:
-
endpointOptional shorthand for complete URL to use for the constructed client.
-
regionOptional shorthand for AWS Region used in instantiating the client.
Value¶
A client for the service. You can call the service's operations using syntax like svc$operation(...), where svc is the name you've assigned to the client. The available operations are listed in the Operations section.
Service syntax¶
svc <- opensearchservice(
config = list(
credentials = list(
creds = list(
access_key_id = "string",
secret_access_key = "string",
session_token = "string"
),
profile = "string",
anonymous = "logical"
),
endpoint = "string",
region = "string",
close_connection = "logical",
timeout = "numeric",
s3_force_path_style = "logical",
sts_regional_endpoint = "string",
use_dual_stack = "logical"
),
credentials = list(
creds = list(
access_key_id = "string",
secret_access_key = "string",
session_token = "string"
),
profile = "string",
anonymous = "logical"
),
endpoint = "string",
region = "string"
)
Operations¶
accept_inbound_connection |
Allows the destination Amazon OpenSearch Service domain owner to accept an inbound cross-cluster search connection request |
|---|---|
add_data_source |
Creates a new direct-query data source to the specified domain |
add_direct_query_data_source |
Adds a new data source in Amazon OpenSearch Service so that you can perform direct queries on external data |
add_tags |
Attaches tags to an existing Amazon OpenSearch Service domain, data source, or application |
associate_package |
Associates a package with an Amazon OpenSearch Service domain |
associate_packages |
Operation in the Amazon OpenSearch Service API for associating multiple packages with a domain simultaneously |
attach_data_source |
Attaches a data source to an OpenSearch application |
authorize_vpc_endpoint_access |
Provides access to an Amazon OpenSearch Service domain through the use of an interface VPC endpoint |
cancel_domain_config_change |
Cancels a pending configuration change on an Amazon OpenSearch Service domain |
cancel_service_software_update |
Cancels a scheduled service software update for an Amazon OpenSearch Service domain |
create_application |
Creates an OpenSearch UI application |
create_domain |
Creates an Amazon OpenSearch Service domain |
create_index |
Creates an OpenSearch index with optional automatic semantic enrichment for specified text fields |
create_outbound_connection |
Creates a new cross-cluster search connection from a source Amazon OpenSearch Service domain to a destination domain |
create_package |
Creates a package for use with Amazon OpenSearch Service domains |
create_vpc_endpoint |
Creates an Amazon OpenSearch Service-managed VPC endpoint |
delete_application |
Deletes a specified OpenSearch application |
delete_data_source |
Deletes a direct-query data source |
delete_direct_query_data_source |
Deletes a previously configured direct query data source from Amazon OpenSearch Service |
delete_domain |
Deletes an Amazon OpenSearch Service domain and all of its data |
delete_inbound_connection |
Allows the destination Amazon OpenSearch Service domain owner to delete an existing inbound cross-cluster search connection |
delete_index |
Deletes an OpenSearch index |
delete_outbound_connection |
Allows the source Amazon OpenSearch Service domain owner to delete an existing outbound cross-cluster search connection |
delete_package |
Deletes an Amazon OpenSearch Service package |
delete_vpc_endpoint |
Deletes an Amazon OpenSearch Service-managed interface VPC endpoint |
deregister_capability |
Deregisters a capability from an OpenSearch UI application |
describe_data_source_attachment |
Returns the current status and details of a specific data source attachment for an OpenSearch application |
describe_domain |
Describes the domain configuration for the specified Amazon OpenSearch Service domain, including the domain ID, domain service endpoint, and domain ARN |
describe_domain_auto_tunes |
Returns the list of optimizations that Auto-Tune has made to an Amazon OpenSearch Service domain |
describe_domain_change_progress |
Returns information about the current blue/green deployment happening on an Amazon OpenSearch Service domain |
describe_domain_config |
Returns the configuration of an Amazon OpenSearch Service domain |
describe_domain_health |
Returns information about domain and node health, the standby Availability Zone, number of nodes per Availability Zone, and shard count per node |
describe_domain_nodes |
Returns information about domain and nodes, including data nodes, master nodes, ultrawarm nodes, Availability Zone(s), standby nodes, node configurations, and node states |
describe_domains |
Returns domain configuration information about the specified Amazon OpenSearch Service domains |
describe_dry_run_progress |
Describes the progress of a pre-update dry run analysis on an Amazon OpenSearch Service domain |
describe_inbound_connections |
Lists all the inbound cross-cluster search connections for a destination (remote) Amazon OpenSearch Service domain |
describe_insight_details |
Describes the details of an existing insight for an Amazon OpenSearch Service domain |
describe_instance_type_limits |
Describes the instance count, storage, and master node limits for a given OpenSearch or Elasticsearch version and instance type |
describe_outbound_connections |
Lists all the outbound cross-cluster connections for a local (source) Amazon OpenSearch Service domain |
describe_packages |
Describes all packages available to OpenSearch Service |
describe_reserved_instance_offerings |
Describes the available Amazon OpenSearch Service Reserved Instance offerings for a given Region |
describe_reserved_instances |
Describes the Amazon OpenSearch Service instances that you have reserved in a given Region |
describe_vpc_endpoints |
Describes one or more Amazon OpenSearch Service-managed VPC endpoints |
detach_data_source |
Removes a data source from an OpenSearch application |
dissociate_package |
Removes a package from the specified Amazon OpenSearch Service domain |
dissociate_packages |
Dissociates multiple packages from a domain simultaneously |
get_application |
Retrieves the configuration and status of an existing OpenSearch application |
get_capability |
Retrieves information about a registered capability for an OpenSearch UI application, including its configuration and current status |
get_compatible_versions |
Returns a map of OpenSearch or Elasticsearch versions and the versions you can upgrade them to |
get_data_source |
Retrieves information about a direct query data source |
get_default_application_setting |
Gets the ARN of the current default application |
get_direct_query_data_source |
Returns detailed configuration information for a specific direct query data source in Amazon OpenSearch Service |
get_domain_maintenance_status |
The status of the maintenance action |
get_index |
Retrieves information about an OpenSearch index including its schema and semantic enrichment configuration |
get_migration |
Retrieves the current status and progress of a migration job, including the number of exported and imported objects and error details if the migration failed |
get_package_version_history |
Returns a list of Amazon OpenSearch Service package versions, along with their creation time, commit message, and plugin properties (if the package is a zip plugin package) |
get_upgrade_history |
Retrieves the complete history of the last 10 upgrades performed on an Amazon OpenSearch Service domain |
get_upgrade_status |
Returns the most recent status of the last upgrade or upgrade eligibility check performed on an Amazon OpenSearch Service domain |
insight_feedback |
Submits feedback for an existing insight in an Amazon OpenSearch Service domain |
list_applications |
Lists all OpenSearch applications under your account |
list_data_source_attachments |
Returns a paginated list of all data source attachments for an OpenSearch application, including attachments in all states (PENDING, ATTACHED, and FAILED) |
list_data_sources |
Lists direct-query data sources for a specific domain |
list_direct_query_data_sources |
Lists an inventory of all the direct query data sources that you have configured within Amazon OpenSearch Service |
list_domain_maintenances |
A list of maintenance actions for the domain |
list_domain_names |
Returns the names of all Amazon OpenSearch Service domains owned by the current user in the active Region |
list_domains_for_package |
Lists all Amazon OpenSearch Service domains associated with a given package |
list_insights |
Lists insights for an Amazon OpenSearch Service domain or Amazon Web Services account |
list_instance_type_details |
Lists all instance types and available features for a given OpenSearch or Elasticsearch version |
list_migrations |
Lists migration jobs for an Amazon OpenSearch Service application |
list_packages_for_domain |
Lists all packages associated with an Amazon OpenSearch Service domain |
list_scheduled_actions |
Retrieves a list of configuration changes that are scheduled for a domain |
list_tags |
Returns all resource tags for an Amazon OpenSearch Service domain, data source, or application |
list_versions |
Lists all versions of OpenSearch and Elasticsearch that Amazon OpenSearch Service supports |
list_vpc_endpoint_access |
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 |
list_vpc_endpoints |
Retrieves all Amazon OpenSearch Service-managed VPC endpoints in the current Amazon Web Services account and Region |
list_vpc_endpoints_for_domain |
Retrieves all Amazon OpenSearch Service-managed VPC endpoints associated with a particular domain |
purchase_reserved_instance_offering |
Allows you to purchase Amazon OpenSearch Service Reserved Instances |
put_default_application_setting |
Sets the default application to the application with the specified ARN |
register_capability |
Registers a capability for an OpenSearch UI application |
reject_inbound_connection |
Allows the remote Amazon OpenSearch Service domain owner to reject an inbound cross-cluster connection request |
remove_tags |
Removes the specified set of tags from an Amazon OpenSearch Service domain, data source, or application |
revoke_vpc_endpoint_access |
Revokes access to an Amazon OpenSearch Service domain that was provided through an interface VPC endpoint |
rollback_service_software_update |
Rolls back a service software update for a domain to the previous version |
start_domain_maintenance |
Starts the node maintenance process on the data node |
start_migration |
Initiates a migration job to migrate saved objects from a data source to an Amazon OpenSearch Service application workspace |
start_service_software_update |
Schedules a service software update for an Amazon OpenSearch Service domain |
update_application |
Updates the configuration and settings of an existing OpenSearch application |
update_data_source |
Updates a direct-query data source |
update_direct_query_data_source |
Updates the configuration or properties of an existing direct query data source in Amazon OpenSearch Service |
update_domain_config |
Modifies the cluster configuration of the specified Amazon OpenSearch Service domain |
update_index |
Updates an existing OpenSearch index schema and semantic enrichment configuration |
update_package |
Updates a package for use with Amazon OpenSearch Service domains |
update_package_scope |
Updates the scope of a package |
update_scheduled_action |
Reschedules a planned domain configuration change for a later time |
update_vpc_endpoint |
Modifies an Amazon OpenSearch Service-managed interface VPC endpoint |
upgrade_domain |
Allows you to either upgrade your Amazon OpenSearch Service domain or perform an upgrade eligibility check to a compatible version of OpenSearch or Elasticsearch |