aws-sdk-servicecatalog 1.79.0 → 1.81.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 54f5d17ad7319a313a0368674c9babcc18c52d0bceb42573b18e1aea70e71a31
-  data.tar.gz: 6204e33542c232cbf5089148c0f9be26dcf19ceeb2c819fd15f806d7825be1ed
+  metadata.gz: '080343c3d853222f58ac7a6ff8da7f6a8026502ac746ca1caf18e789cd298db4'
+  data.tar.gz: 54cb85ae36e5870e62ebaf933a73bfee468ceda80d5e5d42a55a34a65909e093
 SHA512:
-  metadata.gz: be125ed02086942c9cafd68a167b289a364509db6ef6c29c82ed28aa76d24ee158dc1506e97197259fc2be80606c24f40058ed5417dfef1b260e4ab0e680e585
-  data.tar.gz: bf71f518bdbfa974f495e0929160bf80c7654c709dc550ac09bf5894518dc3d23ba62a10afd1703d7514e6ee0e6b21ee8078ecb500206a95d2284f63b984d724
+  metadata.gz: 4fe8f5640e9de61edf6ab15e98f54707a7f693fca9e40597943f222f2dc93e8a95a6fa2026d3dda833348e5f7e1162b70bbfb25bc19669722c6b6976dab2866d
+  data.tar.gz: 5c9ee7216d362156acde68c3b71cc0d09bd07fda7f45a910aa677bbe96c50e3e11eae153ca079bd57c1577ed8b51d236cb1b5da63b0d1e428caaa6d4154ef6d7

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.81.0 (2023-06-08)
+------------------
+
+* Feature - New parameter added in ServiceCatalog DescribeProvisioningArtifact api - IncludeProvisioningArtifactParameters. This parameter can be used to return information about the parameters used to provision the product
+
+1.80.0 (2023-05-31)
+------------------
+
+* Feature - Documentation updates for ServiceCatalog.
+
 1.79.0 (2023-04-07)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.79.0
+1.81.0

data/lib/aws-sdk-servicecatalog/client.rb

@@ -275,6 +275,11 @@ module Aws::ServiceCatalog
     #       in the future.
     #
     #
+    #   @option options [String] :sdk_ua_app_id
+    #     A unique and opaque application ID that is appended to the
+    #     User-Agent header as app/<sdk_ua_app_id>. It should have a
+    #     maximum length of 50.
+    #
     #   @option options [String] :secret_access_key
     #
     #   @option options [String] :session_token
@@ -486,17 +491,70 @@ module Aws::ServiceCatalog
     #   The portfolio identifier.
     #
     # @option params [required, String] :principal_arn
-    #   The ARN of the principal (user, role, or group). This field allows an
-    #   ARN with no `accountID` if `PrincipalType` is `IAM_PATTERN`.
+    #   The ARN of the principal (user, role, or group). If the
+    #   `PrincipalType` is `IAM`, the supported value is a fully defined [IAM
+    #   Amazon Resource Name (ARN)][1]. If the `PrincipalType` is
+    #   `IAM_PATTERN`, the supported value is an `IAM` ARN *without an
+    #   AccountID* in the following format:
+    #
+    #   *arn:partition:iam:::resource-type/resource-id*
+    #
+    #   The ARN resource-id can be either:
+    #
+    #   * A fully formed resource-id. For example,
+    #     *arn:aws:iam:::role/resource-name* or
+    #     *arn:aws:iam:::role/resource-path/resource-name*
+    #
+    #   * A wildcard ARN. The wildcard ARN accepts `IAM_PATTERN` values with a
+    #     "*" or "?" in the resource-id segment of the ARN. For example
+    #     *arn:partition:service:::resource-type/resource-path/resource-name*.
+    #     The new symbols are exclusive to the **resource-path** and
+    #     **resource-name** and cannot replace the **resource-type** or other
+    #     ARN values.
+    #
+    #     The ARN path and principal name allow unlimited wildcard characters.
+    #
+    #   Examples of an **acceptable** wildcard ARN:
+    #
+    #   * arn:aws:iam:::role/ResourceName\_*
+    #
+    #   * arn:aws:iam:::role/*/ResourceName\_?
+    #
+    #   Examples of an **unacceptable** wildcard ARN:
     #
-    #   You can associate multiple `IAM` patterns even if the account has no
-    #   principal with that name. This is useful in Principal Name Sharing if
-    #   you want to share a principal without creating it in the account that
-    #   owns the portfolio.
+    #   * arn:aws:iam:::*/ResourceName
+    #
+    #   ^
+    #
+    #   You can associate multiple `IAM_PATTERN`s even if the account has no
+    #   principal with that name.
+    #
+    #   The "?" wildcard character matches zero or one of any character.
+    #   This is similar to ".?" in regular regex context. The "*"
+    #   wildcard character matches any number of any characters. This is
+    #   similar to ".*" in regular regex context.
+    #
+    #   In the IAM Principal ARN format
+    #   (*arn:partition:iam:::resource-type/resource-path/resource-name*),
+    #   valid resource-type values include **user/**, **group/**, or
+    #   **role/**. The "?" and "*" characters are allowed only after the
+    #   resource-type in the resource-id segment. You can use special
+    #   characters anywhere within the resource-id.
+    #
+    #   The "*" character also matches the "/" character, allowing paths
+    #   to be formed *within* the resource-id. For example,
+    #   *arn:aws:iam:::role/*****/ResourceName\_?* matches both
+    #   *arn:aws:iam:::role/pathA/pathB/ResourceName\_1* and
+    #   *arn:aws:iam:::role/pathA/ResourceName\_1*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-arns
     #
     # @option params [required, String] :principal_type
     #   The principal type. The supported value is `IAM` if you use a fully
-    #   defined ARN, or `IAM_PATTERN` if you use an ARN with no `accountID`.
+    #   defined Amazon Resource Name (ARN), or `IAM_PATTERN` if you use an ARN
+    #   with no `accountID`, with or without wildcard characters.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -2549,11 +2607,16 @@ module Aws::ServiceCatalog
     # @option params [Boolean] :verbose
     #   Indicates whether a verbose level of detail is enabled.
     #
+    # @option params [Boolean] :include_provisioning_artifact_parameters
+    #   Indicates if the API call response does or does not include additional
+    #   details about the provisioning parameters.
+    #
     # @return [Types::DescribeProvisioningArtifactOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DescribeProvisioningArtifactOutput#provisioning_artifact_detail #provisioning_artifact_detail} => Types::ProvisioningArtifactDetail
     #   * {Types::DescribeProvisioningArtifactOutput#info #info} => Hash&lt;String,String&gt;
     #   * {Types::DescribeProvisioningArtifactOutput#status #status} => String
+    #   * {Types::DescribeProvisioningArtifactOutput#provisioning_artifact_parameters #provisioning_artifact_parameters} => Array&lt;Types::ProvisioningArtifactParameter&gt;
     #
     # @example Request syntax with placeholder values
     #
@@ -2564,6 +2627,7 @@ module Aws::ServiceCatalog
     #     provisioning_artifact_name: "ProvisioningArtifactName",
     #     product_name: "ProductViewName",
     #     verbose: false,
+    #     include_provisioning_artifact_parameters: false,
     #   })
     #
     # @example Response structure
@@ -2579,6 +2643,20 @@ module Aws::ServiceCatalog
     #   resp.info #=> Hash
     #   resp.info["ProvisioningArtifactInfoKey"] #=> String
     #   resp.status #=> String, one of "AVAILABLE", "CREATING", "FAILED"
+    #   resp.provisioning_artifact_parameters #=> Array
+    #   resp.provisioning_artifact_parameters[0].parameter_key #=> String
+    #   resp.provisioning_artifact_parameters[0].default_value #=> String
+    #   resp.provisioning_artifact_parameters[0].parameter_type #=> String
+    #   resp.provisioning_artifact_parameters[0].is_no_echo #=> Boolean
+    #   resp.provisioning_artifact_parameters[0].description #=> String
+    #   resp.provisioning_artifact_parameters[0].parameter_constraints.allowed_values #=> Array
+    #   resp.provisioning_artifact_parameters[0].parameter_constraints.allowed_values[0] #=> String
+    #   resp.provisioning_artifact_parameters[0].parameter_constraints.allowed_pattern #=> String
+    #   resp.provisioning_artifact_parameters[0].parameter_constraints.constraint_description #=> String
+    #   resp.provisioning_artifact_parameters[0].parameter_constraints.max_length #=> String
+    #   resp.provisioning_artifact_parameters[0].parameter_constraints.min_length #=> String
+    #   resp.provisioning_artifact_parameters[0].parameter_constraints.max_value #=> String
+    #   resp.provisioning_artifact_parameters[0].parameter_constraints.min_value #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/DescribeProvisioningArtifact AWS API Documentation
     #
@@ -2974,6 +3052,23 @@ module Aws::ServiceCatalog
     # will no longer be able to provision products in this portfolio using a
     # role matching the name of the associated principal.
     #
+    # For more information, review [associate-principal-with-portfolio][1]
+    # in the Amazon Web Services CLI Command Reference.
+    #
+    # <note markdown="1"> If you disassociate a principal from a portfolio, with PrincipalType
+    # as `IAM`, the same principal will still have access to the portfolio
+    # if it matches one of the associated principals of type `IAM_PATTERN`.
+    # To fully remove access for a principal, verify all the associated
+    # Principals of type `IAM_PATTERN`, and then ensure you disassociate any
+    # `IAM_PATTERN` principals that match the principal whose access you are
+    # removing.
+    #
+    #  </note>
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/cli/latest/reference/servicecatalog/associate-principal-with-portfolio.html#options
+    #
     # @option params [String] :accept_language
     #   The language code.
     #
@@ -2986,11 +3081,13 @@ module Aws::ServiceCatalog
     #
     # @option params [required, String] :principal_arn
     #   The ARN of the principal (user, role, or group). This field allows an
-    #   ARN with no `accountID` if `PrincipalType` is `IAM_PATTERN`.
+    #   ARN with no `accountID` with or without wildcard characters if
+    #   `PrincipalType` is `IAM_PATTERN`.
     #
     # @option params [String] :principal_type
     #   The supported value is `IAM` if you use a fully defined ARN, or
-    #   `IAM_PATTERN` if you use no `accountID`.
+    #   `IAM_PATTERN` if you specify an `IAM` ARN with no AccountId, with or
+    #   without wildcard characters.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -6138,7 +6235,7 @@ module Aws::ServiceCatalog
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-servicecatalog'
-      context[:gem_version] = '1.79.0'
+      context[:gem_version] = '1.81.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-servicecatalog/client_api.rb

@@ -876,11 +876,13 @@ module Aws::ServiceCatalog
     DescribeProvisioningArtifactInput.add_member(:provisioning_artifact_name, Shapes::ShapeRef.new(shape: ProvisioningArtifactName, location_name: "ProvisioningArtifactName"))
     DescribeProvisioningArtifactInput.add_member(:product_name, Shapes::ShapeRef.new(shape: ProductViewName, location_name: "ProductName"))
     DescribeProvisioningArtifactInput.add_member(:verbose, Shapes::ShapeRef.new(shape: Verbose, location_name: "Verbose"))
+    DescribeProvisioningArtifactInput.add_member(:include_provisioning_artifact_parameters, Shapes::ShapeRef.new(shape: Boolean, location_name: "IncludeProvisioningArtifactParameters"))
     DescribeProvisioningArtifactInput.struct_class = Types::DescribeProvisioningArtifactInput
 
     DescribeProvisioningArtifactOutput.add_member(:provisioning_artifact_detail, Shapes::ShapeRef.new(shape: ProvisioningArtifactDetail, location_name: "ProvisioningArtifactDetail"))
     DescribeProvisioningArtifactOutput.add_member(:info, Shapes::ShapeRef.new(shape: ProvisioningArtifactInfo, location_name: "Info"))
     DescribeProvisioningArtifactOutput.add_member(:status, Shapes::ShapeRef.new(shape: Status, location_name: "Status"))
+    DescribeProvisioningArtifactOutput.add_member(:provisioning_artifact_parameters, Shapes::ShapeRef.new(shape: ProvisioningArtifactParameters, location_name: "ProvisioningArtifactParameters"))
     DescribeProvisioningArtifactOutput.struct_class = Types::DescribeProvisioningArtifactOutput
 
     DescribeProvisioningParametersInput.add_member(:accept_language, Shapes::ShapeRef.new(shape: AcceptLanguage, location_name: "AcceptLanguage"))

data/lib/aws-sdk-servicecatalog/types.rb

@@ -114,18 +114,73 @@ module Aws::ServiceCatalog
     #   @return [String]
     #
     # @!attribute [rw] principal_arn
-    #   The ARN of the principal (user, role, or group). This field allows
-    #   an ARN with no `accountID` if `PrincipalType` is `IAM_PATTERN`.
+    #   The ARN of the principal (user, role, or group). If the
+    #   `PrincipalType` is `IAM`, the supported value is a fully defined
+    #   [IAM Amazon Resource Name (ARN)][1]. If the `PrincipalType` is
+    #   `IAM_PATTERN`, the supported value is an `IAM` ARN *without an
+    #   AccountID* in the following format:
+    #
+    #   *arn:partition:iam:::resource-type/resource-id*
+    #
+    #   The ARN resource-id can be either:
+    #
+    #   * A fully formed resource-id. For example,
+    #     *arn:aws:iam:::role/resource-name* or
+    #     *arn:aws:iam:::role/resource-path/resource-name*
+    #
+    #   * A wildcard ARN. The wildcard ARN accepts `IAM_PATTERN` values with
+    #     a "*" or "?" in the resource-id segment of the ARN. For
+    #     example
+    #     *arn:partition:service:::resource-type/resource-path/resource-name*.
+    #     The new symbols are exclusive to the **resource-path** and
+    #     **resource-name** and cannot replace the **resource-type** or
+    #     other ARN values.
+    #
+    #     The ARN path and principal name allow unlimited wildcard
+    #     characters.
+    #
+    #   Examples of an **acceptable** wildcard ARN:
+    #
+    #   * arn:aws:iam:::role/ResourceName\_*
+    #
+    #   * arn:aws:iam:::role/*/ResourceName\_?
+    #
+    #   Examples of an **unacceptable** wildcard ARN:
+    #
+    #   * arn:aws:iam:::*/ResourceName
+    #
+    #   ^
+    #
+    #   You can associate multiple `IAM_PATTERN`s even if the account has no
+    #   principal with that name.
+    #
+    #   The "?" wildcard character matches zero or one of any character.
+    #   This is similar to ".?" in regular regex context. The "*"
+    #   wildcard character matches any number of any characters. This is
+    #   similar to ".*" in regular regex context.
+    #
+    #   In the IAM Principal ARN format
+    #   (*arn:partition:iam:::resource-type/resource-path/resource-name*),
+    #   valid resource-type values include **user/**, **group/**, or
+    #   **role/**. The "?" and "*" characters are allowed only after
+    #   the resource-type in the resource-id segment. You can use special
+    #   characters anywhere within the resource-id.
     #
-    #   You can associate multiple `IAM` patterns even if the account has no
-    #   principal with that name. This is useful in Principal Name Sharing
-    #   if you want to share a principal without creating it in the account
-    #   that owns the portfolio.
+    #   The "*" character also matches the "/" character, allowing
+    #   paths to be formed *within* the resource-id. For example,
+    #   *arn:aws:iam:::role/*****/ResourceName\_?* matches both
+    #   *arn:aws:iam:::role/pathA/pathB/ResourceName\_1* and
+    #   *arn:aws:iam:::role/pathA/ResourceName\_1*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-arns
     #   @return [String]
     #
     # @!attribute [rw] principal_type
     #   The principal type. The supported value is `IAM` if you use a fully
-    #   defined ARN, or `IAM_PATTERN` if you use an ARN with no `accountID`.
+    #   defined Amazon Resource Name (ARN), or `IAM_PATTERN` if you use an
+    #   ARN with no `accountID`, with or without wildcard characters.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/AssociatePrincipalWithPortfolioInput AWS API Documentation
@@ -1985,6 +2040,11 @@ module Aws::ServiceCatalog
     #   Indicates whether a verbose level of detail is enabled.
     #   @return [Boolean]
     #
+    # @!attribute [rw] include_provisioning_artifact_parameters
+    #   Indicates if the API call response does or does not include
+    #   additional details about the provisioning parameters.
+    #   @return [Boolean]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/DescribeProvisioningArtifactInput AWS API Documentation
     #
     class DescribeProvisioningArtifactInput < Struct.new(
@@ -1993,7 +2053,8 @@ module Aws::ServiceCatalog
       :product_id,
       :provisioning_artifact_name,
       :product_name,
-      :verbose)
+      :verbose,
+      :include_provisioning_artifact_parameters)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2011,12 +2072,17 @@ module Aws::ServiceCatalog
     #   The status of the current request.
     #   @return [String]
     #
+    # @!attribute [rw] provisioning_artifact_parameters
+    #   Information about the parameters used to provision the product.
+    #   @return [Array<Types::ProvisioningArtifactParameter>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/DescribeProvisioningArtifactOutput AWS API Documentation
     #
     class DescribeProvisioningArtifactOutput < Struct.new(
       :provisioning_artifact_detail,
       :info,
-      :status)
+      :status,
+      :provisioning_artifact_parameters)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2320,12 +2386,14 @@ module Aws::ServiceCatalog
     #
     # @!attribute [rw] principal_arn
     #   The ARN of the principal (user, role, or group). This field allows
-    #   an ARN with no `accountID` if `PrincipalType` is `IAM_PATTERN`.
+    #   an ARN with no `accountID` with or without wildcard characters if
+    #   `PrincipalType` is `IAM_PATTERN`.
     #   @return [String]
     #
     # @!attribute [rw] principal_type
     #   The supported value is `IAM` if you use a fully defined ARN, or
-    #   `IAM_PATTERN` if you use no `accountID`.
+    #   `IAM_PATTERN` if you specify an `IAM` ARN with no AccountId, with or
+    #   without wildcard characters.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/DisassociatePrincipalFromPortfolioInput AWS API Documentation
@@ -4187,13 +4255,21 @@ module Aws::ServiceCatalog
     #
     # @!attribute [rw] principal_arn
     #   The ARN of the principal (user, role, or group). This field allows
-    #   for an ARN with no `accountID` if the `PrincipalType` is an
-    #   `IAM_PATTERN`.
+    #   for an ARN with no `accountID`, with or without wildcard characters
+    #   if the `PrincipalType` is an `IAM_PATTERN`.
+    #
+    #   For more information, review [associate-principal-with-portfolio][1]
+    #   in the Amazon Web Services CLI Command Reference.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/cli/latest/reference/servicecatalog/associate-principal-with-portfolio.html#options
     #   @return [String]
     #
     # @!attribute [rw] principal_type
     #   The principal type. The supported value is `IAM` if you use a fully
-    #   defined ARN, or `IAM_PATTERN` if you use an ARN with no `accountID`.
+    #   defined ARN, or `IAM_PATTERN` if you use an ARN with no `accountID`,
+    #   with or without wildcard characters.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/Principal AWS API Documentation

data/lib/aws-sdk-servicecatalog.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-servicecatalog/customizations'
 # @!group service
 module Aws::ServiceCatalog
 
-  GEM_VERSION = '1.79.0'
+  GEM_VERSION = '1.81.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-servicecatalog
 version: !ruby/object:Gem::Version
-  version: 1.79.0
+  version: 1.81.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-04-07 00:00:00.000000000 Z
+date: 2023-06-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.165.0
+        version: 3.174.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.165.0
+        version: 3.174.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement