aws-sdk-elasticsearchservice 1.31.0 → 1.32.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -25,7 +25,9 @@ module Aws::ElasticsearchService
25
25
  # See {Seahorse::Client::RequestContext} for more information.
26
26
  #
27
27
  # ## Error Classes
28
+ # * {AccessDeniedException}
28
29
  # * {BaseException}
30
+ # * {ConflictException}
29
31
  # * {DisabledOperationException}
30
32
  # * {InternalException}
31
33
  # * {InvalidTypeException}
@@ -40,6 +42,16 @@ module Aws::ElasticsearchService
40
42
 
41
43
  extend Aws::Errors::DynamicErrors
42
44
 
45
+ class AccessDeniedException < ServiceError
46
+
47
+ # @param [Seahorse::Client::RequestContext] context
48
+ # @param [String] message
49
+ # @param [Aws::ElasticsearchService::Types::AccessDeniedException] data
50
+ def initialize(context, message, data = Aws::EmptyStructure.new)
51
+ super(context, message, data)
52
+ end
53
+ end
54
+
43
55
  class BaseException < ServiceError
44
56
 
45
57
  # @param [Seahorse::Client::RequestContext] context
@@ -55,6 +67,16 @@ module Aws::ElasticsearchService
55
67
  end
56
68
  end
57
69
 
70
+ class ConflictException < ServiceError
71
+
72
+ # @param [Seahorse::Client::RequestContext] context
73
+ # @param [String] message
74
+ # @param [Aws::ElasticsearchService::Types::ConflictException] data
75
+ def initialize(context, message, data = Aws::EmptyStructure.new)
76
+ super(context, message, data)
77
+ end
78
+ end
79
+
58
80
  class DisabledOperationException < ServiceError
59
81
 
60
82
  # @param [Seahorse::Client::RequestContext] context
@@ -6,13 +6,7 @@
6
6
  # WARNING ABOUT GENERATED CODE
7
7
 
8
8
  module Aws::ElasticsearchService
9
- # This class provides a resource oriented interface for ElasticsearchService.
10
- # To create a resource object:
11
- # resource = Aws::ElasticsearchService::Resource.new(region: 'us-west-2')
12
- # You can supply a client object with custom configuration that will be used for all resource operations.
13
- # If you do not pass +:client+, a default client will be constructed.
14
- # client = Aws::ElasticsearchService::Client.new(region: 'us-west-2')
15
- # resource = Aws::ElasticsearchService::Resource.new(client: client)
9
+
16
10
  class Resource
17
11
 
18
12
  # @param options ({})
@@ -8,6 +8,11 @@
8
8
  module Aws::ElasticsearchService
9
9
  module Types
10
10
 
11
+ # An error occurred because user does not have permissions to access the
12
+ # resource. Returns HTTP status code 403.
13
+ #
14
+ class AccessDeniedException < Aws::EmptyStructure; end
15
+
11
16
  # The configured access rules for the domain's document and search
12
17
  # endpoints, and the current status of those rules.
13
18
  #
@@ -191,6 +196,42 @@ module Aws::ElasticsearchService
191
196
  include Aws::Structure
192
197
  end
193
198
 
199
+ # Container for request parameters to ` AssociatePackage ` operation.
200
+ #
201
+ # @note When making an API call, you may pass AssociatePackageRequest
202
+ # data as a hash:
203
+ #
204
+ # {
205
+ # package_id: "PackageID", # required
206
+ # domain_name: "DomainName", # required
207
+ # }
208
+ #
209
+ # @!attribute [rw] package_id
210
+ # Internal ID of the package that you want to associate with a domain.
211
+ # Use `DescribePackages` to find this value.
212
+ # @return [String]
213
+ #
214
+ # @!attribute [rw] domain_name
215
+ # Name of the domain that you want to associate the package with.
216
+ # @return [String]
217
+ #
218
+ class AssociatePackageRequest < Struct.new(
219
+ :package_id,
220
+ :domain_name)
221
+ include Aws::Structure
222
+ end
223
+
224
+ # Container for response returned by ` AssociatePackage ` operation.
225
+ #
226
+ # @!attribute [rw] domain_package_details
227
+ # `DomainPackageDetails`
228
+ # @return [Types::DomainPackageDetails]
229
+ #
230
+ class AssociatePackageResponse < Struct.new(
231
+ :domain_package_details)
232
+ include Aws::Structure
233
+ end
234
+
194
235
  # An error occurred while processing the request.
195
236
  #
196
237
  # @!attribute [rw] message
@@ -314,6 +355,11 @@ module Aws::ElasticsearchService
314
355
  include Aws::Structure
315
356
  end
316
357
 
358
+ # An error occurred because the client attempts to remove a resource
359
+ # that is currently in use. Returns HTTP status code 409.
360
+ #
361
+ class ConflictException < Aws::EmptyStructure; end
362
+
317
363
  # @note When making an API call, you may pass CreateElasticsearchDomainRequest
318
364
  # data as a hash:
319
365
  #
@@ -506,6 +552,56 @@ module Aws::ElasticsearchService
506
552
  include Aws::Structure
507
553
  end
508
554
 
555
+ # Container for request parameters to ` CreatePackage ` operation.
556
+ #
557
+ # @note When making an API call, you may pass CreatePackageRequest
558
+ # data as a hash:
559
+ #
560
+ # {
561
+ # package_name: "PackageName", # required
562
+ # package_type: "TXT-DICTIONARY", # required, accepts TXT-DICTIONARY
563
+ # package_description: "PackageDescription",
564
+ # package_source: { # required
565
+ # s3_bucket_name: "S3BucketName",
566
+ # s3_key: "S3Key",
567
+ # },
568
+ # }
569
+ #
570
+ # @!attribute [rw] package_name
571
+ # Unique identifier for the package.
572
+ # @return [String]
573
+ #
574
+ # @!attribute [rw] package_type
575
+ # Type of package. Currently supports only TXT-DICTIONARY.
576
+ # @return [String]
577
+ #
578
+ # @!attribute [rw] package_description
579
+ # Description of the package.
580
+ # @return [String]
581
+ #
582
+ # @!attribute [rw] package_source
583
+ # The customer S3 location `PackageSource` for importing the package.
584
+ # @return [Types::PackageSource]
585
+ #
586
+ class CreatePackageRequest < Struct.new(
587
+ :package_name,
588
+ :package_type,
589
+ :package_description,
590
+ :package_source)
591
+ include Aws::Structure
592
+ end
593
+
594
+ # Container for response returned by ` CreatePackage ` operation.
595
+ #
596
+ # @!attribute [rw] package_details
597
+ # Information about the package `PackageDetails`.
598
+ # @return [Types::PackageDetails]
599
+ #
600
+ class CreatePackageResponse < Struct.new(
601
+ :package_details)
602
+ include Aws::Structure
603
+ end
604
+
509
605
  # Container for the parameters to the `DeleteElasticsearchDomain`
510
606
  # operation. Specifies the name of the Elasticsearch domain that you
511
607
  # want to delete.
@@ -540,6 +636,36 @@ module Aws::ElasticsearchService
540
636
  include Aws::Structure
541
637
  end
542
638
 
639
+ # Container for request parameters to ` DeletePackage ` operation.
640
+ #
641
+ # @note When making an API call, you may pass DeletePackageRequest
642
+ # data as a hash:
643
+ #
644
+ # {
645
+ # package_id: "PackageID", # required
646
+ # }
647
+ #
648
+ # @!attribute [rw] package_id
649
+ # Internal ID of the package that you want to delete. Use
650
+ # `DescribePackages` to find this value.
651
+ # @return [String]
652
+ #
653
+ class DeletePackageRequest < Struct.new(
654
+ :package_id)
655
+ include Aws::Structure
656
+ end
657
+
658
+ # Container for response parameters to ` DeletePackage ` operation.
659
+ #
660
+ # @!attribute [rw] package_details
661
+ # `PackageDetails`
662
+ # @return [Types::PackageDetails]
663
+ #
664
+ class DeletePackageResponse < Struct.new(
665
+ :package_details)
666
+ include Aws::Structure
667
+ end
668
+
543
669
  # Container for the parameters to the
544
670
  # `DescribeElasticsearchDomainConfig` operation. Specifies the domain
545
671
  # name for which you want configuration information.
@@ -687,6 +813,83 @@ module Aws::ElasticsearchService
687
813
  include Aws::Structure
688
814
  end
689
815
 
816
+ # Filter to apply in `DescribePackage` response.
817
+ #
818
+ # @note When making an API call, you may pass DescribePackagesFilter
819
+ # data as a hash:
820
+ #
821
+ # {
822
+ # name: "PackageID", # accepts PackageID, PackageName, PackageStatus
823
+ # value: ["DescribePackagesFilterValue"],
824
+ # }
825
+ #
826
+ # @!attribute [rw] name
827
+ # Any field from `PackageDetails`.
828
+ # @return [String]
829
+ #
830
+ # @!attribute [rw] value
831
+ # A list of values for the specified field.
832
+ # @return [Array<String>]
833
+ #
834
+ class DescribePackagesFilter < Struct.new(
835
+ :name,
836
+ :value)
837
+ include Aws::Structure
838
+ end
839
+
840
+ # Container for request parameters to ` DescribePackage ` operation.
841
+ #
842
+ # @note When making an API call, you may pass DescribePackagesRequest
843
+ # data as a hash:
844
+ #
845
+ # {
846
+ # filters: [
847
+ # {
848
+ # name: "PackageID", # accepts PackageID, PackageName, PackageStatus
849
+ # value: ["DescribePackagesFilterValue"],
850
+ # },
851
+ # ],
852
+ # max_results: 1,
853
+ # next_token: "NextToken",
854
+ # }
855
+ #
856
+ # @!attribute [rw] filters
857
+ # Only returns packages that match the `DescribePackagesFilterList`
858
+ # values.
859
+ # @return [Array<Types::DescribePackagesFilter>]
860
+ #
861
+ # @!attribute [rw] max_results
862
+ # Limits results to a maximum number of packages.
863
+ # @return [Integer]
864
+ #
865
+ # @!attribute [rw] next_token
866
+ # Used for pagination. Only necessary if a previous API call includes
867
+ # a non-null NextToken value. If provided, returns results for the
868
+ # next page.
869
+ # @return [String]
870
+ #
871
+ class DescribePackagesRequest < Struct.new(
872
+ :filters,
873
+ :max_results,
874
+ :next_token)
875
+ include Aws::Structure
876
+ end
877
+
878
+ # Container for response returned by ` DescribePackages ` operation.
879
+ #
880
+ # @!attribute [rw] package_details_list
881
+ # List of `PackageDetails` objects.
882
+ # @return [Array<Types::PackageDetails>]
883
+ #
884
+ # @!attribute [rw] next_token
885
+ # @return [String]
886
+ #
887
+ class DescribePackagesResponse < Struct.new(
888
+ :package_details_list,
889
+ :next_token)
890
+ include Aws::Structure
891
+ end
892
+
690
893
  # Container for parameters to
691
894
  # `DescribeReservedElasticsearchInstanceOfferings`
692
895
  #
@@ -794,6 +997,42 @@ module Aws::ElasticsearchService
794
997
  #
795
998
  class DisabledOperationException < Aws::EmptyStructure; end
796
999
 
1000
+ # Container for request parameters to ` DissociatePackage ` operation.
1001
+ #
1002
+ # @note When making an API call, you may pass DissociatePackageRequest
1003
+ # data as a hash:
1004
+ #
1005
+ # {
1006
+ # package_id: "PackageID", # required
1007
+ # domain_name: "DomainName", # required
1008
+ # }
1009
+ #
1010
+ # @!attribute [rw] package_id
1011
+ # Internal ID of the package that you want to associate with a domain.
1012
+ # Use `DescribePackages` to find this value.
1013
+ # @return [String]
1014
+ #
1015
+ # @!attribute [rw] domain_name
1016
+ # Name of the domain that you want to associate the package with.
1017
+ # @return [String]
1018
+ #
1019
+ class DissociatePackageRequest < Struct.new(
1020
+ :package_id,
1021
+ :domain_name)
1022
+ include Aws::Structure
1023
+ end
1024
+
1025
+ # Container for response returned by ` DissociatePackage ` operation.
1026
+ #
1027
+ # @!attribute [rw] domain_package_details
1028
+ # `DomainPackageDetails`
1029
+ # @return [Types::DomainPackageDetails]
1030
+ #
1031
+ class DissociatePackageResponse < Struct.new(
1032
+ :domain_package_details)
1033
+ include Aws::Structure
1034
+ end
1035
+
797
1036
  # Options to configure endpoint for the Elasticsearch domain.
798
1037
  #
799
1038
  # @note When making an API call, you may pass DomainEndpointOptions
@@ -852,6 +1091,55 @@ module Aws::ElasticsearchService
852
1091
  include Aws::Structure
853
1092
  end
854
1093
 
1094
+ # Information on a package that is associated with a domain.
1095
+ #
1096
+ # @!attribute [rw] package_id
1097
+ # Internal ID of the package.
1098
+ # @return [String]
1099
+ #
1100
+ # @!attribute [rw] package_name
1101
+ # User specified name of the package.
1102
+ # @return [String]
1103
+ #
1104
+ # @!attribute [rw] package_type
1105
+ # Currently supports only TXT-DICTIONARY.
1106
+ # @return [String]
1107
+ #
1108
+ # @!attribute [rw] last_updated
1109
+ # Timestamp of the most-recent update to the association status.
1110
+ # @return [Time]
1111
+ #
1112
+ # @!attribute [rw] domain_name
1113
+ # Name of the domain you've associated a package with.
1114
+ # @return [String]
1115
+ #
1116
+ # @!attribute [rw] domain_package_status
1117
+ # State of the association. Values are
1118
+ # ASSOCIATING/ASSOCIATION\_FAILED/ACTIVE/DISSOCIATING/DISSOCIATION\_FAILED.
1119
+ # @return [String]
1120
+ #
1121
+ # @!attribute [rw] reference_path
1122
+ # The relative path on Amazon ES nodes, which can be used as
1123
+ # synonym\_path when the package is synonym file.
1124
+ # @return [String]
1125
+ #
1126
+ # @!attribute [rw] error_details
1127
+ # Additional information if the package is in an error state. Null
1128
+ # otherwise.
1129
+ # @return [Types::ErrorDetails]
1130
+ #
1131
+ class DomainPackageDetails < Struct.new(
1132
+ :package_id,
1133
+ :package_name,
1134
+ :package_type,
1135
+ :last_updated,
1136
+ :domain_name,
1137
+ :domain_package_status,
1138
+ :reference_path,
1139
+ :error_details)
1140
+ include Aws::Structure
1141
+ end
1142
+
855
1143
  # Options to enable, disable, and specify the properties of EBS storage
856
1144
  # volumes. For more information, see [ Configuring EBS-based
857
1145
  # Storage][1].
@@ -1327,6 +1615,18 @@ module Aws::ElasticsearchService
1327
1615
  include Aws::Structure
1328
1616
  end
1329
1617
 
1618
+ # @!attribute [rw] error_type
1619
+ # @return [String]
1620
+ #
1621
+ # @!attribute [rw] error_message
1622
+ # @return [String]
1623
+ #
1624
+ class ErrorDetails < Struct.new(
1625
+ :error_type,
1626
+ :error_message)
1627
+ include Aws::Structure
1628
+ end
1629
+
1330
1630
  # Container for request parameters to `
1331
1631
  # GetCompatibleElasticsearchVersions ` operation.
1332
1632
  #
@@ -1552,6 +1852,55 @@ module Aws::ElasticsearchService
1552
1852
  include Aws::Structure
1553
1853
  end
1554
1854
 
1855
+ # Container for request parameters to ` ListDomainsForPackage `
1856
+ # operation.
1857
+ #
1858
+ # @note When making an API call, you may pass ListDomainsForPackageRequest
1859
+ # data as a hash:
1860
+ #
1861
+ # {
1862
+ # package_id: "PackageID", # required
1863
+ # max_results: 1,
1864
+ # next_token: "NextToken",
1865
+ # }
1866
+ #
1867
+ # @!attribute [rw] package_id
1868
+ # The package for which to list domains.
1869
+ # @return [String]
1870
+ #
1871
+ # @!attribute [rw] max_results
1872
+ # Limits results to a maximum number of domains.
1873
+ # @return [Integer]
1874
+ #
1875
+ # @!attribute [rw] next_token
1876
+ # Used for pagination. Only necessary if a previous API call includes
1877
+ # a non-null NextToken value. If provided, returns results for the
1878
+ # next page.
1879
+ # @return [String]
1880
+ #
1881
+ class ListDomainsForPackageRequest < Struct.new(
1882
+ :package_id,
1883
+ :max_results,
1884
+ :next_token)
1885
+ include Aws::Structure
1886
+ end
1887
+
1888
+ # Container for response parameters to ` ListDomainsForPackage `
1889
+ # operation.
1890
+ #
1891
+ # @!attribute [rw] domain_package_details_list
1892
+ # List of `DomainPackageDetails` objects.
1893
+ # @return [Array<Types::DomainPackageDetails>]
1894
+ #
1895
+ # @!attribute [rw] next_token
1896
+ # @return [String]
1897
+ #
1898
+ class ListDomainsForPackageResponse < Struct.new(
1899
+ :domain_package_details_list,
1900
+ :next_token)
1901
+ include Aws::Structure
1902
+ end
1903
+
1555
1904
  # Container for the parameters to the ` ListElasticsearchInstanceTypes `
1556
1905
  # operation.
1557
1906
  #
@@ -1668,6 +2017,58 @@ module Aws::ElasticsearchService
1668
2017
  include Aws::Structure
1669
2018
  end
1670
2019
 
2020
+ # Container for request parameters to ` ListPackagesForDomain `
2021
+ # operation.
2022
+ #
2023
+ # @note When making an API call, you may pass ListPackagesForDomainRequest
2024
+ # data as a hash:
2025
+ #
2026
+ # {
2027
+ # domain_name: "DomainName", # required
2028
+ # max_results: 1,
2029
+ # next_token: "NextToken",
2030
+ # }
2031
+ #
2032
+ # @!attribute [rw] domain_name
2033
+ # The name of the domain for which you want to list associated
2034
+ # packages.
2035
+ # @return [String]
2036
+ #
2037
+ # @!attribute [rw] max_results
2038
+ # Limits results to a maximum number of packages.
2039
+ # @return [Integer]
2040
+ #
2041
+ # @!attribute [rw] next_token
2042
+ # Used for pagination. Only necessary if a previous API call includes
2043
+ # a non-null NextToken value. If provided, returns results for the
2044
+ # next page.
2045
+ # @return [String]
2046
+ #
2047
+ class ListPackagesForDomainRequest < Struct.new(
2048
+ :domain_name,
2049
+ :max_results,
2050
+ :next_token)
2051
+ include Aws::Structure
2052
+ end
2053
+
2054
+ # Container for response parameters to ` ListPackagesForDomain `
2055
+ # operation.
2056
+ #
2057
+ # @!attribute [rw] domain_package_details_list
2058
+ # List of `DomainPackageDetails` objects.
2059
+ # @return [Array<Types::DomainPackageDetails>]
2060
+ #
2061
+ # @!attribute [rw] next_token
2062
+ # Pagination token that needs to be supplied to the next call to get
2063
+ # the next page of results.
2064
+ # @return [String]
2065
+ #
2066
+ class ListPackagesForDomainResponse < Struct.new(
2067
+ :domain_package_details_list,
2068
+ :next_token)
2069
+ include Aws::Structure
2070
+ end
2071
+
1671
2072
  # Container for the parameters to the `ListTags` operation. Specify the
1672
2073
  # `ARN` for the Elasticsearch domain to which the tags are attached that
1673
2074
  # you want to view are attached.
@@ -1849,6 +2250,74 @@ module Aws::ElasticsearchService
1849
2250
  include Aws::Structure
1850
2251
  end
1851
2252
 
2253
+ # Basic information about a package.
2254
+ #
2255
+ # @!attribute [rw] package_id
2256
+ # Internal ID of the package.
2257
+ # @return [String]
2258
+ #
2259
+ # @!attribute [rw] package_name
2260
+ # User specified name of the package.
2261
+ # @return [String]
2262
+ #
2263
+ # @!attribute [rw] package_type
2264
+ # Currently supports only TXT-DICTIONARY.
2265
+ # @return [String]
2266
+ #
2267
+ # @!attribute [rw] package_description
2268
+ # User-specified description of the package.
2269
+ # @return [String]
2270
+ #
2271
+ # @!attribute [rw] package_status
2272
+ # Current state of the package. Values are
2273
+ # COPYING/COPY\_FAILED/AVAILABLE/DELETING/DELETE\_FAILED
2274
+ # @return [String]
2275
+ #
2276
+ # @!attribute [rw] created_at
2277
+ # Timestamp which tells creation date of the package.
2278
+ # @return [Time]
2279
+ #
2280
+ # @!attribute [rw] error_details
2281
+ # Additional information if the package is in an error state. Null
2282
+ # otherwise.
2283
+ # @return [Types::ErrorDetails]
2284
+ #
2285
+ class PackageDetails < Struct.new(
2286
+ :package_id,
2287
+ :package_name,
2288
+ :package_type,
2289
+ :package_description,
2290
+ :package_status,
2291
+ :created_at,
2292
+ :error_details)
2293
+ include Aws::Structure
2294
+ end
2295
+
2296
+ # The S3 location for importing the package specified as `S3BucketName`
2297
+ # and `S3Key`
2298
+ #
2299
+ # @note When making an API call, you may pass PackageSource
2300
+ # data as a hash:
2301
+ #
2302
+ # {
2303
+ # s3_bucket_name: "S3BucketName",
2304
+ # s3_key: "S3Key",
2305
+ # }
2306
+ #
2307
+ # @!attribute [rw] s3_bucket_name
2308
+ # Name of the bucket containing the package.
2309
+ # @return [String]
2310
+ #
2311
+ # @!attribute [rw] s3_key
2312
+ # Key (file name) of the package.
2313
+ # @return [String]
2314
+ #
2315
+ class PackageSource < Struct.new(
2316
+ :s3_bucket_name,
2317
+ :s3_key)
2318
+ include Aws::Structure
2319
+ end
2320
+
1852
2321
  # Container for parameters to
1853
2322
  # `PurchaseReservedElasticsearchInstanceOffering`
1854
2323
  #