aws-sdk-cloudcontrolapi 1.0.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -0,0 +1,1197 @@
1
+ # frozen_string_literal: true
2
+
3
+ # WARNING ABOUT GENERATED CODE
4
+ #
5
+ # This file is generated. See the contributing guide for more information:
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
+ #
8
+ # WARNING ABOUT GENERATED CODE
9
+
10
+ module Aws::CloudControlApi
11
+ module Types
12
+
13
+ # The resource with the name requested already exists.
14
+ #
15
+ # @!attribute [rw] message
16
+ # @return [String]
17
+ #
18
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/AlreadyExistsException AWS API Documentation
19
+ #
20
+ class AlreadyExistsException < Struct.new(
21
+ :message)
22
+ SENSITIVE = []
23
+ include Aws::Structure
24
+ end
25
+
26
+ # @note When making an API call, you may pass CancelResourceRequestInput
27
+ # data as a hash:
28
+ #
29
+ # {
30
+ # request_token: "RequestToken", # required
31
+ # }
32
+ #
33
+ # @!attribute [rw] request_token
34
+ # The `RequestToken` of the `ProgressEvent` object returned by the
35
+ # resource operation request.
36
+ # @return [String]
37
+ #
38
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/CancelResourceRequestInput AWS API Documentation
39
+ #
40
+ class CancelResourceRequestInput < Struct.new(
41
+ :request_token)
42
+ SENSITIVE = []
43
+ include Aws::Structure
44
+ end
45
+
46
+ # @!attribute [rw] progress_event
47
+ # Represents the current status of a resource operation request. For
48
+ # more information, see [Managing resource operation requests][1] in
49
+ # the *Amazon Web Services Cloud Control API User Guide*.
50
+ #
51
+ #
52
+ #
53
+ # [1]: https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-manage-requests.html
54
+ # @return [Types::ProgressEvent]
55
+ #
56
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/CancelResourceRequestOutput AWS API Documentation
57
+ #
58
+ class CancelResourceRequestOutput < Struct.new(
59
+ :progress_event)
60
+ SENSITIVE = []
61
+ include Aws::Structure
62
+ end
63
+
64
+ # The specified client token has already been used in another resource
65
+ # request.
66
+ #
67
+ # It is best practice for client tokens to be unique for each resource
68
+ # operation request. However, client token expire after 36 hours.
69
+ #
70
+ # @!attribute [rw] message
71
+ # @return [String]
72
+ #
73
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/ClientTokenConflictException AWS API Documentation
74
+ #
75
+ class ClientTokenConflictException < Struct.new(
76
+ :message)
77
+ SENSITIVE = []
78
+ include Aws::Structure
79
+ end
80
+
81
+ # The resource is currently being modified by another operation.
82
+ #
83
+ # @!attribute [rw] message
84
+ # @return [String]
85
+ #
86
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/ConcurrentModificationException AWS API Documentation
87
+ #
88
+ class ConcurrentModificationException < Struct.new(
89
+ :message)
90
+ SENSITIVE = []
91
+ include Aws::Structure
92
+ end
93
+
94
+ # Another resource operation is currently being performed on this
95
+ # resource.
96
+ #
97
+ # @!attribute [rw] message
98
+ # @return [String]
99
+ #
100
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/ConcurrentOperationException AWS API Documentation
101
+ #
102
+ class ConcurrentOperationException < Struct.new(
103
+ :message)
104
+ SENSITIVE = []
105
+ include Aws::Structure
106
+ end
107
+
108
+ # @note When making an API call, you may pass CreateResourceInput
109
+ # data as a hash:
110
+ #
111
+ # {
112
+ # type_name: "TypeName", # required
113
+ # type_version_id: "TypeVersionId",
114
+ # role_arn: "RoleArn",
115
+ # client_token: "ClientToken",
116
+ # desired_state: "Properties", # required
117
+ # }
118
+ #
119
+ # @!attribute [rw] type_name
120
+ # The name of the resource type.
121
+ # @return [String]
122
+ #
123
+ # @!attribute [rw] type_version_id
124
+ # For private resource types, the type version to use in this resource
125
+ # operation. If you do not specify a resource version, CloudFormation
126
+ # uses the default version.
127
+ # @return [String]
128
+ #
129
+ # @!attribute [rw] role_arn
130
+ # The Amazon Resource Name (ARN) of the Identity and Access Management
131
+ # (IAM) for Cloud Control API to use when performing this resource
132
+ # operation. The role specified must have the permissions required for
133
+ # this operation. The necessary permissions for each event handler are
134
+ # defined in the ` handlers ` section of the [resource type definition
135
+ # schema][1].
136
+ #
137
+ # If you do not specify a role, Cloud Control API uses a temporary
138
+ # session created using your Amazon Web Services user credentials.
139
+ #
140
+ # For more information, see [Specifying credentials][2] in the *Amazon
141
+ # Web Services Cloud Control API User Guide*.
142
+ #
143
+ #
144
+ #
145
+ # [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html
146
+ # [2]: https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-permissions
147
+ # @return [String]
148
+ #
149
+ # @!attribute [rw] client_token
150
+ # A unique identifier to ensure the idempotency of the resource
151
+ # request. As a best practice, specify this token to ensure
152
+ # idempotency, so that Amazon Web Services Cloud Control API can
153
+ # accurately distinguish between request retries and new resource
154
+ # requests. You might retry a resource request to ensure that it was
155
+ # successfully received.
156
+ #
157
+ # A client token is valid for 36 hours once used. After that, a
158
+ # resource request with the same client token is treated as a new
159
+ # request.
160
+ #
161
+ # If you do not specify a client token, one is generated for inclusion
162
+ # in the request.
163
+ #
164
+ # For more information, see [Ensuring resource operation requests are
165
+ # unique][1] in the *Amazon Web Services Cloud Control API User
166
+ # Guide*.
167
+ #
168
+ # **A suitable default value is auto-generated.** You should normally
169
+ # not need to pass this option.
170
+ #
171
+ #
172
+ #
173
+ # [1]: https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-idempotency
174
+ # @return [String]
175
+ #
176
+ # @!attribute [rw] desired_state
177
+ # Structured data format representing the desired state of the
178
+ # resource, consisting of that resource's properties and their
179
+ # desired values.
180
+ #
181
+ # <note markdown="1"> Cloud Control API currently supports JSON as a structured data
182
+ # format.
183
+ #
184
+ # </note>
185
+ #
186
+ # Specify the desired state as one of the following:
187
+ #
188
+ # * A JSON blob
189
+ #
190
+ # * A local path containing the desired state in JSON data format
191
+ #
192
+ # For more information, see [Composing the desired state of the
193
+ # resource][1] in the *Amazon Web Services Cloud Control API User
194
+ # Guide*.
195
+ #
196
+ # For more information about the properties of a specific resource,
197
+ # refer to the related topic for the resource in the [Resource and
198
+ # property types reference][2] in the *Amazon Web Services
199
+ # CloudFormation Users Guide*.
200
+ #
201
+ #
202
+ #
203
+ # [1]: https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-create.html#resource-operations-create-desiredstate
204
+ # [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html
205
+ # @return [String]
206
+ #
207
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/CreateResourceInput AWS API Documentation
208
+ #
209
+ class CreateResourceInput < Struct.new(
210
+ :type_name,
211
+ :type_version_id,
212
+ :role_arn,
213
+ :client_token,
214
+ :desired_state)
215
+ SENSITIVE = [:desired_state]
216
+ include Aws::Structure
217
+ end
218
+
219
+ # @!attribute [rw] progress_event
220
+ # Represents the current status of the resource creation request.
221
+ #
222
+ # After you have initiated a resource creation request, you can
223
+ # monitor the progress of your request by calling
224
+ # [GetResourceRequestStatus][1] using the `RequestToken` of the
225
+ # `ProgressEvent` returned by `CreateResource`.
226
+ #
227
+ #
228
+ #
229
+ # [1]: https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_GetResourceRequestStatus.html
230
+ # @return [Types::ProgressEvent]
231
+ #
232
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/CreateResourceOutput AWS API Documentation
233
+ #
234
+ class CreateResourceOutput < Struct.new(
235
+ :progress_event)
236
+ SENSITIVE = []
237
+ include Aws::Structure
238
+ end
239
+
240
+ # @note When making an API call, you may pass DeleteResourceInput
241
+ # data as a hash:
242
+ #
243
+ # {
244
+ # type_name: "TypeName", # required
245
+ # type_version_id: "TypeVersionId",
246
+ # role_arn: "RoleArn",
247
+ # client_token: "ClientToken",
248
+ # identifier: "Identifier", # required
249
+ # }
250
+ #
251
+ # @!attribute [rw] type_name
252
+ # The name of the resource type.
253
+ # @return [String]
254
+ #
255
+ # @!attribute [rw] type_version_id
256
+ # For private resource types, the type version to use in this resource
257
+ # operation. If you do not specify a resource version, CloudFormation
258
+ # uses the default version.
259
+ # @return [String]
260
+ #
261
+ # @!attribute [rw] role_arn
262
+ # The Amazon Resource Name (ARN) of the Identity and Access Management
263
+ # (IAM) for Cloud Control API to use when performing this resource
264
+ # operation. The role specified must have the permissions required for
265
+ # this operation. The necessary permissions for each event handler are
266
+ # defined in the ` handlers ` section of the [resource type definition
267
+ # schema][1].
268
+ #
269
+ # If you do not specify a role, Cloud Control API uses a temporary
270
+ # session created using your Amazon Web Services user credentials.
271
+ #
272
+ # For more information, see [Specifying credentials][2] in the *Amazon
273
+ # Web Services Cloud Control API User Guide*.
274
+ #
275
+ #
276
+ #
277
+ # [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html
278
+ # [2]: https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-permissions
279
+ # @return [String]
280
+ #
281
+ # @!attribute [rw] client_token
282
+ # A unique identifier to ensure the idempotency of the resource
283
+ # request. As a best practice, specify this token to ensure
284
+ # idempotency, so that Amazon Web Services Cloud Control API can
285
+ # accurately distinguish between request retries and new resource
286
+ # requests. You might retry a resource request to ensure that it was
287
+ # successfully received.
288
+ #
289
+ # A client token is valid for 36 hours once used. After that, a
290
+ # resource request with the same client token is treated as a new
291
+ # request.
292
+ #
293
+ # If you do not specify a client token, one is generated for inclusion
294
+ # in the request.
295
+ #
296
+ # For more information, see [Ensuring resource operation requests are
297
+ # unique][1] in the *Amazon Web Services Cloud Control API User
298
+ # Guide*.
299
+ #
300
+ # **A suitable default value is auto-generated.** You should normally
301
+ # not need to pass this option.
302
+ #
303
+ #
304
+ #
305
+ # [1]: https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-idempotency
306
+ # @return [String]
307
+ #
308
+ # @!attribute [rw] identifier
309
+ # The identifier for the resource.
310
+ #
311
+ # You can specify the primary identifier, or any secondary identifier
312
+ # defined for the resource type in its resource schema. You can only
313
+ # specify one identifier. Primary identifiers can be specified as a
314
+ # string or JSON; secondary identifiers must be specified as JSON.
315
+ #
316
+ # For compound primary identifiers (that is, one that consists of
317
+ # multiple resource properties strung together), to specify the
318
+ # primary identifier as a string, list the property values *in the
319
+ # order they are specified* in the primary identifier definition,
320
+ # separated by `|`.
321
+ #
322
+ # For more information, see [Identifying resources][1] in the *Amazon
323
+ # Web Services Cloud Control API User Guide*.
324
+ #
325
+ #
326
+ #
327
+ # [1]: https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-identifier.html
328
+ # @return [String]
329
+ #
330
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/DeleteResourceInput AWS API Documentation
331
+ #
332
+ class DeleteResourceInput < Struct.new(
333
+ :type_name,
334
+ :type_version_id,
335
+ :role_arn,
336
+ :client_token,
337
+ :identifier)
338
+ SENSITIVE = []
339
+ include Aws::Structure
340
+ end
341
+
342
+ # @!attribute [rw] progress_event
343
+ # Represents the current status of the resource deletion request.
344
+ #
345
+ # After you have initiated a resource deletion request, you can
346
+ # monitor the progress of your request by calling
347
+ # [GetResourceRequestStatus][1] using the `RequestToken` of the
348
+ # `ProgressEvent` returned by `DeleteResource`.
349
+ #
350
+ #
351
+ #
352
+ # [1]: https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_GetResourceRequestStatus.html
353
+ # @return [Types::ProgressEvent]
354
+ #
355
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/DeleteResourceOutput AWS API Documentation
356
+ #
357
+ class DeleteResourceOutput < Struct.new(
358
+ :progress_event)
359
+ SENSITIVE = []
360
+ include Aws::Structure
361
+ end
362
+
363
+ # The resource handler has returned that the downstream service
364
+ # generated an error that does not map to any other handler error code.
365
+ #
366
+ # @!attribute [rw] message
367
+ # @return [String]
368
+ #
369
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/GeneralServiceException AWS API Documentation
370
+ #
371
+ class GeneralServiceException < Struct.new(
372
+ :message)
373
+ SENSITIVE = []
374
+ include Aws::Structure
375
+ end
376
+
377
+ # @note When making an API call, you may pass GetResourceInput
378
+ # data as a hash:
379
+ #
380
+ # {
381
+ # type_name: "TypeName", # required
382
+ # type_version_id: "TypeVersionId",
383
+ # role_arn: "RoleArn",
384
+ # identifier: "Identifier", # required
385
+ # }
386
+ #
387
+ # @!attribute [rw] type_name
388
+ # The name of the resource type.
389
+ # @return [String]
390
+ #
391
+ # @!attribute [rw] type_version_id
392
+ # For private resource types, the type version to use in this resource
393
+ # operation. If you do not specify a resource version, CloudFormation
394
+ # uses the default version.
395
+ # @return [String]
396
+ #
397
+ # @!attribute [rw] role_arn
398
+ # The Amazon Resource Name (ARN) of the Identity and Access Management
399
+ # (IAM) for Cloud Control API to use when performing this resource
400
+ # operation. The role specified must have the permissions required for
401
+ # this operation. The necessary permissions for each event handler are
402
+ # defined in the ` handlers ` section of the [resource type definition
403
+ # schema][1].
404
+ #
405
+ # If you do not specify a role, Cloud Control API uses a temporary
406
+ # session created using your Amazon Web Services user credentials.
407
+ #
408
+ # For more information, see [Specifying credentials][2] in the *Amazon
409
+ # Web Services Cloud Control API User Guide*.
410
+ #
411
+ #
412
+ #
413
+ # [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html
414
+ # [2]: https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-permissions
415
+ # @return [String]
416
+ #
417
+ # @!attribute [rw] identifier
418
+ # The identifier for the resource.
419
+ #
420
+ # You can specify the primary identifier, or any secondary identifier
421
+ # defined for the resource type in its resource schema. You can only
422
+ # specify one identifier. Primary identifiers can be specified as a
423
+ # string or JSON; secondary identifiers must be specified as JSON.
424
+ #
425
+ # For compound primary identifiers (that is, one that consists of
426
+ # multiple resource properties strung together), to specify the
427
+ # primary identifier as a string, list the property values *in the
428
+ # order they are specified* in the primary identifier definition,
429
+ # separated by `|`.
430
+ #
431
+ # For more information, see [Identifying resources][1] in the *Amazon
432
+ # Web Services Cloud Control API User Guide*.
433
+ #
434
+ #
435
+ #
436
+ # [1]: https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-identifier.html
437
+ # @return [String]
438
+ #
439
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/GetResourceInput AWS API Documentation
440
+ #
441
+ class GetResourceInput < Struct.new(
442
+ :type_name,
443
+ :type_version_id,
444
+ :role_arn,
445
+ :identifier)
446
+ SENSITIVE = []
447
+ include Aws::Structure
448
+ end
449
+
450
+ # @!attribute [rw] type_name
451
+ # The name of the resource type.
452
+ # @return [String]
453
+ #
454
+ # @!attribute [rw] resource_description
455
+ # Represents information about a provisioned resource.
456
+ # @return [Types::ResourceDescription]
457
+ #
458
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/GetResourceOutput AWS API Documentation
459
+ #
460
+ class GetResourceOutput < Struct.new(
461
+ :type_name,
462
+ :resource_description)
463
+ SENSITIVE = []
464
+ include Aws::Structure
465
+ end
466
+
467
+ # @note When making an API call, you may pass GetResourceRequestStatusInput
468
+ # data as a hash:
469
+ #
470
+ # {
471
+ # request_token: "RequestToken", # required
472
+ # }
473
+ #
474
+ # @!attribute [rw] request_token
475
+ # A unique token used to track the progress of the resource operation
476
+ # request.
477
+ #
478
+ # Request tokens are included in the `ProgressEvent` type returned by
479
+ # a resource operation request.
480
+ # @return [String]
481
+ #
482
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/GetResourceRequestStatusInput AWS API Documentation
483
+ #
484
+ class GetResourceRequestStatusInput < Struct.new(
485
+ :request_token)
486
+ SENSITIVE = []
487
+ include Aws::Structure
488
+ end
489
+
490
+ # @!attribute [rw] progress_event
491
+ # Represents the current status of the resource operation request.
492
+ # @return [Types::ProgressEvent]
493
+ #
494
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/GetResourceRequestStatusOutput AWS API Documentation
495
+ #
496
+ class GetResourceRequestStatusOutput < Struct.new(
497
+ :progress_event)
498
+ SENSITIVE = []
499
+ include Aws::Structure
500
+ end
501
+
502
+ # The resource handler has failed without a returning a more specific
503
+ # error code. This can include timeouts.
504
+ #
505
+ # @!attribute [rw] message
506
+ # @return [String]
507
+ #
508
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/HandlerFailureException AWS API Documentation
509
+ #
510
+ class HandlerFailureException < Struct.new(
511
+ :message)
512
+ SENSITIVE = []
513
+ include Aws::Structure
514
+ end
515
+
516
+ # The resource handler has returned that an unexpected error occurred
517
+ # within the resource handler.
518
+ #
519
+ # @!attribute [rw] message
520
+ # @return [String]
521
+ #
522
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/HandlerInternalFailureException AWS API Documentation
523
+ #
524
+ class HandlerInternalFailureException < Struct.new(
525
+ :message)
526
+ SENSITIVE = []
527
+ include Aws::Structure
528
+ end
529
+
530
+ # The resource handler has returned that the credentials provided by the
531
+ # user are invalid.
532
+ #
533
+ # @!attribute [rw] message
534
+ # @return [String]
535
+ #
536
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/InvalidCredentialsException AWS API Documentation
537
+ #
538
+ class InvalidCredentialsException < Struct.new(
539
+ :message)
540
+ SENSITIVE = []
541
+ include Aws::Structure
542
+ end
543
+
544
+ # The resource handler has returned that invalid input from the user has
545
+ # generated a generic exception.
546
+ #
547
+ # @!attribute [rw] message
548
+ # @return [String]
549
+ #
550
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/InvalidRequestException AWS API Documentation
551
+ #
552
+ class InvalidRequestException < Struct.new(
553
+ :message)
554
+ SENSITIVE = []
555
+ include Aws::Structure
556
+ end
557
+
558
+ # @note When making an API call, you may pass ListResourceRequestsInput
559
+ # data as a hash:
560
+ #
561
+ # {
562
+ # max_results: 1,
563
+ # next_token: "NextToken",
564
+ # resource_request_status_filter: {
565
+ # operations: ["CREATE"], # accepts CREATE, DELETE, UPDATE
566
+ # operation_statuses: ["PENDING"], # accepts PENDING, IN_PROGRESS, SUCCESS, FAILED, CANCEL_IN_PROGRESS, CANCEL_COMPLETE
567
+ # },
568
+ # }
569
+ #
570
+ # @!attribute [rw] max_results
571
+ # The maximum number of results to be returned with a single call. If
572
+ # the number of available results exceeds this maximum, the response
573
+ # includes a `NextToken` value that you can assign to the `NextToken`
574
+ # request parameter to get the next set of results.
575
+ #
576
+ # The default is `20`.
577
+ # @return [Integer]
578
+ #
579
+ # @!attribute [rw] next_token
580
+ # If the previous paginated request didn't return all of the
581
+ # remaining results, the response object's `NextToken` parameter
582
+ # value is set to a token. To retrieve the next set of results, call
583
+ # this action again and assign that token to the request object's
584
+ # `NextToken` parameter. If there are no remaining results, the
585
+ # previous response object's `NextToken` parameter is set to `null`.
586
+ # @return [String]
587
+ #
588
+ # @!attribute [rw] resource_request_status_filter
589
+ # The filter criteria to apply to the requests returned.
590
+ # @return [Types::ResourceRequestStatusFilter]
591
+ #
592
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/ListResourceRequestsInput AWS API Documentation
593
+ #
594
+ class ListResourceRequestsInput < Struct.new(
595
+ :max_results,
596
+ :next_token,
597
+ :resource_request_status_filter)
598
+ SENSITIVE = []
599
+ include Aws::Structure
600
+ end
601
+
602
+ # @!attribute [rw] resource_request_status_summaries
603
+ # The requests that match the specified filter criteria.
604
+ # @return [Array<Types::ProgressEvent>]
605
+ #
606
+ # @!attribute [rw] next_token
607
+ # If the request doesn't return all of the remaining results,
608
+ # `NextToken` is set to a token. To retrieve the next set of results,
609
+ # call `ListResources` again and assign that token to the request
610
+ # object's `NextToken` parameter. If the request returns all results,
611
+ # `NextToken` is set to null.
612
+ # @return [String]
613
+ #
614
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/ListResourceRequestsOutput AWS API Documentation
615
+ #
616
+ class ListResourceRequestsOutput < Struct.new(
617
+ :resource_request_status_summaries,
618
+ :next_token)
619
+ SENSITIVE = []
620
+ include Aws::Structure
621
+ end
622
+
623
+ # @note When making an API call, you may pass ListResourcesInput
624
+ # data as a hash:
625
+ #
626
+ # {
627
+ # type_name: "TypeName", # required
628
+ # type_version_id: "TypeVersionId",
629
+ # role_arn: "RoleArn",
630
+ # next_token: "HandlerNextToken",
631
+ # max_results: 1,
632
+ # resource_model: "Properties",
633
+ # }
634
+ #
635
+ # @!attribute [rw] type_name
636
+ # The name of the resource type.
637
+ # @return [String]
638
+ #
639
+ # @!attribute [rw] type_version_id
640
+ # For private resource types, the type version to use in this resource
641
+ # operation. If you do not specify a resource version, CloudFormation
642
+ # uses the default version.
643
+ # @return [String]
644
+ #
645
+ # @!attribute [rw] role_arn
646
+ # The Amazon Resource Name (ARN) of the Identity and Access Management
647
+ # (IAM) for Cloud Control API to use when performing this resource
648
+ # operation. The role specified must have the permissions required for
649
+ # this operation. The necessary permissions for each event handler are
650
+ # defined in the ` handlers ` section of the [resource type definition
651
+ # schema][1].
652
+ #
653
+ # If you do not specify a role, Cloud Control API uses a temporary
654
+ # session created using your Amazon Web Services user credentials.
655
+ #
656
+ # For more information, see [Specifying credentials][2] in the *Amazon
657
+ # Web Services Cloud Control API User Guide*.
658
+ #
659
+ #
660
+ #
661
+ # [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html
662
+ # [2]: https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-permissions
663
+ # @return [String]
664
+ #
665
+ # @!attribute [rw] next_token
666
+ # If the previous paginated request didn't return all of the
667
+ # remaining results, the response object's `NextToken` parameter
668
+ # value is set to a token. To retrieve the next set of results, call
669
+ # this action again and assign that token to the request object's
670
+ # `NextToken` parameter. If there are no remaining results, the
671
+ # previous response object's `NextToken` parameter is set to `null`.
672
+ # @return [String]
673
+ #
674
+ # @!attribute [rw] max_results
675
+ # The maximum number of results to be returned with a single call. If
676
+ # the number of available results exceeds this maximum, the response
677
+ # includes a `NextToken` value that you can assign to the `NextToken`
678
+ # request parameter to get the next set of results.
679
+ #
680
+ # The default is `20`.
681
+ # @return [Integer]
682
+ #
683
+ # @!attribute [rw] resource_model
684
+ # The resource model to use to select the resources to return.
685
+ # @return [String]
686
+ #
687
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/ListResourcesInput AWS API Documentation
688
+ #
689
+ class ListResourcesInput < Struct.new(
690
+ :type_name,
691
+ :type_version_id,
692
+ :role_arn,
693
+ :next_token,
694
+ :max_results,
695
+ :resource_model)
696
+ SENSITIVE = [:resource_model]
697
+ include Aws::Structure
698
+ end
699
+
700
+ # @!attribute [rw] type_name
701
+ # The name of the resource type.
702
+ # @return [String]
703
+ #
704
+ # @!attribute [rw] resource_descriptions
705
+ # Information about the specified resources, including primary
706
+ # identifier and resource model.
707
+ # @return [Array<Types::ResourceDescription>]
708
+ #
709
+ # @!attribute [rw] next_token
710
+ # If the request doesn't return all of the remaining results,
711
+ # `NextToken` is set to a token. To retrieve the next set of results,
712
+ # call `ListResources` again and assign that token to the request
713
+ # object's `NextToken` parameter. If the request returns all results,
714
+ # `NextToken` is set to null.
715
+ # @return [String]
716
+ #
717
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/ListResourcesOutput AWS API Documentation
718
+ #
719
+ class ListResourcesOutput < Struct.new(
720
+ :type_name,
721
+ :resource_descriptions,
722
+ :next_token)
723
+ SENSITIVE = []
724
+ include Aws::Structure
725
+ end
726
+
727
+ # The resource handler has returned that the request could not be
728
+ # completed due to networking issues, such as a failure to receive a
729
+ # response from the server.
730
+ #
731
+ # @!attribute [rw] message
732
+ # @return [String]
733
+ #
734
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/NetworkFailureException AWS API Documentation
735
+ #
736
+ class NetworkFailureException < Struct.new(
737
+ :message)
738
+ SENSITIVE = []
739
+ include Aws::Structure
740
+ end
741
+
742
+ # The resource handler has returned that the downstream resource failed
743
+ # to complete all of its ready-state checks.
744
+ #
745
+ # @!attribute [rw] message
746
+ # @return [String]
747
+ #
748
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/NotStabilizedException AWS API Documentation
749
+ #
750
+ class NotStabilizedException < Struct.new(
751
+ :message)
752
+ SENSITIVE = []
753
+ include Aws::Structure
754
+ end
755
+
756
+ # One or more properties included in this resource operation are defined
757
+ # as create-only, and therefore cannot be updated.
758
+ #
759
+ # @!attribute [rw] message
760
+ # @return [String]
761
+ #
762
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/NotUpdatableException AWS API Documentation
763
+ #
764
+ class NotUpdatableException < Struct.new(
765
+ :message)
766
+ SENSITIVE = []
767
+ include Aws::Structure
768
+ end
769
+
770
+ # Cloud Control API has not received a valid response from the resource
771
+ # handler, due to a configuration error. This includes issues such as
772
+ # the resource handler returning an invalid response, or timing out.
773
+ #
774
+ # @!attribute [rw] message
775
+ # @return [String]
776
+ #
777
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/PrivateTypeException AWS API Documentation
778
+ #
779
+ class PrivateTypeException < Struct.new(
780
+ :message)
781
+ SENSITIVE = []
782
+ include Aws::Structure
783
+ end
784
+
785
+ # Represents the current status of a resource operation request. For
786
+ # more information, see [Managing resource operation requests][1] in the
787
+ # *Amazon Web Services Cloud Control API User Guide*.
788
+ #
789
+ #
790
+ #
791
+ # [1]: https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-manage-requests.html
792
+ #
793
+ # @!attribute [rw] type_name
794
+ # The name of the resource type used in the operation.
795
+ # @return [String]
796
+ #
797
+ # @!attribute [rw] identifier
798
+ # The primary identifier for the resource.
799
+ #
800
+ # <note markdown="1"> In some cases, the resource identifier may be available before the
801
+ # resource operation has reached a status of `SUCCESS`.
802
+ #
803
+ # </note>
804
+ # @return [String]
805
+ #
806
+ # @!attribute [rw] request_token
807
+ # The unique token representing this resource operation request.
808
+ #
809
+ # Use the `RequestToken` with [GetResourceRequestStatus][1] to return
810
+ # the current status of a resource operation request.
811
+ #
812
+ #
813
+ #
814
+ # [1]: https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_GetResourceRequestStatus.html
815
+ # @return [String]
816
+ #
817
+ # @!attribute [rw] operation
818
+ # The resource operation type.
819
+ # @return [String]
820
+ #
821
+ # @!attribute [rw] operation_status
822
+ # The current status of the resource operation request.
823
+ #
824
+ # * `PENDING`\: The resource operation has not yet started.
825
+ #
826
+ # * `IN_PROGRESS`\: The resource operation is currently in progress.
827
+ #
828
+ # * `SUCCESS`\: The resource operation has successfully completed.
829
+ #
830
+ # * `FAILED`\: The resource operation has failed. Refer to the error
831
+ # code and status message for more information.
832
+ #
833
+ # * `CANCEL_IN_PROGRESS`\: The resource operation is in the process of
834
+ # being canceled.
835
+ #
836
+ # * `CANCEL_COMPLETE`\: The resource operation has been canceled.
837
+ # @return [String]
838
+ #
839
+ # @!attribute [rw] event_time
840
+ # When the resource operation request was initiated.
841
+ # @return [Time]
842
+ #
843
+ # @!attribute [rw] resource_model
844
+ # A JSON string containing the resource model, consisting of each
845
+ # resource property and its current value.
846
+ # @return [String]
847
+ #
848
+ # @!attribute [rw] status_message
849
+ # Any message explaining the current status.
850
+ # @return [String]
851
+ #
852
+ # @!attribute [rw] error_code
853
+ # For requests with a status of `FAILED`, the associated error code.
854
+ #
855
+ # For error code definitions, see [Handler error codes][1] in the
856
+ # *CloudFormation Command Line Interface User Guide for Extension
857
+ # Development*.
858
+ #
859
+ #
860
+ #
861
+ # [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-test-contract-errors.html
862
+ # @return [String]
863
+ #
864
+ # @!attribute [rw] retry_after
865
+ # When to next request the status of this resource operation request.
866
+ # @return [Time]
867
+ #
868
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/ProgressEvent AWS API Documentation
869
+ #
870
+ class ProgressEvent < Struct.new(
871
+ :type_name,
872
+ :identifier,
873
+ :request_token,
874
+ :operation,
875
+ :operation_status,
876
+ :event_time,
877
+ :resource_model,
878
+ :status_message,
879
+ :error_code,
880
+ :retry_after)
881
+ SENSITIVE = [:resource_model]
882
+ include Aws::Structure
883
+ end
884
+
885
+ # A resource operation with the specified request token cannot be found.
886
+ #
887
+ # @!attribute [rw] message
888
+ # @return [String]
889
+ #
890
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/RequestTokenNotFoundException AWS API Documentation
891
+ #
892
+ class RequestTokenNotFoundException < Struct.new(
893
+ :message)
894
+ SENSITIVE = []
895
+ include Aws::Structure
896
+ end
897
+
898
+ # The resource is temporarily unavailable to be acted upon. For example,
899
+ # if the resource is currently undergoing an operation and cannot be
900
+ # acted upon until that operation is finished.
901
+ #
902
+ # @!attribute [rw] message
903
+ # @return [String]
904
+ #
905
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/ResourceConflictException AWS API Documentation
906
+ #
907
+ class ResourceConflictException < Struct.new(
908
+ :message)
909
+ SENSITIVE = []
910
+ include Aws::Structure
911
+ end
912
+
913
+ # Represents information about a provisioned resource.
914
+ #
915
+ # @!attribute [rw] identifier
916
+ # The primary identifier for the resource.
917
+ #
918
+ # For more information, see [Identifying resources][1] in the *Amazon
919
+ # Web Services Cloud Control API User Guide*.
920
+ #
921
+ #
922
+ #
923
+ # [1]: https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-identifier.html
924
+ # @return [String]
925
+ #
926
+ # @!attribute [rw] properties
927
+ # A list of the resource properties and their current values.
928
+ # @return [String]
929
+ #
930
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/ResourceDescription AWS API Documentation
931
+ #
932
+ class ResourceDescription < Struct.new(
933
+ :identifier,
934
+ :properties)
935
+ SENSITIVE = [:properties]
936
+ include Aws::Structure
937
+ end
938
+
939
+ # A resource with the specified identifier cannot be found.
940
+ #
941
+ # @!attribute [rw] message
942
+ # @return [String]
943
+ #
944
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/ResourceNotFoundException AWS API Documentation
945
+ #
946
+ class ResourceNotFoundException < Struct.new(
947
+ :message)
948
+ SENSITIVE = []
949
+ include Aws::Structure
950
+ end
951
+
952
+ # The filter criteria to use in determining the requests returned.
953
+ #
954
+ # @note When making an API call, you may pass ResourceRequestStatusFilter
955
+ # data as a hash:
956
+ #
957
+ # {
958
+ # operations: ["CREATE"], # accepts CREATE, DELETE, UPDATE
959
+ # operation_statuses: ["PENDING"], # accepts PENDING, IN_PROGRESS, SUCCESS, FAILED, CANCEL_IN_PROGRESS, CANCEL_COMPLETE
960
+ # }
961
+ #
962
+ # @!attribute [rw] operations
963
+ # The operation types to include in the filter.
964
+ # @return [Array<String>]
965
+ #
966
+ # @!attribute [rw] operation_statuses
967
+ # The operation statuses to include in the filter.
968
+ #
969
+ # * `PENDING`\: The operation has been requested, but not yet
970
+ # initiated.
971
+ #
972
+ # * `IN_PROGRESS`\: The operation is currently in progress.
973
+ #
974
+ # * `SUCCESS`\: The operation has successfully completed.
975
+ #
976
+ # * `FAILED`\: The operation has failed.
977
+ #
978
+ # * `CANCEL_IN_PROGRESS`\: The operation is currently in the process
979
+ # of being canceled.
980
+ #
981
+ # * `CANCEL_COMPLETE`\: The operation has been canceled.
982
+ # @return [Array<String>]
983
+ #
984
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/ResourceRequestStatusFilter AWS API Documentation
985
+ #
986
+ class ResourceRequestStatusFilter < Struct.new(
987
+ :operations,
988
+ :operation_statuses)
989
+ SENSITIVE = []
990
+ include Aws::Structure
991
+ end
992
+
993
+ # The resource handler has returned that the downstream service returned
994
+ # an internal error, typically with a `5XX HTTP` status code.
995
+ #
996
+ # @!attribute [rw] message
997
+ # @return [String]
998
+ #
999
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/ServiceInternalErrorException AWS API Documentation
1000
+ #
1001
+ class ServiceInternalErrorException < Struct.new(
1002
+ :message)
1003
+ SENSITIVE = []
1004
+ include Aws::Structure
1005
+ end
1006
+
1007
+ # The resource handler has returned that a non-transient resource limit
1008
+ # was reached on the service side.
1009
+ #
1010
+ # @!attribute [rw] message
1011
+ # @return [String]
1012
+ #
1013
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/ServiceLimitExceededException AWS API Documentation
1014
+ #
1015
+ class ServiceLimitExceededException < Struct.new(
1016
+ :message)
1017
+ SENSITIVE = []
1018
+ include Aws::Structure
1019
+ end
1020
+
1021
+ # The request was denied due to request throttling.
1022
+ #
1023
+ # @!attribute [rw] message
1024
+ # @return [String]
1025
+ #
1026
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/ThrottlingException AWS API Documentation
1027
+ #
1028
+ class ThrottlingException < Struct.new(
1029
+ :message)
1030
+ SENSITIVE = []
1031
+ include Aws::Structure
1032
+ end
1033
+
1034
+ # The specified extension does not exist in the CloudFormation registry.
1035
+ #
1036
+ # @!attribute [rw] message
1037
+ # @return [String]
1038
+ #
1039
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/TypeNotFoundException AWS API Documentation
1040
+ #
1041
+ class TypeNotFoundException < Struct.new(
1042
+ :message)
1043
+ SENSITIVE = []
1044
+ include Aws::Structure
1045
+ end
1046
+
1047
+ # The specified resource does not support this resource operation.
1048
+ #
1049
+ # @!attribute [rw] message
1050
+ # @return [String]
1051
+ #
1052
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/UnsupportedActionException AWS API Documentation
1053
+ #
1054
+ class UnsupportedActionException < Struct.new(
1055
+ :message)
1056
+ SENSITIVE = []
1057
+ include Aws::Structure
1058
+ end
1059
+
1060
+ # @note When making an API call, you may pass UpdateResourceInput
1061
+ # data as a hash:
1062
+ #
1063
+ # {
1064
+ # type_name: "TypeName", # required
1065
+ # type_version_id: "TypeVersionId",
1066
+ # role_arn: "RoleArn",
1067
+ # client_token: "ClientToken",
1068
+ # identifier: "Identifier", # required
1069
+ # patch_document: "PatchDocument", # required
1070
+ # }
1071
+ #
1072
+ # @!attribute [rw] type_name
1073
+ # The name of the resource type.
1074
+ # @return [String]
1075
+ #
1076
+ # @!attribute [rw] type_version_id
1077
+ # For private resource types, the type version to use in this resource
1078
+ # operation. If you do not specify a resource version, CloudFormation
1079
+ # uses the default version.
1080
+ # @return [String]
1081
+ #
1082
+ # @!attribute [rw] role_arn
1083
+ # The Amazon Resource Name (ARN) of the Identity and Access Management
1084
+ # (IAM) for Cloud Control API to use when performing this resource
1085
+ # operation. The role specified must have the permissions required for
1086
+ # this operation. The necessary permissions for each event handler are
1087
+ # defined in the ` handlers ` section of the [resource type definition
1088
+ # schema][1].
1089
+ #
1090
+ # If you do not specify a role, Cloud Control API uses a temporary
1091
+ # session created using your Amazon Web Services user credentials.
1092
+ #
1093
+ # For more information, see [Specifying credentials][2] in the *Amazon
1094
+ # Web Services Cloud Control API User Guide*.
1095
+ #
1096
+ #
1097
+ #
1098
+ # [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html
1099
+ # [2]: https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-permissions
1100
+ # @return [String]
1101
+ #
1102
+ # @!attribute [rw] client_token
1103
+ # A unique identifier to ensure the idempotency of the resource
1104
+ # request. As a best practice, specify this token to ensure
1105
+ # idempotency, so that Amazon Web Services Cloud Control API can
1106
+ # accurately distinguish between request retries and new resource
1107
+ # requests. You might retry a resource request to ensure that it was
1108
+ # successfully received.
1109
+ #
1110
+ # A client token is valid for 36 hours once used. After that, a
1111
+ # resource request with the same client token is treated as a new
1112
+ # request.
1113
+ #
1114
+ # If you do not specify a client token, one is generated for inclusion
1115
+ # in the request.
1116
+ #
1117
+ # For more information, see [Ensuring resource operation requests are
1118
+ # unique][1] in the *Amazon Web Services Cloud Control API User
1119
+ # Guide*.
1120
+ #
1121
+ # **A suitable default value is auto-generated.** You should normally
1122
+ # not need to pass this option.
1123
+ #
1124
+ #
1125
+ #
1126
+ # [1]: https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-idempotency
1127
+ # @return [String]
1128
+ #
1129
+ # @!attribute [rw] identifier
1130
+ # The identifier for the resource.
1131
+ #
1132
+ # You can specify the primary identifier, or any secondary identifier
1133
+ # defined for the resource type in its resource schema. You can only
1134
+ # specify one identifier. Primary identifiers can be specified as a
1135
+ # string or JSON; secondary identifiers must be specified as JSON.
1136
+ #
1137
+ # For compound primary identifiers (that is, one that consists of
1138
+ # multiple resource properties strung together), to specify the
1139
+ # primary identifier as a string, list the property values *in the
1140
+ # order they are specified* in the primary identifier definition,
1141
+ # separated by `|`.
1142
+ #
1143
+ # For more information, see [Identifying resources][1] in the *Amazon
1144
+ # Web Services Cloud Control API User Guide*.
1145
+ #
1146
+ #
1147
+ #
1148
+ # [1]: https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-identifier.html
1149
+ # @return [String]
1150
+ #
1151
+ # @!attribute [rw] patch_document
1152
+ # A JavaScript Object Notation (JSON) document listing the patch
1153
+ # operations that represent the updates to apply to the current
1154
+ # resource properties. For details, see [Composing the patch
1155
+ # document][1] in the *Amazon Web Services Cloud Control API User
1156
+ # Guide*.
1157
+ #
1158
+ #
1159
+ #
1160
+ # [1]: https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-update.html#resource-operations-update-patch
1161
+ # @return [String]
1162
+ #
1163
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/UpdateResourceInput AWS API Documentation
1164
+ #
1165
+ class UpdateResourceInput < Struct.new(
1166
+ :type_name,
1167
+ :type_version_id,
1168
+ :role_arn,
1169
+ :client_token,
1170
+ :identifier,
1171
+ :patch_document)
1172
+ SENSITIVE = [:patch_document]
1173
+ include Aws::Structure
1174
+ end
1175
+
1176
+ # @!attribute [rw] progress_event
1177
+ # Represents the current status of the resource update request.
1178
+ #
1179
+ # Use the `RequestToken` of the `ProgressEvent` with
1180
+ # [GetResourceRequestStatus][1] to return the current status of a
1181
+ # resource operation request.
1182
+ #
1183
+ #
1184
+ #
1185
+ # [1]: https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_GetResourceRequestStatus.html
1186
+ # @return [Types::ProgressEvent]
1187
+ #
1188
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudcontrol-2021-09-30/UpdateResourceOutput AWS API Documentation
1189
+ #
1190
+ class UpdateResourceOutput < Struct.new(
1191
+ :progress_event)
1192
+ SENSITIVE = []
1193
+ include Aws::Structure
1194
+ end
1195
+
1196
+ end
1197
+ end