aws-sdk-globalaccelerator 1.56.0 → 1.58.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0d01bf15bf32922350c29fdac0ff7f2f23e1b7941ea4688bf30f8f2d6f2115fa
-  data.tar.gz: 16b68db376da3c5d0af3de4a045edb55915d2ff4e4cfc4c9ebff6008e24e7d1a
+  metadata.gz: 923ea37167dffed2bfb63c594ffb9490137ce5c5c40354e1dda5c1ce5592c267
+  data.tar.gz: 1fb4989e4be756fabd776dbf34c20eb90e3a621fd8553f7cbfa6a63c08166a67
 SHA512:
-  metadata.gz: e61424573903669104d67d0aecea5720248355dc7af2a059418060222a52bf150498e421c9b6c10e32b6bfd0423344c6413b99e6afd1e061c537086c6a7eb47d
-  data.tar.gz: 4b5ed1238f71d1c877f3001e07b3fa76d631d2b8322b959a1b9eaac789354c91925292ad7817372339f71d94d4137e07e98af301a42c01cb0e1978bbbdee1a16
+  metadata.gz: 1475091bfab492b490c2412d30ee112a6c010b87e3d7708be02eafd95cf855c01b33ffc2377e01b193c426f52027831c47cd3a1d1314d9ae567ff00e27db7763
+  data.tar.gz: 4aad85d61fff39e856855572d8a5baf3debaa0022fe7cf0404d175e70106ee0ce93903e36493be911d6da077027b26e9ce137156f90079c2bb7982d30719d89c

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.58.0 (2024-04-25)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+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.58.0

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

@@ -22,6 +22,7 @@ require 'aws-sdk-core/plugins/endpoint_pattern.rb'
 require 'aws-sdk-core/plugins/response_paging.rb'
 require 'aws-sdk-core/plugins/stub_responses.rb'
 require 'aws-sdk-core/plugins/idempotency_token.rb'
+require 'aws-sdk-core/plugins/invocation_id.rb'
 require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
 require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
@@ -72,6 +73,7 @@ module Aws::GlobalAccelerator
     add_plugin(Aws::Plugins::ResponsePaging)
     add_plugin(Aws::Plugins::StubResponses)
     add_plugin(Aws::Plugins::IdempotencyToken)
+    add_plugin(Aws::Plugins::InvocationId)
     add_plugin(Aws::Plugins::JsonvalueConverter)
     add_plugin(Aws::Plugins::ClientMetricsPlugin)
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
@@ -196,10 +198,17 @@ module Aws::GlobalAccelerator
     #     When set to 'true' the request body will not be compressed
     #     for supported operations.
     #
-    #   @option options [String] :endpoint
-    #     The client endpoint is normally constructed from the `:region`
-    #     option. You should only configure an `:endpoint` when connecting
-    #     to test or custom endpoints. This should be a valid HTTP(S) URI.
+    #   @option options [String, URI::HTTPS, URI::HTTP] :endpoint
+    #     Normally you should not configure the `:endpoint` option
+    #     directly. This is normally constructed from the `:region`
+    #     option. Configuring `:endpoint` is normally reserved for
+    #     connecting to test or custom endpoints. The endpoint should
+    #     be a URI formatted like:
+    #
+    #         'http://example.com'
+    #         'https://example.com'
+    #         'http://example.com:123'
+    #
     #
     #   @option options [Integer] :endpoint_cache_max_entries (1000)
     #     Used for the maximum size limit of the LRU cache storing endpoints data
@@ -347,50 +356,65 @@ module Aws::GlobalAccelerator
     #   @option options [Aws::GlobalAccelerator::EndpointProvider] :endpoint_provider
     #     The endpoint provider used to resolve endpoints. Any object that responds to `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to `Aws::GlobalAccelerator::EndpointParameters`
     #
-    #   @option options [URI::HTTP,String] :http_proxy A proxy to send
-    #     requests through.  Formatted like 'http://proxy.com:123'.
-    #
-    #   @option options [Float] :http_open_timeout (15) The number of
-    #     seconds to wait when opening a HTTP session before raising a
-    #     `Timeout::Error`.
-    #
-    #   @option options [Float] :http_read_timeout (60) The default
-    #     number of seconds to wait for response data.  This value can
-    #     safely be set per-request on the session.
-    #
-    #   @option options [Float] :http_idle_timeout (5) The number of
-    #     seconds a connection is allowed to sit idle before it is
-    #     considered stale.  Stale connections are closed and removed
-    #     from the pool before making a request.
-    #
-    #   @option options [Float] :http_continue_timeout (1) The number of
-    #     seconds to wait for a 100-continue response before sending the
-    #     request body.  This option has no effect unless the request has
-    #     "Expect" header set to "100-continue".  Defaults to `nil` which
-    #     disables this behaviour.  This value can safely be set per
-    #     request on the session.
-    #
-    #   @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
-    #     in seconds.
-    #
-    #   @option options [Boolean] :http_wire_trace (false) When `true`,
-    #     HTTP debug output will be sent to the `:logger`.
+    #   @option options [Float] :http_continue_timeout (1)
+    #     The number of seconds to wait for a 100-continue response before sending the
+    #     request body.  This option has no effect unless the request has "Expect"
+    #     header set to "100-continue".  Defaults to `nil` which  disables this
+    #     behaviour.  This value can safely be set per request on the session.
+    #
+    #   @option options [Float] :http_idle_timeout (5)
+    #     The number of seconds a connection is allowed to sit idle before it
+    #     is considered stale.  Stale connections are closed and removed from the
+    #     pool before making a request.
+    #
+    #   @option options [Float] :http_open_timeout (15)
+    #     The default number of seconds to wait for response data.
+    #     This value can safely be set per-request on the session.
+    #
+    #   @option options [URI::HTTP,String] :http_proxy
+    #     A proxy to send requests through.  Formatted like 'http://proxy.com:123'.
+    #
+    #   @option options [Float] :http_read_timeout (60)
+    #     The default number of seconds to wait for response data.
+    #     This value can safely be set per-request on the session.
+    #
+    #   @option options [Boolean] :http_wire_trace (false)
+    #     When `true`,  HTTP debug output will be sent to the `:logger`.
+    #
+    #   @option options [Proc] :on_chunk_received
+    #     When a Proc object is provided, it will be used as callback when each chunk
+    #     of the response body is received. It provides three arguments: the chunk,
+    #     the number of bytes received, and the total number of
+    #     bytes in the response (or nil if the server did not send a `content-length`).
+    #
+    #   @option options [Proc] :on_chunk_sent
+    #     When a Proc object is provided, it will be used as callback when each chunk
+    #     of the request body is sent. It provides three arguments: the chunk,
+    #     the number of bytes read from the body, and the total number of
+    #     bytes in the body.
+    #
+    #   @option options [Boolean] :raise_response_errors (true)
+    #     When `true`, response errors are raised.
+    #
+    #   @option options [String] :ssl_ca_bundle
+    #     Full path to the SSL certificate authority bundle file that should be used when
+    #     verifying peer certificates.  If you do not pass `:ssl_ca_bundle` or
+    #     `:ssl_ca_directory` the the system default will be used if available.
+    #
+    #   @option options [String] :ssl_ca_directory
+    #     Full path of the directory that contains the unbundled SSL certificate
+    #     authority files for verifying peer certificates.  If you do
+    #     not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the system
+    #     default will be used if available.
     #
-    #   @option options [Boolean] :ssl_verify_peer (true) When `true`,
-    #     SSL peer certificates are verified when establishing a
-    #     connection.
+    #   @option options [String] :ssl_ca_store
+    #     Sets the X509::Store to verify peer certificate.
     #
-    #   @option options [String] :ssl_ca_bundle Full path to the SSL
-    #     certificate authority bundle file that should be used when
-    #     verifying peer certificates.  If you do not pass
-    #     `:ssl_ca_bundle` or `:ssl_ca_directory` the the system default
-    #     will be used if available.
+    #   @option options [Float] :ssl_timeout
+    #     Sets the SSL timeout in seconds
     #
-    #   @option options [String] :ssl_ca_directory Full path of the
-    #     directory that contains the unbundled SSL certificate
-    #     authority files for verifying peer certificates.  If you do
-    #     not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the
-    #     system default will be used if available.
+    #   @option options [Boolean] :ssl_verify_peer (true)
+    #     When `true`, SSL peer certificates are verified when establishing a connection.
     #
     def initialize(*args)
       super
@@ -552,6 +576,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 +804,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 +856,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 +876,8 @@ module Aws::GlobalAccelerator
     #     principals: ["Principal"],
     #     resources: [
     #       {
-    #         endpoint_id: "GenericString", # required
+    #         endpoint_id: "GenericString",
+    #         cidr: "GenericString",
     #         region: "GenericString",
     #       },
     #     ],
@@ -848,6 +898,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 +1432,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.
+    #
+    # 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 account ID, Global Accelerator reviews every
-    #   accelerator in the account and removes cross-account endpoints from
-    #   all accelerators.
     #
-    # * 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 +1682,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 +1815,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 +2182,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 +2197,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 +2225,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 +2235,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 +2262,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 +2724,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 +3075,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.
+    #
+    # 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 account ID, Global Accelerator reviews every
-    #   accelerator in the account and removes cross-account endpoints from
-    #   all accelerators.
     #
-    # * 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 +3095,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 +3104,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 +3139,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 +3161,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 +3556,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 +3603,7 @@ module Aws::GlobalAccelerator
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-globalaccelerator'
-      context[:gem_version] = '1.56.0'
+      context[:gem_version] = '1.58.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.58.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.58.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-01-26 00:00:00.000000000 Z
+date: 2024-04-25 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.191.0
+        version: 3.193.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.191.0
+        version: 3.193.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement