aws-sdk-servicecatalog 1.79.0 → 1.80.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 54f5d17ad7319a313a0368674c9babcc18c52d0bceb42573b18e1aea70e71a31
-  data.tar.gz: 6204e33542c232cbf5089148c0f9be26dcf19ceeb2c819fd15f806d7825be1ed
+  metadata.gz: 48ee0a58b46c9e2dd705f01119a78966aac2d7e4a583627573805504fc61cad7
+  data.tar.gz: 34d0e1f1f9a3a14bd61dfdf41203bb7fbc958a8bc6cfd78ccd68cf984641974e
 SHA512:
-  metadata.gz: be125ed02086942c9cafd68a167b289a364509db6ef6c29c82ed28aa76d24ee158dc1506e97197259fc2be80606c24f40058ed5417dfef1b260e4ab0e680e585
-  data.tar.gz: bf71f518bdbfa974f495e0929160bf80c7654c709dc550ac09bf5894518dc3d23ba62a10afd1703d7514e6ee0e6b21ee8078ecb500206a95d2284f63b984d724
+  metadata.gz: 5210dc34151aecd5fd48229fd8f8bd4ea9fb79ef99af8459e8c52c9f605ad6cb717fdbce05d15b5d0e9536e8cc8a15a5ff2df2468b4e648bcd6772dbf12b74e5
+  data.tar.gz: 9b64b496bd04a0a9ec0ae88b4067ebdd68b83dc86b05690c4f16fd83361bab7b961be917544106f5f2465d593fd1f495a37676188ef84fbdae71cdb3ab31a5a9

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+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.80.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,71 @@ 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). The supported value
+    #   is a fully defined [ `IAM` ARN][1] if the `PrincipalType` is `IAM`. 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 resource-id can be either of the following:
+    #
+    #   * Fully formed, 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 be used to replace the
+    #     **resource-type** or other ARN values.
+    #
+    #   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.
+    #
+    #   <note markdown="1"> * The ARN path and principal name allow unlimited wildcard characters.
     #
-    #   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 "?" 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 ".*" in regular regex context.
+    #
+    #   * In the IAM Principal ARNs format
+    #     (arn:partition:iam:::resource-type/resource-path/resource-name),
+    #     valid **resource-type** values include user/, group/, or role/. The
+    #     "?" and "*" are allowed only after the **resource-type**, in
+    #     the resource-id segment. You can use special characters anywhere
+    #     within the **resource-id**.
+    #
+    #   * The "*" 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.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [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 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}.
     #
@@ -2974,6 +3033,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 +3062,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 +6216,7 @@ module Aws::ServiceCatalog
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-servicecatalog'
-      context[:gem_version] = '1.79.0'
+      context[:gem_version] = '1.80.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -114,18 +114,74 @@ 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). The supported value
+    #   is a fully defined [ `IAM` ARN][1] if the `PrincipalType` is `IAM`.
+    #   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 resource-id can be either of the following:
+    #
+    #   * Fully formed, 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 be used to replace the
+    #     **resource-type** or other ARN values.
+    #
+    #   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.
     #
-    #   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.
+    #   <note markdown="1"> * The ARN path and principal name allow unlimited wildcard
+    #     characters.
+    #
+    #   * 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 ".*" in regular regex context.
+    #
+    #   * In the IAM Principal ARNs format
+    #     (arn:partition:iam:::resource-type/resource-path/resource-name),
+    #     valid **resource-type** values include user/, group/, or role/.
+    #     The "?" and "*" are allowed only after the **resource-type**,
+    #     in the resource-id segment. You can use special characters
+    #     anywhere within the **resource-id**.
+    #
+    #   * The "*" 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.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [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 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
@@ -2320,12 +2376,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 +4245,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.80.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.80.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-04-07 00:00:00.000000000 Z
+date: 2023-05-31 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