aws-sdk-elasticsearchservice 1.30.0 → 1.35.0

data/lib/aws-sdk-elasticsearchservice/errors.rb

@@ -6,10 +6,52 @@
 # WARNING ABOUT GENERATED CODE
 
 module Aws::ElasticsearchService
+
+  # When ElasticsearchService returns an error response, the Ruby SDK constructs and raises an error.
+  # These errors all extend Aws::ElasticsearchService::Errors::ServiceError < {Aws::Errors::ServiceError}
+  #
+  # You can rescue all ElasticsearchService errors using ServiceError:
+  #
+  #     begin
+  #       # do stuff
+  #     rescue Aws::ElasticsearchService::Errors::ServiceError
+  #       # rescues all ElasticsearchService API errors
+  #     end
+  #
+  #
+  # ## Request Context
+  # ServiceError objects have a {Aws::Errors::ServiceError#context #context} method that returns
+  # information about the request that generated the error.
+  # See {Seahorse::Client::RequestContext} for more information.
+  #
+  # ## Error Classes
+  # * {AccessDeniedException}
+  # * {BaseException}
+  # * {ConflictException}
+  # * {DisabledOperationException}
+  # * {InternalException}
+  # * {InvalidTypeException}
+  # * {LimitExceededException}
+  # * {ResourceAlreadyExistsException}
+  # * {ResourceNotFoundException}
+  # * {ValidationException}
+  #
+  # Additionally, error classes are dynamically generated for service errors based on the error code
+  # if they are not defined above.
   module Errors
 
     extend Aws::Errors::DynamicErrors
 
+    class AccessDeniedException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::ElasticsearchService::Types::AccessDeniedException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+    end
+
     class BaseException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -23,7 +65,86 @@ module Aws::ElasticsearchService
       def message
         @message || @data[:message]
       end
+    end
+
+    class ConflictException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::ElasticsearchService::Types::ConflictException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+    end
+
+    class DisabledOperationException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::ElasticsearchService::Types::DisabledOperationException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+    end
+
+    class InternalException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::ElasticsearchService::Types::InternalException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+    end
+
+    class InvalidTypeException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::ElasticsearchService::Types::InvalidTypeException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+    end
+
+    class LimitExceededException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::ElasticsearchService::Types::LimitExceededException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+    end
+
+    class ResourceAlreadyExistsException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::ElasticsearchService::Types::ResourceAlreadyExistsException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+    end
+
+    class ResourceNotFoundException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::ElasticsearchService::Types::ResourceNotFoundException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+    end
 
+    class ValidationException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::ElasticsearchService::Types::ValidationException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
     end
 
   end

data/lib/aws-sdk-elasticsearchservice/resource.rb

@@ -6,6 +6,7 @@
 # WARNING ABOUT GENERATED CODE
 
 module Aws::ElasticsearchService
+
   class Resource
 
     # @param options ({})

data/lib/aws-sdk-elasticsearchservice/types.rb

@@ -8,6 +8,11 @@
 module Aws::ElasticsearchService
   module Types
 
+    # An error occurred because user does not have permissions to access the
+    # resource. Returns HTTP status code 403.
+    #
+    class AccessDeniedException < Aws::EmptyStructure; end
+
     # The configured access rules for the domain's document and search
     # endpoints, and the current status of those rules.
     #
@@ -191,6 +196,42 @@ module Aws::ElasticsearchService
       include Aws::Structure
     end
 
+    # Container for request parameters to ` AssociatePackage ` operation.
+    #
+    # @note When making an API call, you may pass AssociatePackageRequest
+    #   data as a hash:
+    #
+    #       {
+    #         package_id: "PackageID", # required
+    #         domain_name: "DomainName", # required
+    #       }
+    #
+    # @!attribute [rw] package_id
+    #   Internal ID of the package that you want to associate with a domain.
+    #   Use `DescribePackages` to find this value.
+    #   @return [String]
+    #
+    # @!attribute [rw] domain_name
+    #   Name of the domain that you want to associate the package with.
+    #   @return [String]
+    #
+    class AssociatePackageRequest < Struct.new(
+      :package_id,
+      :domain_name)
+      include Aws::Structure
+    end
+
+    # Container for response returned by ` AssociatePackage ` operation.
+    #
+    # @!attribute [rw] domain_package_details
+    #   `DomainPackageDetails`
+    #   @return [Types::DomainPackageDetails]
+    #
+    class AssociatePackageResponse < Struct.new(
+      :domain_package_details)
+      include Aws::Structure
+    end
+
     # An error occurred while processing the request.
     #
     # @!attribute [rw] message
@@ -314,6 +355,11 @@ module Aws::ElasticsearchService
       include Aws::Structure
     end
 
+    # An error occurred because the client attempts to remove a resource
+    # that is currently in use. Returns HTTP status code 409.
+    #
+    class ConflictException < Aws::EmptyStructure; end
+
     # @note When making an API call, you may pass CreateElasticsearchDomainRequest
     #   data as a hash:
     #
@@ -506,6 +552,56 @@ module Aws::ElasticsearchService
       include Aws::Structure
     end
 
+    # Container for request parameters to ` CreatePackage ` operation.
+    #
+    # @note When making an API call, you may pass CreatePackageRequest
+    #   data as a hash:
+    #
+    #       {
+    #         package_name: "PackageName", # required
+    #         package_type: "TXT-DICTIONARY", # required, accepts TXT-DICTIONARY
+    #         package_description: "PackageDescription",
+    #         package_source: { # required
+    #           s3_bucket_name: "S3BucketName",
+    #           s3_key: "S3Key",
+    #         },
+    #       }
+    #
+    # @!attribute [rw] package_name
+    #   Unique identifier for the package.
+    #   @return [String]
+    #
+    # @!attribute [rw] package_type
+    #   Type of package. Currently supports only TXT-DICTIONARY.
+    #   @return [String]
+    #
+    # @!attribute [rw] package_description
+    #   Description of the package.
+    #   @return [String]
+    #
+    # @!attribute [rw] package_source
+    #   The customer S3 location `PackageSource` for importing the package.
+    #   @return [Types::PackageSource]
+    #
+    class CreatePackageRequest < Struct.new(
+      :package_name,
+      :package_type,
+      :package_description,
+      :package_source)
+      include Aws::Structure
+    end
+
+    # Container for response returned by ` CreatePackage ` operation.
+    #
+    # @!attribute [rw] package_details
+    #   Information about the package `PackageDetails`.
+    #   @return [Types::PackageDetails]
+    #
+    class CreatePackageResponse < Struct.new(
+      :package_details)
+      include Aws::Structure
+    end
+
     # Container for the parameters to the `DeleteElasticsearchDomain`
     # operation. Specifies the name of the Elasticsearch domain that you
     # want to delete.
@@ -540,6 +636,36 @@ module Aws::ElasticsearchService
       include Aws::Structure
     end
 
+    # Container for request parameters to ` DeletePackage ` operation.
+    #
+    # @note When making an API call, you may pass DeletePackageRequest
+    #   data as a hash:
+    #
+    #       {
+    #         package_id: "PackageID", # required
+    #       }
+    #
+    # @!attribute [rw] package_id
+    #   Internal ID of the package that you want to delete. Use
+    #   `DescribePackages` to find this value.
+    #   @return [String]
+    #
+    class DeletePackageRequest < Struct.new(
+      :package_id)
+      include Aws::Structure
+    end
+
+    # Container for response parameters to ` DeletePackage ` operation.
+    #
+    # @!attribute [rw] package_details
+    #   `PackageDetails`
+    #   @return [Types::PackageDetails]
+    #
+    class DeletePackageResponse < Struct.new(
+      :package_details)
+      include Aws::Structure
+    end
+
     # Container for the parameters to the
     # `DescribeElasticsearchDomainConfig` operation. Specifies the domain
     # name for which you want configuration information.
@@ -687,6 +813,83 @@ module Aws::ElasticsearchService
       include Aws::Structure
     end
 
+    # Filter to apply in `DescribePackage` response.
+    #
+    # @note When making an API call, you may pass DescribePackagesFilter
+    #   data as a hash:
+    #
+    #       {
+    #         name: "PackageID", # accepts PackageID, PackageName, PackageStatus
+    #         value: ["DescribePackagesFilterValue"],
+    #       }
+    #
+    # @!attribute [rw] name
+    #   Any field from `PackageDetails`.
+    #   @return [String]
+    #
+    # @!attribute [rw] value
+    #   A list of values for the specified field.
+    #   @return [Array<String>]
+    #
+    class DescribePackagesFilter < Struct.new(
+      :name,
+      :value)
+      include Aws::Structure
+    end
+
+    # Container for request parameters to ` DescribePackage ` operation.
+    #
+    # @note When making an API call, you may pass DescribePackagesRequest
+    #   data as a hash:
+    #
+    #       {
+    #         filters: [
+    #           {
+    #             name: "PackageID", # accepts PackageID, PackageName, PackageStatus
+    #             value: ["DescribePackagesFilterValue"],
+    #           },
+    #         ],
+    #         max_results: 1,
+    #         next_token: "NextToken",
+    #       }
+    #
+    # @!attribute [rw] filters
+    #   Only returns packages that match the `DescribePackagesFilterList`
+    #   values.
+    #   @return [Array<Types::DescribePackagesFilter>]
+    #
+    # @!attribute [rw] max_results
+    #   Limits results to a maximum number of packages.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] next_token
+    #   Used for pagination. Only necessary if a previous API call includes
+    #   a non-null NextToken value. If provided, returns results for the
+    #   next page.
+    #   @return [String]
+    #
+    class DescribePackagesRequest < Struct.new(
+      :filters,
+      :max_results,
+      :next_token)
+      include Aws::Structure
+    end
+
+    # Container for response returned by ` DescribePackages ` operation.
+    #
+    # @!attribute [rw] package_details_list
+    #   List of `PackageDetails` objects.
+    #   @return [Array<Types::PackageDetails>]
+    #
+    # @!attribute [rw] next_token
+    #   @return [String]
+    #
+    class DescribePackagesResponse < Struct.new(
+      :package_details_list,
+      :next_token)
+      include Aws::Structure
+    end
+
     # Container for parameters to
     # `DescribeReservedElasticsearchInstanceOfferings`
     #
@@ -789,6 +992,47 @@ module Aws::ElasticsearchService
       include Aws::Structure
     end
 
+    # An error occured because the client wanted to access a not supported
+    # operation. Gives http status code of 409.
+    #
+    class DisabledOperationException < Aws::EmptyStructure; end
+
+    # Container for request parameters to ` DissociatePackage ` operation.
+    #
+    # @note When making an API call, you may pass DissociatePackageRequest
+    #   data as a hash:
+    #
+    #       {
+    #         package_id: "PackageID", # required
+    #         domain_name: "DomainName", # required
+    #       }
+    #
+    # @!attribute [rw] package_id
+    #   Internal ID of the package that you want to associate with a domain.
+    #   Use `DescribePackages` to find this value.
+    #   @return [String]
+    #
+    # @!attribute [rw] domain_name
+    #   Name of the domain that you want to associate the package with.
+    #   @return [String]
+    #
+    class DissociatePackageRequest < Struct.new(
+      :package_id,
+      :domain_name)
+      include Aws::Structure
+    end
+
+    # Container for response returned by ` DissociatePackage ` operation.
+    #
+    # @!attribute [rw] domain_package_details
+    #   `DomainPackageDetails`
+    #   @return [Types::DomainPackageDetails]
+    #
+    class DissociatePackageResponse < Struct.new(
+      :domain_package_details)
+      include Aws::Structure
+    end
+
     # Options to configure endpoint for the Elasticsearch domain.
     #
     # @note When making an API call, you may pass DomainEndpointOptions
@@ -847,6 +1091,55 @@ module Aws::ElasticsearchService
       include Aws::Structure
     end
 
+    # Information on a package that is associated with a domain.
+    #
+    # @!attribute [rw] package_id
+    #   Internal ID of the package.
+    #   @return [String]
+    #
+    # @!attribute [rw] package_name
+    #   User specified name of the package.
+    #   @return [String]
+    #
+    # @!attribute [rw] package_type
+    #   Currently supports only TXT-DICTIONARY.
+    #   @return [String]
+    #
+    # @!attribute [rw] last_updated
+    #   Timestamp of the most-recent update to the association status.
+    #   @return [Time]
+    #
+    # @!attribute [rw] domain_name
+    #   Name of the domain you've associated a package with.
+    #   @return [String]
+    #
+    # @!attribute [rw] domain_package_status
+    #   State of the association. Values are
+    #   ASSOCIATING/ASSOCIATION\_FAILED/ACTIVE/DISSOCIATING/DISSOCIATION\_FAILED.
+    #   @return [String]
+    #
+    # @!attribute [rw] reference_path
+    #   The relative path on Amazon ES nodes, which can be used as
+    #   synonym\_path when the package is synonym file.
+    #   @return [String]
+    #
+    # @!attribute [rw] error_details
+    #   Additional information if the package is in an error state. Null
+    #   otherwise.
+    #   @return [Types::ErrorDetails]
+    #
+    class DomainPackageDetails < Struct.new(
+      :package_id,
+      :package_name,
+      :package_type,
+      :last_updated,
+      :domain_name,
+      :domain_package_status,
+      :reference_path,
+      :error_details)
+      include Aws::Structure
+    end
+
     # Options to enable, disable, and specify the properties of EBS storage
     # volumes. For more information, see [ Configuring EBS-based
     # Storage][1].
@@ -1322,6 +1615,18 @@ module Aws::ElasticsearchService
       include Aws::Structure
     end
 
+    # @!attribute [rw] error_type
+    #   @return [String]
+    #
+    # @!attribute [rw] error_message
+    #   @return [String]
+    #
+    class ErrorDetails < Struct.new(
+      :error_type,
+      :error_message)
+      include Aws::Structure
+    end
+
     # Container for request parameters to `
     # GetCompatibleElasticsearchVersions ` operation.
     #
@@ -1493,6 +1798,22 @@ module Aws::ElasticsearchService
       include Aws::Structure
     end
 
+    # The request processing has failed because of an unknown error,
+    # exception or failure (the failure is internal to the service) . Gives
+    # http status code of 500.
+    #
+    class InternalException < Aws::EmptyStructure; end
+
+    # An exception for trying to create or access sub-resource that is
+    # either invalid or not supported. Gives http status code of 409.
+    #
+    class InvalidTypeException < Aws::EmptyStructure; end
+
+    # An exception for trying to create more than allowed resources or
+    # sub-resources. Gives http status code of 409.
+    #
+    class LimitExceededException < Aws::EmptyStructure; end
+
     # Limits for given InstanceType and for each of it's role.
     #  Limits contains following ` StorageTypes, ` ` InstanceLimits ` and `
     # AdditionalLimits `
@@ -1531,6 +1852,55 @@ module Aws::ElasticsearchService
       include Aws::Structure
     end
 
+    # Container for request parameters to ` ListDomainsForPackage `
+    # operation.
+    #
+    # @note When making an API call, you may pass ListDomainsForPackageRequest
+    #   data as a hash:
+    #
+    #       {
+    #         package_id: "PackageID", # required
+    #         max_results: 1,
+    #         next_token: "NextToken",
+    #       }
+    #
+    # @!attribute [rw] package_id
+    #   The package for which to list domains.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   Limits results to a maximum number of domains.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] next_token
+    #   Used for pagination. Only necessary if a previous API call includes
+    #   a non-null NextToken value. If provided, returns results for the
+    #   next page.
+    #   @return [String]
+    #
+    class ListDomainsForPackageRequest < Struct.new(
+      :package_id,
+      :max_results,
+      :next_token)
+      include Aws::Structure
+    end
+
+    # Container for response parameters to ` ListDomainsForPackage `
+    # operation.
+    #
+    # @!attribute [rw] domain_package_details_list
+    #   List of `DomainPackageDetails` objects.
+    #   @return [Array<Types::DomainPackageDetails>]
+    #
+    # @!attribute [rw] next_token
+    #   @return [String]
+    #
+    class ListDomainsForPackageResponse < Struct.new(
+      :domain_package_details_list,
+      :next_token)
+      include Aws::Structure
+    end
+
     # Container for the parameters to the ` ListElasticsearchInstanceTypes `
     # operation.
     #
@@ -1647,6 +2017,58 @@ module Aws::ElasticsearchService
       include Aws::Structure
     end
 
+    # Container for request parameters to ` ListPackagesForDomain `
+    # operation.
+    #
+    # @note When making an API call, you may pass ListPackagesForDomainRequest
+    #   data as a hash:
+    #
+    #       {
+    #         domain_name: "DomainName", # required
+    #         max_results: 1,
+    #         next_token: "NextToken",
+    #       }
+    #
+    # @!attribute [rw] domain_name
+    #   The name of the domain for which you want to list associated
+    #   packages.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   Limits results to a maximum number of packages.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] next_token
+    #   Used for pagination. Only necessary if a previous API call includes
+    #   a non-null NextToken value. If provided, returns results for the
+    #   next page.
+    #   @return [String]
+    #
+    class ListPackagesForDomainRequest < Struct.new(
+      :domain_name,
+      :max_results,
+      :next_token)
+      include Aws::Structure
+    end
+
+    # Container for response parameters to ` ListPackagesForDomain `
+    # operation.
+    #
+    # @!attribute [rw] domain_package_details_list
+    #   List of `DomainPackageDetails` objects.
+    #   @return [Array<Types::DomainPackageDetails>]
+    #
+    # @!attribute [rw] next_token
+    #   Pagination token that needs to be supplied to the next call to get
+    #   the next page of results.
+    #   @return [String]
+    #
+    class ListPackagesForDomainResponse < Struct.new(
+      :domain_package_details_list,
+      :next_token)
+      include Aws::Structure
+    end
+
     # Container for the parameters to the `ListTags` operation. Specify the
     # `ARN` for the Elasticsearch domain to which the tags are attached that
     # you want to view are attached.
@@ -1828,6 +2250,74 @@ module Aws::ElasticsearchService
       include Aws::Structure
     end
 
+    # Basic information about a package.
+    #
+    # @!attribute [rw] package_id
+    #   Internal ID of the package.
+    #   @return [String]
+    #
+    # @!attribute [rw] package_name
+    #   User specified name of the package.
+    #   @return [String]
+    #
+    # @!attribute [rw] package_type
+    #   Currently supports only TXT-DICTIONARY.
+    #   @return [String]
+    #
+    # @!attribute [rw] package_description
+    #   User-specified description of the package.
+    #   @return [String]
+    #
+    # @!attribute [rw] package_status
+    #   Current state of the package. Values are
+    #   COPYING/COPY\_FAILED/AVAILABLE/DELETING/DELETE\_FAILED
+    #   @return [String]
+    #
+    # @!attribute [rw] created_at
+    #   Timestamp which tells creation date of the package.
+    #   @return [Time]
+    #
+    # @!attribute [rw] error_details
+    #   Additional information if the package is in an error state. Null
+    #   otherwise.
+    #   @return [Types::ErrorDetails]
+    #
+    class PackageDetails < Struct.new(
+      :package_id,
+      :package_name,
+      :package_type,
+      :package_description,
+      :package_status,
+      :created_at,
+      :error_details)
+      include Aws::Structure
+    end
+
+    # The S3 location for importing the package specified as `S3BucketName`
+    # and `S3Key`
+    #
+    # @note When making an API call, you may pass PackageSource
+    #   data as a hash:
+    #
+    #       {
+    #         s3_bucket_name: "S3BucketName",
+    #         s3_key: "S3Key",
+    #       }
+    #
+    # @!attribute [rw] s3_bucket_name
+    #   Name of the bucket containing the package.
+    #   @return [String]
+    #
+    # @!attribute [rw] s3_key
+    #   Key (file name) of the package.
+    #   @return [String]
+    #
+    class PackageSource < Struct.new(
+      :s3_bucket_name,
+      :s3_key)
+      include Aws::Structure
+    end
+
     # Container for parameters to
     # `PurchaseReservedElasticsearchInstanceOffering`
     #
@@ -2050,6 +2540,16 @@ module Aws::ElasticsearchService
       include Aws::Structure
     end
 
+    # An exception for creating a resource that already exists. Gives http
+    # status code of 400.
+    #
+    class ResourceAlreadyExistsException < Aws::EmptyStructure; end
+
+    # An exception for accessing or deleting a resource that does not exist.
+    # Gives http status code of 400.
+    #
+    class ResourceNotFoundException < Aws::EmptyStructure; end
+
     # The current options of an Elasticsearch domain service software
     # options.
     #
@@ -2088,6 +2588,12 @@ module Aws::ElasticsearchService
     #   your service software.
     #   @return [Time]
     #
+    # @!attribute [rw] optional_deployment
+    #   `True` if a service software is never automatically updated. `False`
+    #   if a service software is automatically updated after
+    #   `AutomatedUpdateDate`.
+    #   @return [Boolean]
+    #
     class ServiceSoftwareOptions < Struct.new(
       :current_version,
       :new_version,
@@ -2095,7 +2601,8 @@ module Aws::ElasticsearchService
       :cancellable,
       :update_status,
       :description,
-      :automated_update_date)
+      :automated_update_date,
+      :optional_deployment)
       include Aws::Structure
     end
 
@@ -2628,6 +3135,11 @@ module Aws::ElasticsearchService
       include Aws::Structure
     end
 
+    # An exception for missing / invalid input fields. Gives http status
+    # code of 400.
+    #
+    class ValidationException < Aws::EmptyStructure; end
+
     # Specifies the zone awareness configuration for the domain cluster,
     # such as the number of availability zones.
     #