aws-sdk-proton 1.12.0 → 1.15.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -27,7 +27,9 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
27
27
  require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
28
28
  require 'aws-sdk-core/plugins/transfer_encoding.rb'
29
29
  require 'aws-sdk-core/plugins/http_checksum.rb'
30
+ require 'aws-sdk-core/plugins/checksum_algorithm.rb'
30
31
  require 'aws-sdk-core/plugins/defaults_mode.rb'
32
+ require 'aws-sdk-core/plugins/recursion_detection.rb'
31
33
  require 'aws-sdk-core/plugins/signature_v4.rb'
32
34
  require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
33
35
 
@@ -74,7 +76,9 @@ module Aws::Proton
74
76
  add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
75
77
  add_plugin(Aws::Plugins::TransferEncoding)
76
78
  add_plugin(Aws::Plugins::HttpChecksum)
79
+ add_plugin(Aws::Plugins::ChecksumAlgorithm)
77
80
  add_plugin(Aws::Plugins::DefaultsMode)
81
+ add_plugin(Aws::Plugins::RecursionDetection)
78
82
  add_plugin(Aws::Plugins::SignatureV4)
79
83
  add_plugin(Aws::Plugins::Protocols::JsonRpc)
80
84
 
@@ -597,19 +601,20 @@ module Aws::Proton
597
601
  #
598
602
  # **You can provision environments using the following methods:**
599
603
  #
600
- # * Standard provisioning: Proton makes direct calls to provision your
601
- # resources.
604
+ # * Amazon Web Services-managed provisioning: Proton makes direct calls
605
+ # to provision your resources.
602
606
  #
603
- # * Pull request provisioning: Proton makes pull requests on your
607
+ # * Self-managed provisioning: Proton makes pull requests on your
604
608
  # repository to provide compiled infrastructure as code (IaC) files
605
609
  # that your IaC engine uses to provision resources.
606
610
  #
607
- # For more information, see the [Environments][1] in the *Proton
608
- # Administrator Guide.*
611
+ # For more information, see [Environments][1] and [Provisioning
612
+ # methods][2] in the *Proton Administrator Guide*.
609
613
  #
610
614
  #
611
615
  #
612
616
  # [1]: https://docs.aws.amazon.com/proton/latest/adminguide/ag-environments.html
617
+ # [2]: https://docs.aws.amazon.com/proton/latest/adminguide/ag-works-prov-methods.html
613
618
  #
614
619
  # @option params [String] :description
615
620
  # A description of the environment that's being created and deployed.
@@ -617,11 +622,13 @@ module Aws::Proton
617
622
  # @option params [String] :environment_account_connection_id
618
623
  # The ID of the environment account connection that you provide if
619
624
  # you're provisioning your environment infrastructure resources to an
620
- # environment account. You must include either the
621
- # `environmentAccountConnectionId` or `protonServiceRoleArn` parameter
622
- # and value and omit the `provisioningRepository` parameter and values.
623
- # For more information, see [Environment account connections][1] in the
624
- # *Proton Administrator guide*.
625
+ # environment account. For more information, see [Environment account
626
+ # connections][1] in the *Proton Administrator guide*.
627
+ #
628
+ # To use Amazon Web Services-managed provisioning for the environment,
629
+ # specify either the `environmentAccountConnectionId` or
630
+ # `protonServiceRoleArn` parameter and omit the `provisioningRepository`
631
+ # parameter.
625
632
  #
626
633
  #
627
634
  #
@@ -632,39 +639,36 @@ module Aws::Proton
632
639
  #
633
640
  # @option params [String] :proton_service_role_arn
634
641
  # The Amazon Resource Name (ARN) of the Proton service role that allows
635
- # Proton to make calls to other services on your behalf. You must
636
- # include either the `environmentAccountConnectionId` or
637
- # `protonServiceRoleArn` parameter and value and omit the
638
- # `provisioningRepository` parameter when you use standard provisioning.
639
- #
640
- # @option params [Types::RepositoryBranchInput] :provisioning_repository
641
- # The repository that you provide with pull request provisioning. If you
642
- # provide this parameter, you must omit the
643
- # `environmentAccountConnectionId` and `protonServiceRoleArn`
644
- # parameters.
645
- #
646
- # Provisioning by pull request is currently in feature preview and is
647
- # only usable with Terraform based Proton Templates. To learn more about
648
- # [Amazon Web Services Feature Preview terms][1], see section 2 on Beta
649
- # and Previews.
642
+ # Proton to make calls to other services on your behalf.
650
643
  #
644
+ # To use Amazon Web Services-managed provisioning for the environment,
645
+ # specify either the `environmentAccountConnectionId` or
646
+ # `protonServiceRoleArn` parameter and omit the `provisioningRepository`
647
+ # parameter.
651
648
  #
649
+ # @option params [Types::RepositoryBranchInput] :provisioning_repository
650
+ # The infrastructure repository that you use to host your rendered
651
+ # infrastructure templates for self-managed provisioning.
652
652
  #
653
- # [1]: https://aws.amazon.com/service-terms
653
+ # To use self-managed provisioning for the environment, specify this
654
+ # parameter and omit the `environmentAccountConnectionId` and
655
+ # `protonServiceRoleArn` parameters.
654
656
  #
655
657
  # @option params [required, String] :spec
656
- # A link to a YAML formatted spec file that provides inputs as defined
657
- # in the environment template bundle schema file. For more information,
658
- # see [Environments][1] in the *Proton Administrator Guide*.
658
+ # A YAML formatted string that provides inputs as defined in the
659
+ # environment template bundle schema file. For more information, see
660
+ # [Environments][1] in the *Proton Administrator Guide*.
659
661
  #
660
662
  #
661
663
  #
662
664
  # [1]: https://docs.aws.amazon.com/proton/latest/adminguide/ag-environments.html
663
665
  #
664
666
  # @option params [Array<Types::Tag>] :tags
665
- # Create tags for your environment. For more information, see *Proton
666
- # resources and tagging* in the [Proton Administrator Guide][1] or
667
- # [Proton User Guide][2].
667
+ # An optional list of metadata items that you can associate with the
668
+ # Proton environment. A tag is a key-value pair.
669
+ #
670
+ # For more information, see *Proton resources and tagging* in the
671
+ # [Proton Administrator Guide][1] or [Proton User Guide][2].
668
672
  #
669
673
  #
670
674
  #
@@ -773,7 +777,7 @@ module Aws::Proton
773
777
  #
774
778
  # @option params [required, String] :management_account_id
775
779
  # The ID of the management account that accepts or rejects the
776
- # environment account connection. You create an manage the Proton
780
+ # environment account connection. You create and manage the Proton
777
781
  # environment in this account. If the management account accepts the
778
782
  # environment account connection, Proton can use the associated IAM role
779
783
  # to provision environment infrastructure resources in the associated
@@ -785,9 +789,11 @@ module Aws::Proton
785
789
  # infrastructure resources in the associated environment account.
786
790
  #
787
791
  # @option params [Array<Types::Tag>] :tags
788
- # Tags for your environment account connection. For more information,
789
- # see [Proton resources and tagging][1] in the *Proton Administrator
790
- # Guide*.
792
+ # An optional list of metadata items that you can associate with the
793
+ # Proton environment account connection. A tag is a key-value pair.
794
+ #
795
+ # For more information, see [Proton resources and tagging][1] in the
796
+ # *Proton Administrator Guide*.
791
797
  #
792
798
  #
793
799
  #
@@ -873,9 +879,11 @@ module Aws::Proton
873
879
  # provisioned and managed infrastructure.
874
880
  #
875
881
  # @option params [Array<Types::Tag>] :tags
876
- # Create tags for your environment template. For more information, see
877
- # *Proton resources and tagging* in the [Proton Administrator Guide][1]
878
- # or [Proton User Guide][2].
882
+ # An optional list of metadata items that you can associate with the
883
+ # Proton environment template. A tag is a key-value pair.
884
+ #
885
+ # For more information, see *Proton resources and tagging* in the
886
+ # [Proton Administrator Guide][1] or [Proton User Guide][2].
879
887
  #
880
888
  #
881
889
  #
@@ -940,18 +948,27 @@ module Aws::Proton
940
948
  # A description of the new version of an environment template.
941
949
  #
942
950
  # @option params [String] :major_version
943
- # To create a new minor version of the environment template, include a
951
+ # To create a new minor version of the environment template, include
944
952
  # `major Version`.
945
953
  #
946
954
  # To create a new major and minor version of the environment template,
947
- # *exclude* `major Version`.
955
+ # exclude `major Version`.
948
956
  #
949
957
  # @option params [required, Types::TemplateVersionSourceInput] :source
950
958
  # An object that includes the template bundle S3 bucket path and name
951
959
  # for the new version of an template.
952
960
  #
953
961
  # @option params [Array<Types::Tag>] :tags
954
- # Create tags for a new version of an environment template.
962
+ # An optional list of metadata items that you can associate with the
963
+ # Proton environment template version. A tag is a key-value pair.
964
+ #
965
+ # For more information, see *Proton resources and tagging* in the
966
+ # [Proton Administrator Guide][1] or [Proton User Guide][2].
967
+ #
968
+ #
969
+ #
970
+ # [1]: https://docs.aws.amazon.com/proton/latest/adminguide/resources.html
971
+ # [2]: https://docs.aws.amazon.com/proton/latest/userguide/resources.html
955
972
  #
956
973
  # @option params [required, String] :template_name
957
974
  # The name of the environment template.
@@ -1004,15 +1021,21 @@ module Aws::Proton
1004
1021
  req.send_request(options)
1005
1022
  end
1006
1023
 
1007
- # Create and register a link to a repository that can be used with pull
1008
- # request provisioning or template sync configurations. For more
1009
- # information, see [Template bundles][1] and [Template sync
1010
- # configurations][2] in the *Proton Administrator Guide*.
1024
+ # Create and register a link to a repository that can be used with
1025
+ # self-managed provisioning (infrastructure or pipelines) or for
1026
+ # template sync configurations. When you create a repository link,
1027
+ # Proton creates a [service-linked role][1] for you.
1011
1028
  #
1029
+ # For more information, see [Self-managed provisioning][2], [Template
1030
+ # bundles][3], and [Template sync configurations][4] in the *Proton
1031
+ # Administrator Guide*.
1012
1032
  #
1013
1033
  #
1014
- # [1]: https://docs.aws.amazon.com/proton/latest/adminguide/ag-template-bundles.html
1015
- # [2]: https://docs.aws.amazon.com/proton/latest/adminguide/ag-template-sync-configs.html
1034
+ #
1035
+ # [1]: https://docs.aws.amazon.com/proton/latest/adminguide/using-service-linked-roles.html
1036
+ # [2]: https://docs.aws.amazon.com/proton/latest/adminguide/ag-works-prov-methods.html#ag-works-prov-methods-self
1037
+ # [3]: https://docs.aws.amazon.com/proton/latest/adminguide/ag-template-bundles.html
1038
+ # [4]: https://docs.aws.amazon.com/proton/latest/adminguide/ag-template-sync-configs.html
1016
1039
  #
1017
1040
  # @option params [required, String] :connection_arn
1018
1041
  # The Amazon Resource Name (ARN) of your Amazon Web Services CodeStar
@@ -1021,18 +1044,30 @@ module Aws::Proton
1021
1044
  #
1022
1045
  #
1023
1046
  #
1024
- # [1]: https://docs.aws.amazon.com/setting-up-for-service
1047
+ # [1]: https://docs.aws.amazon.com/proton/latest/adminguide/setting-up-for-service.html
1025
1048
  #
1026
1049
  # @option params [String] :encryption_key
1027
1050
  # The ARN of your customer Amazon Web Services Key Management Service
1028
1051
  # (Amazon Web Services KMS) key.
1029
1052
  #
1030
1053
  # @option params [required, String] :name
1031
- # The repository name, for example `myrepos/myrepo`.
1054
+ # The repository name (for example, `myrepos/myrepo`).
1032
1055
  #
1033
1056
  # @option params [required, String] :provider
1034
1057
  # The repository provider.
1035
1058
  #
1059
+ # @option params [Array<Types::Tag>] :tags
1060
+ # An optional list of metadata items that you can associate with the
1061
+ # Proton repository. A tag is a key-value pair.
1062
+ #
1063
+ # For more information, see *Proton resources and tagging* in the
1064
+ # [Proton Administrator Guide][1] or [Proton User Guide][2].
1065
+ #
1066
+ #
1067
+ #
1068
+ # [1]: https://docs.aws.amazon.com/proton/latest/adminguide/resources.html
1069
+ # [2]: https://docs.aws.amazon.com/proton/latest/userguide/resources.html
1070
+ #
1036
1071
  # @return [Types::CreateRepositoryOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1037
1072
  #
1038
1073
  # * {Types::CreateRepositoryOutput#repository #repository} => Types::Repository
@@ -1044,6 +1079,12 @@ module Aws::Proton
1044
1079
  # encryption_key: "Arn",
1045
1080
  # name: "RepositoryName", # required
1046
1081
  # provider: "GITHUB", # required, accepts GITHUB, GITHUB_ENTERPRISE, BITBUCKET
1082
+ # tags: [
1083
+ # {
1084
+ # key: "TagKey", # required
1085
+ # value: "TagValue", # required
1086
+ # },
1087
+ # ],
1047
1088
  # })
1048
1089
  #
1049
1090
  # @example Response structure
@@ -1102,7 +1143,7 @@ module Aws::Proton
1102
1143
  #
1103
1144
  # @option params [required, String] :spec
1104
1145
  # A link to a spec file that provides inputs as defined in the service
1105
- # template bundle schema file. The spec file is in YAML format. Don’t
1146
+ # template bundle schema file. The spec file is in YAML format. *Don’t*
1106
1147
  # include pipeline inputs in the spec if your service template *doesn’t*
1107
1148
  # include a service pipeline. For more information, see [Create a
1108
1149
  # service][1] in the *Proton Administrator Guide* and [Create a
@@ -1114,9 +1155,11 @@ module Aws::Proton
1114
1155
  # [2]: https://docs.aws.amazon.com/proton/latest/userguide/ug-svc-create.html
1115
1156
  #
1116
1157
  # @option params [Array<Types::Tag>] :tags
1117
- # Create tags for your service. For more information, see *Proton
1118
- # resources and tagging* in the [Proton Administrator Guide][1] or
1119
- # [Proton User Guide][2].
1158
+ # An optional list of metadata items that you can associate with the
1159
+ # Proton service. A tag is a key-value pair.
1160
+ #
1161
+ # For more information, see *Proton resources and tagging* in the
1162
+ # [Proton Administrator Guide][1] or [Proton User Guide][2].
1120
1163
  #
1121
1164
  #
1122
1165
  #
@@ -1193,7 +1236,7 @@ module Aws::Proton
1193
1236
  end
1194
1237
 
1195
1238
  # Create a service template. The administrator creates a service
1196
- # template to define standardized infrastructure and an optional CICD
1239
+ # template to define standardized infrastructure and an optional CI/CD
1197
1240
  # service pipeline. Developers, in turn, select the service template
1198
1241
  # from Proton. If the selected service template includes a service
1199
1242
  # pipeline definition, they provide a link to their source code
@@ -1219,9 +1262,9 @@ module Aws::Proton
1219
1262
  # The name of the service template.
1220
1263
  #
1221
1264
  # @option params [String] :pipeline_provisioning
1222
- # Proton includes a service pipeline for your service by default. When
1223
- # included, this parameter indicates that an Proton service pipeline
1224
- # *won't* be included for your service. Once specified, this parameter
1265
+ # By default, Proton provides a service pipeline for your service. When
1266
+ # this parameter is included, it indicates that an Proton service
1267
+ # pipeline *isn't* provided for your service. After it's included, it
1225
1268
  # *can't* be changed. For more information, see [Service template
1226
1269
  # bundles][1] in the *Proton Administrator Guide*.
1227
1270
  #
@@ -1230,9 +1273,11 @@ module Aws::Proton
1230
1273
  # [1]: https://docs.aws.amazon.com/proton/latest/adminguide/ag-template-bundles.html
1231
1274
  #
1232
1275
  # @option params [Array<Types::Tag>] :tags
1233
- # Create tags for your service template. For more information, see
1234
- # *Proton resources and tagging* in the [Proton Administrator Guide][1]
1235
- # or [Proton User Guide][2].
1276
+ # An optional list of metadata items that you can associate with the
1277
+ # Proton service template. A tag is a key-value pair.
1278
+ #
1279
+ # For more information, see *Proton resources and tagging* in the
1280
+ # [Proton Administrator Guide][1] or [Proton User Guide][2].
1236
1281
  #
1237
1282
  #
1238
1283
  #
@@ -1312,7 +1357,16 @@ module Aws::Proton
1312
1357
  # for the new version of a service template.
1313
1358
  #
1314
1359
  # @option params [Array<Types::Tag>] :tags
1315
- # Create tags for a new version of a service template.
1360
+ # An optional list of metadata items that you can associate with the
1361
+ # Proton service template version. A tag is a key-value pair.
1362
+ #
1363
+ # For more information, see *Proton resources and tagging* in the
1364
+ # [Proton Administrator Guide][1] or [Proton User Guide][2].
1365
+ #
1366
+ #
1367
+ #
1368
+ # [1]: https://docs.aws.amazon.com/proton/latest/adminguide/resources.html
1369
+ # [2]: https://docs.aws.amazon.com/proton/latest/userguide/resources.html
1316
1370
  #
1317
1371
  # @option params [required, String] :template_name
1318
1372
  # The name of the service template.
@@ -1374,13 +1428,13 @@ module Aws::Proton
1374
1428
  req.send_request(options)
1375
1429
  end
1376
1430
 
1377
- # Set up a template for automated template version creation. When a
1378
- # commit is pushed to your registered [repository][1], Proton checks for
1379
- # changes to your repository template bundles. If it detects a template
1380
- # bundle change, a new minor or major version of its template is
1381
- # created, if the version doesn’t already exist. For more information,
1382
- # see [Template sync configurations][2] in the *Proton Administrator
1383
- # Guide*.
1431
+ # Set up a template to create new template versions automatically. When
1432
+ # a commit is pushed to your registered [repository][1], Proton checks
1433
+ # for changes to your repository template bundles. If it detects a
1434
+ # template bundle change, a new major or minor version of its template
1435
+ # is created, if the version doesn’t already exist. For more
1436
+ # information, see [Template sync configurations][2] in the *Proton
1437
+ # Administrator Guide*.
1384
1438
  #
1385
1439
  #
1386
1440
  #
@@ -1391,7 +1445,7 @@ module Aws::Proton
1391
1445
  # The branch of the registered repository for your template.
1392
1446
  #
1393
1447
  # @option params [required, String] :repository_name
1394
- # The name of your repository, for example `myrepos/myrepo`.
1448
+ # The name of your repository (for example, `myrepos/myrepo`).
1395
1449
  #
1396
1450
  # @option params [required, String] :repository_provider
1397
1451
  # The provider type for your repository.
@@ -2096,7 +2150,23 @@ module Aws::Proton
2096
2150
  req.send_request(options)
2097
2151
  end
2098
2152
 
2099
- # Get the repository sync status.
2153
+ # Get the sync status of a repository used for Proton template sync. For
2154
+ # more information about template sync, see .
2155
+ #
2156
+ # <note markdown="1"> A repository sync status isn't tied to the Proton Repository resource
2157
+ # (or any other Proton resource). Therefore, tags on an Proton
2158
+ # Repository resource have no effect on this action. Specifically, you
2159
+ # can't use these tags to control access to this action using
2160
+ # Attribute-based access control (ABAC).
2161
+ #
2162
+ # For more information about ABAC, see [ABAC][1] in the *Proton
2163
+ # Administrator Guide*.
2164
+ #
2165
+ # </note>
2166
+ #
2167
+ #
2168
+ #
2169
+ # [1]: https://docs.aws.amazon.com/proton/latest/adminguide/security_iam_service-with-iam.html#security_iam_service-with-iam-tags
2100
2170
  #
2101
2171
  # @option params [required, String] :branch
2102
2172
  # The repository branch.
@@ -2200,7 +2270,7 @@ module Aws::Proton
2200
2270
  end
2201
2271
 
2202
2272
  # Get detail data for a service instance. A service instance is an
2203
- # instantiation of service template, which is running in a specific
2273
+ # instantiation of service template and it runs in a specific
2204
2274
  # environment.
2205
2275
  #
2206
2276
  # @option params [required, String] :name
@@ -2389,7 +2459,7 @@ module Aws::Proton
2389
2459
  # The template type.
2390
2460
  #
2391
2461
  # @option params [required, String] :template_version
2392
- # The template version.
2462
+ # The template major version.
2393
2463
  #
2394
2464
  # @return [Types::GetTemplateSyncStatusOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2395
2465
  #
@@ -2475,7 +2545,7 @@ module Aws::Proton
2475
2545
  # The maximum number of environment account connections to list.
2476
2546
  #
2477
2547
  # @option params [String] :next_token
2478
- # A token to indicate the location of the next environment account
2548
+ # A token that indicates the location of the next environment account
2479
2549
  # connection in the array of environment account connections, after the
2480
2550
  # list of environment account connections that was previously requested.
2481
2551
  #
@@ -2532,9 +2602,9 @@ module Aws::Proton
2532
2602
  # The environment name.
2533
2603
  #
2534
2604
  # @option params [String] :next_token
2535
- # A token to indicate the location of the next environment output in the
2536
- # array of environment outputs, after the list of environment outputs
2537
- # that was previously requested.
2605
+ # A token that indicates the location of the next environment output in
2606
+ # the array of environment outputs, after the list of environment
2607
+ # outputs that was previously requested.
2538
2608
  #
2539
2609
  # @return [Types::ListEnvironmentOutputsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2540
2610
  #
@@ -2572,10 +2642,10 @@ module Aws::Proton
2572
2642
  # The environment name.
2573
2643
  #
2574
2644
  # @option params [String] :next_token
2575
- # A token to indicate the location of the next environment provisioned
2576
- # resource in the array of environment provisioned resources, after the
2577
- # list of environment provisioned resources that was previously
2578
- # requested.
2645
+ # A token that indicates the location of the next environment
2646
+ # provisioned resource in the array of environment provisioned
2647
+ # resources, after the list of environment provisioned resources that
2648
+ # was previously requested.
2579
2649
  #
2580
2650
  # @return [Types::ListEnvironmentProvisionedResourcesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2581
2651
  #
@@ -2623,9 +2693,10 @@ module Aws::Proton
2623
2693
  # template to list.
2624
2694
  #
2625
2695
  # @option params [String] :next_token
2626
- # A token to indicate the location of the next major or minor version in
2627
- # the array of major or minor versions of an environment template, after
2628
- # the list of major or minor versions that was previously requested.
2696
+ # A token that indicates the location of the next major or minor version
2697
+ # in the array of major or minor versions of an environment template,
2698
+ # after the list of major or minor versions that was previously
2699
+ # requested.
2629
2700
  #
2630
2701
  # @option params [required, String] :template_name
2631
2702
  # The name of the environment template.
@@ -2676,8 +2747,8 @@ module Aws::Proton
2676
2747
  # The maximum number of environment templates to list.
2677
2748
  #
2678
2749
  # @option params [String] :next_token
2679
- # A token to indicate the location of the next environment template in
2680
- # the array of environment templates, after the list of environment
2750
+ # A token that indicates the location of the next environment template
2751
+ # in the array of environment templates, after the list of environment
2681
2752
  # templates that was previously requested.
2682
2753
  #
2683
2754
  # @return [Types::ListEnvironmentTemplatesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -2725,9 +2796,9 @@ module Aws::Proton
2725
2796
  # The maximum number of environments to list.
2726
2797
  #
2727
2798
  # @option params [String] :next_token
2728
- # A token to indicate the location of the next environment in the array
2729
- # of environments, after the list of environments that was previously
2730
- # requested.
2799
+ # A token that indicates the location of the next environment in the
2800
+ # array of environments, after the list of environments that was
2801
+ # previously requested.
2731
2802
  #
2732
2803
  # @return [Types::ListEnvironmentsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2733
2804
  #
@@ -2784,8 +2855,9 @@ module Aws::Proton
2784
2855
  # The maximum number of repositories to list.
2785
2856
  #
2786
2857
  # @option params [String] :next_token
2787
- # A token to indicate the location of the next repository in the array
2788
- # of repositories, after the list of repositories previously requested.
2858
+ # A token that indicates the location of the next repository in the
2859
+ # array of repositories, after the list of repositories previously
2860
+ # requested.
2789
2861
  #
2790
2862
  # @return [Types::ListRepositoriesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2791
2863
  #
@@ -2821,7 +2893,7 @@ module Aws::Proton
2821
2893
  # List repository sync definitions with detail data.
2822
2894
  #
2823
2895
  # @option params [String] :next_token
2824
- # A token to indicate the location of the next repository sync
2896
+ # A token that indicates the location of the next repository sync
2825
2897
  # definition in the array of repository sync definitions, after the list
2826
2898
  # of repository sync definitions previously requested.
2827
2899
  #
@@ -2872,7 +2944,7 @@ module Aws::Proton
2872
2944
  # detail data.
2873
2945
  #
2874
2946
  # @option params [String] :next_token
2875
- # A token to indicate the location of the next output in the array of
2947
+ # A token that indicates the location of the next output in the array of
2876
2948
  # outputs, after the list of outputs that was previously requested.
2877
2949
  #
2878
2950
  # @option params [required, String] :service_instance_name
@@ -2915,8 +2987,8 @@ module Aws::Proton
2915
2987
  # List provisioned resources for a service instance with details.
2916
2988
  #
2917
2989
  # @option params [String] :next_token
2918
- # A token to indicate the location of the next provisioned resource in
2919
- # the array of provisioned resources, after the list of provisioned
2990
+ # A token that indicates the location of the next provisioned resource
2991
+ # in the array of provisioned resources, after the list of provisioned
2920
2992
  # resources that was previously requested.
2921
2993
  #
2922
2994
  # @option params [required, String] :service_instance_name
@@ -2963,8 +3035,8 @@ module Aws::Proton
2963
3035
  # The maximum number of service instances to list.
2964
3036
  #
2965
3037
  # @option params [String] :next_token
2966
- # A token to indicate the location of the next service in the array of
2967
- # service instances, after the list of service instances that was
3038
+ # A token that indicates the location of the next service in the array
3039
+ # of service instances, after the list of service instances that was
2968
3040
  # previously requested.
2969
3041
  #
2970
3042
  # @option params [String] :service_name
@@ -3015,7 +3087,7 @@ module Aws::Proton
3015
3087
  # detail.
3016
3088
  #
3017
3089
  # @option params [String] :next_token
3018
- # A token to indicate the location of the next output in the array of
3090
+ # A token that indicates the location of the next output in the array of
3019
3091
  # outputs, after the list of outputs that was previously requested.
3020
3092
  #
3021
3093
  # @option params [required, String] :service_name
@@ -3054,8 +3126,8 @@ module Aws::Proton
3054
3126
  # List provisioned resources for a service and pipeline with details.
3055
3127
  #
3056
3128
  # @option params [String] :next_token
3057
- # A token to indicate the location of the next provisioned resource in
3058
- # the array of provisioned resources, after the list of provisioned
3129
+ # A token that indicates the location of the next provisioned resource
3130
+ # in the array of provisioned resources, after the list of provisioned
3059
3131
  # resources that was previously requested.
3060
3132
  #
3061
3133
  # @option params [required, String] :service_name
@@ -3106,9 +3178,9 @@ module Aws::Proton
3106
3178
  # list.
3107
3179
  #
3108
3180
  # @option params [String] :next_token
3109
- # A token to indicate the location of the next major or minor version in
3110
- # the array of major or minor versions of a service template, after the
3111
- # list of major or minor versions that was previously requested.
3181
+ # A token that indicates the location of the next major or minor version
3182
+ # in the array of major or minor versions of a service template, after
3183
+ # the list of major or minor versions that was previously requested.
3112
3184
  #
3113
3185
  # @option params [required, String] :template_name
3114
3186
  # The name of the service template.
@@ -3159,8 +3231,8 @@ module Aws::Proton
3159
3231
  # The maximum number of service templates to list.
3160
3232
  #
3161
3233
  # @option params [String] :next_token
3162
- # A token to indicate the location of the next service template in the
3163
- # array of service templates, after the list of service templates
3234
+ # A token that indicates the location of the next service template in
3235
+ # the array of service templates, after the list of service templates
3164
3236
  # previously requested.
3165
3237
  #
3166
3238
  # @return [Types::ListServiceTemplatesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -3205,8 +3277,8 @@ module Aws::Proton
3205
3277
  # The maximum number of services to list.
3206
3278
  #
3207
3279
  # @option params [String] :next_token
3208
- # A token to indicate the location of the next service in the array of
3209
- # services, after the list of services that was previously requested.
3280
+ # A token that indicates the location of the next service in the array
3281
+ # of services, after the list of services that was previously requested.
3210
3282
  #
3211
3283
  # @return [Types::ListServicesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3212
3284
  #
@@ -3257,9 +3329,9 @@ module Aws::Proton
3257
3329
  # The maximum number of tags to list.
3258
3330
  #
3259
3331
  # @option params [String] :next_token
3260
- # A token to indicate the location of the next resource tag in the array
3261
- # of resource tags, after the list of resource tags that was previously
3262
- # requested.
3332
+ # A token that indicates the location of the next resource tag in the
3333
+ # array of resource tags, after the list of resource tags that was
3334
+ # previously requested.
3263
3335
  #
3264
3336
  # @option params [required, String] :resource_arn
3265
3337
  # The Amazon Resource Name (ARN) of the resource for the listed tags.
@@ -3296,18 +3368,14 @@ module Aws::Proton
3296
3368
  end
3297
3369
 
3298
3370
  # Notify Proton of status changes to a provisioned resource when you use
3299
- # pull request provisioning. For more information, see [Template
3300
- # bundles][1].
3371
+ # self-managed provisioning.
3301
3372
  #
3302
- # Provisioning by pull request is currently in feature preview and is
3303
- # only usable with Terraform based Proton Templates. To learn more about
3304
- # [Amazon Web Services Feature Preview terms][2], see section 2 on Beta
3305
- # and Previews.
3373
+ # For more information, see [Self-managed provisioning][1] in the
3374
+ # *Proton Administrator Guide*.
3306
3375
  #
3307
3376
  #
3308
3377
  #
3309
- # [1]: https://docs.aws.amazon.com/proton/latest/adminguide/ag-template-bundles.html
3310
- # [2]: https://aws.amazon.com/service-terms
3378
+ # [1]: https://docs.aws.amazon.com/proton/latest/adminguide/ag-works-prov-methods.html#ag-works-prov-methods-self
3311
3379
  #
3312
3380
  # @option params [String] :deployment_id
3313
3381
  # The deployment ID for your provisioned resource.
@@ -3355,10 +3423,9 @@ module Aws::Proton
3355
3423
  # another environment account.
3356
3424
  #
3357
3425
  # After you reject an environment account connection request, you
3358
- # *won’t* be able to accept or use the rejected environment account
3359
- # connection.
3426
+ # *can't* accept or use the rejected environment account connection.
3360
3427
  #
3361
- # You *can’t* reject an environment account connection that is connected
3428
+ # You *can’t* reject an environment account connection that's connected
3362
3429
  # to an environment.
3363
3430
  #
3364
3431
  # For more information, see [Environment account connections][1] in the
@@ -3402,9 +3469,11 @@ module Aws::Proton
3402
3469
  req.send_request(options)
3403
3470
  end
3404
3471
 
3405
- # Tag a resource. For more information, see *Proton resources and
3406
- # tagging* in the [Proton Administrator Guide][1] or [Proton User
3407
- # Guide][2].
3472
+ # Tag a resource. A tag is a key-value pair of metadata that you
3473
+ # associate with an Proton resource.
3474
+ #
3475
+ # For more information, see *Proton resources and tagging* in the
3476
+ # [Proton Administrator Guide][1] or [Proton User Guide][2].
3408
3477
  #
3409
3478
  #
3410
3479
  #
@@ -3412,11 +3481,11 @@ module Aws::Proton
3412
3481
  # [2]: https://docs.aws.amazon.com/proton/latest/userguide/resources.html
3413
3482
  #
3414
3483
  # @option params [required, String] :resource_arn
3415
- # The Amazon Resource Name (ARN) of the resource that the resource tag
3416
- # is applied to.
3484
+ # The Amazon Resource Name (ARN) of the Proton resource to apply
3485
+ # customer tags to.
3417
3486
  #
3418
3487
  # @option params [required, Array<Types::Tag>] :tags
3419
- # An array of resource tags to apply to a resource.
3488
+ # A list of customer tags to apply to the Proton resource.
3420
3489
  #
3421
3490
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
3422
3491
  #
@@ -3441,9 +3510,11 @@ module Aws::Proton
3441
3510
  req.send_request(options)
3442
3511
  end
3443
3512
 
3444
- # Remove a tag from a resource. For more information, see *Proton
3445
- # resources and tagging* in the [Proton Administrator Guide][1] or
3446
- # [Proton User Guide][2].
3513
+ # Remove a customer tag from a resource. A tag is a key-value pair of
3514
+ # metadata associated with an Proton resource.
3515
+ #
3516
+ # For more information, see *Proton resources and tagging* in the
3517
+ # [Proton Administrator Guide][1] or [Proton User Guide][2].
3447
3518
  #
3448
3519
  #
3449
3520
  #
@@ -3451,12 +3522,12 @@ module Aws::Proton
3451
3522
  # [2]: https://docs.aws.amazon.com/proton/latest/userguide/resources.html
3452
3523
  #
3453
3524
  # @option params [required, String] :resource_arn
3454
- # The Amazon Resource Name (ARN) of the resource that the tag is to be
3455
- # removed from.
3525
+ # The Amazon Resource Name (ARN) of the resource to remove customer tags
3526
+ # from.
3456
3527
  #
3457
3528
  # @option params [required, Array<String>] :tag_keys
3458
- # An array of tag keys indicating the resource tags to be removed from
3459
- # the resource.
3529
+ # A list of customer tag keys that indicate the customer tags to be
3530
+ # removed from the resource.
3460
3531
  #
3461
3532
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
3462
3533
  #
@@ -3479,28 +3550,15 @@ module Aws::Proton
3479
3550
  # Update the Proton service pipeline role or repository settings.
3480
3551
  #
3481
3552
  # @option params [Types::RepositoryBranchInput] :pipeline_provisioning_repository
3482
- # The repository that you provide with pull request provisioning.
3483
- #
3484
- # Provisioning by pull request is currently in feature preview and is
3485
- # only usable with Terraform based Proton Templates. To learn more about
3486
- # [Amazon Web Services Feature Preview terms][1], see section 2 on Beta
3487
- # and Previews.
3488
- #
3489
- #
3490
- #
3491
- # [1]: https://aws.amazon.com/service-terms
3553
+ # A repository for pipeline provisioning. Specify it if you have
3554
+ # environments configured for self-managed provisioning with services
3555
+ # that include pipelines.
3492
3556
  #
3493
3557
  # @option params [String] :pipeline_service_role_arn
3494
- # The Amazon Resource Name (ARN) of the Proton pipeline service role.
3495
- #
3496
- # Provisioning by pull request is currently in feature preview and is
3497
- # only usable with Terraform based Proton Templates. To learn more about
3498
- # [Amazon Web Services Feature Preview terms][1], see section 2 on Beta
3499
- # and Previews.
3500
- #
3501
- #
3502
- #
3503
- # [1]: https://aws.amazon.com/service-terms
3558
+ # The Amazon Resource Name (ARN) of the service role you want to use for
3559
+ # provisioning pipelines. Assumed by Proton for Amazon Web
3560
+ # Services-managed provisioning, and by customer-owned automation for
3561
+ # self-managed provisioning.
3504
3562
  #
3505
3563
  # @return [Types::UpdateAccountSettingsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3506
3564
  #
@@ -3541,29 +3599,33 @@ module Aws::Proton
3541
3599
  # `provisioningRepository` parameter to update or connect to an
3542
3600
  # environment account connection.
3543
3601
  #
3544
- # You can only update to a new environment account connection if it was
3545
- # created in the same environment account that the current environment
3546
- # account connection was created in and is associated with the current
3547
- # environment.
3602
+ # You can only update to a new environment account connection if that
3603
+ # connection was created in the same environment account that the
3604
+ # current environment account connection was created in. The account
3605
+ # connection must also be associated with the current environment.
3548
3606
  #
3549
3607
  # If the environment *isn't* associated with an environment account
3550
3608
  # connection, *don't* update or include the
3551
- # `environmentAccountConnectionId` parameter to update or connect to an
3552
- # environment account connection.
3609
+ # `environmentAccountConnectionId` parameter. You *can't* update or
3610
+ # connect the environment to an environment account connection if it
3611
+ # *isn't* already associated with an environment connection.
3553
3612
  #
3554
3613
  # You can update either the `environmentAccountConnectionId` or
3555
3614
  # `protonServiceRoleArn` parameter and value. You can’t update both.
3556
3615
  #
3557
- # If the environment was provisioned with pull request provisioning,
3558
- # include the `provisioningRepository` parameter and omit the
3616
+ # If the environment was configured for Amazon Web Services-managed
3617
+ # provisioning, omit the `provisioningRepository` parameter.
3618
+ #
3619
+ # If the environment was configured for self-managed provisioning,
3620
+ # specify the `provisioningRepository` parameter and omit the
3559
3621
  # `protonServiceRoleArn` and `environmentAccountConnectionId`
3560
3622
  # parameters.
3561
3623
  #
3562
- # If the environment wasn't provisioned with pull request provisioning,
3563
- # omit the `provisioningRepository` parameter.
3624
+ # For more information, see [Environments][1] and [Provisioning
3625
+ # methods][2] in the *Proton Administrator Guide*.
3564
3626
  #
3565
- # There are four modes for updating an environment as described in the
3566
- # following. The `deploymentType` field defines the mode.
3627
+ # There are four modes for updating an environment. The `deploymentType`
3628
+ # field defines the mode.
3567
3629
  #
3568
3630
  #
3569
3631
  #
@@ -3598,11 +3660,16 @@ module Aws::Proton
3598
3660
  # published, recommended (latest) major and minor version of the
3599
3661
  # current template, by default. You can also specify a different major
3600
3662
  # version that's higher than the major version in use and a minor
3601
- # version (optional).
3663
+ # version.
3664
+ #
3665
+ #
3666
+ #
3667
+ # [1]: https://docs.aws.amazon.com/proton/latest/adminguide/ag-environments.html
3668
+ # [2]: https://docs.aws.amazon.com/proton/latest/adminguide/ag-works-prov-methods.html
3602
3669
  #
3603
3670
  # @option params [required, String] :deployment_type
3604
- # There are four modes for updating an environment as described in the
3605
- # following. The `deploymentType` field defines the mode.
3671
+ # There are four modes for updating an environment. The `deploymentType`
3672
+ # field defines the mode.
3606
3673
  #
3607
3674
  #
3608
3675
  #
@@ -3617,7 +3684,7 @@ module Aws::Proton
3617
3684
  #
3618
3685
  # In this mode, the environment is deployed and updated with the new
3619
3686
  # spec that you provide. Only requested parameters are updated.
3620
- # *Don’t* include minor or major version parameters when you use this
3687
+ # *Don’t* include major or minor version parameters when you use this
3621
3688
  # `deployment-type`.
3622
3689
  #
3623
3690
  #
@@ -3658,16 +3725,8 @@ module Aws::Proton
3658
3725
  # Proton to make API calls to other services your behalf.
3659
3726
  #
3660
3727
  # @option params [Types::RepositoryBranchInput] :provisioning_repository
3661
- # The repository that you provide with pull request provisioning.
3662
- #
3663
- # Provisioning by pull request is currently in feature preview and is
3664
- # only usable with Terraform based Proton Templates. To learn more about
3665
- # [Amazon Web Services Feature Preview terms][1], see section 2 on Beta
3666
- # and Previews.
3667
- #
3668
- #
3669
- #
3670
- # [1]: https://aws.amazon.com/service-terms
3728
+ # The infrastructure repository that you use to host your rendered
3729
+ # infrastructure templates for self-managed provisioning.
3671
3730
  #
3672
3731
  # @option params [String] :spec
3673
3732
  # The formatted specification that defines the update.
@@ -3746,7 +3805,7 @@ module Aws::Proton
3746
3805
  # The ID of the environment account connection to update.
3747
3806
  #
3748
3807
  # @option params [required, String] :role_arn
3749
- # The Amazon Resource Name (ARN) of the IAM service role that is
3808
+ # The Amazon Resource Name (ARN) of the IAM service role that's
3750
3809
  # associated with the environment account connection to update.
3751
3810
  #
3752
3811
  # @return [Types::UpdateEnvironmentAccountConnectionOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -3960,8 +4019,8 @@ module Aws::Proton
3960
4019
 
3961
4020
  # Update a service instance.
3962
4021
  #
3963
- # There are four modes for updating a service instance as described in
3964
- # the following. The `deploymentType` field defines the mode.
4022
+ # There are four modes for updating a service instance. The
4023
+ # `deploymentType` field defines the mode.
3965
4024
  #
3966
4025
  #
3967
4026
  #
@@ -3995,14 +4054,14 @@ module Aws::Proton
3995
4054
  # In this mode, the service instance is deployed and updated with the
3996
4055
  # published, recommended (latest) major and minor version of the
3997
4056
  # current template, by default. You can also specify a different major
3998
- # version that is higher than the major version in use and a minor
3999
- # version (optional).
4057
+ # version that's higher than the major version in use and a minor
4058
+ # version.
4000
4059
  #
4001
4060
  # @option params [required, String] :deployment_type
4002
4061
  # The deployment type.
4003
4062
  #
4004
- # There are four modes for updating a service instance as described in
4005
- # the following. The `deploymentType` field defines the mode.
4063
+ # There are four modes for updating a service instance. The
4064
+ # `deploymentType` field defines the mode.
4006
4065
  #
4007
4066
  #
4008
4067
  #
@@ -4017,7 +4076,7 @@ module Aws::Proton
4017
4076
  #
4018
4077
  # In this mode, the service instance is deployed and updated with the
4019
4078
  # new spec that you provide. Only requested parameters are updated.
4020
- # *Don’t* include minor or major version parameters when you use this
4079
+ # *Don’t* include major or minor version parameters when you use this
4021
4080
  # `deployment-type`.
4022
4081
  #
4023
4082
  #
@@ -4035,9 +4094,9 @@ module Aws::Proton
4035
4094
  #
4036
4095
  # In this mode, the service instance is deployed and updated with the
4037
4096
  # published, recommended (latest) major and minor version of the
4038
- # current template, by default. You can also specify a different major
4039
- # version that is higher than the major version in use and a minor
4040
- # version (optional).
4097
+ # current template, by default. You can specify a different major
4098
+ # version that's higher than the major version in use and a minor
4099
+ # version.
4041
4100
  #
4042
4101
  # @option params [required, String] :name
4043
4102
  # The name of the service instance to update.
@@ -4096,8 +4155,8 @@ module Aws::Proton
4096
4155
 
4097
4156
  # Update the service pipeline.
4098
4157
  #
4099
- # There are four modes for updating a service pipeline as described in
4100
- # the following. The `deploymentType` field defines the mode.
4158
+ # There are four modes for updating a service pipeline. The
4159
+ # `deploymentType` field defines the mode.
4101
4160
  #
4102
4161
  #
4103
4162
  #
@@ -4112,7 +4171,7 @@ module Aws::Proton
4112
4171
  #
4113
4172
  # In this mode, the service pipeline is deployed and updated with the
4114
4173
  # new spec that you provide. Only requested parameters are updated.
4115
- # *Don’t* include minor or major version parameters when you use this
4174
+ # *Don’t* include major or minor version parameters when you use this
4116
4175
  # `deployment-type`.
4117
4176
  #
4118
4177
  #
@@ -4121,7 +4180,7 @@ module Aws::Proton
4121
4180
  #
4122
4181
  # In this mode, the service pipeline is deployed and updated with the
4123
4182
  # published, recommended (latest) minor version of the current major
4124
- # version in use, by default. You can also specify a different minor
4183
+ # version in use, by default. You can specify a different minor
4125
4184
  # version of the current major version in use.
4126
4185
  #
4127
4186
  #
@@ -4130,15 +4189,15 @@ module Aws::Proton
4130
4189
  #
4131
4190
  # In this mode, the service pipeline is deployed and updated with the
4132
4191
  # published, recommended (latest) major and minor version of the
4133
- # current template by default. You can also specify a different major
4134
- # version that is higher than the major version in use and a minor
4135
- # version (optional).
4192
+ # current template by default. You can specify a different major
4193
+ # version that's higher than the major version in use and a minor
4194
+ # version.
4136
4195
  #
4137
4196
  # @option params [required, String] :deployment_type
4138
4197
  # The deployment type.
4139
4198
  #
4140
- # There are four modes for updating a service pipeline as described in
4141
- # the following. The `deploymentType` field defines the mode.
4199
+ # There are four modes for updating a service pipeline. The
4200
+ # `deploymentType` field defines the mode.
4142
4201
  #
4143
4202
  #
4144
4203
  #
@@ -4153,7 +4212,7 @@ module Aws::Proton
4153
4212
  #
4154
4213
  # In this mode, the service pipeline is deployed and updated with the
4155
4214
  # new spec that you provide. Only requested parameters are updated.
4156
- # *Don’t* include minor or major version parameters when you use this
4215
+ # *Don’t* include major or minor version parameters when you use this
4157
4216
  # `deployment-type`.
4158
4217
  #
4159
4218
  #
@@ -4162,7 +4221,7 @@ module Aws::Proton
4162
4221
  #
4163
4222
  # In this mode, the service pipeline is deployed and updated with the
4164
4223
  # published, recommended (latest) minor version of the current major
4165
- # version in use, by default. You can also specify a different minor
4224
+ # version in use, by default. You can specify a different minor
4166
4225
  # version of the current major version in use.
4167
4226
  #
4168
4227
  #
@@ -4171,9 +4230,9 @@ module Aws::Proton
4171
4230
  #
4172
4231
  # In this mode, the service pipeline is deployed and updated with the
4173
4232
  # published, recommended (latest) major and minor version of the
4174
- # current template, by default. You can also specify a different major
4175
- # version that is higher than the major version in use and a minor
4176
- # version (optional).
4233
+ # current template, by default. You can specify a different major
4234
+ # version that's higher than the major version in use and a minor
4235
+ # version.
4177
4236
  #
4178
4237
  # @option params [required, String] :service_name
4179
4238
  # The name of the service to that the pipeline is associated with.
@@ -4231,7 +4290,7 @@ module Aws::Proton
4231
4290
  # A description of the service template update.
4232
4291
  #
4233
4292
  # @option params [String] :display_name
4234
- # The name of the service template to update as displayed in the
4293
+ # The name of the service template to update that's displayed in the
4235
4294
  # developer interface.
4236
4295
  #
4237
4296
  # @option params [required, String] :name
@@ -4346,7 +4405,7 @@ module Aws::Proton
4346
4405
  # The repository branch.
4347
4406
  #
4348
4407
  # @option params [required, String] :repository_name
4349
- # The name of the repository, for example `myrepos/myrepo`.
4408
+ # The name of the repository (for example, `myrepos/myrepo`).
4350
4409
  #
4351
4410
  # @option params [required, String] :repository_provider
4352
4411
  # The repository provider.
@@ -4407,7 +4466,7 @@ module Aws::Proton
4407
4466
  params: params,
4408
4467
  config: config)
4409
4468
  context[:gem_name] = 'aws-sdk-proton'
4410
- context[:gem_version] = '1.12.0'
4469
+ context[:gem_version] = '1.15.0'
4411
4470
  Seahorse::Client::Request.new(handlers, context)
4412
4471
  end
4413
4472