UNPKG

43.9 kBTypeScriptView Raw
1import {Request} from '../lib/request';
2import {Response} from '../lib/response';
3import {AWSError} from '../lib/error';
4import {Service} from '../lib/service';
5import {ServiceConfigurationOptions} from '../lib/service';
6import {ConfigBase as Config} from '../lib/config';
7interface Blob {}
8declare class DAX extends Service {
9 /**
10 * Constructs a service object. This object has one method for each API operation.
11 */
12 constructor(options?: DAX.Types.ClientConfiguration)
13 config: Config & DAX.Types.ClientConfiguration;
14 /**
15 * Creates a DAX cluster. All nodes in the cluster run the same DAX caching software.
16 */
17 createCluster(params: DAX.Types.CreateClusterRequest, callback?: (err: AWSError, data: DAX.Types.CreateClusterResponse) => void): Request<DAX.Types.CreateClusterResponse, AWSError>;
18 /**
19 * Creates a DAX cluster. All nodes in the cluster run the same DAX caching software.
20 */
21 createCluster(callback?: (err: AWSError, data: DAX.Types.CreateClusterResponse) => void): Request<DAX.Types.CreateClusterResponse, AWSError>;
22 /**
23 * Creates a new parameter group. A parameter group is a collection of parameters that you apply to all of the nodes in a DAX cluster.
24 */
25 createParameterGroup(params: DAX.Types.CreateParameterGroupRequest, callback?: (err: AWSError, data: DAX.Types.CreateParameterGroupResponse) => void): Request<DAX.Types.CreateParameterGroupResponse, AWSError>;
26 /**
27 * Creates a new parameter group. A parameter group is a collection of parameters that you apply to all of the nodes in a DAX cluster.
28 */
29 createParameterGroup(callback?: (err: AWSError, data: DAX.Types.CreateParameterGroupResponse) => void): Request<DAX.Types.CreateParameterGroupResponse, AWSError>;
30 /**
31 * Creates a new subnet group.
32 */
33 createSubnetGroup(params: DAX.Types.CreateSubnetGroupRequest, callback?: (err: AWSError, data: DAX.Types.CreateSubnetGroupResponse) => void): Request<DAX.Types.CreateSubnetGroupResponse, AWSError>;
34 /**
35 * Creates a new subnet group.
36 */
37 createSubnetGroup(callback?: (err: AWSError, data: DAX.Types.CreateSubnetGroupResponse) => void): Request<DAX.Types.CreateSubnetGroupResponse, AWSError>;
38 /**
39 * Removes one or more nodes from a DAX cluster. You cannot use DecreaseReplicationFactor to remove the last node in a DAX cluster. If you need to do this, use DeleteCluster instead.
40 */
41 decreaseReplicationFactor(params: DAX.Types.DecreaseReplicationFactorRequest, callback?: (err: AWSError, data: DAX.Types.DecreaseReplicationFactorResponse) => void): Request<DAX.Types.DecreaseReplicationFactorResponse, AWSError>;
42 /**
43 * Removes one or more nodes from a DAX cluster. You cannot use DecreaseReplicationFactor to remove the last node in a DAX cluster. If you need to do this, use DeleteCluster instead.
44 */
45 decreaseReplicationFactor(callback?: (err: AWSError, data: DAX.Types.DecreaseReplicationFactorResponse) => void): Request<DAX.Types.DecreaseReplicationFactorResponse, AWSError>;
46 /**
47 * Deletes a previously provisioned DAX cluster. DeleteCluster deletes all associated nodes, node endpoints and the DAX cluster itself. When you receive a successful response from this action, DAX immediately begins deleting the cluster; you cannot cancel or revert this action.
48 */
49 deleteCluster(params: DAX.Types.DeleteClusterRequest, callback?: (err: AWSError, data: DAX.Types.DeleteClusterResponse) => void): Request<DAX.Types.DeleteClusterResponse, AWSError>;
50 /**
51 * Deletes a previously provisioned DAX cluster. DeleteCluster deletes all associated nodes, node endpoints and the DAX cluster itself. When you receive a successful response from this action, DAX immediately begins deleting the cluster; you cannot cancel or revert this action.
52 */
53 deleteCluster(callback?: (err: AWSError, data: DAX.Types.DeleteClusterResponse) => void): Request<DAX.Types.DeleteClusterResponse, AWSError>;
54 /**
55 * Deletes the specified parameter group. You cannot delete a parameter group if it is associated with any DAX clusters.
56 */
57 deleteParameterGroup(params: DAX.Types.DeleteParameterGroupRequest, callback?: (err: AWSError, data: DAX.Types.DeleteParameterGroupResponse) => void): Request<DAX.Types.DeleteParameterGroupResponse, AWSError>;
58 /**
59 * Deletes the specified parameter group. You cannot delete a parameter group if it is associated with any DAX clusters.
60 */
61 deleteParameterGroup(callback?: (err: AWSError, data: DAX.Types.DeleteParameterGroupResponse) => void): Request<DAX.Types.DeleteParameterGroupResponse, AWSError>;
62 /**
63 * Deletes a subnet group. You cannot delete a subnet group if it is associated with any DAX clusters.
64 */
65 deleteSubnetGroup(params: DAX.Types.DeleteSubnetGroupRequest, callback?: (err: AWSError, data: DAX.Types.DeleteSubnetGroupResponse) => void): Request<DAX.Types.DeleteSubnetGroupResponse, AWSError>;
66 /**
67 * Deletes a subnet group. You cannot delete a subnet group if it is associated with any DAX clusters.
68 */
69 deleteSubnetGroup(callback?: (err: AWSError, data: DAX.Types.DeleteSubnetGroupResponse) => void): Request<DAX.Types.DeleteSubnetGroupResponse, AWSError>;
70 /**
71 * Returns information about all provisioned DAX clusters if no cluster identifier is specified, or about a specific DAX cluster if a cluster identifier is supplied. If the cluster is in the CREATING state, only cluster level information will be displayed until all of the nodes are successfully provisioned. If the cluster is in the DELETING state, only cluster level information will be displayed. If nodes are currently being added to the DAX cluster, node endpoint information and creation time for the additional nodes will not be displayed until they are completely provisioned. When the DAX cluster state is available, the cluster is ready for use. If nodes are currently being removed from the DAX cluster, no endpoint information for the removed nodes is displayed.
72 */
73 describeClusters(params: DAX.Types.DescribeClustersRequest, callback?: (err: AWSError, data: DAX.Types.DescribeClustersResponse) => void): Request<DAX.Types.DescribeClustersResponse, AWSError>;
74 /**
75 * Returns information about all provisioned DAX clusters if no cluster identifier is specified, or about a specific DAX cluster if a cluster identifier is supplied. If the cluster is in the CREATING state, only cluster level information will be displayed until all of the nodes are successfully provisioned. If the cluster is in the DELETING state, only cluster level information will be displayed. If nodes are currently being added to the DAX cluster, node endpoint information and creation time for the additional nodes will not be displayed until they are completely provisioned. When the DAX cluster state is available, the cluster is ready for use. If nodes are currently being removed from the DAX cluster, no endpoint information for the removed nodes is displayed.
76 */
77 describeClusters(callback?: (err: AWSError, data: DAX.Types.DescribeClustersResponse) => void): Request<DAX.Types.DescribeClustersResponse, AWSError>;
78 /**
79 * Returns the default system parameter information for the DAX caching software.
80 */
81 describeDefaultParameters(params: DAX.Types.DescribeDefaultParametersRequest, callback?: (err: AWSError, data: DAX.Types.DescribeDefaultParametersResponse) => void): Request<DAX.Types.DescribeDefaultParametersResponse, AWSError>;
82 /**
83 * Returns the default system parameter information for the DAX caching software.
84 */
85 describeDefaultParameters(callback?: (err: AWSError, data: DAX.Types.DescribeDefaultParametersResponse) => void): Request<DAX.Types.DescribeDefaultParametersResponse, AWSError>;
86 /**
87 * Returns events related to DAX clusters and parameter groups. You can obtain events specific to a particular DAX cluster or parameter group by providing the name as a parameter. By default, only the events occurring within the last hour are returned; however, you can retrieve up to 14 days' worth of events if necessary.
88 */
89 describeEvents(params: DAX.Types.DescribeEventsRequest, callback?: (err: AWSError, data: DAX.Types.DescribeEventsResponse) => void): Request<DAX.Types.DescribeEventsResponse, AWSError>;
90 /**
91 * Returns events related to DAX clusters and parameter groups. You can obtain events specific to a particular DAX cluster or parameter group by providing the name as a parameter. By default, only the events occurring within the last hour are returned; however, you can retrieve up to 14 days' worth of events if necessary.
92 */
93 describeEvents(callback?: (err: AWSError, data: DAX.Types.DescribeEventsResponse) => void): Request<DAX.Types.DescribeEventsResponse, AWSError>;
94 /**
95 * Returns a list of parameter group descriptions. If a parameter group name is specified, the list will contain only the descriptions for that group.
96 */
97 describeParameterGroups(params: DAX.Types.DescribeParameterGroupsRequest, callback?: (err: AWSError, data: DAX.Types.DescribeParameterGroupsResponse) => void): Request<DAX.Types.DescribeParameterGroupsResponse, AWSError>;
98 /**
99 * Returns a list of parameter group descriptions. If a parameter group name is specified, the list will contain only the descriptions for that group.
100 */
101 describeParameterGroups(callback?: (err: AWSError, data: DAX.Types.DescribeParameterGroupsResponse) => void): Request<DAX.Types.DescribeParameterGroupsResponse, AWSError>;
102 /**
103 * Returns the detailed parameter list for a particular parameter group.
104 */
105 describeParameters(params: DAX.Types.DescribeParametersRequest, callback?: (err: AWSError, data: DAX.Types.DescribeParametersResponse) => void): Request<DAX.Types.DescribeParametersResponse, AWSError>;
106 /**
107 * Returns the detailed parameter list for a particular parameter group.
108 */
109 describeParameters(callback?: (err: AWSError, data: DAX.Types.DescribeParametersResponse) => void): Request<DAX.Types.DescribeParametersResponse, AWSError>;
110 /**
111 * Returns a list of subnet group descriptions. If a subnet group name is specified, the list will contain only the description of that group.
112 */
113 describeSubnetGroups(params: DAX.Types.DescribeSubnetGroupsRequest, callback?: (err: AWSError, data: DAX.Types.DescribeSubnetGroupsResponse) => void): Request<DAX.Types.DescribeSubnetGroupsResponse, AWSError>;
114 /**
115 * Returns a list of subnet group descriptions. If a subnet group name is specified, the list will contain only the description of that group.
116 */
117 describeSubnetGroups(callback?: (err: AWSError, data: DAX.Types.DescribeSubnetGroupsResponse) => void): Request<DAX.Types.DescribeSubnetGroupsResponse, AWSError>;
118 /**
119 * Adds one or more nodes to a DAX cluster.
120 */
121 increaseReplicationFactor(params: DAX.Types.IncreaseReplicationFactorRequest, callback?: (err: AWSError, data: DAX.Types.IncreaseReplicationFactorResponse) => void): Request<DAX.Types.IncreaseReplicationFactorResponse, AWSError>;
122 /**
123 * Adds one or more nodes to a DAX cluster.
124 */
125 increaseReplicationFactor(callback?: (err: AWSError, data: DAX.Types.IncreaseReplicationFactorResponse) => void): Request<DAX.Types.IncreaseReplicationFactorResponse, AWSError>;
126 /**
127 * List all of the tags for a DAX cluster. You can call ListTags up to 10 times per second, per account.
128 */
129 listTags(params: DAX.Types.ListTagsRequest, callback?: (err: AWSError, data: DAX.Types.ListTagsResponse) => void): Request<DAX.Types.ListTagsResponse, AWSError>;
130 /**
131 * List all of the tags for a DAX cluster. You can call ListTags up to 10 times per second, per account.
132 */
133 listTags(callback?: (err: AWSError, data: DAX.Types.ListTagsResponse) => void): Request<DAX.Types.ListTagsResponse, AWSError>;
134 /**
135 * Reboots a single node of a DAX cluster. The reboot action takes place as soon as possible. During the reboot, the node status is set to REBOOTING.
136 */
137 rebootNode(params: DAX.Types.RebootNodeRequest, callback?: (err: AWSError, data: DAX.Types.RebootNodeResponse) => void): Request<DAX.Types.RebootNodeResponse, AWSError>;
138 /**
139 * Reboots a single node of a DAX cluster. The reboot action takes place as soon as possible. During the reboot, the node status is set to REBOOTING.
140 */
141 rebootNode(callback?: (err: AWSError, data: DAX.Types.RebootNodeResponse) => void): Request<DAX.Types.RebootNodeResponse, AWSError>;
142 /**
143 * Associates a set of tags with a DAX resource. You can call TagResource up to 5 times per second, per account.
144 */
145 tagResource(params: DAX.Types.TagResourceRequest, callback?: (err: AWSError, data: DAX.Types.TagResourceResponse) => void): Request<DAX.Types.TagResourceResponse, AWSError>;
146 /**
147 * Associates a set of tags with a DAX resource. You can call TagResource up to 5 times per second, per account.
148 */
149 tagResource(callback?: (err: AWSError, data: DAX.Types.TagResourceResponse) => void): Request<DAX.Types.TagResourceResponse, AWSError>;
150 /**
151 * Removes the association of tags from a DAX resource. You can call UntagResource up to 5 times per second, per account.
152 */
153 untagResource(params: DAX.Types.UntagResourceRequest, callback?: (err: AWSError, data: DAX.Types.UntagResourceResponse) => void): Request<DAX.Types.UntagResourceResponse, AWSError>;
154 /**
155 * Removes the association of tags from a DAX resource. You can call UntagResource up to 5 times per second, per account.
156 */
157 untagResource(callback?: (err: AWSError, data: DAX.Types.UntagResourceResponse) => void): Request<DAX.Types.UntagResourceResponse, AWSError>;
158 /**
159 * Modifies the settings for a DAX cluster. You can use this action to change one or more cluster configuration parameters by specifying the parameters and the new values.
160 */
161 updateCluster(params: DAX.Types.UpdateClusterRequest, callback?: (err: AWSError, data: DAX.Types.UpdateClusterResponse) => void): Request<DAX.Types.UpdateClusterResponse, AWSError>;
162 /**
163 * Modifies the settings for a DAX cluster. You can use this action to change one or more cluster configuration parameters by specifying the parameters and the new values.
164 */
165 updateCluster(callback?: (err: AWSError, data: DAX.Types.UpdateClusterResponse) => void): Request<DAX.Types.UpdateClusterResponse, AWSError>;
166 /**
167 * Modifies the parameters of a parameter group. You can modify up to 20 parameters in a single request by submitting a list parameter name and value pairs.
168 */
169 updateParameterGroup(params: DAX.Types.UpdateParameterGroupRequest, callback?: (err: AWSError, data: DAX.Types.UpdateParameterGroupResponse) => void): Request<DAX.Types.UpdateParameterGroupResponse, AWSError>;
170 /**
171 * Modifies the parameters of a parameter group. You can modify up to 20 parameters in a single request by submitting a list parameter name and value pairs.
172 */
173 updateParameterGroup(callback?: (err: AWSError, data: DAX.Types.UpdateParameterGroupResponse) => void): Request<DAX.Types.UpdateParameterGroupResponse, AWSError>;
174 /**
175 * Modifies an existing subnet group.
176 */
177 updateSubnetGroup(params: DAX.Types.UpdateSubnetGroupRequest, callback?: (err: AWSError, data: DAX.Types.UpdateSubnetGroupResponse) => void): Request<DAX.Types.UpdateSubnetGroupResponse, AWSError>;
178 /**
179 * Modifies an existing subnet group.
180 */
181 updateSubnetGroup(callback?: (err: AWSError, data: DAX.Types.UpdateSubnetGroupResponse) => void): Request<DAX.Types.UpdateSubnetGroupResponse, AWSError>;
182}
183declare namespace DAX {
184 export type AvailabilityZoneList = String[];
185 export type ChangeType = "IMMEDIATE"|"REQUIRES_REBOOT"|string;
186 export interface Cluster {
187 /**
188 * The name of the DAX cluster.
189 */
190 ClusterName?: String;
191 /**
192 * The description of the cluster.
193 */
194 Description?: String;
195 /**
196 * The Amazon Resource Name (ARN) that uniquely identifies the cluster.
197 */
198 ClusterArn?: String;
199 /**
200 * The total number of nodes in the cluster.
201 */
202 TotalNodes?: IntegerOptional;
203 /**
204 * The number of nodes in the cluster that are active (i.e., capable of serving requests).
205 */
206 ActiveNodes?: IntegerOptional;
207 /**
208 * The node type for the nodes in the cluster. (All nodes in a DAX cluster are of the same type.)
209 */
210 NodeType?: String;
211 /**
212 * The current status of the cluster.
213 */
214 Status?: String;
215 /**
216 * The configuration endpoint for this DAX cluster, consisting of a DNS name and a port number. Client applications can specify this endpoint, rather than an individual node endpoint, and allow the DAX client software to intelligently route requests and responses to nodes in the DAX cluster.
217 */
218 ClusterDiscoveryEndpoint?: Endpoint;
219 /**
220 * A list of nodes to be removed from the cluster.
221 */
222 NodeIdsToRemove?: NodeIdentifierList;
223 /**
224 * A list of nodes that are currently in the cluster.
225 */
226 Nodes?: NodeList;
227 /**
228 * A range of time when maintenance of DAX cluster software will be performed. For example: sun:01:00-sun:09:00. Cluster maintenance normally takes less than 30 minutes, and is performed automatically within the maintenance window.
229 */
230 PreferredMaintenanceWindow?: String;
231 /**
232 * Describes a notification topic and its status. Notification topics are used for publishing DAX events to subscribers using Amazon Simple Notification Service (SNS).
233 */
234 NotificationConfiguration?: NotificationConfiguration;
235 /**
236 * The subnet group where the DAX cluster is running.
237 */
238 SubnetGroup?: String;
239 /**
240 * A list of security groups, and the status of each, for the nodes in the cluster.
241 */
242 SecurityGroups?: SecurityGroupMembershipList;
243 /**
244 * A valid Amazon Resource Name (ARN) that identifies an IAM role. At runtime, DAX will assume this role and use the role's permissions to access DynamoDB on your behalf.
245 */
246 IamRoleArn?: String;
247 /**
248 * The parameter group being used by nodes in the cluster.
249 */
250 ParameterGroup?: ParameterGroupStatus;
251 /**
252 * The description of the server-side encryption status on the specified DAX cluster.
253 */
254 SSEDescription?: SSEDescription;
255 }
256 export type ClusterList = Cluster[];
257 export type ClusterNameList = String[];
258 export interface CreateClusterRequest {
259 /**
260 * The cluster identifier. This parameter is stored as a lowercase string. Constraints: A name must contain from 1 to 20 alphanumeric characters or hyphens. The first character must be a letter. A name cannot end with a hyphen or contain two consecutive hyphens.
261 */
262 ClusterName: String;
263 /**
264 * The compute and memory capacity of the nodes in the cluster.
265 */
266 NodeType: String;
267 /**
268 * A description of the cluster.
269 */
270 Description?: String;
271 /**
272 * The number of nodes in the DAX cluster. A replication factor of 1 will create a single-node cluster, without any read replicas. For additional fault tolerance, you can create a multiple node cluster with one or more read replicas. To do this, set ReplicationFactor to 2 or more. AWS recommends that you have at least two read replicas per cluster.
273 */
274 ReplicationFactor: Integer;
275 /**
276 * The Availability Zones (AZs) in which the cluster nodes will be created. All nodes belonging to the cluster are placed in these Availability Zones. Use this parameter if you want to distribute the nodes across multiple AZs.
277 */
278 AvailabilityZones?: AvailabilityZoneList;
279 /**
280 * The name of the subnet group to be used for the replication group. DAX clusters can only run in an Amazon VPC environment. All of the subnets that you specify in a subnet group must exist in the same VPC.
281 */
282 SubnetGroupName?: String;
283 /**
284 * A list of security group IDs to be assigned to each node in the DAX cluster. (Each of the security group ID is system-generated.) If this parameter is not specified, DAX assigns the default VPC security group to each node.
285 */
286 SecurityGroupIds?: SecurityGroupIdentifierList;
287 /**
288 * Specifies the weekly time range during which maintenance on the DAX cluster is performed. It is specified as a range in the format ddd:hh24:mi-ddd:hh24:mi (24H Clock UTC). The minimum maintenance window is a 60 minute period. Valid values for ddd are: sun mon tue wed thu fri sat Example: sun:05:00-sun:09:00 If you don't specify a preferred maintenance window when you create or modify a cache cluster, DAX assigns a 60-minute maintenance window on a randomly selected day of the week.
289 */
290 PreferredMaintenanceWindow?: String;
291 /**
292 * The Amazon Resource Name (ARN) of the Amazon SNS topic to which notifications will be sent. The Amazon SNS topic owner must be same as the DAX cluster owner.
293 */
294 NotificationTopicArn?: String;
295 /**
296 * A valid Amazon Resource Name (ARN) that identifies an IAM role. At runtime, DAX will assume this role and use the role's permissions to access DynamoDB on your behalf.
297 */
298 IamRoleArn: String;
299 /**
300 * The parameter group to be associated with the DAX cluster.
301 */
302 ParameterGroupName?: String;
303 /**
304 * A set of tags to associate with the DAX cluster.
305 */
306 Tags?: TagList;
307 /**
308 * Represents the settings used to enable server-side encryption on the cluster.
309 */
310 SSESpecification?: SSESpecification;
311 }
312 export interface CreateClusterResponse {
313 /**
314 * A description of the DAX cluster that you have created.
315 */
316 Cluster?: Cluster;
317 }
318 export interface CreateParameterGroupRequest {
319 /**
320 * The name of the parameter group to apply to all of the clusters in this replication group.
321 */
322 ParameterGroupName: String;
323 /**
324 * A description of the parameter group.
325 */
326 Description?: String;
327 }
328 export interface CreateParameterGroupResponse {
329 /**
330 * Represents the output of a CreateParameterGroup action.
331 */
332 ParameterGroup?: ParameterGroup;
333 }
334 export interface CreateSubnetGroupRequest {
335 /**
336 * A name for the subnet group. This value is stored as a lowercase string.
337 */
338 SubnetGroupName: String;
339 /**
340 * A description for the subnet group
341 */
342 Description?: String;
343 /**
344 * A list of VPC subnet IDs for the subnet group.
345 */
346 SubnetIds: SubnetIdentifierList;
347 }
348 export interface CreateSubnetGroupResponse {
349 /**
350 * Represents the output of a CreateSubnetGroup operation.
351 */
352 SubnetGroup?: SubnetGroup;
353 }
354 export interface DecreaseReplicationFactorRequest {
355 /**
356 * The name of the DAX cluster from which you want to remove nodes.
357 */
358 ClusterName: String;
359 /**
360 * The new number of nodes for the DAX cluster.
361 */
362 NewReplicationFactor: Integer;
363 /**
364 * The Availability Zone(s) from which to remove nodes.
365 */
366 AvailabilityZones?: AvailabilityZoneList;
367 /**
368 * The unique identifiers of the nodes to be removed from the cluster.
369 */
370 NodeIdsToRemove?: NodeIdentifierList;
371 }
372 export interface DecreaseReplicationFactorResponse {
373 /**
374 * A description of the DAX cluster, after you have decreased its replication factor.
375 */
376 Cluster?: Cluster;
377 }
378 export interface DeleteClusterRequest {
379 /**
380 * The name of the cluster to be deleted.
381 */
382 ClusterName: String;
383 }
384 export interface DeleteClusterResponse {
385 /**
386 * A description of the DAX cluster that is being deleted.
387 */
388 Cluster?: Cluster;
389 }
390 export interface DeleteParameterGroupRequest {
391 /**
392 * The name of the parameter group to delete.
393 */
394 ParameterGroupName: String;
395 }
396 export interface DeleteParameterGroupResponse {
397 /**
398 * A user-specified message for this action (i.e., a reason for deleting the parameter group).
399 */
400 DeletionMessage?: String;
401 }
402 export interface DeleteSubnetGroupRequest {
403 /**
404 * The name of the subnet group to delete.
405 */
406 SubnetGroupName: String;
407 }
408 export interface DeleteSubnetGroupResponse {
409 /**
410 * A user-specified message for this action (i.e., a reason for deleting the subnet group).
411 */
412 DeletionMessage?: String;
413 }
414 export interface DescribeClustersRequest {
415 /**
416 * The names of the DAX clusters being described.
417 */
418 ClusterNames?: ClusterNameList;
419 /**
420 * The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved. The value for MaxResults must be between 20 and 100.
421 */
422 MaxResults?: IntegerOptional;
423 /**
424 * An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.
425 */
426 NextToken?: String;
427 }
428 export interface DescribeClustersResponse {
429 /**
430 * Provides an identifier to allow retrieval of paginated results.
431 */
432 NextToken?: String;
433 /**
434 * The descriptions of your DAX clusters, in response to a DescribeClusters request.
435 */
436 Clusters?: ClusterList;
437 }
438 export interface DescribeDefaultParametersRequest {
439 /**
440 * The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved. The value for MaxResults must be between 20 and 100.
441 */
442 MaxResults?: IntegerOptional;
443 /**
444 * An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.
445 */
446 NextToken?: String;
447 }
448 export interface DescribeDefaultParametersResponse {
449 /**
450 * Provides an identifier to allow retrieval of paginated results.
451 */
452 NextToken?: String;
453 /**
454 * A list of parameters. Each element in the list represents one parameter.
455 */
456 Parameters?: ParameterList;
457 }
458 export interface DescribeEventsRequest {
459 /**
460 * The identifier of the event source for which events will be returned. If not specified, then all sources are included in the response.
461 */
462 SourceName?: String;
463 /**
464 * The event source to retrieve events for. If no value is specified, all events are returned.
465 */
466 SourceType?: SourceType;
467 /**
468 * The beginning of the time interval to retrieve events for, specified in ISO 8601 format.
469 */
470 StartTime?: TStamp;
471 /**
472 * The end of the time interval for which to retrieve events, specified in ISO 8601 format.
473 */
474 EndTime?: TStamp;
475 /**
476 * The number of minutes' worth of events to retrieve.
477 */
478 Duration?: IntegerOptional;
479 /**
480 * The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved. The value for MaxResults must be between 20 and 100.
481 */
482 MaxResults?: IntegerOptional;
483 /**
484 * An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.
485 */
486 NextToken?: String;
487 }
488 export interface DescribeEventsResponse {
489 /**
490 * Provides an identifier to allow retrieval of paginated results.
491 */
492 NextToken?: String;
493 /**
494 * An array of events. Each element in the array represents one event.
495 */
496 Events?: EventList;
497 }
498 export interface DescribeParameterGroupsRequest {
499 /**
500 * The names of the parameter groups.
501 */
502 ParameterGroupNames?: ParameterGroupNameList;
503 /**
504 * The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved. The value for MaxResults must be between 20 and 100.
505 */
506 MaxResults?: IntegerOptional;
507 /**
508 * An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.
509 */
510 NextToken?: String;
511 }
512 export interface DescribeParameterGroupsResponse {
513 /**
514 * Provides an identifier to allow retrieval of paginated results.
515 */
516 NextToken?: String;
517 /**
518 * An array of parameter groups. Each element in the array represents one parameter group.
519 */
520 ParameterGroups?: ParameterGroupList;
521 }
522 export interface DescribeParametersRequest {
523 /**
524 * The name of the parameter group.
525 */
526 ParameterGroupName: String;
527 /**
528 * How the parameter is defined. For example, system denotes a system-defined parameter.
529 */
530 Source?: String;
531 /**
532 * The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved. The value for MaxResults must be between 20 and 100.
533 */
534 MaxResults?: IntegerOptional;
535 /**
536 * An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.
537 */
538 NextToken?: String;
539 }
540 export interface DescribeParametersResponse {
541 /**
542 * Provides an identifier to allow retrieval of paginated results.
543 */
544 NextToken?: String;
545 /**
546 * A list of parameters within a parameter group. Each element in the list represents one parameter.
547 */
548 Parameters?: ParameterList;
549 }
550 export interface DescribeSubnetGroupsRequest {
551 /**
552 * The name of the subnet group.
553 */
554 SubnetGroupNames?: SubnetGroupNameList;
555 /**
556 * The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved. The value for MaxResults must be between 20 and 100.
557 */
558 MaxResults?: IntegerOptional;
559 /**
560 * An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.
561 */
562 NextToken?: String;
563 }
564 export interface DescribeSubnetGroupsResponse {
565 /**
566 * Provides an identifier to allow retrieval of paginated results.
567 */
568 NextToken?: String;
569 /**
570 * An array of subnet groups. Each element in the array represents a single subnet group.
571 */
572 SubnetGroups?: SubnetGroupList;
573 }
574 export interface Endpoint {
575 /**
576 * The DNS hostname of the endpoint.
577 */
578 Address?: String;
579 /**
580 * The port number that applications should use to connect to the endpoint.
581 */
582 Port?: Integer;
583 }
584 export interface Event {
585 /**
586 * The source of the event. For example, if the event occurred at the node level, the source would be the node ID.
587 */
588 SourceName?: String;
589 /**
590 * Specifies the origin of this event - a cluster, a parameter group, a node ID, etc.
591 */
592 SourceType?: SourceType;
593 /**
594 * A user-defined message associated with the event.
595 */
596 Message?: String;
597 /**
598 * The date and time when the event occurred.
599 */
600 Date?: TStamp;
601 }
602 export type EventList = Event[];
603 export interface IncreaseReplicationFactorRequest {
604 /**
605 * The name of the DAX cluster that will receive additional nodes.
606 */
607 ClusterName: String;
608 /**
609 * The new number of nodes for the DAX cluster.
610 */
611 NewReplicationFactor: Integer;
612 /**
613 * The Availability Zones (AZs) in which the cluster nodes will be created. All nodes belonging to the cluster are placed in these Availability Zones. Use this parameter if you want to distribute the nodes across multiple AZs.
614 */
615 AvailabilityZones?: AvailabilityZoneList;
616 }
617 export interface IncreaseReplicationFactorResponse {
618 /**
619 * A description of the DAX cluster. with its new replication factor.
620 */
621 Cluster?: Cluster;
622 }
623 export type Integer = number;
624 export type IntegerOptional = number;
625 export type IsModifiable = "TRUE"|"FALSE"|"CONDITIONAL"|string;
626 export type KeyList = String[];
627 export interface ListTagsRequest {
628 /**
629 * The name of the DAX resource to which the tags belong.
630 */
631 ResourceName: String;
632 /**
633 * An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token.
634 */
635 NextToken?: String;
636 }
637 export interface ListTagsResponse {
638 /**
639 * A list of tags currently associated with the DAX cluster.
640 */
641 Tags?: TagList;
642 /**
643 * If this value is present, there are additional results to be displayed. To retrieve them, call ListTags again, with NextToken set to this value.
644 */
645 NextToken?: String;
646 }
647 export interface Node {
648 /**
649 * A system-generated identifier for the node.
650 */
651 NodeId?: String;
652 /**
653 * The endpoint for the node, consisting of a DNS name and a port number. Client applications can connect directly to a node endpoint, if desired (as an alternative to allowing DAX client software to intelligently route requests and responses to nodes in the DAX cluster.
654 */
655 Endpoint?: Endpoint;
656 /**
657 * The date and time (in UNIX epoch format) when the node was launched.
658 */
659 NodeCreateTime?: TStamp;
660 /**
661 * The Availability Zone (AZ) in which the node has been deployed.
662 */
663 AvailabilityZone?: String;
664 /**
665 * The current status of the node. For example: available.
666 */
667 NodeStatus?: String;
668 /**
669 * The status of the parameter group associated with this node. For example, in-sync.
670 */
671 ParameterGroupStatus?: String;
672 }
673 export type NodeIdentifierList = String[];
674 export type NodeList = Node[];
675 export interface NodeTypeSpecificValue {
676 /**
677 * A node type to which the parameter value applies.
678 */
679 NodeType?: String;
680 /**
681 * The parameter value for this node type.
682 */
683 Value?: String;
684 }
685 export type NodeTypeSpecificValueList = NodeTypeSpecificValue[];
686 export interface NotificationConfiguration {
687 /**
688 * The Amazon Resource Name (ARN) that identifies the topic.
689 */
690 TopicArn?: String;
691 /**
692 * The current state of the topic.
693 */
694 TopicStatus?: String;
695 }
696 export interface Parameter {
697 /**
698 * The name of the parameter.
699 */
700 ParameterName?: String;
701 /**
702 * Determines whether the parameter can be applied to any nodes, or only nodes of a particular type.
703 */
704 ParameterType?: ParameterType;
705 /**
706 * The value for the parameter.
707 */
708 ParameterValue?: String;
709 /**
710 * A list of node types, and specific parameter values for each node.
711 */
712 NodeTypeSpecificValues?: NodeTypeSpecificValueList;
713 /**
714 * A description of the parameter
715 */
716 Description?: String;
717 /**
718 * How the parameter is defined. For example, system denotes a system-defined parameter.
719 */
720 Source?: String;
721 /**
722 * The data type of the parameter. For example, integer:
723 */
724 DataType?: String;
725 /**
726 * A range of values within which the parameter can be set.
727 */
728 AllowedValues?: String;
729 /**
730 * Whether the customer is allowed to modify the parameter.
731 */
732 IsModifiable?: IsModifiable;
733 /**
734 * The conditions under which changes to this parameter can be applied. For example, requires-reboot indicates that a new value for this parameter will only take effect if a node is rebooted.
735 */
736 ChangeType?: ChangeType;
737 }
738 export interface ParameterGroup {
739 /**
740 * The name of the parameter group.
741 */
742 ParameterGroupName?: String;
743 /**
744 * A description of the parameter group.
745 */
746 Description?: String;
747 }
748 export type ParameterGroupList = ParameterGroup[];
749 export type ParameterGroupNameList = String[];
750 export interface ParameterGroupStatus {
751 /**
752 * The name of the parameter group.
753 */
754 ParameterGroupName?: String;
755 /**
756 * The status of parameter updates.
757 */
758 ParameterApplyStatus?: String;
759 /**
760 * The node IDs of one or more nodes to be rebooted.
761 */
762 NodeIdsToReboot?: NodeIdentifierList;
763 }
764 export type ParameterList = Parameter[];
765 export interface ParameterNameValue {
766 /**
767 * The name of the parameter.
768 */
769 ParameterName?: String;
770 /**
771 * The value of the parameter.
772 */
773 ParameterValue?: String;
774 }
775 export type ParameterNameValueList = ParameterNameValue[];
776 export type ParameterType = "DEFAULT"|"NODE_TYPE_SPECIFIC"|string;
777 export interface RebootNodeRequest {
778 /**
779 * The name of the DAX cluster containing the node to be rebooted.
780 */
781 ClusterName: String;
782 /**
783 * The system-assigned ID of the node to be rebooted.
784 */
785 NodeId: String;
786 }
787 export interface RebootNodeResponse {
788 /**
789 * A description of the DAX cluster after a node has been rebooted.
790 */
791 Cluster?: Cluster;
792 }
793 export interface SSEDescription {
794 /**
795 * The current state of server-side encryption: ENABLING - Server-side encryption is being enabled. ENABLED - Server-side encryption is enabled. DISABLING - Server-side encryption is being disabled. DISABLED - Server-side encryption is disabled.
796 */
797 Status?: SSEStatus;
798 }
799 export type SSEEnabled = boolean;
800 export interface SSESpecification {
801 /**
802 * Indicates whether server-side encryption is enabled (true) or disabled (false) on the cluster.
803 */
804 Enabled: SSEEnabled;
805 }
806 export type SSEStatus = "ENABLING"|"ENABLED"|"DISABLING"|"DISABLED"|string;
807 export type SecurityGroupIdentifierList = String[];
808 export interface SecurityGroupMembership {
809 /**
810 * The unique ID for this security group.
811 */
812 SecurityGroupIdentifier?: String;
813 /**
814 * The status of this security group.
815 */
816 Status?: String;
817 }
818 export type SecurityGroupMembershipList = SecurityGroupMembership[];
819 export type SourceType = "CLUSTER"|"PARAMETER_GROUP"|"SUBNET_GROUP"|string;
820 export type String = string;
821 export interface Subnet {
822 /**
823 * The system-assigned identifier for the subnet.
824 */
825 SubnetIdentifier?: String;
826 /**
827 * The Availability Zone (AZ) for subnet subnet.
828 */
829 SubnetAvailabilityZone?: String;
830 }
831 export interface SubnetGroup {
832 /**
833 * The name of the subnet group.
834 */
835 SubnetGroupName?: String;
836 /**
837 * The description of the subnet group.
838 */
839 Description?: String;
840 /**
841 * The Amazon Virtual Private Cloud identifier (VPC ID) of the subnet group.
842 */
843 VpcId?: String;
844 /**
845 * A list of subnets associated with the subnet group.
846 */
847 Subnets?: SubnetList;
848 }
849 export type SubnetGroupList = SubnetGroup[];
850 export type SubnetGroupNameList = String[];
851 export type SubnetIdentifierList = String[];
852 export type SubnetList = Subnet[];
853 export type TStamp = Date;
854 export interface Tag {
855 /**
856 * The key for the tag. Tag keys are case sensitive. Every DAX cluster can only have one tag with the same key. If you try to add an existing tag (same key), the existing tag value will be updated to the new value.
857 */
858 Key?: String;
859 /**
860 * The value of the tag. Tag values are case-sensitive and can be null.
861 */
862 Value?: String;
863 }
864 export type TagList = Tag[];
865 export interface TagResourceRequest {
866 /**
867 * The name of the DAX resource to which tags should be added.
868 */
869 ResourceName: String;
870 /**
871 * The tags to be assigned to the DAX resource.
872 */
873 Tags: TagList;
874 }
875 export interface TagResourceResponse {
876 /**
877 * The list of tags that are associated with the DAX resource.
878 */
879 Tags?: TagList;
880 }
881 export interface UntagResourceRequest {
882 /**
883 * The name of the DAX resource from which the tags should be removed.
884 */
885 ResourceName: String;
886 /**
887 * A list of tag keys. If the DAX cluster has any tags with these keys, then the tags are removed from the cluster.
888 */
889 TagKeys: KeyList;
890 }
891 export interface UntagResourceResponse {
892 /**
893 * The tag keys that have been removed from the cluster.
894 */
895 Tags?: TagList;
896 }
897 export interface UpdateClusterRequest {
898 /**
899 * The name of the DAX cluster to be modified.
900 */
901 ClusterName: String;
902 /**
903 * A description of the changes being made to the cluster.
904 */
905 Description?: String;
906 /**
907 * A range of time when maintenance of DAX cluster software will be performed. For example: sun:01:00-sun:09:00. Cluster maintenance normally takes less than 30 minutes, and is performed automatically within the maintenance window.
908 */
909 PreferredMaintenanceWindow?: String;
910 /**
911 * The Amazon Resource Name (ARN) that identifies the topic.
912 */
913 NotificationTopicArn?: String;
914 /**
915 * The current state of the topic.
916 */
917 NotificationTopicStatus?: String;
918 /**
919 * The name of a parameter group for this cluster.
920 */
921 ParameterGroupName?: String;
922 /**
923 * A list of user-specified security group IDs to be assigned to each node in the DAX cluster. If this parameter is not specified, DAX assigns the default VPC security group to each node.
924 */
925 SecurityGroupIds?: SecurityGroupIdentifierList;
926 }
927 export interface UpdateClusterResponse {
928 /**
929 * A description of the DAX cluster, after it has been modified.
930 */
931 Cluster?: Cluster;
932 }
933 export interface UpdateParameterGroupRequest {
934 /**
935 * The name of the parameter group.
936 */
937 ParameterGroupName: String;
938 /**
939 * An array of name-value pairs for the parameters in the group. Each element in the array represents a single parameter.
940 */
941 ParameterNameValues: ParameterNameValueList;
942 }
943 export interface UpdateParameterGroupResponse {
944 /**
945 * The parameter group that has been modified.
946 */
947 ParameterGroup?: ParameterGroup;
948 }
949 export interface UpdateSubnetGroupRequest {
950 /**
951 * The name of the subnet group.
952 */
953 SubnetGroupName: String;
954 /**
955 * A description of the subnet group.
956 */
957 Description?: String;
958 /**
959 * A list of subnet IDs in the subnet group.
960 */
961 SubnetIds?: SubnetIdentifierList;
962 }
963 export interface UpdateSubnetGroupResponse {
964 /**
965 * The subnet group that has been modified.
966 */
967 SubnetGroup?: SubnetGroup;
968 }
969 /**
970 * A string in YYYY-MM-DD format that represents the latest possible API version that can be used in this service. Specify 'latest' to use the latest possible version.
971 */
972 export type apiVersion = "2017-04-19"|"latest"|string;
973 export interface ClientApiVersions {
974 /**
975 * A string in YYYY-MM-DD format that represents the latest possible API version that can be used in this service. Specify 'latest' to use the latest possible version.
976 */
977 apiVersion?: apiVersion;
978 }
979 export type ClientConfiguration = ServiceConfigurationOptions & ClientApiVersions;
980 /**
981 * Contains interfaces for use with the DAX client.
982 */
983 export import Types = DAX;
984}
985export = DAX;