aws-sdk-proton 1.12.0 → 1.15.0

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