Verwalten der Bandbreite für Ihr Amazon S3 S3-Datei-Gateway

Sie können den Upload-Durchsatz von Ihrem Gateway aufAWSSo steuern Sie die Netzwerkbandbreite, die das Gateway verwendet. Standardmäßig verfügt ein aktiviertes Gateway über keine Ratenlimits.

Sie können einen Zeitplan für die Bandbreitenrate konfigurieren, indem Sie dieAWS Management Console, einAWSDas Software Development Kit (SDK) oder dasAWS Storage GatewayAPI (sieheupdateBandWidthrateLimitScheduleimAWSStorage Gateway Gateway-API.). Mit einem Zeitplan für das Bandbreitenratenlimit können Sie Limits so konfigurieren, dass sie sich während des Tages oder der Woche automatisch ändern. Weitere Informationen finden Sie unter Anzeigen und bearbeiten Sie den Zeitplan für die Bandbreitenrate für Ihr Gateway mithilfe der Storage Gateway Gateway-Konsole.

Anmerkung

Das Konfigurieren von Bandbreitenratenlimits und -plänen wird derzeit für den Amazon FSx File Gateway-Typ nicht unterstützt.

Anzeigen und bearbeiten Sie den Zeitplan für die Bandbreitenrate für Ihr Gateway mithilfe der Storage Gateway Gateway-Konsole

In diesem Abschnitt wird beschrieben, wie Sie den Zeitplan für das Bandbreitenlimit für das Gateway anzeigen und bearbeiten.

So zeigen Sie einen Zeitplan für das Bandbreitenlimit an und bearbeiten ihn

1. Öffnen Sie die Storage Gateway Gateway-Konsolehttps://console.aws.amazon.com/storagegateway/homeaus.

2. Wählen Sie im linken Navigationsbereich-GatewaysWählen Sie dann das Gateway aus, das Sie verwalten möchten.

3. FürAktionen, wählenZeitplan für Bandbreitenratenlimits bearbeitenaus.

   Der aktuelle Zeitplan des Gateways für Bandbreiten-Raten-Limit wird auf derZeitplan für Bandbreitenratenlimits bearbeitenangezeigten. Standardmäßig hat ein neues Gateway keine definierten Bandbreitenratengrenzwerte.

4. (Optional) Wählen SieNeues Bandbreitenratenlimit hinzufügenum dem Zeitplan ein neues konfigurierbares Intervall hinzuzufügen. Geben Sie für jedes hinzugefügte Intervall die folgenden Informationen ein:

   • Upload-rate— Geben Sie das Upload-Ratenlimit in Megabit pro Sekunde (Mbit/s) ein. Der Mindestwert beträgt 100 Mbit/s.

   • Wochentage— Wählen Sie den Tag oder die Tage in jeder Woche aus, an denen das Intervall angewendet werden soll. Sie können das Intervall an Wochentagen (Montag bis Freitag), am Wochenende (Samstag und Sonntag), an jedem Wochentag oder an einem bestimmten Tag pro Woche anwenden. Um das Bandbreitenlimit gleichmäßig und konstant an allen Tagen und zu jeder Zeit anzuwenden, wählen SieKein Zeitplanaus.

   • Beginnzeit— Geben Sie die Startzeit für das Bandbreitenintervall ein, indem Sie das HH:MM-Format und den Zeitzonen-Offset von UTC für Ihr Gateway verwenden.

     Anmerkung

     Ihr Bandbreitenrate-Limit-Intervall beginnt zu Beginn der Minute, die Sie hier angeben.

   • Endzeit— Geben Sie die Endzeit für das Bandbreitenintervall ein, indem Sie das HH:MM-Format und den Zeitzonen-Offset von GMT für Ihr Gateway verwenden.

     Wichtig

     Das Bandbreiten-Grenz-Intervall endet am Ende der hier angegebenen Minute. Um ein Intervall zu planen, das am Ende einer Stunde endet, geben Sie59aus.

     Um aufeinanderfolgende kontinuierliche Intervalle zu planen, die zu Beginn der Stunde ohne Unterbrechung zwischen den Intervallen übergehen, geben Sie ein59für die Endminute des ersten Intervalls. Geben Sie ein.00für die Startminute des nachfolgenden Intervalls.

5. (Optional) Wiederholen Sie den vorherigen Schritt bei Bedarf, bis der Zeitplan für die Bandbreitenlimits abgeschlossen ist. Wenn Sie ein Intervall aus Ihrem Zeitplan löschen müssen, wählen SieRemoveaus.

   Wichtig

   Bandbreitenrate-Grenzintervalle können sich nicht überlappen. Die Startzeit eines Intervalls muss nach der Endzeit eines vorhergehenden Intervalls und vor der Startzeit eines folgenden Intervalls erfolgen.

6. Wenn Sie fertig sind, wählen SieSpeichern Sie die Änderungenaus.

Aktualisieren von Gateway-Bandbreitenlimits mitAWS SDK for Java

Durch die programmgesteuerte Aktualisierung von Bandbreitenlimits können Sie diese Limits automatisch über einen bestimmten Zeitraum hinweg anpassen, z. B. durch die Verwendung von geplanten Aufgaben. Im folgenden Beispiel wird gezeigt, wie Sie die Bandbreitenlimits eines Gateways mit aktualisierenAWS SDK for Javaaus. Wenn Sie den Beispielcode verwenden möchten, sollten Sie mit der Ausführung einer Java-Konsolenanwendung vertraut sein. Weitere Informationen finden Sie unter Erste Schritte im AWS SDK for Java-Entwicklerhandbuch.

Beispiel : Aktualisieren von Gateway-Bandbreitenlimits mitAWS SDK for Java

Mit dem folgenden Java-Codebeispiel werden die Bandbreitenlimits eines Gateways aktualisiert. Um diesen Beispielcode verwenden zu können, müssen Sie den Service-Endpunkt, den Amazon-Ressourcennamen (ARN) des Gateways sowie das Upload-Limit angeben. Für eine ListeAWSDienstendpunkte, die Sie mit Storage Gateway verwenden können, sieheAWS Storage GatewayEndpunkte und KontingenteimAWS– Allgemeine Referenzaus.

    import java.io.IOException;
     
    import com.amazonaws.AmazonClientException;
    import com.amazonaws.auth.PropertiesCredentials;
    import com.amazonaws.services.storagegateway.AWSStorageGatewayClient;
    import com.amazonaws.services.storagegateway.model. UpdateBandwidthRateLimitScheduleRequest;
    import com.amazonaws.services.storagegateway.model. UpdateBandwidthRateLimitScheduleReturn;
     
    import java.util.Arrays;
    import java.util.Collections;
    import java.util.List;
     
    public class UpdateBandwidthExample {
     
        public static AWSStorageGatewayClient sgClient;
        
        // The gatewayARN
        public static String gatewayARN = "*** provide gateway ARN ***";
     
        // The endpoint
        static String serviceURL = "https://storagegateway.us-east-1.amazonaws.com";
        
        // Rates
        static long uploadRate = 100 * 1024 * 1024;  // Bits per second, minimum 100 Megabits/second
        
        public static void main(String[] args) throws IOException {
     
            // Create a storage gateway client
            sgClient = new AWSStorageGatewayClient(new PropertiesCredentials(
                    UpdateBandwidthExample.class.getResourceAsStream("AwsCredentials.properties")));    
            sgClient.setEndpoint(serviceURL);
            
            UpdateBandwidth(gatewayARN, uploadRate, null); // download rate not supported by S3 File gateways
            
        }
     
        private static void UpdateBandwidth(String gatewayArn, long uploadRate, long downloadRate) {
            try
            {
                BandwidthRateLimit bandwidthRateLimit = new BandwidthRateLimit(downloadRate, uploadRate);
                BandwidthRateLimitInterval noScheduleInterval = new BandwidthRateLimitInterval()
                    .withBandwidthRateLimit(bandwidthRateLimit)
                    .withDaysOfWeek(Arrays.asList(1, 2, 3, 4, 5, 6, 0))
                    .withStartHourOfDay(0)
                    .withStartMinuteOfHour(0)
                    .withEndHourOfDay(23)
                    .withEndMinuteOfHour(59);
                UpdateBandwidthRateLimitScheduleRequest updateBandwidthRateLimitScheduleRequest =
                    new UpdateBandwidthRateLimitScheduleRequest()
                    .withGatewayARN(gatewayArn)
                    .with BandwidthRateLimitIntervals(Collections.singletonList(noScheduleInterval));
     
                UpdateBandwidthRateLimitScheduleReturn updateBandwidthRateLimitScheuduleResponse = sgClient.UpdateBandwidthRateLimitSchedule(updateBandwidthRateLimitScheduleRequest);
     
                String returnGatewayARN = updateBandwidthRateLimitScheuduleResponse.getGatewayARN();
                System.out.println("Updated the bandwidth rate limits of " + returnGatewayARN);
                System.out.println("Upload bandwidth limit = " + uploadRate + " bits per second");
            }
            catch (AmazonClientException ex)
            {
                System.err.println("Error updating gateway bandwith.\n" + ex.toString());
            }
        }        
    }

Aktualisieren von Gateway-Bandbreitenlimits mitAWS SDK for .NET

Durch die programmgesteuerte Aktualisierung von Bandbreitenlimits können Sie diese Limits automatisch über einen bestimmten Zeitraum hinweg anpassen, z. B. durch die Verwendung von geplanten Aufgaben. Im folgenden Beispiel wird gezeigt, wie Sie die Bandbreitenlimits eines Gateways mit aktualisierenAWSSoftware Development Kit (SDK) für .NET. Wenn Sie den Beispielcode verwenden möchten, sollten Sie mit der Ausführung einer .NET-Konsolenanwendung vertraut sein. Weitere Informationen finden Sie unter Erste Schritte im AWS SDK for .NET-Entwicklerhandbuch.

Beispiel : Aktualisieren von Gateway-Bandbreitenlimits mitAWS SDK for .NET

Mit dem folgenden C#-Codebeispiel werden die Bandbreitenlimits eines Gateways aktualisiert. Um diesen Beispielcode verwenden zu können, müssen Sie den Service-Endpunkt, den Amazon-Ressourcennamen (ARN) des Gateways sowie das Upload-Limit angeben. Für eine ListeAWSDienstendpunkte, die Sie mit Storage Gateway verwenden können, sieheAWS Storage GatewayEndpunkte und KontingenteimAWS– Allgemeine Referenzaus.

    using System;
    using System.Collections.Generic;
    using System.Linq;
    using System.Text;
    using Amazon.StorageGateway;
    using Amazon.StorageGateway.Model;
     
    namespace AWSStorageGateway
    {
        class UpdateBandwidthExample
        {
            static AmazonStorageGatewayClient sgClient;
            static AmazonStorageGatewayConfig sgConfig;
     
            // The gatewayARN
            public static String gatewayARN = "*** provide gateway ARN ***";
     
            // The endpoint
            static String serviceURL = "https://storagegateway.us-east-1.amazonaws.com";
     
            // Rates
            static long uploadRate = 100 * 1024 * 1024;  // Bits per second, minimum 100 Megabits/second
     
            public static void Main(string[] args)
            {
                // Create a storage gateway client
                sgConfig = new AmazonStorageGatewayConfig();
                sgConfig.ServiceURL = serviceURL;
                sgClient = new AmazonStorageGatewayClient(sgConfig);
     
                UpdateBandwidth(gatewayARN, uploadRate, null);
     
                Console.WriteLine("\nTo continue, press Enter.");
                Console.Read();
            }
     
            public static void UpdateBandwidth(string gatewayARN, long uploadRate, long downloadRate)
            {
                try
                {
                   BandwidthRateLimit bandwidthRateLimit = new BandwidthRateLimit(downloadRate, uploadRate);
                   BandwidthRateLimitInterval noScheduleInterval = new BandwidthRateLimitInterval()
                    .withBandwidthRateLimit(bandwidthRateLimit)
                    .withDaysOfWeek(Arrays.asList(1, 2, 3, 4, 5, 6, 0))
                    .withStartHourOfDay(0)
                    .withStartMinuteOfHour(0)
                    .withEndHourOfDay(23)
                    .withEndMinuteOfHour(59);
                  List <BandwidthRateLimitInterval> bandwidthRateLimitIntervals = new List<BandwidthRateLimitInterval>();
                  bandwidthRateLimitIntervals.Add(noScheduleInterval);
                  UpdateBandwidthRateLimitScheduleRequest updateBandwidthRateLimitScheduleRequest = 
                    new UpdateBandwidthRateLimitScheduleRequest()
                       .withGatewayARN(gatewayARN)
                       .with BandwidthRateLimitIntervals(bandwidthRateLimitIntervals);
     
                    UpdateBandwidthRateLimitScheduleReturn updateBandwidthRateLimitScheuduleResponse = sgClient.UpdateBandwidthRateLimitSchedule(updateBandwidthRateLimitScheduleRequest);
                    String returnGatewayARN = updateBandwidthRateLimitScheuduleResponse.GatewayARN;
                    Console.WriteLine("Updated the bandwidth rate limits of " + returnGatewayARN);
                    Console.WriteLine("Upload bandwidth limit = " + uploadRate + " bits per second");
                }
                catch (AmazonStorageGatewayException ex)
                {
                    Console.WriteLine("Error updating gateway bandwith.\n" + ex.ToString());
                }
            }
        }
    }

Aktualisieren von Gateway-Bandbreitenlimits mitAWS Tools for Windows PowerShell

Durch die programmgesteuerte Aktualisierung von Bandbreitenlimits können Sie diese Limits automatisch über einen bestimmten Zeitraum hinweg anpassen, z. B. durch die Verwendung von geplanten Aufgaben. Im folgenden Beispiel wird gezeigt, wie Sie die Bandbreitenlimits eines Gateways mit aktualisierenAWS Tools for Windows PowerShellaus. Wenn Sie den Beispielcode verwenden möchten, sollten Sie mit der Ausführung eines PowerShell-Skripts vertraut sein. Weitere Informationen finden Sie unterErste SchritteimAWS Tools for Windows PowerShell-Benutzerhandbuchaus.

Beispiel : Aktualisieren von Gateway-Bandbreitenlimits mitAWS Tools for Windows PowerShell

Mit dem folgenden PowerShell-Skriptbeispiel werden die Bandbreitenlimits eines Gateways aktualisiert. Um dieses Beispielskript verwenden zu können, müssen Sie den Amazon-Ressourcennamen (ARN) des Gateways sowie das Uploadlimit angeben.

    <#
    .DESCRIPTION
        Update Gateway bandwidth limits schedule
        
    .NOTES
        PREREQUISITES:
        1) AWS Tools for PowerShell from https://aws.amazon.com/powershell/
        2) Credentials and region stored in session using Initialize-AWSDefault.
        For more info, see https://docs.aws.amazon.com/powershell/latest/userguide/specifying-your-aws-credentials.html
        
     
    .EXAMPLE
        powershell.exe .\SG_UpdateBandwidth.ps1 
    #>
     
    $UploadBandwidthRate = 100 * 1024 * 1024 
    $gatewayARN = "*** provide gateway ARN ***"
     
    $bandwidthRateLimitInterval = New-Object Amazon.StorageGateway.Model.BandwidthRateLimitInterval
    $bandwidthRateLimitInterval.StartHourOfDay = 0
    $bandwidthRateLimitInterval.StartMinuteOfHour = 0
    $bandwidthRateLimitInterval.EndHourOfDay = 23
    $bandwidthRateLimitInterval.EndMinuteOfHour = 59
    $bandwidthRateLimitInterval.DaysOfWeek = 0,1,2,3,4,5,6
    $bandwidthRateLimitInterval.AverageUploadRateLimitInBitsPerSec = $UploadBandwidthRate
     
    #Update Bandwidth Rate Limits
    Update-SGBandwidthRateLimitSchedule -GatewayARN $gatewayARN `
                                        -BandwidthRateLimitInterval @($bandwidthRateLimitInterval)
     
    $schedule =  Get-SGBandwidthRateLimitSchedule -GatewayARN $gatewayARN
     
    Write-Output("`nGateway: " + $gatewayARN);
    Write-Output("`nNew bandwidth throttle schedule: " + $schedule.BandwidthRateLimitIntervals.AverageUploadRateLimitInBitsPerSec)