UNPKG

45 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 Health extends Service {
9 /**
10 * Constructs a service object. This object has one method for each API operation.
11 */
12 constructor(options?: Health.Types.ClientConfiguration)
13 config: Config & Health.Types.ClientConfiguration;
14 /**
15 * Returns a list of accounts in the organization from AWS Organizations that are affected by the provided event. Before you can call this operation, you must first enable AWS Health to work with AWS Organizations. To do this, call the EnableHealthServiceAccessForOrganization operation from your organization's master account.
16 */
17 describeAffectedAccountsForOrganization(params: Health.Types.DescribeAffectedAccountsForOrganizationRequest, callback?: (err: AWSError, data: Health.Types.DescribeAffectedAccountsForOrganizationResponse) => void): Request<Health.Types.DescribeAffectedAccountsForOrganizationResponse, AWSError>;
18 /**
19 * Returns a list of accounts in the organization from AWS Organizations that are affected by the provided event. Before you can call this operation, you must first enable AWS Health to work with AWS Organizations. To do this, call the EnableHealthServiceAccessForOrganization operation from your organization's master account.
20 */
21 describeAffectedAccountsForOrganization(callback?: (err: AWSError, data: Health.Types.DescribeAffectedAccountsForOrganizationResponse) => void): Request<Health.Types.DescribeAffectedAccountsForOrganizationResponse, AWSError>;
22 /**
23 * Returns a list of entities that have been affected by the specified events, based on the specified filter criteria. Entities can refer to individual customer resources, groups of customer resources, or any other construct, depending on the AWS service. Events that have impact beyond that of the affected entities, or where the extent of impact is unknown, include at least one entity indicating this. At least one event ARN is required. Results are sorted by the lastUpdatedTime of the entity, starting with the most recent.
24 */
25 describeAffectedEntities(params: Health.Types.DescribeAffectedEntitiesRequest, callback?: (err: AWSError, data: Health.Types.DescribeAffectedEntitiesResponse) => void): Request<Health.Types.DescribeAffectedEntitiesResponse, AWSError>;
26 /**
27 * Returns a list of entities that have been affected by the specified events, based on the specified filter criteria. Entities can refer to individual customer resources, groups of customer resources, or any other construct, depending on the AWS service. Events that have impact beyond that of the affected entities, or where the extent of impact is unknown, include at least one entity indicating this. At least one event ARN is required. Results are sorted by the lastUpdatedTime of the entity, starting with the most recent.
28 */
29 describeAffectedEntities(callback?: (err: AWSError, data: Health.Types.DescribeAffectedEntitiesResponse) => void): Request<Health.Types.DescribeAffectedEntitiesResponse, AWSError>;
30 /**
31 * Returns a list of entities that have been affected by one or more events for one or more accounts in your organization in AWS Organizations, based on the filter criteria. Entities can refer to individual customer resources, groups of customer resources, or any other construct, depending on the AWS service. At least one event ARN and account ID are required. Results are sorted by the lastUpdatedTime of the entity, starting with the most recent. Before you can call this operation, you must first enable AWS Health to work with AWS Organizations. To do this, call the EnableHealthServiceAccessForOrganization operation from your organization's master account.
32 */
33 describeAffectedEntitiesForOrganization(params: Health.Types.DescribeAffectedEntitiesForOrganizationRequest, callback?: (err: AWSError, data: Health.Types.DescribeAffectedEntitiesForOrganizationResponse) => void): Request<Health.Types.DescribeAffectedEntitiesForOrganizationResponse, AWSError>;
34 /**
35 * Returns a list of entities that have been affected by one or more events for one or more accounts in your organization in AWS Organizations, based on the filter criteria. Entities can refer to individual customer resources, groups of customer resources, or any other construct, depending on the AWS service. At least one event ARN and account ID are required. Results are sorted by the lastUpdatedTime of the entity, starting with the most recent. Before you can call this operation, you must first enable AWS Health to work with AWS Organizations. To do this, call the EnableHealthServiceAccessForOrganization operation from your organization's master account.
36 */
37 describeAffectedEntitiesForOrganization(callback?: (err: AWSError, data: Health.Types.DescribeAffectedEntitiesForOrganizationResponse) => void): Request<Health.Types.DescribeAffectedEntitiesForOrganizationResponse, AWSError>;
38 /**
39 * Returns the number of entities that are affected by each of the specified events. If no events are specified, the counts of all affected entities are returned.
40 */
41 describeEntityAggregates(params: Health.Types.DescribeEntityAggregatesRequest, callback?: (err: AWSError, data: Health.Types.DescribeEntityAggregatesResponse) => void): Request<Health.Types.DescribeEntityAggregatesResponse, AWSError>;
42 /**
43 * Returns the number of entities that are affected by each of the specified events. If no events are specified, the counts of all affected entities are returned.
44 */
45 describeEntityAggregates(callback?: (err: AWSError, data: Health.Types.DescribeEntityAggregatesResponse) => void): Request<Health.Types.DescribeEntityAggregatesResponse, AWSError>;
46 /**
47 * Returns the number of events of each event type (issue, scheduled change, and account notification). If no filter is specified, the counts of all events in each category are returned.
48 */
49 describeEventAggregates(params: Health.Types.DescribeEventAggregatesRequest, callback?: (err: AWSError, data: Health.Types.DescribeEventAggregatesResponse) => void): Request<Health.Types.DescribeEventAggregatesResponse, AWSError>;
50 /**
51 * Returns the number of events of each event type (issue, scheduled change, and account notification). If no filter is specified, the counts of all events in each category are returned.
52 */
53 describeEventAggregates(callback?: (err: AWSError, data: Health.Types.DescribeEventAggregatesResponse) => void): Request<Health.Types.DescribeEventAggregatesResponse, AWSError>;
54 /**
55 * Returns detailed information about one or more specified events. Information includes standard event data (region, service, and so on, as returned by DescribeEvents), a detailed event description, and possible additional metadata that depends upon the nature of the event. Affected entities are not included; to retrieve those, use the DescribeAffectedEntities operation. If a specified event cannot be retrieved, an error message is returned for that event.
56 */
57 describeEventDetails(params: Health.Types.DescribeEventDetailsRequest, callback?: (err: AWSError, data: Health.Types.DescribeEventDetailsResponse) => void): Request<Health.Types.DescribeEventDetailsResponse, AWSError>;
58 /**
59 * Returns detailed information about one or more specified events. Information includes standard event data (region, service, and so on, as returned by DescribeEvents), a detailed event description, and possible additional metadata that depends upon the nature of the event. Affected entities are not included; to retrieve those, use the DescribeAffectedEntities operation. If a specified event cannot be retrieved, an error message is returned for that event.
60 */
61 describeEventDetails(callback?: (err: AWSError, data: Health.Types.DescribeEventDetailsResponse) => void): Request<Health.Types.DescribeEventDetailsResponse, AWSError>;
62 /**
63 * Returns detailed information about one or more specified events for one or more accounts in your organization. Information includes standard event data (Region, service, and so on, as returned by DescribeEventsForOrganization, a detailed event description, and possible additional metadata that depends upon the nature of the event. Affected entities are not included; to retrieve those, use the DescribeAffectedEntitiesForOrganization operation. Before you can call this operation, you must first enable AWS Health to work with AWS Organizations. To do this, call the EnableHealthServiceAccessForOrganization operation from your organization's master account.
64 */
65 describeEventDetailsForOrganization(params: Health.Types.DescribeEventDetailsForOrganizationRequest, callback?: (err: AWSError, data: Health.Types.DescribeEventDetailsForOrganizationResponse) => void): Request<Health.Types.DescribeEventDetailsForOrganizationResponse, AWSError>;
66 /**
67 * Returns detailed information about one or more specified events for one or more accounts in your organization. Information includes standard event data (Region, service, and so on, as returned by DescribeEventsForOrganization, a detailed event description, and possible additional metadata that depends upon the nature of the event. Affected entities are not included; to retrieve those, use the DescribeAffectedEntitiesForOrganization operation. Before you can call this operation, you must first enable AWS Health to work with AWS Organizations. To do this, call the EnableHealthServiceAccessForOrganization operation from your organization's master account.
68 */
69 describeEventDetailsForOrganization(callback?: (err: AWSError, data: Health.Types.DescribeEventDetailsForOrganizationResponse) => void): Request<Health.Types.DescribeEventDetailsForOrganizationResponse, AWSError>;
70 /**
71 * Returns the event types that meet the specified filter criteria. If no filter criteria are specified, all event types are returned, in no particular order.
72 */
73 describeEventTypes(params: Health.Types.DescribeEventTypesRequest, callback?: (err: AWSError, data: Health.Types.DescribeEventTypesResponse) => void): Request<Health.Types.DescribeEventTypesResponse, AWSError>;
74 /**
75 * Returns the event types that meet the specified filter criteria. If no filter criteria are specified, all event types are returned, in no particular order.
76 */
77 describeEventTypes(callback?: (err: AWSError, data: Health.Types.DescribeEventTypesResponse) => void): Request<Health.Types.DescribeEventTypesResponse, AWSError>;
78 /**
79 * Returns information about events that meet the specified filter criteria. Events are returned in a summary form and do not include the detailed description, any additional metadata that depends on the event type, or any affected resources. To retrieve that information, use the DescribeEventDetails and DescribeAffectedEntities operations. If no filter criteria are specified, all events are returned. Results are sorted by lastModifiedTime, starting with the most recent.
80 */
81 describeEvents(params: Health.Types.DescribeEventsRequest, callback?: (err: AWSError, data: Health.Types.DescribeEventsResponse) => void): Request<Health.Types.DescribeEventsResponse, AWSError>;
82 /**
83 * Returns information about events that meet the specified filter criteria. Events are returned in a summary form and do not include the detailed description, any additional metadata that depends on the event type, or any affected resources. To retrieve that information, use the DescribeEventDetails and DescribeAffectedEntities operations. If no filter criteria are specified, all events are returned. Results are sorted by lastModifiedTime, starting with the most recent.
84 */
85 describeEvents(callback?: (err: AWSError, data: Health.Types.DescribeEventsResponse) => void): Request<Health.Types.DescribeEventsResponse, AWSError>;
86 /**
87 * Returns information about events across your organization in AWS Organizations, meeting the specified filter criteria. Events are returned in a summary form and do not include the accounts impacted, detailed description, any additional metadata that depends on the event type, or any affected resources. To retrieve that information, use the DescribeAffectedAccountsForOrganization, DescribeEventDetailsForOrganization, and DescribeAffectedEntitiesForOrganization operations. If no filter criteria are specified, all events across your organization are returned. Results are sorted by lastModifiedTime, starting with the most recent. Before you can call this operation, you must first enable Health to work with AWS Organizations. To do this, call the EnableHealthServiceAccessForOrganization operation from your organization's master account.
88 */
89 describeEventsForOrganization(params: Health.Types.DescribeEventsForOrganizationRequest, callback?: (err: AWSError, data: Health.Types.DescribeEventsForOrganizationResponse) => void): Request<Health.Types.DescribeEventsForOrganizationResponse, AWSError>;
90 /**
91 * Returns information about events across your organization in AWS Organizations, meeting the specified filter criteria. Events are returned in a summary form and do not include the accounts impacted, detailed description, any additional metadata that depends on the event type, or any affected resources. To retrieve that information, use the DescribeAffectedAccountsForOrganization, DescribeEventDetailsForOrganization, and DescribeAffectedEntitiesForOrganization operations. If no filter criteria are specified, all events across your organization are returned. Results are sorted by lastModifiedTime, starting with the most recent. Before you can call this operation, you must first enable Health to work with AWS Organizations. To do this, call the EnableHealthServiceAccessForOrganization operation from your organization's master account.
92 */
93 describeEventsForOrganization(callback?: (err: AWSError, data: Health.Types.DescribeEventsForOrganizationResponse) => void): Request<Health.Types.DescribeEventsForOrganizationResponse, AWSError>;
94 /**
95 * This operation provides status information on enabling or disabling AWS Health to work with your organization. To call this operation, you must sign in as an IAM user, assume an IAM role, or sign in as the root user (not recommended) in the organization's master account.
96 */
97 describeHealthServiceStatusForOrganization(callback?: (err: AWSError, data: Health.Types.DescribeHealthServiceStatusForOrganizationResponse) => void): Request<Health.Types.DescribeHealthServiceStatusForOrganizationResponse, AWSError>;
98 /**
99 * Calling this operation disables Health from working with AWS Organizations. This does not remove the Service Linked Role (SLR) from the the master account in your organization. Use the IAM console, API, or AWS CLI to remove the SLR if desired. To call this operation, you must sign in as an IAM user, assume an IAM role, or sign in as the root user (not recommended) in the organization's master account.
100 */
101 disableHealthServiceAccessForOrganization(callback?: (err: AWSError, data: {}) => void): Request<{}, AWSError>;
102 /**
103 * Calling this operation enables AWS Health to work with AWS Organizations. This applies a Service Linked Role (SLR) to the master account in the organization. To learn more about the steps in this process, visit enabling service access for AWS Health in AWS Organizations. To call this operation, you must sign in as an IAM user, assume an IAM role, or sign in as the root user (not recommended) in the organization's master account.
104 */
105 enableHealthServiceAccessForOrganization(callback?: (err: AWSError, data: {}) => void): Request<{}, AWSError>;
106}
107declare namespace Health {
108 export interface AffectedEntity {
109 /**
110 * The unique identifier for the entity. Format: arn:aws:health:entity-region:aws-account:entity/entity-id . Example: arn:aws:health:us-east-1:111222333444:entity/AVh5GGT7ul1arKr1sE1K
111 */
112 entityArn?: entityArn;
113 /**
114 * The unique identifier for the event. Format: arn:aws:health:event-region::event/SERVICE/EVENT_TYPE_CODE/EVENT_TYPE_PLUS_ID . Example: Example: arn:aws:health:us-east-1::event/EC2/EC2_INSTANCE_RETIREMENT_SCHEDULED/EC2_INSTANCE_RETIREMENT_SCHEDULED_ABC123-DEF456
115 */
116 eventArn?: eventArn;
117 /**
118 * The ID of the affected entity.
119 */
120 entityValue?: entityValue;
121 /**
122 * The URL of the affected entity.
123 */
124 entityUrl?: entityUrl;
125 /**
126 * The 12-digit AWS account number that contains the affected entity.
127 */
128 awsAccountId?: accountId;
129 /**
130 * The most recent time that the entity was updated.
131 */
132 lastUpdatedTime?: timestamp;
133 /**
134 * The most recent status of the entity affected by the event. The possible values are IMPAIRED, UNIMPAIRED, and UNKNOWN.
135 */
136 statusCode?: entityStatusCode;
137 /**
138 * A map of entity tags attached to the affected entity.
139 */
140 tags?: tagSet;
141 }
142 export interface DateTimeRange {
143 /**
144 * The starting date and time of a time range.
145 */
146 from?: timestamp;
147 /**
148 * The ending date and time of a time range.
149 */
150 to?: timestamp;
151 }
152 export interface DescribeAffectedAccountsForOrganizationRequest {
153 /**
154 * The unique identifier for the event. Format: arn:aws:health:event-region::event/SERVICE/EVENT_TYPE_CODE/EVENT_TYPE_PLUS_ID . Example: Example: arn:aws:health:us-east-1::event/EC2/EC2_INSTANCE_RETIREMENT_SCHEDULED/EC2_INSTANCE_RETIREMENT_SCHEDULED_ABC123-DEF456
155 */
156 eventArn: eventArn;
157 /**
158 * If the results of a search are large, only a portion of the results are returned, and a nextToken pagination token is returned in the response. To retrieve the next batch of results, reissue the search request and include the returned token. When all results have been returned, the response does not contain a pagination token value.
159 */
160 nextToken?: nextToken;
161 /**
162 * The maximum number of items to return in one batch, between 10 and 100, inclusive.
163 */
164 maxResults?: maxResults;
165 }
166 export interface DescribeAffectedAccountsForOrganizationResponse {
167 /**
168 * A JSON set of elements of the affected accounts.
169 */
170 affectedAccounts?: affectedAccountsList;
171 /**
172 * If the results of a search are large, only a portion of the results are returned, and a nextToken pagination token is returned in the response. To retrieve the next batch of results, reissue the search request and include the returned token. When all results have been returned, the response does not contain a pagination token value.
173 */
174 nextToken?: nextToken;
175 }
176 export type DescribeAffectedEntitiesForOrganizationFailedSet = OrganizationAffectedEntitiesErrorItem[];
177 export interface DescribeAffectedEntitiesForOrganizationRequest {
178 /**
179 * A JSON set of elements including the awsAccountId and the eventArn.
180 */
181 organizationEntityFilters: OrganizationEntityFiltersList;
182 /**
183 * The locale (language) to return information in. English (en) is the default and the only supported value at this time.
184 */
185 locale?: locale;
186 /**
187 * If the results of a search are large, only a portion of the results are returned, and a nextToken pagination token is returned in the response. To retrieve the next batch of results, reissue the search request and include the returned token. When all results have been returned, the response does not contain a pagination token value.
188 */
189 nextToken?: nextToken;
190 /**
191 * The maximum number of items to return in one batch, between 10 and 100, inclusive.
192 */
193 maxResults?: maxResults;
194 }
195 export interface DescribeAffectedEntitiesForOrganizationResponse {
196 /**
197 * A JSON set of elements including the awsAccountId and its entityArn, entityValue and its entityArn, lastUpdatedTime, statusCode, and tags.
198 */
199 entities?: EntityList;
200 /**
201 * A JSON set of elements of the failed response, including the awsAccountId, errorMessage, errorName, and eventArn.
202 */
203 failedSet?: DescribeAffectedEntitiesForOrganizationFailedSet;
204 /**
205 * If the results of a search are large, only a portion of the results are returned, and a nextToken pagination token is returned in the response. To retrieve the next batch of results, reissue the search request and include the returned token. When all results have been returned, the response does not contain a pagination token value.
206 */
207 nextToken?: nextToken;
208 }
209 export interface DescribeAffectedEntitiesRequest {
210 /**
211 * Values to narrow the results returned. At least one event ARN is required.
212 */
213 filter: EntityFilter;
214 /**
215 * The locale (language) to return information in. English (en) is the default and the only supported value at this time.
216 */
217 locale?: locale;
218 /**
219 * If the results of a search are large, only a portion of the results are returned, and a nextToken pagination token is returned in the response. To retrieve the next batch of results, reissue the search request and include the returned token. When all results have been returned, the response does not contain a pagination token value.
220 */
221 nextToken?: nextToken;
222 /**
223 * The maximum number of items to return in one batch, between 10 and 100, inclusive.
224 */
225 maxResults?: maxResults;
226 }
227 export interface DescribeAffectedEntitiesResponse {
228 /**
229 * The entities that match the filter criteria.
230 */
231 entities?: EntityList;
232 /**
233 * If the results of a search are large, only a portion of the results are returned, and a nextToken pagination token is returned in the response. To retrieve the next batch of results, reissue the search request and include the returned token. When all results have been returned, the response does not contain a pagination token value.
234 */
235 nextToken?: nextToken;
236 }
237 export interface DescribeEntityAggregatesRequest {
238 /**
239 * A list of event ARNs (unique identifiers). For example: "arn:aws:health:us-east-1::event/EC2/EC2_INSTANCE_RETIREMENT_SCHEDULED/EC2_INSTANCE_RETIREMENT_SCHEDULED_ABC123-CDE456", "arn:aws:health:us-west-1::event/EBS/AWS_EBS_LOST_VOLUME/AWS_EBS_LOST_VOLUME_CHI789_JKL101"
240 */
241 eventArns?: EventArnsList;
242 }
243 export interface DescribeEntityAggregatesResponse {
244 /**
245 * The number of entities that are affected by each of the specified events.
246 */
247 entityAggregates?: EntityAggregateList;
248 }
249 export interface DescribeEventAggregatesRequest {
250 /**
251 * Values to narrow the results returned.
252 */
253 filter?: EventFilter;
254 /**
255 * The only currently supported value is eventTypeCategory.
256 */
257 aggregateField: eventAggregateField;
258 /**
259 * The maximum number of items to return in one batch, between 10 and 100, inclusive.
260 */
261 maxResults?: maxResults;
262 /**
263 * If the results of a search are large, only a portion of the results are returned, and a nextToken pagination token is returned in the response. To retrieve the next batch of results, reissue the search request and include the returned token. When all results have been returned, the response does not contain a pagination token value.
264 */
265 nextToken?: nextToken;
266 }
267 export interface DescribeEventAggregatesResponse {
268 /**
269 * The number of events in each category that meet the optional filter criteria.
270 */
271 eventAggregates?: EventAggregateList;
272 /**
273 * If the results of a search are large, only a portion of the results are returned, and a nextToken pagination token is returned in the response. To retrieve the next batch of results, reissue the search request and include the returned token. When all results have been returned, the response does not contain a pagination token value.
274 */
275 nextToken?: nextToken;
276 }
277 export type DescribeEventDetailsFailedSet = EventDetailsErrorItem[];
278 export type DescribeEventDetailsForOrganizationFailedSet = OrganizationEventDetailsErrorItem[];
279 export interface DescribeEventDetailsForOrganizationRequest {
280 /**
281 * A set of JSON elements that includes the awsAccountId and the eventArn.
282 */
283 organizationEventDetailFilters: OrganizationEventDetailFiltersList;
284 /**
285 * The locale (language) to return information in. English (en) is the default and the only supported value at this time.
286 */
287 locale?: locale;
288 }
289 export interface DescribeEventDetailsForOrganizationResponse {
290 /**
291 * Information about the events that could be retrieved.
292 */
293 successfulSet?: DescribeEventDetailsForOrganizationSuccessfulSet;
294 /**
295 * Error messages for any events that could not be retrieved.
296 */
297 failedSet?: DescribeEventDetailsForOrganizationFailedSet;
298 }
299 export type DescribeEventDetailsForOrganizationSuccessfulSet = OrganizationEventDetails[];
300 export interface DescribeEventDetailsRequest {
301 /**
302 * A list of event ARNs (unique identifiers). For example: "arn:aws:health:us-east-1::event/EC2/EC2_INSTANCE_RETIREMENT_SCHEDULED/EC2_INSTANCE_RETIREMENT_SCHEDULED_ABC123-CDE456", "arn:aws:health:us-west-1::event/EBS/AWS_EBS_LOST_VOLUME/AWS_EBS_LOST_VOLUME_CHI789_JKL101"
303 */
304 eventArns: eventArnList;
305 /**
306 * The locale (language) to return information in. English (en) is the default and the only supported value at this time.
307 */
308 locale?: locale;
309 }
310 export interface DescribeEventDetailsResponse {
311 /**
312 * Information about the events that could be retrieved.
313 */
314 successfulSet?: DescribeEventDetailsSuccessfulSet;
315 /**
316 * Error messages for any events that could not be retrieved.
317 */
318 failedSet?: DescribeEventDetailsFailedSet;
319 }
320 export type DescribeEventDetailsSuccessfulSet = EventDetails[];
321 export interface DescribeEventTypesRequest {
322 /**
323 * Values to narrow the results returned.
324 */
325 filter?: EventTypeFilter;
326 /**
327 * The locale (language) to return information in. English (en) is the default and the only supported value at this time.
328 */
329 locale?: locale;
330 /**
331 * If the results of a search are large, only a portion of the results are returned, and a nextToken pagination token is returned in the response. To retrieve the next batch of results, reissue the search request and include the returned token. When all results have been returned, the response does not contain a pagination token value.
332 */
333 nextToken?: nextToken;
334 /**
335 * The maximum number of items to return in one batch, between 10 and 100, inclusive.
336 */
337 maxResults?: maxResults;
338 }
339 export interface DescribeEventTypesResponse {
340 /**
341 * A list of event types that match the filter criteria. Event types have a category (issue, accountNotification, or scheduledChange), a service (for example, EC2, RDS, DATAPIPELINE, BILLING), and a code (in the format AWS_SERVICE_DESCRIPTION ; for example, AWS_EC2_SYSTEM_MAINTENANCE_EVENT).
342 */
343 eventTypes?: EventTypeList;
344 /**
345 * If the results of a search are large, only a portion of the results are returned, and a nextToken pagination token is returned in the response. To retrieve the next batch of results, reissue the search request and include the returned token. When all results have been returned, the response does not contain a pagination token value.
346 */
347 nextToken?: nextToken;
348 }
349 export interface DescribeEventsForOrganizationRequest {
350 /**
351 * Values to narrow the results returned.
352 */
353 filter?: OrganizationEventFilter;
354 /**
355 * If the results of a search are large, only a portion of the results are returned, and a nextToken pagination token is returned in the response. To retrieve the next batch of results, reissue the search request and include the returned token. When all results have been returned, the response does not contain a pagination token value.
356 */
357 nextToken?: nextToken;
358 /**
359 * The maximum number of items to return in one batch, between 10 and 100, inclusive.
360 */
361 maxResults?: maxResults;
362 /**
363 * The locale (language) to return information in. English (en) is the default and the only supported value at this time.
364 */
365 locale?: locale;
366 }
367 export interface DescribeEventsForOrganizationResponse {
368 /**
369 * The events that match the specified filter criteria.
370 */
371 events?: OrganizationEventList;
372 /**
373 * If the results of a search are large, only a portion of the results are returned, and a nextToken pagination token is returned in the response. To retrieve the next batch of results, reissue the search request and include the returned token. When all results have been returned, the response does not contain a pagination token value.
374 */
375 nextToken?: nextToken;
376 }
377 export interface DescribeEventsRequest {
378 /**
379 * Values to narrow the results returned.
380 */
381 filter?: EventFilter;
382 /**
383 * If the results of a search are large, only a portion of the results are returned, and a nextToken pagination token is returned in the response. To retrieve the next batch of results, reissue the search request and include the returned token. When all results have been returned, the response does not contain a pagination token value.
384 */
385 nextToken?: nextToken;
386 /**
387 * The maximum number of items to return in one batch, between 10 and 100, inclusive.
388 */
389 maxResults?: maxResults;
390 /**
391 * The locale (language) to return information in. English (en) is the default and the only supported value at this time.
392 */
393 locale?: locale;
394 }
395 export interface DescribeEventsResponse {
396 /**
397 * The events that match the specified filter criteria.
398 */
399 events?: EventList;
400 /**
401 * If the results of a search are large, only a portion of the results are returned, and a nextToken pagination token is returned in the response. To retrieve the next batch of results, reissue the search request and include the returned token. When all results have been returned, the response does not contain a pagination token value.
402 */
403 nextToken?: nextToken;
404 }
405 export interface DescribeHealthServiceStatusForOrganizationResponse {
406 /**
407 * Information about the status of enabling or disabling AWS Health Organizational View in your organization. Valid values are ENABLED | DISABLED | PENDING.
408 */
409 healthServiceAccessStatusForOrganization?: healthServiceAccessStatusForOrganization;
410 }
411 export interface EntityAggregate {
412 /**
413 * The unique identifier for the event. Format: arn:aws:health:event-region::event/SERVICE/EVENT_TYPE_CODE/EVENT_TYPE_PLUS_ID . Example: Example: arn:aws:health:us-east-1::event/EC2/EC2_INSTANCE_RETIREMENT_SCHEDULED/EC2_INSTANCE_RETIREMENT_SCHEDULED_ABC123-DEF456
414 */
415 eventArn?: eventArn;
416 /**
417 * The number entities that match the criteria for the specified events.
418 */
419 count?: count;
420 }
421 export type EntityAggregateList = EntityAggregate[];
422 export interface EntityFilter {
423 /**
424 * A list of event ARNs (unique identifiers). For example: "arn:aws:health:us-east-1::event/EC2/EC2_INSTANCE_RETIREMENT_SCHEDULED/EC2_INSTANCE_RETIREMENT_SCHEDULED_ABC123-CDE456", "arn:aws:health:us-west-1::event/EBS/AWS_EBS_LOST_VOLUME/AWS_EBS_LOST_VOLUME_CHI789_JKL101"
425 */
426 eventArns: eventArnList;
427 /**
428 * A list of entity ARNs (unique identifiers).
429 */
430 entityArns?: entityArnList;
431 /**
432 * A list of IDs for affected entities.
433 */
434 entityValues?: entityValueList;
435 /**
436 * A list of the most recent dates and times that the entity was updated.
437 */
438 lastUpdatedTimes?: dateTimeRangeList;
439 /**
440 * A map of entity tags attached to the affected entity.
441 */
442 tags?: tagFilter;
443 /**
444 * A list of entity status codes (IMPAIRED, UNIMPAIRED, or UNKNOWN).
445 */
446 statusCodes?: entityStatusCodeList;
447 }
448 export type EntityList = AffectedEntity[];
449 export interface Event {
450 /**
451 * The unique identifier for the event. Format: arn:aws:health:event-region::event/SERVICE/EVENT_TYPE_CODE/EVENT_TYPE_PLUS_ID . Example: Example: arn:aws:health:us-east-1::event/EC2/EC2_INSTANCE_RETIREMENT_SCHEDULED/EC2_INSTANCE_RETIREMENT_SCHEDULED_ABC123-DEF456
452 */
453 arn?: eventArn;
454 /**
455 * The AWS service that is affected by the event. For example, EC2, RDS.
456 */
457 service?: service;
458 /**
459 * The unique identifier for the event type. The format is AWS_SERVICE_DESCRIPTION ; for example, AWS_EC2_SYSTEM_MAINTENANCE_EVENT.
460 */
461 eventTypeCode?: eventTypeCode;
462 /**
463 * The category of the event. Possible values are issue, scheduledChange, and accountNotification.
464 */
465 eventTypeCategory?: eventTypeCategory;
466 /**
467 * The AWS region name of the event.
468 */
469 region?: region;
470 /**
471 * The AWS Availability Zone of the event. For example, us-east-1a.
472 */
473 availabilityZone?: availabilityZone;
474 /**
475 * The date and time that the event began.
476 */
477 startTime?: timestamp;
478 /**
479 * The date and time that the event ended.
480 */
481 endTime?: timestamp;
482 /**
483 * The most recent date and time that the event was updated.
484 */
485 lastUpdatedTime?: timestamp;
486 /**
487 * The most recent status of the event. Possible values are open, closed, and upcoming.
488 */
489 statusCode?: eventStatusCode;
490 }
491 export interface EventAccountFilter {
492 /**
493 * The unique identifier for the event. Format: arn:aws:health:event-region::event/SERVICE/EVENT_TYPE_CODE/EVENT_TYPE_PLUS_ID . Example: Example: arn:aws:health:us-east-1::event/EC2/EC2_INSTANCE_RETIREMENT_SCHEDULED/EC2_INSTANCE_RETIREMENT_SCHEDULED_ABC123-DEF456
494 */
495 eventArn: eventArn;
496 /**
497 * The 12-digit AWS account numbers that contains the affected entities.
498 */
499 awsAccountId: accountId;
500 }
501 export interface EventAggregate {
502 /**
503 * The issue type for the associated count.
504 */
505 aggregateValue?: aggregateValue;
506 /**
507 * The number of events of the associated issue type.
508 */
509 count?: count;
510 }
511 export type EventAggregateList = EventAggregate[];
512 export type EventArnsList = eventArn[];
513 export interface EventDescription {
514 /**
515 * The most recent description of the event.
516 */
517 latestDescription?: eventDescription;
518 }
519 export interface EventDetails {
520 /**
521 * Summary information about the event.
522 */
523 event?: Event;
524 /**
525 * The most recent description of the event.
526 */
527 eventDescription?: EventDescription;
528 /**
529 * Additional metadata about the event.
530 */
531 eventMetadata?: eventMetadata;
532 }
533 export interface EventDetailsErrorItem {
534 /**
535 * The unique identifier for the event. Format: arn:aws:health:event-region::event/SERVICE/EVENT_TYPE_CODE/EVENT_TYPE_PLUS_ID . Example: Example: arn:aws:health:us-east-1::event/EC2/EC2_INSTANCE_RETIREMENT_SCHEDULED/EC2_INSTANCE_RETIREMENT_SCHEDULED_ABC123-DEF456
536 */
537 eventArn?: eventArn;
538 /**
539 * The name of the error.
540 */
541 errorName?: string;
542 /**
543 * A message that describes the error.
544 */
545 errorMessage?: string;
546 }
547 export interface EventFilter {
548 /**
549 * A list of event ARNs (unique identifiers). For example: "arn:aws:health:us-east-1::event/EC2/EC2_INSTANCE_RETIREMENT_SCHEDULED/EC2_INSTANCE_RETIREMENT_SCHEDULED_ABC123-CDE456", "arn:aws:health:us-west-1::event/EBS/AWS_EBS_LOST_VOLUME/AWS_EBS_LOST_VOLUME_CHI789_JKL101"
550 */
551 eventArns?: eventArnList;
552 /**
553 * A list of unique identifiers for event types. For example, "AWS_EC2_SYSTEM_MAINTENANCE_EVENT","AWS_RDS_MAINTENANCE_SCHEDULED".
554 */
555 eventTypeCodes?: eventTypeList;
556 /**
557 * The AWS services associated with the event. For example, EC2, RDS.
558 */
559 services?: serviceList;
560 /**
561 * A list of AWS regions.
562 */
563 regions?: regionList;
564 /**
565 * A list of AWS availability zones.
566 */
567 availabilityZones?: availabilityZones;
568 /**
569 * A list of dates and times that the event began.
570 */
571 startTimes?: dateTimeRangeList;
572 /**
573 * A list of dates and times that the event ended.
574 */
575 endTimes?: dateTimeRangeList;
576 /**
577 * A list of dates and times that the event was last updated.
578 */
579 lastUpdatedTimes?: dateTimeRangeList;
580 /**
581 * A list of entity ARNs (unique identifiers).
582 */
583 entityArns?: entityArnList;
584 /**
585 * A list of entity identifiers, such as EC2 instance IDs (i-34ab692e) or EBS volumes (vol-426ab23e).
586 */
587 entityValues?: entityValueList;
588 /**
589 * A list of event type category codes (issue, scheduledChange, or accountNotification).
590 */
591 eventTypeCategories?: eventTypeCategoryList;
592 /**
593 * A map of entity tags attached to the affected entity.
594 */
595 tags?: tagFilter;
596 /**
597 * A list of event status codes.
598 */
599 eventStatusCodes?: eventStatusCodeList;
600 }
601 export type EventList = Event[];
602 export interface EventType {
603 /**
604 * The AWS service that is affected by the event. For example, EC2, RDS.
605 */
606 service?: service;
607 /**
608 * The unique identifier for the event type. The format is AWS_SERVICE_DESCRIPTION ; for example, AWS_EC2_SYSTEM_MAINTENANCE_EVENT.
609 */
610 code?: eventTypeCode;
611 /**
612 * A list of event type category codes (issue, scheduledChange, or accountNotification).
613 */
614 category?: eventTypeCategory;
615 }
616 export type EventTypeCategoryList = eventTypeCategory[];
617 export type EventTypeCodeList = eventTypeCode[];
618 export interface EventTypeFilter {
619 /**
620 * A list of event type codes.
621 */
622 eventTypeCodes?: EventTypeCodeList;
623 /**
624 * The AWS services associated with the event. For example, EC2, RDS.
625 */
626 services?: serviceList;
627 /**
628 * A list of event type category codes (issue, scheduledChange, or accountNotification).
629 */
630 eventTypeCategories?: EventTypeCategoryList;
631 }
632 export type EventTypeList = EventType[];
633 export interface OrganizationAffectedEntitiesErrorItem {
634 /**
635 * The 12-digit AWS account numbers that contains the affected entities.
636 */
637 awsAccountId?: accountId;
638 /**
639 * The unique identifier for the event. Format: arn:aws:health:event-region::event/SERVICE/EVENT_TYPE_CODE/EVENT_TYPE_PLUS_ID . Example: Example: arn:aws:health:us-east-1::event/EC2/EC2_INSTANCE_RETIREMENT_SCHEDULED/EC2_INSTANCE_RETIREMENT_SCHEDULED_ABC123-DEF456
640 */
641 eventArn?: eventArn;
642 /**
643 * The name of the error.
644 */
645 errorName?: string;
646 /**
647 * The unique identifier for the event type. The format is AWS_SERVICE_DESCRIPTION. For example, AWS_EC2_SYSTEM_MAINTENANCE_EVENT.
648 */
649 errorMessage?: string;
650 }
651 export type OrganizationEntityFiltersList = EventAccountFilter[];
652 export interface OrganizationEvent {
653 /**
654 * The unique identifier for the event. Format: arn:aws:health:event-region::event/SERVICE/EVENT_TYPE_CODE/EVENT_TYPE_PLUS_ID . Example: Example: arn:aws:health:us-east-1::event/EC2/EC2_INSTANCE_RETIREMENT_SCHEDULED/EC2_INSTANCE_RETIREMENT_SCHEDULED_ABC123-DEF456
655 */
656 arn?: eventArn;
657 /**
658 * The AWS service that is affected by the event. For example, EC2, RDS.
659 */
660 service?: service;
661 /**
662 * The unique identifier for the event type. The format is AWS_SERVICE_DESCRIPTION. For example, AWS_EC2_SYSTEM_MAINTENANCE_EVENT.
663 */
664 eventTypeCode?: eventTypeCode;
665 /**
666 * The category of the event type.
667 */
668 eventTypeCategory?: eventTypeCategory;
669 /**
670 * The AWS Region name of the event.
671 */
672 region?: region;
673 /**
674 * The date and time that the event began.
675 */
676 startTime?: timestamp;
677 /**
678 * The date and time that the event ended.
679 */
680 endTime?: timestamp;
681 /**
682 * The most recent date and time that the event was updated.
683 */
684 lastUpdatedTime?: timestamp;
685 /**
686 * The most recent status of the event. Possible values are open, closed, and upcoming.
687 */
688 statusCode?: eventStatusCode;
689 }
690 export type OrganizationEventDetailFiltersList = EventAccountFilter[];
691 export interface OrganizationEventDetails {
692 /**
693 * The 12-digit AWS account numbers that contains the affected entities.
694 */
695 awsAccountId?: accountId;
696 event?: Event;
697 eventDescription?: EventDescription;
698 /**
699 * Additional metadata about the event.
700 */
701 eventMetadata?: eventMetadata;
702 }
703 export interface OrganizationEventDetailsErrorItem {
704 /**
705 * Error information returned when a DescribeEventDetailsForOrganization operation cannot find a specified event.
706 */
707 awsAccountId?: accountId;
708 /**
709 * The unique identifier for the event. Format: arn:aws:health:event-region::event/SERVICE/EVENT_TYPE_CODE/EVENT_TYPE_PLUS_ID . Example: Example: arn:aws:health:us-east-1::event/EC2/EC2_INSTANCE_RETIREMENT_SCHEDULED/EC2_INSTANCE_RETIREMENT_SCHEDULED_ABC123-DEF456
710 */
711 eventArn?: eventArn;
712 /**
713 * The name of the error.
714 */
715 errorName?: string;
716 /**
717 * A message that describes the error.
718 */
719 errorMessage?: string;
720 }
721 export interface OrganizationEventFilter {
722 /**
723 * A list of unique identifiers for event types. For example, "AWS_EC2_SYSTEM_MAINTENANCE_EVENT","AWS_RDS_MAINTENANCE_SCHEDULED".
724 */
725 eventTypeCodes?: eventTypeList;
726 /**
727 * A list of 12-digit AWS account numbers that contains the affected entities.
728 */
729 awsAccountIds?: awsAccountIdsList;
730 /**
731 * The AWS services associated with the event. For example, EC2, RDS.
732 */
733 services?: serviceList;
734 /**
735 * A list of AWS Regions.
736 */
737 regions?: regionList;
738 startTime?: DateTimeRange;
739 endTime?: DateTimeRange;
740 lastUpdatedTime?: DateTimeRange;
741 /**
742 * REPLACEME
743 */
744 entityArns?: entityArnList;
745 /**
746 * A list of entity identifiers, such as EC2 instance IDs (i-34ab692e) or EBS volumes (vol-426ab23e).
747 */
748 entityValues?: entityValueList;
749 /**
750 * REPLACEME
751 */
752 eventTypeCategories?: eventTypeCategoryList;
753 /**
754 * A list of event status codes.
755 */
756 eventStatusCodes?: eventStatusCodeList;
757 }
758 export type OrganizationEventList = OrganizationEvent[];
759 export type accountId = string;
760 export type affectedAccountsList = accountId[];
761 export type aggregateValue = string;
762 export type availabilityZone = string;
763 export type availabilityZones = availabilityZone[];
764 export type awsAccountIdsList = accountId[];
765 export type count = number;
766 export type dateTimeRangeList = DateTimeRange[];
767 export type entityArn = string;
768 export type entityArnList = entityArn[];
769 export type entityStatusCode = "IMPAIRED"|"UNIMPAIRED"|"UNKNOWN"|string;
770 export type entityStatusCodeList = entityStatusCode[];
771 export type entityUrl = string;
772 export type entityValue = string;
773 export type entityValueList = entityValue[];
774 export type eventAggregateField = "eventTypeCategory"|string;
775 export type eventArn = string;
776 export type eventArnList = eventArn[];
777 export type eventDescription = string;
778 export type eventMetadata = {[key: string]: metadataValue};
779 export type eventStatusCode = "open"|"closed"|"upcoming"|string;
780 export type eventStatusCodeList = eventStatusCode[];
781 export type eventType = string;
782 export type eventTypeCategory = "issue"|"accountNotification"|"scheduledChange"|"investigation"|string;
783 export type eventTypeCategoryList = eventTypeCategory[];
784 export type eventTypeCode = string;
785 export type eventTypeList = eventType[];
786 export type healthServiceAccessStatusForOrganization = string;
787 export type locale = string;
788 export type maxResults = number;
789 export type metadataKey = string;
790 export type metadataValue = string;
791 export type nextToken = string;
792 export type region = string;
793 export type regionList = region[];
794 export type service = string;
795 export type serviceList = service[];
796 export type tagFilter = tagSet[];
797 export type tagKey = string;
798 export type tagSet = {[key: string]: tagValue};
799 export type tagValue = string;
800 export type timestamp = Date;
801 /**
802 * 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.
803 */
804 export type apiVersion = "2016-08-04"|"latest"|string;
805 export interface ClientApiVersions {
806 /**
807 * 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.
808 */
809 apiVersion?: apiVersion;
810 }
811 export type ClientConfiguration = ServiceConfigurationOptions & ClientApiVersions;
812 /**
813 * Contains interfaces for use with the Health client.
814 */
815 export import Types = Health;
816}
817export = Health;
818
\No newline at end of file