@aws-sdk/client-service-catalog 3.278.0 → 3.279.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.
@@ -1,7 +1,7 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.ruleSet = void 0;
4
- const p = "required", q = "fn", r = "argv", s = "ref";
5
- const a = "PartitionResult", b = "tree", c = "error", d = "endpoint", e = { [p]: false, "type": "String" }, f = { [p]: true, "default": false, "type": "Boolean" }, g = { [s]: "Endpoint" }, h = { [q]: "booleanEquals", [r]: [{ [s]: "UseFIPS" }, true] }, i = { [q]: "booleanEquals", [r]: [{ [s]: "UseDualStack" }, true] }, j = {}, k = { [q]: "booleanEquals", [r]: [true, { [q]: "getAttr", [r]: [{ [s]: a }, "supportsFIPS"] }] }, l = { [q]: "booleanEquals", [r]: [true, { [q]: "getAttr", [r]: [{ [s]: a }, "supportsDualStack"] }] }, m = [g], n = [h], o = [i];
6
- const _data = { version: "1.0", parameters: { Region: e, UseDualStack: f, UseFIPS: f, Endpoint: e }, rules: [{ conditions: [{ [q]: "aws.partition", [r]: [{ [s]: "Region" }], assign: a }], type: b, rules: [{ conditions: [{ [q]: "isSet", [r]: m }, { [q]: "parseURL", [r]: m, assign: "url" }], type: b, rules: [{ conditions: n, error: "Invalid Configuration: FIPS and custom endpoint are not supported", type: c }, { type: b, rules: [{ conditions: o, error: "Invalid Configuration: Dualstack and custom endpoint are not supported", type: c }, { endpoint: { url: g, properties: j, headers: j }, type: d }] }] }, { conditions: [h, i], type: b, rules: [{ conditions: [k, l], type: b, rules: [{ endpoint: { url: "https://servicecatalog-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: j, headers: j }, type: d }] }, { error: "FIPS and DualStack are enabled, but this partition does not support one or both", type: c }] }, { conditions: n, type: b, rules: [{ conditions: [k], type: b, rules: [{ type: b, rules: [{ endpoint: { url: "https://servicecatalog-fips.{Region}.{PartitionResult#dnsSuffix}", properties: j, headers: j }, type: d }] }] }, { error: "FIPS is enabled but this partition does not support FIPS", type: c }] }, { conditions: o, type: b, rules: [{ conditions: [l], type: b, rules: [{ endpoint: { url: "https://servicecatalog.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: j, headers: j }, type: d }] }, { error: "DualStack is enabled but this partition does not support DualStack", type: c }] }, { endpoint: { url: "https://servicecatalog.{Region}.{PartitionResult#dnsSuffix}", properties: j, headers: j }, type: d }] }] };
4
+ const q = "required", r = "fn", s = "argv", t = "ref";
5
+ const a = "isSet", b = "tree", c = "error", d = "endpoint", e = "PartitionResult", f = { [q]: false, "type": "String" }, g = { [q]: true, "default": false, "type": "Boolean" }, h = { [t]: "Endpoint" }, i = { [r]: "booleanEquals", [s]: [{ [t]: "UseFIPS" }, true] }, j = { [r]: "booleanEquals", [s]: [{ [t]: "UseDualStack" }, true] }, k = {}, l = { [r]: "booleanEquals", [s]: [true, { [r]: "getAttr", [s]: [{ [t]: e }, "supportsFIPS"] }] }, m = { [r]: "booleanEquals", [s]: [true, { [r]: "getAttr", [s]: [{ [t]: e }, "supportsDualStack"] }] }, n = [i], o = [j], p = [{ [t]: "Region" }];
6
+ const _data = { version: "1.0", parameters: { Region: f, UseDualStack: g, UseFIPS: g, Endpoint: f }, rules: [{ conditions: [{ [r]: a, [s]: [h] }], type: b, rules: [{ conditions: n, error: "Invalid Configuration: FIPS and custom endpoint are not supported", type: c }, { type: b, rules: [{ conditions: o, error: "Invalid Configuration: Dualstack and custom endpoint are not supported", type: c }, { endpoint: { url: h, properties: k, headers: k }, type: d }] }] }, { type: b, rules: [{ conditions: [{ [r]: a, [s]: p }], type: b, rules: [{ conditions: [{ [r]: "aws.partition", [s]: p, assign: e }], type: b, rules: [{ conditions: [i, j], type: b, rules: [{ conditions: [l, m], type: b, rules: [{ type: b, rules: [{ endpoint: { url: "https://servicecatalog-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: k, headers: k }, type: d }] }] }, { error: "FIPS and DualStack are enabled, but this partition does not support one or both", type: c }] }, { conditions: n, type: b, rules: [{ conditions: [l], type: b, rules: [{ type: b, rules: [{ endpoint: { url: "https://servicecatalog-fips.{Region}.{PartitionResult#dnsSuffix}", properties: k, headers: k }, type: d }] }] }, { error: "FIPS is enabled but this partition does not support FIPS", type: c }] }, { conditions: o, type: b, rules: [{ conditions: [m], type: b, rules: [{ type: b, rules: [{ endpoint: { url: "https://servicecatalog.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: k, headers: k }, type: d }] }] }, { error: "DualStack is enabled but this partition does not support DualStack", type: c }] }, { type: b, rules: [{ endpoint: { url: "https://servicecatalog.{Region}.{PartitionResult#dnsSuffix}", properties: k, headers: k }, type: d }] }] }] }, { error: "Invalid Configuration: Missing Region", type: c }] }] };
7
7
  exports.ruleSet = _data;
@@ -1,4 +1,4 @@
1
- const p = "required", q = "fn", r = "argv", s = "ref";
2
- const a = "PartitionResult", b = "tree", c = "error", d = "endpoint", e = { [p]: false, "type": "String" }, f = { [p]: true, "default": false, "type": "Boolean" }, g = { [s]: "Endpoint" }, h = { [q]: "booleanEquals", [r]: [{ [s]: "UseFIPS" }, true] }, i = { [q]: "booleanEquals", [r]: [{ [s]: "UseDualStack" }, true] }, j = {}, k = { [q]: "booleanEquals", [r]: [true, { [q]: "getAttr", [r]: [{ [s]: a }, "supportsFIPS"] }] }, l = { [q]: "booleanEquals", [r]: [true, { [q]: "getAttr", [r]: [{ [s]: a }, "supportsDualStack"] }] }, m = [g], n = [h], o = [i];
3
- const _data = { version: "1.0", parameters: { Region: e, UseDualStack: f, UseFIPS: f, Endpoint: e }, rules: [{ conditions: [{ [q]: "aws.partition", [r]: [{ [s]: "Region" }], assign: a }], type: b, rules: [{ conditions: [{ [q]: "isSet", [r]: m }, { [q]: "parseURL", [r]: m, assign: "url" }], type: b, rules: [{ conditions: n, error: "Invalid Configuration: FIPS and custom endpoint are not supported", type: c }, { type: b, rules: [{ conditions: o, error: "Invalid Configuration: Dualstack and custom endpoint are not supported", type: c }, { endpoint: { url: g, properties: j, headers: j }, type: d }] }] }, { conditions: [h, i], type: b, rules: [{ conditions: [k, l], type: b, rules: [{ endpoint: { url: "https://servicecatalog-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: j, headers: j }, type: d }] }, { error: "FIPS and DualStack are enabled, but this partition does not support one or both", type: c }] }, { conditions: n, type: b, rules: [{ conditions: [k], type: b, rules: [{ type: b, rules: [{ endpoint: { url: "https://servicecatalog-fips.{Region}.{PartitionResult#dnsSuffix}", properties: j, headers: j }, type: d }] }] }, { error: "FIPS is enabled but this partition does not support FIPS", type: c }] }, { conditions: o, type: b, rules: [{ conditions: [l], type: b, rules: [{ endpoint: { url: "https://servicecatalog.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: j, headers: j }, type: d }] }, { error: "DualStack is enabled but this partition does not support DualStack", type: c }] }, { endpoint: { url: "https://servicecatalog.{Region}.{PartitionResult#dnsSuffix}", properties: j, headers: j }, type: d }] }] };
1
+ const q = "required", r = "fn", s = "argv", t = "ref";
2
+ const a = "isSet", b = "tree", c = "error", d = "endpoint", e = "PartitionResult", f = { [q]: false, "type": "String" }, g = { [q]: true, "default": false, "type": "Boolean" }, h = { [t]: "Endpoint" }, i = { [r]: "booleanEquals", [s]: [{ [t]: "UseFIPS" }, true] }, j = { [r]: "booleanEquals", [s]: [{ [t]: "UseDualStack" }, true] }, k = {}, l = { [r]: "booleanEquals", [s]: [true, { [r]: "getAttr", [s]: [{ [t]: e }, "supportsFIPS"] }] }, m = { [r]: "booleanEquals", [s]: [true, { [r]: "getAttr", [s]: [{ [t]: e }, "supportsDualStack"] }] }, n = [i], o = [j], p = [{ [t]: "Region" }];
3
+ const _data = { version: "1.0", parameters: { Region: f, UseDualStack: g, UseFIPS: g, Endpoint: f }, rules: [{ conditions: [{ [r]: a, [s]: [h] }], type: b, rules: [{ conditions: n, error: "Invalid Configuration: FIPS and custom endpoint are not supported", type: c }, { type: b, rules: [{ conditions: o, error: "Invalid Configuration: Dualstack and custom endpoint are not supported", type: c }, { endpoint: { url: h, properties: k, headers: k }, type: d }] }] }, { type: b, rules: [{ conditions: [{ [r]: a, [s]: p }], type: b, rules: [{ conditions: [{ [r]: "aws.partition", [s]: p, assign: e }], type: b, rules: [{ conditions: [i, j], type: b, rules: [{ conditions: [l, m], type: b, rules: [{ type: b, rules: [{ endpoint: { url: "https://servicecatalog-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: k, headers: k }, type: d }] }] }, { error: "FIPS and DualStack are enabled, but this partition does not support one or both", type: c }] }, { conditions: n, type: b, rules: [{ conditions: [l], type: b, rules: [{ type: b, rules: [{ endpoint: { url: "https://servicecatalog-fips.{Region}.{PartitionResult#dnsSuffix}", properties: k, headers: k }, type: d }] }] }, { error: "FIPS is enabled but this partition does not support FIPS", type: c }] }, { conditions: o, type: b, rules: [{ conditions: [m], type: b, rules: [{ type: b, rules: [{ endpoint: { url: "https://servicecatalog.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: k, headers: k }, type: d }] }] }, { error: "DualStack is enabled but this partition does not support DualStack", type: c }] }, { type: b, rules: [{ endpoint: { url: "https://servicecatalog.{Region}.{PartitionResult#dnsSuffix}", properties: k, headers: k }, type: d }] }] }] }, { error: "Invalid Configuration: Missing Region", type: c }] }] };
4
4
  export const ruleSet = _data;
@@ -117,7 +117,6 @@ export declare class ServiceCatalog extends ServiceCatalogClient {
117
117
  * required. </p>
118
118
  * <p>You can associate a maximum of 10 Principals with a portfolio using <code>PrincipalType</code> as <code>IAM_PATTERN</code>
119
119
  * </p>
120
- *
121
120
  * <note>
122
121
  * <p>When you associate a principal with portfolio, a potential privilege escalation path may occur when that portfolio is
123
122
  * then shared with other accounts. For a user in a recipient account who is <i>not</i> an Service Catalog Admin,
@@ -194,12 +193,11 @@ export declare class ServiceCatalog extends ServiceCatalogClient {
194
193
  * organization or by a delegated administrator. You can share portfolios to an organization,
195
194
  * an organizational unit, or a specific account.</p>
196
195
  * <p>Note that if a delegated admin is de-registered, they can no longer create portfolio shares.</p>
197
- * <p>
196
+ * <p>
198
197
  * <code>AWSOrganizationsAccess</code> must be enabled in order to create a portfolio share to an organization node.</p>
199
198
  * <p>You can't share a shared resource, including portfolios that contain a shared product.</p>
200
199
  * <p>If the portfolio share with the specified account or organization node already exists, this action will have no effect
201
200
  * and will not return an error. To update an existing share, you must use the <code> UpdatePortfolioShare</code> API instead. </p>
202
- *
203
201
  * <note>
204
202
  * <p>When you associate a principal with portfolio, a potential privilege escalation path may occur when that portfolio is
205
203
  * then shared with other accounts. For a user in a recipient account who is <i>not</i> an Service Catalog Admin,
@@ -216,7 +214,6 @@ export declare class ServiceCatalog extends ServiceCatalogClient {
216
214
  /**
217
215
  * <p>Creates a product.</p>
218
216
  * <p>A delegated admin is authorized to invoke this command.</p>
219
- *
220
217
  * <p>The user or role that performs this operation must have the
221
218
  * <code>cloudformation:GetTemplate</code> IAM policy permission. This policy permission is
222
219
  * required when using the <code>ImportFromPhysicalId</code> template source in the
@@ -241,7 +238,6 @@ export declare class ServiceCatalog extends ServiceCatalogClient {
241
238
  /**
242
239
  * <p>Creates a provisioning artifact (also known as a version) for the specified product.</p>
243
240
  * <p>You cannot create a provisioning artifact for a product that was shared with you.</p>
244
- *
245
241
  * <p>The user or role that performs this operation must have the <code>cloudformation:GetTemplate</code>
246
242
  * IAM policy permission. This policy permission is required when using the
247
243
  * <code>ImportFromPhysicalId</code> template source in the information data section.</p>
@@ -360,6 +356,15 @@ export declare class ServiceCatalog extends ServiceCatalogClient {
360
356
  describePortfolioShareStatus(args: DescribePortfolioShareStatusCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribePortfolioShareStatusCommandOutput) => void): void;
361
357
  /**
362
358
  * <p>Gets information about the specified product.</p>
359
+ * <note>
360
+ * <p>
361
+ * Running this operation
362
+ * with administrator access
363
+ * results
364
+ * in a failure.
365
+ * <a>DescribeProductAsAdmin</a> should be used instead.
366
+ * </p>
367
+ * </note>
363
368
  */
364
369
  describeProduct(args: DescribeProductCommandInput, options?: __HttpHandlerOptions): Promise<DescribeProductCommandOutput>;
365
370
  describeProduct(args: DescribeProductCommandInput, cb: (err: any, data?: DescribeProductCommandOutput) => void): void;
@@ -540,20 +545,48 @@ export declare class ServiceCatalog extends ServiceCatalogClient {
540
545
  getProvisionedProductOutputs(args: GetProvisionedProductOutputsCommandInput, cb: (err: any, data?: GetProvisionedProductOutputsCommandOutput) => void): void;
541
546
  getProvisionedProductOutputs(args: GetProvisionedProductOutputsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: GetProvisionedProductOutputsCommandOutput) => void): void;
542
547
  /**
543
- * <p>Requests the import of a resource as an Service Catalog provisioned product that is
544
- * associated to an Service Catalog product and provisioning artifact. Once imported, all
545
- * supported Service Catalog governance actions are supported on the provisioned
546
- * product.</p>
547
- * <p>Resource import only supports CloudFormation stack ARNs. CloudFormation StackSets and
548
- * non-root nested stacks are not supported.</p>
549
- * <p>The CloudFormation stack must have one of the following statuses to be imported:
550
- * <code>CREATE_COMPLETE</code>, <code>UPDATE_COMPLETE</code>, <code>UPDATE_ROLLBACK_COMPLETE</code>, <code>IMPORT_COMPLETE</code>,
551
- * <code>IMPORT_ROLLBACK_COMPLETE</code>.</p>
552
- * <p>Import of the resource requires that the CloudFormation stack template matches the
553
- * associated Service Catalog product provisioning artifact. </p>
554
- *
555
- * <p>The user or role that performs this operation must have the <code>cloudformation:GetTemplate</code>
556
- * and <code>cloudformation:DescribeStacks</code> IAM policy permissions. </p>
548
+ * <p>
549
+ * Requests the import
550
+ * of a resource
551
+ * as an Service Catalog provisioned product
552
+ * that is associated
553
+ * to an Service Catalog product and provisioning artifact.
554
+ * Once imported,
555
+ * all supported governance actions are supported
556
+ * on the provisioned product.
557
+ * </p>
558
+ * <p>
559
+ * Resource import only supports CloudFormation stack ARNs. CloudFormation StackSets, and non-root nested stacks are not supported.
560
+ * </p>
561
+ * <p>
562
+ * The CloudFormation stack must have one
563
+ * of the following statuses
564
+ * to be imported: <code>CREATE_COMPLETE</code>, <code>UPDATE_COMPLETE</code>, <code>UPDATE_ROLLBACK_COMPLETE</code>, <code>IMPORT_COMPLETE</code>, and <code>IMPORT_ROLLBACK_COMPLETE</code>.
565
+ * </p>
566
+ * <p>
567
+ * Import
568
+ * of the resource requires
569
+ * that the CloudFormation stack template matches the associated Service Catalog product provisioning artifact.
570
+ * </p>
571
+ * <note>
572
+ * <p>
573
+ * When you import an existing CloudFormation stack
574
+ * into a portfolio,
575
+ * constraints
576
+ * that are associated
577
+ * with the product
578
+ * aren't applied
579
+ * during the import process.
580
+ * The constraints are applied
581
+ * after you call <code>UpdateProvisionedProduct</code>
582
+ * for the provisioned product.
583
+ * </p>
584
+ * </note>
585
+ * <p>
586
+ * The user or role
587
+ * that performs this operation
588
+ * must have the <code>cloudformation:GetTemplate</code> and <code>cloudformation:DescribeStacks</code> IAM policy permissions.
589
+ * </p>
557
590
  */
558
591
  importAsProvisionedProduct(args: ImportAsProvisionedProductCommandInput, options?: __HttpHandlerOptions): Promise<ImportAsProvisionedProductCommandOutput>;
559
592
  importAsProvisionedProduct(args: ImportAsProvisionedProductCommandInput, cb: (err: any, data?: ImportAsProvisionedProductCommandOutput) => void): void;
@@ -579,9 +612,32 @@ export declare class ServiceCatalog extends ServiceCatalogClient {
579
612
  listConstraintsForPortfolio(args: ListConstraintsForPortfolioCommandInput, cb: (err: any, data?: ListConstraintsForPortfolioCommandOutput) => void): void;
580
613
  listConstraintsForPortfolio(args: ListConstraintsForPortfolioCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListConstraintsForPortfolioCommandOutput) => void): void;
581
614
  /**
582
- * <p>Lists the paths to the specified product. A path is how the user
583
- * has access to a specified product, and is necessary when provisioning a product. A path
584
- * also determines the constraints put on the product.</p>
615
+ * <p>
616
+ * Lists the paths
617
+ * to the specified product.
618
+ * A path describes
619
+ * how the user
620
+ * gets access
621
+ * to a specified product
622
+ * and is necessary
623
+ * when provisioning a product.
624
+ * A path also determines the constraints
625
+ * that are put on a product.
626
+ * A path is dependent
627
+ * on a specific product, porfolio, and principal.
628
+ * </p>
629
+ * <note>
630
+ * <p>
631
+ * When provisioning a product
632
+ * that's been added
633
+ * to a portfolio,
634
+ * you must grant your user, group, or role access
635
+ * to the portfolio.
636
+ * For more information,
637
+ * see <a href="https://docs.aws.amazon.com/servicecatalog/latest/adminguide/catalogs_portfolios_users.html">Granting users access</a>
638
+ * in the <i>Service Catalog User Guide</i>.
639
+ * </p>
640
+ * </note>
585
641
  */
586
642
  listLaunchPaths(args: ListLaunchPathsCommandInput, options?: __HttpHandlerOptions): Promise<ListLaunchPathsCommandOutput>;
587
643
  listLaunchPaths(args: ListLaunchPathsCommandInput, cb: (err: any, data?: ListLaunchPathsCommandOutput) => void): void;
@@ -675,15 +731,43 @@ export declare class ServiceCatalog extends ServiceCatalogClient {
675
731
  listTagOptions(args: ListTagOptionsCommandInput, cb: (err: any, data?: ListTagOptionsCommandOutput) => void): void;
676
732
  listTagOptions(args: ListTagOptionsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListTagOptionsCommandOutput) => void): void;
677
733
  /**
678
- * <p>Provisions the specified product.</p>
679
- * <p>A provisioned product is a resourced instance of a product.
680
- * For example, provisioning a product based on a CloudFormation template launches a
681
- * CloudFormation stack and its underlying resources.
682
- * You can check the status of this request using <a>DescribeRecord</a>.</p>
683
- * <p>If the request contains a tag key with an empty list of values, there is a
684
- * tag conflict for that key. Do not include conflicted keys as tags, or this causes
685
- * the error "Parameter validation failed: Missing required parameter in
686
- * Tags[<i>N</i>]:<i>Value</i>".</p>
734
+ * <p>
735
+ * Provisions the specified product.
736
+ * </p>
737
+ * <p>
738
+ * A provisioned product is a resourced instance
739
+ * of a product.
740
+ * For example,
741
+ * provisioning a product
742
+ * that's based
743
+ * on an CloudFormation template
744
+ * launches an CloudFormation stack and its underlying resources.
745
+ * You can check the status
746
+ * of this request
747
+ * using <a>DescribeRecord</a>.
748
+ * </p>
749
+ * <p>
750
+ * If the request contains a tag key
751
+ * with an empty list
752
+ * of values,
753
+ * there's a tag conflict
754
+ * for that key.
755
+ * Don't include conflicted keys
756
+ * as tags,
757
+ * or this will cause the error "Parameter validation failed: Missing required parameter in Tags[<i>N</i>]:<i>Value</i>".
758
+ * </p>
759
+ * <note>
760
+ * <p>
761
+ * When provisioning a product
762
+ * that's been added
763
+ * to a portfolio,
764
+ * you must grant your user, group, or role access
765
+ * to the portfolio.
766
+ * For more information,
767
+ * see <a href="https://docs.aws.amazon.com/servicecatalog/latest/adminguide/catalogs_portfolios_users.html">Granting users access</a>
768
+ * in the <i>Service Catalog User Guide</i>.
769
+ * </p>
770
+ * </note>
687
771
  */
688
772
  provisionProduct(args: ProvisionProductCommandInput, options?: __HttpHandlerOptions): Promise<ProvisionProductCommandOutput>;
689
773
  provisionProduct(args: ProvisionProductCommandInput, cb: (err: any, data?: ProvisionProductCommandOutput) => void): void;
@@ -715,16 +799,6 @@ export declare class ServiceCatalog extends ServiceCatalogClient {
715
799
  searchProductsAsAdmin(args: SearchProductsAsAdminCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: SearchProductsAsAdminCommandOutput) => void): void;
716
800
  /**
717
801
  * <p>Gets information about the provisioned products that meet the specified criteria.</p>
718
- *
719
- * <note>
720
- * <p>To ensure a complete list of provisioned products and remove duplicate products, use
721
- * <code>sort-by createdTime</code>. </p>
722
- * <p>Here is a CLI example: <code> </code>
723
- * </p>
724
- * <p>
725
- * <code>aws servicecatalog search-provisioned-products --sort-by createdTime </code>
726
- * </p>
727
- * </note>
728
802
  */
729
803
  searchProvisionedProducts(args: SearchProvisionedProductsCommandInput, options?: __HttpHandlerOptions): Promise<SearchProvisionedProductsCommandOutput>;
730
804
  searchProvisionedProducts(args: SearchProvisionedProductsCommandInput, cb: (err: any, data?: SearchProvisionedProductsCommandOutput) => void): void;
@@ -753,15 +827,10 @@ export declare class ServiceCatalog extends ServiceCatalogClient {
753
827
  /**
754
828
  * <p>Updates the specified portfolio share. You can use this API to enable or disable <code>TagOptions</code> sharing
755
829
  * or Principal sharing for an existing portfolio share. </p>
756
- *
757
830
  * <p>The portfolio share cannot be updated if the <code>CreatePortfolioShare</code> operation is <code>IN_PROGRESS</code>, as the share is not available to recipient entities. In this case, you must wait for the portfolio share to be COMPLETED.</p>
758
- *
759
831
  * <p>You must provide the <code>accountId</code> or organization node in the input, but not both.</p>
760
- *
761
832
  * <p>If the portfolio is shared to both an external account and an organization node, and both shares need to be updated, you must invoke <code>UpdatePortfolioShare</code> separately for each share type. </p>
762
- *
763
833
  * <p>This API cannot be used for removing the portfolio share. You must use <code>DeletePortfolioShare</code> API for that action. </p>
764
- *
765
834
  * <note>
766
835
  * <p>When you associate a principal with portfolio, a potential privilege escalation path may occur when that portfolio is
767
836
  * then shared with other accounts. For a user in a recipient account who is <i>not</i> an Service Catalog Admin,
@@ -15,7 +15,6 @@ export interface AssociatePrincipalWithPortfolioCommandOutput extends AssociateP
15
15
  * required. </p>
16
16
  * <p>You can associate a maximum of 10 Principals with a portfolio using <code>PrincipalType</code> as <code>IAM_PATTERN</code>
17
17
  * </p>
18
- *
19
18
  * <note>
20
19
  * <p>When you associate a principal with portfolio, a potential privilege escalation path may occur when that portfolio is
21
20
  * then shared with other accounts. For a user in a recipient account who is <i>not</i> an Service Catalog Admin,
@@ -13,12 +13,11 @@ export interface CreatePortfolioShareCommandOutput extends CreatePortfolioShareO
13
13
  * organization or by a delegated administrator. You can share portfolios to an organization,
14
14
  * an organizational unit, or a specific account.</p>
15
15
  * <p>Note that if a delegated admin is de-registered, they can no longer create portfolio shares.</p>
16
- * <p>
16
+ * <p>
17
17
  * <code>AWSOrganizationsAccess</code> must be enabled in order to create a portfolio share to an organization node.</p>
18
18
  * <p>You can't share a shared resource, including portfolios that contain a shared product.</p>
19
19
  * <p>If the portfolio share with the specified account or organization node already exists, this action will have no effect
20
20
  * and will not return an error. To update an existing share, you must use the <code> UpdatePortfolioShare</code> API instead. </p>
21
- *
22
21
  * <note>
23
22
  * <p>When you associate a principal with portfolio, a potential privilege escalation path may occur when that portfolio is
24
23
  * then shared with other accounts. For a user in a recipient account who is <i>not</i> an Service Catalog Admin,
@@ -10,7 +10,6 @@ export interface CreateProductCommandOutput extends CreateProductOutput, __Metad
10
10
  /**
11
11
  * <p>Creates a product.</p>
12
12
  * <p>A delegated admin is authorized to invoke this command.</p>
13
- *
14
13
  * <p>The user or role that performs this operation must have the
15
14
  * <code>cloudformation:GetTemplate</code> IAM policy permission. This policy permission is
16
15
  * required when using the <code>ImportFromPhysicalId</code> template source in the
@@ -10,7 +10,6 @@ export interface CreateProvisioningArtifactCommandOutput extends CreateProvision
10
10
  /**
11
11
  * <p>Creates a provisioning artifact (also known as a version) for the specified product.</p>
12
12
  * <p>You cannot create a provisioning artifact for a product that was shared with you.</p>
13
- *
14
13
  * <p>The user or role that performs this operation must have the <code>cloudformation:GetTemplate</code>
15
14
  * IAM policy permission. This policy permission is required when using the
16
15
  * <code>ImportFromPhysicalId</code> template source in the information data section.</p>
@@ -9,6 +9,15 @@ export interface DescribeProductCommandOutput extends DescribeProductOutput, __M
9
9
  }
10
10
  /**
11
11
  * <p>Gets information about the specified product.</p>
12
+ * <note>
13
+ * <p>
14
+ * Running this operation
15
+ * with administrator access
16
+ * results
17
+ * in a failure.
18
+ * <a>DescribeProductAsAdmin</a> should be used instead.
19
+ * </p>
20
+ * </note>
12
21
  * @example
13
22
  * Use a bare-bones client and the command you need to make an API call.
14
23
  * ```javascript
@@ -8,20 +8,48 @@ export interface ImportAsProvisionedProductCommandInput extends ImportAsProvisio
8
8
  export interface ImportAsProvisionedProductCommandOutput extends ImportAsProvisionedProductOutput, __MetadataBearer {
9
9
  }
10
10
  /**
11
- * <p>Requests the import of a resource as an Service Catalog provisioned product that is
12
- * associated to an Service Catalog product and provisioning artifact. Once imported, all
13
- * supported Service Catalog governance actions are supported on the provisioned
14
- * product.</p>
15
- * <p>Resource import only supports CloudFormation stack ARNs. CloudFormation StackSets and
16
- * non-root nested stacks are not supported.</p>
17
- * <p>The CloudFormation stack must have one of the following statuses to be imported:
18
- * <code>CREATE_COMPLETE</code>, <code>UPDATE_COMPLETE</code>, <code>UPDATE_ROLLBACK_COMPLETE</code>, <code>IMPORT_COMPLETE</code>,
19
- * <code>IMPORT_ROLLBACK_COMPLETE</code>.</p>
20
- * <p>Import of the resource requires that the CloudFormation stack template matches the
21
- * associated Service Catalog product provisioning artifact. </p>
22
- *
23
- * <p>The user or role that performs this operation must have the <code>cloudformation:GetTemplate</code>
24
- * and <code>cloudformation:DescribeStacks</code> IAM policy permissions. </p>
11
+ * <p>
12
+ * Requests the import
13
+ * of a resource
14
+ * as an Service Catalog provisioned product
15
+ * that is associated
16
+ * to an Service Catalog product and provisioning artifact.
17
+ * Once imported,
18
+ * all supported governance actions are supported
19
+ * on the provisioned product.
20
+ * </p>
21
+ * <p>
22
+ * Resource import only supports CloudFormation stack ARNs. CloudFormation StackSets, and non-root nested stacks are not supported.
23
+ * </p>
24
+ * <p>
25
+ * The CloudFormation stack must have one
26
+ * of the following statuses
27
+ * to be imported: <code>CREATE_COMPLETE</code>, <code>UPDATE_COMPLETE</code>, <code>UPDATE_ROLLBACK_COMPLETE</code>, <code>IMPORT_COMPLETE</code>, and <code>IMPORT_ROLLBACK_COMPLETE</code>.
28
+ * </p>
29
+ * <p>
30
+ * Import
31
+ * of the resource requires
32
+ * that the CloudFormation stack template matches the associated Service Catalog product provisioning artifact.
33
+ * </p>
34
+ * <note>
35
+ * <p>
36
+ * When you import an existing CloudFormation stack
37
+ * into a portfolio,
38
+ * constraints
39
+ * that are associated
40
+ * with the product
41
+ * aren't applied
42
+ * during the import process.
43
+ * The constraints are applied
44
+ * after you call <code>UpdateProvisionedProduct</code>
45
+ * for the provisioned product.
46
+ * </p>
47
+ * </note>
48
+ * <p>
49
+ * The user or role
50
+ * that performs this operation
51
+ * must have the <code>cloudformation:GetTemplate</code> and <code>cloudformation:DescribeStacks</code> IAM policy permissions.
52
+ * </p>
25
53
  * @example
26
54
  * Use a bare-bones client and the command you need to make an API call.
27
55
  * ```javascript
@@ -8,9 +8,32 @@ export interface ListLaunchPathsCommandInput extends ListLaunchPathsInput {
8
8
  export interface ListLaunchPathsCommandOutput extends ListLaunchPathsOutput, __MetadataBearer {
9
9
  }
10
10
  /**
11
- * <p>Lists the paths to the specified product. A path is how the user
12
- * has access to a specified product, and is necessary when provisioning a product. A path
13
- * also determines the constraints put on the product.</p>
11
+ * <p>
12
+ * Lists the paths
13
+ * to the specified product.
14
+ * A path describes
15
+ * how the user
16
+ * gets access
17
+ * to a specified product
18
+ * and is necessary
19
+ * when provisioning a product.
20
+ * A path also determines the constraints
21
+ * that are put on a product.
22
+ * A path is dependent
23
+ * on a specific product, porfolio, and principal.
24
+ * </p>
25
+ * <note>
26
+ * <p>
27
+ * When provisioning a product
28
+ * that's been added
29
+ * to a portfolio,
30
+ * you must grant your user, group, or role access
31
+ * to the portfolio.
32
+ * For more information,
33
+ * see <a href="https://docs.aws.amazon.com/servicecatalog/latest/adminguide/catalogs_portfolios_users.html">Granting users access</a>
34
+ * in the <i>Service Catalog User Guide</i>.
35
+ * </p>
36
+ * </note>
14
37
  * @example
15
38
  * Use a bare-bones client and the command you need to make an API call.
16
39
  * ```javascript
@@ -8,15 +8,43 @@ export interface ProvisionProductCommandInput extends ProvisionProductInput {
8
8
  export interface ProvisionProductCommandOutput extends ProvisionProductOutput, __MetadataBearer {
9
9
  }
10
10
  /**
11
- * <p>Provisions the specified product.</p>
12
- * <p>A provisioned product is a resourced instance of a product.
13
- * For example, provisioning a product based on a CloudFormation template launches a
14
- * CloudFormation stack and its underlying resources.
15
- * You can check the status of this request using <a>DescribeRecord</a>.</p>
16
- * <p>If the request contains a tag key with an empty list of values, there is a
17
- * tag conflict for that key. Do not include conflicted keys as tags, or this causes
18
- * the error "Parameter validation failed: Missing required parameter in
19
- * Tags[<i>N</i>]:<i>Value</i>".</p>
11
+ * <p>
12
+ * Provisions the specified product.
13
+ * </p>
14
+ * <p>
15
+ * A provisioned product is a resourced instance
16
+ * of a product.
17
+ * For example,
18
+ * provisioning a product
19
+ * that's based
20
+ * on an CloudFormation template
21
+ * launches an CloudFormation stack and its underlying resources.
22
+ * You can check the status
23
+ * of this request
24
+ * using <a>DescribeRecord</a>.
25
+ * </p>
26
+ * <p>
27
+ * If the request contains a tag key
28
+ * with an empty list
29
+ * of values,
30
+ * there's a tag conflict
31
+ * for that key.
32
+ * Don't include conflicted keys
33
+ * as tags,
34
+ * or this will cause the error "Parameter validation failed: Missing required parameter in Tags[<i>N</i>]:<i>Value</i>".
35
+ * </p>
36
+ * <note>
37
+ * <p>
38
+ * When provisioning a product
39
+ * that's been added
40
+ * to a portfolio,
41
+ * you must grant your user, group, or role access
42
+ * to the portfolio.
43
+ * For more information,
44
+ * see <a href="https://docs.aws.amazon.com/servicecatalog/latest/adminguide/catalogs_portfolios_users.html">Granting users access</a>
45
+ * in the <i>Service Catalog User Guide</i>.
46
+ * </p>
47
+ * </note>
20
48
  * @example
21
49
  * Use a bare-bones client and the command you need to make an API call.
22
50
  * ```javascript
@@ -9,16 +9,6 @@ export interface SearchProvisionedProductsCommandOutput extends SearchProvisione
9
9
  }
10
10
  /**
11
11
  * <p>Gets information about the provisioned products that meet the specified criteria.</p>
12
- *
13
- * <note>
14
- * <p>To ensure a complete list of provisioned products and remove duplicate products, use
15
- * <code>sort-by createdTime</code>. </p>
16
- * <p>Here is a CLI example: <code> </code>
17
- * </p>
18
- * <p>
19
- * <code>aws servicecatalog search-provisioned-products --sort-by createdTime </code>
20
- * </p>
21
- * </note>
22
12
  * @example
23
13
  * Use a bare-bones client and the command you need to make an API call.
24
14
  * ```javascript
@@ -10,15 +10,10 @@ export interface UpdatePortfolioShareCommandOutput extends UpdatePortfolioShareO
10
10
  /**
11
11
  * <p>Updates the specified portfolio share. You can use this API to enable or disable <code>TagOptions</code> sharing
12
12
  * or Principal sharing for an existing portfolio share. </p>
13
- *
14
13
  * <p>The portfolio share cannot be updated if the <code>CreatePortfolioShare</code> operation is <code>IN_PROGRESS</code>, as the share is not available to recipient entities. In this case, you must wait for the portfolio share to be COMPLETED.</p>
15
- *
16
14
  * <p>You must provide the <code>accountId</code> or organization node in the input, but not both.</p>
17
- *
18
15
  * <p>If the portfolio is shared to both an external account and an organization node, and both shares need to be updated, you must invoke <code>UpdatePortfolioShare</code> separately for each share type. </p>
19
- *
20
16
  * <p>This API cannot be used for removing the portfolio share. You must use <code>DeletePortfolioShare</code> API for that action. </p>
21
- *
22
17
  * <note>
23
18
  * <p>When you associate a principal with portfolio, a potential privilege escalation path may occur when that portfolio is
24
19
  * then shared with other accounts. For a user in a recipient account who is <i>not</i> an Service Catalog Admin,
@@ -2900,13 +2900,10 @@ export interface ParameterConstraints {
2900
2900
  AllowedPattern?: string;
2901
2901
  /**
2902
2902
  * <p>A string that explains a constraint when the constraint is violated. For example, without a constraint description, a parameter that has an allowed pattern of <code>[A-Za-z0-9]+</code> displays the following error message when the user specifies an invalid value:</p>
2903
- *
2904
2903
  * <p>
2905
2904
  * <code>Malformed input-Parameter MyParameter must match pattern [A-Za-z0-9]+</code>
2906
2905
  * </p>
2907
- *
2908
2906
  * <p>By adding a constraint description, such as must only contain letters (uppercase and lowercase) and numbers, you can display the following customized error message:</p>
2909
- *
2910
2907
  * <p>
2911
2908
  * <code>Malformed input-Parameter MyParameter must only contain uppercase and lowercase letters and numbers.</code>
2912
2909
  * </p>
@@ -5739,7 +5736,6 @@ export interface UpdateProvisionedProductPropertiesInput {
5739
5736
  * calls a provisioning operation such as <code>UpdateProvisionedProduct</code>,
5740
5737
  * <code>TerminateProvisionedProduct</code>, or
5741
5738
  * <code>ExecuteProvisionedProductServiceAction</code>. Only a role ARN is valid. A user ARN is invalid. </p>
5742
- *
5743
5739
  * <p>The <code>OWNER</code> key accepts IAM user ARNs, IAM role ARNs, and STS
5744
5740
  * assumed-role ARNs. The owner is the user that has permission to see, update, terminate, and
5745
5741
  * execute service actions in the provisioned product.</p>
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@aws-sdk/client-service-catalog",
3
3
  "description": "AWS SDK for JavaScript Service Catalog Client for Node.js, Browser and React Native",
4
- "version": "3.278.0",
4
+ "version": "3.279.0",
5
5
  "scripts": {
6
6
  "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
7
7
  "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -20,9 +20,9 @@
20
20
  "dependencies": {
21
21
  "@aws-crypto/sha256-browser": "3.0.0",
22
22
  "@aws-crypto/sha256-js": "3.0.0",
23
- "@aws-sdk/client-sts": "3.278.0",
23
+ "@aws-sdk/client-sts": "3.279.0",
24
24
  "@aws-sdk/config-resolver": "3.272.0",
25
- "@aws-sdk/credential-provider-node": "3.278.0",
25
+ "@aws-sdk/credential-provider-node": "3.279.0",
26
26
  "@aws-sdk/fetch-http-handler": "3.272.0",
27
27
  "@aws-sdk/hash-node": "3.272.0",
28
28
  "@aws-sdk/invalid-dependency": "3.272.0",
@@ -39,14 +39,14 @@
39
39
  "@aws-sdk/node-config-provider": "3.272.0",
40
40
  "@aws-sdk/node-http-handler": "3.272.0",
41
41
  "@aws-sdk/protocol-http": "3.272.0",
42
- "@aws-sdk/smithy-client": "3.272.0",
42
+ "@aws-sdk/smithy-client": "3.279.0",
43
43
  "@aws-sdk/types": "3.272.0",
44
44
  "@aws-sdk/url-parser": "3.272.0",
45
45
  "@aws-sdk/util-base64": "3.208.0",
46
46
  "@aws-sdk/util-body-length-browser": "3.188.0",
47
47
  "@aws-sdk/util-body-length-node": "3.208.0",
48
- "@aws-sdk/util-defaults-mode-browser": "3.272.0",
49
- "@aws-sdk/util-defaults-mode-node": "3.272.0",
48
+ "@aws-sdk/util-defaults-mode-browser": "3.279.0",
49
+ "@aws-sdk/util-defaults-mode-node": "3.279.0",
50
50
  "@aws-sdk/util-endpoints": "3.272.0",
51
51
  "@aws-sdk/util-retry": "3.272.0",
52
52
  "@aws-sdk/util-user-agent-browser": "3.272.0",