aws-sdk-globalaccelerator 1.24.0 → 1.29.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 98bc6a701bfa10579b74d7e783c9f3913a21a9840f19c2fde23422acb443be53
4
- data.tar.gz: d95cdb55da920a8e7ef8a781aacdf92b68382c0ba09356b4eb08b08c0e3bb499
3
+ metadata.gz: 5f977dd876fc9292f3d29e0463143fa81de9e8341ab8a216dfc2ddfbd8cad547
4
+ data.tar.gz: 1ee803cf0e80c122ed26f049d2388cc05ad2ed06871a845b908900016107454f
5
5
  SHA512:
6
- metadata.gz: d9358b2379ac0289a92193a53e63658734c6e37cd4bf8c054bd71c9a690f922e9f0e1e4f8bb5bd574f68a1f36c13f611f1fe1522b324d2fc161a16b3d2b4833d
7
- data.tar.gz: dc89393ca26cde38b5c8c8eaf4105c60fd5db0608ec63384ad4613c5cb7e82e041ebb8a3f01ca6f5a1cf0a9b72b1d46072f1fea7743805c18f9f953e72868ecd
6
+ metadata.gz: b6a91d8ee0d00c2403953f92171460e9a3cbf665538bd90d6c3b2fca5584b8c4d6ce97496e745794881206844ad49dade91019977db9c1b99957a1d760271766
7
+ data.tar.gz: 7b5704d77f939a6d0019107bc5712eaf826cc7c0fc8be9bf3bf434d93c7ad8111ed322ae3b685c09c985d369ca6f489eba49a5228a70e476588a285911afd7b8
@@ -28,7 +28,7 @@ require_relative 'aws-sdk-globalaccelerator/customizations'
28
28
  # structure.
29
29
  #
30
30
  # global_accelerator = Aws::GlobalAccelerator::Client.new
31
- # resp = global_accelerator.advertise_byoip_cidr(params)
31
+ # resp = global_accelerator.add_custom_routing_endpoints(params)
32
32
  #
33
33
  # See {Client} for more information.
34
34
  #
@@ -48,6 +48,6 @@ require_relative 'aws-sdk-globalaccelerator/customizations'
48
48
  # @!group service
49
49
  module Aws::GlobalAccelerator
50
50
 
51
- GEM_VERSION = '1.24.0'
51
+ GEM_VERSION = '1.29.0'
52
52
 
53
53
  end
@@ -337,11 +337,70 @@ module Aws::GlobalAccelerator
337
337
 
338
338
  # @!group API Operations
339
339
 
340
+ # Associate a virtual private cloud (VPC) subnet endpoint with your
341
+ # custom routing accelerator.
342
+ #
343
+ # The listener port range must be large enough to support the number of
344
+ # IP addresses that can be specified in your subnet. The number of ports
345
+ # required is: subnet size times the number of ports per destination EC2
346
+ # instances. For example, a subnet defined as /24 requires a listener
347
+ # port range of at least 255 ports.
348
+ #
349
+ # Note: You must have enough remaining listener ports available to map
350
+ # to the subnet ports, or the call will fail with a
351
+ # LimitExceededException.
352
+ #
353
+ # By default, all destinations in a subnet in a custom routing
354
+ # accelerator cannot receive traffic. To enable all destinations to
355
+ # receive traffic, or to specify individual port mappings that can
356
+ # receive traffic, see the [ AllowCustomRoutingTraffic][1] operation.
357
+ #
358
+ #
359
+ #
360
+ # [1]: https://docs.aws.amazon.com/global-accelerator/latest/api/API_AllowCustomRoutingTraffic.html
361
+ #
362
+ # @option params [required, Array<Types::CustomRoutingEndpointConfiguration>] :endpoint_configurations
363
+ # The list of endpoint objects to add to a custom routing accelerator.
364
+ #
365
+ # @option params [required, String] :endpoint_group_arn
366
+ # The Amazon Resource Name (ARN) of the endpoint group for the custom
367
+ # routing endpoint.
368
+ #
369
+ # @return [Types::AddCustomRoutingEndpointsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
370
+ #
371
+ # * {Types::AddCustomRoutingEndpointsResponse#endpoint_descriptions #endpoint_descriptions} => Array&lt;Types::CustomRoutingEndpointDescription&gt;
372
+ # * {Types::AddCustomRoutingEndpointsResponse#endpoint_group_arn #endpoint_group_arn} => String
373
+ #
374
+ # @example Request syntax with placeholder values
375
+ #
376
+ # resp = client.add_custom_routing_endpoints({
377
+ # endpoint_configurations: [ # required
378
+ # {
379
+ # endpoint_id: "GenericString",
380
+ # },
381
+ # ],
382
+ # endpoint_group_arn: "GenericString", # required
383
+ # })
384
+ #
385
+ # @example Response structure
386
+ #
387
+ # resp.endpoint_descriptions #=> Array
388
+ # resp.endpoint_descriptions[0].endpoint_id #=> String
389
+ # resp.endpoint_group_arn #=> String
390
+ #
391
+ # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/AddCustomRoutingEndpoints AWS API Documentation
392
+ #
393
+ # @overload add_custom_routing_endpoints(params = {})
394
+ # @param [Hash] params ({})
395
+ def add_custom_routing_endpoints(params = {}, options = {})
396
+ req = build_request(:add_custom_routing_endpoints, params)
397
+ req.send_request(options)
398
+ end
399
+
340
400
  # Advertises an IPv4 address range that is provisioned for use with your
341
401
  # AWS resources through bring your own IP addresses (BYOIP). It can take
342
402
  # a few minutes before traffic to the specified addresses starts routing
343
- # to AWS because of propagation delays. To see an AWS CLI example of
344
- # advertising an address range, scroll down to **Example**.
403
+ # to AWS because of propagation delays.
345
404
  #
346
405
  # To stop advertising the BYOIP address range, use [
347
406
  # WithdrawByoipCidr][1].
@@ -386,11 +445,80 @@ module Aws::GlobalAccelerator
386
445
  req.send_request(options)
387
446
  end
388
447
 
448
+ # Specify the Amazon EC2 instance (destination) IP addresses and ports
449
+ # for a VPC subnet endpoint that can receive traffic for a custom
450
+ # routing accelerator. You can allow traffic to all destinations in the
451
+ # subnet endpoint, or allow traffic to a specified list of destination
452
+ # IP addresses and ports in the subnet. Note that you cannot specify IP
453
+ # addresses or ports outside of the range that you configured for the
454
+ # endpoint group.
455
+ #
456
+ # After you make changes, you can verify that the updates are complete
457
+ # by checking the status of your accelerator: the status changes from
458
+ # IN\_PROGRESS to DEPLOYED.
459
+ #
460
+ # @option params [required, String] :endpoint_group_arn
461
+ # The Amazon Resource Name (ARN) of the endpoint group.
462
+ #
463
+ # @option params [required, String] :endpoint_id
464
+ # An ID for the endpoint. For custom routing accelerators, this is the
465
+ # virtual private cloud (VPC) subnet ID.
466
+ #
467
+ # @option params [Array<String>] :destination_addresses
468
+ # A list of specific Amazon EC2 instance IP addresses (destination
469
+ # addresses) in a subnet that you want to allow to receive traffic. The
470
+ # IP addresses must be a subset of the IP addresses that you specified
471
+ # for the endpoint group.
472
+ #
473
+ # `DestinationAddresses` is required if `AllowAllTrafficToEndpoint` is
474
+ # `FALSE` or is not specified.
475
+ #
476
+ # @option params [Array<Integer>] :destination_ports
477
+ # A list of specific Amazon EC2 instance ports (destination ports) that
478
+ # you want to allow to receive traffic.
479
+ #
480
+ # @option params [Boolean] :allow_all_traffic_to_endpoint
481
+ # Indicates whether all destination IP addresses and ports for a
482
+ # specified VPC subnet endpoint can receive traffic from a custom
483
+ # routing accelerator. The value is TRUE or FALSE.
484
+ #
485
+ # When set to TRUE, *all* destinations in the custom routing VPC subnet
486
+ # can receive traffic. Note that you cannot specify destination IP
487
+ # addresses and ports when the value is set to TRUE.
488
+ #
489
+ # When set to FALSE (or not specified), you *must* specify a list of
490
+ # destination IP addresses that are allowed to receive traffic. A list
491
+ # of ports is optional. If you don't specify a list of ports, the ports
492
+ # that can accept traffic is the same as the ports configured for the
493
+ # endpoint group.
494
+ #
495
+ # The default value is FALSE.
496
+ #
497
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
498
+ #
499
+ # @example Request syntax with placeholder values
500
+ #
501
+ # resp = client.allow_custom_routing_traffic({
502
+ # endpoint_group_arn: "GenericString", # required
503
+ # endpoint_id: "GenericString", # required
504
+ # destination_addresses: ["IpAddress"],
505
+ # destination_ports: [1],
506
+ # allow_all_traffic_to_endpoint: false,
507
+ # })
508
+ #
509
+ # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/AllowCustomRoutingTraffic AWS API Documentation
510
+ #
511
+ # @overload allow_custom_routing_traffic(params = {})
512
+ # @param [Hash] params ({})
513
+ def allow_custom_routing_traffic(params = {}, options = {})
514
+ req = build_request(:allow_custom_routing_traffic, params)
515
+ req.send_request(options)
516
+ end
517
+
389
518
  # Create an accelerator. An accelerator includes one or more listeners
390
519
  # that process inbound connections and direct traffic to one or more
391
520
  # endpoint groups, each of which includes endpoints, such as Network
392
- # Load Balancers. To see an AWS CLI example of creating an accelerator,
393
- # scroll down to **Example**.
521
+ # Load Balancers.
394
522
  #
395
523
  # Global Accelerator is a global service that supports endpoints in
396
524
  # multiple AWS Regions but you must specify the US West (Oregon) Region
@@ -409,7 +537,7 @@ module Aws::GlobalAccelerator
409
537
  # Accelerator (BYOIP), you can choose IP addresses from your own pool to
410
538
  # use for the accelerator's static IP addresses when you create an
411
539
  # accelerator. You can specify one or two addresses, separated by a
412
- # comma. Do not include the /32 suffix.
540
+ # space. Do not include the /32 suffix.
413
541
  #
414
542
  # Only one IP address from each of your IP address ranges can be used
415
543
  # for each accelerator. If you specify only one IP address from your IP
@@ -495,13 +623,250 @@ module Aws::GlobalAccelerator
495
623
  req.send_request(options)
496
624
  end
497
625
 
626
+ # Create a custom routing accelerator. A custom routing accelerator
627
+ # directs traffic to one of possibly thousands of Amazon EC2 instance
628
+ # destinations running in a single or multiple virtual private clouds
629
+ # (VPC) subnet endpoints.
630
+ #
631
+ # Be aware that, by default, all destination EC2 instances in a VPC
632
+ # subnet endpoint cannot receive traffic. To enable all destinations to
633
+ # receive traffic, or to specify individual port mappings that can
634
+ # receive traffic, see the [ AllowCustomRoutingTraffic][1] operation.
635
+ #
636
+ # Global Accelerator is a global service that supports endpoints in
637
+ # multiple AWS Regions but you must specify the US West (Oregon) Region
638
+ # to create or update accelerators.
639
+ #
640
+ #
641
+ #
642
+ # [1]: https://docs.aws.amazon.com/global-accelerator/latest/api/API_AllowCustomRoutingTraffic.html
643
+ #
644
+ # @option params [required, String] :name
645
+ # The name of a custom routing accelerator. The name can have a maximum
646
+ # of 64 characters, must contain only alphanumeric characters or hyphens
647
+ # (-), and must not begin or end with a hyphen.
648
+ #
649
+ # @option params [String] :ip_address_type
650
+ # The value for the address type must be IPv4.
651
+ #
652
+ # @option params [Array<String>] :ip_addresses
653
+ # Optionally, if you've added your own IP address pool to Global
654
+ # Accelerator (BYOIP), you can choose IP addresses from your own pool to
655
+ # use for the accelerator's static IP addresses when you create an
656
+ # accelerator. You can specify one or two addresses, separated by a
657
+ # space. Do not include the /32 suffix.
658
+ #
659
+ # Only one IP address from each of your IP address ranges can be used
660
+ # for each accelerator. If you specify only one IP address from your IP
661
+ # address range, Global Accelerator assigns a second static IP address
662
+ # for the accelerator from the AWS IP address pool.
663
+ #
664
+ # Note that you can't update IP addresses for an existing accelerator.
665
+ # To change them, you must create a new accelerator with the new
666
+ # addresses.
667
+ #
668
+ # For more information, see [Bring your own IP addresses (BYOIP)][1] in
669
+ # the *AWS Global Accelerator Developer Guide*.
670
+ #
671
+ #
672
+ #
673
+ # [1]: https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html
674
+ #
675
+ # @option params [Boolean] :enabled
676
+ # Indicates whether an accelerator is enabled. The value is true or
677
+ # false. The default value is true.
678
+ #
679
+ # If the value is set to true, an accelerator cannot be deleted. If set
680
+ # to false, the accelerator can be deleted.
681
+ #
682
+ # @option params [required, String] :idempotency_token
683
+ # A unique, case-sensitive identifier that you provide to ensure the
684
+ # idempotency—that is, the uniqueness—of the request.
685
+ #
686
+ # **A suitable default value is auto-generated.** You should normally
687
+ # not need to pass this option.**
688
+ #
689
+ # @option params [Array<Types::Tag>] :tags
690
+ # Create tags for an accelerator.
691
+ #
692
+ # For more information, see [Tagging in AWS Global Accelerator][1] in
693
+ # the *AWS Global Accelerator Developer Guide*.
694
+ #
695
+ #
696
+ #
697
+ # [1]: https://docs.aws.amazon.com/global-accelerator/latest/dg/tagging-in-global-accelerator.html
698
+ #
699
+ # @return [Types::CreateCustomRoutingAcceleratorResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
700
+ #
701
+ # * {Types::CreateCustomRoutingAcceleratorResponse#accelerator #accelerator} => Types::CustomRoutingAccelerator
702
+ #
703
+ # @example Request syntax with placeholder values
704
+ #
705
+ # resp = client.create_custom_routing_accelerator({
706
+ # name: "GenericString", # required
707
+ # ip_address_type: "IPV4", # accepts IPV4
708
+ # ip_addresses: ["IpAddress"],
709
+ # enabled: false,
710
+ # idempotency_token: "IdempotencyToken", # required
711
+ # tags: [
712
+ # {
713
+ # key: "TagKey", # required
714
+ # value: "TagValue", # required
715
+ # },
716
+ # ],
717
+ # })
718
+ #
719
+ # @example Response structure
720
+ #
721
+ # resp.accelerator.accelerator_arn #=> String
722
+ # resp.accelerator.name #=> String
723
+ # resp.accelerator.ip_address_type #=> String, one of "IPV4"
724
+ # resp.accelerator.enabled #=> Boolean
725
+ # resp.accelerator.ip_sets #=> Array
726
+ # resp.accelerator.ip_sets[0].ip_family #=> String
727
+ # resp.accelerator.ip_sets[0].ip_addresses #=> Array
728
+ # resp.accelerator.ip_sets[0].ip_addresses[0] #=> String
729
+ # resp.accelerator.dns_name #=> String
730
+ # resp.accelerator.status #=> String, one of "DEPLOYED", "IN_PROGRESS"
731
+ # resp.accelerator.created_time #=> Time
732
+ # resp.accelerator.last_modified_time #=> Time
733
+ #
734
+ # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/CreateCustomRoutingAccelerator AWS API Documentation
735
+ #
736
+ # @overload create_custom_routing_accelerator(params = {})
737
+ # @param [Hash] params ({})
738
+ def create_custom_routing_accelerator(params = {}, options = {})
739
+ req = build_request(:create_custom_routing_accelerator, params)
740
+ req.send_request(options)
741
+ end
742
+
743
+ # Create an endpoint group for the specified listener for a custom
744
+ # routing accelerator. An endpoint group is a collection of endpoints in
745
+ # one AWS Region.
746
+ #
747
+ # @option params [required, String] :listener_arn
748
+ # The Amazon Resource Name (ARN) of the listener for a custom routing
749
+ # endpoint.
750
+ #
751
+ # @option params [required, String] :endpoint_group_region
752
+ # The AWS Region where the endpoint group is located. A listener can
753
+ # have only one endpoint group in a specific Region.
754
+ #
755
+ # @option params [required, Array<Types::CustomRoutingDestinationConfiguration>] :destination_configurations
756
+ # Sets the port range and protocol for all endpoints (virtual private
757
+ # cloud subnets) in a custom routing endpoint group to accept client
758
+ # traffic on.
759
+ #
760
+ # @option params [required, String] :idempotency_token
761
+ # A unique, case-sensitive identifier that you provide to ensure the
762
+ # idempotency—that is, the uniqueness—of the request.
763
+ #
764
+ # **A suitable default value is auto-generated.** You should normally
765
+ # not need to pass this option.**
766
+ #
767
+ # @return [Types::CreateCustomRoutingEndpointGroupResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
768
+ #
769
+ # * {Types::CreateCustomRoutingEndpointGroupResponse#endpoint_group #endpoint_group} => Types::CustomRoutingEndpointGroup
770
+ #
771
+ # @example Request syntax with placeholder values
772
+ #
773
+ # resp = client.create_custom_routing_endpoint_group({
774
+ # listener_arn: "GenericString", # required
775
+ # endpoint_group_region: "GenericString", # required
776
+ # destination_configurations: [ # required
777
+ # {
778
+ # from_port: 1, # required
779
+ # to_port: 1, # required
780
+ # protocols: ["TCP"], # required, accepts TCP, UDP
781
+ # },
782
+ # ],
783
+ # idempotency_token: "IdempotencyToken", # required
784
+ # })
785
+ #
786
+ # @example Response structure
787
+ #
788
+ # resp.endpoint_group.endpoint_group_arn #=> String
789
+ # resp.endpoint_group.endpoint_group_region #=> String
790
+ # resp.endpoint_group.destination_descriptions #=> Array
791
+ # resp.endpoint_group.destination_descriptions[0].from_port #=> Integer
792
+ # resp.endpoint_group.destination_descriptions[0].to_port #=> Integer
793
+ # resp.endpoint_group.destination_descriptions[0].protocols #=> Array
794
+ # resp.endpoint_group.destination_descriptions[0].protocols[0] #=> String, one of "TCP", "UDP"
795
+ # resp.endpoint_group.endpoint_descriptions #=> Array
796
+ # resp.endpoint_group.endpoint_descriptions[0].endpoint_id #=> String
797
+ #
798
+ # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/CreateCustomRoutingEndpointGroup AWS API Documentation
799
+ #
800
+ # @overload create_custom_routing_endpoint_group(params = {})
801
+ # @param [Hash] params ({})
802
+ def create_custom_routing_endpoint_group(params = {}, options = {})
803
+ req = build_request(:create_custom_routing_endpoint_group, params)
804
+ req.send_request(options)
805
+ end
806
+
807
+ # Create a listener to process inbound connections from clients to a
808
+ # custom routing accelerator. Connections arrive to assigned static IP
809
+ # addresses on the port range that you specify.
810
+ #
811
+ # @option params [required, String] :accelerator_arn
812
+ # The Amazon Resource Name (ARN) of the accelerator for a custom routing
813
+ # listener.
814
+ #
815
+ # @option params [required, Array<Types::PortRange>] :port_ranges
816
+ # The port range to support for connections from clients to your
817
+ # accelerator.
818
+ #
819
+ # Separately, you set port ranges for endpoints. For more information,
820
+ # see [About endpoints for custom routing accelerators][1].
821
+ #
822
+ #
823
+ #
824
+ # [1]: https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-endpoints.html
825
+ #
826
+ # @option params [required, String] :idempotency_token
827
+ # A unique, case-sensitive identifier that you provide to ensure the
828
+ # idempotency—that is, the uniqueness—of the request.
829
+ #
830
+ # **A suitable default value is auto-generated.** You should normally
831
+ # not need to pass this option.**
832
+ #
833
+ # @return [Types::CreateCustomRoutingListenerResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
834
+ #
835
+ # * {Types::CreateCustomRoutingListenerResponse#listener #listener} => Types::CustomRoutingListener
836
+ #
837
+ # @example Request syntax with placeholder values
838
+ #
839
+ # resp = client.create_custom_routing_listener({
840
+ # accelerator_arn: "GenericString", # required
841
+ # port_ranges: [ # required
842
+ # {
843
+ # from_port: 1,
844
+ # to_port: 1,
845
+ # },
846
+ # ],
847
+ # idempotency_token: "IdempotencyToken", # required
848
+ # })
849
+ #
850
+ # @example Response structure
851
+ #
852
+ # resp.listener.listener_arn #=> String
853
+ # resp.listener.port_ranges #=> Array
854
+ # resp.listener.port_ranges[0].from_port #=> Integer
855
+ # resp.listener.port_ranges[0].to_port #=> Integer
856
+ #
857
+ # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/CreateCustomRoutingListener AWS API Documentation
858
+ #
859
+ # @overload create_custom_routing_listener(params = {})
860
+ # @param [Hash] params ({})
861
+ def create_custom_routing_listener(params = {}, options = {})
862
+ req = build_request(:create_custom_routing_listener, params)
863
+ req.send_request(options)
864
+ end
865
+
498
866
  # Create an endpoint group for the specified listener. An endpoint group
499
867
  # is a collection of endpoints in one AWS Region. A resource must be
500
868
  # valid and active when you add it as an endpoint.
501
869
  #
502
- # To see an AWS CLI example of creating an endpoint group, scroll down
503
- # to **Example**.
504
- #
505
870
  # @option params [required, String] :listener_arn
506
871
  # The Amazon Resource Name (ARN) of the listener.
507
872
  #
@@ -588,7 +953,7 @@ module Aws::GlobalAccelerator
588
953
  # traffic_dial_percentage: 1.0,
589
954
  # health_check_port: 1,
590
955
  # health_check_protocol: "TCP", # accepts TCP, HTTP, HTTPS
591
- # health_check_path: "GenericString",
956
+ # health_check_path: "HealthCheckPath",
592
957
  # health_check_interval_seconds: 1,
593
958
  # threshold_count: 1,
594
959
  # idempotency_token: "IdempotencyToken", # required
@@ -631,8 +996,7 @@ module Aws::GlobalAccelerator
631
996
 
632
997
  # Create a listener to process inbound connections from clients to an
633
998
  # accelerator. Connections arrive to assigned static IP addresses on a
634
- # port, port range, or list of port ranges that you specify. To see an
635
- # AWS CLI example of creating a listener, scroll down to **Example**.
999
+ # port, port range, or list of port ranges that you specify.
636
1000
  #
637
1001
  # @option params [required, String] :accelerator_arn
638
1002
  # The Amazon Resource Name (ARN) of your accelerator.
@@ -758,17 +1122,106 @@ module Aws::GlobalAccelerator
758
1122
  req.send_request(options)
759
1123
  end
760
1124
 
761
- # Delete an endpoint group from a listener.
1125
+ # Delete a custom routing accelerator. Before you can delete an
1126
+ # accelerator, you must disable it and remove all dependent resources
1127
+ # (listeners and endpoint groups). To disable the accelerator, update
1128
+ # the accelerator to set `Enabled` to false.
1129
+ #
1130
+ # When you create a custom routing accelerator, by default, Global
1131
+ # Accelerator provides you with a set of two static IP addresses.
1132
+ #
1133
+ # The IP addresses are assigned to your accelerator for as long as it
1134
+ # exists, even if you disable the accelerator and it no longer accepts
1135
+ # or routes traffic. However, when you *delete* an accelerator, you lose
1136
+ # the static IP addresses that are assigned to the accelerator, so you
1137
+ # can no longer route traffic by using them. As a best practice, ensure
1138
+ # that you have permissions in place to avoid inadvertently deleting
1139
+ # accelerators. You can use IAM policies with Global Accelerator to
1140
+ # limit the users who have permissions to delete an accelerator. For
1141
+ # more information, see [Authentication and Access Control][1] in the
1142
+ # *AWS Global Accelerator Developer Guide*.
762
1143
  #
763
- # @option params [required, String] :endpoint_group_arn
764
- # The Amazon Resource Name (ARN) of the endpoint group to delete.
1144
+ #
1145
+ #
1146
+ # [1]: https://docs.aws.amazon.com/global-accelerator/latest/dg/auth-and-access-control.html
1147
+ #
1148
+ # @option params [required, String] :accelerator_arn
1149
+ # The Amazon Resource Name (ARN) of the custom routing accelerator to
1150
+ # delete.
765
1151
  #
766
1152
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
767
1153
  #
768
1154
  # @example Request syntax with placeholder values
769
1155
  #
770
- # resp = client.delete_endpoint_group({
771
- # endpoint_group_arn: "GenericString", # required
1156
+ # resp = client.delete_custom_routing_accelerator({
1157
+ # accelerator_arn: "GenericString", # required
1158
+ # })
1159
+ #
1160
+ # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/DeleteCustomRoutingAccelerator AWS API Documentation
1161
+ #
1162
+ # @overload delete_custom_routing_accelerator(params = {})
1163
+ # @param [Hash] params ({})
1164
+ def delete_custom_routing_accelerator(params = {}, options = {})
1165
+ req = build_request(:delete_custom_routing_accelerator, params)
1166
+ req.send_request(options)
1167
+ end
1168
+
1169
+ # Delete an endpoint group from a listener for a custom routing
1170
+ # accelerator.
1171
+ #
1172
+ # @option params [required, String] :endpoint_group_arn
1173
+ # The Amazon Resource Name (ARN) of the endpoint group to delete.
1174
+ #
1175
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1176
+ #
1177
+ # @example Request syntax with placeholder values
1178
+ #
1179
+ # resp = client.delete_custom_routing_endpoint_group({
1180
+ # endpoint_group_arn: "GenericString", # required
1181
+ # })
1182
+ #
1183
+ # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/DeleteCustomRoutingEndpointGroup AWS API Documentation
1184
+ #
1185
+ # @overload delete_custom_routing_endpoint_group(params = {})
1186
+ # @param [Hash] params ({})
1187
+ def delete_custom_routing_endpoint_group(params = {}, options = {})
1188
+ req = build_request(:delete_custom_routing_endpoint_group, params)
1189
+ req.send_request(options)
1190
+ end
1191
+
1192
+ # Delete a listener for a custom routing accelerator.
1193
+ #
1194
+ # @option params [required, String] :listener_arn
1195
+ # The Amazon Resource Name (ARN) of the listener to delete.
1196
+ #
1197
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1198
+ #
1199
+ # @example Request syntax with placeholder values
1200
+ #
1201
+ # resp = client.delete_custom_routing_listener({
1202
+ # listener_arn: "GenericString", # required
1203
+ # })
1204
+ #
1205
+ # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/DeleteCustomRoutingListener AWS API Documentation
1206
+ #
1207
+ # @overload delete_custom_routing_listener(params = {})
1208
+ # @param [Hash] params ({})
1209
+ def delete_custom_routing_listener(params = {}, options = {})
1210
+ req = build_request(:delete_custom_routing_listener, params)
1211
+ req.send_request(options)
1212
+ end
1213
+
1214
+ # Delete an endpoint group from a listener.
1215
+ #
1216
+ # @option params [required, String] :endpoint_group_arn
1217
+ # The Amazon Resource Name (ARN) of the endpoint group to delete.
1218
+ #
1219
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1220
+ #
1221
+ # @example Request syntax with placeholder values
1222
+ #
1223
+ # resp = client.delete_endpoint_group({
1224
+ # endpoint_group_arn: "GenericString", # required
772
1225
  # })
773
1226
  #
774
1227
  # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/DeleteEndpointGroup AWS API Documentation
@@ -802,10 +1255,75 @@ module Aws::GlobalAccelerator
802
1255
  req.send_request(options)
803
1256
  end
804
1257
 
1258
+ # Specify the Amazon EC2 instance (destination) IP addresses and ports
1259
+ # for a VPC subnet endpoint that cannot receive traffic for a custom
1260
+ # routing accelerator. You can deny traffic to all destinations in the
1261
+ # VPC endpoint, or deny traffic to a specified list of destination IP
1262
+ # addresses and ports. Note that you cannot specify IP addresses or
1263
+ # ports outside of the range that you configured for the endpoint group.
1264
+ #
1265
+ # After you make changes, you can verify that the updates are complete
1266
+ # by checking the status of your accelerator: the status changes from
1267
+ # IN\_PROGRESS to DEPLOYED.
1268
+ #
1269
+ # @option params [required, String] :endpoint_group_arn
1270
+ # The Amazon Resource Name (ARN) of the endpoint group.
1271
+ #
1272
+ # @option params [required, String] :endpoint_id
1273
+ # An ID for the endpoint. For custom routing accelerators, this is the
1274
+ # virtual private cloud (VPC) subnet ID.
1275
+ #
1276
+ # @option params [Array<String>] :destination_addresses
1277
+ # A list of specific Amazon EC2 instance IP addresses (destination
1278
+ # addresses) in a subnet that you want to prevent from receiving
1279
+ # traffic. The IP addresses must be a subset of the IP addresses allowed
1280
+ # for the VPC subnet associated with the endpoint group.
1281
+ #
1282
+ # @option params [Array<Integer>] :destination_ports
1283
+ # A list of specific Amazon EC2 instance ports (destination ports) in a
1284
+ # subnet endpoint that you want to prevent from receiving traffic.
1285
+ #
1286
+ # @option params [Boolean] :deny_all_traffic_to_endpoint
1287
+ # Indicates whether all destination IP addresses and ports for a
1288
+ # specified VPC subnet endpoint *cannot* receive traffic from a custom
1289
+ # routing accelerator. The value is TRUE or FALSE.
1290
+ #
1291
+ # When set to TRUE, *no* destinations in the custom routing VPC subnet
1292
+ # can receive traffic. Note that you cannot specify destination IP
1293
+ # addresses and ports when the value is set to TRUE.
1294
+ #
1295
+ # When set to FALSE (or not specified), you *must* specify a list of
1296
+ # destination IP addresses that cannot receive traffic. A list of ports
1297
+ # is optional. If you don't specify a list of ports, the ports that can
1298
+ # accept traffic is the same as the ports configured for the endpoint
1299
+ # group.
1300
+ #
1301
+ # The default value is FALSE.
1302
+ #
1303
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1304
+ #
1305
+ # @example Request syntax with placeholder values
1306
+ #
1307
+ # resp = client.deny_custom_routing_traffic({
1308
+ # endpoint_group_arn: "GenericString", # required
1309
+ # endpoint_id: "GenericString", # required
1310
+ # destination_addresses: ["IpAddress"],
1311
+ # destination_ports: [1],
1312
+ # deny_all_traffic_to_endpoint: false,
1313
+ # })
1314
+ #
1315
+ # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/DenyCustomRoutingTraffic AWS API Documentation
1316
+ #
1317
+ # @overload deny_custom_routing_traffic(params = {})
1318
+ # @param [Hash] params ({})
1319
+ def deny_custom_routing_traffic(params = {}, options = {})
1320
+ req = build_request(:deny_custom_routing_traffic, params)
1321
+ req.send_request(options)
1322
+ end
1323
+
805
1324
  # Releases the specified address range that you provisioned to use with
806
1325
  # your AWS resources through bring your own IP addresses (BYOIP) and
807
- # deletes the corresponding address pool. To see an AWS CLI example of
808
- # deprovisioning an address range, scroll down to **Example**.
1326
+ # deletes the corresponding address pool.
809
1327
  #
810
1328
  # Before you can release an address range, you must stop advertising it
811
1329
  # by using [WithdrawByoipCidr][1] and you must not have any accelerators
@@ -850,8 +1368,7 @@ module Aws::GlobalAccelerator
850
1368
  req.send_request(options)
851
1369
  end
852
1370
 
853
- # Describe an accelerator. To see an AWS CLI example of describing an
854
- # accelerator, scroll down to **Example**.
1371
+ # Describe an accelerator.
855
1372
  #
856
1373
  # @option params [required, String] :accelerator_arn
857
1374
  # The Amazon Resource Name (ARN) of the accelerator to describe.
@@ -890,9 +1407,7 @@ module Aws::GlobalAccelerator
890
1407
  req.send_request(options)
891
1408
  end
892
1409
 
893
- # Describe the attributes of an accelerator. To see an AWS CLI example
894
- # of describing the attributes of an accelerator, scroll down to
895
- # **Example**.
1410
+ # Describe the attributes of an accelerator.
896
1411
  #
897
1412
  # @option params [required, String] :accelerator_arn
898
1413
  # The Amazon Resource Name (ARN) of the accelerator with the attributes
@@ -923,8 +1438,144 @@ module Aws::GlobalAccelerator
923
1438
  req.send_request(options)
924
1439
  end
925
1440
 
926
- # Describe an endpoint group. To see an AWS CLI example of describing an
927
- # endpoint group, scroll down to **Example**.
1441
+ # Describe a custom routing accelerator.
1442
+ #
1443
+ # @option params [required, String] :accelerator_arn
1444
+ # The Amazon Resource Name (ARN) of the accelerator to describe.
1445
+ #
1446
+ # @return [Types::DescribeCustomRoutingAcceleratorResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1447
+ #
1448
+ # * {Types::DescribeCustomRoutingAcceleratorResponse#accelerator #accelerator} => Types::CustomRoutingAccelerator
1449
+ #
1450
+ # @example Request syntax with placeholder values
1451
+ #
1452
+ # resp = client.describe_custom_routing_accelerator({
1453
+ # accelerator_arn: "GenericString", # required
1454
+ # })
1455
+ #
1456
+ # @example Response structure
1457
+ #
1458
+ # resp.accelerator.accelerator_arn #=> String
1459
+ # resp.accelerator.name #=> String
1460
+ # resp.accelerator.ip_address_type #=> String, one of "IPV4"
1461
+ # resp.accelerator.enabled #=> Boolean
1462
+ # resp.accelerator.ip_sets #=> Array
1463
+ # resp.accelerator.ip_sets[0].ip_family #=> String
1464
+ # resp.accelerator.ip_sets[0].ip_addresses #=> Array
1465
+ # resp.accelerator.ip_sets[0].ip_addresses[0] #=> String
1466
+ # resp.accelerator.dns_name #=> String
1467
+ # resp.accelerator.status #=> String, one of "DEPLOYED", "IN_PROGRESS"
1468
+ # resp.accelerator.created_time #=> Time
1469
+ # resp.accelerator.last_modified_time #=> Time
1470
+ #
1471
+ # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/DescribeCustomRoutingAccelerator AWS API Documentation
1472
+ #
1473
+ # @overload describe_custom_routing_accelerator(params = {})
1474
+ # @param [Hash] params ({})
1475
+ def describe_custom_routing_accelerator(params = {}, options = {})
1476
+ req = build_request(:describe_custom_routing_accelerator, params)
1477
+ req.send_request(options)
1478
+ end
1479
+
1480
+ # Describe the attributes of a custom routing accelerator.
1481
+ #
1482
+ # @option params [required, String] :accelerator_arn
1483
+ # The Amazon Resource Name (ARN) of the custom routing accelerator to
1484
+ # describe the attributes for.
1485
+ #
1486
+ # @return [Types::DescribeCustomRoutingAcceleratorAttributesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1487
+ #
1488
+ # * {Types::DescribeCustomRoutingAcceleratorAttributesResponse#accelerator_attributes #accelerator_attributes} => Types::CustomRoutingAcceleratorAttributes
1489
+ #
1490
+ # @example Request syntax with placeholder values
1491
+ #
1492
+ # resp = client.describe_custom_routing_accelerator_attributes({
1493
+ # accelerator_arn: "GenericString", # required
1494
+ # })
1495
+ #
1496
+ # @example Response structure
1497
+ #
1498
+ # resp.accelerator_attributes.flow_logs_enabled #=> Boolean
1499
+ # resp.accelerator_attributes.flow_logs_s3_bucket #=> String
1500
+ # resp.accelerator_attributes.flow_logs_s3_prefix #=> String
1501
+ #
1502
+ # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/DescribeCustomRoutingAcceleratorAttributes AWS API Documentation
1503
+ #
1504
+ # @overload describe_custom_routing_accelerator_attributes(params = {})
1505
+ # @param [Hash] params ({})
1506
+ def describe_custom_routing_accelerator_attributes(params = {}, options = {})
1507
+ req = build_request(:describe_custom_routing_accelerator_attributes, params)
1508
+ req.send_request(options)
1509
+ end
1510
+
1511
+ # Describe an endpoint group for a custom routing accelerator.
1512
+ #
1513
+ # @option params [required, String] :endpoint_group_arn
1514
+ # The Amazon Resource Name (ARN) of the endpoint group to describe.
1515
+ #
1516
+ # @return [Types::DescribeCustomRoutingEndpointGroupResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1517
+ #
1518
+ # * {Types::DescribeCustomRoutingEndpointGroupResponse#endpoint_group #endpoint_group} => Types::CustomRoutingEndpointGroup
1519
+ #
1520
+ # @example Request syntax with placeholder values
1521
+ #
1522
+ # resp = client.describe_custom_routing_endpoint_group({
1523
+ # endpoint_group_arn: "GenericString", # required
1524
+ # })
1525
+ #
1526
+ # @example Response structure
1527
+ #
1528
+ # resp.endpoint_group.endpoint_group_arn #=> String
1529
+ # resp.endpoint_group.endpoint_group_region #=> String
1530
+ # resp.endpoint_group.destination_descriptions #=> Array
1531
+ # resp.endpoint_group.destination_descriptions[0].from_port #=> Integer
1532
+ # resp.endpoint_group.destination_descriptions[0].to_port #=> Integer
1533
+ # resp.endpoint_group.destination_descriptions[0].protocols #=> Array
1534
+ # resp.endpoint_group.destination_descriptions[0].protocols[0] #=> String, one of "TCP", "UDP"
1535
+ # resp.endpoint_group.endpoint_descriptions #=> Array
1536
+ # resp.endpoint_group.endpoint_descriptions[0].endpoint_id #=> String
1537
+ #
1538
+ # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/DescribeCustomRoutingEndpointGroup AWS API Documentation
1539
+ #
1540
+ # @overload describe_custom_routing_endpoint_group(params = {})
1541
+ # @param [Hash] params ({})
1542
+ def describe_custom_routing_endpoint_group(params = {}, options = {})
1543
+ req = build_request(:describe_custom_routing_endpoint_group, params)
1544
+ req.send_request(options)
1545
+ end
1546
+
1547
+ # The description of a listener for a custom routing accelerator.
1548
+ #
1549
+ # @option params [required, String] :listener_arn
1550
+ # The Amazon Resource Name (ARN) of the listener to describe.
1551
+ #
1552
+ # @return [Types::DescribeCustomRoutingListenerResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1553
+ #
1554
+ # * {Types::DescribeCustomRoutingListenerResponse#listener #listener} => Types::CustomRoutingListener
1555
+ #
1556
+ # @example Request syntax with placeholder values
1557
+ #
1558
+ # resp = client.describe_custom_routing_listener({
1559
+ # listener_arn: "GenericString", # required
1560
+ # })
1561
+ #
1562
+ # @example Response structure
1563
+ #
1564
+ # resp.listener.listener_arn #=> String
1565
+ # resp.listener.port_ranges #=> Array
1566
+ # resp.listener.port_ranges[0].from_port #=> Integer
1567
+ # resp.listener.port_ranges[0].to_port #=> Integer
1568
+ #
1569
+ # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/DescribeCustomRoutingListener AWS API Documentation
1570
+ #
1571
+ # @overload describe_custom_routing_listener(params = {})
1572
+ # @param [Hash] params ({})
1573
+ def describe_custom_routing_listener(params = {}, options = {})
1574
+ req = build_request(:describe_custom_routing_listener, params)
1575
+ req.send_request(options)
1576
+ end
1577
+
1578
+ # Describe an endpoint group.
928
1579
  #
929
1580
  # @option params [required, String] :endpoint_group_arn
930
1581
  # The Amazon Resource Name (ARN) of the endpoint group to describe.
@@ -959,152 +1610,433 @@ module Aws::GlobalAccelerator
959
1610
  # resp.endpoint_group.port_overrides[0].listener_port #=> Integer
960
1611
  # resp.endpoint_group.port_overrides[0].endpoint_port #=> Integer
961
1612
  #
962
- # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/DescribeEndpointGroup AWS API Documentation
1613
+ # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/DescribeEndpointGroup AWS API Documentation
1614
+ #
1615
+ # @overload describe_endpoint_group(params = {})
1616
+ # @param [Hash] params ({})
1617
+ def describe_endpoint_group(params = {}, options = {})
1618
+ req = build_request(:describe_endpoint_group, params)
1619
+ req.send_request(options)
1620
+ end
1621
+
1622
+ # Describe a listener.
1623
+ #
1624
+ # @option params [required, String] :listener_arn
1625
+ # The Amazon Resource Name (ARN) of the listener to describe.
1626
+ #
1627
+ # @return [Types::DescribeListenerResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1628
+ #
1629
+ # * {Types::DescribeListenerResponse#listener #listener} => Types::Listener
1630
+ #
1631
+ # @example Request syntax with placeholder values
1632
+ #
1633
+ # resp = client.describe_listener({
1634
+ # listener_arn: "GenericString", # required
1635
+ # })
1636
+ #
1637
+ # @example Response structure
1638
+ #
1639
+ # resp.listener.listener_arn #=> String
1640
+ # resp.listener.port_ranges #=> Array
1641
+ # resp.listener.port_ranges[0].from_port #=> Integer
1642
+ # resp.listener.port_ranges[0].to_port #=> Integer
1643
+ # resp.listener.protocol #=> String, one of "TCP", "UDP"
1644
+ # resp.listener.client_affinity #=> String, one of "NONE", "SOURCE_IP"
1645
+ #
1646
+ # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/DescribeListener AWS API Documentation
1647
+ #
1648
+ # @overload describe_listener(params = {})
1649
+ # @param [Hash] params ({})
1650
+ def describe_listener(params = {}, options = {})
1651
+ req = build_request(:describe_listener, params)
1652
+ req.send_request(options)
1653
+ end
1654
+
1655
+ # List the accelerators for an AWS account.
1656
+ #
1657
+ # @option params [Integer] :max_results
1658
+ # The number of Global Accelerator objects that you want to return with
1659
+ # this call. The default value is 10.
1660
+ #
1661
+ # @option params [String] :next_token
1662
+ # The token for the next set of results. You receive this token from a
1663
+ # previous call.
1664
+ #
1665
+ # @return [Types::ListAcceleratorsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1666
+ #
1667
+ # * {Types::ListAcceleratorsResponse#accelerators #accelerators} => Array&lt;Types::Accelerator&gt;
1668
+ # * {Types::ListAcceleratorsResponse#next_token #next_token} => String
1669
+ #
1670
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1671
+ #
1672
+ # @example Request syntax with placeholder values
1673
+ #
1674
+ # resp = client.list_accelerators({
1675
+ # max_results: 1,
1676
+ # next_token: "GenericString",
1677
+ # })
1678
+ #
1679
+ # @example Response structure
1680
+ #
1681
+ # resp.accelerators #=> Array
1682
+ # resp.accelerators[0].accelerator_arn #=> String
1683
+ # resp.accelerators[0].name #=> String
1684
+ # resp.accelerators[0].ip_address_type #=> String, one of "IPV4"
1685
+ # resp.accelerators[0].enabled #=> Boolean
1686
+ # resp.accelerators[0].ip_sets #=> Array
1687
+ # resp.accelerators[0].ip_sets[0].ip_family #=> String
1688
+ # resp.accelerators[0].ip_sets[0].ip_addresses #=> Array
1689
+ # resp.accelerators[0].ip_sets[0].ip_addresses[0] #=> String
1690
+ # resp.accelerators[0].dns_name #=> String
1691
+ # resp.accelerators[0].status #=> String, one of "DEPLOYED", "IN_PROGRESS"
1692
+ # resp.accelerators[0].created_time #=> Time
1693
+ # resp.accelerators[0].last_modified_time #=> Time
1694
+ # resp.next_token #=> String
1695
+ #
1696
+ # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/ListAccelerators AWS API Documentation
1697
+ #
1698
+ # @overload list_accelerators(params = {})
1699
+ # @param [Hash] params ({})
1700
+ def list_accelerators(params = {}, options = {})
1701
+ req = build_request(:list_accelerators, params)
1702
+ req.send_request(options)
1703
+ end
1704
+
1705
+ # Lists the IP address ranges that were specified in calls to
1706
+ # [ProvisionByoipCidr][1], including the current state and a history of
1707
+ # state changes.
1708
+ #
1709
+ #
1710
+ #
1711
+ # [1]: https://docs.aws.amazon.com/global-accelerator/latest/api/ProvisionByoipCidr.html
1712
+ #
1713
+ # @option params [Integer] :max_results
1714
+ # The maximum number of results to return with a single call. To
1715
+ # retrieve the remaining results, make another call with the returned
1716
+ # `nextToken` value.
1717
+ #
1718
+ # @option params [String] :next_token
1719
+ # The token for the next page of results.
1720
+ #
1721
+ # @return [Types::ListByoipCidrsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1722
+ #
1723
+ # * {Types::ListByoipCidrsResponse#byoip_cidrs #byoip_cidrs} => Array&lt;Types::ByoipCidr&gt;
1724
+ # * {Types::ListByoipCidrsResponse#next_token #next_token} => String
1725
+ #
1726
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1727
+ #
1728
+ # @example Request syntax with placeholder values
1729
+ #
1730
+ # resp = client.list_byoip_cidrs({
1731
+ # max_results: 1,
1732
+ # next_token: "GenericString",
1733
+ # })
1734
+ #
1735
+ # @example Response structure
1736
+ #
1737
+ # resp.byoip_cidrs #=> Array
1738
+ # resp.byoip_cidrs[0].cidr #=> String
1739
+ # resp.byoip_cidrs[0].state #=> String, one of "PENDING_PROVISIONING", "READY", "PENDING_ADVERTISING", "ADVERTISING", "PENDING_WITHDRAWING", "PENDING_DEPROVISIONING", "DEPROVISIONED", "FAILED_PROVISION", "FAILED_ADVERTISING", "FAILED_WITHDRAW", "FAILED_DEPROVISION"
1740
+ # resp.byoip_cidrs[0].events #=> Array
1741
+ # resp.byoip_cidrs[0].events[0].message #=> String
1742
+ # resp.byoip_cidrs[0].events[0].timestamp #=> Time
1743
+ # resp.next_token #=> String
1744
+ #
1745
+ # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/ListByoipCidrs AWS API Documentation
1746
+ #
1747
+ # @overload list_byoip_cidrs(params = {})
1748
+ # @param [Hash] params ({})
1749
+ def list_byoip_cidrs(params = {}, options = {})
1750
+ req = build_request(:list_byoip_cidrs, params)
1751
+ req.send_request(options)
1752
+ end
1753
+
1754
+ # List the custom routing accelerators for an AWS account.
1755
+ #
1756
+ # @option params [Integer] :max_results
1757
+ # The number of custom routing Global Accelerator objects that you want
1758
+ # to return with this call. The default value is 10.
1759
+ #
1760
+ # @option params [String] :next_token
1761
+ # The token for the next set of results. You receive this token from a
1762
+ # previous call.
1763
+ #
1764
+ # @return [Types::ListCustomRoutingAcceleratorsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1765
+ #
1766
+ # * {Types::ListCustomRoutingAcceleratorsResponse#accelerators #accelerators} => Array&lt;Types::CustomRoutingAccelerator&gt;
1767
+ # * {Types::ListCustomRoutingAcceleratorsResponse#next_token #next_token} => String
1768
+ #
1769
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1770
+ #
1771
+ # @example Request syntax with placeholder values
1772
+ #
1773
+ # resp = client.list_custom_routing_accelerators({
1774
+ # max_results: 1,
1775
+ # next_token: "GenericString",
1776
+ # })
1777
+ #
1778
+ # @example Response structure
1779
+ #
1780
+ # resp.accelerators #=> Array
1781
+ # resp.accelerators[0].accelerator_arn #=> String
1782
+ # resp.accelerators[0].name #=> String
1783
+ # resp.accelerators[0].ip_address_type #=> String, one of "IPV4"
1784
+ # resp.accelerators[0].enabled #=> Boolean
1785
+ # resp.accelerators[0].ip_sets #=> Array
1786
+ # resp.accelerators[0].ip_sets[0].ip_family #=> String
1787
+ # resp.accelerators[0].ip_sets[0].ip_addresses #=> Array
1788
+ # resp.accelerators[0].ip_sets[0].ip_addresses[0] #=> String
1789
+ # resp.accelerators[0].dns_name #=> String
1790
+ # resp.accelerators[0].status #=> String, one of "DEPLOYED", "IN_PROGRESS"
1791
+ # resp.accelerators[0].created_time #=> Time
1792
+ # resp.accelerators[0].last_modified_time #=> Time
1793
+ # resp.next_token #=> String
1794
+ #
1795
+ # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/ListCustomRoutingAccelerators AWS API Documentation
1796
+ #
1797
+ # @overload list_custom_routing_accelerators(params = {})
1798
+ # @param [Hash] params ({})
1799
+ def list_custom_routing_accelerators(params = {}, options = {})
1800
+ req = build_request(:list_custom_routing_accelerators, params)
1801
+ req.send_request(options)
1802
+ end
1803
+
1804
+ # List the endpoint groups that are associated with a listener for a
1805
+ # custom routing accelerator.
1806
+ #
1807
+ # @option params [required, String] :listener_arn
1808
+ # The Amazon Resource Name (ARN) of the listener to list endpoint groups
1809
+ # for.
1810
+ #
1811
+ # @option params [Integer] :max_results
1812
+ # The number of endpoint group objects that you want to return with this
1813
+ # call. The default value is 10.
1814
+ #
1815
+ # @option params [String] :next_token
1816
+ # The token for the next set of results. You receive this token from a
1817
+ # previous call.
1818
+ #
1819
+ # @return [Types::ListCustomRoutingEndpointGroupsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1820
+ #
1821
+ # * {Types::ListCustomRoutingEndpointGroupsResponse#endpoint_groups #endpoint_groups} => Array&lt;Types::CustomRoutingEndpointGroup&gt;
1822
+ # * {Types::ListCustomRoutingEndpointGroupsResponse#next_token #next_token} => String
1823
+ #
1824
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1825
+ #
1826
+ # @example Request syntax with placeholder values
1827
+ #
1828
+ # resp = client.list_custom_routing_endpoint_groups({
1829
+ # listener_arn: "GenericString", # required
1830
+ # max_results: 1,
1831
+ # next_token: "GenericString",
1832
+ # })
1833
+ #
1834
+ # @example Response structure
1835
+ #
1836
+ # resp.endpoint_groups #=> Array
1837
+ # resp.endpoint_groups[0].endpoint_group_arn #=> String
1838
+ # resp.endpoint_groups[0].endpoint_group_region #=> String
1839
+ # resp.endpoint_groups[0].destination_descriptions #=> Array
1840
+ # resp.endpoint_groups[0].destination_descriptions[0].from_port #=> Integer
1841
+ # resp.endpoint_groups[0].destination_descriptions[0].to_port #=> Integer
1842
+ # resp.endpoint_groups[0].destination_descriptions[0].protocols #=> Array
1843
+ # resp.endpoint_groups[0].destination_descriptions[0].protocols[0] #=> String, one of "TCP", "UDP"
1844
+ # resp.endpoint_groups[0].endpoint_descriptions #=> Array
1845
+ # resp.endpoint_groups[0].endpoint_descriptions[0].endpoint_id #=> String
1846
+ # resp.next_token #=> String
1847
+ #
1848
+ # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/ListCustomRoutingEndpointGroups AWS API Documentation
963
1849
  #
964
- # @overload describe_endpoint_group(params = {})
1850
+ # @overload list_custom_routing_endpoint_groups(params = {})
965
1851
  # @param [Hash] params ({})
966
- def describe_endpoint_group(params = {}, options = {})
967
- req = build_request(:describe_endpoint_group, params)
1852
+ def list_custom_routing_endpoint_groups(params = {}, options = {})
1853
+ req = build_request(:list_custom_routing_endpoint_groups, params)
968
1854
  req.send_request(options)
969
1855
  end
970
1856
 
971
- # Describe a listener. To see an AWS CLI example of describing a
972
- # listener, scroll down to **Example**.
1857
+ # List the listeners for a custom routing accelerator.
973
1858
  #
974
- # @option params [required, String] :listener_arn
975
- # The Amazon Resource Name (ARN) of the listener to describe.
1859
+ # @option params [required, String] :accelerator_arn
1860
+ # The Amazon Resource Name (ARN) of the accelerator to list listeners
1861
+ # for.
976
1862
  #
977
- # @return [Types::DescribeListenerResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1863
+ # @option params [Integer] :max_results
1864
+ # The number of listener objects that you want to return with this call.
1865
+ # The default value is 10.
978
1866
  #
979
- # * {Types::DescribeListenerResponse#listener #listener} => Types::Listener
1867
+ # @option params [String] :next_token
1868
+ # The token for the next set of results. You receive this token from a
1869
+ # previous call.
1870
+ #
1871
+ # @return [Types::ListCustomRoutingListenersResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1872
+ #
1873
+ # * {Types::ListCustomRoutingListenersResponse#listeners #listeners} => Array&lt;Types::CustomRoutingListener&gt;
1874
+ # * {Types::ListCustomRoutingListenersResponse#next_token #next_token} => String
1875
+ #
1876
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
980
1877
  #
981
1878
  # @example Request syntax with placeholder values
982
1879
  #
983
- # resp = client.describe_listener({
984
- # listener_arn: "GenericString", # required
1880
+ # resp = client.list_custom_routing_listeners({
1881
+ # accelerator_arn: "GenericString", # required
1882
+ # max_results: 1,
1883
+ # next_token: "GenericString",
985
1884
  # })
986
1885
  #
987
1886
  # @example Response structure
988
1887
  #
989
- # resp.listener.listener_arn #=> String
990
- # resp.listener.port_ranges #=> Array
991
- # resp.listener.port_ranges[0].from_port #=> Integer
992
- # resp.listener.port_ranges[0].to_port #=> Integer
993
- # resp.listener.protocol #=> String, one of "TCP", "UDP"
994
- # resp.listener.client_affinity #=> String, one of "NONE", "SOURCE_IP"
1888
+ # resp.listeners #=> Array
1889
+ # resp.listeners[0].listener_arn #=> String
1890
+ # resp.listeners[0].port_ranges #=> Array
1891
+ # resp.listeners[0].port_ranges[0].from_port #=> Integer
1892
+ # resp.listeners[0].port_ranges[0].to_port #=> Integer
1893
+ # resp.next_token #=> String
995
1894
  #
996
- # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/DescribeListener AWS API Documentation
1895
+ # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/ListCustomRoutingListeners AWS API Documentation
997
1896
  #
998
- # @overload describe_listener(params = {})
1897
+ # @overload list_custom_routing_listeners(params = {})
999
1898
  # @param [Hash] params ({})
1000
- def describe_listener(params = {}, options = {})
1001
- req = build_request(:describe_listener, params)
1899
+ def list_custom_routing_listeners(params = {}, options = {})
1900
+ req = build_request(:list_custom_routing_listeners, params)
1002
1901
  req.send_request(options)
1003
1902
  end
1004
1903
 
1005
- # List the accelerators for an AWS account. To see an AWS CLI example of
1006
- # listing the accelerators for an AWS account, scroll down to
1007
- # **Example**.
1904
+ # Provides a complete mapping from the public accelerator IP address and
1905
+ # port to destination EC2 instance IP addresses and ports in the virtual
1906
+ # public cloud (VPC) subnet endpoint for a custom routing accelerator.
1907
+ # For each subnet endpoint that you add, Global Accelerator creates a
1908
+ # new static port mapping for the accelerator. The port mappings don't
1909
+ # change after Global Accelerator generates them, so you can retrieve
1910
+ # and cache the full mapping on your servers.
1911
+ #
1912
+ # If you remove a subnet from your accelerator, Global Accelerator
1913
+ # removes (reclaims) the port mappings. If you add a subnet to your
1914
+ # accelerator, Global Accelerator creates new port mappings (the
1915
+ # existing ones don't change). If you add or remove EC2 instances in
1916
+ # your subnet, the port mappings don't change, because the mappings are
1917
+ # created when you add the subnet to Global Accelerator.
1918
+ #
1919
+ # The mappings also include a flag for each destination denoting which
1920
+ # destination IP addresses and ports are allowed or denied traffic.
1921
+ #
1922
+ # @option params [required, String] :accelerator_arn
1923
+ # The Amazon Resource Name (ARN) of the accelerator to list the custom
1924
+ # routing port mappings for.
1925
+ #
1926
+ # @option params [String] :endpoint_group_arn
1927
+ # The Amazon Resource Name (ARN) of the endpoint group to list the
1928
+ # custom routing port mappings for.
1008
1929
  #
1009
1930
  # @option params [Integer] :max_results
1010
- # The number of Global Accelerator objects that you want to return with
1931
+ # The number of destination port mappings that you want to return with
1011
1932
  # this call. The default value is 10.
1012
1933
  #
1013
1934
  # @option params [String] :next_token
1014
1935
  # The token for the next set of results. You receive this token from a
1015
1936
  # previous call.
1016
1937
  #
1017
- # @return [Types::ListAcceleratorsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1938
+ # @return [Types::ListCustomRoutingPortMappingsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1018
1939
  #
1019
- # * {Types::ListAcceleratorsResponse#accelerators #accelerators} => Array&lt;Types::Accelerator&gt;
1020
- # * {Types::ListAcceleratorsResponse#next_token #next_token} => String
1940
+ # * {Types::ListCustomRoutingPortMappingsResponse#port_mappings #port_mappings} => Array&lt;Types::PortMapping&gt;
1941
+ # * {Types::ListCustomRoutingPortMappingsResponse#next_token #next_token} => String
1942
+ #
1943
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1021
1944
  #
1022
1945
  # @example Request syntax with placeholder values
1023
1946
  #
1024
- # resp = client.list_accelerators({
1947
+ # resp = client.list_custom_routing_port_mappings({
1948
+ # accelerator_arn: "GenericString", # required
1949
+ # endpoint_group_arn: "GenericString",
1025
1950
  # max_results: 1,
1026
1951
  # next_token: "GenericString",
1027
1952
  # })
1028
1953
  #
1029
1954
  # @example Response structure
1030
1955
  #
1031
- # resp.accelerators #=> Array
1032
- # resp.accelerators[0].accelerator_arn #=> String
1033
- # resp.accelerators[0].name #=> String
1034
- # resp.accelerators[0].ip_address_type #=> String, one of "IPV4"
1035
- # resp.accelerators[0].enabled #=> Boolean
1036
- # resp.accelerators[0].ip_sets #=> Array
1037
- # resp.accelerators[0].ip_sets[0].ip_family #=> String
1038
- # resp.accelerators[0].ip_sets[0].ip_addresses #=> Array
1039
- # resp.accelerators[0].ip_sets[0].ip_addresses[0] #=> String
1040
- # resp.accelerators[0].dns_name #=> String
1041
- # resp.accelerators[0].status #=> String, one of "DEPLOYED", "IN_PROGRESS"
1042
- # resp.accelerators[0].created_time #=> Time
1043
- # resp.accelerators[0].last_modified_time #=> Time
1956
+ # resp.port_mappings #=> Array
1957
+ # resp.port_mappings[0].accelerator_port #=> Integer
1958
+ # resp.port_mappings[0].endpoint_group_arn #=> String
1959
+ # resp.port_mappings[0].endpoint_id #=> String
1960
+ # resp.port_mappings[0].destination_socket_address.ip_address #=> String
1961
+ # resp.port_mappings[0].destination_socket_address.port #=> Integer
1962
+ # resp.port_mappings[0].protocols #=> Array
1963
+ # resp.port_mappings[0].protocols[0] #=> String, one of "TCP", "UDP"
1964
+ # resp.port_mappings[0].destination_traffic_state #=> String, one of "ALLOW", "DENY"
1044
1965
  # resp.next_token #=> String
1045
1966
  #
1046
- # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/ListAccelerators AWS API Documentation
1967
+ # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/ListCustomRoutingPortMappings AWS API Documentation
1047
1968
  #
1048
- # @overload list_accelerators(params = {})
1969
+ # @overload list_custom_routing_port_mappings(params = {})
1049
1970
  # @param [Hash] params ({})
1050
- def list_accelerators(params = {}, options = {})
1051
- req = build_request(:list_accelerators, params)
1971
+ def list_custom_routing_port_mappings(params = {}, options = {})
1972
+ req = build_request(:list_custom_routing_port_mappings, params)
1052
1973
  req.send_request(options)
1053
1974
  end
1054
1975
 
1055
- # Lists the IP address ranges that were specified in calls to
1056
- # [ProvisionByoipCidr][1], including the current state and a history of
1057
- # state changes.
1058
- #
1059
- # To see an AWS CLI example of listing BYOIP CIDR addresses, scroll down
1060
- # to **Example**.
1061
- #
1976
+ # List the port mappings for a specific EC2 instance (destination) in a
1977
+ # VPC subnet endpoint. The response is the mappings for one destination
1978
+ # IP address. This is useful when your subnet endpoint has mappings that
1979
+ # span multiple custom routing accelerators in your account, or for
1980
+ # scenarios where you only want to list the port mappings for a specific
1981
+ # destination instance.
1062
1982
  #
1983
+ # @option params [required, String] :endpoint_id
1984
+ # The ID for the virtual private cloud (VPC) subnet.
1063
1985
  #
1064
- # [1]: https://docs.aws.amazon.com/global-accelerator/latest/api/ProvisionByoipCidr.html
1986
+ # @option params [required, String] :destination_address
1987
+ # The endpoint IP address in a virtual private cloud (VPC) subnet for
1988
+ # which you want to receive back port mappings.
1065
1989
  #
1066
1990
  # @option params [Integer] :max_results
1067
- # The maximum number of results to return with a single call. To
1068
- # retrieve the remaining results, make another call with the returned
1069
- # `nextToken` value.
1991
+ # The number of destination port mappings that you want to return with
1992
+ # this call. The default value is 10.
1070
1993
  #
1071
1994
  # @option params [String] :next_token
1072
- # The token for the next page of results.
1995
+ # The token for the next set of results. You receive this token from a
1996
+ # previous call.
1073
1997
  #
1074
- # @return [Types::ListByoipCidrsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1998
+ # @return [Types::ListCustomRoutingPortMappingsByDestinationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1075
1999
  #
1076
- # * {Types::ListByoipCidrsResponse#byoip_cidrs #byoip_cidrs} => Array&lt;Types::ByoipCidr&gt;
1077
- # * {Types::ListByoipCidrsResponse#next_token #next_token} => String
2000
+ # * {Types::ListCustomRoutingPortMappingsByDestinationResponse#destination_port_mappings #destination_port_mappings} => Array&lt;Types::DestinationPortMapping&gt;
2001
+ # * {Types::ListCustomRoutingPortMappingsByDestinationResponse#next_token #next_token} => String
2002
+ #
2003
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1078
2004
  #
1079
2005
  # @example Request syntax with placeholder values
1080
2006
  #
1081
- # resp = client.list_byoip_cidrs({
2007
+ # resp = client.list_custom_routing_port_mappings_by_destination({
2008
+ # endpoint_id: "GenericString", # required
2009
+ # destination_address: "GenericString", # required
1082
2010
  # max_results: 1,
1083
2011
  # next_token: "GenericString",
1084
2012
  # })
1085
2013
  #
1086
2014
  # @example Response structure
1087
2015
  #
1088
- # resp.byoip_cidrs #=> Array
1089
- # resp.byoip_cidrs[0].cidr #=> String
1090
- # resp.byoip_cidrs[0].state #=> String, one of "PENDING_PROVISIONING", "READY", "PENDING_ADVERTISING", "ADVERTISING", "PENDING_WITHDRAWING", "PENDING_DEPROVISIONING", "DEPROVISIONED", "FAILED_PROVISION", "FAILED_ADVERTISING", "FAILED_WITHDRAW", "FAILED_DEPROVISION"
1091
- # resp.byoip_cidrs[0].events #=> Array
1092
- # resp.byoip_cidrs[0].events[0].message #=> String
1093
- # resp.byoip_cidrs[0].events[0].timestamp #=> Time
2016
+ # resp.destination_port_mappings #=> Array
2017
+ # resp.destination_port_mappings[0].accelerator_arn #=> String
2018
+ # resp.destination_port_mappings[0].accelerator_socket_addresses #=> Array
2019
+ # resp.destination_port_mappings[0].accelerator_socket_addresses[0].ip_address #=> String
2020
+ # resp.destination_port_mappings[0].accelerator_socket_addresses[0].port #=> Integer
2021
+ # resp.destination_port_mappings[0].endpoint_group_arn #=> String
2022
+ # resp.destination_port_mappings[0].endpoint_id #=> String
2023
+ # resp.destination_port_mappings[0].endpoint_group_region #=> String
2024
+ # resp.destination_port_mappings[0].destination_socket_address.ip_address #=> String
2025
+ # resp.destination_port_mappings[0].destination_socket_address.port #=> Integer
2026
+ # resp.destination_port_mappings[0].ip_address_type #=> String, one of "IPV4"
2027
+ # resp.destination_port_mappings[0].destination_traffic_state #=> String, one of "ALLOW", "DENY"
1094
2028
  # resp.next_token #=> String
1095
2029
  #
1096
- # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/ListByoipCidrs AWS API Documentation
2030
+ # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/ListCustomRoutingPortMappingsByDestination AWS API Documentation
1097
2031
  #
1098
- # @overload list_byoip_cidrs(params = {})
2032
+ # @overload list_custom_routing_port_mappings_by_destination(params = {})
1099
2033
  # @param [Hash] params ({})
1100
- def list_byoip_cidrs(params = {}, options = {})
1101
- req = build_request(:list_byoip_cidrs, params)
2034
+ def list_custom_routing_port_mappings_by_destination(params = {}, options = {})
2035
+ req = build_request(:list_custom_routing_port_mappings_by_destination, params)
1102
2036
  req.send_request(options)
1103
2037
  end
1104
2038
 
1105
- # List the endpoint groups that are associated with a listener. To see
1106
- # an AWS CLI example of listing the endpoint groups for listener, scroll
1107
- # down to **Example**.
2039
+ # List the endpoint groups that are associated with a listener.
1108
2040
  #
1109
2041
  # @option params [required, String] :listener_arn
1110
2042
  # The Amazon Resource Name (ARN) of the listener.
@@ -1122,6 +2054,8 @@ module Aws::GlobalAccelerator
1122
2054
  # * {Types::ListEndpointGroupsResponse#endpoint_groups #endpoint_groups} => Array&lt;Types::EndpointGroup&gt;
1123
2055
  # * {Types::ListEndpointGroupsResponse#next_token #next_token} => String
1124
2056
  #
2057
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2058
+ #
1125
2059
  # @example Request syntax with placeholder values
1126
2060
  #
1127
2061
  # resp = client.list_endpoint_groups({
@@ -1161,8 +2095,7 @@ module Aws::GlobalAccelerator
1161
2095
  req.send_request(options)
1162
2096
  end
1163
2097
 
1164
- # List the listeners for an accelerator. To see an AWS CLI example of
1165
- # listing the listeners for an accelerator, scroll down to **Example**.
2098
+ # List the listeners for an accelerator.
1166
2099
  #
1167
2100
  # @option params [required, String] :accelerator_arn
1168
2101
  # The Amazon Resource Name (ARN) of the accelerator for which you want
@@ -1181,6 +2114,8 @@ module Aws::GlobalAccelerator
1181
2114
  # * {Types::ListListenersResponse#listeners #listeners} => Array&lt;Types::Listener&gt;
1182
2115
  # * {Types::ListListenersResponse#next_token #next_token} => String
1183
2116
  #
2117
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2118
+ #
1184
2119
  # @example Request syntax with placeholder values
1185
2120
  #
1186
2121
  # resp = client.list_listeners({
@@ -1209,8 +2144,7 @@ module Aws::GlobalAccelerator
1209
2144
  req.send_request(options)
1210
2145
  end
1211
2146
 
1212
- # List all tags for an accelerator. To see an AWS CLI example of listing
1213
- # tags for an accelerator, scroll down to **Example**.
2147
+ # List all tags for an accelerator.
1214
2148
  #
1215
2149
  # For more information, see [Tagging in AWS Global Accelerator][1] in
1216
2150
  # the *AWS Global Accelerator Developer Guide*.
@@ -1253,9 +2187,6 @@ module Aws::GlobalAccelerator
1253
2187
  # address pool. After the address range is provisioned, it is ready to
1254
2188
  # be advertised using [ AdvertiseByoipCidr][1].
1255
2189
  #
1256
- # To see an AWS CLI example of provisioning an address range for BYOIP,
1257
- # scroll down to **Example**.
1258
- #
1259
2190
  # For more information, see [Bring Your Own IP Addresses (BYOIP)][2] in
1260
2191
  # the *AWS Global Accelerator Developer Guide*.
1261
2192
  #
@@ -1305,8 +2236,35 @@ module Aws::GlobalAccelerator
1305
2236
  req.send_request(options)
1306
2237
  end
1307
2238
 
1308
- # Add tags to an accelerator resource. To see an AWS CLI example of
1309
- # adding tags to an accelerator, scroll down to **Example**.
2239
+ # Remove endpoints from a custom routing accelerator.
2240
+ #
2241
+ # @option params [required, Array<String>] :endpoint_ids
2242
+ # The IDs for the endpoints. For custom routing accelerators, endpoint
2243
+ # IDs are the virtual private cloud (VPC) subnet IDs.
2244
+ #
2245
+ # @option params [required, String] :endpoint_group_arn
2246
+ # The Amazon Resource Name (ARN) of the endpoint group to remove
2247
+ # endpoints from.
2248
+ #
2249
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2250
+ #
2251
+ # @example Request syntax with placeholder values
2252
+ #
2253
+ # resp = client.remove_custom_routing_endpoints({
2254
+ # endpoint_ids: ["GenericString"], # required
2255
+ # endpoint_group_arn: "GenericString", # required
2256
+ # })
2257
+ #
2258
+ # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/RemoveCustomRoutingEndpoints AWS API Documentation
2259
+ #
2260
+ # @overload remove_custom_routing_endpoints(params = {})
2261
+ # @param [Hash] params ({})
2262
+ def remove_custom_routing_endpoints(params = {}, options = {})
2263
+ req = build_request(:remove_custom_routing_endpoints, params)
2264
+ req.send_request(options)
2265
+ end
2266
+
2267
+ # Add tags to an accelerator resource.
1310
2268
  #
1311
2269
  # For more information, see [Tagging in AWS Global Accelerator][1] in
1312
2270
  # the *AWS Global Accelerator Developer Guide*.
@@ -1347,10 +2305,9 @@ module Aws::GlobalAccelerator
1347
2305
  end
1348
2306
 
1349
2307
  # Remove tags from a Global Accelerator resource. When you specify a tag
1350
- # key, the action removes both that key and its associated value. To see
1351
- # an AWS CLI example of removing tags from an accelerator, scroll down
1352
- # to **Example**. The operation succeeds even if you attempt to remove
1353
- # tags from an accelerator that was already removed.
2308
+ # key, the action removes both that key and its associated value. The
2309
+ # operation succeeds even if you attempt to remove tags from an
2310
+ # accelerator that was already removed.
1354
2311
  #
1355
2312
  # For more information, see [Tagging in AWS Global Accelerator][1] in
1356
2313
  # the *AWS Global Accelerator Developer Guide*.
@@ -1385,8 +2342,7 @@ module Aws::GlobalAccelerator
1385
2342
  req.send_request(options)
1386
2343
  end
1387
2344
 
1388
- # Update an accelerator. To see an AWS CLI example of updating an
1389
- # accelerator, scroll down to **Example**.
2345
+ # Update an accelerator.
1390
2346
  #
1391
2347
  # Global Accelerator is a global service that supports endpoints in
1392
2348
  # multiple AWS Regions but you must specify the US West (Oregon) Region
@@ -1401,7 +2357,7 @@ module Aws::GlobalAccelerator
1401
2357
  # and must not begin or end with a hyphen.
1402
2358
  #
1403
2359
  # @option params [String] :ip_address_type
1404
- # The value for the address type must be IPv4.
2360
+ # The IP address type, which must be IPv4.
1405
2361
  #
1406
2362
  # @option params [Boolean] :enabled
1407
2363
  # Indicates whether an accelerator is enabled. The value is true or
@@ -1447,9 +2403,7 @@ module Aws::GlobalAccelerator
1447
2403
  req.send_request(options)
1448
2404
  end
1449
2405
 
1450
- # Update the attributes for an accelerator. To see an AWS CLI example of
1451
- # updating an accelerator to enable flow logs, scroll down to
1452
- # **Example**.
2406
+ # Update the attributes for an accelerator.
1453
2407
  #
1454
2408
  # @option params [required, String] :accelerator_arn
1455
2409
  # The Amazon Resource Name (ARN) of the accelerator that you want to
@@ -1512,12 +2466,178 @@ module Aws::GlobalAccelerator
1512
2466
  req.send_request(options)
1513
2467
  end
1514
2468
 
2469
+ # Update a custom routing accelerator.
2470
+ #
2471
+ # @option params [required, String] :accelerator_arn
2472
+ # The Amazon Resource Name (ARN) of the accelerator to update.
2473
+ #
2474
+ # @option params [String] :name
2475
+ # The name of the accelerator. The name can have a maximum of 32
2476
+ # characters, must contain only alphanumeric characters or hyphens (-),
2477
+ # and must not begin or end with a hyphen.
2478
+ #
2479
+ # @option params [String] :ip_address_type
2480
+ # The value for the address type must be IPv4.
2481
+ #
2482
+ # @option params [Boolean] :enabled
2483
+ # Indicates whether an accelerator is enabled. The value is true or
2484
+ # false. The default value is true.
2485
+ #
2486
+ # If the value is set to true, the accelerator cannot be deleted. If set
2487
+ # to false, the accelerator can be deleted.
2488
+ #
2489
+ # @return [Types::UpdateCustomRoutingAcceleratorResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2490
+ #
2491
+ # * {Types::UpdateCustomRoutingAcceleratorResponse#accelerator #accelerator} => Types::CustomRoutingAccelerator
2492
+ #
2493
+ # @example Request syntax with placeholder values
2494
+ #
2495
+ # resp = client.update_custom_routing_accelerator({
2496
+ # accelerator_arn: "GenericString", # required
2497
+ # name: "GenericString",
2498
+ # ip_address_type: "IPV4", # accepts IPV4
2499
+ # enabled: false,
2500
+ # })
2501
+ #
2502
+ # @example Response structure
2503
+ #
2504
+ # resp.accelerator.accelerator_arn #=> String
2505
+ # resp.accelerator.name #=> String
2506
+ # resp.accelerator.ip_address_type #=> String, one of "IPV4"
2507
+ # resp.accelerator.enabled #=> Boolean
2508
+ # resp.accelerator.ip_sets #=> Array
2509
+ # resp.accelerator.ip_sets[0].ip_family #=> String
2510
+ # resp.accelerator.ip_sets[0].ip_addresses #=> Array
2511
+ # resp.accelerator.ip_sets[0].ip_addresses[0] #=> String
2512
+ # resp.accelerator.dns_name #=> String
2513
+ # resp.accelerator.status #=> String, one of "DEPLOYED", "IN_PROGRESS"
2514
+ # resp.accelerator.created_time #=> Time
2515
+ # resp.accelerator.last_modified_time #=> Time
2516
+ #
2517
+ # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/UpdateCustomRoutingAccelerator AWS API Documentation
2518
+ #
2519
+ # @overload update_custom_routing_accelerator(params = {})
2520
+ # @param [Hash] params ({})
2521
+ def update_custom_routing_accelerator(params = {}, options = {})
2522
+ req = build_request(:update_custom_routing_accelerator, params)
2523
+ req.send_request(options)
2524
+ end
2525
+
2526
+ # Update the attributes for a custom routing accelerator.
2527
+ #
2528
+ # @option params [required, String] :accelerator_arn
2529
+ # The Amazon Resource Name (ARN) of the custom routing accelerator to
2530
+ # update attributes for.
2531
+ #
2532
+ # @option params [Boolean] :flow_logs_enabled
2533
+ # Update whether flow logs are enabled. The default value is false. If
2534
+ # the value is true, `FlowLogsS3Bucket` and `FlowLogsS3Prefix` must be
2535
+ # specified.
2536
+ #
2537
+ # For more information, see [Flow Logs][1] in the *AWS Global
2538
+ # Accelerator Developer Guide*.
2539
+ #
2540
+ #
2541
+ #
2542
+ # [1]: https://docs.aws.amazon.com/global-accelerator/latest/dg/monitoring-global-accelerator.flow-logs.html
2543
+ #
2544
+ # @option params [String] :flow_logs_s3_bucket
2545
+ # The name of the Amazon S3 bucket for the flow logs. Attribute is
2546
+ # required if `FlowLogsEnabled` is `true`. The bucket must exist and
2547
+ # have a bucket policy that grants AWS Global Accelerator permission to
2548
+ # write to the bucket.
2549
+ #
2550
+ # @option params [String] :flow_logs_s3_prefix
2551
+ # Update the prefix for the location in the Amazon S3 bucket for the
2552
+ # flow logs. Attribute is required if `FlowLogsEnabled` is `true`.
2553
+ #
2554
+ # If you don’t specify a prefix, the flow logs are stored in the root of
2555
+ # the bucket. If you specify slash (/) for the S3 bucket prefix, the log
2556
+ # file bucket folder structure will include a double slash (//), like
2557
+ # the following:
2558
+ #
2559
+ # DOC-EXAMPLE-BUCKET//AWSLogs/aws\_account\_id
2560
+ #
2561
+ # @return [Types::UpdateCustomRoutingAcceleratorAttributesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2562
+ #
2563
+ # * {Types::UpdateCustomRoutingAcceleratorAttributesResponse#accelerator_attributes #accelerator_attributes} => Types::CustomRoutingAcceleratorAttributes
2564
+ #
2565
+ # @example Request syntax with placeholder values
2566
+ #
2567
+ # resp = client.update_custom_routing_accelerator_attributes({
2568
+ # accelerator_arn: "GenericString", # required
2569
+ # flow_logs_enabled: false,
2570
+ # flow_logs_s3_bucket: "GenericString",
2571
+ # flow_logs_s3_prefix: "GenericString",
2572
+ # })
2573
+ #
2574
+ # @example Response structure
2575
+ #
2576
+ # resp.accelerator_attributes.flow_logs_enabled #=> Boolean
2577
+ # resp.accelerator_attributes.flow_logs_s3_bucket #=> String
2578
+ # resp.accelerator_attributes.flow_logs_s3_prefix #=> String
2579
+ #
2580
+ # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/UpdateCustomRoutingAcceleratorAttributes AWS API Documentation
2581
+ #
2582
+ # @overload update_custom_routing_accelerator_attributes(params = {})
2583
+ # @param [Hash] params ({})
2584
+ def update_custom_routing_accelerator_attributes(params = {}, options = {})
2585
+ req = build_request(:update_custom_routing_accelerator_attributes, params)
2586
+ req.send_request(options)
2587
+ end
2588
+
2589
+ # Update a listener for a custom routing accelerator.
2590
+ #
2591
+ # @option params [required, String] :listener_arn
2592
+ # The Amazon Resource Name (ARN) of the listener to update.
2593
+ #
2594
+ # @option params [required, Array<Types::PortRange>] :port_ranges
2595
+ # The updated port range to support for connections from clients to your
2596
+ # accelerator. If you remove ports that are currently being used by a
2597
+ # subnet endpoint, the call fails.
2598
+ #
2599
+ # Separately, you set port ranges for endpoints. For more information,
2600
+ # see [About endpoints for custom routing accelerators][1].
2601
+ #
2602
+ #
2603
+ #
2604
+ # [1]: https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-endpoints.html
2605
+ #
2606
+ # @return [Types::UpdateCustomRoutingListenerResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2607
+ #
2608
+ # * {Types::UpdateCustomRoutingListenerResponse#listener #listener} => Types::CustomRoutingListener
2609
+ #
2610
+ # @example Request syntax with placeholder values
2611
+ #
2612
+ # resp = client.update_custom_routing_listener({
2613
+ # listener_arn: "GenericString", # required
2614
+ # port_ranges: [ # required
2615
+ # {
2616
+ # from_port: 1,
2617
+ # to_port: 1,
2618
+ # },
2619
+ # ],
2620
+ # })
2621
+ #
2622
+ # @example Response structure
2623
+ #
2624
+ # resp.listener.listener_arn #=> String
2625
+ # resp.listener.port_ranges #=> Array
2626
+ # resp.listener.port_ranges[0].from_port #=> Integer
2627
+ # resp.listener.port_ranges[0].to_port #=> Integer
2628
+ #
2629
+ # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/UpdateCustomRoutingListener AWS API Documentation
2630
+ #
2631
+ # @overload update_custom_routing_listener(params = {})
2632
+ # @param [Hash] params ({})
2633
+ def update_custom_routing_listener(params = {}, options = {})
2634
+ req = build_request(:update_custom_routing_listener, params)
2635
+ req.send_request(options)
2636
+ end
2637
+
1515
2638
  # Update an endpoint group. A resource must be valid and active when you
1516
2639
  # add it as an endpoint.
1517
2640
  #
1518
- # To see an AWS CLI example of updating an endpoint group, scroll down
1519
- # to **Example**.
1520
- #
1521
2641
  # @option params [required, String] :endpoint_group_arn
1522
2642
  # The Amazon Resource Name (ARN) of the endpoint group.
1523
2643
  #
@@ -1593,7 +2713,7 @@ module Aws::GlobalAccelerator
1593
2713
  # traffic_dial_percentage: 1.0,
1594
2714
  # health_check_port: 1,
1595
2715
  # health_check_protocol: "TCP", # accepts TCP, HTTP, HTTPS
1596
- # health_check_path: "GenericString",
2716
+ # health_check_path: "HealthCheckPath",
1597
2717
  # health_check_interval_seconds: 1,
1598
2718
  # threshold_count: 1,
1599
2719
  # port_overrides: [
@@ -1633,8 +2753,7 @@ module Aws::GlobalAccelerator
1633
2753
  req.send_request(options)
1634
2754
  end
1635
2755
 
1636
- # Update a listener. To see an AWS CLI example of updating listener,
1637
- # scroll down to **Example**.
2756
+ # Update a listener.
1638
2757
  #
1639
2758
  # @option params [required, String] :listener_arn
1640
2759
  # The Amazon Resource Name (ARN) of the listener to update.
@@ -1710,9 +2829,7 @@ module Aws::GlobalAccelerator
1710
2829
 
1711
2830
  # Stops advertising an address range that is provisioned as an address
1712
2831
  # pool. You can perform this operation at most once every 10 seconds,
1713
- # even if you specify different address ranges each time. To see an AWS
1714
- # CLI example of withdrawing an address range for BYOIP so it will no
1715
- # longer be advertised by AWS, scroll down to **Example**.
2832
+ # even if you specify different address ranges each time.
1716
2833
  #
1717
2834
  # It can take a few minutes before traffic to the specified addresses
1718
2835
  # stops routing to AWS because of propagation delays.
@@ -1767,7 +2884,7 @@ module Aws::GlobalAccelerator
1767
2884
  params: params,
1768
2885
  config: config)
1769
2886
  context[:gem_name] = 'aws-sdk-globalaccelerator'
1770
- context[:gem_version] = '1.24.0'
2887
+ context[:gem_version] = '1.29.0'
1771
2888
  Seahorse::Client::Request.new(handlers, context)
1772
2889
  end
1773
2890