aws-sdk-proton 1.17.0 → 1.19.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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 54aa73075ca5810cae0c120a313c829d8d2dda90ace1cca86d9ba0505ad9c976
4
- data.tar.gz: cdca2ddb157f09c5e5913d96e72518c8518bd21defdf3dd0543d65fbeaae6d5b
3
+ metadata.gz: 8a54dcd6810fcef8979772a47975580b51acd528ebc85fbaad40d1b4a6d0f70a
4
+ data.tar.gz: 04e2cae9aca1c0b81eb1a615cacf31f47ce7811bce496e8d12ef1309be92043e
5
5
  SHA512:
6
- metadata.gz: 75ddc0d1ee27a96f70937ccdf9504bf6cd967f4d03c763030782a1f61624fa70e2b4c35508c1992f4828f246dd1e4b2bff82962dbadada4477162ebdc899d3bc
7
- data.tar.gz: b2297967573fcb39b89e98bf3c2f980da1580b1c3ce045cce7737a773903f0f946b36abd0e8112aea2de045beba2dc8a5a6464f83bed8eb3f47158276362382c
6
+ metadata.gz: 925fece7859267df592bb07f1682bcc6d24536c64bbe3eb8c021b46b3b30e235be49ef5703b47dd3317ea2cd2efa004a887980a05563765a61b7b8cb45a04cd1
7
+ data.tar.gz: 10be88edde46c9f97550b384cdc7df24fcf91bcc926cfb36a4ae4d5bcde035994913e79abe0935e1264ca77405432b63233bf75fb666cbc32b9a2d3da9e83329
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.19.0 (2022-11-14)
5
+ ------------------
6
+
7
+ * Feature - Add support for CodeBuild Provisioning
8
+
9
+ 1.18.0 (2022-10-25)
10
+ ------------------
11
+
12
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
13
+
4
14
  1.17.0 (2022-09-29)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.17.0
1
+ 1.19.0
@@ -30,7 +30,7 @@ require 'aws-sdk-core/plugins/http_checksum.rb'
30
30
  require 'aws-sdk-core/plugins/checksum_algorithm.rb'
31
31
  require 'aws-sdk-core/plugins/defaults_mode.rb'
32
32
  require 'aws-sdk-core/plugins/recursion_detection.rb'
33
- require 'aws-sdk-core/plugins/signature_v4.rb'
33
+ require 'aws-sdk-core/plugins/sign.rb'
34
34
  require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
35
35
 
36
36
  Aws::Plugins::GlobalConfiguration.add_identifier(:proton)
@@ -79,8 +79,9 @@ module Aws::Proton
79
79
  add_plugin(Aws::Plugins::ChecksumAlgorithm)
80
80
  add_plugin(Aws::Plugins::DefaultsMode)
81
81
  add_plugin(Aws::Plugins::RecursionDetection)
82
- add_plugin(Aws::Plugins::SignatureV4)
82
+ add_plugin(Aws::Plugins::Sign)
83
83
  add_plugin(Aws::Plugins::Protocols::JsonRpc)
84
+ add_plugin(Aws::Proton::Plugins::Endpoints)
84
85
 
85
86
  # @overload initialize(options)
86
87
  # @param [Hash] options
@@ -297,6 +298,19 @@ module Aws::Proton
297
298
  # ** Please note ** When response stubbing is enabled, no HTTP
298
299
  # requests are made, and retries are disabled.
299
300
  #
301
+ # @option options [Aws::TokenProvider] :token_provider
302
+ # A Bearer Token Provider. This can be an instance of any one of the
303
+ # following classes:
304
+ #
305
+ # * `Aws::StaticTokenProvider` - Used for configuring static, non-refreshing
306
+ # tokens.
307
+ #
308
+ # * `Aws::SSOTokenProvider` - Used for loading tokens from AWS SSO using an
309
+ # access token generated from `aws login`.
310
+ #
311
+ # When `:token_provider` is not configured directly, the `Aws::TokenProviderChain`
312
+ # will be used to search for tokens configured for your profile in shared configuration files.
313
+ #
300
314
  # @option options [Boolean] :use_dualstack_endpoint
301
315
  # When set to `true`, dualstack enabled endpoints (with `.aws` TLD)
302
316
  # will be used if available.
@@ -310,6 +324,9 @@ module Aws::Proton
310
324
  # When `true`, request parameters are validated before
311
325
  # sending the request.
312
326
  #
327
+ # @option options [Aws::Proton::EndpointProvider] :endpoint_provider
328
+ # The endpoint provider used to resolve endpoints. Any object that responds to `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to `Aws::Proton::EndpointParameters`
329
+ #
313
330
  # @option options [URI::HTTP,String] :http_proxy A proxy to send
314
331
  # requests through. Formatted like 'http://proxy.com:123'.
315
332
  #
@@ -389,6 +406,7 @@ module Aws::Proton
389
406
  # @example Response structure
390
407
  #
391
408
  # resp.environment_account_connection.arn #=> String
409
+ # resp.environment_account_connection.codebuild_role_arn #=> String
392
410
  # resp.environment_account_connection.component_role_arn #=> String
393
411
  # resp.environment_account_connection.environment_account_id #=> String
394
412
  # resp.environment_account_connection.environment_name #=> String
@@ -492,6 +510,7 @@ module Aws::Proton
492
510
  # @example Response structure
493
511
  #
494
512
  # resp.environment.arn #=> String
513
+ # resp.environment.codebuild_role_arn #=> String
495
514
  # resp.environment.component_role_arn #=> String
496
515
  # resp.environment.created_at #=> Time
497
516
  # resp.environment.deployment_status #=> String, one of "IN_PROGRESS", "FAILED", "SUCCEEDED", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "CANCELLING", "CANCELLED"
@@ -760,13 +779,18 @@ module Aws::Proton
760
779
  #
761
780
  # **You can provision environments using the following methods:**
762
781
  #
763
- # * Amazon Web Services-managed provisioning: Proton makes direct calls
764
- # to provision your resources.
782
+ # * **Amazon Web Services-managed provisioning** Proton makes direct
783
+ # calls to provision your resources.
765
784
  #
766
- # * Self-managed provisioning: Proton makes pull requests on your
785
+ # * **Self-managed provisioning** Proton makes pull requests on your
767
786
  # repository to provide compiled infrastructure as code (IaC) files
768
787
  # that your IaC engine uses to provision resources.
769
788
  #
789
+ # * **CodeBuild-based provisioning** – Proton uses CodeBuild to run
790
+ # shell commands that you provide. Your commands can read inputs that
791
+ # Proton provides, and are responsible for provisioning or
792
+ # deprovisioning infrastructure and generating output values.
793
+ #
770
794
  # For more information, see [Environments][1] and [Provisioning
771
795
  # methods][2] in the *Proton User Guide*.
772
796
  #
@@ -775,6 +799,15 @@ module Aws::Proton
775
799
  # [1]: https://docs.aws.amazon.com/proton/latest/userguide/ag-environments.html
776
800
  # [2]: https://docs.aws.amazon.com/proton/latest/userguide/ag-works-prov-methods.html
777
801
  #
802
+ # @option params [String] :codebuild_role_arn
803
+ # The Amazon Resource Name (ARN) of the IAM service role that allows
804
+ # Proton to provision infrastructure using CodeBuild-based provisioning
805
+ # on your behalf.
806
+ #
807
+ # To use CodeBuild-based provisioning for the environment or for any
808
+ # service instance running in the environment, specify either the
809
+ # `environmentAccountConnectionId` or `codebuildRoleArn` parameter.
810
+ #
778
811
  # @option params [String] :component_role_arn
779
812
  # The Amazon Resource Name (ARN) of the IAM service role that Proton
780
813
  # uses when provisioning directly defined components in this
@@ -795,15 +828,15 @@ module Aws::Proton
795
828
  # A description of the environment that's being created and deployed.
796
829
  #
797
830
  # @option params [String] :environment_account_connection_id
798
- # The ID of the environment account connection that you provide if
799
- # you're provisioning your environment infrastructure resources to an
800
- # environment account. For more information, see [Environment account
831
+ # The ID of the environment account connection that you provide if you
832
+ # want Proton to provision infrastructure resources for your environment
833
+ # or for any of the service instances running in it in an environment
834
+ # account. For more information, see [Environment account
801
835
  # connections][1] in the *Proton User guide*.
802
836
  #
803
- # To use Amazon Web Services-managed provisioning for the environment,
804
- # specify either the `environmentAccountConnectionId` or
805
- # `protonServiceRoleArn` parameter and omit the `provisioningRepository`
806
- # parameter.
837
+ # If you specify the `environmentAccountConnectionId` parameter, don't
838
+ # specify `protonServiceRoleArn`, `codebuildRoleArn`, or
839
+ # `provisioningRepository`.
807
840
  #
808
841
  #
809
842
  #
@@ -813,12 +846,13 @@ module Aws::Proton
813
846
  # The name of the environment.
814
847
  #
815
848
  # @option params [String] :proton_service_role_arn
816
- # The Amazon Resource Name (ARN) of the Proton service role that allows
817
- # Proton to make calls to other services on your behalf.
849
+ # The Amazon Resource Name (ARN) of the IAM service role that allows
850
+ # Proton to provision infrastructure using Amazon Web Services-managed
851
+ # provisioning and CloudFormation on your behalf.
818
852
  #
819
- # To use Amazon Web Services-managed provisioning for the environment,
820
- # specify either the `environmentAccountConnectionId` or
821
- # `protonServiceRoleArn` parameter and omit the `provisioningRepository`
853
+ # To use Amazon Web Services-managed provisioning for the environment or
854
+ # for any service instance running in the environment, specify either
855
+ # the `environmentAccountConnectionId` or `protonServiceRoleArn`
822
856
  # parameter.
823
857
  #
824
858
  # @option params [Types::RepositoryBranchInput] :provisioning_repository
@@ -827,9 +861,8 @@ module Aws::Proton
827
861
  # repository is a repository that has been registered with Proton. For
828
862
  # more information, see CreateRepository.
829
863
  #
830
- # To use self-managed provisioning for the environment, specify this
831
- # parameter and omit the `environmentAccountConnectionId` and
832
- # `protonServiceRoleArn` parameters.
864
+ # To use self-managed provisioning for the environment or for any
865
+ # service instance running in the environment, specify this parameter.
833
866
  #
834
867
  # @option params [required, String] :spec
835
868
  # A YAML formatted string that provides inputs as defined in the
@@ -872,7 +905,8 @@ module Aws::Proton
872
905
  # @example Request syntax with placeholder values
873
906
  #
874
907
  # resp = client.create_environment({
875
- # component_role_arn: "Arn",
908
+ # codebuild_role_arn: "RoleArn",
909
+ # component_role_arn: "RoleArn",
876
910
  # description: "Description",
877
911
  # environment_account_connection_id: "EnvironmentAccountConnectionId",
878
912
  # name: "ResourceName", # required
@@ -897,6 +931,7 @@ module Aws::Proton
897
931
  # @example Response structure
898
932
  #
899
933
  # resp.environment.arn #=> String
934
+ # resp.environment.codebuild_role_arn #=> String
900
935
  # resp.environment.component_role_arn #=> String
901
936
  # resp.environment.created_at #=> Time
902
937
  # resp.environment.deployment_status #=> String, one of "IN_PROGRESS", "FAILED", "SUCCEEDED", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "CANCELLING", "CANCELLED"
@@ -948,11 +983,18 @@ module Aws::Proton
948
983
  # **A suitable default value is auto-generated.** You should normally
949
984
  # not need to pass this option.**
950
985
  #
986
+ # @option params [String] :codebuild_role_arn
987
+ # The Amazon Resource Name (ARN) of an IAM service role in the
988
+ # environment account. Proton uses this role to provision infrastructure
989
+ # resources using CodeBuild-based provisioning in the associated
990
+ # environment account.
991
+ #
951
992
  # @option params [String] :component_role_arn
952
- # The Amazon Resource Name (ARN) of the IAM service role that Proton
953
- # uses when provisioning directly defined components in the associated
954
- # environment account. It determines the scope of infrastructure that a
955
- # component can provision in the account.
993
+ # The Amazon Resource Name (ARN) of an IAM service role in the
994
+ # environment account. Proton uses this role to provision directly
995
+ # defined components in the associated environment account. It
996
+ # determines the scope of infrastructure that a component can provision
997
+ # in the account.
956
998
  #
957
999
  # You must specify `componentRoleArn` to allow directly defined
958
1000
  # components to be associated with any environments running in this
@@ -978,9 +1020,10 @@ module Aws::Proton
978
1020
  # environment account.
979
1021
  #
980
1022
  # @option params [required, String] :role_arn
981
- # The Amazon Resource Name (ARN) of the IAM service role that's created
982
- # in the environment account. Proton uses this role to provision
983
- # infrastructure resources in the associated environment account.
1023
+ # The Amazon Resource Name (ARN) of an IAM service role in the
1024
+ # environment account. Proton uses this role to provision infrastructure
1025
+ # resources using Amazon Web Services-managed provisioning and
1026
+ # CloudFormation in the associated environment account.
984
1027
  #
985
1028
  # @option params [Array<Types::Tag>] :tags
986
1029
  # An optional list of metadata items that you can associate with the
@@ -1001,10 +1044,11 @@ module Aws::Proton
1001
1044
  #
1002
1045
  # resp = client.create_environment_account_connection({
1003
1046
  # client_token: "ClientToken",
1004
- # component_role_arn: "Arn",
1047
+ # codebuild_role_arn: "RoleArn",
1048
+ # component_role_arn: "RoleArn",
1005
1049
  # environment_name: "ResourceName", # required
1006
1050
  # management_account_id: "AwsAccountId", # required
1007
- # role_arn: "Arn", # required
1051
+ # role_arn: "RoleArn", # required
1008
1052
  # tags: [
1009
1053
  # {
1010
1054
  # key: "TagKey", # required
@@ -1016,6 +1060,7 @@ module Aws::Proton
1016
1060
  # @example Response structure
1017
1061
  #
1018
1062
  # resp.environment_account_connection.arn #=> String
1063
+ # resp.environment_account_connection.codebuild_role_arn #=> String
1019
1064
  # resp.environment_account_connection.component_role_arn #=> String
1020
1065
  # resp.environment_account_connection.environment_account_id #=> String
1021
1066
  # resp.environment_account_connection.environment_name #=> String
@@ -1766,6 +1811,7 @@ module Aws::Proton
1766
1811
  # @example Response structure
1767
1812
  #
1768
1813
  # resp.environment.arn #=> String
1814
+ # resp.environment.codebuild_role_arn #=> String
1769
1815
  # resp.environment.component_role_arn #=> String
1770
1816
  # resp.environment.created_at #=> Time
1771
1817
  # resp.environment.deployment_status #=> String, one of "IN_PROGRESS", "FAILED", "SUCCEEDED", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "CANCELLING", "CANCELLED"
@@ -1828,6 +1874,7 @@ module Aws::Proton
1828
1874
  # @example Response structure
1829
1875
  #
1830
1876
  # resp.environment_account_connection.arn #=> String
1877
+ # resp.environment_account_connection.codebuild_role_arn #=> String
1831
1878
  # resp.environment_account_connection.component_role_arn #=> String
1832
1879
  # resp.environment_account_connection.environment_account_id #=> String
1833
1880
  # resp.environment_account_connection.environment_name #=> String
@@ -2182,6 +2229,7 @@ module Aws::Proton
2182
2229
  #
2183
2230
  # @example Response structure
2184
2231
  #
2232
+ # resp.account_settings.pipeline_codebuild_role_arn #=> String
2185
2233
  # resp.account_settings.pipeline_provisioning_repository.arn #=> String
2186
2234
  # resp.account_settings.pipeline_provisioning_repository.branch #=> String
2187
2235
  # resp.account_settings.pipeline_provisioning_repository.name #=> String
@@ -2269,6 +2317,7 @@ module Aws::Proton
2269
2317
  # @example Response structure
2270
2318
  #
2271
2319
  # resp.environment.arn #=> String
2320
+ # resp.environment.codebuild_role_arn #=> String
2272
2321
  # resp.environment.component_role_arn #=> String
2273
2322
  # resp.environment.created_at #=> Time
2274
2323
  # resp.environment.deployment_status #=> String, one of "IN_PROGRESS", "FAILED", "SUCCEEDED", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "CANCELLING", "CANCELLED"
@@ -2331,6 +2380,7 @@ module Aws::Proton
2331
2380
  # @example Response structure
2332
2381
  #
2333
2382
  # resp.environment_account_connection.arn #=> String
2383
+ # resp.environment_account_connection.codebuild_role_arn #=> String
2334
2384
  # resp.environment_account_connection.component_role_arn #=> String
2335
2385
  # resp.environment_account_connection.environment_account_id #=> String
2336
2386
  # resp.environment_account_connection.environment_name #=> String
@@ -3865,27 +3915,40 @@ module Aws::Proton
3865
3915
  req.send_request(options)
3866
3916
  end
3867
3917
 
3868
- # Notify Proton of status changes to a provisioned resource when you use
3869
- # self-managed provisioning.
3918
+ # Notify Proton of the following information related to a provisioned
3919
+ # resource (environment, service instance, or service pipeline):
3870
3920
  #
3871
- # For more information, see [Self-managed provisioning][1] in the
3872
- # *Proton User Guide*.
3921
+ # * For [CodeBuild-based provisioning][1], provide your provisioned
3922
+ # resource output values to Proton.
3873
3923
  #
3924
+ # * For [self-managed provisioning][2], notify Proton about the status
3925
+ # of your provisioned resource. To disambiguate between different
3926
+ # deployments of the same resource, set `deploymentId` to a unique
3927
+ # deployment ID of your choice.
3874
3928
  #
3929
+ # </li> </ul>
3875
3930
  #
3876
- # [1]: https://docs.aws.amazon.com/proton/latest/userguide/ag-works-prov-methods.html#ag-works-prov-methods-self
3931
+ #
3932
+ #
3933
+ # [1]: https://docs.aws.amazon.com/proton/latest/userguide/ag-works-prov-methods.html#ag-works-prov-methods-codebuild
3934
+ # [2]: https://docs.aws.amazon.com/proton/latest/userguide/ag-works-prov-methods.html#ag-works-prov-methods-self
3877
3935
  #
3878
3936
  # @option params [String] :deployment_id
3879
- # The deployment ID for your provisioned resource.
3937
+ # The deployment ID for your provisioned resource. Proton uses it to
3938
+ # disambiguate different deployments of the resource. Applicable to
3939
+ # [self-managed provisioning][1].
3940
+ #
3941
+ #
3942
+ #
3943
+ # [1]: https://docs.aws.amazon.com/proton/latest/userguide/ag-works-prov-methods.html#ag-works-prov-methods-self
3880
3944
  #
3881
3945
  # @option params [Array<Types::Output>] :outputs
3882
- # The provisioned resource state change detail data that's returned by
3883
- # Proton.
3946
+ # The output values generated by your provisioned resource.
3884
3947
  #
3885
3948
  # @option params [required, String] :resource_arn
3886
- # The provisioned resource Amazon Resource Name (ARN).
3949
+ # The Amazon Resource Name (ARN) of your provisioned resource.
3887
3950
  #
3888
- # @option params [required, String] :status
3951
+ # @option params [String] :status
3889
3952
  # The status of your provisioned resource.
3890
3953
  #
3891
3954
  # @option params [String] :status_message
@@ -3904,7 +3967,7 @@ module Aws::Proton
3904
3967
  # },
3905
3968
  # ],
3906
3969
  # resource_arn: "Arn", # required
3907
- # status: "IN_PROGRESS", # required, accepts IN_PROGRESS, FAILED, SUCCEEDED
3970
+ # status: "IN_PROGRESS", # accepts IN_PROGRESS, FAILED, SUCCEEDED
3908
3971
  # status_message: "NotifyResourceDeploymentStatusChangeInputStatusMessageString",
3909
3972
  # })
3910
3973
  #
@@ -3949,6 +4012,7 @@ module Aws::Proton
3949
4012
  # @example Response structure
3950
4013
  #
3951
4014
  # resp.environment_account_connection.arn #=> String
4015
+ # resp.environment_account_connection.codebuild_role_arn #=> String
3952
4016
  # resp.environment_account_connection.component_role_arn #=> String
3953
4017
  # resp.environment_account_connection.environment_account_id #=> String
3954
4018
  # resp.environment_account_connection.environment_name #=> String
@@ -4052,6 +4116,11 @@ module Aws::Proton
4052
4116
  # account settings. Don't set this field if you are updating the
4053
4117
  # configured pipeline repository.
4054
4118
  #
4119
+ # @option params [String] :pipeline_codebuild_role_arn
4120
+ # The Amazon Resource Name (ARN) of the service role you want to use for
4121
+ # provisioning pipelines. Proton assumes this role for CodeBuild-based
4122
+ # provisioning.
4123
+ #
4055
4124
  # @option params [Types::RepositoryBranchInput] :pipeline_provisioning_repository
4056
4125
  # A linked repository for pipeline provisioning. Specify it if you have
4057
4126
  # environments configured for self-managed provisioning with services
@@ -4079,16 +4148,18 @@ module Aws::Proton
4079
4148
  #
4080
4149
  # resp = client.update_account_settings({
4081
4150
  # delete_pipeline_provisioning_repository: false,
4151
+ # pipeline_codebuild_role_arn: "RoleArnOrEmptyString",
4082
4152
  # pipeline_provisioning_repository: {
4083
4153
  # branch: "GitBranchName", # required
4084
4154
  # name: "RepositoryName", # required
4085
4155
  # provider: "GITHUB", # required, accepts GITHUB, GITHUB_ENTERPRISE, BITBUCKET
4086
4156
  # },
4087
- # pipeline_service_role_arn: "PipelineRoleArn",
4157
+ # pipeline_service_role_arn: "RoleArnOrEmptyString",
4088
4158
  # })
4089
4159
  #
4090
4160
  # @example Response structure
4091
4161
  #
4162
+ # resp.account_settings.pipeline_codebuild_role_arn #=> String
4092
4163
  # resp.account_settings.pipeline_provisioning_repository.arn #=> String
4093
4164
  # resp.account_settings.pipeline_provisioning_repository.branch #=> String
4094
4165
  # resp.account_settings.pipeline_provisioning_repository.name #=> String
@@ -4221,9 +4292,8 @@ module Aws::Proton
4221
4292
  # Update an environment.
4222
4293
  #
4223
4294
  # If the environment is associated with an environment account
4224
- # connection, *don't* update or include the `protonServiceRoleArn` and
4225
- # `provisioningRepository` parameter to update or connect to an
4226
- # environment account connection.
4295
+ # connection, *don't* update or include the `protonServiceRoleArn`,
4296
+ # `codebuildRoleArn`, and `provisioningRepository` parameters.
4227
4297
  #
4228
4298
  # You can only update to a new environment account connection if that
4229
4299
  # connection was created in the same environment account that the
@@ -4236,16 +4306,18 @@ module Aws::Proton
4236
4306
  # connect the environment to an environment account connection if it
4237
4307
  # *isn't* already associated with an environment connection.
4238
4308
  #
4239
- # You can update either the `environmentAccountConnectionId` or
4240
- # `protonServiceRoleArn` parameter and value. You can’t update both.
4309
+ # You can update either `environmentAccountConnectionId` or one or more
4310
+ # of `protonServiceRoleArn`, `codebuildRoleArn`, and
4311
+ # `provisioningRepository`.
4241
4312
  #
4242
- # If the environment was configured for Amazon Web Services-managed
4243
- # provisioning, omit the `provisioningRepository` parameter.
4313
+ # If the environment was configured for Amazon Web Services-managed or
4314
+ # CodeBuild-based provisioning, omit the `provisioningRepository`
4315
+ # parameter.
4244
4316
  #
4245
4317
  # If the environment was configured for self-managed provisioning,
4246
4318
  # specify the `provisioningRepository` parameter and omit the
4247
- # `protonServiceRoleArn` and `environmentAccountConnectionId`
4248
- # parameters.
4319
+ # `protonServiceRoleArn`, `codebuildRoleArn`, and
4320
+ # `provisioningRepository` parameters.
4249
4321
  #
4250
4322
  # For more information, see [Environments][1] and [Provisioning
4251
4323
  # methods][2] in the *Proton User Guide*.
@@ -4293,6 +4365,11 @@ module Aws::Proton
4293
4365
  # [1]: https://docs.aws.amazon.com/proton/latest/userguide/ag-environments.html
4294
4366
  # [2]: https://docs.aws.amazon.com/proton/latest/userguide/ag-works-prov-methods.html
4295
4367
  #
4368
+ # @option params [String] :codebuild_role_arn
4369
+ # The Amazon Resource Name (ARN) of the IAM service role that allows
4370
+ # Proton to provision infrastructure using CodeBuild-based provisioning
4371
+ # on your behalf.
4372
+ #
4296
4373
  # @option params [String] :component_role_arn
4297
4374
  # The Amazon Resource Name (ARN) of the IAM service role that Proton
4298
4375
  # uses when provisioning directly defined components in this
@@ -4352,19 +4429,28 @@ module Aws::Proton
4352
4429
  # A description of the environment update.
4353
4430
  #
4354
4431
  # @option params [String] :environment_account_connection_id
4355
- # The ID of the environment account connection.
4432
+ # The ID of the environment account connection that you provide if you
4433
+ # want Proton to provision infrastructure resources for your environment
4434
+ # or for any of the service instances running in it in an environment
4435
+ # account. For more information, see [Environment account
4436
+ # connections][1] in the *Proton User guide*.
4356
4437
  #
4357
4438
  # You can only update to a new environment account connection if it was
4358
4439
  # created in the same environment account that the current environment
4359
4440
  # account connection was created in and is associated with the current
4360
4441
  # environment.
4361
4442
  #
4443
+ #
4444
+ #
4445
+ # [1]: https://docs.aws.amazon.com/proton/latest/userguide/ag-env-account-connections.html
4446
+ #
4362
4447
  # @option params [required, String] :name
4363
4448
  # The name of the environment to update.
4364
4449
  #
4365
4450
  # @option params [String] :proton_service_role_arn
4366
- # The Amazon Resource Name (ARN) of the Proton service role that allows
4367
- # Proton to make API calls to other services your behalf.
4451
+ # The Amazon Resource Name (ARN) of the IAM service role that allows
4452
+ # Proton to provision infrastructure using Amazon Web Services-managed
4453
+ # provisioning and CloudFormation on your behalf.
4368
4454
  #
4369
4455
  # @option params [Types::RepositoryBranchInput] :provisioning_repository
4370
4456
  # The linked repository that you use to host your rendered
@@ -4388,7 +4474,8 @@ module Aws::Proton
4388
4474
  # @example Request syntax with placeholder values
4389
4475
  #
4390
4476
  # resp = client.update_environment({
4391
- # component_role_arn: "Arn",
4477
+ # codebuild_role_arn: "RoleArn",
4478
+ # component_role_arn: "RoleArn",
4392
4479
  # deployment_type: "NONE", # required, accepts NONE, CURRENT_VERSION, MINOR_VERSION, MAJOR_VERSION
4393
4480
  # description: "Description",
4394
4481
  # environment_account_connection_id: "EnvironmentAccountConnectionId",
@@ -4407,6 +4494,7 @@ module Aws::Proton
4407
4494
  # @example Response structure
4408
4495
  #
4409
4496
  # resp.environment.arn #=> String
4497
+ # resp.environment.codebuild_role_arn #=> String
4410
4498
  # resp.environment.component_role_arn #=> String
4411
4499
  # resp.environment.created_at #=> Time
4412
4500
  # resp.environment.deployment_status #=> String, one of "IN_PROGRESS", "FAILED", "SUCCEEDED", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "CANCELLING", "CANCELLED"
@@ -4447,6 +4535,12 @@ module Aws::Proton
4447
4535
  #
4448
4536
  # [1]: https://docs.aws.amazon.com/proton/latest/userguide/ag-env-account-connections.html
4449
4537
  #
4538
+ # @option params [String] :codebuild_role_arn
4539
+ # The Amazon Resource Name (ARN) of an IAM service role in the
4540
+ # environment account. Proton uses this role to provision infrastructure
4541
+ # resources using CodeBuild-based provisioning in the associated
4542
+ # environment account.
4543
+ #
4450
4544
  # @option params [String] :component_role_arn
4451
4545
  # The Amazon Resource Name (ARN) of the IAM service role that Proton
4452
4546
  # uses when provisioning directly defined components in the associated
@@ -4468,8 +4562,10 @@ module Aws::Proton
4468
4562
  # The ID of the environment account connection to update.
4469
4563
  #
4470
4564
  # @option params [String] :role_arn
4471
- # The Amazon Resource Name (ARN) of the IAM service role that's
4472
- # associated with the environment account connection to update.
4565
+ # The Amazon Resource Name (ARN) of an IAM service role in the
4566
+ # environment account. Proton uses this role to provision infrastructure
4567
+ # resources using Amazon Web Services-managed provisioning and
4568
+ # CloudFormation in the associated environment account.
4473
4569
  #
4474
4570
  # @return [Types::UpdateEnvironmentAccountConnectionOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4475
4571
  #
@@ -4478,14 +4574,16 @@ module Aws::Proton
4478
4574
  # @example Request syntax with placeholder values
4479
4575
  #
4480
4576
  # resp = client.update_environment_account_connection({
4481
- # component_role_arn: "Arn",
4577
+ # codebuild_role_arn: "RoleArn",
4578
+ # component_role_arn: "RoleArn",
4482
4579
  # id: "EnvironmentAccountConnectionId", # required
4483
- # role_arn: "Arn",
4580
+ # role_arn: "RoleArn",
4484
4581
  # })
4485
4582
  #
4486
4583
  # @example Response structure
4487
4584
  #
4488
4585
  # resp.environment_account_connection.arn #=> String
4586
+ # resp.environment_account_connection.codebuild_role_arn #=> String
4489
4587
  # resp.environment_account_connection.component_role_arn #=> String
4490
4588
  # resp.environment_account_connection.environment_account_id #=> String
4491
4589
  # resp.environment_account_connection.environment_name #=> String
@@ -5143,7 +5241,7 @@ module Aws::Proton
5143
5241
  params: params,
5144
5242
  config: config)
5145
5243
  context[:gem_name] = 'aws-sdk-proton'
5146
- context[:gem_version] = '1.17.0'
5244
+ context[:gem_version] = '1.19.0'
5147
5245
  Seahorse::Client::Request.new(handlers, context)
5148
5246
  end
5149
5247