aws-sdk-arczonalshift 1.10.0 → 1.11.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: e5c5c2bc01ad89056247802472e08540b28a55662f503df98b1a02f4ea037454
4
- data.tar.gz: '00285ead7294b67f14c8f02fa472e5fb4b577606b0606c16516ff1edc35da68a'
3
+ metadata.gz: c9cd36f48a1de32de00bdc151264f918c934f353aab359149d163adb9f69d36d
4
+ data.tar.gz: 1b6a955b6a32764849561d3e165a6151d95d87757ddcdb88a8cc1d4f46554359
5
5
  SHA512:
6
- metadata.gz: 75419befdbef36affa425c2cba15929af0b73979e2596c275064b48963b6cad56f577e43e60221a6587baecf5926eb0cf4ed9b5e10e0869adc20aaba72d91e29
7
- data.tar.gz: 58fc7e0231aac098fca88cd280fc855f324a9dc0603903c51244a98b66539780491e8af24703d950e3ecb3221affbeeb3389e988da4b5dbed865fd078cf8efd7
6
+ metadata.gz: c9694f178e20e0dd279006d4f295fab8226922bf931c3c3baf6fecd769349f4a5ac8d923ba01f224bcb24850baee978eec133b9b08b3c57dff252d879aa1f36e
7
+ data.tar.gz: 02cf80294eb73695ea39ebf84f354fb76d619bba0e6e4cd9107b0ed69a079e840b4e1aab8233881de226ef9b65d3a0937e4e85840db45d2ec640962fa0b25431
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.11.0 (2023-11-30)
5
+ ------------------
6
+
7
+ * Feature - This release adds a new capability, zonal autoshift. You can configure zonal autoshift so that AWS shifts traffic for a resource away from an Availability Zone, on your behalf, when AWS determines that there is an issue that could potentially affect customers in the Availability Zone.
8
+
4
9
  1.10.0 (2023-11-28)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.10.0
1
+ 1.11.0
@@ -389,8 +389,11 @@ module Aws::ARCZonalShift
389
389
  # @!group API Operations
390
390
 
391
391
  # Cancel a zonal shift in Amazon Route 53 Application Recovery
392
- # Controller that you've started for a resource in your AWS account in
393
- # an AWS Region.
392
+ # Controller. To cancel the zonal shift, specify the zonal shift ID.
393
+ #
394
+ # A zonal shift can be one that you've started for a resource in your
395
+ # Amazon Web Services account in an Amazon Web Services Region, or it
396
+ # can be a zonal shift started by a practice run with zonal autoshift.
394
397
  #
395
398
  # @option params [required, String] :zonal_shift_id
396
399
  # The internally-generated identifier of a zonal shift.
@@ -430,28 +433,189 @@ module Aws::ARCZonalShift
430
433
  req.send_request(options)
431
434
  end
432
435
 
436
+ # A practice run configuration for zonal autoshift is required when you
437
+ # enable zonal autoshift. A practice run configuration includes
438
+ # specifications for blocked dates and blocked time windows, and for
439
+ # Amazon CloudWatch alarms that you create to use with practice runs.
440
+ # The alarms that you specify are an *outcome alarm*, to monitor
441
+ # application health during practice runs and, optionally, a *blocking
442
+ # alarm*, to block practice runs from starting.
443
+ #
444
+ # For more information, see [ Considerations when you configure zonal
445
+ # autoshift][1] in the Amazon Route 53 Application Recovery Controller
446
+ # Developer Guide.
447
+ #
448
+ #
449
+ #
450
+ # [1]: https://docs.aws.amazon.com/r53recovery/latest/dg/arc-zonal-autoshift.considerations.html
451
+ #
452
+ # @option params [Array<String>] :blocked_dates
453
+ # Optionally, you can block Route 53 ARC from starting practice runs for
454
+ # a resource on specific calendar dates.
455
+ #
456
+ # The format for blocked dates is: YYYY-MM-DD. Keep in mind, when you
457
+ # specify dates, that dates and times for practice runs are in UTC.
458
+ # Separate multiple blocked dates with spaces.
459
+ #
460
+ # For example, if you have an application update scheduled to launch on
461
+ # May 1, 2024, and you don't want practice runs to shift traffic away
462
+ # at that time, you could set a blocked date for `2024-05-01`.
463
+ #
464
+ # @option params [Array<String>] :blocked_windows
465
+ # Optionally, you can block Route 53 ARC from starting practice runs for
466
+ # specific windows of days and times.
467
+ #
468
+ # The format for blocked windows is: DAY:HH:SS-DAY:HH:SS. Keep in mind,
469
+ # when you specify dates, that dates and times for practice runs are in
470
+ # UTC. Also, be aware of potential time adjustments that might be
471
+ # required for daylight saving time differences. Separate multiple
472
+ # blocked windows with spaces.
473
+ #
474
+ # For example, say you run business report summaries three days a week.
475
+ # For this scenario, you might set the following recurring days and
476
+ # times as blocked windows, for example: `MON-20:30-21:30
477
+ # WED-20:30-21:30 FRI-20:30-21:30`.
478
+ #
479
+ # @option params [Array<Types::ControlCondition>] :blocking_alarms
480
+ # An Amazon CloudWatch alarm that you can specify for zonal autoshift
481
+ # practice runs. This alarm blocks Route 53 ARC from starting practice
482
+ # run zonal shifts, and ends a practice run that's in progress, when
483
+ # the alarm is in an `ALARM` state.
484
+ #
485
+ # @option params [required, Array<Types::ControlCondition>] :outcome_alarms
486
+ # The *outcome alarm* for practice runs is a required Amazon CloudWatch
487
+ # alarm that you specify that ends a practice run when the alarm is in
488
+ # an `ALARM` state.
489
+ #
490
+ # Configure the alarm to monitor the health of your application when
491
+ # traffic is shifted away from an Availability Zone during each weekly
492
+ # practice run. You should configure the alarm to go into an `ALARM`
493
+ # state if your application is impacted by the zonal shift, and you want
494
+ # to stop the zonal shift, to let traffic for the resource return to the
495
+ # Availability Zone.
496
+ #
497
+ # @option params [required, String] :resource_identifier
498
+ # The identifier of the resource to shift away traffic for when a
499
+ # practice run starts a zonal shift. The identifier is the Amazon
500
+ # Resource Name (ARN) for the resource.
501
+ #
502
+ # At this time, supported resources are Network Load Balancers and
503
+ # Application Load Balancers with cross-zone load balancing turned off.
504
+ #
505
+ # @return [Types::CreatePracticeRunConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
506
+ #
507
+ # * {Types::CreatePracticeRunConfigurationResponse#arn #arn} => String
508
+ # * {Types::CreatePracticeRunConfigurationResponse#name #name} => String
509
+ # * {Types::CreatePracticeRunConfigurationResponse#practice_run_configuration #practice_run_configuration} => Types::PracticeRunConfiguration
510
+ # * {Types::CreatePracticeRunConfigurationResponse#zonal_autoshift_status #zonal_autoshift_status} => String
511
+ #
512
+ # @example Request syntax with placeholder values
513
+ #
514
+ # resp = client.create_practice_run_configuration({
515
+ # blocked_dates: ["BlockedDate"],
516
+ # blocked_windows: ["BlockedWindow"],
517
+ # blocking_alarms: [
518
+ # {
519
+ # alarm_identifier: "ResourceArn", # required
520
+ # type: "CLOUDWATCH", # required, accepts CLOUDWATCH
521
+ # },
522
+ # ],
523
+ # outcome_alarms: [ # required
524
+ # {
525
+ # alarm_identifier: "ResourceArn", # required
526
+ # type: "CLOUDWATCH", # required, accepts CLOUDWATCH
527
+ # },
528
+ # ],
529
+ # resource_identifier: "ResourceIdentifier", # required
530
+ # })
531
+ #
532
+ # @example Response structure
533
+ #
534
+ # resp.arn #=> String
535
+ # resp.name #=> String
536
+ # resp.practice_run_configuration.blocked_dates #=> Array
537
+ # resp.practice_run_configuration.blocked_dates[0] #=> String
538
+ # resp.practice_run_configuration.blocked_windows #=> Array
539
+ # resp.practice_run_configuration.blocked_windows[0] #=> String
540
+ # resp.practice_run_configuration.blocking_alarms #=> Array
541
+ # resp.practice_run_configuration.blocking_alarms[0].alarm_identifier #=> String
542
+ # resp.practice_run_configuration.blocking_alarms[0].type #=> String, one of "CLOUDWATCH"
543
+ # resp.practice_run_configuration.outcome_alarms #=> Array
544
+ # resp.practice_run_configuration.outcome_alarms[0].alarm_identifier #=> String
545
+ # resp.practice_run_configuration.outcome_alarms[0].type #=> String, one of "CLOUDWATCH"
546
+ # resp.zonal_autoshift_status #=> String, one of "ENABLED", "DISABLED"
547
+ #
548
+ # @see http://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/CreatePracticeRunConfiguration AWS API Documentation
549
+ #
550
+ # @overload create_practice_run_configuration(params = {})
551
+ # @param [Hash] params ({})
552
+ def create_practice_run_configuration(params = {}, options = {})
553
+ req = build_request(:create_practice_run_configuration, params)
554
+ req.send_request(options)
555
+ end
556
+
557
+ # Deletes the practice run configuration for a resource. Before you can
558
+ # delete a practice run configuration for a resource., you must disable
559
+ # zonal autoshift for the resource. Practice runs must be configured for
560
+ # zonal autoshift to be enabled.
561
+ #
562
+ # @option params [required, String] :resource_identifier
563
+ # The identifier for the resource that you want to delete the practice
564
+ # run configuration for. The identifier is the Amazon Resource Name
565
+ # (ARN) for the resource.
566
+ #
567
+ # @return [Types::DeletePracticeRunConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
568
+ #
569
+ # * {Types::DeletePracticeRunConfigurationResponse#arn #arn} => String
570
+ # * {Types::DeletePracticeRunConfigurationResponse#name #name} => String
571
+ # * {Types::DeletePracticeRunConfigurationResponse#zonal_autoshift_status #zonal_autoshift_status} => String
572
+ #
573
+ # @example Request syntax with placeholder values
574
+ #
575
+ # resp = client.delete_practice_run_configuration({
576
+ # resource_identifier: "ResourceIdentifier", # required
577
+ # })
578
+ #
579
+ # @example Response structure
580
+ #
581
+ # resp.arn #=> String
582
+ # resp.name #=> String
583
+ # resp.zonal_autoshift_status #=> String, one of "ENABLED", "DISABLED"
584
+ #
585
+ # @see http://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/DeletePracticeRunConfiguration AWS API Documentation
586
+ #
587
+ # @overload delete_practice_run_configuration(params = {})
588
+ # @param [Hash] params ({})
589
+ def delete_practice_run_configuration(params = {}, options = {})
590
+ req = build_request(:delete_practice_run_configuration, params)
591
+ req.send_request(options)
592
+ end
593
+
433
594
  # Get information about a resource that's been registered for zonal
434
595
  # shifts with Amazon Route 53 Application Recovery Controller in this
435
- # AWS Region. Resources that are registered for zonal shifts are managed
436
- # resources in Route 53 ARC.
596
+ # Amazon Web Services Region. Resources that are registered for zonal
597
+ # shifts are managed resources in Route 53 ARC. You can start zonal
598
+ # shifts and configure zonal autoshift for managed resources.
437
599
  #
438
- # At this time, you can only start a zonal shift for Network Load
439
- # Balancers and Application Load Balancers with cross-zone load
440
- # balancing turned off.
600
+ # At this time, you can only start a zonal shift or configure zonal
601
+ # autoshift for Network Load Balancers and Application Load Balancers
602
+ # with cross-zone load balancing turned off.
441
603
  #
442
604
  # @option params [required, String] :resource_identifier
443
- # The identifier for the resource to include in a zonal shift. The
605
+ # The identifier for the resource to shift away traffic for. The
444
606
  # identifier is the Amazon Resource Name (ARN) for the resource.
445
607
  #
446
- # At this time, you can only start a zonal shift for Network Load
447
- # Balancers and Application Load Balancers with cross-zone load
448
- # balancing turned off.
608
+ # At this time, supported resources are Network Load Balancers and
609
+ # Application Load Balancers with cross-zone load balancing turned off.
449
610
  #
450
611
  # @return [Types::GetManagedResourceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
451
612
  #
452
613
  # * {Types::GetManagedResourceResponse#applied_weights #applied_weights} => Hash&lt;String,Float&gt;
453
614
  # * {Types::GetManagedResourceResponse#arn #arn} => String
615
+ # * {Types::GetManagedResourceResponse#autoshifts #autoshifts} => Array&lt;Types::AutoshiftInResource&gt;
454
616
  # * {Types::GetManagedResourceResponse#name #name} => String
617
+ # * {Types::GetManagedResourceResponse#practice_run_configuration #practice_run_configuration} => Types::PracticeRunConfiguration
618
+ # * {Types::GetManagedResourceResponse#zonal_autoshift_status #zonal_autoshift_status} => String
455
619
  # * {Types::GetManagedResourceResponse#zonal_shifts #zonal_shifts} => Array&lt;Types::ZonalShiftInResource&gt;
456
620
  #
457
621
  # @example Request syntax with placeholder values
@@ -465,12 +629,28 @@ module Aws::ARCZonalShift
465
629
  # resp.applied_weights #=> Hash
466
630
  # resp.applied_weights["AvailabilityZone"] #=> Float
467
631
  # resp.arn #=> String
632
+ # resp.autoshifts #=> Array
633
+ # resp.autoshifts[0].applied_status #=> String, one of "APPLIED", "NOT_APPLIED"
634
+ # resp.autoshifts[0].away_from #=> String
635
+ # resp.autoshifts[0].start_time #=> Time
468
636
  # resp.name #=> String
637
+ # resp.practice_run_configuration.blocked_dates #=> Array
638
+ # resp.practice_run_configuration.blocked_dates[0] #=> String
639
+ # resp.practice_run_configuration.blocked_windows #=> Array
640
+ # resp.practice_run_configuration.blocked_windows[0] #=> String
641
+ # resp.practice_run_configuration.blocking_alarms #=> Array
642
+ # resp.practice_run_configuration.blocking_alarms[0].alarm_identifier #=> String
643
+ # resp.practice_run_configuration.blocking_alarms[0].type #=> String, one of "CLOUDWATCH"
644
+ # resp.practice_run_configuration.outcome_alarms #=> Array
645
+ # resp.practice_run_configuration.outcome_alarms[0].alarm_identifier #=> String
646
+ # resp.practice_run_configuration.outcome_alarms[0].type #=> String, one of "CLOUDWATCH"
647
+ # resp.zonal_autoshift_status #=> String, one of "ENABLED", "DISABLED"
469
648
  # resp.zonal_shifts #=> Array
470
649
  # resp.zonal_shifts[0].applied_status #=> String, one of "APPLIED", "NOT_APPLIED"
471
650
  # resp.zonal_shifts[0].away_from #=> String
472
651
  # resp.zonal_shifts[0].comment #=> String
473
652
  # resp.zonal_shifts[0].expiry_time #=> Time
653
+ # resp.zonal_shifts[0].practice_run_outcome #=> String, one of "FAILED", "INTERRUPTED", "PENDING", "SUCCEEDED"
474
654
  # resp.zonal_shifts[0].resource_identifier #=> String
475
655
  # resp.zonal_shifts[0].start_time #=> Time
476
656
  # resp.zonal_shifts[0].zonal_shift_id #=> String
@@ -484,11 +664,60 @@ module Aws::ARCZonalShift
484
664
  req.send_request(options)
485
665
  end
486
666
 
487
- # Lists all the resources in your AWS account in this AWS Region that
488
- # are managed for zonal shifts in Amazon Route 53 Application Recovery
489
- # Controller, and information about them. The information includes their
490
- # Amazon Resource Names (ARNs), the Availability Zones the resources are
491
- # deployed in, and the resource name.
667
+ # Returns the active autoshifts for a specified resource.
668
+ #
669
+ # @option params [Integer] :max_results
670
+ # The number of objects that you want to return with this call.
671
+ #
672
+ # @option params [String] :next_token
673
+ # Specifies that you want to receive the next page of results. Valid
674
+ # only if you received a `NextToken` response in the previous request.
675
+ # If you did, it indicates that more output is available. Set this
676
+ # parameter to the value provided by the previous call's `NextToken`
677
+ # response to request the next page of results.
678
+ #
679
+ # @option params [String] :status
680
+ # The status of the autoshift.
681
+ #
682
+ # @return [Types::ListAutoshiftsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
683
+ #
684
+ # * {Types::ListAutoshiftsResponse#items #items} => Array&lt;Types::AutoshiftSummary&gt;
685
+ # * {Types::ListAutoshiftsResponse#next_token #next_token} => String
686
+ #
687
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
688
+ #
689
+ # @example Request syntax with placeholder values
690
+ #
691
+ # resp = client.list_autoshifts({
692
+ # max_results: 1,
693
+ # next_token: "String",
694
+ # status: "ACTIVE", # accepts ACTIVE, COMPLETED
695
+ # })
696
+ #
697
+ # @example Response structure
698
+ #
699
+ # resp.items #=> Array
700
+ # resp.items[0].away_from #=> String
701
+ # resp.items[0].end_time #=> Time
702
+ # resp.items[0].start_time #=> Time
703
+ # resp.items[0].status #=> String, one of "ACTIVE", "COMPLETED"
704
+ # resp.next_token #=> String
705
+ #
706
+ # @see http://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/ListAutoshifts AWS API Documentation
707
+ #
708
+ # @overload list_autoshifts(params = {})
709
+ # @param [Hash] params ({})
710
+ def list_autoshifts(params = {}, options = {})
711
+ req = build_request(:list_autoshifts, params)
712
+ req.send_request(options)
713
+ end
714
+
715
+ # Lists all the resources in your Amazon Web Services account in this
716
+ # Amazon Web Services Region that are managed for zonal shifts in Amazon
717
+ # Route 53 Application Recovery Controller, and information about them.
718
+ # The information includes the zonal autoshift status for the resource,
719
+ # as well as the Amazon Resource Name (ARN), the Availability Zones that
720
+ # each resource is deployed in, and the resource name.
492
721
  #
493
722
  # @option params [Integer] :max_results
494
723
  # The number of objects that you want to return with this call.
@@ -517,10 +746,27 @@ module Aws::ARCZonalShift
517
746
  # @example Response structure
518
747
  #
519
748
  # resp.items #=> Array
749
+ # resp.items[0].applied_weights #=> Hash
750
+ # resp.items[0].applied_weights["AvailabilityZone"] #=> Float
520
751
  # resp.items[0].arn #=> String
752
+ # resp.items[0].autoshifts #=> Array
753
+ # resp.items[0].autoshifts[0].applied_status #=> String, one of "APPLIED", "NOT_APPLIED"
754
+ # resp.items[0].autoshifts[0].away_from #=> String
755
+ # resp.items[0].autoshifts[0].start_time #=> Time
521
756
  # resp.items[0].availability_zones #=> Array
522
757
  # resp.items[0].availability_zones[0] #=> String
523
758
  # resp.items[0].name #=> String
759
+ # resp.items[0].practice_run_status #=> String, one of "ENABLED", "DISABLED"
760
+ # resp.items[0].zonal_autoshift_status #=> String, one of "ENABLED", "DISABLED"
761
+ # resp.items[0].zonal_shifts #=> Array
762
+ # resp.items[0].zonal_shifts[0].applied_status #=> String, one of "APPLIED", "NOT_APPLIED"
763
+ # resp.items[0].zonal_shifts[0].away_from #=> String
764
+ # resp.items[0].zonal_shifts[0].comment #=> String
765
+ # resp.items[0].zonal_shifts[0].expiry_time #=> Time
766
+ # resp.items[0].zonal_shifts[0].practice_run_outcome #=> String, one of "FAILED", "INTERRUPTED", "PENDING", "SUCCEEDED"
767
+ # resp.items[0].zonal_shifts[0].resource_identifier #=> String
768
+ # resp.items[0].zonal_shifts[0].start_time #=> Time
769
+ # resp.items[0].zonal_shifts[0].zonal_shift_id #=> String
524
770
  # resp.next_token #=> String
525
771
  #
526
772
  # @see http://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/ListManagedResources AWS API Documentation
@@ -532,8 +778,18 @@ module Aws::ARCZonalShift
532
778
  req.send_request(options)
533
779
  end
534
780
 
535
- # Lists all the active zonal shifts in Amazon Route 53 Application
536
- # Recovery Controller in your AWS account in this AWS Region.
781
+ # Lists all active and completed zonal shifts in Amazon Route 53
782
+ # Application Recovery Controller in your Amazon Web Services account in
783
+ # this Amazon Web Services Region. `ListZonalShifts` returns
784
+ # customer-started zonal shifts, as well as practice run zonal shifts
785
+ # that Route 53 ARC started on your behalf for zonal autoshift.
786
+ #
787
+ # The `ListZonalShifts` operation does not list autoshifts. For more
788
+ # information about listing autoshifts, see ["&gt;ListAutoshifts][1].
789
+ #
790
+ #
791
+ #
792
+ # [1]: https://docs.aws.amazon.com/arc-zonal-shift/latest/api/API_ListAutoshifts.html
537
793
  #
538
794
  # @option params [Integer] :max_results
539
795
  # The number of objects that you want to return with this call.
@@ -545,12 +801,17 @@ module Aws::ARCZonalShift
545
801
  # parameter to the value provided by the previous call's `NextToken`
546
802
  # response to request the next page of results.
547
803
  #
804
+ # @option params [String] :resource_identifier
805
+ # The identifier for the resource that you want to list zonal shifts
806
+ # for. The identifier is the Amazon Resource Name (ARN) for the
807
+ # resource.
808
+ #
548
809
  # @option params [String] :status
549
810
  # A status for a zonal shift.
550
811
  #
551
812
  # The `Status` for a zonal shift can have one of the following values:
552
813
  #
553
- # * **ACTIVE**: The zonal shift is started and active.
814
+ # * **ACTIVE**: The zonal shift has been started and active.
554
815
  #
555
816
  # * **EXPIRED**: The zonal shift has expired (the expiry time was
556
817
  # exceeded).
@@ -569,6 +830,7 @@ module Aws::ARCZonalShift
569
830
  # resp = client.list_zonal_shifts({
570
831
  # max_results: 1,
571
832
  # next_token: "String",
833
+ # resource_identifier: "ResourceIdentifier",
572
834
  # status: "ACTIVE", # accepts ACTIVE, EXPIRED, CANCELED
573
835
  # })
574
836
  #
@@ -578,6 +840,7 @@ module Aws::ARCZonalShift
578
840
  # resp.items[0].away_from #=> String
579
841
  # resp.items[0].comment #=> String
580
842
  # resp.items[0].expiry_time #=> Time
843
+ # resp.items[0].practice_run_outcome #=> String, one of "FAILED", "INTERRUPTED", "PENDING", "SUCCEEDED"
581
844
  # resp.items[0].resource_identifier #=> String
582
845
  # resp.items[0].start_time #=> Time
583
846
  # resp.items[0].status #=> String, one of "ACTIVE", "EXPIRED", "CANCELED"
@@ -594,12 +857,13 @@ module Aws::ARCZonalShift
594
857
  end
595
858
 
596
859
  # You start a zonal shift to temporarily move load balancer traffic away
597
- # from an Availability Zone in a AWS Region, to help your application
598
- # recover immediately, for example, from a developer's bad code
599
- # deployment or from an AWS infrastructure failure in a single
600
- # Availability Zone. You can start a zonal shift in Route 53 ARC only
601
- # for managed resources in your account in an AWS Region. Resources are
602
- # automatically registered with Route 53 ARC by AWS services.
860
+ # from an Availability Zone in an Amazon Web Services Region, to help
861
+ # your application recover immediately, for example, from a developer's
862
+ # bad code deployment or from an Amazon Web Services infrastructure
863
+ # failure in a single Availability Zone. You can start a zonal shift in
864
+ # Route 53 ARC only for managed resources in your Amazon Web Services
865
+ # account in an Amazon Web Services Region. Resources are automatically
866
+ # registered with Route 53 ARC by Amazon Web Services services.
603
867
  #
604
868
  # At this time, you can only start a zonal shift for Network Load
605
869
  # Balancers and Application Load Balancers with cross-zone load
@@ -622,7 +886,7 @@ module Aws::ARCZonalShift
622
886
  # The Availability Zone that traffic is moved away from for a resource
623
887
  # when you start a zonal shift. Until the zonal shift expires or you
624
888
  # cancel it, traffic for the resource is instead moved to other
625
- # Availability Zones in the AWS Region.
889
+ # Availability Zones in the Amazon Web Services Region.
626
890
  #
627
891
  # @option params [required, String] :comment
628
892
  # A comment that you enter about the zonal shift. Only the latest
@@ -643,15 +907,19 @@ module Aws::ARCZonalShift
643
907
  # To set a length of time for a zonal shift to be active, specify a
644
908
  # whole number, and then one of the following, with no space:
645
909
  #
646
- # <ul> <li> <p> <b>A lowercase letter m:</b> To specify that the value is in minutes.</p> </li> <li> <p> <b>A lowercase letter h:</b> To specify that the value is in hours.</p> </li> </ul> <p>For example: <code>20h</code> means the zonal shift expires in 20 hours. <code>120m</code> means the zonal shift expires in 120 minutes (2 hours).</p>
910
+ # * **A lowercase letter m:** To specify that the value is in minutes.
911
+ #
912
+ # * **A lowercase letter h:** To specify that the value is in hours.
913
+ #
914
+ # For example: `20h` means the zonal shift expires in 20 hours. `120m`
915
+ # means the zonal shift expires in 120 minutes (2 hours).
647
916
  #
648
917
  # @option params [required, String] :resource_identifier
649
- # The identifier for the resource to include in a zonal shift. The
918
+ # The identifier for the resource to shift away traffic for. The
650
919
  # identifier is the Amazon Resource Name (ARN) for the resource.
651
920
  #
652
- # At this time, you can only start a zonal shift for Network Load
653
- # Balancers and Application Load Balancers with cross-zone load
654
- # balancing turned off.
921
+ # At this time, supported resources are Network Load Balancers and
922
+ # Application Load Balancers with cross-zone load balancing turned off.
655
923
  #
656
924
  # @return [Types::ZonalShift] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
657
925
  #
@@ -691,9 +959,151 @@ module Aws::ARCZonalShift
691
959
  req.send_request(options)
692
960
  end
693
961
 
962
+ # Update a practice run configuration to change one or more of the
963
+ # following: add, change, or remove the blocking alarm; change the
964
+ # outcome alarm; or add, change, or remove blocking dates or time
965
+ # windows.
966
+ #
967
+ # @option params [Array<String>] :blocked_dates
968
+ # Add, change, or remove blocked dates for a practice run in zonal
969
+ # autoshift.
970
+ #
971
+ # Optionally, you can block practice runs for specific calendar dates.
972
+ # The format for blocked dates is: YYYY-MM-DD. Keep in mind, when you
973
+ # specify dates, that dates and times for practice runs are in UTC.
974
+ # Separate multiple blocked dates with spaces.
975
+ #
976
+ # For example, if you have an application update scheduled to launch on
977
+ # May 1, 2024, and you don't want practice runs to shift traffic away
978
+ # at that time, you could set a blocked date for `2024-05-01`.
979
+ #
980
+ # @option params [Array<String>] :blocked_windows
981
+ # Add, change, or remove windows of days and times for when you can,
982
+ # optionally, block Route 53 ARC from starting a practice run for a
983
+ # resource.
984
+ #
985
+ # The format for blocked windows is: DAY:HH:SS-DAY:HH:SS. Keep in mind,
986
+ # when you specify dates, that dates and times for practice runs are in
987
+ # UTC. Also, be aware of potential time adjustments that might be
988
+ # required for daylight saving time differences. Separate multiple
989
+ # blocked windows with spaces.
990
+ #
991
+ # For example, say you run business report summaries three days a week.
992
+ # For this scenario, you might set the following recurring days and
993
+ # times as blocked windows, for example: `MON-20:30-21:30
994
+ # WED-20:30-21:30 FRI-20:30-21:30`.
995
+ #
996
+ # @option params [Array<Types::ControlCondition>] :blocking_alarms
997
+ # Add, change, or remove the Amazon CloudWatch alarm that you optionally
998
+ # specify as the blocking alarm for practice runs.
999
+ #
1000
+ # @option params [Array<Types::ControlCondition>] :outcome_alarms
1001
+ # Specify a new the Amazon CloudWatch alarm as the outcome alarm for
1002
+ # practice runs.
1003
+ #
1004
+ # @option params [required, String] :resource_identifier
1005
+ # The identifier for the resource that you want to update the practice
1006
+ # run configuration for. The identifier is the Amazon Resource Name
1007
+ # (ARN) for the resource.
1008
+ #
1009
+ # @return [Types::UpdatePracticeRunConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1010
+ #
1011
+ # * {Types::UpdatePracticeRunConfigurationResponse#arn #arn} => String
1012
+ # * {Types::UpdatePracticeRunConfigurationResponse#name #name} => String
1013
+ # * {Types::UpdatePracticeRunConfigurationResponse#practice_run_configuration #practice_run_configuration} => Types::PracticeRunConfiguration
1014
+ # * {Types::UpdatePracticeRunConfigurationResponse#zonal_autoshift_status #zonal_autoshift_status} => String
1015
+ #
1016
+ # @example Request syntax with placeholder values
1017
+ #
1018
+ # resp = client.update_practice_run_configuration({
1019
+ # blocked_dates: ["BlockedDate"],
1020
+ # blocked_windows: ["BlockedWindow"],
1021
+ # blocking_alarms: [
1022
+ # {
1023
+ # alarm_identifier: "ResourceArn", # required
1024
+ # type: "CLOUDWATCH", # required, accepts CLOUDWATCH
1025
+ # },
1026
+ # ],
1027
+ # outcome_alarms: [
1028
+ # {
1029
+ # alarm_identifier: "ResourceArn", # required
1030
+ # type: "CLOUDWATCH", # required, accepts CLOUDWATCH
1031
+ # },
1032
+ # ],
1033
+ # resource_identifier: "ResourceIdentifier", # required
1034
+ # })
1035
+ #
1036
+ # @example Response structure
1037
+ #
1038
+ # resp.arn #=> String
1039
+ # resp.name #=> String
1040
+ # resp.practice_run_configuration.blocked_dates #=> Array
1041
+ # resp.practice_run_configuration.blocked_dates[0] #=> String
1042
+ # resp.practice_run_configuration.blocked_windows #=> Array
1043
+ # resp.practice_run_configuration.blocked_windows[0] #=> String
1044
+ # resp.practice_run_configuration.blocking_alarms #=> Array
1045
+ # resp.practice_run_configuration.blocking_alarms[0].alarm_identifier #=> String
1046
+ # resp.practice_run_configuration.blocking_alarms[0].type #=> String, one of "CLOUDWATCH"
1047
+ # resp.practice_run_configuration.outcome_alarms #=> Array
1048
+ # resp.practice_run_configuration.outcome_alarms[0].alarm_identifier #=> String
1049
+ # resp.practice_run_configuration.outcome_alarms[0].type #=> String, one of "CLOUDWATCH"
1050
+ # resp.zonal_autoshift_status #=> String, one of "ENABLED", "DISABLED"
1051
+ #
1052
+ # @see http://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/UpdatePracticeRunConfiguration AWS API Documentation
1053
+ #
1054
+ # @overload update_practice_run_configuration(params = {})
1055
+ # @param [Hash] params ({})
1056
+ def update_practice_run_configuration(params = {}, options = {})
1057
+ req = build_request(:update_practice_run_configuration, params)
1058
+ req.send_request(options)
1059
+ end
1060
+
1061
+ # You can update the zonal autoshift status for a resource, to enable or
1062
+ # disable zonal autoshift. When zonal autoshift is `ENABLED`, Amazon Web
1063
+ # Services shifts away resource traffic from an Availability Zone, on
1064
+ # your behalf, when Amazon Web Services determines that there's an
1065
+ # issue in the Availability Zone that could potentially affect
1066
+ # customers.
1067
+ #
1068
+ # @option params [required, String] :resource_identifier
1069
+ # The identifier for the resource that you want to update the zonal
1070
+ # autoshift configuration for. The identifier is the Amazon Resource
1071
+ # Name (ARN) for the resource.
1072
+ #
1073
+ # @option params [required, String] :zonal_autoshift_status
1074
+ # The zonal autoshift status for the resource that you want to update
1075
+ # the zonal autoshift configuration for.
1076
+ #
1077
+ # @return [Types::UpdateZonalAutoshiftConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1078
+ #
1079
+ # * {Types::UpdateZonalAutoshiftConfigurationResponse#resource_identifier #resource_identifier} => String
1080
+ # * {Types::UpdateZonalAutoshiftConfigurationResponse#zonal_autoshift_status #zonal_autoshift_status} => String
1081
+ #
1082
+ # @example Request syntax with placeholder values
1083
+ #
1084
+ # resp = client.update_zonal_autoshift_configuration({
1085
+ # resource_identifier: "ResourceIdentifier", # required
1086
+ # zonal_autoshift_status: "ENABLED", # required, accepts ENABLED, DISABLED
1087
+ # })
1088
+ #
1089
+ # @example Response structure
1090
+ #
1091
+ # resp.resource_identifier #=> String
1092
+ # resp.zonal_autoshift_status #=> String, one of "ENABLED", "DISABLED"
1093
+ #
1094
+ # @see http://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/UpdateZonalAutoshiftConfiguration AWS API Documentation
1095
+ #
1096
+ # @overload update_zonal_autoshift_configuration(params = {})
1097
+ # @param [Hash] params ({})
1098
+ def update_zonal_autoshift_configuration(params = {}, options = {})
1099
+ req = build_request(:update_zonal_autoshift_configuration, params)
1100
+ req.send_request(options)
1101
+ end
1102
+
694
1103
  # Update an active zonal shift in Amazon Route 53 Application Recovery
695
- # Controller in your AWS account. You can update a zonal shift to set a
696
- # new expiration, or edit or replace the comment for the zonal shift.
1104
+ # Controller in your Amazon Web Services account. You can update a zonal
1105
+ # shift to set a new expiration, or edit or replace the comment for the
1106
+ # zonal shift.
697
1107
  #
698
1108
  # @option params [String] :comment
699
1109
  # A comment that you enter about the zonal shift. Only the latest
@@ -774,7 +1184,7 @@ module Aws::ARCZonalShift
774
1184
  params: params,
775
1185
  config: config)
776
1186
  context[:gem_name] = 'aws-sdk-arczonalshift'
777
- context[:gem_version] = '1.10.0'
1187
+ context[:gem_version] = '1.11.0'
778
1188
  Seahorse::Client::Request.new(handlers, context)
779
1189
  end
780
1190