@aws-sdk/client-opensearch 3.686.0 → 3.689.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.
Files changed (50) hide show
  1. package/README.md +24 -0
  2. package/dist-cjs/index.js +186 -3
  3. package/dist-es/OpenSearch.js +6 -0
  4. package/dist-es/commands/AssociatePackagesCommand.js +22 -0
  5. package/dist-es/commands/DissociatePackagesCommand.js +22 -0
  6. package/dist-es/commands/UpdatePackageScopeCommand.js +22 -0
  7. package/dist-es/commands/index.js +3 -0
  8. package/dist-es/models/models_0.js +8 -0
  9. package/dist-es/models/models_1.js +5 -0
  10. package/dist-es/protocols/Aws_restJson1.js +108 -1
  11. package/dist-types/OpenSearch.d.ts +21 -0
  12. package/dist-types/OpenSearchClient.d.ts +5 -2
  13. package/dist-types/commands/AssociatePackageCommand.d.ts +19 -1
  14. package/dist-types/commands/AssociatePackagesCommand.d.ts +127 -0
  15. package/dist-types/commands/CreatePackageCommand.d.ts +33 -2
  16. package/dist-types/commands/DeletePackageCommand.d.ts +18 -1
  17. package/dist-types/commands/DescribePackagesCommand.d.ts +19 -2
  18. package/dist-types/commands/DissociatePackageCommand.d.ts +10 -1
  19. package/dist-types/commands/DissociatePackagesCommand.d.ts +116 -0
  20. package/dist-types/commands/GetPackageVersionHistoryCommand.d.ts +6 -0
  21. package/dist-types/commands/ListDomainsForPackageCommand.d.ts +10 -1
  22. package/dist-types/commands/ListPackagesForDomainCommand.d.ts +10 -1
  23. package/dist-types/commands/ListVersionsCommand.d.ts +1 -1
  24. package/dist-types/commands/ListVpcEndpointAccessCommand.d.ts +1 -1
  25. package/dist-types/commands/ListVpcEndpointsCommand.d.ts +1 -1
  26. package/dist-types/commands/ListVpcEndpointsForDomainCommand.d.ts +1 -1
  27. package/dist-types/commands/PurchaseReservedInstanceOfferingCommand.d.ts +1 -1
  28. package/dist-types/commands/RejectInboundConnectionCommand.d.ts +1 -2
  29. package/dist-types/commands/UpdatePackageCommand.d.ts +28 -1
  30. package/dist-types/commands/UpdatePackageScopeCommand.d.ts +94 -0
  31. package/dist-types/commands/index.d.ts +3 -0
  32. package/dist-types/models/models_0.d.ts +242 -186
  33. package/dist-types/models/models_1.d.ts +250 -1
  34. package/dist-types/protocols/Aws_restJson1.d.ts +27 -0
  35. package/dist-types/ts3.4/OpenSearch.d.ts +51 -0
  36. package/dist-types/ts3.4/OpenSearchClient.d.ts +18 -0
  37. package/dist-types/ts3.4/commands/AssociatePackagesCommand.d.ts +51 -0
  38. package/dist-types/ts3.4/commands/DissociatePackagesCommand.d.ts +51 -0
  39. package/dist-types/ts3.4/commands/ListVersionsCommand.d.ts +1 -1
  40. package/dist-types/ts3.4/commands/ListVpcEndpointAccessCommand.d.ts +1 -1
  41. package/dist-types/ts3.4/commands/ListVpcEndpointsCommand.d.ts +1 -1
  42. package/dist-types/ts3.4/commands/ListVpcEndpointsForDomainCommand.d.ts +1 -1
  43. package/dist-types/ts3.4/commands/PurchaseReservedInstanceOfferingCommand.d.ts +1 -1
  44. package/dist-types/ts3.4/commands/RejectInboundConnectionCommand.d.ts +4 -2
  45. package/dist-types/ts3.4/commands/UpdatePackageScopeCommand.d.ts +51 -0
  46. package/dist-types/ts3.4/commands/index.d.ts +3 -0
  47. package/dist-types/ts3.4/models/models_0.d.ts +63 -43
  48. package/dist-types/ts3.4/models/models_1.d.ts +66 -0
  49. package/dist-types/ts3.4/protocols/Aws_restJson1.d.ts +36 -0
  50. package/package.json +6 -6
@@ -922,6 +922,33 @@ export interface AIMLOptionsStatus {
922
922
  */
923
923
  Status?: OptionStatus;
924
924
  }
925
+ /**
926
+ * <p>The configuration parameters to enable access to the key store required by the package.</p>
927
+ * @public
928
+ */
929
+ export interface KeyStoreAccessOption {
930
+ /**
931
+ * <p>Role ARN to access the KeyStore Key</p>
932
+ * @public
933
+ */
934
+ KeyAccessRoleArn?: string;
935
+ /**
936
+ * <p>This indicates whether Key Store access is enabled </p>
937
+ * @public
938
+ */
939
+ KeyStoreAccessEnabled: boolean | undefined;
940
+ }
941
+ /**
942
+ * <p>The configuration for associating a package with a domain.</p>
943
+ * @public
944
+ */
945
+ export interface PackageAssociationConfiguration {
946
+ /**
947
+ * <p>The configuration parameters to enable accessing the key store required by the package.</p>
948
+ * @public
949
+ */
950
+ KeyStoreAccessOption?: KeyStoreAccessOption;
951
+ }
925
952
  /**
926
953
  * <p>Container for the request parameters to the <code>AssociatePackage</code> operation.</p>
927
954
  * @public
@@ -938,6 +965,16 @@ export interface AssociatePackageRequest {
938
965
  * @public
939
966
  */
940
967
  DomainName: string | undefined;
968
+ /**
969
+ * <p>A list of package IDs that must be associated with the domain before the package specified in the request can be associated.</p>
970
+ * @public
971
+ */
972
+ PrerequisitePackageIDList?: string[];
973
+ /**
974
+ * <p>The configuration for associating a package with an Amazon OpenSearch Service domain.</p>
975
+ * @public
976
+ */
977
+ AssociationConfiguration?: PackageAssociationConfiguration;
941
978
  }
942
979
  /**
943
980
  * @public
@@ -975,6 +1012,8 @@ export interface ErrorDetails {
975
1012
  * @enum
976
1013
  */
977
1014
  export declare const PackageType: {
1015
+ readonly PACKAGE_CONFIG: "PACKAGE-CONFIG";
1016
+ readonly PACKAGE_LICENSE: "PACKAGE-LICENSE";
978
1017
  readonly TXT_DICTIONARY: "TXT-DICTIONARY";
979
1018
  readonly ZIP_PLUGIN: "ZIP-PLUGIN";
980
1019
  };
@@ -1023,6 +1062,11 @@ export interface DomainPackageDetails {
1023
1062
  * @public
1024
1063
  */
1025
1064
  PackageVersion?: string;
1065
+ /**
1066
+ * <p>A list of package IDs that must be associated with the domain before or with the package can be associated.</p>
1067
+ * @public
1068
+ */
1069
+ PrerequisitePackageIDList?: string[];
1026
1070
  /**
1027
1071
  * <p>The relative path of the package on the OpenSearch Service cluster nodes. This is <code>synonym_path</code>
1028
1072
  * when the package is for synonym files.</p>
@@ -1034,6 +1078,11 @@ export interface DomainPackageDetails {
1034
1078
  * @public
1035
1079
  */
1036
1080
  ErrorDetails?: ErrorDetails;
1081
+ /**
1082
+ * <p>The configuration for associating a package with an Amazon OpenSearch Service domain.</p>
1083
+ * @public
1084
+ */
1085
+ AssociationConfiguration?: PackageAssociationConfiguration;
1037
1086
  }
1038
1087
  /**
1039
1088
  * <p>Container for the response returned by the <code>AssociatePackage</code> operation.</p>
@@ -1058,6 +1107,53 @@ export declare class ConflictException extends __BaseException {
1058
1107
  */
1059
1108
  constructor(opts: __ExceptionOptionType<ConflictException, __BaseException>);
1060
1109
  }
1110
+ /**
1111
+ * <p> Details of a package that is associated with a domain.</p>
1112
+ * @public
1113
+ */
1114
+ export interface PackageDetailsForAssociation {
1115
+ /**
1116
+ * <p>Internal ID of the package that you want to associate with a domain.</p>
1117
+ * @public
1118
+ */
1119
+ PackageID: string | undefined;
1120
+ /**
1121
+ * <p>List of package IDs that must be associated with the domain with or before the package can be associated.</p>
1122
+ * @public
1123
+ */
1124
+ PrerequisitePackageIDList?: string[];
1125
+ /**
1126
+ * <p>The configuration parameters for associating the package with a domain.</p>
1127
+ * @public
1128
+ */
1129
+ AssociationConfiguration?: PackageAssociationConfiguration;
1130
+ }
1131
+ /**
1132
+ * @public
1133
+ */
1134
+ export interface AssociatePackagesRequest {
1135
+ /**
1136
+ * <p>A list of packages and their prerequisites to be associated with a domain.</p>
1137
+ * @public
1138
+ */
1139
+ PackageList: PackageDetailsForAssociation[] | undefined;
1140
+ /**
1141
+ * <p>The name of an OpenSearch Service domain. Domain names are unique across the domains owned
1142
+ * by an account within an Amazon Web Services Region.</p>
1143
+ * @public
1144
+ */
1145
+ DomainName: string | undefined;
1146
+ }
1147
+ /**
1148
+ * @public
1149
+ */
1150
+ export interface AssociatePackagesResponse {
1151
+ /**
1152
+ * <p>List of information about packages that are associated with a domain. </p>
1153
+ * @public
1154
+ */
1155
+ DomainPackageDetailsList?: DomainPackageDetails[];
1156
+ }
1061
1157
  /**
1062
1158
  * @public
1063
1159
  * @enum
@@ -3042,6 +3138,61 @@ export interface CreateOutboundConnectionResponse {
3042
3138
  */
3043
3139
  ConnectionProperties?: ConnectionProperties;
3044
3140
  }
3141
+ /**
3142
+ * @public
3143
+ * @enum
3144
+ */
3145
+ export declare const RequirementLevel: {
3146
+ readonly NONE: "NONE";
3147
+ readonly OPTIONAL: "OPTIONAL";
3148
+ readonly REQUIRED: "REQUIRED";
3149
+ };
3150
+ /**
3151
+ * @public
3152
+ */
3153
+ export type RequirementLevel = (typeof RequirementLevel)[keyof typeof RequirementLevel];
3154
+ /**
3155
+ * <p> The configuration parameters for a package.</p>
3156
+ * @public
3157
+ */
3158
+ export interface PackageConfiguration {
3159
+ /**
3160
+ * <p>The license requirements for the package.</p>
3161
+ * @public
3162
+ */
3163
+ LicenseRequirement: RequirementLevel | undefined;
3164
+ /**
3165
+ * <p>The relative file path for the license associated with the package.</p>
3166
+ * @public
3167
+ */
3168
+ LicenseFilepath?: string;
3169
+ /**
3170
+ * <p>The configuration requirements for the package.</p>
3171
+ * @public
3172
+ */
3173
+ ConfigurationRequirement: RequirementLevel | undefined;
3174
+ /**
3175
+ * <p>This indicates whether a B/G deployment is required for updating the configuration that the plugin is prerequisite for.</p>
3176
+ * @public
3177
+ */
3178
+ RequiresRestartForConfigurationUpdate?: boolean;
3179
+ }
3180
+ /**
3181
+ * <p>Encryption options for a package.</p>
3182
+ * @public
3183
+ */
3184
+ export interface PackageEncryptionOptions {
3185
+ /**
3186
+ * <p> KMS key ID for encrypting the package.</p>
3187
+ * @public
3188
+ */
3189
+ KmsKeyIdentifier?: string;
3190
+ /**
3191
+ * <p>This indicates whether encryption is enabled for the package.</p>
3192
+ * @public
3193
+ */
3194
+ EncryptionEnabled: boolean | undefined;
3195
+ }
3045
3196
  /**
3046
3197
  * <p>The Amazon S3 location to import the package from.</p>
3047
3198
  * @public
@@ -3058,6 +3209,19 @@ export interface PackageSource {
3058
3209
  */
3059
3210
  S3Key?: string;
3060
3211
  }
3212
+ /**
3213
+ * <p>The vending options for a package to determine if the package can be used by other users.
3214
+ * </p>
3215
+ * @public
3216
+ */
3217
+ export interface PackageVendingOptions {
3218
+ /**
3219
+ * <p>This indicates whether vending is enabled for the package to determine if package can be used by other users.
3220
+ * </p>
3221
+ * @public
3222
+ */
3223
+ VendingEnabled: boolean | undefined;
3224
+ }
3061
3225
  /**
3062
3226
  * <p>Container for request parameters to the <code>CreatePackage</code> operation.</p>
3063
3227
  * @public
@@ -3083,6 +3247,27 @@ export interface CreatePackageRequest {
3083
3247
  * @public
3084
3248
  */
3085
3249
  PackageSource: PackageSource | undefined;
3250
+ /**
3251
+ * <p> The configuration parameters for the package being created.</p>
3252
+ * @public
3253
+ */
3254
+ PackageConfiguration?: PackageConfiguration;
3255
+ /**
3256
+ * <p>The version of the Amazon OpenSearch Service engine for which is compatible with the package. This can only be specified for package type <code>ZIP-PLUGIN</code>
3257
+ * </p>
3258
+ * @public
3259
+ */
3260
+ EngineVersion?: string;
3261
+ /**
3262
+ * <p> The vending options for the package being created. They determine if the package can be vended to other users.</p>
3263
+ * @public
3264
+ */
3265
+ PackageVendingOptions?: PackageVendingOptions;
3266
+ /**
3267
+ * <p>The encryption parameters for the package being created.</p>
3268
+ * @public
3269
+ */
3270
+ PackageEncryptionOptions?: PackageEncryptionOptions;
3086
3271
  }
3087
3272
  /**
3088
3273
  * <p>Basic information about the plugin.</p>
@@ -3194,6 +3379,31 @@ export interface PackageDetails {
3194
3379
  * @public
3195
3380
  */
3196
3381
  AvailablePluginProperties?: PluginProperties;
3382
+ /**
3383
+ * <p>This represents the available configuration parameters for the package.</p>
3384
+ * @public
3385
+ */
3386
+ AvailablePackageConfiguration?: PackageConfiguration;
3387
+ /**
3388
+ * <p> A list of users who are allowed to view and associate the package. This field is only visible to the owner of a package.</p>
3389
+ * @public
3390
+ */
3391
+ AllowListedUserList?: string[];
3392
+ /**
3393
+ * <p>The owner of the package who is allowed to create/update a package and add users to the package scope.</p>
3394
+ * @public
3395
+ */
3396
+ PackageOwner?: string;
3397
+ /**
3398
+ * <p>Package Vending Options for a package.</p>
3399
+ * @public
3400
+ */
3401
+ PackageVendingOptions?: PackageVendingOptions;
3402
+ /**
3403
+ * <p>Package Encryption Options for a package.</p>
3404
+ * @public
3405
+ */
3406
+ PackageEncryptionOptions?: PackageEncryptionOptions;
3197
3407
  }
3198
3408
  /**
3199
3409
  * <p>Container for the response returned by the <code>CreatePackage</code> operation.</p>
@@ -5020,6 +5230,7 @@ export declare const DescribePackagesFilterName: {
5020
5230
  readonly EngineVersion: "EngineVersion";
5021
5231
  readonly PackageID: "PackageID";
5022
5232
  readonly PackageName: "PackageName";
5233
+ readonly PackageOwner: "PackageOwner";
5023
5234
  readonly PackageStatus: "PackageStatus";
5024
5235
  readonly PackageType: "PackageType";
5025
5236
  };
@@ -5419,6 +5630,32 @@ export interface DissociatePackageResponse {
5419
5630
  */
5420
5631
  DomainPackageDetails?: DomainPackageDetails;
5421
5632
  }
5633
+ /**
5634
+ * @public
5635
+ */
5636
+ export interface DissociatePackagesRequest {
5637
+ /**
5638
+ * <p>A list of package IDs to be dissociated from a domain.</p>
5639
+ * @public
5640
+ */
5641
+ PackageList: string[] | undefined;
5642
+ /**
5643
+ * <p>The name of an OpenSearch Service domain. Domain names are unique across the domains owned
5644
+ * by an account within an Amazon Web Services Region.</p>
5645
+ * @public
5646
+ */
5647
+ DomainName: string | undefined;
5648
+ }
5649
+ /**
5650
+ * @public
5651
+ */
5652
+ export interface DissociatePackagesResponse {
5653
+ /**
5654
+ * <p>A list of package details for the packages that were dissociated from the domain.</p>
5655
+ * @public
5656
+ */
5657
+ DomainPackageDetailsList?: DomainPackageDetails[];
5658
+ }
5422
5659
  /**
5423
5660
  * @public
5424
5661
  */
@@ -5728,6 +5965,11 @@ export interface PackageVersionHistory {
5728
5965
  * @public
5729
5966
  */
5730
5967
  PluginProperties?: PluginProperties;
5968
+ /**
5969
+ * <p>The configuration details for a specific version of a package.</p>
5970
+ * @public
5971
+ */
5972
+ PackageConfiguration?: PackageConfiguration;
5731
5973
  }
5732
5974
  /**
5733
5975
  * <p>Container for response returned by <code>GetPackageVersionHistory</code> operation.</p>
@@ -6549,192 +6791,6 @@ export interface ListTagsResponse {
6549
6791
  */
6550
6792
  TagList?: Tag[];
6551
6793
  }
6552
- /**
6553
- * <p>Container for the request parameters to the <code>ListVersions</code> operation.</p>
6554
- * @public
6555
- */
6556
- export interface ListVersionsRequest {
6557
- /**
6558
- * <p>An optional parameter that specifies the maximum number of results to return. You can use
6559
- * <code>nextToken</code> to get the next page of results.</p>
6560
- * @public
6561
- */
6562
- MaxResults?: number;
6563
- /**
6564
- * <p>If your initial <code>ListVersions</code> operation returns a <code>nextToken</code>, you
6565
- * can include the returned <code>nextToken</code> in subsequent <code>ListVersions</code>
6566
- * operations, which returns results in the next page.</p>
6567
- * @public
6568
- */
6569
- NextToken?: string;
6570
- }
6571
- /**
6572
- * <p>Container for the parameters for response received from the <code>ListVersions</code>
6573
- * operation.</p>
6574
- * @public
6575
- */
6576
- export interface ListVersionsResponse {
6577
- /**
6578
- * <p>A list of all versions of OpenSearch and Elasticsearch that Amazon OpenSearch Service
6579
- * supports.</p>
6580
- * @public
6581
- */
6582
- Versions?: string[];
6583
- /**
6584
- * <p>When <code>nextToken</code> is returned, there are more results available. The value of
6585
- * <code>nextToken</code> is a unique pagination token for each page. Send the request again using the
6586
- * returned token to retrieve the next page.</p>
6587
- * @public
6588
- */
6589
- NextToken?: string;
6590
- }
6591
- /**
6592
- * @public
6593
- */
6594
- export interface ListVpcEndpointAccessRequest {
6595
- /**
6596
- * <p>The name of the OpenSearch Service domain to retrieve access information for.</p>
6597
- * @public
6598
- */
6599
- DomainName: string | undefined;
6600
- /**
6601
- * <p>If your initial <code>ListVpcEndpointAccess</code> operation returns a
6602
- * <code>nextToken</code>, you can include the returned <code>nextToken</code> in subsequent
6603
- * <code>ListVpcEndpointAccess</code> operations, which returns results in the next page.</p>
6604
- * @public
6605
- */
6606
- NextToken?: string;
6607
- }
6608
- /**
6609
- * @public
6610
- */
6611
- export interface ListVpcEndpointAccessResponse {
6612
- /**
6613
- * <p>A list of <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html">IAM principals</a>
6614
- * that can currently access the domain.</p>
6615
- * @public
6616
- */
6617
- AuthorizedPrincipalList: AuthorizedPrincipal[] | undefined;
6618
- /**
6619
- * <p>When <code>nextToken</code> is returned, there are more results available. The value of
6620
- * <code>nextToken</code> is a unique pagination token for each page. Send the request again using the
6621
- * returned token to retrieve the next page.</p>
6622
- * @public
6623
- */
6624
- NextToken: string | undefined;
6625
- }
6626
- /**
6627
- * @public
6628
- */
6629
- export interface ListVpcEndpointsRequest {
6630
- /**
6631
- * <p>If your initial <code>ListVpcEndpoints</code> operation returns a <code>nextToken</code>,
6632
- * you can include the returned <code>nextToken</code> in subsequent <code>ListVpcEndpoints</code>
6633
- * operations, which returns results in the next page.</p>
6634
- * @public
6635
- */
6636
- NextToken?: string;
6637
- }
6638
- /**
6639
- * @public
6640
- */
6641
- export interface ListVpcEndpointsResponse {
6642
- /**
6643
- * <p>Information about each endpoint.</p>
6644
- * @public
6645
- */
6646
- VpcEndpointSummaryList: VpcEndpointSummary[] | undefined;
6647
- /**
6648
- * <p>When <code>nextToken</code> is returned, there are more results available. The value of
6649
- * <code>nextToken</code> is a unique pagination token for each page. Send the request again using the
6650
- * returned token to retrieve the next page.</p>
6651
- * @public
6652
- */
6653
- NextToken: string | undefined;
6654
- }
6655
- /**
6656
- * @public
6657
- */
6658
- export interface ListVpcEndpointsForDomainRequest {
6659
- /**
6660
- * <p>The name of the domain to list associated VPC endpoints for.</p>
6661
- * @public
6662
- */
6663
- DomainName: string | undefined;
6664
- /**
6665
- * <p>If your initial <code>ListEndpointsForDomain</code> operation returns a
6666
- * <code>nextToken</code>, you can include the returned <code>nextToken</code> in subsequent
6667
- * <code>ListEndpointsForDomain</code> operations, which returns results in the next page.</p>
6668
- * @public
6669
- */
6670
- NextToken?: string;
6671
- }
6672
- /**
6673
- * @public
6674
- */
6675
- export interface ListVpcEndpointsForDomainResponse {
6676
- /**
6677
- * <p>Information about each endpoint associated with the domain.</p>
6678
- * @public
6679
- */
6680
- VpcEndpointSummaryList: VpcEndpointSummary[] | undefined;
6681
- /**
6682
- * <p>When <code>nextToken</code> is returned, there are more results available. The value of
6683
- * <code>nextToken</code> is a unique pagination token for each page. Send the request again using the
6684
- * returned token to retrieve the next page.</p>
6685
- * @public
6686
- */
6687
- NextToken: string | undefined;
6688
- }
6689
- /**
6690
- * <p>Container for request parameters to the <code>PurchaseReservedInstanceOffering</code>
6691
- * operation.</p>
6692
- * @public
6693
- */
6694
- export interface PurchaseReservedInstanceOfferingRequest {
6695
- /**
6696
- * <p>The ID of the Reserved Instance offering to purchase.</p>
6697
- * @public
6698
- */
6699
- ReservedInstanceOfferingId: string | undefined;
6700
- /**
6701
- * <p>A customer-specified identifier to track this reservation.</p>
6702
- * @public
6703
- */
6704
- ReservationName: string | undefined;
6705
- /**
6706
- * <p>The number of OpenSearch instances to reserve.</p>
6707
- * @public
6708
- */
6709
- InstanceCount?: number;
6710
- }
6711
- /**
6712
- * <p>Represents the output of a <code>PurchaseReservedInstanceOffering</code> operation.</p>
6713
- * @public
6714
- */
6715
- export interface PurchaseReservedInstanceOfferingResponse {
6716
- /**
6717
- * <p>The ID of the Reserved Instance offering that was purchased.</p>
6718
- * @public
6719
- */
6720
- ReservedInstanceId?: string;
6721
- /**
6722
- * <p>The customer-specified identifier used to track this reservation.</p>
6723
- * @public
6724
- */
6725
- ReservationName?: string;
6726
- }
6727
- /**
6728
- * <p>Container for the request parameters to the <code>RejectInboundConnection</code> operation.</p>
6729
- * @public
6730
- */
6731
- export interface RejectInboundConnectionRequest {
6732
- /**
6733
- * <p>The unique identifier of the inbound connection to reject.</p>
6734
- * @public
6735
- */
6736
- ConnectionId: string | undefined;
6737
- }
6738
6794
  /**
6739
6795
  * @internal
6740
6796
  */