aws-sdk-globalaccelerator 1.56.0 → 1.57.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0d01bf15bf32922350c29fdac0ff7f2f23e1b7941ea4688bf30f8f2d6f2115fa
-  data.tar.gz: 16b68db376da3c5d0af3de4a045edb55915d2ff4e4cfc4c9ebff6008e24e7d1a
+  metadata.gz: 16113719ee88cdbafec471657cc49d934b4b23efa53c70f99008310a927108ee
+  data.tar.gz: 5a9a3daa721448ad26844706ed7775433279947aaab7d9aa4e455b97de86e9a5
 SHA512:
-  metadata.gz: e61424573903669104d67d0aecea5720248355dc7af2a059418060222a52bf150498e421c9b6c10e32b6bfd0423344c6413b99e6afd1e061c537086c6a7eb47d
-  data.tar.gz: 4b5ed1238f71d1c877f3001e07b3fa76d631d2b8322b959a1b9eaac789354c91925292ad7817372339f71d94d4137e07e98af301a42c01cb0e1978bbbdee1a16
+  metadata.gz: 3400e01cbcecd336507e88750741fb0517dae756e2957ecfb3dfe70c2144fed5a9126dcf6989a6499c0f16c2e96148f9748e350194df12e6838c172ddedbb9be
+  data.tar.gz: 773fcdff0e19fbc4218e4cb13f654cc7c96197bde2a768a3117e436680fb35dc4eb5e3006eec62a35c678de5af3e11f21b4fbf75bdb1d09940b7295b89829306

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.57.0 (2024-03-25)
+------------------
+
+* Feature - AWS Global Accelerator now supports cross-account sharing for bring your own IP addresses.
+
 1.56.0 (2024-01-26)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.56.0
+1.57.0

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

@@ -552,6 +552,13 @@ module Aws::GlobalAccelerator
     #   you provisioned. You can't advertise only a portion of the
     #   provisioned range.
     #
+    #   For more information, see [Bring your own IP addresses (BYOIP)][1] in
+    #   the Global Accelerator Developer Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html
+    #
     # @return [Types::AdvertiseByoipCidrResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::AdvertiseByoipCidrResponse#byoip_cidr #byoip_cidr} => Types::ByoipCidr
@@ -773,31 +780,49 @@ module Aws::GlobalAccelerator
 
     # Create a cross-account attachment in Global Accelerator. You create a
     # cross-account attachment to specify the *principals* who have
-    # permission to add to accelerators in their own account the resources
-    # in your account that you also list in the attachment.
+    # permission to work with *resources* in accelerators in their own
+    # account. You specify, in the same attachment, the resources that are
+    # shared.
     #
     # A principal can be an Amazon Web Services account number or the Amazon
     # Resource Name (ARN) for an accelerator. For account numbers that are
-    # listed as principals, to add a resource listed in the attachment to an
-    # accelerator, you must sign in to an account specified as a principal.
-    # Then you can add the resources that are listed to any of your
+    # listed as principals, to work with a resource listed in the
+    # attachment, you must sign in to an account specified as a principal.
+    # Then, you can work with resources that are listed, with any of your
     # accelerators. If an accelerator ARN is listed in the cross-account
     # attachment as a principal, anyone with permission to make updates to
-    # the accelerator can add as endpoints resources that are listed in the
+    # the accelerator can work with resources that are listed in the
     # attachment.
     #
+    # Specify each principal and resource separately. To specify two CIDR
+    # address pools, list them individually under `Resources`, and so on.
+    # For a command line operation, for example, you might use a statement
+    # like the following:
+    #
+    # ` "Resources": [\{"Cidr": "169.254.60.0/24"\},\{"Cidr":
+    # "169.254.59.0/24"\}]`
+    #
+    # For more information, see [ Working with cross-account attachments and
+    # resources in Global Accelerator][1] in the <i> Global Accelerator
+    # Developer Guide</i>.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/global-accelerator/latest/dg/cross-account-resources.html
+    #
     # @option params [required, String] :name
     #   The name of the cross-account attachment.
     #
     # @option params [Array<String>] :principals
-    #   The principals to list in the cross-account attachment. A principal
+    #   The principals to include in the cross-account attachment. A principal
     #   can be an Amazon Web Services account number or the Amazon Resource
     #   Name (ARN) for an accelerator.
     #
     # @option params [Array<Types::Resource>] :resources
-    #   The Amazon Resource Names (ARNs) for the resources to list in the
+    #   The Amazon Resource Names (ARNs) for the resources to include in the
     #   cross-account attachment. A resource can be any supported Amazon Web
-    #   Services resource type for Global Accelerator.
+    #   Services resource type for Global Accelerator or a CIDR range for a
+    #   bring your own IP address (BYOIP) address pool.
     #
     # @option params [required, String] :idempotency_token
     #   A unique, case-sensitive identifier that you provide to ensure the
@@ -807,7 +832,7 @@ module Aws::GlobalAccelerator
     #   not need to pass this option.**
     #
     # @option params [Array<Types::Tag>] :tags
-    #   Create tags for cross-account attachment.
+    #   Add tags for a cross-account attachment.
     #
     #   For more information, see [Tagging in Global Accelerator][1] in the
     #   *Global Accelerator Developer Guide*.
@@ -827,7 +852,8 @@ module Aws::GlobalAccelerator
     #     principals: ["Principal"],
     #     resources: [
     #       {
-    #         endpoint_id: "GenericString", # required
+    #         endpoint_id: "GenericString",
+    #         cidr: "GenericString",
     #         region: "GenericString",
     #       },
     #     ],
@@ -848,6 +874,7 @@ module Aws::GlobalAccelerator
     #   resp.cross_account_attachment.principals[0] #=> String
     #   resp.cross_account_attachment.resources #=> Array
     #   resp.cross_account_attachment.resources[0].endpoint_id #=> String
+    #   resp.cross_account_attachment.resources[0].cidr #=> String
     #   resp.cross_account_attachment.resources[0].region #=> String
     #   resp.cross_account_attachment.last_modified_time #=> Time
     #   resp.cross_account_attachment.created_time #=> Time
@@ -1381,23 +1408,15 @@ module Aws::GlobalAccelerator
     # Delete a cross-account attachment. When you delete an attachment,
     # Global Accelerator revokes the permission to use the resources in the
     # attachment from all principals in the list of principals. Global
-    # Accelerator revokes the permission for specific resources by doing the
-    # following:
+    # Accelerator revokes the permission for specific resources.
     #
-    # * If the principal is an account ID, Global Accelerator reviews every
-    #   accelerator in the account and removes cross-account endpoints from
-    #   all accelerators.
+    # For more information, see [ Working with cross-account attachments and
+    # resources in Global Accelerator][1] in the <i> Global Accelerator
+    # Developer Guide</i>.
     #
-    # * If the principal is an accelerator, Global Accelerator reviews just
-    #   that accelerator and removes cross-account endpoints from it.
     #
-    # If there are overlapping permissions provided by multiple
-    # cross-account attachments, Global Accelerator only removes endpoints
-    # if there are no current cross-account attachments that provide access
-    # permission. For example, if you delete a cross-account attachment that
-    # lists an accelerator as a principal, but another cross-account
-    # attachment includes the account ID that owns that accelerator,
-    # endpoints will not be removed from the accelerator.
+    #
+    # [1]: https://docs.aws.amazon.com/global-accelerator/latest/dg/cross-account-resources.html
     #
     # @option params [required, String] :attachment_arn
     #   The Amazon Resource Name (ARN) for the cross-account attachment to
@@ -1639,6 +1658,13 @@ module Aws::GlobalAccelerator
     #   The address range, in CIDR notation. The prefix must be the same
     #   prefix that you specified when you provisioned the address range.
     #
+    #   For more information, see [Bring your own IP addresses (BYOIP)][1] in
+    #   the Global Accelerator Developer Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html
+    #
     # @return [Types::DeprovisionByoipCidrResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DeprovisionByoipCidrResponse#byoip_cidr #byoip_cidr} => Types::ByoipCidr
@@ -1765,6 +1791,7 @@ module Aws::GlobalAccelerator
     #   resp.cross_account_attachment.principals[0] #=> String
     #   resp.cross_account_attachment.resources #=> Array
     #   resp.cross_account_attachment.resources[0].endpoint_id #=> String
+    #   resp.cross_account_attachment.resources[0].cidr #=> String
     #   resp.cross_account_attachment.resources[0].region #=> String
     #   resp.cross_account_attachment.last_modified_time #=> Time
     #   resp.cross_account_attachment.created_time #=> Time
@@ -2131,6 +2158,7 @@ module Aws::GlobalAccelerator
     #   resp.cross_account_attachments[0].principals[0] #=> String
     #   resp.cross_account_attachments[0].resources #=> Array
     #   resp.cross_account_attachments[0].resources[0].endpoint_id #=> String
+    #   resp.cross_account_attachments[0].resources[0].cidr #=> String
     #   resp.cross_account_attachments[0].resources[0].region #=> String
     #   resp.cross_account_attachments[0].last_modified_time #=> Time
     #   resp.cross_account_attachments[0].created_time #=> Time
@@ -2145,7 +2173,15 @@ module Aws::GlobalAccelerator
       req.send_request(options)
     end
 
-    # List the accounts that have cross-account endpoints.
+    # List the accounts that have cross-account resources.
+    #
+    # For more information, see [ Working with cross-account attachments and
+    # resources in Global Accelerator][1] in the <i> Global Accelerator
+    # Developer Guide</i>.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/global-accelerator/latest/dg/cross-account-resources.html
     #
     # @return [Types::ListCrossAccountResourceAccountsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2165,7 +2201,7 @@ module Aws::GlobalAccelerator
       req.send_request(options)
     end
 
-    # List the cross-account endpoints available to add to an accelerator.
+    # List the cross-account resources available to work with.
     #
     # @option params [String] :accelerator_arn
     #   The Amazon Resource Name (ARN) of an accelerator in a cross-account
@@ -2175,7 +2211,7 @@ module Aws::GlobalAccelerator
     #   The account ID of a resource owner in a cross-account attachment.
     #
     # @option params [Integer] :max_results
-    #   The number of cross-account endpoints objects that you want to return
+    #   The number of cross-account resource objects that you want to return
     #   with this call. The default value is 10.
     #
     # @option params [String] :next_token
@@ -2202,6 +2238,7 @@ module Aws::GlobalAccelerator
     #
     #   resp.cross_account_resources #=> Array
     #   resp.cross_account_resources[0].endpoint_id #=> String
+    #   resp.cross_account_resources[0].cidr #=> String
     #   resp.cross_account_resources[0].attachment_arn #=> String
     #   resp.next_token #=> String
     #
@@ -2663,8 +2700,15 @@ module Aws::GlobalAccelerator
     # @option params [required, String] :cidr
     #   The public IPv4 address range, in CIDR notation. The most specific IP
     #   prefix that you can specify is /24. The address range cannot overlap
-    #   with another address range that you've brought to this or another
-    #   Region.
+    #   with another address range that you've brought to this Amazon Web
+    #   Services Region or another Region.
+    #
+    #   For more information, see [Bring your own IP addresses (BYOIP)][1] in
+    #   the Global Accelerator Developer Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html
     #
     # @option params [required, Types::CidrAuthorizationContext] :cidr_authorization_context
     #   A signed document that proves that you are authorized to bring the
@@ -3007,22 +3051,15 @@ module Aws::GlobalAccelerator
     # Update a cross-account attachment to add or remove principals or
     # resources. When you update an attachment to remove a principal
     # (account ID or accelerator) or a resource, Global Accelerator revokes
-    # the permission for specific resources by doing the following:
+    # the permission for specific resources.
     #
-    # * If the principal is an account ID, Global Accelerator reviews every
-    #   accelerator in the account and removes cross-account endpoints from
-    #   all accelerators.
+    # For more information, see [ Working with cross-account attachments and
+    # resources in Global Accelerator][1] in the <i> Global Accelerator
+    # Developer Guide</i>.
     #
-    # * If the principal is an accelerator, Global Accelerator reviews just
-    #   that accelerator and removes cross-account endpoints from it.
     #
-    # If there are overlapping permissions provided by multiple
-    # cross-account attachments, Global Accelerator only removes endpoints
-    # if there are no current cross-account attachments that provide access
-    # permission. For example, if you delete a cross-account attachment that
-    # lists an accelerator as a principal, but another cross-account
-    # attachment includes the account ID that owns that accelerator,
-    # endpoints will not be removed from the accelerator.
+    #
+    # [1]: https://docs.aws.amazon.com/global-accelerator/latest/dg/cross-account-resources.html
     #
     # @option params [required, String] :attachment_arn
     #   The Amazon Resource Name (ARN) of the cross-account attachment to
@@ -3034,8 +3071,8 @@ module Aws::GlobalAccelerator
     # @option params [Array<String>] :add_principals
     #   The principals to add to the cross-account attachment. A principal is
     #   an account or the Amazon Resource Name (ARN) of an accelerator that
-    #   the attachment gives permission to add the resources from another
-    #   account, listed in the attachment.
+    #   the attachment gives permission to work with resources from another
+    #   account. The resources are also listed in the attachment.
     #
     #   To add more than one principal, separate the account numbers or
     #   accelerator ARNs, or both, with commas.
@@ -3043,23 +3080,24 @@ module Aws::GlobalAccelerator
     # @option params [Array<String>] :remove_principals
     #   The principals to remove from the cross-account attachment. A
     #   principal is an account or the Amazon Resource Name (ARN) of an
-    #   accelerator that is given permission to add the resources from another
-    #   account, listed in the cross-account attachment.
+    #   accelerator that the attachment gives permission to work with
+    #   resources from another account. The resources are also listed in the
+    #   attachment.
     #
     #   To remove more than one principal, separate the account numbers or
     #   accelerator ARNs, or both, with commas.
     #
     # @option params [Array<Types::Resource>] :add_resources
     #   The resources to add to the cross-account attachment. A resource
-    #   listed in a cross-account attachment can be added to an accelerator by
-    #   the principals that are listed in the attachment.
+    #   listed in a cross-account attachment can be used with an accelerator
+    #   by the principals that are listed in the attachment.
     #
     #   To add more than one resource, separate the resource ARNs with commas.
     #
     # @option params [Array<Types::Resource>] :remove_resources
     #   The resources to remove from the cross-account attachment. A resource
-    #   listed in a cross-account attachment can be added to an accelerator fy
-    #   principals that are listed in the cross-account attachment.
+    #   listed in a cross-account attachment can be used with an accelerator
+    #   by the principals that are listed in the attachment.
     #
     #   To remove more than one resource, separate the resource ARNs with
     #   commas.
@@ -3077,13 +3115,15 @@ module Aws::GlobalAccelerator
     #     remove_principals: ["Principal"],
     #     add_resources: [
     #       {
-    #         endpoint_id: "GenericString", # required
+    #         endpoint_id: "GenericString",
+    #         cidr: "GenericString",
     #         region: "GenericString",
     #       },
     #     ],
     #     remove_resources: [
     #       {
-    #         endpoint_id: "GenericString", # required
+    #         endpoint_id: "GenericString",
+    #         cidr: "GenericString",
     #         region: "GenericString",
     #       },
     #     ],
@@ -3097,6 +3137,7 @@ module Aws::GlobalAccelerator
     #   resp.cross_account_attachment.principals[0] #=> String
     #   resp.cross_account_attachment.resources #=> Array
     #   resp.cross_account_attachment.resources[0].endpoint_id #=> String
+    #   resp.cross_account_attachment.resources[0].cidr #=> String
     #   resp.cross_account_attachment.resources[0].region #=> String
     #   resp.cross_account_attachment.last_modified_time #=> Time
     #   resp.cross_account_attachment.created_time #=> Time
@@ -3491,6 +3532,13 @@ module Aws::GlobalAccelerator
     # @option params [required, String] :cidr
     #   The address range, in CIDR notation.
     #
+    #   For more information, see [Bring your own IP addresses (BYOIP)][1] in
+    #   the Global Accelerator Developer Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html
+    #
     # @return [Types::WithdrawByoipCidrResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::WithdrawByoipCidrResponse#byoip_cidr #byoip_cidr} => Types::ByoipCidr
@@ -3531,7 +3579,7 @@ module Aws::GlobalAccelerator
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-globalaccelerator'
-      context[:gem_version] = '1.56.0'
+      context[:gem_version] = '1.57.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -415,6 +415,7 @@ module Aws::GlobalAccelerator
     CreateListenerResponse.struct_class = Types::CreateListenerResponse
 
     CrossAccountResource.add_member(:endpoint_id, Shapes::ShapeRef.new(shape: GenericString, location_name: "EndpointId"))
+    CrossAccountResource.add_member(:cidr, Shapes::ShapeRef.new(shape: GenericString, location_name: "Cidr"))
     CrossAccountResource.add_member(:attachment_arn, Shapes::ShapeRef.new(shape: GenericString, location_name: "AttachmentArn"))
     CrossAccountResource.struct_class = Types::CrossAccountResource
 
@@ -822,7 +823,8 @@ module Aws::GlobalAccelerator
     RemoveEndpointsRequest.add_member(:endpoint_group_arn, Shapes::ShapeRef.new(shape: GenericString, required: true, location_name: "EndpointGroupArn"))
     RemoveEndpointsRequest.struct_class = Types::RemoveEndpointsRequest
 
-    Resource.add_member(:endpoint_id, Shapes::ShapeRef.new(shape: GenericString, required: true, location_name: "EndpointId"))
+    Resource.add_member(:endpoint_id, Shapes::ShapeRef.new(shape: GenericString, location_name: "EndpointId"))
+    Resource.add_member(:cidr, Shapes::ShapeRef.new(shape: GenericString, location_name: "Cidr"))
     Resource.add_member(:region, Shapes::ShapeRef.new(shape: GenericString, location_name: "Region"))
     Resource.struct_class = Types::Resource
 

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

@@ -303,6 +303,13 @@ module Aws::GlobalAccelerator
     #   The address range, in CIDR notation. This must be the exact range
     #   that you provisioned. You can't advertise only a portion of the
     #   provisioned range.
+    #
+    #   For more information, see [Bring your own IP addresses (BYOIP)][1]
+    #   in the Global Accelerator Developer Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/AdvertiseByoipCidrRequest AWS API Documentation
@@ -410,9 +417,8 @@ module Aws::GlobalAccelerator
     end
 
     # A cross-account attachment in Global Accelerator. A cross-account
-    # attachment specifies the *principals* who have permission to add to
-    # accelerators in their own account the resources in your account that
-    # you also list in the attachment.
+    # attachment specifies the *principals* who have permission to work with
+    # *resources* in your account, which you also list in the attachment.
     #
     # @!attribute [rw] attachment_arn
     #   The Amazon Resource Name (ARN) of the cross-account attachment.
@@ -523,6 +529,13 @@ module Aws::GlobalAccelerator
     #
     # @!attribute [rw] cidr
     #   The address range, in CIDR notation.
+    #
+    #   For more information, see [Bring your own IP addresses (BYOIP)][1]
+    #   in the Global Accelerator Developer Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html
     #   @return [String]
     #
     # @!attribute [rw] state
@@ -723,15 +736,16 @@ module Aws::GlobalAccelerator
     #   @return [String]
     #
     # @!attribute [rw] principals
-    #   The principals to list in the cross-account attachment. A principal
-    #   can be an Amazon Web Services account number or the Amazon Resource
-    #   Name (ARN) for an accelerator.
+    #   The principals to include in the cross-account attachment. A
+    #   principal can be an Amazon Web Services account number or the Amazon
+    #   Resource Name (ARN) for an accelerator.
     #   @return [Array<String>]
     #
     # @!attribute [rw] resources
-    #   The Amazon Resource Names (ARNs) for the resources to list in the
+    #   The Amazon Resource Names (ARNs) for the resources to include in the
     #   cross-account attachment. A resource can be any supported Amazon Web
-    #   Services resource type for Global Accelerator.
+    #   Services resource type for Global Accelerator or a CIDR range for a
+    #   bring your own IP address (BYOIP) address pool.
     #   @return [Array<Types::Resource>]
     #
     # @!attribute [rw] idempotency_token
@@ -743,7 +757,7 @@ module Aws::GlobalAccelerator
     #   @return [String]
     #
     # @!attribute [rw] tags
-    #   Create tags for cross-account attachment.
+    #   Add tags for a cross-account attachment.
     #
     #   For more information, see [Tagging in Global Accelerator][1] in the
     #   *Global Accelerator Developer Guide*.
@@ -1147,9 +1161,18 @@ module Aws::GlobalAccelerator
       include Aws::Structure
     end
 
-    # An endpoint (Amazon Web Services resource) that is listed in a
-    # cross-account attachment and can be added to an accelerator by
-    # specified principals, that are also listed in the attachment.
+    # An endpoint (Amazon Web Services resource) or an IP address range, in
+    # CIDR format, that is listed in a cross-account attachment. A
+    # cross-account resource can be added to an accelerator by specified
+    # principals, which are also listed in the attachment.
+    #
+    # For more information, see [ Working with cross-account attachments and
+    # resources in Global Accelerator][1] in the <i> Global Accelerator
+    # Developer Guide</i>.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/global-accelerator/latest/dg/cross-account-resources.html
     #
     # @!attribute [rw] endpoint_id
     #   The endpoint ID for the endpoint that is listed in a cross-account
@@ -1157,17 +1180,31 @@ module Aws::GlobalAccelerator
     #   principals.
     #   @return [String]
     #
+    # @!attribute [rw] cidr
+    #   An IP address range, in CIDR format, that is specified as an Amazon
+    #   Web Services resource. The address must be provisioned and
+    #   advertised in Global Accelerator by following the bring your own IP
+    #   address (BYOIP) process for Global Accelerator.
+    #
+    #   For more information, see [Bring your own IP addresses (BYOIP)][1]
+    #   in the Global Accelerator Developer Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html
+    #   @return [String]
+    #
     # @!attribute [rw] attachment_arn
     #   The Amazon Resource Name (ARN) of the cross-account attachment that
-    #   specifies the endpoints (resources) that can be added to
-    #   accelerators and principals that have permission to add the
-    #   endpoints to accelerators.
+    #   specifies the resources (endpoints or CIDR range) that can be added
+    #   to accelerators and principals that have permission to add them.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/CrossAccountResource AWS API Documentation
     #
     class CrossAccountResource < Struct.new(
       :endpoint_id,
+      :cidr,
       :attachment_arn)
       SENSITIVE = []
       include Aws::Structure
@@ -1367,7 +1404,7 @@ module Aws::GlobalAccelerator
     #   The Amazon Resource Name (ARN) of the cross-account attachment that
     #   specifies the endpoints (resources) that can be added to
     #   accelerators and principals that have permission to add the
-    #   endpoints to accelerators.
+    #   endpoints.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/CustomRoutingEndpointConfiguration AWS API Documentation
@@ -1598,6 +1635,13 @@ module Aws::GlobalAccelerator
     # @!attribute [rw] cidr
     #   The address range, in CIDR notation. The prefix must be the same
     #   prefix that you specified when you provisioned the address range.
+    #
+    #   For more information, see [Bring your own IP addresses (BYOIP)][1]
+    #   in the Global Accelerator Developer Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/DeprovisionByoipCidrRequest AWS API Documentation
@@ -1919,8 +1963,7 @@ module Aws::GlobalAccelerator
     #   is the EC2 instance ID. A resource must be valid and active when you
     #   add it as an endpoint.
     #
-    #   An Application Load Balancer can be either internal or
-    #   internet-facing.
+    #   For cross-account endpoints, this must be the ARN of the resource.
     #   @return [String]
     #
     # @!attribute [rw] weight
@@ -1965,7 +2008,7 @@ module Aws::GlobalAccelerator
     #   The Amazon Resource Name (ARN) of the cross-account attachment that
     #   specifies the endpoints (resources) that can be added to
     #   accelerators and principals that have permission to add the
-    #   endpoints to accelerators.
+    #   endpoints.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/EndpointConfiguration AWS API Documentation
@@ -2431,7 +2474,7 @@ module Aws::GlobalAccelerator
 
     # @!attribute [rw] resource_owner_aws_account_ids
     #   The account IDs of principals (resource owners) in a cross-account
-    #   attachment who can add endpoints (resources) listed in the same
+    #   attachment who can work with resources listed in the same
     #   attachment.
     #   @return [Array<String>]
     #
@@ -2453,8 +2496,8 @@ module Aws::GlobalAccelerator
     #   @return [String]
     #
     # @!attribute [rw] max_results
-    #   The number of cross-account endpoints objects that you want to
-    #   return with this call. The default value is 10.
+    #   The number of cross-account resource objects that you want to return
+    #   with this call. The default value is 10.
     #   @return [Integer]
     #
     # @!attribute [rw] next_token
@@ -2474,8 +2517,7 @@ module Aws::GlobalAccelerator
     end
 
     # @!attribute [rw] cross_account_resources
-    #   The endpoints attached to an accelerator in a cross-account
-    #   attachment.
+    #   The cross-account resources used with an accelerator.
     #   @return [Array<Types::CrossAccountResource>]
     #
     # @!attribute [rw] next_token
@@ -2992,8 +3034,15 @@ module Aws::GlobalAccelerator
     # @!attribute [rw] cidr
     #   The public IPv4 address range, in CIDR notation. The most specific
     #   IP prefix that you can specify is /24. The address range cannot
-    #   overlap with another address range that you've brought to this or
-    #   another Region.
+    #   overlap with another address range that you've brought to this
+    #   Amazon Web Services Region or another Region.
+    #
+    #   For more information, see [Bring your own IP addresses (BYOIP)][1]
+    #   in the Global Accelerator Developer Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html
     #   @return [String]
     #
     # @!attribute [rw] cidr_authorization_context
@@ -3058,21 +3107,44 @@ module Aws::GlobalAccelerator
       include Aws::Structure
     end
 
-    # An Amazon Web Services resource that is supported by Global
-    # Accelerator and can be added as an endpoint for an accelerator.
+    # A resource is one of the following: the ARN for an Amazon Web Services
+    # resource that is supported by Global Accelerator to be added as an
+    # endpoint, or a CIDR range that specifies a bring your own IP (BYOIP)
+    # address pool.
     #
     # @!attribute [rw] endpoint_id
-    #   The endpoint ID for the endpoint (Amazon Web Services resource).
+    #   The endpoint ID for the endpoint that is specified as a Amazon Web
+    #   Services resource.
+    #
+    #   An endpoint ID for the cross-account feature is the ARN of an Amazon
+    #   Web Services resource, such as a Network Load Balancer, that Global
+    #   Accelerator supports as an endpoint for an accelerator.
+    #   @return [String]
+    #
+    # @!attribute [rw] cidr
+    #   An IP address range, in CIDR format, that is specified as resource.
+    #   The address must be provisioned and advertised in Global Accelerator
+    #   by following the bring your own IP address (BYOIP) process for
+    #   Global Accelerator
+    #
+    #   For more information, see [Bring your own IP addresses (BYOIP)][1]
+    #   in the Global Accelerator Developer Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html
     #   @return [String]
     #
     # @!attribute [rw] region
-    #   The Amazon Web Services Region where a resource is located.
+    #   The Amazon Web Services Region where a shared endpoint resource is
+    #   located.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/Resource AWS API Documentation
     #
     class Resource < Struct.new(
       :endpoint_id,
+      :cidr,
       :region)
       SENSITIVE = []
       include Aws::Structure
@@ -3293,8 +3365,8 @@ module Aws::GlobalAccelerator
     # @!attribute [rw] add_principals
     #   The principals to add to the cross-account attachment. A principal
     #   is an account or the Amazon Resource Name (ARN) of an accelerator
-    #   that the attachment gives permission to add the resources from
-    #   another account, listed in the attachment.
+    #   that the attachment gives permission to work with resources from
+    #   another account. The resources are also listed in the attachment.
     #
     #   To add more than one principal, separate the account numbers or
     #   accelerator ARNs, or both, with commas.
@@ -3303,8 +3375,9 @@ module Aws::GlobalAccelerator
     # @!attribute [rw] remove_principals
     #   The principals to remove from the cross-account attachment. A
     #   principal is an account or the Amazon Resource Name (ARN) of an
-    #   accelerator that is given permission to add the resources from
-    #   another account, listed in the cross-account attachment.
+    #   accelerator that the attachment gives permission to work with
+    #   resources from another account. The resources are also listed in the
+    #   attachment.
     #
     #   To remove more than one principal, separate the account numbers or
     #   accelerator ARNs, or both, with commas.
@@ -3312,7 +3385,7 @@ module Aws::GlobalAccelerator
     #
     # @!attribute [rw] add_resources
     #   The resources to add to the cross-account attachment. A resource
-    #   listed in a cross-account attachment can be added to an accelerator
+    #   listed in a cross-account attachment can be used with an accelerator
     #   by the principals that are listed in the attachment.
     #
     #   To add more than one resource, separate the resource ARNs with
@@ -3321,9 +3394,8 @@ module Aws::GlobalAccelerator
     #
     # @!attribute [rw] remove_resources
     #   The resources to remove from the cross-account attachment. A
-    #   resource listed in a cross-account attachment can be added to an
-    #   accelerator fy principals that are listed in the cross-account
-    #   attachment.
+    #   resource listed in a cross-account attachment can be used with an
+    #   accelerator by the principals that are listed in the attachment.
     #
     #   To remove more than one resource, separate the resource ARNs with
     #   commas.
@@ -3660,6 +3732,13 @@ module Aws::GlobalAccelerator
 
     # @!attribute [rw] cidr
     #   The address range, in CIDR notation.
+    #
+    #   For more information, see [Bring your own IP addresses (BYOIP)][1]
+    #   in the Global Accelerator Developer Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/WithdrawByoipCidrRequest AWS API Documentation
@@ -3671,7 +3750,7 @@ module Aws::GlobalAccelerator
     end
 
     # @!attribute [rw] byoip_cidr
-    #   Information about the address pool.
+    #   Information about the BYOIP address pool.
     #   @return [Types::ByoipCidr]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/WithdrawByoipCidrResponse AWS API Documentation

data/lib/aws-sdk-globalaccelerator.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-globalaccelerator/customizations'
 # @!group service
 module Aws::GlobalAccelerator
 
-  GEM_VERSION = '1.56.0'
+  GEM_VERSION = '1.57.0'
 
 end

data/sig/client.rbs

@@ -159,7 +159,8 @@ module Aws
                                              ?principals: Array[::String],
                                              ?resources: Array[
                                                {
-                                                 endpoint_id: ::String,
+                                                 endpoint_id: ::String?,
+                                                 cidr: ::String?,
                                                  region: ::String?
                                                },
                                              ],
@@ -689,13 +690,15 @@ module Aws
                                              ?remove_principals: Array[::String],
                                              ?add_resources: Array[
                                                {
-                                                 endpoint_id: ::String,
+                                                 endpoint_id: ::String?,
+                                                 cidr: ::String?,
                                                  region: ::String?
                                                },
                                              ],
                                              ?remove_resources: Array[
                                                {
-                                                 endpoint_id: ::String,
+                                                 endpoint_id: ::String?,
+                                                 cidr: ::String?,
                                                  region: ::String?
                                                },
                                              ]

data/sig/types.rbs

@@ -253,6 +253,7 @@ module Aws::GlobalAccelerator
 
     class CrossAccountResource
       attr_accessor endpoint_id: ::String
+      attr_accessor cidr: ::String
       attr_accessor attachment_arn: ::String
       SENSITIVE: []
     end
@@ -786,6 +787,7 @@ module Aws::GlobalAccelerator
 
     class Resource
       attr_accessor endpoint_id: ::String
+      attr_accessor cidr: ::String
       attr_accessor region: ::String
       SENSITIVE: []
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-globalaccelerator
 version: !ruby/object:Gem::Version
-  version: 1.56.0
+  version: 1.57.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-01-26 00:00:00.000000000 Z
+date: 2024-03-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core