aws-sdk-globalaccelerator 1.39.0 → 1.40.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.
@@ -422,15 +422,16 @@ module Aws::GlobalAccelerator
422
422
  end
423
423
 
424
424
  # Advertises an IPv4 address range that is provisioned for use with your
425
- # AWS resources through bring your own IP addresses (BYOIP). It can take
426
- # a few minutes before traffic to the specified addresses starts routing
427
- # to AWS because of propagation delays.
425
+ # Amazon Web Services resources through bring your own IP addresses
426
+ # (BYOIP). It can take a few minutes before traffic to the specified
427
+ # addresses starts routing to Amazon Web Services because of propagation
428
+ # delays.
428
429
  #
429
430
  # To stop advertising the BYOIP address range, use [
430
431
  # WithdrawByoipCidr][1].
431
432
  #
432
- # For more information, see [Bring Your Own IP Addresses (BYOIP)][2] in
433
- # the *AWS Global Accelerator Developer Guide*.
433
+ # For more information, see [Bring your own IP addresses (BYOIP)][2] in
434
+ # the *Global Accelerator Developer Guide*.
434
435
  #
435
436
  #
436
437
  #
@@ -545,35 +546,44 @@ module Aws::GlobalAccelerator
545
546
  # Load Balancers.
546
547
  #
547
548
  # Global Accelerator is a global service that supports endpoints in
548
- # multiple AWS Regions but you must specify the US West (Oregon) Region
549
- # to create or update accelerators.
549
+ # multiple Amazon Web Services Regions but you must specify the US West
550
+ # (Oregon) Region to create, update, or otherwise work with
551
+ # accelerators. That is, for example, specify `--region us-west-2` on
552
+ # AWS CLI commands.
550
553
  #
551
554
  # @option params [required, String] :name
552
- # The name of an accelerator. The name can have a maximum of 32
553
- # characters, must contain only alphanumeric characters or hyphens (-),
554
- # and must not begin or end with a hyphen.
555
+ # The name of the accelerator. The name can have a maximum of 64
556
+ # characters, must contain only alphanumeric characters, periods (.), or
557
+ # hyphens (-), and must not begin or end with a hyphen or period.
555
558
  #
556
559
  # @option params [String] :ip_address_type
557
- # The value for the address type must be IPv4.
560
+ # The IP address type that an accelerator supports. For a standard
561
+ # accelerator, the value can be IPV4 or DUAL\_STACK.
558
562
  #
559
563
  # @option params [Array<String>] :ip_addresses
560
564
  # Optionally, if you've added your own IP address pool to Global
561
- # Accelerator (BYOIP), you can choose IP addresses from your own pool to
562
- # use for the accelerator's static IP addresses when you create an
563
- # accelerator. You can specify one or two addresses, separated by a
564
- # space. Do not include the /32 suffix.
565
+ # Accelerator (BYOIP), you can choose an IPv4 address from your own pool
566
+ # to use for the accelerator's static IPv4 address when you create an
567
+ # accelerator.
568
+ #
569
+ # After you bring an address range to Amazon Web Services, it appears in
570
+ # your account as an address pool. When you create an accelerator, you
571
+ # can assign one IPv4 address from your range to it. Global Accelerator
572
+ # assigns you a second static IPv4 address from an Amazon IP address
573
+ # range. If you bring two IPv4 address ranges to Amazon Web Services,
574
+ # you can assign one IPv4 address from each range to your accelerator.
575
+ # This restriction is because Global Accelerator assigns each address
576
+ # range to a different network zone, for high availability.
565
577
  #
566
- # Only one IP address from each of your IP address ranges can be used
567
- # for each accelerator. If you specify only one IP address from your IP
568
- # address range, Global Accelerator assigns a second static IP address
569
- # for the accelerator from the AWS IP address pool.
578
+ # You can specify one or two addresses, separated by a space. Do not
579
+ # include the /32 suffix.
570
580
  #
571
581
  # Note that you can't update IP addresses for an existing accelerator.
572
582
  # To change them, you must create a new accelerator with the new
573
583
  # addresses.
574
584
  #
575
- # For more information, see [Bring Your Own IP Addresses (BYOIP)][1] in
576
- # the *AWS Global Accelerator Developer Guide*.
585
+ # For more information, see [Bring your own IP addresses (BYOIP)][1] in
586
+ # the *Global Accelerator Developer Guide*.
577
587
  #
578
588
  #
579
589
  #
@@ -596,8 +606,8 @@ module Aws::GlobalAccelerator
596
606
  # @option params [Array<Types::Tag>] :tags
597
607
  # Create tags for an accelerator.
598
608
  #
599
- # For more information, see [Tagging in AWS Global Accelerator][1] in
600
- # the *AWS Global Accelerator Developer Guide*.
609
+ # For more information, see [Tagging in Global Accelerator][1] in the
610
+ # *Global Accelerator Developer Guide*.
601
611
  #
602
612
  #
603
613
  #
@@ -611,7 +621,7 @@ module Aws::GlobalAccelerator
611
621
  #
612
622
  # resp = client.create_accelerator({
613
623
  # name: "GenericString", # required
614
- # ip_address_type: "IPV4", # accepts IPV4
624
+ # ip_address_type: "IPV4", # accepts IPV4, DUAL_STACK
615
625
  # ip_addresses: ["IpAddress"],
616
626
  # enabled: false,
617
627
  # idempotency_token: "IdempotencyToken", # required
@@ -627,16 +637,21 @@ module Aws::GlobalAccelerator
627
637
  #
628
638
  # resp.accelerator.accelerator_arn #=> String
629
639
  # resp.accelerator.name #=> String
630
- # resp.accelerator.ip_address_type #=> String, one of "IPV4"
640
+ # resp.accelerator.ip_address_type #=> String, one of "IPV4", "DUAL_STACK"
631
641
  # resp.accelerator.enabled #=> Boolean
632
642
  # resp.accelerator.ip_sets #=> Array
633
643
  # resp.accelerator.ip_sets[0].ip_family #=> String
634
644
  # resp.accelerator.ip_sets[0].ip_addresses #=> Array
635
645
  # resp.accelerator.ip_sets[0].ip_addresses[0] #=> String
646
+ # resp.accelerator.ip_sets[0].ip_address_family #=> String, one of "IPv4", "IPv6"
636
647
  # resp.accelerator.dns_name #=> String
637
648
  # resp.accelerator.status #=> String, one of "DEPLOYED", "IN_PROGRESS"
638
649
  # resp.accelerator.created_time #=> Time
639
650
  # resp.accelerator.last_modified_time #=> Time
651
+ # resp.accelerator.dual_stack_dns_name #=> String
652
+ # resp.accelerator.events #=> Array
653
+ # resp.accelerator.events[0].message #=> String
654
+ # resp.accelerator.events[0].timestamp #=> Time
640
655
  #
641
656
  # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/CreateAccelerator AWS API Documentation
642
657
  #
@@ -658,8 +673,10 @@ module Aws::GlobalAccelerator
658
673
  # receive traffic, see the [ AllowCustomRoutingTraffic][1] operation.
659
674
  #
660
675
  # Global Accelerator is a global service that supports endpoints in
661
- # multiple AWS Regions but you must specify the US West (Oregon) Region
662
- # to create or update accelerators.
676
+ # multiple Amazon Web Services Regions but you must specify the US West
677
+ # (Oregon) Region to create, update, or otherwise work with
678
+ # accelerators. That is, for example, specify `--region us-west-2` on
679
+ # AWS CLI commands.
663
680
  #
664
681
  #
665
682
  #
@@ -671,26 +688,33 @@ module Aws::GlobalAccelerator
671
688
  # (-), and must not begin or end with a hyphen.
672
689
  #
673
690
  # @option params [String] :ip_address_type
674
- # The value for the address type must be IPv4.
691
+ # The IP address type that an accelerator supports. For a custom routing
692
+ # accelerator, the value must be IPV4.
675
693
  #
676
694
  # @option params [Array<String>] :ip_addresses
677
695
  # Optionally, if you've added your own IP address pool to Global
678
- # Accelerator (BYOIP), you can choose IP addresses from your own pool to
679
- # use for the accelerator's static IP addresses when you create an
680
- # accelerator. You can specify one or two addresses, separated by a
681
- # space. Do not include the /32 suffix.
696
+ # Accelerator (BYOIP), you can choose an IPv4 address from your own pool
697
+ # to use for the accelerator's static IPv4 address when you create an
698
+ # accelerator.
699
+ #
700
+ # After you bring an address range to Amazon Web Services, it appears in
701
+ # your account as an address pool. When you create an accelerator, you
702
+ # can assign one IPv4 address from your range to it. Global Accelerator
703
+ # assigns you a second static IPv4 address from an Amazon IP address
704
+ # range. If you bring two IPv4 address ranges to Amazon Web Services,
705
+ # you can assign one IPv4 address from each range to your accelerator.
706
+ # This restriction is because Global Accelerator assigns each address
707
+ # range to a different network zone, for high availability.
682
708
  #
683
- # Only one IP address from each of your IP address ranges can be used
684
- # for each accelerator. If you specify only one IP address from your IP
685
- # address range, Global Accelerator assigns a second static IP address
686
- # for the accelerator from the AWS IP address pool.
709
+ # You can specify one or two addresses, separated by a space. Do not
710
+ # include the /32 suffix.
687
711
  #
688
712
  # Note that you can't update IP addresses for an existing accelerator.
689
713
  # To change them, you must create a new accelerator with the new
690
714
  # addresses.
691
715
  #
692
716
  # For more information, see [Bring your own IP addresses (BYOIP)][1] in
693
- # the *AWS Global Accelerator Developer Guide*.
717
+ # the *Global Accelerator Developer Guide*.
694
718
  #
695
719
  #
696
720
  #
@@ -713,8 +737,8 @@ module Aws::GlobalAccelerator
713
737
  # @option params [Array<Types::Tag>] :tags
714
738
  # Create tags for an accelerator.
715
739
  #
716
- # For more information, see [Tagging in AWS Global Accelerator][1] in
717
- # the *AWS Global Accelerator Developer Guide*.
740
+ # For more information, see [Tagging in Global Accelerator][1] in the
741
+ # *Global Accelerator Developer Guide*.
718
742
  #
719
743
  #
720
744
  #
@@ -728,7 +752,7 @@ module Aws::GlobalAccelerator
728
752
  #
729
753
  # resp = client.create_custom_routing_accelerator({
730
754
  # name: "GenericString", # required
731
- # ip_address_type: "IPV4", # accepts IPV4
755
+ # ip_address_type: "IPV4", # accepts IPV4, DUAL_STACK
732
756
  # ip_addresses: ["IpAddress"],
733
757
  # enabled: false,
734
758
  # idempotency_token: "IdempotencyToken", # required
@@ -744,12 +768,13 @@ module Aws::GlobalAccelerator
744
768
  #
745
769
  # resp.accelerator.accelerator_arn #=> String
746
770
  # resp.accelerator.name #=> String
747
- # resp.accelerator.ip_address_type #=> String, one of "IPV4"
771
+ # resp.accelerator.ip_address_type #=> String, one of "IPV4", "DUAL_STACK"
748
772
  # resp.accelerator.enabled #=> Boolean
749
773
  # resp.accelerator.ip_sets #=> Array
750
774
  # resp.accelerator.ip_sets[0].ip_family #=> String
751
775
  # resp.accelerator.ip_sets[0].ip_addresses #=> Array
752
776
  # resp.accelerator.ip_sets[0].ip_addresses[0] #=> String
777
+ # resp.accelerator.ip_sets[0].ip_address_family #=> String, one of "IPv4", "IPv6"
753
778
  # resp.accelerator.dns_name #=> String
754
779
  # resp.accelerator.status #=> String, one of "DEPLOYED", "IN_PROGRESS"
755
780
  # resp.accelerator.created_time #=> Time
@@ -766,15 +791,15 @@ module Aws::GlobalAccelerator
766
791
 
767
792
  # Create an endpoint group for the specified listener for a custom
768
793
  # routing accelerator. An endpoint group is a collection of endpoints in
769
- # one AWS Region.
794
+ # one Amazon Web Services Region.
770
795
  #
771
796
  # @option params [required, String] :listener_arn
772
797
  # The Amazon Resource Name (ARN) of the listener for a custom routing
773
798
  # endpoint.
774
799
  #
775
800
  # @option params [required, String] :endpoint_group_region
776
- # The AWS Region where the endpoint group is located. A listener can
777
- # have only one endpoint group in a specific Region.
801
+ # The Amazon Web Services Region where the endpoint group is located. A
802
+ # listener can have only one endpoint group in a specific Region.
778
803
  #
779
804
  # @option params [required, Array<Types::CustomRoutingDestinationConfiguration>] :destination_configurations
780
805
  # Sets the port range and protocol for all endpoints (virtual private
@@ -888,22 +913,23 @@ module Aws::GlobalAccelerator
888
913
  end
889
914
 
890
915
  # Create an endpoint group for the specified listener. An endpoint group
891
- # is a collection of endpoints in one AWS Region. A resource must be
892
- # valid and active when you add it as an endpoint.
916
+ # is a collection of endpoints in one Amazon Web Services Region. A
917
+ # resource must be valid and active when you add it as an endpoint.
893
918
  #
894
919
  # @option params [required, String] :listener_arn
895
920
  # The Amazon Resource Name (ARN) of the listener.
896
921
  #
897
922
  # @option params [required, String] :endpoint_group_region
898
- # The AWS Region where the endpoint group is located. A listener can
899
- # have only one endpoint group in a specific Region.
923
+ # The Amazon Web Services Region where the endpoint group is located. A
924
+ # listener can have only one endpoint group in a specific Region.
900
925
  #
901
926
  # @option params [Array<Types::EndpointConfiguration>] :endpoint_configurations
902
927
  # The list of endpoint objects.
903
928
  #
904
929
  # @option params [Float] :traffic_dial_percentage
905
- # The percentage of traffic to send to an AWS Region. Additional traffic
906
- # is distributed to other endpoint groups for this listener.
930
+ # The percentage of traffic to send to an Amazon Web Services Region.
931
+ # Additional traffic is distributed to other endpoint groups for this
932
+ # listener.
907
933
  #
908
934
  # Use this action to increase (dial up) or decrease (dial down) traffic
909
935
  # to a specific Region. The percentage is applied to the traffic that
@@ -913,14 +939,13 @@ module Aws::GlobalAccelerator
913
939
  # The default value is 100.
914
940
  #
915
941
  # @option params [Integer] :health_check_port
916
- # The port that AWS Global Accelerator uses to check the health of
917
- # endpoints that are part of this endpoint group. The default port is
918
- # the listener port that this endpoint group is associated with. If
919
- # listener port is a list of ports, Global Accelerator uses the first
920
- # port in the list.
942
+ # The port that Global Accelerator uses to check the health of endpoints
943
+ # that are part of this endpoint group. The default port is the listener
944
+ # port that this endpoint group is associated with. If listener port is
945
+ # a list of ports, Global Accelerator uses the first port in the list.
921
946
  #
922
947
  # @option params [String] :health_check_protocol
923
- # The protocol that AWS Global Accelerator uses to check the health of
948
+ # The protocol that Global Accelerator uses to check the health of
924
949
  # endpoints that are part of this endpoint group. The default value is
925
950
  # TCP.
926
951
  #
@@ -951,8 +976,8 @@ module Aws::GlobalAccelerator
951
976
  # and 443, but your accelerator routes that traffic to ports 1080 and
952
977
  # 1443, respectively, on the endpoints.
953
978
  #
954
- # For more information, see [ Port overrides][1] in the *AWS Global
955
- # Accelerator Developer Guide*.
979
+ # For more information, see [ Overriding listener ports][1] in the
980
+ # *Global Accelerator Developer Guide*.
956
981
  #
957
982
  #
958
983
  #
@@ -1039,15 +1064,14 @@ module Aws::GlobalAccelerator
1039
1064
  # over whether to always route each client to the same specific
1040
1065
  # endpoint.
1041
1066
  #
1042
- # AWS Global Accelerator uses a consistent-flow hashing algorithm to
1043
- # choose the optimal endpoint for a connection. If client affinity is
1044
- # `NONE`, Global Accelerator uses the "five-tuple" (5-tuple)
1045
- # properties—source IP address, source port, destination IP address,
1046
- # destination port, and protocol—to select the hash value, and then
1047
- # chooses the best endpoint. However, with this setting, if someone uses
1048
- # different ports to connect to Global Accelerator, their connections
1049
- # might not be always routed to the same endpoint because the hash value
1050
- # changes.
1067
+ # Global Accelerator uses a consistent-flow hashing algorithm to choose
1068
+ # the optimal endpoint for a connection. If client affinity is `NONE`,
1069
+ # Global Accelerator uses the "five-tuple" (5-tuple) properties—source
1070
+ # IP address, source port, destination IP address, destination port, and
1071
+ # protocol—to select the hash value, and then chooses the best endpoint.
1072
+ # However, with this setting, if someone uses different ports to connect
1073
+ # to Global Accelerator, their connections might not be always routed to
1074
+ # the same endpoint because the hash value changes.
1051
1075
  #
1052
1076
  # If you want a given client to always be routed to the same endpoint,
1053
1077
  # set client affinity to `SOURCE_IP` instead. When you use the
@@ -1119,8 +1143,8 @@ module Aws::GlobalAccelerator
1119
1143
  # that you have permissions in place to avoid inadvertently deleting
1120
1144
  # accelerators. You can use IAM policies with Global Accelerator to
1121
1145
  # limit the users who have permissions to delete an accelerator. For
1122
- # more information, see [Authentication and Access Control][1] in the
1123
- # *AWS Global Accelerator Developer Guide*.
1146
+ # more information, see [Identity and access management][1] in the
1147
+ # *Global Accelerator Developer Guide*.
1124
1148
  #
1125
1149
  #
1126
1150
  #
@@ -1162,8 +1186,8 @@ module Aws::GlobalAccelerator
1162
1186
  # that you have permissions in place to avoid inadvertently deleting
1163
1187
  # accelerators. You can use IAM policies with Global Accelerator to
1164
1188
  # limit the users who have permissions to delete an accelerator. For
1165
- # more information, see [Authentication and Access Control][1] in the
1166
- # *AWS Global Accelerator Developer Guide*.
1189
+ # more information, see [Identity and access management][1] in the
1190
+ # *Global Accelerator Developer Guide*.
1167
1191
  #
1168
1192
  #
1169
1193
  #
@@ -1346,15 +1370,15 @@ module Aws::GlobalAccelerator
1346
1370
  end
1347
1371
 
1348
1372
  # Releases the specified address range that you provisioned to use with
1349
- # your AWS resources through bring your own IP addresses (BYOIP) and
1350
- # deletes the corresponding address pool.
1373
+ # your Amazon Web Services resources through bring your own IP addresses
1374
+ # (BYOIP) and deletes the corresponding address pool.
1351
1375
  #
1352
1376
  # Before you can release an address range, you must stop advertising it
1353
1377
  # by using [WithdrawByoipCidr][1] and you must not have any accelerators
1354
1378
  # that are using static IP addresses allocated from its address range.
1355
1379
  #
1356
- # For more information, see [Bring Your Own IP Addresses (BYOIP)][2] in
1357
- # the *AWS Global Accelerator Developer Guide*.
1380
+ # For more information, see [Bring your own IP addresses (BYOIP)][2] in
1381
+ # the *Global Accelerator Developer Guide*.
1358
1382
  #
1359
1383
  #
1360
1384
  #
@@ -1411,16 +1435,21 @@ module Aws::GlobalAccelerator
1411
1435
  #
1412
1436
  # resp.accelerator.accelerator_arn #=> String
1413
1437
  # resp.accelerator.name #=> String
1414
- # resp.accelerator.ip_address_type #=> String, one of "IPV4"
1438
+ # resp.accelerator.ip_address_type #=> String, one of "IPV4", "DUAL_STACK"
1415
1439
  # resp.accelerator.enabled #=> Boolean
1416
1440
  # resp.accelerator.ip_sets #=> Array
1417
1441
  # resp.accelerator.ip_sets[0].ip_family #=> String
1418
1442
  # resp.accelerator.ip_sets[0].ip_addresses #=> Array
1419
1443
  # resp.accelerator.ip_sets[0].ip_addresses[0] #=> String
1444
+ # resp.accelerator.ip_sets[0].ip_address_family #=> String, one of "IPv4", "IPv6"
1420
1445
  # resp.accelerator.dns_name #=> String
1421
1446
  # resp.accelerator.status #=> String, one of "DEPLOYED", "IN_PROGRESS"
1422
1447
  # resp.accelerator.created_time #=> Time
1423
1448
  # resp.accelerator.last_modified_time #=> Time
1449
+ # resp.accelerator.dual_stack_dns_name #=> String
1450
+ # resp.accelerator.events #=> Array
1451
+ # resp.accelerator.events[0].message #=> String
1452
+ # resp.accelerator.events[0].timestamp #=> Time
1424
1453
  #
1425
1454
  # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/DescribeAccelerator AWS API Documentation
1426
1455
  #
@@ -1481,12 +1510,13 @@ module Aws::GlobalAccelerator
1481
1510
  #
1482
1511
  # resp.accelerator.accelerator_arn #=> String
1483
1512
  # resp.accelerator.name #=> String
1484
- # resp.accelerator.ip_address_type #=> String, one of "IPV4"
1513
+ # resp.accelerator.ip_address_type #=> String, one of "IPV4", "DUAL_STACK"
1485
1514
  # resp.accelerator.enabled #=> Boolean
1486
1515
  # resp.accelerator.ip_sets #=> Array
1487
1516
  # resp.accelerator.ip_sets[0].ip_family #=> String
1488
1517
  # resp.accelerator.ip_sets[0].ip_addresses #=> Array
1489
1518
  # resp.accelerator.ip_sets[0].ip_addresses[0] #=> String
1519
+ # resp.accelerator.ip_sets[0].ip_address_family #=> String, one of "IPv4", "IPv6"
1490
1520
  # resp.accelerator.dns_name #=> String
1491
1521
  # resp.accelerator.status #=> String, one of "DEPLOYED", "IN_PROGRESS"
1492
1522
  # resp.accelerator.created_time #=> Time
@@ -1676,7 +1706,7 @@ module Aws::GlobalAccelerator
1676
1706
  req.send_request(options)
1677
1707
  end
1678
1708
 
1679
- # List the accelerators for an AWS account.
1709
+ # List the accelerators for an Amazon Web Services account.
1680
1710
  #
1681
1711
  # @option params [Integer] :max_results
1682
1712
  # The number of Global Accelerator objects that you want to return with
@@ -1705,16 +1735,21 @@ module Aws::GlobalAccelerator
1705
1735
  # resp.accelerators #=> Array
1706
1736
  # resp.accelerators[0].accelerator_arn #=> String
1707
1737
  # resp.accelerators[0].name #=> String
1708
- # resp.accelerators[0].ip_address_type #=> String, one of "IPV4"
1738
+ # resp.accelerators[0].ip_address_type #=> String, one of "IPV4", "DUAL_STACK"
1709
1739
  # resp.accelerators[0].enabled #=> Boolean
1710
1740
  # resp.accelerators[0].ip_sets #=> Array
1711
1741
  # resp.accelerators[0].ip_sets[0].ip_family #=> String
1712
1742
  # resp.accelerators[0].ip_sets[0].ip_addresses #=> Array
1713
1743
  # resp.accelerators[0].ip_sets[0].ip_addresses[0] #=> String
1744
+ # resp.accelerators[0].ip_sets[0].ip_address_family #=> String, one of "IPv4", "IPv6"
1714
1745
  # resp.accelerators[0].dns_name #=> String
1715
1746
  # resp.accelerators[0].status #=> String, one of "DEPLOYED", "IN_PROGRESS"
1716
1747
  # resp.accelerators[0].created_time #=> Time
1717
1748
  # resp.accelerators[0].last_modified_time #=> Time
1749
+ # resp.accelerators[0].dual_stack_dns_name #=> String
1750
+ # resp.accelerators[0].events #=> Array
1751
+ # resp.accelerators[0].events[0].message #=> String
1752
+ # resp.accelerators[0].events[0].timestamp #=> Time
1718
1753
  # resp.next_token #=> String
1719
1754
  #
1720
1755
  # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/ListAccelerators AWS API Documentation
@@ -1775,7 +1810,8 @@ module Aws::GlobalAccelerator
1775
1810
  req.send_request(options)
1776
1811
  end
1777
1812
 
1778
- # List the custom routing accelerators for an AWS account.
1813
+ # List the custom routing accelerators for an Amazon Web Services
1814
+ # account.
1779
1815
  #
1780
1816
  # @option params [Integer] :max_results
1781
1817
  # The number of custom routing Global Accelerator objects that you want
@@ -1804,12 +1840,13 @@ module Aws::GlobalAccelerator
1804
1840
  # resp.accelerators #=> Array
1805
1841
  # resp.accelerators[0].accelerator_arn #=> String
1806
1842
  # resp.accelerators[0].name #=> String
1807
- # resp.accelerators[0].ip_address_type #=> String, one of "IPV4"
1843
+ # resp.accelerators[0].ip_address_type #=> String, one of "IPV4", "DUAL_STACK"
1808
1844
  # resp.accelerators[0].enabled #=> Boolean
1809
1845
  # resp.accelerators[0].ip_sets #=> Array
1810
1846
  # resp.accelerators[0].ip_sets[0].ip_family #=> String
1811
1847
  # resp.accelerators[0].ip_sets[0].ip_addresses #=> Array
1812
1848
  # resp.accelerators[0].ip_sets[0].ip_addresses[0] #=> String
1849
+ # resp.accelerators[0].ip_sets[0].ip_address_family #=> String, one of "IPv4", "IPv6"
1813
1850
  # resp.accelerators[0].dns_name #=> String
1814
1851
  # resp.accelerators[0].status #=> String, one of "DEPLOYED", "IN_PROGRESS"
1815
1852
  # resp.accelerators[0].created_time #=> Time
@@ -2047,7 +2084,7 @@ module Aws::GlobalAccelerator
2047
2084
  # resp.destination_port_mappings[0].endpoint_group_region #=> String
2048
2085
  # resp.destination_port_mappings[0].destination_socket_address.ip_address #=> String
2049
2086
  # resp.destination_port_mappings[0].destination_socket_address.port #=> Integer
2050
- # resp.destination_port_mappings[0].ip_address_type #=> String, one of "IPV4"
2087
+ # resp.destination_port_mappings[0].ip_address_type #=> String, one of "IPV4", "DUAL_STACK"
2051
2088
  # resp.destination_port_mappings[0].destination_traffic_state #=> String, one of "ALLOW", "DENY"
2052
2089
  # resp.next_token #=> String
2053
2090
  #
@@ -2170,8 +2207,8 @@ module Aws::GlobalAccelerator
2170
2207
 
2171
2208
  # List all tags for an accelerator.
2172
2209
  #
2173
- # For more information, see [Tagging in AWS Global Accelerator][1] in
2174
- # the *AWS Global Accelerator Developer Guide*.
2210
+ # For more information, see [Tagging in Global Accelerator][1] in the
2211
+ # *Global Accelerator Developer Guide*.
2175
2212
  #
2176
2213
  #
2177
2214
  #
@@ -2206,13 +2243,13 @@ module Aws::GlobalAccelerator
2206
2243
  req.send_request(options)
2207
2244
  end
2208
2245
 
2209
- # Provisions an IP address range to use with your AWS resources through
2210
- # bring your own IP addresses (BYOIP) and creates a corresponding
2211
- # address pool. After the address range is provisioned, it is ready to
2212
- # be advertised using [ AdvertiseByoipCidr][1].
2246
+ # Provisions an IP address range to use with your Amazon Web Services
2247
+ # resources through bring your own IP addresses (BYOIP) and creates a
2248
+ # corresponding address pool. After the address range is provisioned, it
2249
+ # is ready to be advertised using [ AdvertiseByoipCidr][1].
2213
2250
  #
2214
- # For more information, see [Bring Your Own IP Addresses (BYOIP)][2] in
2215
- # the *AWS Global Accelerator Developer Guide*.
2251
+ # For more information, see [Bring your own IP addresses (BYOIP)][2] in
2252
+ # the *Global Accelerator Developer Guide*.
2216
2253
  #
2217
2254
  #
2218
2255
  #
@@ -2290,8 +2327,8 @@ module Aws::GlobalAccelerator
2290
2327
 
2291
2328
  # Add tags to an accelerator resource.
2292
2329
  #
2293
- # For more information, see [Tagging in AWS Global Accelerator][1] in
2294
- # the *AWS Global Accelerator Developer Guide*.
2330
+ # For more information, see [Tagging in Global Accelerator][1] in the
2331
+ # *Global Accelerator Developer Guide*.
2295
2332
  #
2296
2333
  #
2297
2334
  #
@@ -2333,8 +2370,8 @@ module Aws::GlobalAccelerator
2333
2370
  # operation succeeds even if you attempt to remove tags from an
2334
2371
  # accelerator that was already removed.
2335
2372
  #
2336
- # For more information, see [Tagging in AWS Global Accelerator][1] in
2337
- # the *AWS Global Accelerator Developer Guide*.
2373
+ # For more information, see [Tagging in Global Accelerator][1] in the
2374
+ # *Global Accelerator Developer Guide*.
2338
2375
  #
2339
2376
  #
2340
2377
  #
@@ -2369,19 +2406,22 @@ module Aws::GlobalAccelerator
2369
2406
  # Update an accelerator.
2370
2407
  #
2371
2408
  # Global Accelerator is a global service that supports endpoints in
2372
- # multiple AWS Regions but you must specify the US West (Oregon) Region
2373
- # to create or update accelerators.
2409
+ # multiple Amazon Web Services Regions but you must specify the US West
2410
+ # (Oregon) Region to create, update, or otherwise work with
2411
+ # accelerators. That is, for example, specify `--region us-west-2` on
2412
+ # AWS CLI commands.
2374
2413
  #
2375
2414
  # @option params [required, String] :accelerator_arn
2376
2415
  # The Amazon Resource Name (ARN) of the accelerator to update.
2377
2416
  #
2378
2417
  # @option params [String] :name
2379
- # The name of the accelerator. The name can have a maximum of 32
2380
- # characters, must contain only alphanumeric characters or hyphens (-),
2381
- # and must not begin or end with a hyphen.
2418
+ # The name of the accelerator. The name can have a maximum of 64
2419
+ # characters, must contain only alphanumeric characters, periods (.), or
2420
+ # hyphens (-), and must not begin or end with a hyphen or period.
2382
2421
  #
2383
2422
  # @option params [String] :ip_address_type
2384
- # The IP address type, which must be IPv4.
2423
+ # The IP address type that an accelerator supports. For a standard
2424
+ # accelerator, the value can be IPV4 or DUAL\_STACK.
2385
2425
  #
2386
2426
  # @option params [Boolean] :enabled
2387
2427
  # Indicates whether an accelerator is enabled. The value is true or
@@ -2399,7 +2439,7 @@ module Aws::GlobalAccelerator
2399
2439
  # resp = client.update_accelerator({
2400
2440
  # accelerator_arn: "GenericString", # required
2401
2441
  # name: "GenericString",
2402
- # ip_address_type: "IPV4", # accepts IPV4
2442
+ # ip_address_type: "IPV4", # accepts IPV4, DUAL_STACK
2403
2443
  # enabled: false,
2404
2444
  # })
2405
2445
  #
@@ -2407,16 +2447,21 @@ module Aws::GlobalAccelerator
2407
2447
  #
2408
2448
  # resp.accelerator.accelerator_arn #=> String
2409
2449
  # resp.accelerator.name #=> String
2410
- # resp.accelerator.ip_address_type #=> String, one of "IPV4"
2450
+ # resp.accelerator.ip_address_type #=> String, one of "IPV4", "DUAL_STACK"
2411
2451
  # resp.accelerator.enabled #=> Boolean
2412
2452
  # resp.accelerator.ip_sets #=> Array
2413
2453
  # resp.accelerator.ip_sets[0].ip_family #=> String
2414
2454
  # resp.accelerator.ip_sets[0].ip_addresses #=> Array
2415
2455
  # resp.accelerator.ip_sets[0].ip_addresses[0] #=> String
2456
+ # resp.accelerator.ip_sets[0].ip_address_family #=> String, one of "IPv4", "IPv6"
2416
2457
  # resp.accelerator.dns_name #=> String
2417
2458
  # resp.accelerator.status #=> String, one of "DEPLOYED", "IN_PROGRESS"
2418
2459
  # resp.accelerator.created_time #=> Time
2419
2460
  # resp.accelerator.last_modified_time #=> Time
2461
+ # resp.accelerator.dual_stack_dns_name #=> String
2462
+ # resp.accelerator.events #=> Array
2463
+ # resp.accelerator.events[0].message #=> String
2464
+ # resp.accelerator.events[0].timestamp #=> Time
2420
2465
  #
2421
2466
  # @see http://docs.aws.amazon.com/goto/WebAPI/globalaccelerator-2018-08-08/UpdateAccelerator AWS API Documentation
2422
2467
  #
@@ -2438,8 +2483,8 @@ module Aws::GlobalAccelerator
2438
2483
  # the value is true, `FlowLogsS3Bucket` and `FlowLogsS3Prefix` must be
2439
2484
  # specified.
2440
2485
  #
2441
- # For more information, see [Flow Logs][1] in the *AWS Global
2442
- # Accelerator Developer Guide*.
2486
+ # For more information, see [Flow Logs][1] in the *Global Accelerator
2487
+ # Developer Guide*.
2443
2488
  #
2444
2489
  #
2445
2490
  #
@@ -2448,17 +2493,15 @@ module Aws::GlobalAccelerator
2448
2493
  # @option params [String] :flow_logs_s3_bucket
2449
2494
  # The name of the Amazon S3 bucket for the flow logs. Attribute is
2450
2495
  # required if `FlowLogsEnabled` is `true`. The bucket must exist and
2451
- # have a bucket policy that grants AWS Global Accelerator permission to
2496
+ # have a bucket policy that grants Global Accelerator permission to
2452
2497
  # write to the bucket.
2453
2498
  #
2454
2499
  # @option params [String] :flow_logs_s3_prefix
2455
2500
  # Update the prefix for the location in the Amazon S3 bucket for the
2456
2501
  # flow logs. Attribute is required if `FlowLogsEnabled` is `true`.
2457
2502
  #
2458
- # If you don’t specify a prefix, the flow logs are stored in the root of
2459
- # the bucket. If you specify slash (/) for the S3 bucket prefix, the log
2460
- # file bucket folder structure will include a double slash (//), like
2461
- # the following:
2503
+ # If you specify slash (/) for the S3 bucket prefix, the log file bucket
2504
+ # folder structure will include a double slash (//), like the following:
2462
2505
  #
2463
2506
  # s3-bucket\_name//AWSLogs/aws\_account\_id
2464
2507
  #
@@ -2496,12 +2539,13 @@ module Aws::GlobalAccelerator
2496
2539
  # The Amazon Resource Name (ARN) of the accelerator to update.
2497
2540
  #
2498
2541
  # @option params [String] :name
2499
- # The name of the accelerator. The name can have a maximum of 32
2500
- # characters, must contain only alphanumeric characters or hyphens (-),
2501
- # and must not begin or end with a hyphen.
2542
+ # The name of the accelerator. The name can have a maximum of 64
2543
+ # characters, must contain only alphanumeric characters, periods (.), or
2544
+ # hyphens (-), and must not begin or end with a hyphen or period.
2502
2545
  #
2503
2546
  # @option params [String] :ip_address_type
2504
- # The value for the address type must be IPv4.
2547
+ # The IP address type that an accelerator supports. For a custom routing
2548
+ # accelerator, the value must be IPV4.
2505
2549
  #
2506
2550
  # @option params [Boolean] :enabled
2507
2551
  # Indicates whether an accelerator is enabled. The value is true or
@@ -2519,7 +2563,7 @@ module Aws::GlobalAccelerator
2519
2563
  # resp = client.update_custom_routing_accelerator({
2520
2564
  # accelerator_arn: "GenericString", # required
2521
2565
  # name: "GenericString",
2522
- # ip_address_type: "IPV4", # accepts IPV4
2566
+ # ip_address_type: "IPV4", # accepts IPV4, DUAL_STACK
2523
2567
  # enabled: false,
2524
2568
  # })
2525
2569
  #
@@ -2527,12 +2571,13 @@ module Aws::GlobalAccelerator
2527
2571
  #
2528
2572
  # resp.accelerator.accelerator_arn #=> String
2529
2573
  # resp.accelerator.name #=> String
2530
- # resp.accelerator.ip_address_type #=> String, one of "IPV4"
2574
+ # resp.accelerator.ip_address_type #=> String, one of "IPV4", "DUAL_STACK"
2531
2575
  # resp.accelerator.enabled #=> Boolean
2532
2576
  # resp.accelerator.ip_sets #=> Array
2533
2577
  # resp.accelerator.ip_sets[0].ip_family #=> String
2534
2578
  # resp.accelerator.ip_sets[0].ip_addresses #=> Array
2535
2579
  # resp.accelerator.ip_sets[0].ip_addresses[0] #=> String
2580
+ # resp.accelerator.ip_sets[0].ip_address_family #=> String, one of "IPv4", "IPv6"
2536
2581
  # resp.accelerator.dns_name #=> String
2537
2582
  # resp.accelerator.status #=> String, one of "DEPLOYED", "IN_PROGRESS"
2538
2583
  # resp.accelerator.created_time #=> Time
@@ -2558,8 +2603,8 @@ module Aws::GlobalAccelerator
2558
2603
  # the value is true, `FlowLogsS3Bucket` and `FlowLogsS3Prefix` must be
2559
2604
  # specified.
2560
2605
  #
2561
- # For more information, see [Flow Logs][1] in the *AWS Global
2562
- # Accelerator Developer Guide*.
2606
+ # For more information, see [Flow logs][1] in the *Global Accelerator
2607
+ # Developer Guide*.
2563
2608
  #
2564
2609
  #
2565
2610
  #
@@ -2568,7 +2613,7 @@ module Aws::GlobalAccelerator
2568
2613
  # @option params [String] :flow_logs_s3_bucket
2569
2614
  # The name of the Amazon S3 bucket for the flow logs. Attribute is
2570
2615
  # required if `FlowLogsEnabled` is `true`. The bucket must exist and
2571
- # have a bucket policy that grants AWS Global Accelerator permission to
2616
+ # have a bucket policy that grants Global Accelerator permission to
2572
2617
  # write to the bucket.
2573
2618
  #
2574
2619
  # @option params [String] :flow_logs_s3_prefix
@@ -2670,8 +2715,9 @@ module Aws::GlobalAccelerator
2670
2715
  # you add it as an endpoint.
2671
2716
  #
2672
2717
  # @option params [Float] :traffic_dial_percentage
2673
- # The percentage of traffic to send to an AWS Region. Additional traffic
2674
- # is distributed to other endpoint groups for this listener.
2718
+ # The percentage of traffic to send to an Amazon Web Services Region.
2719
+ # Additional traffic is distributed to other endpoint groups for this
2720
+ # listener.
2675
2721
  #
2676
2722
  # Use this action to increase (dial up) or decrease (dial down) traffic
2677
2723
  # to a specific Region. The percentage is applied to the traffic that
@@ -2681,14 +2727,14 @@ module Aws::GlobalAccelerator
2681
2727
  # The default value is 100.
2682
2728
  #
2683
2729
  # @option params [Integer] :health_check_port
2684
- # The port that AWS Global Accelerator uses to check the health of
2685
- # endpoints that are part of this endpoint group. The default port is
2686
- # the listener port that this endpoint group is associated with. If the
2687
- # listener port is a list of ports, Global Accelerator uses the first
2688
- # port in the list.
2730
+ # The port that Global Accelerator uses to check the health of endpoints
2731
+ # that are part of this endpoint group. The default port is the listener
2732
+ # port that this endpoint group is associated with. If the listener port
2733
+ # is a list of ports, Global Accelerator uses the first port in the
2734
+ # list.
2689
2735
  #
2690
2736
  # @option params [String] :health_check_protocol
2691
- # The protocol that AWS Global Accelerator uses to check the health of
2737
+ # The protocol that Global Accelerator uses to check the health of
2692
2738
  # endpoints that are part of this endpoint group. The default value is
2693
2739
  # TCP.
2694
2740
  #
@@ -2712,8 +2758,8 @@ module Aws::GlobalAccelerator
2712
2758
  # and 443, but your accelerator routes that traffic to ports 1080 and
2713
2759
  # 1443, respectively, on the endpoints.
2714
2760
  #
2715
- # For more information, see [ Port overrides][1] in the *AWS Global
2716
- # Accelerator Developer Guide*.
2761
+ # For more information, see [ Overriding listener ports][1] in the
2762
+ # *Global Accelerator Developer Guide*.
2717
2763
  #
2718
2764
  #
2719
2765
  #
@@ -2797,15 +2843,14 @@ module Aws::GlobalAccelerator
2797
2843
  # over whether to always route each client to the same specific
2798
2844
  # endpoint.
2799
2845
  #
2800
- # AWS Global Accelerator uses a consistent-flow hashing algorithm to
2801
- # choose the optimal endpoint for a connection. If client affinity is
2802
- # `NONE`, Global Accelerator uses the "five-tuple" (5-tuple)
2803
- # properties—source IP address, source port, destination IP address,
2804
- # destination port, and protocol—to select the hash value, and then
2805
- # chooses the best endpoint. However, with this setting, if someone uses
2806
- # different ports to connect to Global Accelerator, their connections
2807
- # might not be always routed to the same endpoint because the hash value
2808
- # changes.
2846
+ # Global Accelerator uses a consistent-flow hashing algorithm to choose
2847
+ # the optimal endpoint for a connection. If client affinity is `NONE`,
2848
+ # Global Accelerator uses the "five-tuple" (5-tuple) properties—source
2849
+ # IP address, source port, destination IP address, destination port, and
2850
+ # protocol—to select the hash value, and then chooses the best endpoint.
2851
+ # However, with this setting, if someone uses different ports to connect
2852
+ # to Global Accelerator, their connections might not be always routed to
2853
+ # the same endpoint because the hash value changes.
2809
2854
  #
2810
2855
  # If you want a given client to always be routed to the same endpoint,
2811
2856
  # set client affinity to `SOURCE_IP` instead. When you use the
@@ -2856,10 +2901,10 @@ module Aws::GlobalAccelerator
2856
2901
  # even if you specify different address ranges each time.
2857
2902
  #
2858
2903
  # It can take a few minutes before traffic to the specified addresses
2859
- # stops routing to AWS because of propagation delays.
2904
+ # stops routing to Amazon Web Services because of propagation delays.
2860
2905
  #
2861
- # For more information, see [Bring Your Own IP Addresses (BYOIP)][1] in
2862
- # the *AWS Global Accelerator Developer Guide*.
2906
+ # For more information, see [Bring your own IP addresses (BYOIP)][1] in
2907
+ # the *Global Accelerator Developer Guide*.
2863
2908
  #
2864
2909
  #
2865
2910
  #
@@ -2908,7 +2953,7 @@ module Aws::GlobalAccelerator
2908
2953
  params: params,
2909
2954
  config: config)
2910
2955
  context[:gem_name] = 'aws-sdk-globalaccelerator'
2911
- context[:gem_version] = '1.39.0'
2956
+ context[:gem_version] = '1.40.0'
2912
2957
  Seahorse::Client::Request.new(handlers, context)
2913
2958
  end
2914
2959