Skip to content

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

opensearchservice(
  config = list(),
  credentials = list(),
  endpoint = NULL,
  region = NULL
)

Arguments

  • config

    Optional 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.
    • 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 true to 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 true to use the dualstack (IPv4 and IPv6) endpoint for a service, where available, falling back to the regular endpoint when it isn't. Defaults to the AWS_USE_DUALSTACK_ENDPOINT environment variable when unset.
  • credentials

    Optional 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.
  • endpoint

    Optional shorthand for complete URL to use for the constructed client.

  • region

    Optional 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

Examples

svc <- opensearchservice()
svc$accept_inbound_connection(
  Foo = 123
)