aws-sdk-globalaccelerator 1.24.0 → 1.29.0

Sign up to get free protection for your applications and to get access to all the features.
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