aws-sdk-globalaccelerator 1.39.0 → 1.40.0

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