aws-sdk-proton 1.15.0 → 1.16.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -80,6 +80,38 @@ module Aws::Proton
80
80
  include Aws::Structure
81
81
  end
82
82
 
83
+ # @note When making an API call, you may pass CancelComponentDeploymentInput
84
+ # data as a hash:
85
+ #
86
+ # {
87
+ # component_name: "ResourceName", # required
88
+ # }
89
+ #
90
+ # @!attribute [rw] component_name
91
+ # The name of the component with the deployment to cancel.
92
+ # @return [String]
93
+ #
94
+ # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/CancelComponentDeploymentInput AWS API Documentation
95
+ #
96
+ class CancelComponentDeploymentInput < Struct.new(
97
+ :component_name)
98
+ SENSITIVE = []
99
+ include Aws::Structure
100
+ end
101
+
102
+ # @!attribute [rw] component
103
+ # The detailed data of the component with the deployment that is being
104
+ # canceled.
105
+ # @return [Types::Component]
106
+ #
107
+ # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/CancelComponentDeploymentOutput AWS API Documentation
108
+ #
109
+ class CancelComponentDeploymentOutput < Struct.new(
110
+ :component)
111
+ SENSITIVE = []
112
+ include Aws::Structure
113
+ end
114
+
83
115
  # @note When making an API call, you may pass CancelEnvironmentDeploymentInput
84
116
  # data as a hash:
85
117
  #
@@ -227,6 +259,165 @@ module Aws::Proton
227
259
  include Aws::Structure
228
260
  end
229
261
 
262
+ # Detailed data of an Proton component resource.
263
+ #
264
+ # For more information about components, see [Proton components][1] in
265
+ # the *Proton Administrator Guide*.
266
+ #
267
+ #
268
+ #
269
+ # [1]: https://docs.aws.amazon.com/proton/latest/adminguide/ag-components.html
270
+ #
271
+ # @!attribute [rw] arn
272
+ # The Amazon Resource Name (ARN) of the component.
273
+ # @return [String]
274
+ #
275
+ # @!attribute [rw] created_at
276
+ # The time when the component was created.
277
+ # @return [Time]
278
+ #
279
+ # @!attribute [rw] deployment_status
280
+ # The component deployment status.
281
+ # @return [String]
282
+ #
283
+ # @!attribute [rw] deployment_status_message
284
+ # The message associated with the component deployment status.
285
+ # @return [String]
286
+ #
287
+ # @!attribute [rw] description
288
+ # A description of the component.
289
+ # @return [String]
290
+ #
291
+ # @!attribute [rw] environment_name
292
+ # The name of the Proton environment that this component is associated
293
+ # with.
294
+ # @return [String]
295
+ #
296
+ # @!attribute [rw] last_deployment_attempted_at
297
+ # The time when a deployment of the component was last attempted.
298
+ # @return [Time]
299
+ #
300
+ # @!attribute [rw] last_deployment_succeeded_at
301
+ # The time when the component was last deployed successfully.
302
+ # @return [Time]
303
+ #
304
+ # @!attribute [rw] last_modified_at
305
+ # The time when the component was last modified.
306
+ # @return [Time]
307
+ #
308
+ # @!attribute [rw] name
309
+ # The name of the component.
310
+ # @return [String]
311
+ #
312
+ # @!attribute [rw] service_instance_name
313
+ # The name of the service instance that this component is attached to.
314
+ # Provided when a component is attached to a service instance.
315
+ # @return [String]
316
+ #
317
+ # @!attribute [rw] service_name
318
+ # The name of the service that `serviceInstanceName` is associated
319
+ # with. Provided when a component is attached to a service instance.
320
+ # @return [String]
321
+ #
322
+ # @!attribute [rw] service_spec
323
+ # The service spec that the component uses to access service inputs.
324
+ # Provided when a component is attached to a service instance.
325
+ # @return [String]
326
+ #
327
+ # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/Component AWS API Documentation
328
+ #
329
+ class Component < Struct.new(
330
+ :arn,
331
+ :created_at,
332
+ :deployment_status,
333
+ :deployment_status_message,
334
+ :description,
335
+ :environment_name,
336
+ :last_deployment_attempted_at,
337
+ :last_deployment_succeeded_at,
338
+ :last_modified_at,
339
+ :name,
340
+ :service_instance_name,
341
+ :service_name,
342
+ :service_spec)
343
+ SENSITIVE = [:deployment_status_message, :description, :service_spec]
344
+ include Aws::Structure
345
+ end
346
+
347
+ # Summary data of an Proton component resource.
348
+ #
349
+ # For more information about components, see [Proton components][1] in
350
+ # the *Proton Administrator Guide*.
351
+ #
352
+ #
353
+ #
354
+ # [1]: https://docs.aws.amazon.com/proton/latest/adminguide/ag-components.html
355
+ #
356
+ # @!attribute [rw] arn
357
+ # The Amazon Resource Name (ARN) of the component.
358
+ # @return [String]
359
+ #
360
+ # @!attribute [rw] created_at
361
+ # The time when the component was created.
362
+ # @return [Time]
363
+ #
364
+ # @!attribute [rw] deployment_status
365
+ # The component deployment status.
366
+ # @return [String]
367
+ #
368
+ # @!attribute [rw] deployment_status_message
369
+ # The message associated with the component deployment status.
370
+ # @return [String]
371
+ #
372
+ # @!attribute [rw] environment_name
373
+ # The name of the Proton environment that this component is associated
374
+ # with.
375
+ # @return [String]
376
+ #
377
+ # @!attribute [rw] last_deployment_attempted_at
378
+ # The time when a deployment of the component was last attempted.
379
+ # @return [Time]
380
+ #
381
+ # @!attribute [rw] last_deployment_succeeded_at
382
+ # The time when the component was last deployed successfully.
383
+ # @return [Time]
384
+ #
385
+ # @!attribute [rw] last_modified_at
386
+ # The time when the component was last modified.
387
+ # @return [Time]
388
+ #
389
+ # @!attribute [rw] name
390
+ # The name of the component.
391
+ # @return [String]
392
+ #
393
+ # @!attribute [rw] service_instance_name
394
+ # The name of the service instance that this component is attached to.
395
+ # Provided when a component is attached to a service instance.
396
+ # @return [String]
397
+ #
398
+ # @!attribute [rw] service_name
399
+ # The name of the service that `serviceInstanceName` is associated
400
+ # with. Provided when a component is attached to a service instance.
401
+ # @return [String]
402
+ #
403
+ # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/ComponentSummary AWS API Documentation
404
+ #
405
+ class ComponentSummary < Struct.new(
406
+ :arn,
407
+ :created_at,
408
+ :deployment_status,
409
+ :deployment_status_message,
410
+ :environment_name,
411
+ :last_deployment_attempted_at,
412
+ :last_deployment_succeeded_at,
413
+ :last_modified_at,
414
+ :name,
415
+ :service_instance_name,
416
+ :service_name)
417
+ SENSITIVE = [:deployment_status_message]
418
+ include Aws::Structure
419
+ end
420
+
230
421
  # The request *couldn't* be made due to a conflicting operation or
231
422
  # resource.
232
423
  #
@@ -241,11 +432,123 @@ module Aws::Proton
241
432
  include Aws::Structure
242
433
  end
243
434
 
435
+ # @note When making an API call, you may pass CreateComponentInput
436
+ # data as a hash:
437
+ #
438
+ # {
439
+ # description: "Description",
440
+ # environment_name: "ResourceName",
441
+ # manifest: "TemplateManifestContents", # required
442
+ # name: "ResourceName", # required
443
+ # service_instance_name: "ResourceName",
444
+ # service_name: "ResourceName",
445
+ # service_spec: "SpecContents",
446
+ # tags: [
447
+ # {
448
+ # key: "TagKey", # required
449
+ # value: "TagValue", # required
450
+ # },
451
+ # ],
452
+ # template_file: "TemplateFileContents", # required
453
+ # }
454
+ #
455
+ # @!attribute [rw] description
456
+ # An optional customer-provided description of the component.
457
+ # @return [String]
458
+ #
459
+ # @!attribute [rw] environment_name
460
+ # The name of the Proton environment that you want to associate this
461
+ # component with. You must specify this when you don't specify
462
+ # `serviceInstanceName` and `serviceName`.
463
+ # @return [String]
464
+ #
465
+ # @!attribute [rw] manifest
466
+ # A path to a manifest file that lists the Infrastructure as Code
467
+ # (IaC) file, template language, and rendering engine for
468
+ # infrastructure that a custom component provisions.
469
+ # @return [String]
470
+ #
471
+ # @!attribute [rw] name
472
+ # The customer-provided name of the component.
473
+ # @return [String]
474
+ #
475
+ # @!attribute [rw] service_instance_name
476
+ # The name of the service instance that you want to attach this
477
+ # component to. If you don't specify this, the component isn't
478
+ # attached to any service instance. Specify both `serviceInstanceName`
479
+ # and `serviceName` or neither of them.
480
+ # @return [String]
481
+ #
482
+ # @!attribute [rw] service_name
483
+ # The name of the service that `serviceInstanceName` is associated
484
+ # with. If you don't specify this, the component isn't attached to
485
+ # any service instance. Specify both `serviceInstanceName` and
486
+ # `serviceName` or neither of them.
487
+ # @return [String]
488
+ #
489
+ # @!attribute [rw] service_spec
490
+ # The service spec that you want the component to use to access
491
+ # service inputs. Set this only when you attach the component to a
492
+ # service instance.
493
+ # @return [String]
494
+ #
495
+ # @!attribute [rw] tags
496
+ # An optional list of metadata items that you can associate with the
497
+ # Proton component. A tag is a key-value pair.
498
+ #
499
+ # For more information, see *Proton resources and tagging* in the
500
+ # [Proton Administrator Guide][1] or [Proton User Guide][2].
501
+ #
502
+ #
503
+ #
504
+ # [1]: https://docs.aws.amazon.com/proton/latest/adminguide/resources.html
505
+ # [2]: https://docs.aws.amazon.com/proton/latest/userguide/resources.html
506
+ # @return [Array<Types::Tag>]
507
+ #
508
+ # @!attribute [rw] template_file
509
+ # A path to the Infrastructure as Code (IaC) file describing
510
+ # infrastructure that a custom component provisions.
511
+ #
512
+ # <note markdown="1"> Components support a single IaC file, even if you use Terraform as
513
+ # your template language.
514
+ #
515
+ # </note>
516
+ # @return [String]
517
+ #
518
+ # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/CreateComponentInput AWS API Documentation
519
+ #
520
+ class CreateComponentInput < Struct.new(
521
+ :description,
522
+ :environment_name,
523
+ :manifest,
524
+ :name,
525
+ :service_instance_name,
526
+ :service_name,
527
+ :service_spec,
528
+ :tags,
529
+ :template_file)
530
+ SENSITIVE = [:description, :manifest, :service_spec, :template_file]
531
+ include Aws::Structure
532
+ end
533
+
534
+ # @!attribute [rw] component
535
+ # The detailed data of the created component.
536
+ # @return [Types::Component]
537
+ #
538
+ # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/CreateComponentOutput AWS API Documentation
539
+ #
540
+ class CreateComponentOutput < Struct.new(
541
+ :component)
542
+ SENSITIVE = []
543
+ include Aws::Structure
544
+ end
545
+
244
546
  # @note When making an API call, you may pass CreateEnvironmentAccountConnectionInput
245
547
  # data as a hash:
246
548
  #
247
549
  # {
248
550
  # client_token: "ClientToken",
551
+ # component_role_arn: "Arn",
249
552
  # environment_name: "ResourceName", # required
250
553
  # management_account_id: "AwsAccountId", # required
251
554
  # role_arn: "Arn", # required
@@ -266,6 +569,24 @@ module Aws::Proton
266
569
  # not need to pass this option.
267
570
  # @return [String]
268
571
  #
572
+ # @!attribute [rw] component_role_arn
573
+ # The Amazon Resource Name (ARN) of the IAM service role that Proton
574
+ # uses when provisioning directly defined components in the associated
575
+ # environment account. It determines the scope of infrastructure that
576
+ # a component can provision in the account.
577
+ #
578
+ # You must specify `componentRoleArn` to allow directly defined
579
+ # components to be associated with any environments running in this
580
+ # account.
581
+ #
582
+ # For more information about components, see [Proton components][1] in
583
+ # the *Proton Administrator Guide*.
584
+ #
585
+ #
586
+ #
587
+ # [1]: https://docs.aws.amazon.com/proton/latest/adminguide/ag-components.html
588
+ # @return [String]
589
+ #
269
590
  # @!attribute [rw] environment_name
270
591
  # The name of the Proton environment that's created in the associated
271
592
  # management account.
@@ -303,6 +624,7 @@ module Aws::Proton
303
624
  #
304
625
  class CreateEnvironmentAccountConnectionInput < Struct.new(
305
626
  :client_token,
627
+ :component_role_arn,
306
628
  :environment_name,
307
629
  :management_account_id,
308
630
  :role_arn,
@@ -328,6 +650,7 @@ module Aws::Proton
328
650
  # data as a hash:
329
651
  #
330
652
  # {
653
+ # component_role_arn: "Arn",
331
654
  # description: "Description",
332
655
  # environment_account_connection_id: "EnvironmentAccountConnectionId",
333
656
  # name: "ResourceName", # required
@@ -349,6 +672,23 @@ module Aws::Proton
349
672
  # template_name: "ResourceName", # required
350
673
  # }
351
674
  #
675
+ # @!attribute [rw] component_role_arn
676
+ # The Amazon Resource Name (ARN) of the IAM service role that Proton
677
+ # uses when provisioning directly defined components in this
678
+ # environment. It determines the scope of infrastructure that a
679
+ # component can provision.
680
+ #
681
+ # You must specify `componentRoleArn` to allow directly defined
682
+ # components to be associated with this environment.
683
+ #
684
+ # For more information about components, see [Proton components][1] in
685
+ # the *Proton Administrator Guide*.
686
+ #
687
+ #
688
+ #
689
+ # [1]: https://docs.aws.amazon.com/proton/latest/adminguide/ag-components.html
690
+ # @return [String]
691
+ #
352
692
  # @!attribute [rw] description
353
693
  # A description of the environment that's being created and deployed.
354
694
  # @return [String]
@@ -435,6 +775,7 @@ module Aws::Proton
435
775
  # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/CreateEnvironmentInput AWS API Documentation
436
776
  #
437
777
  class CreateEnvironmentInput < Struct.new(
778
+ :component_role_arn,
438
779
  :description,
439
780
  :environment_account_connection_id,
440
781
  :name,
@@ -930,6 +1271,7 @@ module Aws::Proton
930
1271
  # key: "S3Key", # required
931
1272
  # },
932
1273
  # },
1274
+ # supported_component_sources: ["DIRECTLY_DEFINED"], # accepts DIRECTLY_DEFINED
933
1275
  # tags: [
934
1276
  # {
935
1277
  # key: "TagKey", # required
@@ -949,8 +1291,10 @@ module Aws::Proton
949
1291
  # @return [String]
950
1292
  #
951
1293
  # @!attribute [rw] compatible_environment_templates
952
- # An array of compatible environment template objects for the new
953
- # version of a service template.
1294
+ # An array of environment template objects that are compatible with
1295
+ # the new service template version. A service instance based on this
1296
+ # service template version can run in environments based on compatible
1297
+ # templates.
954
1298
  # @return [Array<Types::CompatibleEnvironmentTemplateInput>]
955
1299
  #
956
1300
  # @!attribute [rw] description
@@ -970,6 +1314,19 @@ module Aws::Proton
970
1314
  # for the new version of a service template.
971
1315
  # @return [Types::TemplateVersionSourceInput]
972
1316
  #
1317
+ # @!attribute [rw] supported_component_sources
1318
+ # An array of supported component sources. Components with supported
1319
+ # sources can be attached to service instances based on this service
1320
+ # template version.
1321
+ #
1322
+ # For more information about components, see [Proton components][1] in
1323
+ # the *Proton Administrator Guide*.
1324
+ #
1325
+ #
1326
+ #
1327
+ # [1]: https://docs.aws.amazon.com/proton/latest/adminguide/ag-components.html
1328
+ # @return [Array<String>]
1329
+ #
973
1330
  # @!attribute [rw] tags
974
1331
  # An optional list of metadata items that you can associate with the
975
1332
  # Proton service template version. A tag is a key-value pair.
@@ -995,6 +1352,7 @@ module Aws::Proton
995
1352
  :description,
996
1353
  :major_version,
997
1354
  :source,
1355
+ :supported_component_sources,
998
1356
  :tags,
999
1357
  :template_name)
1000
1358
  SENSITIVE = [:description]
@@ -1078,6 +1436,37 @@ module Aws::Proton
1078
1436
  include Aws::Structure
1079
1437
  end
1080
1438
 
1439
+ # @note When making an API call, you may pass DeleteComponentInput
1440
+ # data as a hash:
1441
+ #
1442
+ # {
1443
+ # name: "ResourceName", # required
1444
+ # }
1445
+ #
1446
+ # @!attribute [rw] name
1447
+ # The name of the component to delete.
1448
+ # @return [String]
1449
+ #
1450
+ # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/DeleteComponentInput AWS API Documentation
1451
+ #
1452
+ class DeleteComponentInput < Struct.new(
1453
+ :name)
1454
+ SENSITIVE = []
1455
+ include Aws::Structure
1456
+ end
1457
+
1458
+ # @!attribute [rw] component
1459
+ # The detailed data of the component being deleted.
1460
+ # @return [Types::Component]
1461
+ #
1462
+ # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/DeleteComponentOutput AWS API Documentation
1463
+ #
1464
+ class DeleteComponentOutput < Struct.new(
1465
+ :component)
1466
+ SENSITIVE = []
1467
+ include Aws::Structure
1468
+ end
1469
+
1081
1470
  # @note When making an API call, you may pass DeleteEnvironmentAccountConnectionInput
1082
1471
  # data as a hash:
1083
1472
  #
@@ -1098,8 +1487,8 @@ module Aws::Proton
1098
1487
  end
1099
1488
 
1100
1489
  # @!attribute [rw] environment_account_connection
1101
- # The environment account connection detail data that's returned by
1102
- # Proton.
1490
+ # The detailed data of the environment account connection being
1491
+ # deleted.
1103
1492
  # @return [Types::EnvironmentAccountConnection]
1104
1493
  #
1105
1494
  # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/DeleteEnvironmentAccountConnectionOutput AWS API Documentation
@@ -1130,7 +1519,7 @@ module Aws::Proton
1130
1519
  end
1131
1520
 
1132
1521
  # @!attribute [rw] environment
1133
- # The environment detail data that's returned by Proton.
1522
+ # The detailed data of the environment being deleted.
1134
1523
  # @return [Types::Environment]
1135
1524
  #
1136
1525
  # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/DeleteEnvironmentOutput AWS API Documentation
@@ -1161,7 +1550,7 @@ module Aws::Proton
1161
1550
  end
1162
1551
 
1163
1552
  # @!attribute [rw] environment_template
1164
- # The environment template detail data that's returned by Proton.
1553
+ # The detailed data of the environment template being deleted.
1165
1554
  # @return [Types::EnvironmentTemplate]
1166
1555
  #
1167
1556
  # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/DeleteEnvironmentTemplateOutput AWS API Documentation
@@ -1204,8 +1593,7 @@ module Aws::Proton
1204
1593
  end
1205
1594
 
1206
1595
  # @!attribute [rw] environment_template_version
1207
- # The environment template version detail data that's returned by
1208
- # Proton.
1596
+ # The detailed data of the environment template version being deleted.
1209
1597
  # @return [Types::EnvironmentTemplateVersion]
1210
1598
  #
1211
1599
  # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/DeleteEnvironmentTemplateVersionOutput AWS API Documentation
@@ -1273,7 +1661,7 @@ module Aws::Proton
1273
1661
  end
1274
1662
 
1275
1663
  # @!attribute [rw] service
1276
- # The service detail data that's returned by Proton.
1664
+ # The detailed data of the service being deleted.
1277
1665
  # @return [Types::Service]
1278
1666
  #
1279
1667
  # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/DeleteServiceOutput AWS API Documentation
@@ -1304,7 +1692,7 @@ module Aws::Proton
1304
1692
  end
1305
1693
 
1306
1694
  # @!attribute [rw] service_template
1307
- # The service template detail data that's returned by Proton.
1695
+ # The detailed data of the service template being deleted.
1308
1696
  # @return [Types::ServiceTemplate]
1309
1697
  #
1310
1698
  # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/DeleteServiceTemplateOutput AWS API Documentation
@@ -1347,7 +1735,7 @@ module Aws::Proton
1347
1735
  end
1348
1736
 
1349
1737
  # @!attribute [rw] service_template_version
1350
- # The service template version detail data that's returned by Proton.
1738
+ # The detailed data of the service template version being deleted.
1351
1739
  # @return [Types::ServiceTemplateVersion]
1352
1740
  #
1353
1741
  # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/DeleteServiceTemplateVersionOutput AWS API Documentation
@@ -1396,13 +1784,30 @@ module Aws::Proton
1396
1784
  include Aws::Structure
1397
1785
  end
1398
1786
 
1399
- # The environment detail data. An Proton environment is a set resources
1400
- # shared across an Proton service.
1787
+ # Detailed data of an Proton environment resource. An Proton environment
1788
+ # is a set of resources shared across Proton services.
1401
1789
  #
1402
1790
  # @!attribute [rw] arn
1403
1791
  # The Amazon Resource Name (ARN) of the environment.
1404
1792
  # @return [String]
1405
1793
  #
1794
+ # @!attribute [rw] component_role_arn
1795
+ # The Amazon Resource Name (ARN) of the IAM service role that Proton
1796
+ # uses when provisioning directly defined components in this
1797
+ # environment. It determines the scope of infrastructure that a
1798
+ # component can provision.
1799
+ #
1800
+ # The environment must have a `componentRoleArn` to allow directly
1801
+ # defined components to be associated with the environment.
1802
+ #
1803
+ # For more information about components, see [Proton components][1] in
1804
+ # the *Proton Administrator Guide*.
1805
+ #
1806
+ #
1807
+ #
1808
+ # [1]: https://docs.aws.amazon.com/proton/latest/adminguide/ag-components.html
1809
+ # @return [String]
1810
+ #
1406
1811
  # @!attribute [rw] created_at
1407
1812
  # The time when the environment was created.
1408
1813
  # @return [Time]
@@ -1476,6 +1881,7 @@ module Aws::Proton
1476
1881
  #
1477
1882
  class Environment < Struct.new(
1478
1883
  :arn,
1884
+ :component_role_arn,
1479
1885
  :created_at,
1480
1886
  :deployment_status,
1481
1887
  :deployment_status_message,
@@ -1496,13 +1902,31 @@ module Aws::Proton
1496
1902
  include Aws::Structure
1497
1903
  end
1498
1904
 
1499
- # The environment account connection detail data.
1905
+ # Detailed data of an Proton environment account connection resource.
1500
1906
  #
1501
1907
  # @!attribute [rw] arn
1502
1908
  # The Amazon Resource Name (ARN) of the environment account
1503
1909
  # connection.
1504
1910
  # @return [String]
1505
1911
  #
1912
+ # @!attribute [rw] component_role_arn
1913
+ # The Amazon Resource Name (ARN) of the IAM service role that Proton
1914
+ # uses when provisioning directly defined components in the associated
1915
+ # environment account. It determines the scope of infrastructure that
1916
+ # a component can provision in the account.
1917
+ #
1918
+ # The environment account connection must have a `componentRoleArn` to
1919
+ # allow directly defined components to be associated with any
1920
+ # environments running in the account.
1921
+ #
1922
+ # For more information about components, see [Proton components][1] in
1923
+ # the *Proton Administrator Guide*.
1924
+ #
1925
+ #
1926
+ #
1927
+ # [1]: https://docs.aws.amazon.com/proton/latest/adminguide/ag-components.html
1928
+ # @return [String]
1929
+ #
1506
1930
  # @!attribute [rw] environment_account_id
1507
1931
  # The environment account that's connected to the environment account
1508
1932
  # connection.
@@ -1543,6 +1967,7 @@ module Aws::Proton
1543
1967
  #
1544
1968
  class EnvironmentAccountConnection < Struct.new(
1545
1969
  :arn,
1970
+ :component_role_arn,
1546
1971
  :environment_account_id,
1547
1972
  :environment_name,
1548
1973
  :id,
@@ -1555,13 +1980,31 @@ module Aws::Proton
1555
1980
  include Aws::Structure
1556
1981
  end
1557
1982
 
1558
- # A summary of the environment account connection detail data.
1983
+ # Summary data of an Proton environment account connection resource.
1559
1984
  #
1560
1985
  # @!attribute [rw] arn
1561
1986
  # The Amazon Resource Name (ARN) of the environment account
1562
1987
  # connection.
1563
1988
  # @return [String]
1564
1989
  #
1990
+ # @!attribute [rw] component_role_arn
1991
+ # The Amazon Resource Name (ARN) of the IAM service role that Proton
1992
+ # uses when provisioning directly defined components in the associated
1993
+ # environment account. It determines the scope of infrastructure that
1994
+ # a component can provision in the account.
1995
+ #
1996
+ # The environment account connection must have a `componentRoleArn` to
1997
+ # allow directly defined components to be associated with any
1998
+ # environments running in the account.
1999
+ #
2000
+ # For more information about components, see [Proton components][1] in
2001
+ # the *Proton Administrator Guide*.
2002
+ #
2003
+ #
2004
+ #
2005
+ # [1]: https://docs.aws.amazon.com/proton/latest/adminguide/ag-components.html
2006
+ # @return [String]
2007
+ #
1565
2008
  # @!attribute [rw] environment_account_id
1566
2009
  # The ID of the environment account that's connected to the
1567
2010
  # environment account connection.
@@ -1602,6 +2045,7 @@ module Aws::Proton
1602
2045
  #
1603
2046
  class EnvironmentAccountConnectionSummary < Struct.new(
1604
2047
  :arn,
2048
+ :component_role_arn,
1605
2049
  :environment_account_id,
1606
2050
  :environment_name,
1607
2051
  :id,
@@ -1614,10 +2058,28 @@ module Aws::Proton
1614
2058
  include Aws::Structure
1615
2059
  end
1616
2060
 
1617
- # A summary of the environment detail data.
2061
+ # Summary data of an Proton environment resource. An Proton environment
2062
+ # is a set of resources shared across Proton services.
2063
+ #
2064
+ # @!attribute [rw] arn
2065
+ # The Amazon Resource Name (ARN) of the environment.
2066
+ # @return [String]
2067
+ #
2068
+ # @!attribute [rw] component_role_arn
2069
+ # The Amazon Resource Name (ARN) of the IAM service role that Proton
2070
+ # uses when provisioning directly defined components in this
2071
+ # environment. It determines the scope of infrastructure that a
2072
+ # component can provision.
1618
2073
  #
1619
- # @!attribute [rw] arn
1620
- # The Amazon Resource Name (ARN) of the environment.
2074
+ # The environment must have a `componentRoleArn` to allow directly
2075
+ # defined components to be associated with the environment.
2076
+ #
2077
+ # For more information about components, see [Proton components][1] in
2078
+ # the *Proton Administrator Guide*.
2079
+ #
2080
+ #
2081
+ #
2082
+ # [1]: https://docs.aws.amazon.com/proton/latest/adminguide/ag-components.html
1621
2083
  # @return [String]
1622
2084
  #
1623
2085
  # @!attribute [rw] created_at
@@ -1684,6 +2146,7 @@ module Aws::Proton
1684
2146
  #
1685
2147
  class EnvironmentSummary < Struct.new(
1686
2148
  :arn,
2149
+ :component_role_arn,
1687
2150
  :created_at,
1688
2151
  :deployment_status,
1689
2152
  :deployment_status_message,
@@ -1984,6 +2447,38 @@ module Aws::Proton
1984
2447
  include Aws::Structure
1985
2448
  end
1986
2449
 
2450
+ # @note When making an API call, you may pass GetComponentInput
2451
+ # data as a hash:
2452
+ #
2453
+ # {
2454
+ # name: "ResourceName", # required
2455
+ # }
2456
+ #
2457
+ # @!attribute [rw] name
2458
+ # The name of the component that you want to get the detailed data
2459
+ # for.
2460
+ # @return [String]
2461
+ #
2462
+ # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/GetComponentInput AWS API Documentation
2463
+ #
2464
+ class GetComponentInput < Struct.new(
2465
+ :name)
2466
+ SENSITIVE = []
2467
+ include Aws::Structure
2468
+ end
2469
+
2470
+ # @!attribute [rw] component
2471
+ # The detailed data of the requested component.
2472
+ # @return [Types::Component]
2473
+ #
2474
+ # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/GetComponentOutput AWS API Documentation
2475
+ #
2476
+ class GetComponentOutput < Struct.new(
2477
+ :component)
2478
+ SENSITIVE = []
2479
+ include Aws::Structure
2480
+ end
2481
+
1987
2482
  # @note When making an API call, you may pass GetEnvironmentAccountConnectionInput
1988
2483
  # data as a hash:
1989
2484
  #
@@ -1992,7 +2487,8 @@ module Aws::Proton
1992
2487
  # }
1993
2488
  #
1994
2489
  # @!attribute [rw] id
1995
- # The ID of the environment account connection.
2490
+ # The ID of the environment account connection that you want to get
2491
+ # the detailed data for.
1996
2492
  # @return [String]
1997
2493
  #
1998
2494
  # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/GetEnvironmentAccountConnectionInput AWS API Documentation
@@ -2004,8 +2500,7 @@ module Aws::Proton
2004
2500
  end
2005
2501
 
2006
2502
  # @!attribute [rw] environment_account_connection
2007
- # The environment account connection detail data that's returned by
2008
- # Proton.
2503
+ # The detailed data of the requested environment account connection.
2009
2504
  # @return [Types::EnvironmentAccountConnection]
2010
2505
  #
2011
2506
  # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/GetEnvironmentAccountConnectionOutput AWS API Documentation
@@ -2024,7 +2519,7 @@ module Aws::Proton
2024
2519
  # }
2025
2520
  #
2026
2521
  # @!attribute [rw] name
2027
- # The name of the environment that you want to get the detail data
2522
+ # The name of the environment that you want to get the detailed data
2028
2523
  # for.
2029
2524
  # @return [String]
2030
2525
  #
@@ -2037,7 +2532,7 @@ module Aws::Proton
2037
2532
  end
2038
2533
 
2039
2534
  # @!attribute [rw] environment
2040
- # The environment detail data that's returned by Proton.
2535
+ # The detailed data of the requested environment.
2041
2536
  # @return [Types::Environment]
2042
2537
  #
2043
2538
  # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/GetEnvironmentOutput AWS API Documentation
@@ -2056,8 +2551,8 @@ module Aws::Proton
2056
2551
  # }
2057
2552
  #
2058
2553
  # @!attribute [rw] name
2059
- # The name of the environment template that you want to get the detail
2060
- # data for.
2554
+ # The name of the environment template that you want to get the
2555
+ # detailed data for.
2061
2556
  # @return [String]
2062
2557
  #
2063
2558
  # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/GetEnvironmentTemplateInput AWS API Documentation
@@ -2069,7 +2564,7 @@ module Aws::Proton
2069
2564
  end
2070
2565
 
2071
2566
  # @!attribute [rw] environment_template
2072
- # The environment template detail data that's returned by Proton.
2567
+ # The detailed data of the requested environment template.
2073
2568
  # @return [Types::EnvironmentTemplate]
2074
2569
  #
2075
2570
  # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/GetEnvironmentTemplateOutput AWS API Documentation
@@ -2090,17 +2585,18 @@ module Aws::Proton
2090
2585
  # }
2091
2586
  #
2092
2587
  # @!attribute [rw] major_version
2093
- # To view environment template major version detail data, include
2588
+ # To get environment template major version detail data, include
2094
2589
  # `major Version`.
2095
2590
  # @return [String]
2096
2591
  #
2097
2592
  # @!attribute [rw] minor_version
2098
- # To view environment template minor version detail data, include
2593
+ # To get environment template minor version detail data, include
2099
2594
  # `minorVersion`.
2100
2595
  # @return [String]
2101
2596
  #
2102
2597
  # @!attribute [rw] template_name
2103
- # The name of the environment template.
2598
+ # The name of the environment template a version of which you want to
2599
+ # get detailed data for..
2104
2600
  # @return [String]
2105
2601
  #
2106
2602
  # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/GetEnvironmentTemplateVersionInput AWS API Documentation
@@ -2114,8 +2610,7 @@ module Aws::Proton
2114
2610
  end
2115
2611
 
2116
2612
  # @!attribute [rw] environment_template_version
2117
- # The environment template version detail data that's returned by
2118
- # Proton.
2613
+ # The detailed data of the requested environment template version.
2119
2614
  # @return [Types::EnvironmentTemplateVersion]
2120
2615
  #
2121
2616
  # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/GetEnvironmentTemplateVersionOutput AWS API Documentation
@@ -2220,7 +2715,7 @@ module Aws::Proton
2220
2715
  # }
2221
2716
  #
2222
2717
  # @!attribute [rw] name
2223
- # The name of the service that you want to get the detail data for.
2718
+ # The name of the service that you want to get the detailed data for.
2224
2719
  # @return [String]
2225
2720
  #
2226
2721
  # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/GetServiceInput AWS API Documentation
@@ -2240,8 +2735,8 @@ module Aws::Proton
2240
2735
  # }
2241
2736
  #
2242
2737
  # @!attribute [rw] name
2243
- # The name of a service instance that you want to get the detail data
2244
- # for.
2738
+ # The name of a service instance that you want to get the detailed
2739
+ # data for.
2245
2740
  # @return [String]
2246
2741
  #
2247
2742
  # @!attribute [rw] service_name
@@ -2258,7 +2753,7 @@ module Aws::Proton
2258
2753
  end
2259
2754
 
2260
2755
  # @!attribute [rw] service_instance
2261
- # The service instance detail data that's returned by Proton.
2756
+ # The detailed data of the requested service instance.
2262
2757
  # @return [Types::ServiceInstance]
2263
2758
  #
2264
2759
  # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/GetServiceInstanceOutput AWS API Documentation
@@ -2270,7 +2765,7 @@ module Aws::Proton
2270
2765
  end
2271
2766
 
2272
2767
  # @!attribute [rw] service
2273
- # The service detail data that's returned by Proton.
2768
+ # The detailed data of the requested service.
2274
2769
  # @return [Types::Service]
2275
2770
  #
2276
2771
  # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/GetServiceOutput AWS API Documentation
@@ -2289,7 +2784,7 @@ module Aws::Proton
2289
2784
  # }
2290
2785
  #
2291
2786
  # @!attribute [rw] name
2292
- # The name of the service template that you want to get detail data
2787
+ # The name of the service template that you want to get detailed data
2293
2788
  # for.
2294
2789
  # @return [String]
2295
2790
  #
@@ -2302,7 +2797,7 @@ module Aws::Proton
2302
2797
  end
2303
2798
 
2304
2799
  # @!attribute [rw] service_template
2305
- # The service template detail data that's returned by Proton.
2800
+ # The detailed data of the requested service template.
2306
2801
  # @return [Types::ServiceTemplate]
2307
2802
  #
2308
2803
  # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/GetServiceTemplateOutput AWS API Documentation
@@ -2323,17 +2818,18 @@ module Aws::Proton
2323
2818
  # }
2324
2819
  #
2325
2820
  # @!attribute [rw] major_version
2326
- # To view service template major version detail data, include `major
2821
+ # To get service template major version detail data, include `major
2327
2822
  # Version`.
2328
2823
  # @return [String]
2329
2824
  #
2330
2825
  # @!attribute [rw] minor_version
2331
- # To view service template minor version detail data, include
2826
+ # To get service template minor version detail data, include
2332
2827
  # `minorVersion`.
2333
2828
  # @return [String]
2334
2829
  #
2335
2830
  # @!attribute [rw] template_name
2336
- # The name of the service template.
2831
+ # The name of the service template a version of which you want to get
2832
+ # detailed data for.
2337
2833
  # @return [String]
2338
2834
  #
2339
2835
  # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/GetServiceTemplateVersionInput AWS API Documentation
@@ -2347,7 +2843,7 @@ module Aws::Proton
2347
2843
  end
2348
2844
 
2349
2845
  # @!attribute [rw] service_template_version
2350
- # The service template version detail data that's returned by Proton.
2846
+ # The detailed data of the requested service template version.
2351
2847
  # @return [Types::ServiceTemplateVersion]
2352
2848
  #
2353
2849
  # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/GetServiceTemplateVersionOutput AWS API Documentation
@@ -2462,6 +2958,163 @@ module Aws::Proton
2462
2958
  include Aws::Structure
2463
2959
  end
2464
2960
 
2961
+ # @note When making an API call, you may pass ListComponentOutputsInput
2962
+ # data as a hash:
2963
+ #
2964
+ # {
2965
+ # component_name: "ResourceName", # required
2966
+ # next_token: "EmptyNextToken",
2967
+ # }
2968
+ #
2969
+ # @!attribute [rw] component_name
2970
+ # The name of the component whose outputs you want.
2971
+ # @return [String]
2972
+ #
2973
+ # @!attribute [rw] next_token
2974
+ # A token that indicates the location of the next output in the array
2975
+ # of outputs, after the list of outputs that was previously requested.
2976
+ # @return [String]
2977
+ #
2978
+ # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/ListComponentOutputsInput AWS API Documentation
2979
+ #
2980
+ class ListComponentOutputsInput < Struct.new(
2981
+ :component_name,
2982
+ :next_token)
2983
+ SENSITIVE = []
2984
+ include Aws::Structure
2985
+ end
2986
+
2987
+ # @!attribute [rw] next_token
2988
+ # A token that indicates the location of the next output in the array
2989
+ # of outputs, after the list of outputs that was previously requested.
2990
+ # @return [String]
2991
+ #
2992
+ # @!attribute [rw] outputs
2993
+ # An array of component Infrastructure as Code (IaC) outputs.
2994
+ # @return [Array<Types::Output>]
2995
+ #
2996
+ # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/ListComponentOutputsOutput AWS API Documentation
2997
+ #
2998
+ class ListComponentOutputsOutput < Struct.new(
2999
+ :next_token,
3000
+ :outputs)
3001
+ SENSITIVE = []
3002
+ include Aws::Structure
3003
+ end
3004
+
3005
+ # @note When making an API call, you may pass ListComponentProvisionedResourcesInput
3006
+ # data as a hash:
3007
+ #
3008
+ # {
3009
+ # component_name: "ResourceName", # required
3010
+ # next_token: "EmptyNextToken",
3011
+ # }
3012
+ #
3013
+ # @!attribute [rw] component_name
3014
+ # The name of the component whose provisioned resources you want.
3015
+ # @return [String]
3016
+ #
3017
+ # @!attribute [rw] next_token
3018
+ # A token that indicates the location of the next provisioned resource
3019
+ # in the array of provisioned resources, after the list of provisioned
3020
+ # resources that was previously requested.
3021
+ # @return [String]
3022
+ #
3023
+ # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/ListComponentProvisionedResourcesInput AWS API Documentation
3024
+ #
3025
+ class ListComponentProvisionedResourcesInput < Struct.new(
3026
+ :component_name,
3027
+ :next_token)
3028
+ SENSITIVE = []
3029
+ include Aws::Structure
3030
+ end
3031
+
3032
+ # @!attribute [rw] next_token
3033
+ # A token that indicates the location of the next provisioned resource
3034
+ # in the array of provisioned resources, after the current requested
3035
+ # list of provisioned resources.
3036
+ # @return [String]
3037
+ #
3038
+ # @!attribute [rw] provisioned_resources
3039
+ # An array of provisioned resources for a component.
3040
+ # @return [Array<Types::ProvisionedResource>]
3041
+ #
3042
+ # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/ListComponentProvisionedResourcesOutput AWS API Documentation
3043
+ #
3044
+ class ListComponentProvisionedResourcesOutput < Struct.new(
3045
+ :next_token,
3046
+ :provisioned_resources)
3047
+ SENSITIVE = []
3048
+ include Aws::Structure
3049
+ end
3050
+
3051
+ # @note When making an API call, you may pass ListComponentsInput
3052
+ # data as a hash:
3053
+ #
3054
+ # {
3055
+ # environment_name: "ResourceName",
3056
+ # max_results: 1,
3057
+ # next_token: "NextToken",
3058
+ # service_instance_name: "ResourceName",
3059
+ # service_name: "ResourceName",
3060
+ # }
3061
+ #
3062
+ # @!attribute [rw] environment_name
3063
+ # The name of an environment for result list filtering. Proton returns
3064
+ # components associated with the environment or attached to service
3065
+ # instances running in it.
3066
+ # @return [String]
3067
+ #
3068
+ # @!attribute [rw] max_results
3069
+ # The maximum number of components to list.
3070
+ # @return [Integer]
3071
+ #
3072
+ # @!attribute [rw] next_token
3073
+ # A token that indicates the location of the next component in the
3074
+ # array of components, after the list of components that was
3075
+ # previously requested.
3076
+ # @return [String]
3077
+ #
3078
+ # @!attribute [rw] service_instance_name
3079
+ # The name of a service instance for result list filtering. Proton
3080
+ # returns the component attached to the service instance, if any.
3081
+ # @return [String]
3082
+ #
3083
+ # @!attribute [rw] service_name
3084
+ # The name of a service for result list filtering. Proton returns
3085
+ # components attached to service instances of the service.
3086
+ # @return [String]
3087
+ #
3088
+ # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/ListComponentsInput AWS API Documentation
3089
+ #
3090
+ class ListComponentsInput < Struct.new(
3091
+ :environment_name,
3092
+ :max_results,
3093
+ :next_token,
3094
+ :service_instance_name,
3095
+ :service_name)
3096
+ SENSITIVE = []
3097
+ include Aws::Structure
3098
+ end
3099
+
3100
+ # @!attribute [rw] components
3101
+ # An array of components with summary data.
3102
+ # @return [Array<Types::ComponentSummary>]
3103
+ #
3104
+ # @!attribute [rw] next_token
3105
+ # A token that indicates the location of the next component in the
3106
+ # array of components, after the current requested list of components.
3107
+ # @return [String]
3108
+ #
3109
+ # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/ListComponentsOutput AWS API Documentation
3110
+ #
3111
+ class ListComponentsOutput < Struct.new(
3112
+ :components,
3113
+ :next_token)
3114
+ SENSITIVE = []
3115
+ include Aws::Structure
3116
+ end
3117
+
2465
3118
  # @note When making an API call, you may pass ListEnvironmentAccountConnectionsInput
2466
3119
  # data as a hash:
2467
3120
  #
@@ -2911,11 +3564,11 @@ module Aws::Proton
2911
3564
  # @return [String]
2912
3565
  #
2913
3566
  # @!attribute [rw] service_instance_name
2914
- # The service instance name.
3567
+ # The name of the service instance whose outputs you want.
2915
3568
  # @return [String]
2916
3569
  #
2917
3570
  # @!attribute [rw] service_name
2918
- # The service name.
3571
+ # The name of the service that `serviceInstanceName` is associated to.
2919
3572
  # @return [String]
2920
3573
  #
2921
3574
  # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/ListServiceInstanceOutputsInput AWS API Documentation
@@ -2934,7 +3587,7 @@ module Aws::Proton
2934
3587
  # @return [String]
2935
3588
  #
2936
3589
  # @!attribute [rw] outputs
2937
- # An array of service instance infrastructure as code outputs.
3590
+ # An array of service instance Infrastructure as Code (IaC) outputs.
2938
3591
  # @return [Array<Types::Output>]
2939
3592
  #
2940
3593
  # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/ListServiceInstanceOutputsOutput AWS API Documentation
@@ -2962,11 +3615,12 @@ module Aws::Proton
2962
3615
  # @return [String]
2963
3616
  #
2964
3617
  # @!attribute [rw] service_instance_name
2965
- # The service instance name.
3618
+ # The name of the service instance whose provisioned resources you
3619
+ # want.
2966
3620
  # @return [String]
2967
3621
  #
2968
3622
  # @!attribute [rw] service_name
2969
- # The service name.
3623
+ # The name of the service that `serviceInstanceName` is associated to.
2970
3624
  # @return [String]
2971
3625
  #
2972
3626
  # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/ListServiceInstanceProvisionedResourcesInput AWS API Documentation
@@ -3038,7 +3692,7 @@ module Aws::Proton
3038
3692
  # @return [String]
3039
3693
  #
3040
3694
  # @!attribute [rw] service_instances
3041
- # An array of service instances with summaries of detail data.
3695
+ # An array of service instances with summary data.
3042
3696
  # @return [Array<Types::ServiceInstanceSummary>]
3043
3697
  #
3044
3698
  # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/ListServiceInstancesOutput AWS API Documentation
@@ -3064,7 +3718,7 @@ module Aws::Proton
3064
3718
  # @return [String]
3065
3719
  #
3066
3720
  # @!attribute [rw] service_name
3067
- # The service name.
3721
+ # The name of the service whose pipeline's outputs you want.
3068
3722
  # @return [String]
3069
3723
  #
3070
3724
  # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/ListServicePipelineOutputsInput AWS API Documentation
@@ -3082,7 +3736,7 @@ module Aws::Proton
3082
3736
  # @return [String]
3083
3737
  #
3084
3738
  # @!attribute [rw] outputs
3085
- # An array of outputs.
3739
+ # An array of service pipeline Infrastructure as Code (IaC) outputs.
3086
3740
  # @return [Array<Types::Output>]
3087
3741
  #
3088
3742
  # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/ListServicePipelineOutputsOutput AWS API Documentation
@@ -3109,7 +3763,8 @@ module Aws::Proton
3109
3763
  # @return [String]
3110
3764
  #
3111
3765
  # @!attribute [rw] service_name
3112
- # The service name.
3766
+ # The name of the service whose pipeline's provisioned resources you
3767
+ # want.
3113
3768
  # @return [String]
3114
3769
  #
3115
3770
  # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/ListServicePipelineProvisionedResourcesInput AWS API Documentation
@@ -3362,7 +4017,7 @@ module Aws::Proton
3362
4017
  # ],
3363
4018
  # resource_arn: "Arn", # required
3364
4019
  # status: "IN_PROGRESS", # required, accepts IN_PROGRESS, FAILED, SUCCEEDED
3365
- # status_message: "SyntheticNotifyResourceDeploymentStatusChangeInputString",
4020
+ # status_message: "NotifyResourceDeploymentStatusChangeInputStatusMessageString",
3366
4021
  # }
3367
4022
  #
3368
4023
  # @!attribute [rw] deployment_id
@@ -3494,7 +4149,7 @@ module Aws::Proton
3494
4149
  include Aws::Structure
3495
4150
  end
3496
4151
 
3497
- # Detail date for a repository that has been registered with Proton.
4152
+ # Detailed data of a repository that has been registered with Proton.
3498
4153
  #
3499
4154
  # @!attribute [rw] arn
3500
4155
  # The repository Amazon Resource Name (ARN).
@@ -3591,7 +4246,7 @@ module Aws::Proton
3591
4246
  include Aws::Structure
3592
4247
  end
3593
4248
 
3594
- # A summary of detail data for a registered repository.
4249
+ # Summary data of a repository that has been registered with Proton.
3595
4250
  #
3596
4251
  # @!attribute [rw] arn
3597
4252
  # The Amazon Resource Name (ARN) for a repository.
@@ -3843,7 +4498,7 @@ module Aws::Proton
3843
4498
  include Aws::Structure
3844
4499
  end
3845
4500
 
3846
- # The service detail data.
4501
+ # Detailed data of an Proton service resource.
3847
4502
  #
3848
4503
  # @!attribute [rw] arn
3849
4504
  # The Amazon Resource Name (ARN) of the service.
@@ -3859,7 +4514,7 @@ module Aws::Proton
3859
4514
  # @return [Time]
3860
4515
  #
3861
4516
  # @!attribute [rw] description
3862
- # A description of a service.
4517
+ # A description of the service.
3863
4518
  # @return [String]
3864
4519
  #
3865
4520
  # @!attribute [rw] last_modified_at
@@ -3926,7 +4581,7 @@ module Aws::Proton
3926
4581
  include Aws::Structure
3927
4582
  end
3928
4583
 
3929
- # The service instance detail data.
4584
+ # Detailed data of an Proton service instance resource.
3930
4585
  #
3931
4586
  # @!attribute [rw] arn
3932
4587
  # The Amazon Resource Name (ARN) of the service instance.
@@ -3941,7 +4596,7 @@ module Aws::Proton
3941
4596
  # @return [String]
3942
4597
  #
3943
4598
  # @!attribute [rw] deployment_status_message
3944
- # A service instance deployment status message.
4599
+ # The message associated with the service instance deployment status.
3945
4600
  # @return [String]
3946
4601
  #
3947
4602
  # @!attribute [rw] environment_name
@@ -4005,7 +4660,7 @@ module Aws::Proton
4005
4660
  include Aws::Structure
4006
4661
  end
4007
4662
 
4008
- # A summary of the service instance detail data.
4663
+ # Summary data of an Proton service instance resource.
4009
4664
  #
4010
4665
  # @!attribute [rw] arn
4011
4666
  # The Amazon Resource Name (ARN) of the service instance.
@@ -4075,7 +4730,7 @@ module Aws::Proton
4075
4730
  include Aws::Structure
4076
4731
  end
4077
4732
 
4078
- # The service pipeline detail data.
4733
+ # Detailed data of an Proton service instance pipeline resource.
4079
4734
  #
4080
4735
  # @!attribute [rw] arn
4081
4736
  # The Amazon Resource Name (ARN) of the service pipeline.
@@ -4156,7 +4811,7 @@ module Aws::Proton
4156
4811
  include Aws::Structure
4157
4812
  end
4158
4813
 
4159
- # A summary of the service detail data.
4814
+ # Summary data of an Proton service resource.
4160
4815
  #
4161
4816
  # @!attribute [rw] arn
4162
4817
  # The Amazon Resource Name (ARN) of the service.
@@ -4205,7 +4860,7 @@ module Aws::Proton
4205
4860
  include Aws::Structure
4206
4861
  end
4207
4862
 
4208
- # The service template detail data.
4863
+ # Detailed data of an Proton service template resource.
4209
4864
  #
4210
4865
  # @!attribute [rw] arn
4211
4866
  # The Amazon Resource Name (ARN) of the service template.
@@ -4262,7 +4917,7 @@ module Aws::Proton
4262
4917
  include Aws::Structure
4263
4918
  end
4264
4919
 
4265
- # The service template summary data.
4920
+ # Summary data of an Proton service template resource.
4266
4921
  #
4267
4922
  # @!attribute [rw] arn
4268
4923
  # The Amazon Resource Name (ARN) of the service template.
@@ -4313,7 +4968,7 @@ module Aws::Proton
4313
4968
  include Aws::Structure
4314
4969
  end
4315
4970
 
4316
- # The version of a service template detail data.
4971
+ # Detailed data of an Proton service template version resource.
4317
4972
  #
4318
4973
  # @!attribute [rw] arn
4319
4974
  # The Amazon Resource Name (ARN) of the version of a service template.
@@ -4361,6 +5016,19 @@ module Aws::Proton
4361
5016
  # A service template version status message.
4362
5017
  # @return [String]
4363
5018
  #
5019
+ # @!attribute [rw] supported_component_sources
5020
+ # An array of supported component sources. Components with supported
5021
+ # sources can be attached to service instances based on this service
5022
+ # template version.
5023
+ #
5024
+ # For more information about components, see [Proton components][1] in
5025
+ # the *Proton Administrator Guide*.
5026
+ #
5027
+ #
5028
+ #
5029
+ # [1]: https://docs.aws.amazon.com/proton/latest/adminguide/ag-components.html
5030
+ # @return [Array<String>]
5031
+ #
4364
5032
  # @!attribute [rw] template_name
4365
5033
  # The name of the version of a service template.
4366
5034
  # @return [String]
@@ -4379,12 +5047,13 @@ module Aws::Proton
4379
5047
  :schema,
4380
5048
  :status,
4381
5049
  :status_message,
5050
+ :supported_component_sources,
4382
5051
  :template_name)
4383
5052
  SENSITIVE = [:description, :schema, :status_message]
4384
5053
  include Aws::Structure
4385
5054
  end
4386
5055
 
4387
- # A summary of the service template version detail data.
5056
+ # Summary data of an Proton service template version resource.
4388
5057
  #
4389
5058
  # @!attribute [rw] arn
4390
5059
  # The Amazon Resource Name (ARN) of the version of a service template.
@@ -4658,14 +5327,135 @@ module Aws::Proton
4658
5327
  include Aws::Structure
4659
5328
  end
4660
5329
 
5330
+ # @note When making an API call, you may pass UpdateComponentInput
5331
+ # data as a hash:
5332
+ #
5333
+ # {
5334
+ # deployment_type: "NONE", # required, accepts NONE, CURRENT_VERSION
5335
+ # description: "Description",
5336
+ # name: "ResourceName", # required
5337
+ # service_instance_name: "ResourceNameOrEmpty",
5338
+ # service_name: "ResourceNameOrEmpty",
5339
+ # service_spec: "SpecContents",
5340
+ # template_file: "TemplateFileContents",
5341
+ # }
5342
+ #
5343
+ # @!attribute [rw] deployment_type
5344
+ # The deployment type. It defines the mode for updating a component,
5345
+ # as follows:
5346
+ #
5347
+ #
5348
+ #
5349
+ # : `NONE`
5350
+ #
5351
+ # In this mode, a deployment *doesn't* occur. Only the requested
5352
+ # metadata parameters are updated. You can only specify
5353
+ # `description` in this mode.
5354
+ #
5355
+ #
5356
+ #
5357
+ # : `CURRENT_VERSION`
5358
+ #
5359
+ # In this mode, the component is deployed and updated with the new
5360
+ # `serviceSpec`, `templateSource`, and/or `type` that you provide.
5361
+ # Only requested parameters are updated.
5362
+ # @return [String]
5363
+ #
5364
+ # @!attribute [rw] description
5365
+ # An optional customer-provided description of the component.
5366
+ # @return [String]
5367
+ #
5368
+ # @!attribute [rw] name
5369
+ # The name of the component to update.
5370
+ # @return [String]
5371
+ #
5372
+ # @!attribute [rw] service_instance_name
5373
+ # The name of the service instance that you want to attach this
5374
+ # component to. Don't specify to keep the component's current
5375
+ # service instance attachment. Specify an empty string to detach the
5376
+ # component from the service instance it's attached to. Specify
5377
+ # non-empty values for both `serviceInstanceName` and `serviceName` or
5378
+ # for neither of them.
5379
+ # @return [String]
5380
+ #
5381
+ # @!attribute [rw] service_name
5382
+ # The name of the service that `serviceInstanceName` is associated
5383
+ # with. Don't specify to keep the component's current service
5384
+ # instance attachment. Specify an empty string to detach the component
5385
+ # from the service instance it's attached to. Specify non-empty
5386
+ # values for both `serviceInstanceName` and `serviceName` or for
5387
+ # neither of them.
5388
+ # @return [String]
5389
+ #
5390
+ # @!attribute [rw] service_spec
5391
+ # The service spec that you want the component to use to access
5392
+ # service inputs. Set this only when the component is attached to a
5393
+ # service instance.
5394
+ # @return [String]
5395
+ #
5396
+ # @!attribute [rw] template_file
5397
+ # A path to the Infrastructure as Code (IaC) file describing
5398
+ # infrastructure that a custom component provisions.
5399
+ #
5400
+ # <note markdown="1"> Components support a single IaC file, even if you use Terraform as
5401
+ # your template language.
5402
+ #
5403
+ # </note>
5404
+ # @return [String]
5405
+ #
5406
+ # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/UpdateComponentInput AWS API Documentation
5407
+ #
5408
+ class UpdateComponentInput < Struct.new(
5409
+ :deployment_type,
5410
+ :description,
5411
+ :name,
5412
+ :service_instance_name,
5413
+ :service_name,
5414
+ :service_spec,
5415
+ :template_file)
5416
+ SENSITIVE = [:description, :service_spec, :template_file]
5417
+ include Aws::Structure
5418
+ end
5419
+
5420
+ # @!attribute [rw] component
5421
+ # The detailed data of the updated component.
5422
+ # @return [Types::Component]
5423
+ #
5424
+ # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/UpdateComponentOutput AWS API Documentation
5425
+ #
5426
+ class UpdateComponentOutput < Struct.new(
5427
+ :component)
5428
+ SENSITIVE = []
5429
+ include Aws::Structure
5430
+ end
5431
+
4661
5432
  # @note When making an API call, you may pass UpdateEnvironmentAccountConnectionInput
4662
5433
  # data as a hash:
4663
5434
  #
4664
5435
  # {
5436
+ # component_role_arn: "Arn",
4665
5437
  # id: "EnvironmentAccountConnectionId", # required
4666
- # role_arn: "Arn", # required
5438
+ # role_arn: "Arn",
4667
5439
  # }
4668
5440
  #
5441
+ # @!attribute [rw] component_role_arn
5442
+ # The Amazon Resource Name (ARN) of the IAM service role that Proton
5443
+ # uses when provisioning directly defined components in the associated
5444
+ # environment account. It determines the scope of infrastructure that
5445
+ # a component can provision in the account.
5446
+ #
5447
+ # The environment account connection must have a `componentRoleArn` to
5448
+ # allow directly defined components to be associated with any
5449
+ # environments running in the account.
5450
+ #
5451
+ # For more information about components, see [Proton components][1] in
5452
+ # the *Proton Administrator Guide*.
5453
+ #
5454
+ #
5455
+ #
5456
+ # [1]: https://docs.aws.amazon.com/proton/latest/adminguide/ag-components.html
5457
+ # @return [String]
5458
+ #
4669
5459
  # @!attribute [rw] id
4670
5460
  # The ID of the environment account connection to update.
4671
5461
  # @return [String]
@@ -4678,6 +5468,7 @@ module Aws::Proton
4678
5468
  # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/UpdateEnvironmentAccountConnectionInput AWS API Documentation
4679
5469
  #
4680
5470
  class UpdateEnvironmentAccountConnectionInput < Struct.new(
5471
+ :component_role_arn,
4681
5472
  :id,
4682
5473
  :role_arn)
4683
5474
  SENSITIVE = []
@@ -4701,6 +5492,7 @@ module Aws::Proton
4701
5492
  # data as a hash:
4702
5493
  #
4703
5494
  # {
5495
+ # component_role_arn: "Arn",
4704
5496
  # deployment_type: "NONE", # required, accepts NONE, CURRENT_VERSION, MINOR_VERSION, MAJOR_VERSION
4705
5497
  # description: "Description",
4706
5498
  # environment_account_connection_id: "EnvironmentAccountConnectionId",
@@ -4716,6 +5508,23 @@ module Aws::Proton
4716
5508
  # template_minor_version: "TemplateVersionPart",
4717
5509
  # }
4718
5510
  #
5511
+ # @!attribute [rw] component_role_arn
5512
+ # The Amazon Resource Name (ARN) of the IAM service role that Proton
5513
+ # uses when provisioning directly defined components in this
5514
+ # environment. It determines the scope of infrastructure that a
5515
+ # component can provision.
5516
+ #
5517
+ # The environment must have a `componentRoleArn` to allow directly
5518
+ # defined components to be associated with the environment.
5519
+ #
5520
+ # For more information about components, see [Proton components][1] in
5521
+ # the *Proton Administrator Guide*.
5522
+ #
5523
+ #
5524
+ #
5525
+ # [1]: https://docs.aws.amazon.com/proton/latest/adminguide/ag-components.html
5526
+ # @return [String]
5527
+ #
4719
5528
  # @!attribute [rw] deployment_type
4720
5529
  # There are four modes for updating an environment. The
4721
5530
  # `deploymentType` field defines the mode.
@@ -4798,6 +5607,7 @@ module Aws::Proton
4798
5607
  # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/UpdateEnvironmentInput AWS API Documentation
4799
5608
  #
4800
5609
  class UpdateEnvironmentInput < Struct.new(
5610
+ :component_role_arn,
4801
5611
  :deployment_type,
4802
5612
  :description,
4803
5613
  :environment_account_connection_id,
@@ -4978,10 +5788,8 @@ module Aws::Proton
4978
5788
  # }
4979
5789
  #
4980
5790
  # @!attribute [rw] deployment_type
4981
- # The deployment type.
4982
- #
4983
- # There are four modes for updating a service instance. The
4984
- # `deploymentType` field defines the mode.
5791
+ # The deployment type. It defines the mode for updating a service
5792
+ # instance, as follows:
4985
5793
  #
4986
5794
  #
4987
5795
  #
@@ -4997,7 +5805,7 @@ module Aws::Proton
4997
5805
  # In this mode, the service instance is deployed and updated with
4998
5806
  # the new spec that you provide. Only requested parameters are
4999
5807
  # updated. *Don’t* include major or minor version parameters when
5000
- # you use this `deployment-type`.
5808
+ # you use this deployment type.
5001
5809
  #
5002
5810
  #
5003
5811
  #
@@ -5230,12 +6038,15 @@ module Aws::Proton
5230
6038
  # major_version: "TemplateVersionPart", # required
5231
6039
  # minor_version: "TemplateVersionPart", # required
5232
6040
  # status: "REGISTRATION_IN_PROGRESS", # accepts REGISTRATION_IN_PROGRESS, REGISTRATION_FAILED, DRAFT, PUBLISHED
6041
+ # supported_component_sources: ["DIRECTLY_DEFINED"], # accepts DIRECTLY_DEFINED
5233
6042
  # template_name: "ResourceName", # required
5234
6043
  # }
5235
6044
  #
5236
6045
  # @!attribute [rw] compatible_environment_templates
5237
- # An array of compatible environment names for a service template
5238
- # major or minor version to update.
6046
+ # An array of environment template objects that are compatible with
6047
+ # this service template version. A service instance based on this
6048
+ # service template version can run in environments based on compatible
6049
+ # templates.
5239
6050
  # @return [Array<Types::CompatibleEnvironmentTemplateInput>]
5240
6051
  #
5241
6052
  # @!attribute [rw] description
@@ -5256,6 +6067,25 @@ module Aws::Proton
5256
6067
  # The status of the service template minor version to update.
5257
6068
  # @return [String]
5258
6069
  #
6070
+ # @!attribute [rw] supported_component_sources
6071
+ # An array of supported component sources. Components with supported
6072
+ # sources can be attached to service instances based on this service
6073
+ # template version.
6074
+ #
6075
+ # <note markdown="1"> A change to `supportedComponentSources` doesn't impact existing
6076
+ # component attachments to instances based on this template version. A
6077
+ # change only affects later associations.
6078
+ #
6079
+ # </note>
6080
+ #
6081
+ # For more information about components, see [Proton components][1] in
6082
+ # the *Proton Administrator Guide*.
6083
+ #
6084
+ #
6085
+ #
6086
+ # [1]: https://docs.aws.amazon.com/proton/latest/adminguide/ag-components.html
6087
+ # @return [Array<String>]
6088
+ #
5259
6089
  # @!attribute [rw] template_name
5260
6090
  # The name of the service template.
5261
6091
  # @return [String]
@@ -5268,6 +6098,7 @@ module Aws::Proton
5268
6098
  :major_version,
5269
6099
  :minor_version,
5270
6100
  :status,
6101
+ :supported_component_sources,
5271
6102
  :template_name)
5272
6103
  SENSITIVE = [:description]
5273
6104
  include Aws::Structure