aws-sdk-servicecatalog 1.73.0 → 1.75.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: e511847ebbd21746b87b9f2d3d8f9bfd6fe1e89d8f37556c79c39bb83fcb0490
4
- data.tar.gz: 5e487e19e62d5aca884f1fa6c484f534ab19862e73603c4198d46fa2b968c376
3
+ metadata.gz: 5d149236a4cb058da7355fe19ca4e36f0b5ceb251562b93dde67adc07d17ac71
4
+ data.tar.gz: 07a329eb9cfce62621763149c9ce65bfc9ee71f4c7fdfe44a5cdc0d3efc94c21
5
5
  SHA512:
6
- metadata.gz: 7b31a582d1ef8c9a6dd1907ac60e3bfed451e5d2eb7321f5b17802147d52815e711a6dd72dcb45749b58a209e4fe0b201dfb57b54e898901fcad62bb177355eb
7
- data.tar.gz: 03ea2f8ce25d18a80528a60429a67ea0689071b3a9d9479082a55f480af42c9af3ff85f3a7bc93ba890c2def4f6a704ca4a75b193aa0110a25c796529fa6ddf6
6
+ metadata.gz: 33ab831882059f38f597cf475229edc11e705db145b56583b90c32d963a20aa06bfe75f8ceeee40e49d22d39d1c07b69ca70bc4b1e684c81430a53ff79f35fec
7
+ data.tar.gz: e7b5598ce52ef0302cfc056e76d2dc05977a37940707b1a7823199634c93d002b02777e2537569488297040ab46531ed54b691d5074f29ccfc99ff2e52d53520
data/CHANGELOG.md CHANGED
@@ -1,6 +1,18 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.75.0 (2023-01-18)
5
+ ------------------
6
+
7
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
8
+
9
+ * Issue - Replace runtime endpoint resolution approach with generated ruby code.
10
+
11
+ 1.74.0 (2022-11-18)
12
+ ------------------
13
+
14
+ * Feature - This release 1. adds support for Principal Name Sharing with Service Catalog portfolio sharing. 2. Introduces repo sourced products which are created and managed with existing SC APIs. These products are synced to external repos and auto create new product versions based on changes in the repo.
15
+
4
16
  1.73.0 (2022-10-25)
5
17
  ------------------
6
18
 
@@ -440,4 +452,4 @@ Unreleased Changes
440
452
  1.0.0.rc1 (2016-12-05)
441
453
  ------------------
442
454
 
443
- * Feature - Initial preview release of the `aws-sdk-servicecatalog` gem.
455
+ * Feature - Initial preview release of the `aws-sdk-servicecatalog` gem.
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.73.0
1
+ 1.75.0
@@ -454,6 +454,29 @@ module Aws::ServiceCatalog
454
454
 
455
455
  # Associates the specified principal ARN with the specified portfolio.
456
456
  #
457
+ # If you share the portfolio with principal name sharing enabled, the
458
+ # `PrincipalARN` association is included in the share.
459
+ #
460
+ # The `PortfolioID`, `PrincipalARN`, and `PrincipalType` parameters are
461
+ # required.
462
+ #
463
+ # You can associate a maximum of 10 Principals with a portfolio using
464
+ # `PrincipalType` as `IAM_PATTERN`
465
+ #
466
+ # <note markdown="1"> When you associate a principal with portfolio, a potential privilege
467
+ # escalation path may occur when that portfolio is then shared with
468
+ # other accounts. For a user in a recipient account who is *not* an
469
+ # Service Catalog Admin, but still has the ability to create Principals
470
+ # (Users/Groups/Roles), that user could create a role that matches a
471
+ # principal name association for the portfolio. Although this user may
472
+ # not know which principal names are associated through Service Catalog,
473
+ # they may be able to guess the user. If this potential escalation path
474
+ # is a concern, then Service Catalog recommends using `PrincipalType` as
475
+ # `IAM`. With this configuration, the `PrincipalARN` must already exist
476
+ # in the recipient account before it can be associated.
477
+ #
478
+ # </note>
479
+ #
457
480
  # @option params [String] :accept_language
458
481
  # The language code.
459
482
  #
@@ -467,10 +490,17 @@ module Aws::ServiceCatalog
467
490
  # The portfolio identifier.
468
491
  #
469
492
  # @option params [required, String] :principal_arn
470
- # The ARN of the principal (IAM user, role, or group).
493
+ # The ARN of the principal (IAM user, role, or group). This field allows
494
+ # an ARN with no `accountID` if `PrincipalType` is `IAM_PATTERN`.
495
+ #
496
+ # You can associate multiple `IAM` patterns even if the account has no
497
+ # principal with that name. This is useful in Principal Name Sharing if
498
+ # you want to share a principal without creating it in the account that
499
+ # owns the portfolio.
471
500
  #
472
501
  # @option params [required, String] :principal_type
473
- # The principal type. The supported value is `IAM`.
502
+ # The principal type. The supported value is `IAM` if you use a fully
503
+ # defined ARN, or `IAM_PATTERN` if you use an ARN with no `accountID`.
474
504
  #
475
505
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
476
506
  #
@@ -480,7 +510,7 @@ module Aws::ServiceCatalog
480
510
  # accept_language: "AcceptLanguage",
481
511
  # portfolio_id: "Id", # required
482
512
  # principal_arn: "PrincipalARN", # required
483
- # principal_type: "IAM", # required, accepts IAM
513
+ # principal_type: "IAM", # required, accepts IAM, IAM_PATTERN
484
514
  # })
485
515
  #
486
516
  # @see http://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/AssociatePrincipalWithPortfolio AWS API Documentation
@@ -1035,6 +1065,20 @@ module Aws::ServiceCatalog
1035
1065
  # error. To update an existing share, you must use the `
1036
1066
  # UpdatePortfolioShare` API instead.
1037
1067
  #
1068
+ # <note markdown="1"> When you associate a principal with portfolio, a potential privilege
1069
+ # escalation path may occur when that portfolio is then shared with
1070
+ # other accounts. For a user in a recipient account who is *not* an
1071
+ # Service Catalog Admin, but still has the ability to create Principals
1072
+ # (Users/Groups/Roles), that user could create a role that matches a
1073
+ # principal name association for the portfolio. Although this user may
1074
+ # not know which principal names are associated through Service Catalog,
1075
+ # they may be able to guess the user. If this potential escalation path
1076
+ # is a concern, then Service Catalog recommends using `PrincipalType` as
1077
+ # `IAM`. With this configuration, the `PrincipalARN` must already exist
1078
+ # in the recipient account before it can be associated.
1079
+ #
1080
+ # </note>
1081
+ #
1038
1082
  # @option params [String] :accept_language
1039
1083
  # The language code.
1040
1084
  #
@@ -1062,6 +1106,18 @@ module Aws::ServiceCatalog
1062
1106
  # Enables or disables `TagOptions ` sharing when creating the portfolio
1063
1107
  # share. If this flag is not provided, TagOptions sharing is disabled.
1064
1108
  #
1109
+ # @option params [Boolean] :share_principals
1110
+ # Enables or disables `Principal` sharing when creating the portfolio
1111
+ # share. If this flag is not provided, principal sharing is disabled.
1112
+ #
1113
+ # When you enable Principal Name Sharing for a portfolio share, the
1114
+ # share recipient account end users with a principal that matches any of
1115
+ # the associated IAM patterns can provision products from the portfolio.
1116
+ # Once shared, the share recipient can view associations of
1117
+ # `PrincipalType`\: `IAM_PATTERN` on their portfolio. You can create the
1118
+ # principals in the recipient account before or after creating the
1119
+ # share.
1120
+ #
1065
1121
  # @return [Types::CreatePortfolioShareOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1066
1122
  #
1067
1123
  # * {Types::CreatePortfolioShareOutput#portfolio_share_token #portfolio_share_token} => String
@@ -1077,6 +1133,7 @@ module Aws::ServiceCatalog
1077
1133
  # value: "OrganizationNodeValue",
1078
1134
  # },
1079
1135
  # share_tag_options: false,
1136
+ # share_principals: false,
1080
1137
  # })
1081
1138
  #
1082
1139
  # @example Response structure
@@ -1139,7 +1196,7 @@ module Aws::ServiceCatalog
1139
1196
  # @option params [Array<Types::Tag>] :tags
1140
1197
  # One or more tags.
1141
1198
  #
1142
- # @option params [required, Types::ProvisioningArtifactProperties] :provisioning_artifact_parameters
1199
+ # @option params [Types::ProvisioningArtifactProperties] :provisioning_artifact_parameters
1143
1200
  # The configuration of the provisioning artifact.
1144
1201
  #
1145
1202
  # @option params [required, String] :idempotency_token
@@ -1150,6 +1207,16 @@ module Aws::ServiceCatalog
1150
1207
  # **A suitable default value is auto-generated.** You should normally
1151
1208
  # not need to pass this option.**
1152
1209
  #
1210
+ # @option params [Types::SourceConnection] :source_connection
1211
+ # Specifies connection details for the created product and syncs the
1212
+ # product to the connection source artifact. This automatically manages
1213
+ # the product's artifacts based on changes to the source. The
1214
+ # `SourceConnection` parameter consists of the following sub-fields.
1215
+ #
1216
+ # * `Type`
1217
+ #
1218
+ # * `ConnectionParamters`
1219
+ #
1153
1220
  # @return [Types::CreateProductOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1154
1221
  #
1155
1222
  # * {Types::CreateProductOutput#product_view_detail #product_view_detail} => Types::ProductViewDetail
@@ -1174,16 +1241,27 @@ module Aws::ServiceCatalog
1174
1241
  # value: "TagValue", # required
1175
1242
  # },
1176
1243
  # ],
1177
- # provisioning_artifact_parameters: { # required
1244
+ # provisioning_artifact_parameters: {
1178
1245
  # name: "ProvisioningArtifactName",
1179
1246
  # description: "ProvisioningArtifactDescription",
1180
- # info: { # required
1247
+ # info: {
1181
1248
  # "ProvisioningArtifactInfoKey" => "ProvisioningArtifactInfoValue",
1182
1249
  # },
1183
1250
  # type: "CLOUD_FORMATION_TEMPLATE", # accepts CLOUD_FORMATION_TEMPLATE, MARKETPLACE_AMI, MARKETPLACE_CAR
1184
1251
  # disable_template_validation: false,
1185
1252
  # },
1186
1253
  # idempotency_token: "IdempotencyToken", # required
1254
+ # source_connection: {
1255
+ # type: "CODESTAR", # accepts CODESTAR
1256
+ # connection_parameters: { # required
1257
+ # code_star: {
1258
+ # connection_arn: "CodeStarConnectionArn", # required
1259
+ # repository: "Repository", # required
1260
+ # branch: "RepositoryBranch", # required
1261
+ # artifact_path: "RepositoryArtifactPath", # required
1262
+ # },
1263
+ # },
1264
+ # },
1187
1265
  # })
1188
1266
  #
1189
1267
  # @example Response structure
@@ -1202,6 +1280,16 @@ module Aws::ServiceCatalog
1202
1280
  # resp.product_view_detail.status #=> String, one of "AVAILABLE", "CREATING", "FAILED"
1203
1281
  # resp.product_view_detail.product_arn #=> String
1204
1282
  # resp.product_view_detail.created_time #=> Time
1283
+ # resp.product_view_detail.source_connection.type #=> String, one of "CODESTAR"
1284
+ # resp.product_view_detail.source_connection.connection_parameters.code_star.connection_arn #=> String
1285
+ # resp.product_view_detail.source_connection.connection_parameters.code_star.repository #=> String
1286
+ # resp.product_view_detail.source_connection.connection_parameters.code_star.branch #=> String
1287
+ # resp.product_view_detail.source_connection.connection_parameters.code_star.artifact_path #=> String
1288
+ # resp.product_view_detail.source_connection.last_sync.last_sync_time #=> Time
1289
+ # resp.product_view_detail.source_connection.last_sync.last_sync_status #=> String, one of "SUCCEEDED", "FAILED"
1290
+ # resp.product_view_detail.source_connection.last_sync.last_sync_status_message #=> String
1291
+ # resp.product_view_detail.source_connection.last_sync.last_successful_sync_time #=> Time
1292
+ # resp.product_view_detail.source_connection.last_sync.last_successful_sync_provisioning_artifact_id #=> String
1205
1293
  # resp.provisioning_artifact_detail.id #=> String
1206
1294
  # resp.provisioning_artifact_detail.name #=> String
1207
1295
  # resp.provisioning_artifact_detail.description #=> String
@@ -1209,6 +1297,7 @@ module Aws::ServiceCatalog
1209
1297
  # resp.provisioning_artifact_detail.created_time #=> Time
1210
1298
  # resp.provisioning_artifact_detail.active #=> Boolean
1211
1299
  # resp.provisioning_artifact_detail.guidance #=> String, one of "DEFAULT", "DEPRECATED"
1300
+ # resp.provisioning_artifact_detail.source_revision #=> String
1212
1301
  # resp.tags #=> Array
1213
1302
  # resp.tags[0].key #=> String
1214
1303
  # resp.tags[0].value #=> String
@@ -1391,7 +1480,7 @@ module Aws::ServiceCatalog
1391
1480
  # parameters: { # required
1392
1481
  # name: "ProvisioningArtifactName",
1393
1482
  # description: "ProvisioningArtifactDescription",
1394
- # info: { # required
1483
+ # info: {
1395
1484
  # "ProvisioningArtifactInfoKey" => "ProvisioningArtifactInfoValue",
1396
1485
  # },
1397
1486
  # type: "CLOUD_FORMATION_TEMPLATE", # accepts CLOUD_FORMATION_TEMPLATE, MARKETPLACE_AMI, MARKETPLACE_CAR
@@ -1409,6 +1498,7 @@ module Aws::ServiceCatalog
1409
1498
  # resp.provisioning_artifact_detail.created_time #=> Time
1410
1499
  # resp.provisioning_artifact_detail.active #=> Boolean
1411
1500
  # resp.provisioning_artifact_detail.guidance #=> String, one of "DEFAULT", "DEPRECATED"
1501
+ # resp.provisioning_artifact_detail.source_revision #=> String
1412
1502
  # resp.info #=> Hash
1413
1503
  # resp.info["ProvisioningArtifactInfoKey"] #=> String
1414
1504
  # resp.status #=> String, one of "AVAILABLE", "CREATING", "FAILED"
@@ -2106,6 +2196,7 @@ module Aws::ServiceCatalog
2106
2196
  # resp.portfolio_share_details[0].type #=> String, one of "ACCOUNT", "ORGANIZATION", "ORGANIZATIONAL_UNIT", "ORGANIZATION_MEMBER_ACCOUNT"
2107
2197
  # resp.portfolio_share_details[0].accepted #=> Boolean
2108
2198
  # resp.portfolio_share_details[0].share_tag_options #=> Boolean
2199
+ # resp.portfolio_share_details[0].share_principals #=> Boolean
2109
2200
  #
2110
2201
  # @see http://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/DescribePortfolioShares AWS API Documentation
2111
2202
  #
@@ -2243,6 +2334,16 @@ module Aws::ServiceCatalog
2243
2334
  # resp.product_view_detail.status #=> String, one of "AVAILABLE", "CREATING", "FAILED"
2244
2335
  # resp.product_view_detail.product_arn #=> String
2245
2336
  # resp.product_view_detail.created_time #=> Time
2337
+ # resp.product_view_detail.source_connection.type #=> String, one of "CODESTAR"
2338
+ # resp.product_view_detail.source_connection.connection_parameters.code_star.connection_arn #=> String
2339
+ # resp.product_view_detail.source_connection.connection_parameters.code_star.repository #=> String
2340
+ # resp.product_view_detail.source_connection.connection_parameters.code_star.branch #=> String
2341
+ # resp.product_view_detail.source_connection.connection_parameters.code_star.artifact_path #=> String
2342
+ # resp.product_view_detail.source_connection.last_sync.last_sync_time #=> Time
2343
+ # resp.product_view_detail.source_connection.last_sync.last_sync_status #=> String, one of "SUCCEEDED", "FAILED"
2344
+ # resp.product_view_detail.source_connection.last_sync.last_sync_status_message #=> String
2345
+ # resp.product_view_detail.source_connection.last_sync.last_successful_sync_time #=> Time
2346
+ # resp.product_view_detail.source_connection.last_sync.last_successful_sync_provisioning_artifact_id #=> String
2246
2347
  # resp.provisioning_artifact_summaries #=> Array
2247
2348
  # resp.provisioning_artifact_summaries[0].id #=> String
2248
2349
  # resp.provisioning_artifact_summaries[0].name #=> String
@@ -2529,6 +2630,7 @@ module Aws::ServiceCatalog
2529
2630
  # resp.provisioning_artifact_detail.created_time #=> Time
2530
2631
  # resp.provisioning_artifact_detail.active #=> Boolean
2531
2632
  # resp.provisioning_artifact_detail.guidance #=> String, one of "DEFAULT", "DEPRECATED"
2633
+ # resp.provisioning_artifact_detail.source_revision #=> String
2532
2634
  # resp.info #=> Hash
2533
2635
  # resp.info["ProvisioningArtifactInfoKey"] #=> String
2534
2636
  # resp.status #=> String, one of "AVAILABLE", "CREATING", "FAILED"
@@ -2924,6 +3026,17 @@ module Aws::ServiceCatalog
2924
3026
  # Disassociates a previously associated principal ARN from a specified
2925
3027
  # portfolio.
2926
3028
  #
3029
+ # The `PrincipalType` and `PrincipalARN` must match the
3030
+ # `AssociatePrincipalWithPortfolio` call request details. For example,
3031
+ # to disassociate an association created with a `PrincipalARN` of
3032
+ # `PrincipalType` IAM you must use the `PrincipalType` IAM when calling
3033
+ # `DisassociatePrincipalFromPortfolio`.
3034
+ #
3035
+ # For portfolios that have been shared with principal name sharing
3036
+ # enabled: after disassociating a principal, share recipient accounts
3037
+ # will no longer be able to provision products in this portfolio using a
3038
+ # role matching the name of the associated principal.
3039
+ #
2927
3040
  # @option params [String] :accept_language
2928
3041
  # The language code.
2929
3042
  #
@@ -2937,7 +3050,12 @@ module Aws::ServiceCatalog
2937
3050
  # The portfolio identifier.
2938
3051
  #
2939
3052
  # @option params [required, String] :principal_arn
2940
- # The ARN of the principal (IAM user, role, or group).
3053
+ # The ARN of the principal (IAM user, role, or group). This field allows
3054
+ # an ARN with no `accountID` if `PrincipalType` is `IAM_PATTERN`.
3055
+ #
3056
+ # @option params [String] :principal_type
3057
+ # The supported value is `IAM` if you use a fully defined ARN, or
3058
+ # `IAM_PATTERN` if you use no `accountID`.
2941
3059
  #
2942
3060
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2943
3061
  #
@@ -2947,6 +3065,7 @@ module Aws::ServiceCatalog
2947
3065
  # accept_language: "AcceptLanguage",
2948
3066
  # portfolio_id: "Id", # required
2949
3067
  # principal_arn: "PrincipalARN", # required
3068
+ # principal_type: "IAM", # accepts IAM, IAM_PATTERN
2950
3069
  # })
2951
3070
  #
2952
3071
  # @see http://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/DisassociatePrincipalFromPortfolio AWS API Documentation
@@ -3328,11 +3447,10 @@ module Aws::ServiceCatalog
3328
3447
  req.send_request(options)
3329
3448
  end
3330
3449
 
3331
- # Requests the import of a resource as a Amazon Web Services Service
3332
- # Catalog provisioned product that is associated to a Amazon Web
3333
- # Services Service Catalog product and provisioning artifact. Once
3334
- # imported, all supported Amazon Web Services Service Catalog governance
3335
- # actions are supported on the provisioned product.
3450
+ # Requests the import of a resource as an Service Catalog provisioned
3451
+ # product that is associated to an Service Catalog product and
3452
+ # provisioning artifact. Once imported, all supported Service Catalog
3453
+ # governance actions are supported on the provisioned product.
3336
3454
  #
3337
3455
  # Resource import only supports CloudFormation stack ARNs.
3338
3456
  # CloudFormation StackSets and non-root nested stacks are not supported.
@@ -3343,8 +3461,7 @@ module Aws::ServiceCatalog
3343
3461
  # `IMPORT_ROLLBACK_COMPLETE`.
3344
3462
  #
3345
3463
  # Import of the resource requires that the CloudFormation stack template
3346
- # matches the associated Amazon Web Services Service Catalog product
3347
- # provisioning artifact.
3464
+ # matches the associated Service Catalog product provisioning artifact.
3348
3465
  #
3349
3466
  # The user or role that performs this operation must have the
3350
3467
  # `cloudformation:GetTemplate` and `cloudformation:DescribeStacks` IAM
@@ -3913,7 +4030,8 @@ module Aws::ServiceCatalog
3913
4030
  req.send_request(options)
3914
4031
  end
3915
4032
 
3916
- # Lists all principal ARNs associated with the specified portfolio.
4033
+ # Lists all `PrincipalARN`s and corresponding `PrincipalType`s
4034
+ # associated with the specified portfolio.
3917
4035
  #
3918
4036
  # @option params [String] :accept_language
3919
4037
  # The language code.
@@ -3954,7 +4072,7 @@ module Aws::ServiceCatalog
3954
4072
  #
3955
4073
  # resp.principals #=> Array
3956
4074
  # resp.principals[0].principal_arn #=> String
3957
- # resp.principals[0].principal_type #=> String, one of "IAM"
4075
+ # resp.principals[0].principal_type #=> String, one of "IAM", "IAM_PATTERN"
3958
4076
  # resp.next_page_token #=> String
3959
4077
  #
3960
4078
  # @see http://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/ListPrincipalsForPortfolio AWS API Documentation
@@ -4066,6 +4184,7 @@ module Aws::ServiceCatalog
4066
4184
  # resp.provisioning_artifact_details[0].created_time #=> Time
4067
4185
  # resp.provisioning_artifact_details[0].active #=> Boolean
4068
4186
  # resp.provisioning_artifact_details[0].guidance #=> String, one of "DEFAULT", "DEPRECATED"
4187
+ # resp.provisioning_artifact_details[0].source_revision #=> String
4069
4188
  # resp.next_page_token #=> String
4070
4189
  #
4071
4190
  # @see http://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/ListProvisioningArtifacts AWS API Documentation
@@ -4903,6 +5022,16 @@ module Aws::ServiceCatalog
4903
5022
  # resp.product_view_details[0].status #=> String, one of "AVAILABLE", "CREATING", "FAILED"
4904
5023
  # resp.product_view_details[0].product_arn #=> String
4905
5024
  # resp.product_view_details[0].created_time #=> Time
5025
+ # resp.product_view_details[0].source_connection.type #=> String, one of "CODESTAR"
5026
+ # resp.product_view_details[0].source_connection.connection_parameters.code_star.connection_arn #=> String
5027
+ # resp.product_view_details[0].source_connection.connection_parameters.code_star.repository #=> String
5028
+ # resp.product_view_details[0].source_connection.connection_parameters.code_star.branch #=> String
5029
+ # resp.product_view_details[0].source_connection.connection_parameters.code_star.artifact_path #=> String
5030
+ # resp.product_view_details[0].source_connection.last_sync.last_sync_time #=> Time
5031
+ # resp.product_view_details[0].source_connection.last_sync.last_sync_status #=> String, one of "SUCCEEDED", "FAILED"
5032
+ # resp.product_view_details[0].source_connection.last_sync.last_sync_status_message #=> String
5033
+ # resp.product_view_details[0].source_connection.last_sync.last_successful_sync_time #=> Time
5034
+ # resp.product_view_details[0].source_connection.last_sync.last_successful_sync_provisioning_artifact_id #=> String
4906
5035
  # resp.next_page_token #=> String
4907
5036
  #
4908
5037
  # @see http://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/SearchProductsAsAdmin AWS API Documentation
@@ -5317,9 +5446,10 @@ module Aws::ServiceCatalog
5317
5446
  end
5318
5447
 
5319
5448
  # Updates the specified portfolio share. You can use this API to enable
5320
- # or disable TagOptions sharing for an existing portfolio share.
5449
+ # or disable `TagOptions` sharing or Principal sharing for an existing
5450
+ # portfolio share.
5321
5451
  #
5322
- # The portfolio share cannot be updated if the ` CreatePortfolioShare`
5452
+ # The portfolio share cannot be updated if the `CreatePortfolioShare`
5323
5453
  # operation is `IN_PROGRESS`, as the share is not available to recipient
5324
5454
  # entities. In this case, you must wait for the portfolio share to be
5325
5455
  # COMPLETED.
@@ -5334,6 +5464,20 @@ module Aws::ServiceCatalog
5334
5464
  # This API cannot be used for removing the portfolio share. You must use
5335
5465
  # `DeletePortfolioShare` API for that action.
5336
5466
  #
5467
+ # <note markdown="1"> When you associate a principal with portfolio, a potential privilege
5468
+ # escalation path may occur when that portfolio is then shared with
5469
+ # other accounts. For a user in a recipient account who is *not* an
5470
+ # Service Catalog Admin, but still has the ability to create Principals
5471
+ # (Users/Groups/Roles), that user could create a role that matches a
5472
+ # principal name association for the portfolio. Although this user may
5473
+ # not know which principal names are associated through Service Catalog,
5474
+ # they may be able to guess the user. If this potential escalation path
5475
+ # is a concern, then Service Catalog recommends using `PrincipalType` as
5476
+ # `IAM`. With this configuration, the `PrincipalARN` must already exist
5477
+ # in the recipient account before it can be associated.
5478
+ #
5479
+ # </note>
5480
+ #
5337
5481
  # @option params [String] :accept_language
5338
5482
  # The language code.
5339
5483
  #
@@ -5356,8 +5500,13 @@ module Aws::ServiceCatalog
5356
5500
  # Information about the organization node.
5357
5501
  #
5358
5502
  # @option params [Boolean] :share_tag_options
5359
- # A flag to enable or disable TagOptions sharing for the portfolio
5360
- # share. If this field is not provided, the current state of TagOptions
5503
+ # Enables or disables `TagOptions` sharing for the portfolio share. If
5504
+ # this field is not provided, the current state of TagOptions sharing on
5505
+ # the portfolio share will not be modified.
5506
+ #
5507
+ # @option params [Boolean] :share_principals
5508
+ # A flag to enables or disables `Principals` sharing in the portfolio.
5509
+ # If this field is not provided, the current state of the `Principals`
5361
5510
  # sharing on the portfolio share will not be modified.
5362
5511
  #
5363
5512
  # @return [Types::UpdatePortfolioShareOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -5376,6 +5525,7 @@ module Aws::ServiceCatalog
5376
5525
  # value: "OrganizationNodeValue",
5377
5526
  # },
5378
5527
  # share_tag_options: false,
5528
+ # share_principals: false,
5379
5529
  # })
5380
5530
  #
5381
5531
  # @example Response structure
@@ -5433,6 +5583,16 @@ module Aws::ServiceCatalog
5433
5583
  # @option params [Array<String>] :remove_tags
5434
5584
  # The tags to remove from the product.
5435
5585
  #
5586
+ # @option params [Types::SourceConnection] :source_connection
5587
+ # Specifies connection details for the updated product and syncs the
5588
+ # product to the connection source artifact. This automatically manages
5589
+ # the product's artifacts based on changes to the source. The
5590
+ # `SourceConnection` parameter consists of the following sub-fields.
5591
+ #
5592
+ # * `Type`
5593
+ #
5594
+ # * `ConnectionParamters`
5595
+ #
5436
5596
  # @return [Types::UpdateProductOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5437
5597
  #
5438
5598
  # * {Types::UpdateProductOutput#product_view_detail #product_view_detail} => Types::ProductViewDetail
@@ -5457,6 +5617,17 @@ module Aws::ServiceCatalog
5457
5617
  # },
5458
5618
  # ],
5459
5619
  # remove_tags: ["TagKey"],
5620
+ # source_connection: {
5621
+ # type: "CODESTAR", # accepts CODESTAR
5622
+ # connection_parameters: { # required
5623
+ # code_star: {
5624
+ # connection_arn: "CodeStarConnectionArn", # required
5625
+ # repository: "Repository", # required
5626
+ # branch: "RepositoryBranch", # required
5627
+ # artifact_path: "RepositoryArtifactPath", # required
5628
+ # },
5629
+ # },
5630
+ # },
5460
5631
  # })
5461
5632
  #
5462
5633
  # @example Response structure
@@ -5475,6 +5646,16 @@ module Aws::ServiceCatalog
5475
5646
  # resp.product_view_detail.status #=> String, one of "AVAILABLE", "CREATING", "FAILED"
5476
5647
  # resp.product_view_detail.product_arn #=> String
5477
5648
  # resp.product_view_detail.created_time #=> Time
5649
+ # resp.product_view_detail.source_connection.type #=> String, one of "CODESTAR"
5650
+ # resp.product_view_detail.source_connection.connection_parameters.code_star.connection_arn #=> String
5651
+ # resp.product_view_detail.source_connection.connection_parameters.code_star.repository #=> String
5652
+ # resp.product_view_detail.source_connection.connection_parameters.code_star.branch #=> String
5653
+ # resp.product_view_detail.source_connection.connection_parameters.code_star.artifact_path #=> String
5654
+ # resp.product_view_detail.source_connection.last_sync.last_sync_time #=> Time
5655
+ # resp.product_view_detail.source_connection.last_sync.last_sync_status #=> String, one of "SUCCEEDED", "FAILED"
5656
+ # resp.product_view_detail.source_connection.last_sync.last_sync_status_message #=> String
5657
+ # resp.product_view_detail.source_connection.last_sync.last_successful_sync_time #=> Time
5658
+ # resp.product_view_detail.source_connection.last_sync.last_successful_sync_provisioning_artifact_id #=> String
5478
5659
  # resp.tags #=> Array
5479
5660
  # resp.tags[0].key #=> String
5480
5661
  # resp.tags[0].value #=> String
@@ -5790,6 +5971,7 @@ module Aws::ServiceCatalog
5790
5971
  # resp.provisioning_artifact_detail.created_time #=> Time
5791
5972
  # resp.provisioning_artifact_detail.active #=> Boolean
5792
5973
  # resp.provisioning_artifact_detail.guidance #=> String, one of "DEFAULT", "DEPRECATED"
5974
+ # resp.provisioning_artifact_detail.source_revision #=> String
5793
5975
  # resp.info #=> Hash
5794
5976
  # resp.info["ProvisioningArtifactInfoKey"] #=> String
5795
5977
  # resp.status #=> String, one of "AVAILABLE", "CREATING", "FAILED"
@@ -5913,7 +6095,7 @@ module Aws::ServiceCatalog
5913
6095
  params: params,
5914
6096
  config: config)
5915
6097
  context[:gem_name] = 'aws-sdk-servicecatalog'
5916
- context[:gem_version] = '1.73.0'
6098
+ context[:gem_version] = '1.75.0'
5917
6099
  Seahorse::Client::Request.new(handlers, context)
5918
6100
  end
5919
6101