class Aws::DAX::Client
An API client for DAX
. To construct a client, you need to configure a `:region` and `:credentials`.
client = Aws::DAX::Client.new( region: region_name, credentials: credentials, # ... )
For details on configuring region and credentials see the [developer guide](/sdk-for-ruby/v3/developer-guide/setup-config.html).
See {#initialize} for a full list of supported configuration options.
Attributes
@api private
Public Class Methods
@api private
# File lib/aws-sdk-dax/client.rb, line 1684 def errors_module Errors end
@overload initialize(options)
@param [Hash] options @option options [required, Aws::CredentialProvider] :credentials Your AWS credentials. This can be an instance of any one of the following classes: * `Aws::Credentials` - Used for configuring static, non-refreshing credentials. * `Aws::SharedCredentials` - Used for loading static credentials from a shared file, such as `~/.aws/config`. * `Aws::AssumeRoleCredentials` - Used when you need to assume a role. * `Aws::AssumeRoleWebIdentityCredentials` - Used when you need to assume a role after providing credentials via the web. * `Aws::SSOCredentials` - Used for loading credentials from AWS SSO using an access token generated from `aws login`. * `Aws::ProcessCredentials` - Used for loading credentials from a process that outputs to stdout. * `Aws::InstanceProfileCredentials` - Used for loading credentials from an EC2 IMDS on an EC2 instance. * `Aws::ECSCredentials` - Used for loading credentials from instances running in ECS. * `Aws::CognitoIdentityCredentials` - Used for loading credentials from the Cognito Identity service. When `:credentials` are not configured directly, the following locations will be searched for credentials: * `Aws.config[:credentials]` * The `:access_key_id`, `:secret_access_key`, and `:session_token` options. * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY'] * `~/.aws/credentials` * `~/.aws/config` * EC2/ECS IMDS instance profile - When used by default, the timeouts are very aggressive. Construct and pass an instance of `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to enable retries and extended timeouts. @option options [required, String] :region The AWS region to connect to. The configured `:region` is used to determine the service `:endpoint`. When not passed, a default `:region` is searched for in the following locations: * `Aws.config[:region]` * `ENV['AWS_REGION']` * `ENV['AMAZON_REGION']` * `ENV['AWS_DEFAULT_REGION']` * `~/.aws/credentials` * `~/.aws/config` @option options [String] :access_key_id @option options [Boolean] :active_endpoint_cache (false) When set to `true`, a thread polling for endpoints will be running in the background every 60 secs (default). Defaults to `false`. @option options [Boolean] :adaptive_retry_wait_to_fill (true) Used only in `adaptive` retry mode. When true, the request will sleep until there is sufficent client side capacity to retry the request. When false, the request will raise a `RetryCapacityNotAvailableError` and will not retry instead of sleeping. @option options [Boolean] :client_side_monitoring (false) When `true`, client-side metrics will be collected for all API requests from this client. @option options [String] :client_side_monitoring_client_id ("") Allows you to provide an identifier for this client which will be attached to all generated client side metrics. Defaults to an empty string. @option options [String] :client_side_monitoring_host ("127.0.0.1") Allows you to specify the DNS hostname or IPv4 or IPv6 address that the client side monitoring agent is running on, where client metrics will be published via UDP. @option options [Integer] :client_side_monitoring_port (31000) Required for publishing client metrics. The port that the client side monitoring agent is running on, where client metrics will be published via UDP. @option options [Aws::ClientSideMonitoring::Publisher] :client_side_monitoring_publisher (Aws::ClientSideMonitoring::Publisher) Allows you to provide a custom client-side monitoring publisher class. By default, will use the Client Side Monitoring Agent Publisher. @option options [Boolean] :convert_params (true) When `true`, an attempt is made to coerce request parameters into the required types. @option options [Boolean] :correct_clock_skew (true) Used only in `standard` and adaptive retry modes. Specifies whether to apply a clock skew correction and retry requests with skewed client clocks. @option options [Boolean] :disable_host_prefix_injection (false) Set to true to disable SDK automatically adding host prefix to default service endpoint when available. @option options [String] :endpoint The client endpoint is normally constructed from the `:region` option. You should only configure an `:endpoint` when connecting to test or custom endpoints. This should be a valid HTTP(S) URI. @option options [Integer] :endpoint_cache_max_entries (1000) Used for the maximum size limit of the LRU cache storing endpoints data for endpoint discovery enabled operations. Defaults to 1000. @option options [Integer] :endpoint_cache_max_threads (10) Used for the maximum threads in use for polling endpoints to be cached, defaults to 10. @option options [Integer] :endpoint_cache_poll_interval (60) When :endpoint_discovery and :active_endpoint_cache is enabled, Use this option to config the time interval in seconds for making requests fetching endpoints information. Defaults to 60 sec. @option options [Boolean] :endpoint_discovery (false) When set to `true`, endpoint discovery will be enabled for operations when available. @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default) The log formatter. @option options [Symbol] :log_level (:info) The log level to send messages to the `:logger` at. @option options [Logger] :logger The Logger instance to send log messages to. If this option is not set, logging will be disabled. @option options [Integer] :max_attempts (3) An integer representing the maximum number attempts that will be made for a single request, including the initial attempt. For example, setting this value to 5 will result in a request being retried up to 4 times. Used in `standard` and `adaptive` retry modes. @option options [String] :profile ("default") Used when loading credentials from the shared credentials file at HOME/.aws/credentials. When not specified, 'default' is used. @option options [Proc] :retry_backoff A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay. This option is only used in the `legacy` retry mode. @option options [Float] :retry_base_delay (0.3) The base delay in seconds used by the default backoff function. This option is only used in the `legacy` retry mode. @option options [Symbol] :retry_jitter (:none) A delay randomiser function used by the default backoff function. Some predefined functions can be referenced by name - :none, :equal, :full, otherwise a Proc that takes and returns a number. This option is only used in the `legacy` retry mode. @see https://www.awsarchitectureblog.com/2015/03/backoff.html @option options [Integer] :retry_limit (3) The maximum number of times to retry failed requests. Only ~ 500 level server errors and certain ~ 400 level client errors are retried. Generally, these are throttling errors, data checksum errors, networking errors, timeout errors, auth errors, endpoint discovery, and errors from expired credentials. This option is only used in the `legacy` retry mode. @option options [Integer] :retry_max_delay (0) The maximum number of seconds to delay between retries (0 for no limit) used by the default backoff function. This option is only used in the `legacy` retry mode. @option options [String] :retry_mode ("legacy") Specifies which retry algorithm to use. Values are: * `legacy` - The pre-existing retry behavior. This is default value if no retry mode is provided. * `standard` - A standardized set of retry rules across the AWS SDKs. This includes support for retry quotas, which limit the number of unsuccessful retries a client can make. * `adaptive` - An experimental retry mode that includes all the functionality of `standard` mode along with automatic client side throttling. This is a provisional mode that may change behavior in the future. @option options [String] :secret_access_key @option options [String] :session_token @option options [Boolean] :simple_json (false) Disables request parameter conversion, validation, and formatting. Also disable response data type conversions. This option is useful when you want to ensure the highest level of performance by avoiding overhead of walking request parameters and response data structures. When `:simple_json` is enabled, the request parameters hash must be formatted exactly as the DynamoDB API expects. @option options [Boolean] :stub_responses (false) Causes the client to return stubbed responses. By default fake responses are generated and returned. You can specify the response data to return or errors to raise by calling {ClientStubs#stub_responses}. See {ClientStubs} for more information. ** Please note ** When response stubbing is enabled, no HTTP requests are made, and retries are disabled. @option options [Boolean] :validate_params (true) When `true`, request parameters are validated before sending the request. @option options [URI::HTTP,String] :http_proxy A proxy to send requests through. Formatted like 'http://proxy.com:123'. @option options [Float] :http_open_timeout (15) The number of seconds to wait when opening a HTTP session before raising a `Timeout::Error`. @option options [Integer] :http_read_timeout (60) The default number of seconds to wait for response data. This value can safely be set per-request on the session. @option options [Float] :http_idle_timeout (5) The number of seconds a connection is allowed to sit idle before it is considered stale. Stale connections are closed and removed from the pool before making a request. @option options [Float] :http_continue_timeout (1) The number of seconds to wait for a 100-continue response before sending the request body. This option has no effect unless the request has "Expect" header set to "100-continue". Defaults to `nil` which disables this behaviour. This value can safely be set per request on the session. @option options [Boolean] :http_wire_trace (false) When `true`, HTTP debug output will be sent to the `:logger`. @option options [Boolean] :ssl_verify_peer (true) When `true`, SSL peer certificates are verified when establishing a connection. @option options [String] :ssl_ca_bundle Full path to the SSL certificate authority bundle file that should be used when verifying peer certificates. If you do not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the system default will be used if available. @option options [String] :ssl_ca_directory Full path of the directory that contains the unbundled SSL certificate authority files for verifying peer certificates. If you do not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the system default will be used if available.
# File lib/aws-sdk-dax/client.rb, line 334 def initialize(*args) super end
Public Instance Methods
@param params ({}) @api private
# File lib/aws-sdk-dax/client.rb, line 1659 def build_request(operation_name, params = {}) handlers = @handlers.for(operation_name) context = Seahorse::Client::RequestContext.new( operation_name: operation_name, operation: config.api.operation(operation_name), client: self, params: params, config: config) context[:gem_name] = 'aws-sdk-dax' context[:gem_version] = '1.33.0' Seahorse::Client::Request.new(handlers, context) end
Creates a DAX
cluster. All nodes in the cluster run the same DAX
caching software.
@option params [required, String] :cluster_name
The cluster identifier. This parameter is stored as a lowercase string. **Constraints:** * A name must contain from 1 to 20 alphanumeric characters or hyphens. * The first character must be a letter. * A name cannot end with a hyphen or contain two consecutive hyphens.
@option params [required, String] :node_type
The compute and memory capacity of the nodes in the cluster.
@option params [String] :description
A description of the cluster.
@option params [required, Integer] :replication_factor
The number of nodes in the DAX cluster. A replication factor of 1 will create a single-node cluster, without any read replicas. For additional fault tolerance, you can create a multiple node cluster with one or more read replicas. To do this, set `ReplicationFactor` to a number between 3 (one primary and two read replicas) and 10 (one primary and nine read replicas). `If the AvailabilityZones` parameter is provided, its length must equal the `ReplicationFactor`. <note markdown="1"> AWS recommends that you have at least two read replicas per cluster. </note>
@option params [Array<String>] :availability_zones
The Availability Zones (AZs) in which the cluster nodes will reside after the cluster has been created or updated. If provided, the length of this list must equal the `ReplicationFactor` parameter. If you omit this parameter, DAX will spread the nodes across Availability Zones for the highest availability.
@option params [String] :subnet_group_name
The name of the subnet group to be used for the replication group. DAX clusters can only run in an Amazon VPC environment. All of the subnets that you specify in a subnet group must exist in the same VPC.
@option params [Array<String>] :security_group_ids
A list of security group IDs to be assigned to each node in the DAX cluster. (Each of the security group ID is system-generated.) If this parameter is not specified, DAX assigns the default VPC security group to each node.
@option params [String] :preferred_maintenance_window
Specifies the weekly time range during which maintenance on the DAX cluster is performed. It is specified as a range in the format ddd:hh24:mi-ddd:hh24:mi (24H Clock UTC). The minimum maintenance window is a 60 minute period. Valid values for `ddd` are: * `sun` * `mon` * `tue` * `wed` * `thu` * `fri` * `sat` Example: `sun:05:00-sun:09:00` <note markdown="1"> If you don't specify a preferred maintenance window when you create or modify a cache cluster, DAX assigns a 60-minute maintenance window on a randomly selected day of the week. </note>
@option params [String] :notification_topic_arn
The Amazon Resource Name (ARN) of the Amazon SNS topic to which notifications will be sent. <note markdown="1"> The Amazon SNS topic owner must be same as the DAX cluster owner. </note>
@option params [required, String] :iam_role_arn
A valid Amazon Resource Name (ARN) that identifies an IAM role. At runtime, DAX will assume this role and use the role's permissions to access DynamoDB on your behalf.
@option params [String] :parameter_group_name
The parameter group to be associated with the DAX cluster.
@option params [Array<Types::Tag>] :tags
A set of tags to associate with the DAX cluster.
@option params [Types::SSESpecification] :sse_specification
Represents the settings used to enable server-side encryption on the cluster.
@option params [String] :cluster_endpoint_encryption_type
The type of encryption the cluster's endpoint should support. Values are: * `NONE` for no encryption * `TLS` for Transport Layer Security
@return [Types::CreateClusterResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
* {Types::CreateClusterResponse#cluster #cluster} => Types::Cluster
@example Request syntax with placeholder values
resp = client.create_cluster({ cluster_name: "String", # required node_type: "String", # required description: "String", replication_factor: 1, # required availability_zones: ["String"], subnet_group_name: "String", security_group_ids: ["String"], preferred_maintenance_window: "String", notification_topic_arn: "String", iam_role_arn: "String", # required parameter_group_name: "String", tags: [ { key: "String", value: "String", }, ], sse_specification: { enabled: false, # required }, cluster_endpoint_encryption_type: "NONE", # accepts NONE, TLS })
@example Response structure
resp.cluster.cluster_name #=> String resp.cluster.description #=> String resp.cluster.cluster_arn #=> String resp.cluster.total_nodes #=> Integer resp.cluster.active_nodes #=> Integer resp.cluster.node_type #=> String resp.cluster.status #=> String resp.cluster.cluster_discovery_endpoint.address #=> String resp.cluster.cluster_discovery_endpoint.port #=> Integer resp.cluster.cluster_discovery_endpoint.url #=> String resp.cluster.node_ids_to_remove #=> Array resp.cluster.node_ids_to_remove[0] #=> String resp.cluster.nodes #=> Array resp.cluster.nodes[0].node_id #=> String resp.cluster.nodes[0].endpoint.address #=> String resp.cluster.nodes[0].endpoint.port #=> Integer resp.cluster.nodes[0].endpoint.url #=> String resp.cluster.nodes[0].node_create_time #=> Time resp.cluster.nodes[0].availability_zone #=> String resp.cluster.nodes[0].node_status #=> String resp.cluster.nodes[0].parameter_group_status #=> String resp.cluster.preferred_maintenance_window #=> String resp.cluster.notification_configuration.topic_arn #=> String resp.cluster.notification_configuration.topic_status #=> String resp.cluster.subnet_group #=> String resp.cluster.security_groups #=> Array resp.cluster.security_groups[0].security_group_identifier #=> String resp.cluster.security_groups[0].status #=> String resp.cluster.iam_role_arn #=> String resp.cluster.parameter_group.parameter_group_name #=> String resp.cluster.parameter_group.parameter_apply_status #=> String resp.cluster.parameter_group.node_ids_to_reboot #=> Array resp.cluster.parameter_group.node_ids_to_reboot[0] #=> String resp.cluster.sse_description.status #=> String, one of "ENABLING", "ENABLED", "DISABLING", "DISABLED" resp.cluster.cluster_endpoint_encryption_type #=> String, one of "NONE", "TLS"
@see docs.aws.amazon.com/goto/WebAPI/dax-2017-04-19/CreateCluster AWS API Documentation
@overload create_cluster
(params = {}) @param [Hash] params ({})
# File lib/aws-sdk-dax/client.rb, line 525 def create_cluster(params = {}, options = {}) req = build_request(:create_cluster, params) req.send_request(options) end
Creates a new parameter group. A parameter group is a collection of parameters that you apply to all of the nodes in a DAX
cluster.
@option params [required, String] :parameter_group_name
The name of the parameter group to apply to all of the clusters in this replication group.
@option params [String] :description
A description of the parameter group.
@return [Types::CreateParameterGroupResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
* {Types::CreateParameterGroupResponse#parameter_group #parameter_group} => Types::ParameterGroup
@example Request syntax with placeholder values
resp = client.create_parameter_group({ parameter_group_name: "String", # required description: "String", })
@example Response structure
resp.parameter_group.parameter_group_name #=> String resp.parameter_group.description #=> String
@see docs.aws.amazon.com/goto/WebAPI/dax-2017-04-19/CreateParameterGroup AWS API Documentation
@overload create_parameter_group
(params = {}) @param [Hash] params ({})
# File lib/aws-sdk-dax/client.rb, line 560 def create_parameter_group(params = {}, options = {}) req = build_request(:create_parameter_group, params) req.send_request(options) end
Creates a new subnet group.
@option params [required, String] :subnet_group_name
A name for the subnet group. This value is stored as a lowercase string.
@option params [String] :description
A description for the subnet group
@option params [required, Array<String>] :subnet_ids
A list of VPC subnet IDs for the subnet group.
@return [Types::CreateSubnetGroupResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
* {Types::CreateSubnetGroupResponse#subnet_group #subnet_group} => Types::SubnetGroup
@example Request syntax with placeholder values
resp = client.create_subnet_group({ subnet_group_name: "String", # required description: "String", subnet_ids: ["String"], # required })
@example Response structure
resp.subnet_group.subnet_group_name #=> String resp.subnet_group.description #=> String resp.subnet_group.vpc_id #=> String resp.subnet_group.subnets #=> Array resp.subnet_group.subnets[0].subnet_identifier #=> String resp.subnet_group.subnets[0].subnet_availability_zone #=> String
@see docs.aws.amazon.com/goto/WebAPI/dax-2017-04-19/CreateSubnetGroup AWS API Documentation
@overload create_subnet_group
(params = {}) @param [Hash] params ({})
# File lib/aws-sdk-dax/client.rb, line 602 def create_subnet_group(params = {}, options = {}) req = build_request(:create_subnet_group, params) req.send_request(options) end
Removes one or more nodes from a DAX
cluster.
<note markdown=“1”> You cannot use `DecreaseReplicationFactor` to remove the last node in a DAX
cluster. If you need to do this, use `DeleteCluster` instead.
</note>
@option params [required, String] :cluster_name
The name of the DAX cluster from which you want to remove nodes.
@option params [required, Integer] :new_replication_factor
The new number of nodes for the DAX cluster.
@option params [Array<String>] :availability_zones
The Availability Zone(s) from which to remove nodes.
@option params [Array<String>] :node_ids_to_remove
The unique identifiers of the nodes to be removed from the cluster.
@return [Types::DecreaseReplicationFactorResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
* {Types::DecreaseReplicationFactorResponse#cluster #cluster} => Types::Cluster
@example Request syntax with placeholder values
resp = client.decrease_replication_factor({ cluster_name: "String", # required new_replication_factor: 1, # required availability_zones: ["String"], node_ids_to_remove: ["String"], })
@example Response structure
resp.cluster.cluster_name #=> String resp.cluster.description #=> String resp.cluster.cluster_arn #=> String resp.cluster.total_nodes #=> Integer resp.cluster.active_nodes #=> Integer resp.cluster.node_type #=> String resp.cluster.status #=> String resp.cluster.cluster_discovery_endpoint.address #=> String resp.cluster.cluster_discovery_endpoint.port #=> Integer resp.cluster.cluster_discovery_endpoint.url #=> String resp.cluster.node_ids_to_remove #=> Array resp.cluster.node_ids_to_remove[0] #=> String resp.cluster.nodes #=> Array resp.cluster.nodes[0].node_id #=> String resp.cluster.nodes[0].endpoint.address #=> String resp.cluster.nodes[0].endpoint.port #=> Integer resp.cluster.nodes[0].endpoint.url #=> String resp.cluster.nodes[0].node_create_time #=> Time resp.cluster.nodes[0].availability_zone #=> String resp.cluster.nodes[0].node_status #=> String resp.cluster.nodes[0].parameter_group_status #=> String resp.cluster.preferred_maintenance_window #=> String resp.cluster.notification_configuration.topic_arn #=> String resp.cluster.notification_configuration.topic_status #=> String resp.cluster.subnet_group #=> String resp.cluster.security_groups #=> Array resp.cluster.security_groups[0].security_group_identifier #=> String resp.cluster.security_groups[0].status #=> String resp.cluster.iam_role_arn #=> String resp.cluster.parameter_group.parameter_group_name #=> String resp.cluster.parameter_group.parameter_apply_status #=> String resp.cluster.parameter_group.node_ids_to_reboot #=> Array resp.cluster.parameter_group.node_ids_to_reboot[0] #=> String resp.cluster.sse_description.status #=> String, one of "ENABLING", "ENABLED", "DISABLING", "DISABLED" resp.cluster.cluster_endpoint_encryption_type #=> String, one of "NONE", "TLS"
@see docs.aws.amazon.com/goto/WebAPI/dax-2017-04-19/DecreaseReplicationFactor AWS API Documentation
@overload decrease_replication_factor
(params = {}) @param [Hash] params ({})
# File lib/aws-sdk-dax/client.rb, line 681 def decrease_replication_factor(params = {}, options = {}) req = build_request(:decrease_replication_factor, params) req.send_request(options) end
Deletes a previously provisioned DAX
cluster. DeleteCluster deletes all associated nodes, node endpoints and the DAX
cluster itself. When you receive a successful response from this action, DAX
immediately begins deleting the cluster; you cannot cancel or revert this action.
@option params [required, String] :cluster_name
The name of the cluster to be deleted.
@return [Types::DeleteClusterResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
* {Types::DeleteClusterResponse#cluster #cluster} => Types::Cluster
@example Request syntax with placeholder values
resp = client.delete_cluster({ cluster_name: "String", # required })
@example Response structure
resp.cluster.cluster_name #=> String resp.cluster.description #=> String resp.cluster.cluster_arn #=> String resp.cluster.total_nodes #=> Integer resp.cluster.active_nodes #=> Integer resp.cluster.node_type #=> String resp.cluster.status #=> String resp.cluster.cluster_discovery_endpoint.address #=> String resp.cluster.cluster_discovery_endpoint.port #=> Integer resp.cluster.cluster_discovery_endpoint.url #=> String resp.cluster.node_ids_to_remove #=> Array resp.cluster.node_ids_to_remove[0] #=> String resp.cluster.nodes #=> Array resp.cluster.nodes[0].node_id #=> String resp.cluster.nodes[0].endpoint.address #=> String resp.cluster.nodes[0].endpoint.port #=> Integer resp.cluster.nodes[0].endpoint.url #=> String resp.cluster.nodes[0].node_create_time #=> Time resp.cluster.nodes[0].availability_zone #=> String resp.cluster.nodes[0].node_status #=> String resp.cluster.nodes[0].parameter_group_status #=> String resp.cluster.preferred_maintenance_window #=> String resp.cluster.notification_configuration.topic_arn #=> String resp.cluster.notification_configuration.topic_status #=> String resp.cluster.subnet_group #=> String resp.cluster.security_groups #=> Array resp.cluster.security_groups[0].security_group_identifier #=> String resp.cluster.security_groups[0].status #=> String resp.cluster.iam_role_arn #=> String resp.cluster.parameter_group.parameter_group_name #=> String resp.cluster.parameter_group.parameter_apply_status #=> String resp.cluster.parameter_group.node_ids_to_reboot #=> Array resp.cluster.parameter_group.node_ids_to_reboot[0] #=> String resp.cluster.sse_description.status #=> String, one of "ENABLING", "ENABLED", "DISABLING", "DISABLED" resp.cluster.cluster_endpoint_encryption_type #=> String, one of "NONE", "TLS"
@see docs.aws.amazon.com/goto/WebAPI/dax-2017-04-19/DeleteCluster AWS API Documentation
@overload delete_cluster
(params = {}) @param [Hash] params ({})
# File lib/aws-sdk-dax/client.rb, line 746 def delete_cluster(params = {}, options = {}) req = build_request(:delete_cluster, params) req.send_request(options) end
Deletes the specified parameter group. You cannot delete a parameter group if it is associated with any DAX
clusters.
@option params [required, String] :parameter_group_name
The name of the parameter group to delete.
@return [Types::DeleteParameterGroupResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
* {Types::DeleteParameterGroupResponse#deletion_message #deletion_message} => String
@example Request syntax with placeholder values
resp = client.delete_parameter_group({ parameter_group_name: "String", # required })
@example Response structure
resp.deletion_message #=> String
@see docs.aws.amazon.com/goto/WebAPI/dax-2017-04-19/DeleteParameterGroup AWS API Documentation
@overload delete_parameter_group
(params = {}) @param [Hash] params ({})
# File lib/aws-sdk-dax/client.rb, line 775 def delete_parameter_group(params = {}, options = {}) req = build_request(:delete_parameter_group, params) req.send_request(options) end
Deletes a subnet group.
<note markdown=“1”> You cannot delete a subnet group if it is associated with any DAX
clusters.
</note>
@option params [required, String] :subnet_group_name
The name of the subnet group to delete.
@return [Types::DeleteSubnetGroupResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
* {Types::DeleteSubnetGroupResponse#deletion_message #deletion_message} => String
@example Request syntax with placeholder values
resp = client.delete_subnet_group({ subnet_group_name: "String", # required })
@example Response structure
resp.deletion_message #=> String
@see docs.aws.amazon.com/goto/WebAPI/dax-2017-04-19/DeleteSubnetGroup AWS API Documentation
@overload delete_subnet_group
(params = {}) @param [Hash] params ({})
# File lib/aws-sdk-dax/client.rb, line 808 def delete_subnet_group(params = {}, options = {}) req = build_request(:delete_subnet_group, params) req.send_request(options) end
Returns information about all provisioned DAX
clusters if no cluster identifier is specified, or about a specific DAX
cluster if a cluster identifier is supplied.
If the cluster is in the CREATING state, only cluster level information will be displayed until all of the nodes are successfully provisioned.
If the cluster is in the DELETING state, only cluster level information will be displayed.
If nodes are currently being added to the DAX
cluster, node endpoint information and creation time for the additional nodes will not be displayed until they are completely provisioned. When the DAX
cluster state is available, the cluster is ready for use.
If nodes are currently being removed from the DAX
cluster, no endpoint information for the removed nodes is displayed.
@option params [Array<String>] :cluster_names
The names of the DAX clusters being described.
@option params [Integer] :max_results
The maximum number of results to include in the response. If more results exist than the specified `MaxResults` value, a token is included in the response so that the remaining results can be retrieved. The value for `MaxResults` must be between 20 and 100.
@option params [String] :next_token
An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by `MaxResults`.
@return [Types::DescribeClustersResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
* {Types::DescribeClustersResponse#next_token #next_token} => String * {Types::DescribeClustersResponse#clusters #clusters} => Array<Types::Cluster>
@example Request syntax with placeholder values
resp = client.describe_clusters({ cluster_names: ["String"], max_results: 1, next_token: "String", })
@example Response structure
resp.next_token #=> String resp.clusters #=> Array resp.clusters[0].cluster_name #=> String resp.clusters[0].description #=> String resp.clusters[0].cluster_arn #=> String resp.clusters[0].total_nodes #=> Integer resp.clusters[0].active_nodes #=> Integer resp.clusters[0].node_type #=> String resp.clusters[0].status #=> String resp.clusters[0].cluster_discovery_endpoint.address #=> String resp.clusters[0].cluster_discovery_endpoint.port #=> Integer resp.clusters[0].cluster_discovery_endpoint.url #=> String resp.clusters[0].node_ids_to_remove #=> Array resp.clusters[0].node_ids_to_remove[0] #=> String resp.clusters[0].nodes #=> Array resp.clusters[0].nodes[0].node_id #=> String resp.clusters[0].nodes[0].endpoint.address #=> String resp.clusters[0].nodes[0].endpoint.port #=> Integer resp.clusters[0].nodes[0].endpoint.url #=> String resp.clusters[0].nodes[0].node_create_time #=> Time resp.clusters[0].nodes[0].availability_zone #=> String resp.clusters[0].nodes[0].node_status #=> String resp.clusters[0].nodes[0].parameter_group_status #=> String resp.clusters[0].preferred_maintenance_window #=> String resp.clusters[0].notification_configuration.topic_arn #=> String resp.clusters[0].notification_configuration.topic_status #=> String resp.clusters[0].subnet_group #=> String resp.clusters[0].security_groups #=> Array resp.clusters[0].security_groups[0].security_group_identifier #=> String resp.clusters[0].security_groups[0].status #=> String resp.clusters[0].iam_role_arn #=> String resp.clusters[0].parameter_group.parameter_group_name #=> String resp.clusters[0].parameter_group.parameter_apply_status #=> String resp.clusters[0].parameter_group.node_ids_to_reboot #=> Array resp.clusters[0].parameter_group.node_ids_to_reboot[0] #=> String resp.clusters[0].sse_description.status #=> String, one of "ENABLING", "ENABLED", "DISABLING", "DISABLED" resp.clusters[0].cluster_endpoint_encryption_type #=> String, one of "NONE", "TLS"
@see docs.aws.amazon.com/goto/WebAPI/dax-2017-04-19/DescribeClusters AWS API Documentation
@overload describe_clusters
(params = {}) @param [Hash] params ({})
# File lib/aws-sdk-dax/client.rb, line 906 def describe_clusters(params = {}, options = {}) req = build_request(:describe_clusters, params) req.send_request(options) end
Returns the default system parameter information for the DAX
caching software.
@option params [Integer] :max_results
The maximum number of results to include in the response. If more results exist than the specified `MaxResults` value, a token is included in the response so that the remaining results can be retrieved. The value for `MaxResults` must be between 20 and 100.
@option params [String] :next_token
An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by `MaxResults`.
@return [Types::DescribeDefaultParametersResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
* {Types::DescribeDefaultParametersResponse#next_token #next_token} => String * {Types::DescribeDefaultParametersResponse#parameters #parameters} => Array<Types::Parameter>
@example Request syntax with placeholder values
resp = client.describe_default_parameters({ max_results: 1, next_token: "String", })
@example Response structure
resp.next_token #=> String resp.parameters #=> Array resp.parameters[0].parameter_name #=> String resp.parameters[0].parameter_type #=> String, one of "DEFAULT", "NODE_TYPE_SPECIFIC" resp.parameters[0].parameter_value #=> String resp.parameters[0].node_type_specific_values #=> Array resp.parameters[0].node_type_specific_values[0].node_type #=> String resp.parameters[0].node_type_specific_values[0].value #=> String resp.parameters[0].description #=> String resp.parameters[0].source #=> String resp.parameters[0].data_type #=> String resp.parameters[0].allowed_values #=> String resp.parameters[0].is_modifiable #=> String, one of "TRUE", "FALSE", "CONDITIONAL" resp.parameters[0].change_type #=> String, one of "IMMEDIATE", "REQUIRES_REBOOT"
@see docs.aws.amazon.com/goto/WebAPI/dax-2017-04-19/DescribeDefaultParameters AWS API Documentation
@overload describe_default_parameters
(params = {}) @param [Hash] params ({})
# File lib/aws-sdk-dax/client.rb, line 961 def describe_default_parameters(params = {}, options = {}) req = build_request(:describe_default_parameters, params) req.send_request(options) end
Returns events related to DAX
clusters and parameter groups. You can obtain events specific to a particular DAX
cluster or parameter group by providing the name as a parameter.
By default, only the events occurring within the last 24 hours are returned; however, you can retrieve up to 14 days' worth of events if necessary.
@option params [String] :source_name
The identifier of the event source for which events will be returned. If not specified, then all sources are included in the response.
@option params [String] :source_type
The event source to retrieve events for. If no value is specified, all events are returned.
@option params [Time,DateTime,Date,Integer,String] :start_time
The beginning of the time interval to retrieve events for, specified in ISO 8601 format.
@option params [Time,DateTime,Date,Integer,String] :end_time
The end of the time interval for which to retrieve events, specified in ISO 8601 format.
@option params [Integer] :duration
The number of minutes' worth of events to retrieve.
@option params [Integer] :max_results
The maximum number of results to include in the response. If more results exist than the specified `MaxResults` value, a token is included in the response so that the remaining results can be retrieved. The value for `MaxResults` must be between 20 and 100.
@option params [String] :next_token
An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by `MaxResults`.
@return [Types::DescribeEventsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
* {Types::DescribeEventsResponse#next_token #next_token} => String * {Types::DescribeEventsResponse#events #events} => Array<Types::Event>
@example Request syntax with placeholder values
resp = client.describe_events({ source_name: "String", source_type: "CLUSTER", # accepts CLUSTER, PARAMETER_GROUP, SUBNET_GROUP start_time: Time.now, end_time: Time.now, duration: 1, max_results: 1, next_token: "String", })
@example Response structure
resp.next_token #=> String resp.events #=> Array resp.events[0].source_name #=> String resp.events[0].source_type #=> String, one of "CLUSTER", "PARAMETER_GROUP", "SUBNET_GROUP" resp.events[0].message #=> String resp.events[0].date #=> Time
@see docs.aws.amazon.com/goto/WebAPI/dax-2017-04-19/DescribeEvents AWS API Documentation
@overload describe_events
(params = {}) @param [Hash] params ({})
# File lib/aws-sdk-dax/client.rb, line 1037 def describe_events(params = {}, options = {}) req = build_request(:describe_events, params) req.send_request(options) end
Returns a list of parameter group descriptions. If a parameter group name is specified, the list will contain only the descriptions for that group.
@option params [Array<String>] :parameter_group_names
The names of the parameter groups.
@option params [Integer] :max_results
The maximum number of results to include in the response. If more results exist than the specified `MaxResults` value, a token is included in the response so that the remaining results can be retrieved. The value for `MaxResults` must be between 20 and 100.
@option params [String] :next_token
An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by `MaxResults`.
@return [Types::DescribeParameterGroupsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
* {Types::DescribeParameterGroupsResponse#next_token #next_token} => String * {Types::DescribeParameterGroupsResponse#parameter_groups #parameter_groups} => Array<Types::ParameterGroup>
@example Request syntax with placeholder values
resp = client.describe_parameter_groups({ parameter_group_names: ["String"], max_results: 1, next_token: "String", })
@example Response structure
resp.next_token #=> String resp.parameter_groups #=> Array resp.parameter_groups[0].parameter_group_name #=> String resp.parameter_groups[0].description #=> String
@see docs.aws.amazon.com/goto/WebAPI/dax-2017-04-19/DescribeParameterGroups AWS API Documentation
@overload describe_parameter_groups
(params = {}) @param [Hash] params ({})
# File lib/aws-sdk-dax/client.rb, line 1087 def describe_parameter_groups(params = {}, options = {}) req = build_request(:describe_parameter_groups, params) req.send_request(options) end
Returns the detailed parameter list for a particular parameter group.
@option params [required, String] :parameter_group_name
The name of the parameter group.
@option params [String] :source
How the parameter is defined. For example, `system` denotes a system-defined parameter.
@option params [Integer] :max_results
The maximum number of results to include in the response. If more results exist than the specified `MaxResults` value, a token is included in the response so that the remaining results can be retrieved. The value for `MaxResults` must be between 20 and 100.
@option params [String] :next_token
An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by `MaxResults`.
@return [Types::DescribeParametersResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
* {Types::DescribeParametersResponse#next_token #next_token} => String * {Types::DescribeParametersResponse#parameters #parameters} => Array<Types::Parameter>
@example Request syntax with placeholder values
resp = client.describe_parameters({ parameter_group_name: "String", # required source: "String", max_results: 1, next_token: "String", })
@example Response structure
resp.next_token #=> String resp.parameters #=> Array resp.parameters[0].parameter_name #=> String resp.parameters[0].parameter_type #=> String, one of "DEFAULT", "NODE_TYPE_SPECIFIC" resp.parameters[0].parameter_value #=> String resp.parameters[0].node_type_specific_values #=> Array resp.parameters[0].node_type_specific_values[0].node_type #=> String resp.parameters[0].node_type_specific_values[0].value #=> String resp.parameters[0].description #=> String resp.parameters[0].source #=> String resp.parameters[0].data_type #=> String resp.parameters[0].allowed_values #=> String resp.parameters[0].is_modifiable #=> String, one of "TRUE", "FALSE", "CONDITIONAL" resp.parameters[0].change_type #=> String, one of "IMMEDIATE", "REQUIRES_REBOOT"
@see docs.aws.amazon.com/goto/WebAPI/dax-2017-04-19/DescribeParameters AWS API Documentation
@overload describe_parameters
(params = {}) @param [Hash] params ({})
# File lib/aws-sdk-dax/client.rb, line 1150 def describe_parameters(params = {}, options = {}) req = build_request(:describe_parameters, params) req.send_request(options) end
Returns a list of subnet group descriptions. If a subnet group name is specified, the list will contain only the description of that group.
@option params [Array<String>] :subnet_group_names
The name of the subnet group.
@option params [Integer] :max_results
The maximum number of results to include in the response. If more results exist than the specified `MaxResults` value, a token is included in the response so that the remaining results can be retrieved. The value for `MaxResults` must be between 20 and 100.
@option params [String] :next_token
An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by `MaxResults`.
@return [Types::DescribeSubnetGroupsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
* {Types::DescribeSubnetGroupsResponse#next_token #next_token} => String * {Types::DescribeSubnetGroupsResponse#subnet_groups #subnet_groups} => Array<Types::SubnetGroup>
@example Request syntax with placeholder values
resp = client.describe_subnet_groups({ subnet_group_names: ["String"], max_results: 1, next_token: "String", })
@example Response structure
resp.next_token #=> String resp.subnet_groups #=> Array resp.subnet_groups[0].subnet_group_name #=> String resp.subnet_groups[0].description #=> String resp.subnet_groups[0].vpc_id #=> String resp.subnet_groups[0].subnets #=> Array resp.subnet_groups[0].subnets[0].subnet_identifier #=> String resp.subnet_groups[0].subnets[0].subnet_availability_zone #=> String
@see docs.aws.amazon.com/goto/WebAPI/dax-2017-04-19/DescribeSubnetGroups AWS API Documentation
@overload describe_subnet_groups
(params = {}) @param [Hash] params ({})
# File lib/aws-sdk-dax/client.rb, line 1203 def describe_subnet_groups(params = {}, options = {}) req = build_request(:describe_subnet_groups, params) req.send_request(options) end
Adds one or more nodes to a DAX
cluster.
@option params [required, String] :cluster_name
The name of the DAX cluster that will receive additional nodes.
@option params [required, Integer] :new_replication_factor
The new number of nodes for the DAX cluster.
@option params [Array<String>] :availability_zones
The Availability Zones (AZs) in which the cluster nodes will be created. All nodes belonging to the cluster are placed in these Availability Zones. Use this parameter if you want to distribute the nodes across multiple AZs.
@return [Types::IncreaseReplicationFactorResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
* {Types::IncreaseReplicationFactorResponse#cluster #cluster} => Types::Cluster
@example Request syntax with placeholder values
resp = client.increase_replication_factor({ cluster_name: "String", # required new_replication_factor: 1, # required availability_zones: ["String"], })
@example Response structure
resp.cluster.cluster_name #=> String resp.cluster.description #=> String resp.cluster.cluster_arn #=> String resp.cluster.total_nodes #=> Integer resp.cluster.active_nodes #=> Integer resp.cluster.node_type #=> String resp.cluster.status #=> String resp.cluster.cluster_discovery_endpoint.address #=> String resp.cluster.cluster_discovery_endpoint.port #=> Integer resp.cluster.cluster_discovery_endpoint.url #=> String resp.cluster.node_ids_to_remove #=> Array resp.cluster.node_ids_to_remove[0] #=> String resp.cluster.nodes #=> Array resp.cluster.nodes[0].node_id #=> String resp.cluster.nodes[0].endpoint.address #=> String resp.cluster.nodes[0].endpoint.port #=> Integer resp.cluster.nodes[0].endpoint.url #=> String resp.cluster.nodes[0].node_create_time #=> Time resp.cluster.nodes[0].availability_zone #=> String resp.cluster.nodes[0].node_status #=> String resp.cluster.nodes[0].parameter_group_status #=> String resp.cluster.preferred_maintenance_window #=> String resp.cluster.notification_configuration.topic_arn #=> String resp.cluster.notification_configuration.topic_status #=> String resp.cluster.subnet_group #=> String resp.cluster.security_groups #=> Array resp.cluster.security_groups[0].security_group_identifier #=> String resp.cluster.security_groups[0].status #=> String resp.cluster.iam_role_arn #=> String resp.cluster.parameter_group.parameter_group_name #=> String resp.cluster.parameter_group.parameter_apply_status #=> String resp.cluster.parameter_group.node_ids_to_reboot #=> Array resp.cluster.parameter_group.node_ids_to_reboot[0] #=> String resp.cluster.sse_description.status #=> String, one of "ENABLING", "ENABLED", "DISABLING", "DISABLED" resp.cluster.cluster_endpoint_encryption_type #=> String, one of "NONE", "TLS"
@see docs.aws.amazon.com/goto/WebAPI/dax-2017-04-19/IncreaseReplicationFactor AWS API Documentation
@overload increase_replication_factor
(params = {}) @param [Hash] params ({})
# File lib/aws-sdk-dax/client.rb, line 1276 def increase_replication_factor(params = {}, options = {}) req = build_request(:increase_replication_factor, params) req.send_request(options) end
Reboots a single node of a DAX
cluster. The reboot action takes place as soon as possible. During the reboot, the node status is set to REBOOTING.
<note markdown=“1”> `RebootNode` restarts the DAX
engine process and does not remove the contents of the cache.
</note>
@option params [required, String] :cluster_name
The name of the DAX cluster containing the node to be rebooted.
@option params [required, String] :node_id
The system-assigned ID of the node to be rebooted.
@return [Types::RebootNodeResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
* {Types::RebootNodeResponse#cluster #cluster} => Types::Cluster
@example Request syntax with placeholder values
resp = client.reboot_node({ cluster_name: "String", # required node_id: "String", # required })
@example Response structure
resp.cluster.cluster_name #=> String resp.cluster.description #=> String resp.cluster.cluster_arn #=> String resp.cluster.total_nodes #=> Integer resp.cluster.active_nodes #=> Integer resp.cluster.node_type #=> String resp.cluster.status #=> String resp.cluster.cluster_discovery_endpoint.address #=> String resp.cluster.cluster_discovery_endpoint.port #=> Integer resp.cluster.cluster_discovery_endpoint.url #=> String resp.cluster.node_ids_to_remove #=> Array resp.cluster.node_ids_to_remove[0] #=> String resp.cluster.nodes #=> Array resp.cluster.nodes[0].node_id #=> String resp.cluster.nodes[0].endpoint.address #=> String resp.cluster.nodes[0].endpoint.port #=> Integer resp.cluster.nodes[0].endpoint.url #=> String resp.cluster.nodes[0].node_create_time #=> Time resp.cluster.nodes[0].availability_zone #=> String resp.cluster.nodes[0].node_status #=> String resp.cluster.nodes[0].parameter_group_status #=> String resp.cluster.preferred_maintenance_window #=> String resp.cluster.notification_configuration.topic_arn #=> String resp.cluster.notification_configuration.topic_status #=> String resp.cluster.subnet_group #=> String resp.cluster.security_groups #=> Array resp.cluster.security_groups[0].security_group_identifier #=> String resp.cluster.security_groups[0].status #=> String resp.cluster.iam_role_arn #=> String resp.cluster.parameter_group.parameter_group_name #=> String resp.cluster.parameter_group.parameter_apply_status #=> String resp.cluster.parameter_group.node_ids_to_reboot #=> Array resp.cluster.parameter_group.node_ids_to_reboot[0] #=> String resp.cluster.sse_description.status #=> String, one of "ENABLING", "ENABLED", "DISABLING", "DISABLED" resp.cluster.cluster_endpoint_encryption_type #=> String, one of "NONE", "TLS"
@see docs.aws.amazon.com/goto/WebAPI/dax-2017-04-19/RebootNode AWS API Documentation
@overload reboot_node
(params = {}) @param [Hash] params ({})
# File lib/aws-sdk-dax/client.rb, line 1388 def reboot_node(params = {}, options = {}) req = build_request(:reboot_node, params) req.send_request(options) end
Associates a set of tags with a DAX
resource. You can call `TagResource` up to 5 times per second, per account.
@option params [required, String] :resource_name
The name of the DAX resource to which tags should be added.
@option params [required, Array<Types::Tag>] :tags
The tags to be assigned to the DAX resource.
@return [Types::TagResourceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
* {Types::TagResourceResponse#tags #tags} => Array<Types::Tag>
@example Request syntax with placeholder values
resp = client.tag_resource({ resource_name: "String", # required tags: [ # required { key: "String", value: "String", }, ], })
@example Response structure
resp.tags #=> Array resp.tags[0].key #=> String resp.tags[0].value #=> String
@see docs.aws.amazon.com/goto/WebAPI/dax-2017-04-19/TagResource AWS API Documentation
@overload tag_resource
(params = {}) @param [Hash] params ({})
# File lib/aws-sdk-dax/client.rb, line 1428 def tag_resource(params = {}, options = {}) req = build_request(:tag_resource, params) req.send_request(options) end
Removes the association of tags from a DAX
resource. You can call `UntagResource` up to 5 times per second, per account.
@option params [required, String] :resource_name
The name of the DAX resource from which the tags should be removed.
@option params [required, Array<String>] :tag_keys
A list of tag keys. If the DAX cluster has any tags with these keys, then the tags are removed from the cluster.
@return [Types::UntagResourceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
* {Types::UntagResourceResponse#tags #tags} => Array<Types::Tag>
@example Request syntax with placeholder values
resp = client.untag_resource({ resource_name: "String", # required tag_keys: ["String"], # required })
@example Response structure
resp.tags #=> Array resp.tags[0].key #=> String resp.tags[0].value #=> String
@see docs.aws.amazon.com/goto/WebAPI/dax-2017-04-19/UntagResource AWS API Documentation
@overload untag_resource
(params = {}) @param [Hash] params ({})
# File lib/aws-sdk-dax/client.rb, line 1464 def untag_resource(params = {}, options = {}) req = build_request(:untag_resource, params) req.send_request(options) end
Modifies the settings for a DAX
cluster. You can use this action to change one or more cluster configuration parameters by specifying the parameters and the new values.
@option params [required, String] :cluster_name
The name of the DAX cluster to be modified.
@option params [String] :description
A description of the changes being made to the cluster.
@option params [String] :preferred_maintenance_window
A range of time when maintenance of DAX cluster software will be performed. For example: `sun:01:00-sun:09:00`. Cluster maintenance normally takes less than 30 minutes, and is performed automatically within the maintenance window.
@option params [String] :notification_topic_arn
The Amazon Resource Name (ARN) that identifies the topic.
@option params [String] :notification_topic_status
The current state of the topic. A value of “active” means that notifications will be sent to the topic. A value of “inactive” means that notifications will not be sent to the topic.
@option params [String] :parameter_group_name
The name of a parameter group for this cluster.
@option params [Array<String>] :security_group_ids
A list of user-specified security group IDs to be assigned to each node in the DAX cluster. If this parameter is not specified, DAX assigns the default VPC security group to each node.
@return [Types::UpdateClusterResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
* {Types::UpdateClusterResponse#cluster #cluster} => Types::Cluster
@example Request syntax with placeholder values
resp = client.update_cluster({ cluster_name: "String", # required description: "String", preferred_maintenance_window: "String", notification_topic_arn: "String", notification_topic_status: "String", parameter_group_name: "String", security_group_ids: ["String"], })
@example Response structure
resp.cluster.cluster_name #=> String resp.cluster.description #=> String resp.cluster.cluster_arn #=> String resp.cluster.total_nodes #=> Integer resp.cluster.active_nodes #=> Integer resp.cluster.node_type #=> String resp.cluster.status #=> String resp.cluster.cluster_discovery_endpoint.address #=> String resp.cluster.cluster_discovery_endpoint.port #=> Integer resp.cluster.cluster_discovery_endpoint.url #=> String resp.cluster.node_ids_to_remove #=> Array resp.cluster.node_ids_to_remove[0] #=> String resp.cluster.nodes #=> Array resp.cluster.nodes[0].node_id #=> String resp.cluster.nodes[0].endpoint.address #=> String resp.cluster.nodes[0].endpoint.port #=> Integer resp.cluster.nodes[0].endpoint.url #=> String resp.cluster.nodes[0].node_create_time #=> Time resp.cluster.nodes[0].availability_zone #=> String resp.cluster.nodes[0].node_status #=> String resp.cluster.nodes[0].parameter_group_status #=> String resp.cluster.preferred_maintenance_window #=> String resp.cluster.notification_configuration.topic_arn #=> String resp.cluster.notification_configuration.topic_status #=> String resp.cluster.subnet_group #=> String resp.cluster.security_groups #=> Array resp.cluster.security_groups[0].security_group_identifier #=> String resp.cluster.security_groups[0].status #=> String resp.cluster.iam_role_arn #=> String resp.cluster.parameter_group.parameter_group_name #=> String resp.cluster.parameter_group.parameter_apply_status #=> String resp.cluster.parameter_group.node_ids_to_reboot #=> Array resp.cluster.parameter_group.node_ids_to_reboot[0] #=> String resp.cluster.sse_description.status #=> String, one of "ENABLING", "ENABLED", "DISABLING", "DISABLED" resp.cluster.cluster_endpoint_encryption_type #=> String, one of "NONE", "TLS"
@see docs.aws.amazon.com/goto/WebAPI/dax-2017-04-19/UpdateCluster AWS API Documentation
@overload update_cluster
(params = {}) @param [Hash] params ({})
# File lib/aws-sdk-dax/client.rb, line 1559 def update_cluster(params = {}, options = {}) req = build_request(:update_cluster, params) req.send_request(options) end
Modifies the parameters of a parameter group. You can modify up to 20 parameters in a single request by submitting a list parameter name and value pairs.
@option params [required, String] :parameter_group_name
The name of the parameter group.
@option params [required, Array<Types::ParameterNameValue>] :parameter_name_values
An array of name-value pairs for the parameters in the group. Each element in the array represents a single parameter. <note markdown="1"> `record-ttl-millis` and `query-ttl-millis` are the only supported parameter names. For more details, see [Configuring TTL Settings][1]. </note> [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DAX.cluster-management.html#DAX.cluster-management.custom-settings.ttl
@return [Types::UpdateParameterGroupResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
* {Types::UpdateParameterGroupResponse#parameter_group #parameter_group} => Types::ParameterGroup
@example Request syntax with placeholder values
resp = client.update_parameter_group({ parameter_group_name: "String", # required parameter_name_values: [ # required { parameter_name: "String", parameter_value: "String", }, ], })
@example Response structure
resp.parameter_group.parameter_group_name #=> String resp.parameter_group.description #=> String
@see docs.aws.amazon.com/goto/WebAPI/dax-2017-04-19/UpdateParameterGroup AWS API Documentation
@overload update_parameter_group
(params = {}) @param [Hash] params ({})
# File lib/aws-sdk-dax/client.rb, line 1609 def update_parameter_group(params = {}, options = {}) req = build_request(:update_parameter_group, params) req.send_request(options) end
Modifies an existing subnet group.
@option params [required, String] :subnet_group_name
The name of the subnet group.
@option params [String] :description
A description of the subnet group.
@option params [Array<String>] :subnet_ids
A list of subnet IDs in the subnet group.
@return [Types::UpdateSubnetGroupResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
* {Types::UpdateSubnetGroupResponse#subnet_group #subnet_group} => Types::SubnetGroup
@example Request syntax with placeholder values
resp = client.update_subnet_group({ subnet_group_name: "String", # required description: "String", subnet_ids: ["String"], })
@example Response structure
resp.subnet_group.subnet_group_name #=> String resp.subnet_group.description #=> String resp.subnet_group.vpc_id #=> String resp.subnet_group.subnets #=> Array resp.subnet_group.subnets[0].subnet_identifier #=> String resp.subnet_group.subnets[0].subnet_availability_zone #=> String
@see docs.aws.amazon.com/goto/WebAPI/dax-2017-04-19/UpdateSubnetGroup AWS API Documentation
@overload update_subnet_group
(params = {}) @param [Hash] params ({})
# File lib/aws-sdk-dax/client.rb, line 1650 def update_subnet_group(params = {}, options = {}) req = build_request(:update_subnet_group, params) req.send_request(options) end
@api private @deprecated
# File lib/aws-sdk-dax/client.rb, line 1674 def waiter_names [] end