View a markdown version of this page

Beispiele für die Verwendung von AWS CLI mit zonaler Verschiebung - Amazon Application Recovery Controller (ARC)

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Beispiele für die Verwendung von AWS CLI mit zonaler Verschiebung

Dieser Abschnitt enthält Anwendungsbeispiele für die Verwendung von Zonal Shift. Dabei wird die verwendet, AWS Command Line Interface um mithilfe von API-Operationen mit der Zonenverschiebungsfunktion in Amazon Application Recovery Controller (ARC) zu arbeiten. Die Beispiele sollen Ihnen helfen, ein grundlegendes Verständnis für die Arbeit mit Zonal Shift mithilfe der CLI zu entwickeln.

Die Zonenverschiebung in ARC ermöglicht es Ihnen, den Datenverkehr für unterstützte Ressourcen vorübergehend von einer Availability Zone weg zu verlagern, sodass Ihre Anwendung weiterhin normal mit anderen Availabilty Zones in einer betrieben werden kann. AWS-Region

Alle zonalen Verschiebungen sind temporär und müssen zunächst so eingestellt werden, dass sie innerhalb von drei Tagen ablaufen. Sie können eine zonale Schicht jedoch später aktualisieren, um ein neues Ablaufdatum festzulegen.

Weitere Informationen zur Verwendung von finden Sie in der AWS CLI Befehlsreferenz. AWS CLI Eine Liste der API-Aktionen für Zonenverschiebungen und Links zu weiteren Informationen finden Sie unterAPI-Operationen mit zonaler Verschiebung.

Starten Sie die Zonenverschiebung

Sie können eine zonale Verschiebung mit der CLI starten, indem Sie den start-zonal-shift Befehl verwenden.

aws arc-zonal-shift start-zonal-shift \ --resource-identifier arn:aws:elasticloadbalancing:us-east-1:111122223333:loadbalancer/app/Testing/5a19403ecd42dc05 \ --away-from use1-az1 \ --expires-in 10m \ --comment "Shifting traffic away from use1-az1"
{ "awayFrom": "use1-az1", "comment": "Shifting traffic away from use1-az1", "expiryTime": "2024-12-17T21:37:26-08:00", "resourceIdentifier": "arn:aws:elasticloadbalancing:us-east-1:111122223333:loadbalancer/app/Testing/5a19403ecd42dc05", "startTime": "2024-12-17T21:27:26-08:00", "status": "ACTIVE", "zonalShiftId": "9ac9ec1e-1df1-0755-3dc5-8cf573cd9c38" }

Verwaltete Ressource abrufen

Sie können Informationen zu einer verwalteten Ressource mit der CLI abrufen, indem Sie den get-managed-resource Befehl verwenden.

aws arc-zonal-shift get-managed-resource \ --resource-identifier arn:aws:elasticloadbalancing:us-east-1:111122223333:loadbalancer/app/Testing/5a19403ecd42dc05
{ "appliedWeights": { "use1-az1": 0.0, "use1-az2": 1.0, "use1-az6": 1.0 }, "arn": "arn:aws:elasticloadbalancing:us-east-1:111122223333:loadbalancer/app/Testing/5a19403ecd42dc05", "autoshifts": [], "name": "Testing", "zonalAutoshiftStatus": "DISABLED", "zonalShifts": [ { "appliedStatus": "APPLIED", "awayFrom": "use1-az1", "comment": "Shifting traffic away from use1-az1", "expiryTime": "2024-12-17T21:37:26-08:00", "resourceIdentifier": "arn:aws:elasticloadbalancing:us-east-1:111122223333:loadbalancer/app/Testing/5a19403ecd42dc05", "startTime": "2024-12-17T21:27:26-08:00", "zonalShiftId": "9ac9ec1e-1df1-0755-3dc5-8cf573cd9c38" "shiftType": "MANUAL" } ] }

Verwaltete Ressourcen auflisten

Sie können die verwalteten Ressourcen in Ihrem Konto mit der CLI auflisten, indem Sie den list-managed-resources Befehl verwenden.

aws arc-zonal-shift list-managed-resources
{ "items": [ { "appliedWeights": { "use1-az1": 0.0, "use1-az2": 1.0, "use1-az6": 1.0 }, "arn": "arn:aws:elasticloadbalancing:us-east-1:111122223333:loadbalancer/app/Testing/5a19403ecd42dc05", "autoshifts": [], "availabilityZones": [ "use1-az1", "use1-az2", "use1-az6" ], "name": "Testing", "practiceRunStatus": "DISABLED", "zonalAutoshiftStatus": "DISABLED", "zonalShifts": [ { "appliedStatus": "APPLIED", "awayFrom": "use1-az1", "comment": "Shifting traffic away from use1-az1", "expiryTime": "2024-12-17T21:37:26-08:00", "resourceIdentifier": "arn:aws:elasticloadbalancing:us-east-1:111122223333:loadbalancer/app/Testing/5a19403ecd42dc05", "startTime": "2024-12-17T21:27:26-08:00", "zonalShiftId": "9ac9ec1e-1df1-0755-3dc5-8cf573cd9c38" } ] } ] }

Zonale Verschiebungen auflisten

Sie können die zonalen Verschiebungen in Ihrem Konto mit der CLI auflisten, indem Sie den list-zonal-shifts Befehl verwenden.

aws arc-zonal-shift list-zonal-shifts
{ "items": [ { "awayFrom": "use1-az1", "comment": "Shifting traffic away from use1-az1", "expiryTime": "2024-12-17T21:37:26-08:00", "resourceIdentifier": "arn:aws:elasticloadbalancing:us-east-1:111122223333:loadbalancer/app/Testing/5a19403ecd42dc05", "startTime": "2024-12-17T21:27:26-08:00", "status": "ACTIVE", "zonalShiftId": "9ac9ec1e-1df1-0755-3dc5-8cf573cd9c38" } ] }

Aktualisieren Sie die zonale Verschiebung

Sie können eine Zonenverschiebung mit der CLI aktualisieren, indem Sie den update-zonal-shift Befehl verwenden.

aws arc-zonal-shift update-zonal-shift \ --zonal-shift-id 9ac9ec1e-1df1-0755-3dc5-8cf573cd9c38 \ --expires-in 1h \ --comment "Still shifting traffic away from use1-az1"
{ "awayFrom": "use1-az1", "comment": "Still shifting traffic away from use1-az1", "expiryTime": "2024-12-17T22:29:38-08:00", "resourceIdentifier": "arn:aws:elasticloadbalancing:us-east-1:111122223333:loadbalancer/app/Testing/5a19403ecd42dc05", "startTime": "2024-12-17T21:27:26-08:00", "status": "ACTIVE", "zonalShiftId": "9ac9ec1e-1df1-0755-3dc5-8cf573cd9c38" }

Brechen Sie die Zonenverschiebung ab

Sie können eine zonale Verschiebung mit der CLI abbrechen, indem Sie den cancel-zonal-shift Befehl verwenden.

aws arc-zonal-shift cancel-zonal-shift \ --zonal-shift-id 9ac9ec1e-1df1-0755-3dc5-8cf573cd9c38
{ "awayFrom": "use1-az1", "comment": "Still shifting traffic away from use1-az1", "expiryTime": "2024-12-17T22:29:38-08:00", "resourceIdentifier": "arn:aws:elasticloadbalancing:us-east-1:111122223333:loadbalancer/app/Testing/5a19403ecd42dc05", "startTime": "2024-12-17T21:27:26-08:00", "status": "CANCELED", "zonalShiftId": "9ac9ec1e-1df1-0755-3dc5-8cf573cd9c38" }