opensearchservice function

Amazon OpenSearch Service

Amazon OpenSearch Service

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.

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

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

Returns

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"
  ),
  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_connectionAllows the destination Amazon OpenSearch Service domain owner to accept an inbound cross-cluster search connection request
add_data_sourceCreates a new direct-query data source to the specified domain
add_direct_query_data_sourceAdds a new data source in Amazon OpenSearch Service so that you can perform direct queries on external data
add_tagsAttaches tags to an existing Amazon OpenSearch Service domain, data source, or application
associate_packageAssociates a package with an Amazon OpenSearch Service domain
associate_packagesOperation in the Amazon OpenSearch Service API for associating multiple packages with a domain simultaneously
authorize_vpc_endpoint_accessProvides access to an Amazon OpenSearch Service domain through the use of an interface VPC endpoint
cancel_domain_config_changeCancels a pending configuration change on an Amazon OpenSearch Service domain
cancel_service_software_updateCancels a scheduled service software update for an Amazon OpenSearch Service domain
create_applicationCreates an OpenSearch Application
create_domainCreates an Amazon OpenSearch Service domain
create_outbound_connectionCreates a new cross-cluster search connection from a source Amazon OpenSearch Service domain to a destination domain
create_packageCreates a package for use with Amazon OpenSearch Service domains
create_vpc_endpointCreates an Amazon OpenSearch Service-managed VPC endpoint
delete_applicationDeletes an existing OpenSearch Application
delete_data_sourceDeletes a direct-query data source
delete_direct_query_data_sourceDeletes a previously configured direct query data source from Amazon OpenSearch Service
delete_domainDeletes an Amazon OpenSearch Service domain and all of its data
delete_inbound_connectionAllows the destination Amazon OpenSearch Service domain owner to delete an existing inbound cross-cluster search connection
delete_outbound_connectionAllows the source Amazon OpenSearch Service domain owner to delete an existing outbound cross-cluster search connection
delete_packageDeletes an Amazon OpenSearch Service package
delete_vpc_endpointDeletes an Amazon OpenSearch Service-managed interface VPC endpoint
describe_domainDescribes the domain configuration for the specified Amazon OpenSearch Service domain, including the domain ID, domain service endpoint, and domain ARN
describe_domain_auto_tunesReturns the list of optimizations that Auto-Tune has made to an Amazon OpenSearch Service domain
describe_domain_change_progressReturns information about the current blue/green deployment happening on an Amazon OpenSearch Service domain
describe_domain_configReturns the configuration of an Amazon OpenSearch Service domain
describe_domain_healthReturns information about domain and node health, the standby Availability Zone, number of nodes per Availability Zone, and shard count per node
describe_domain_nodesReturns information about domain and nodes, including data nodes, master nodes, ultrawarm nodes, Availability Zone(s), standby nodes, node configurations, and node states
describe_domainsReturns domain configuration information about the specified Amazon OpenSearch Service domains
describe_dry_run_progressDescribes the progress of a pre-update dry run analysis on an Amazon OpenSearch Service domain
describe_inbound_connectionsLists all the inbound cross-cluster search connections for a destination (remote) Amazon OpenSearch Service domain
describe_instance_type_limitsDescribes the instance count, storage, and master node limits for a given OpenSearch or Elasticsearch version and instance type
describe_outbound_connectionsLists all the outbound cross-cluster connections for a local (source) Amazon OpenSearch Service domain
describe_packagesDescribes all packages available to OpenSearch Service
describe_reserved_instance_offeringsDescribes the available Amazon OpenSearch Service Reserved Instance offerings for a given Region
describe_reserved_instancesDescribes the Amazon OpenSearch Service instances that you have reserved in a given Region
describe_vpc_endpointsDescribes one or more Amazon OpenSearch Service-managed VPC endpoints
dissociate_packageRemoves a package from the specified Amazon OpenSearch Service domain
dissociate_packagesDissociates multiple packages from a domain simulatneously
get_applicationCheck the configuration and status of an existing OpenSearch Application
get_compatible_versionsReturns a map of OpenSearch or Elasticsearch versions and the versions you can upgrade them to
get_data_sourceRetrieves information about a direct query data source
get_direct_query_data_sourceReturns detailed configuration information for a specific direct query data source in Amazon OpenSearch Service
get_domain_maintenance_statusThe status of the maintenance action
get_package_version_historyReturns 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_historyRetrieves the complete history of the last 10 upgrades performed on an Amazon OpenSearch Service domain
get_upgrade_statusReturns the most recent status of the last upgrade or upgrade eligibility check performed on an Amazon OpenSearch Service domain
list_applicationsList all OpenSearch Applications under your account
list_data_sourcesLists direct-query data sources for a specific domain
list_direct_query_data_sourcesLists an inventory of all the direct query data sources that you have configured within Amazon OpenSearch Service
list_domain_maintenancesA list of maintenance actions for the domain
list_domain_namesReturns the names of all Amazon OpenSearch Service domains owned by the current user in the active Region
list_domains_for_packageLists all Amazon OpenSearch Service domains associated with a given package
list_instance_type_detailsLists all instance types and available features for a given OpenSearch or Elasticsearch version
list_packages_for_domainLists all packages associated with an Amazon OpenSearch Service domain
list_scheduled_actionsRetrieves a list of configuration changes that are scheduled for a domain
list_tagsReturns all resource tags for an Amazon OpenSearch Service domain, data source, or application
list_versionsLists all versions of OpenSearch and Elasticsearch that Amazon OpenSearch Service supports
list_vpc_endpoint_accessRetrieves 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_endpointsRetrieves all Amazon OpenSearch Service-managed VPC endpoints in the current Amazon Web Services account and Region
list_vpc_endpoints_for_domainRetrieves all Amazon OpenSearch Service-managed VPC endpoints associated with a particular domain
purchase_reserved_instance_offeringAllows you to purchase Amazon OpenSearch Service Reserved Instances
reject_inbound_connectionAllows the remote Amazon OpenSearch Service domain owner to reject an inbound cross-cluster connection request
remove_tagsRemoves the specified set of tags from an Amazon OpenSearch Service domain, data source, or application
revoke_vpc_endpoint_accessRevokes access to an Amazon OpenSearch Service domain that was provided through an interface VPC endpoint
start_domain_maintenanceStarts the node maintenance process on the data node
start_service_software_updateSchedules a service software update for an Amazon OpenSearch Service domain
update_applicationUpdate the OpenSearch Application
update_data_sourceUpdates a direct-query data source
update_direct_query_data_sourceUpdates the configuration or properties of an existing direct query data source in Amazon OpenSearch Service
update_domain_configModifies the cluster configuration of the specified Amazon OpenSearch Service domain
update_packageUpdates a package for use with Amazon OpenSearch Service domains
update_package_scopeUpdates the scope of a package
update_scheduled_actionReschedules a planned domain configuration change for a later time
update_vpc_endpointModifies an Amazon OpenSearch Service-managed interface VPC endpoint
upgrade_domainAllows you to either upgrade your Amazon OpenSearch Service domain or perform an upgrade eligibility check to a compatible version of OpenSearch or Elasticsearch

Examples

## Not run: svc <- opensearchservice() svc$accept_inbound_connection( Foo = 123 ) ## End(Not run)
  • Maintainer: Dyfan Jones
  • License: Apache License (>= 2.0)
  • Last published: 2025-03-17