aws-sdk-cloudhsmv2 1.0.0.rc1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 04c293ebb453f589217f46fb3c5fdbce4b3b4a1d
+  data.tar.gz: e24c539d5fce1ad5c014dcaeece3b27974d44b59
+SHA512:
+  metadata.gz: dde08802512b6f1d0ee84368e581199f3ca7d6c3fd3a6933ec84bd01f5085a5b159cffcef60dec34a4ec054c965b90ba73ec403274f72f93567301063ee8cba1
+  data.tar.gz: ea5de3f8fdc77872a6cb1e6ebc65d1e124958cf4259ccc9a548e9b7b1d0e4a809f55f8c916b0ee77a84c684b49220ceec10588ee780e7993148a26be5fe05b13

data/lib/aws-sdk-cloudhsmv2.rb

@@ -0,0 +1,47 @@
+# WARNING ABOUT GENERATED CODE
+#
+# This file is generated. See the contributing guide for more information:
+# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+#
+# WARNING ABOUT GENERATED CODE
+
+require 'aws-sdk-core'
+require 'aws-sigv4'
+
+require_relative 'aws-sdk-cloudhsmv2/types'
+require_relative 'aws-sdk-cloudhsmv2/client_api'
+require_relative 'aws-sdk-cloudhsmv2/client'
+require_relative 'aws-sdk-cloudhsmv2/errors'
+require_relative 'aws-sdk-cloudhsmv2/resource'
+require_relative 'aws-sdk-cloudhsmv2/customizations'
+
+# This module provides support for AWS CloudHSM V2. This module is available in the
+# `aws-sdk-cloudhsmv2` gem.
+#
+# # Client
+#
+# The {Client} class provides one method for each API operation. Operation
+# methods each accept a hash of request parameters and return a response
+# structure.
+#
+# See {Client} for more information.
+#
+# # Errors
+#
+# Errors returned from AWS CloudHSM V2 all
+# extend {Errors::ServiceError}.
+#
+#     begin
+#       # do stuff
+#     rescue Aws::CloudHSMV2::Errors::ServiceError
+#       # rescues all service API errors
+#     end
+#
+# See {Errors} for more information.
+#
+# @service
+module Aws::CloudHSMV2
+
+  GEM_VERSION = '1.0.0.rc1'
+
+end

data/lib/aws-sdk-cloudhsmv2/client.rb

@@ -0,0 +1,726 @@
+# WARNING ABOUT GENERATED CODE
+#
+# This file is generated. See the contributing guide for more information:
+# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+#
+# WARNING ABOUT GENERATED CODE
+
+require 'seahorse/client/plugins/content_length.rb'
+require 'aws-sdk-core/plugins/credentials_configuration.rb'
+require 'aws-sdk-core/plugins/logging.rb'
+require 'aws-sdk-core/plugins/param_converter.rb'
+require 'aws-sdk-core/plugins/param_validator.rb'
+require 'aws-sdk-core/plugins/user_agent.rb'
+require 'aws-sdk-core/plugins/helpful_socket_errors.rb'
+require 'aws-sdk-core/plugins/retry_errors.rb'
+require 'aws-sdk-core/plugins/global_configuration.rb'
+require 'aws-sdk-core/plugins/regional_endpoint.rb'
+require 'aws-sdk-core/plugins/response_paging.rb'
+require 'aws-sdk-core/plugins/stub_responses.rb'
+require 'aws-sdk-core/plugins/idempotency_token.rb'
+require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
+require 'aws-sdk-core/plugins/signature_v4.rb'
+require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
+
+Aws::Plugins::GlobalConfiguration.add_identifier(:cloudhsmv2)
+
+module Aws::CloudHSMV2
+  class Client < Seahorse::Client::Base
+
+    include Aws::ClientStubs
+
+    @identifier = :cloudhsmv2
+
+    set_api(ClientApi::API)
+
+    add_plugin(Seahorse::Client::Plugins::ContentLength)
+    add_plugin(Aws::Plugins::CredentialsConfiguration)
+    add_plugin(Aws::Plugins::Logging)
+    add_plugin(Aws::Plugins::ParamConverter)
+    add_plugin(Aws::Plugins::ParamValidator)
+    add_plugin(Aws::Plugins::UserAgent)
+    add_plugin(Aws::Plugins::HelpfulSocketErrors)
+    add_plugin(Aws::Plugins::RetryErrors)
+    add_plugin(Aws::Plugins::GlobalConfiguration)
+    add_plugin(Aws::Plugins::RegionalEndpoint)
+    add_plugin(Aws::Plugins::ResponsePaging)
+    add_plugin(Aws::Plugins::StubResponses)
+    add_plugin(Aws::Plugins::IdempotencyToken)
+    add_plugin(Aws::Plugins::JsonvalueConverter)
+    add_plugin(Aws::Plugins::SignatureV4)
+    add_plugin(Aws::Plugins::Protocols::JsonRpc)
+
+    # @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::InstanceProfileCredentials` - Used for loading credentials
+    #     from an EC2 IMDS on an EC2 instance.
+    #
+    #   * `Aws::SharedCredentials` - Used for loading credentials from a
+    #     shared file, such as `~/.aws/config`.
+    #
+    #   * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
+    #
+    #   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 IMDS instance profile - When used by default, the timeouts are
+    #     very aggressive. Construct and pass an instance of
+    #     `Aws::InstanceProfileCredentails` 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 search 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] :convert_params (true)
+    #   When `true`, an attempt is made to coerce request parameters into
+    #   the required types.
+    #
+    # @option options [String] :endpoint
+    #   The client endpoint is normally constructed from the `:region`
+    #   option. You should only configure an `:endpoint` when connecting
+    #   to test endpoints. This should be avalid HTTP(S) URI.
+    #
+    # @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 [String] :profile ("default")
+    #   Used when loading credentials from the shared credentials file
+    #   at HOME/.aws/credentials.  When not specified, 'default' is used.
+    #
+    # @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 and auth
+    #   errors from expired credentials.
+    #
+    # @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.
+    #
+    def initialize(*args)
+      super
+    end
+
+    # @!group API Operations
+
+    # Creates a new AWS CloudHSM cluster.
+    #
+    # @option params [required, Array<String>] :subnet_ids
+    #   The identifiers (IDs) of the subnets where you are creating the
+    #   cluster. You must specify at least one subnet. If you specify multiple
+    #   subnets, they must meet the following criteria:
+    #
+    #   * All subnets must be in the same virtual private cloud (VPC).
+    #
+    #   * You can specify only one subnet per Availability Zone.
+    #
+    # @option params [required, String] :hsm_type
+    #   The type of HSM to use in the cluster. Currently the only allowed
+    #   value is `hsm1.medium`.
+    #
+    # @option params [String] :source_backup_id
+    #   The identifier (ID) of the cluster backup to restore. Use this value
+    #   to restore the cluster from a backup instead of creating a new
+    #   cluster. To find the backup ID, use DescribeBackups.
+    #
+    # @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({
+    #     subnet_ids: ["SubnetId"], # required
+    #     hsm_type: "HsmType", # required
+    #     source_backup_id: "BackupId",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.cluster.backup_policy #=> String, one of "DEFAULT"
+    #   resp.cluster.cluster_id #=> String
+    #   resp.cluster.create_timestamp #=> Time
+    #   resp.cluster.hsms #=> Array
+    #   resp.cluster.hsms[0].availability_zone #=> String
+    #   resp.cluster.hsms[0].cluster_id #=> String
+    #   resp.cluster.hsms[0].subnet_id #=> String
+    #   resp.cluster.hsms[0].eni_id #=> String
+    #   resp.cluster.hsms[0].eni_ip #=> String
+    #   resp.cluster.hsms[0].hsm_id #=> String
+    #   resp.cluster.hsms[0].state #=> String, one of "CREATE_IN_PROGRESS", "ACTIVE", "DEGRADED", "DELETE_IN_PROGRESS", "DELETED"
+    #   resp.cluster.hsms[0].state_message #=> String
+    #   resp.cluster.hsm_type #=> String
+    #   resp.cluster.pre_co_password #=> String
+    #   resp.cluster.security_group #=> String
+    #   resp.cluster.source_backup_id #=> String
+    #   resp.cluster.state #=> String, one of "CREATE_IN_PROGRESS", "UNINITIALIZED", "INITIALIZE_IN_PROGRESS", "INITIALIZED", "ACTIVE", "UPDATE_IN_PROGRESS", "DELETE_IN_PROGRESS", "DELETED", "DEGRADED"
+    #   resp.cluster.state_message #=> String
+    #   resp.cluster.subnet_mapping #=> Hash
+    #   resp.cluster.subnet_mapping["ExternalAz"] #=> String
+    #   resp.cluster.vpc_id #=> String
+    #   resp.cluster.certificates.cluster_csr #=> String
+    #   resp.cluster.certificates.hsm_certificate #=> String
+    #   resp.cluster.certificates.aws_hardware_certificate #=> String
+    #   resp.cluster.certificates.manufacturer_hardware_certificate #=> String
+    #   resp.cluster.certificates.cluster_certificate #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudhsmv2-2017-04-28/CreateCluster AWS API Documentation
+    #
+    # @overload create_cluster(params = {})
+    # @param [Hash] params ({})
+    def create_cluster(params = {}, options = {})
+      req = build_request(:create_cluster, params)
+      req.send_request(options)
+    end
+
+    # Creates a new hardware security module (HSM) in the specified AWS
+    # CloudHSM cluster.
+    #
+    # @option params [required, String] :cluster_id
+    #   The identifier (ID) of the HSM's cluster. To find the cluster ID, use
+    #   DescribeClusters.
+    #
+    # @option params [required, String] :availability_zone
+    #   The Availability Zone where you are creating the HSM. To find the
+    #   cluster's Availability Zones, use DescribeClusters.
+    #
+    # @option params [String] :ip_address
+    #   The HSM's IP address. If you specify an IP address, use an available
+    #   address from the subnet that maps to the Availability Zone where you
+    #   are creating the HSM. If you don't specify an IP address, one is
+    #   chosen for you from that subnet.
+    #
+    # @return [Types::CreateHsmResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateHsmResponse#hsm #hsm} => Types::Hsm
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_hsm({
+    #     cluster_id: "ClusterId", # required
+    #     availability_zone: "ExternalAz", # required
+    #     ip_address: "IpAddress",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.hsm.availability_zone #=> String
+    #   resp.hsm.cluster_id #=> String
+    #   resp.hsm.subnet_id #=> String
+    #   resp.hsm.eni_id #=> String
+    #   resp.hsm.eni_ip #=> String
+    #   resp.hsm.hsm_id #=> String
+    #   resp.hsm.state #=> String, one of "CREATE_IN_PROGRESS", "ACTIVE", "DEGRADED", "DELETE_IN_PROGRESS", "DELETED"
+    #   resp.hsm.state_message #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudhsmv2-2017-04-28/CreateHsm AWS API Documentation
+    #
+    # @overload create_hsm(params = {})
+    # @param [Hash] params ({})
+    def create_hsm(params = {}, options = {})
+      req = build_request(:create_hsm, params)
+      req.send_request(options)
+    end
+
+    # Deletes the specified AWS CloudHSM cluster. Before you can delete a
+    # cluster, you must delete all HSMs in the cluster. To see if the
+    # cluster contains any HSMs, use DescribeClusters. To delete an HSM, use
+    # DeleteHsm.
+    #
+    # @option params [required, String] :cluster_id
+    #   The identifier (ID) of the cluster that you are deleting. To find the
+    #   cluster ID, use DescribeClusters.
+    #
+    # @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_id: "ClusterId", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.cluster.backup_policy #=> String, one of "DEFAULT"
+    #   resp.cluster.cluster_id #=> String
+    #   resp.cluster.create_timestamp #=> Time
+    #   resp.cluster.hsms #=> Array
+    #   resp.cluster.hsms[0].availability_zone #=> String
+    #   resp.cluster.hsms[0].cluster_id #=> String
+    #   resp.cluster.hsms[0].subnet_id #=> String
+    #   resp.cluster.hsms[0].eni_id #=> String
+    #   resp.cluster.hsms[0].eni_ip #=> String
+    #   resp.cluster.hsms[0].hsm_id #=> String
+    #   resp.cluster.hsms[0].state #=> String, one of "CREATE_IN_PROGRESS", "ACTIVE", "DEGRADED", "DELETE_IN_PROGRESS", "DELETED"
+    #   resp.cluster.hsms[0].state_message #=> String
+    #   resp.cluster.hsm_type #=> String
+    #   resp.cluster.pre_co_password #=> String
+    #   resp.cluster.security_group #=> String
+    #   resp.cluster.source_backup_id #=> String
+    #   resp.cluster.state #=> String, one of "CREATE_IN_PROGRESS", "UNINITIALIZED", "INITIALIZE_IN_PROGRESS", "INITIALIZED", "ACTIVE", "UPDATE_IN_PROGRESS", "DELETE_IN_PROGRESS", "DELETED", "DEGRADED"
+    #   resp.cluster.state_message #=> String
+    #   resp.cluster.subnet_mapping #=> Hash
+    #   resp.cluster.subnet_mapping["ExternalAz"] #=> String
+    #   resp.cluster.vpc_id #=> String
+    #   resp.cluster.certificates.cluster_csr #=> String
+    #   resp.cluster.certificates.hsm_certificate #=> String
+    #   resp.cluster.certificates.aws_hardware_certificate #=> String
+    #   resp.cluster.certificates.manufacturer_hardware_certificate #=> String
+    #   resp.cluster.certificates.cluster_certificate #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudhsmv2-2017-04-28/DeleteCluster AWS API Documentation
+    #
+    # @overload delete_cluster(params = {})
+    # @param [Hash] params ({})
+    def delete_cluster(params = {}, options = {})
+      req = build_request(:delete_cluster, params)
+      req.send_request(options)
+    end
+
+    # Deletes the specified HSM. To specify an HSM, you can use its
+    # identifier (ID), the IP address of the HSM's elastic network
+    # interface (ENI), or the ID of the HSM's ENI. You need to specify only
+    # one of these values. To find these values, use DescribeClusters.
+    #
+    # @option params [required, String] :cluster_id
+    #   The identifier (ID) of the cluster that contains the HSM that you are
+    #   deleting.
+    #
+    # @option params [String] :hsm_id
+    #   The identifier (ID) of the HSM that you are deleting.
+    #
+    # @option params [String] :eni_id
+    #   The identifier (ID) of the elastic network interface (ENI) of the HSM
+    #   that you are deleting.
+    #
+    # @option params [String] :eni_ip
+    #   The IP address of the elastic network interface (ENI) of the HSM that
+    #   you are deleting.
+    #
+    # @return [Types::DeleteHsmResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DeleteHsmResponse#hsm_id #hsm_id} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_hsm({
+    #     cluster_id: "ClusterId", # required
+    #     hsm_id: "HsmId",
+    #     eni_id: "EniId",
+    #     eni_ip: "IpAddress",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.hsm_id #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudhsmv2-2017-04-28/DeleteHsm AWS API Documentation
+    #
+    # @overload delete_hsm(params = {})
+    # @param [Hash] params ({})
+    def delete_hsm(params = {}, options = {})
+      req = build_request(:delete_hsm, params)
+      req.send_request(options)
+    end
+
+    # Gets information about backups of AWS CloudHSM clusters.
+    #
+    # This is a paginated operation, which means that each response might
+    # contain only a subset of all the backups. When the response contains
+    # only a subset of backups, it includes a `NextToken` value. Use this
+    # value in a subsequent `DescribeBackups` request to get more backups.
+    # When you receive a response with no `NextToken` (or an empty or null
+    # value), that means there are no more backups to get.
+    #
+    # @option params [String] :next_token
+    #   The `NextToken` value that you received in the previous response. Use
+    #   this value to get more backups.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of backups to return in the response. When there
+    #   are more backups than the number you specify, the response contains a
+    #   `NextToken` value.
+    #
+    # @option params [Hash<String,Array>] :filters
+    #   One or more filters to limit the items returned in the response.
+    #
+    #   Use the `backupIds` filter to return only the specified backups.
+    #   Specify backups by their backup identifier (ID).
+    #
+    #   Use the `clusterIds` filter to return only the backups for the
+    #   specified clusters. Specify clusters by their cluster identifier (ID).
+    #
+    #   Use the `states` filter to return only backups that match the
+    #   specified state.
+    #
+    # @return [Types::DescribeBackupsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeBackupsResponse#backups #backups} => Array&lt;Types::Backup&gt;
+    #   * {Types::DescribeBackupsResponse#next_token #next_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_backups({
+    #     next_token: "NextToken",
+    #     max_results: 1,
+    #     filters: {
+    #       "Field" => ["String"],
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.backups #=> Array
+    #   resp.backups[0].backup_id #=> String
+    #   resp.backups[0].backup_state #=> String, one of "CREATE_IN_PROGRESS", "READY", "DELETED"
+    #   resp.backups[0].cluster_id #=> String
+    #   resp.backups[0].create_timestamp #=> Time
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudhsmv2-2017-04-28/DescribeBackups AWS API Documentation
+    #
+    # @overload describe_backups(params = {})
+    # @param [Hash] params ({})
+    def describe_backups(params = {}, options = {})
+      req = build_request(:describe_backups, params)
+      req.send_request(options)
+    end
+
+    # Gets information about AWS CloudHSM clusters.
+    #
+    # This is a paginated operation, which means that each response might
+    # contain only a subset of all the clusters. When the response contains
+    # only a subset of clusters, it includes a `NextToken` value. Use this
+    # value in a subsequent `DescribeClusters` request to get more clusters.
+    # When you receive a response with no `NextToken` (or an empty or null
+    # value), that means there are no more clusters to get.
+    #
+    # @option params [Hash<String,Array>] :filters
+    #   One or more filters to limit the items returned in the response.
+    #
+    #   Use the `clusterIds` filter to return only the specified clusters.
+    #   Specify clusters by their cluster identifier (ID).
+    #
+    #   Use the `vpcIds` filter to return only the clusters in the specified
+    #   virtual private clouds (VPCs). Specify VPCs by their VPC identifier
+    #   (ID).
+    #
+    #   Use the `states` filter to return only clusters that match the
+    #   specified state.
+    #
+    # @option params [String] :next_token
+    #   The `NextToken` value that you received in the previous response. Use
+    #   this value to get more clusters.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of clusters to return in the response. When there
+    #   are more clusters than the number you specify, the response contains a
+    #   `NextToken` value.
+    #
+    # @return [Types::DescribeClustersResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeClustersResponse#clusters #clusters} => Array&lt;Types::Cluster&gt;
+    #   * {Types::DescribeClustersResponse#next_token #next_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_clusters({
+    #     filters: {
+    #       "Field" => ["String"],
+    #     },
+    #     next_token: "NextToken",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.clusters #=> Array
+    #   resp.clusters[0].backup_policy #=> String, one of "DEFAULT"
+    #   resp.clusters[0].cluster_id #=> String
+    #   resp.clusters[0].create_timestamp #=> Time
+    #   resp.clusters[0].hsms #=> Array
+    #   resp.clusters[0].hsms[0].availability_zone #=> String
+    #   resp.clusters[0].hsms[0].cluster_id #=> String
+    #   resp.clusters[0].hsms[0].subnet_id #=> String
+    #   resp.clusters[0].hsms[0].eni_id #=> String
+    #   resp.clusters[0].hsms[0].eni_ip #=> String
+    #   resp.clusters[0].hsms[0].hsm_id #=> String
+    #   resp.clusters[0].hsms[0].state #=> String, one of "CREATE_IN_PROGRESS", "ACTIVE", "DEGRADED", "DELETE_IN_PROGRESS", "DELETED"
+    #   resp.clusters[0].hsms[0].state_message #=> String
+    #   resp.clusters[0].hsm_type #=> String
+    #   resp.clusters[0].pre_co_password #=> String
+    #   resp.clusters[0].security_group #=> String
+    #   resp.clusters[0].source_backup_id #=> String
+    #   resp.clusters[0].state #=> String, one of "CREATE_IN_PROGRESS", "UNINITIALIZED", "INITIALIZE_IN_PROGRESS", "INITIALIZED", "ACTIVE", "UPDATE_IN_PROGRESS", "DELETE_IN_PROGRESS", "DELETED", "DEGRADED"
+    #   resp.clusters[0].state_message #=> String
+    #   resp.clusters[0].subnet_mapping #=> Hash
+    #   resp.clusters[0].subnet_mapping["ExternalAz"] #=> String
+    #   resp.clusters[0].vpc_id #=> String
+    #   resp.clusters[0].certificates.cluster_csr #=> String
+    #   resp.clusters[0].certificates.hsm_certificate #=> String
+    #   resp.clusters[0].certificates.aws_hardware_certificate #=> String
+    #   resp.clusters[0].certificates.manufacturer_hardware_certificate #=> String
+    #   resp.clusters[0].certificates.cluster_certificate #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudhsmv2-2017-04-28/DescribeClusters AWS API Documentation
+    #
+    # @overload describe_clusters(params = {})
+    # @param [Hash] params ({})
+    def describe_clusters(params = {}, options = {})
+      req = build_request(:describe_clusters, params)
+      req.send_request(options)
+    end
+
+    # Claims an AWS CloudHSM cluster by submitting the cluster certificate
+    # issued by your issuing certificate authority (CA) and the CA's root
+    # certificate. Before you can claim a cluster, you must sign the
+    # cluster's certificate signing request (CSR) with your issuing CA. To
+    # get the cluster's CSR, use DescribeClusters.
+    #
+    # @option params [required, String] :cluster_id
+    #   The identifier (ID) of the cluster that you are claiming. To find the
+    #   cluster ID, use DescribeClusters.
+    #
+    # @option params [required, String] :signed_cert
+    #   The cluster certificate issued (signed) by your issuing certificate
+    #   authority (CA). The certificate must be in PEM format.
+    #
+    # @option params [required, String] :trust_anchor
+    #   The issuing certificate of the issuing certificate authority (CA) that
+    #   issued (signed) the cluster certificate. This can be a root
+    #   (self-signed) certificate or a certificate chain that begins with the
+    #   certificate that issued the cluster certificate and ends with a root
+    #   certificate. The certificate or certificate chain must be in PEM
+    #   format.
+    #
+    # @return [Types::InitializeClusterResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::InitializeClusterResponse#state #state} => String
+    #   * {Types::InitializeClusterResponse#state_message #state_message} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.initialize_cluster({
+    #     cluster_id: "ClusterId", # required
+    #     signed_cert: "Cert", # required
+    #     trust_anchor: "Cert", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.state #=> String, one of "CREATE_IN_PROGRESS", "UNINITIALIZED", "INITIALIZE_IN_PROGRESS", "INITIALIZED", "ACTIVE", "UPDATE_IN_PROGRESS", "DELETE_IN_PROGRESS", "DELETED", "DEGRADED"
+    #   resp.state_message #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudhsmv2-2017-04-28/InitializeCluster AWS API Documentation
+    #
+    # @overload initialize_cluster(params = {})
+    # @param [Hash] params ({})
+    def initialize_cluster(params = {}, options = {})
+      req = build_request(:initialize_cluster, params)
+      req.send_request(options)
+    end
+
+    # Gets a list of tags for the specified AWS CloudHSM cluster.
+    #
+    # This is a paginated operation, which means that each response might
+    # contain only a subset of all the tags. When the response contains only
+    # a subset of tags, it includes a `NextToken` value. Use this value in a
+    # subsequent `ListTags` request to get more tags. When you receive a
+    # response with no `NextToken` (or an empty or null value), that means
+    # there are no more tags to get.
+    #
+    # @option params [required, String] :resource_id
+    #   The cluster identifier (ID) for the cluster whose tags you are
+    #   getting. To find the cluster ID, use DescribeClusters.
+    #
+    # @option params [String] :next_token
+    #   The `NextToken` value that you received in the previous response. Use
+    #   this value to get more tags.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of tags to return in the response. When there are
+    #   more tags than the number you specify, the response contains a
+    #   `NextToken` value.
+    #
+    # @return [Types::ListTagsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListTagsResponse#tag_list #tag_list} => Array&lt;Types::Tag&gt;
+    #   * {Types::ListTagsResponse#next_token #next_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_tags({
+    #     resource_id: "ClusterId", # required
+    #     next_token: "NextToken",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.tag_list #=> Array
+    #   resp.tag_list[0].key #=> String
+    #   resp.tag_list[0].value #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudhsmv2-2017-04-28/ListTags AWS API Documentation
+    #
+    # @overload list_tags(params = {})
+    # @param [Hash] params ({})
+    def list_tags(params = {}, options = {})
+      req = build_request(:list_tags, params)
+      req.send_request(options)
+    end
+
+    # Adds or overwrites one or more tags for the specified AWS CloudHSM
+    # cluster.
+    #
+    # @option params [required, String] :resource_id
+    #   The cluster identifier (ID) for the cluster that you are tagging. To
+    #   find the cluster ID, use DescribeClusters.
+    #
+    # @option params [required, Array<Types::Tag>] :tag_list
+    #   A list of one or more tags.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.tag_resource({
+    #     resource_id: "ClusterId", # required
+    #     tag_list: [ # required
+    #       {
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
+    #       },
+    #     ],
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudhsmv2-2017-04-28/TagResource AWS API Documentation
+    #
+    # @overload tag_resource(params = {})
+    # @param [Hash] params ({})
+    def tag_resource(params = {}, options = {})
+      req = build_request(:tag_resource, params)
+      req.send_request(options)
+    end
+
+    # Removes the specified tag or tags from the specified AWS CloudHSM
+    # cluster.
+    #
+    # @option params [required, String] :resource_id
+    #   The cluster identifier (ID) for the cluster whose tags you are
+    #   removing. To find the cluster ID, use DescribeClusters.
+    #
+    # @option params [required, Array<String>] :tag_key_list
+    #   A list of one or more tag keys for the tags that you are removing.
+    #   Specify only the tag keys, not the tag values.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.untag_resource({
+    #     resource_id: "ClusterId", # required
+    #     tag_key_list: ["TagKey"], # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudhsmv2-2017-04-28/UntagResource AWS API Documentation
+    #
+    # @overload untag_resource(params = {})
+    # @param [Hash] params ({})
+    def untag_resource(params = {}, options = {})
+      req = build_request(:untag_resource, params)
+      req.send_request(options)
+    end
+
+    # @!endgroup
+
+    # @param params ({})
+    # @api private
+    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-cloudhsmv2'
+      context[:gem_version] = '1.0.0.rc1'
+      Seahorse::Client::Request.new(handlers, context)
+    end
+
+    # @api private
+    # @deprecated
+    def waiter_names
+      []
+    end
+
+    class << self
+
+      # @api private
+      attr_reader :identifier
+
+      # @api private
+      def errors_module
+        Errors
+      end
+
+    end
+  end
+end