aws-sdk-cloudcontrolapi 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -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