

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Gestione della larghezza di banda per il gateway di volumi
<a name="MaintenanceUpdateBandwidth-common"></a>

È possibile limitare (o limitare) la velocità effettiva di caricamento dal gateway verso AWS o la velocità effettiva di download dal gateway. AWS L'utilizzo della limitazione della larghezza di banda consente di controllare la quantità di larghezza di banda di rete utilizzata dal gateway. Per impostazione predefinita, un gateway attivato non ha limiti di velocità per il caricamento o il download.

È possibile specificare il limite di velocità utilizzando o a livello di codice utilizzando l' Console di gestione AWS API Storage Gateway (vedere [UpdateBandwidthRateLimit](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_UpdateBandwidthRateLimit.html)) o un AWS Software Development Kit (SDK). Se si esegue la limitazione della larghezza di banda a livello di programmazione, è possibile modificare i limiti automaticamente durante il giorno, ad esempio pianificando attività per la modifica della larghezza di banda.

È inoltre possibile definire una limitazione della larghezza di banda basata su una pianificazione per il gateway. È possibile pianificare la limitazione della larghezza di banda definendo uno o più intervalli. bandwidth-rate-limit Per ulteriori informazioni, consulta [Limitazione della larghezza di banda basata sulla pianificazione tramite la console Storage Gateway](#SchedulingBandwidthThrottling). 

****La configurazione di un'unica impostazione per la limitazione della larghezza di banda è l'equivalente funzionale della definizione di una pianificazione con un unico bandwidth-rate-limit intervallo impostato per Tutti **i giorni**, con un'ora di inizio e un'ora di fine di. `00:00`**** `23:59` 

**Nota**  
Le informazioni contenute in questa sezione sono specifiche per i gateway di nastri virtuali e di volumi. Per gestire la larghezza di banda per un gateway di file Amazon S3, consulta [Gestione della larghezza di banda per il gateway di file Amazon S3](https://docs.aws.amazon.com/filegateway/latest/files3/MaintenanceUpdateBandwidth-common.html). I limiti di velocità di banda non sono attualmente supportati per Amazon FSx File Gateway.

**Topics**
+ [Per modificare la limitazione della larghezza di banda usando la console Storage Gateway](#MaintenanceUpdateBandwidthConsole-common)
+ [Limitazione della larghezza di banda basata sulla pianificazione tramite la console Storage Gateway](#SchedulingBandwidthThrottling)
+ [Aggiornamento dei limiti di velocità di larghezza di banda del gateway utilizzando il AWS SDK per Java](#MaintenanceUpdateBandwidthJava-common)
+ [Aggiornamento dei limiti di velocità di larghezza di banda del gateway utilizzando il AWS SDK per .NET](#MaintenanceUpdateBandwidthDotNet-common)
+ [Aggiornamento dei limiti di velocità di larghezza di banda del gateway utilizzando il AWS Tools for Windows PowerShell](#MaintenanceUpdateBandwidthPowerShell-common)

## Per modificare la limitazione della larghezza di banda usando la console Storage Gateway
<a name="MaintenanceUpdateBandwidthConsole-common"></a>

La procedura seguente illustra come modificare la limitazione della larghezza di banda di un gateway usando la console Storage Gateway.

**Per modificare il throttling della larghezza di banda di un gateway usando la console**

1. Apri la console Storage Gateway a [https://console.aws.amazon.com/storagegateway/casa](https://console.aws.amazon.com/storagegateway/).

1. Nel riquadro di navigazione di sinistra, scegliere **Gateway** e quindi scegliere il gateway da gestire.

1. Per **Operazioni**, scegliere **Modifica limite di larghezza di banda**.

1. Nella finestra di dialogo **Modifica limiti velocità** digitare nuovi valori per i limiti e quindi scegliere **Salva**. Le modifiche verranno visualizzate nella scheda **Details (Dettagli)** del gateway.

## Limitazione della larghezza di banda basata sulla pianificazione tramite la console Storage Gateway
<a name="SchedulingBandwidthThrottling"></a>

La procedura seguente illustra come pianificare modifiche nella limitazione della larghezza di banda di un gateway usando la console Storage Gateway.

**Per aggiungere o modificare una pianificazione per la limitazione della larghezza di banda del gateway**

1. Apri la console Storage Gateway a [https://console.aws.amazon.com/storagegateway/casa](https://console.aws.amazon.com/storagegateway/).

1. Nel riquadro di navigazione di sinistra, scegliere **Gateway** e quindi scegliere il gateway da gestire.

1. Per **Operazioni**, scegliere **Modifica pianificazione del limite di velocità di larghezza di banda**.

   La bandwidth-rate-limit pianificazione del gateway viene visualizzata nella finestra di dialogo **Modifica pianificazione del limite di velocità di larghezza di banda**. Per impostazione predefinita, una nuova bandwidth-rate-limit pianificazione del gateway è vuota. 

1. Nella finestra di dialogo **Modifica pianificazione del limite di velocità di larghezza di banda**, scegli **Aggiungi nuovo elemento** per aggiungere un nuovo bandwidth-rate-limit intervallo. Inserisci le seguenti informazioni per ogni bandwidth-rate-limit intervallo:
   + **Giorni della settimana**: puoi creare l' bandwidth-rate-limitintervallo per i giorni feriali (dal lunedì al venerdì), per i fine settimana (sabato e domenica), per tutti i giorni della settimana o per uno o più giorni specifici della settimana.
   + Ora di **inizio: immettere l'ora** di inizio dell'intervallo di larghezza di banda nel fuso orario locale del gateway, utilizzando il formato HH:MM.
**Nota**  
L' bandwidth-rate-limitintervallo inizia all'inizio del minuto specificato qui.
   + **Ora di fine**: immettere l'ora di fine dell' bandwidth-rate-limitintervallo nel fuso orario locale del gateway, utilizzando il formato HH:MM. 
**Importante**  
L' bandwidth-rate-limitintervallo termina alla fine del minuto specificato qui. Per pianificare un intervallo che termini alla fine di un'ora, immettere. **59**  
Per programmare intervalli continui consecutivi, con transizione all'inizio dell'ora, senza interruzioni tra gli intervalli, inserite **59** il minuto finale del primo intervallo. Inserisci **00** per il minuto di inizio dell'intervallo successivo. 
   + **Velocità di download**: inserisci il limite di velocità di download, in kilobit al secondo (Kbps), oppure seleziona **Nessun limite per disattivare la limitazione della larghezza di banda per il** download. Il valore minimo per la velocità di download è 100 Kbps. 
   + **Velocità di caricamento**: inserisci il limite di velocità di caricamento, in Kbps, o seleziona **Nessun limite** per disattivare la limitazione della larghezza di banda per il caricamento. Il valore minimo per la velocità di caricamento è 50 Kbps. 

   Per modificare bandwidth-rate-limit gli intervalli, è possibile inserire valori modificati per i parametri degli intervalli. 

   Per rimuovere gli bandwidth-rate-limit intervalli, puoi scegliere **Rimuovi** a destra dell'intervallo da eliminare.

   Dopo aver completato le modifiche, scegli **Salva**.

1. Continua ad aggiungere bandwidth-rate-limit intervalli scegliendo **Aggiungi nuovo elemento** e inserendo il giorno, l'ora di inizio e di fine e i limiti di velocità di download e upload. 
**Importante**  
 Bandwidth-rate-limitgli intervalli non possono sovrapporsi. L'ora di inizio di un intervallo deve essere successiva all'ora di fine di un intervallo precedente, e precedente all'ora di inizio di un intervallo successivo. 

1. Dopo aver inserito tutti gli bandwidth-rate-limit intervalli, scegli **Salva modifiche per salvare** la pianificazione. bandwidth-rate-limit

Quando la bandwidth-rate-limit pianificazione viene aggiornata correttamente, puoi visualizzare i limiti correnti di velocità di download e upload nel pannello **Dettagli** del gateway.

## Aggiornamento dei limiti di velocità di larghezza di banda del gateway utilizzando il AWS SDK per Java
<a name="MaintenanceUpdateBandwidthJava-common"></a>

Se aggiorni i limiti di velocità della larghezza di banda a livello di programmazione, puoi modificare i limiti automaticamente per un periodo di tempo, ad esempio usando attività pianificate. L'esempio seguente illustra come aggiornare i limiti di velocità della larghezza di banda di un gateway usando AWS SDK per Java. Per usare il codice di esempio, devi avere familiarità con l'esecuzione di un'applicazione di console Java. Per ulteriori informazioni, consulta [Nozioni di base](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/java-dg-setup.html) nella *Guida per gli sviluppatori di AWS SDK per Java .* 

**Example : Aggiornamento dei limiti di velocità di larghezza di banda del gateway utilizzando il AWS SDK per Java**  
L'esempio di codice Java seguente aggiorna i limiti di velocità della larghezza di banda di un gateway. Per utilizzare questo codice di esempio, è necessario fornire l'endpoint del servizio, il nome della risorsa Amazon (ARN) del gateway e i limiti di download e caricamento. Per un elenco degli endpoint di AWS servizio che è possibile utilizzare con Storage Gateway, vedere [Gateway di archiviazione AWS Endpoints and Quotas nel](https://docs.aws.amazon.com/general/latest/gr/sg.html). *Riferimenti generali di AWS*  

```
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.UpdateBandwidthRateLimitRequest;
import com.amazonaws.services.storagegateway.model.UpdateBandwidthRateLimitResult;


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 = 51200;  // Bits per second, minimum 51200
    static long downloadRate = 102400;   // Bits per second, minimum 102400
    
    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, downloadRate);
        
    }

    private static void UpdateBandwidth(String gatewayARN2, long uploadRate2,
            long downloadRate2) {
        try
        {
            UpdateBandwidthRateLimitRequest updateBandwidthRateLimitRequest =
                new UpdateBandwidthRateLimitRequest()
                .withGatewayARN(gatewayARN)
                .withAverageDownloadRateLimitInBitsPerSec(downloadRate)
                .withAverageUploadRateLimitInBitsPerSec(uploadRate);

            UpdateBandwidthRateLimitResult updateBandwidthRateLimitResult = sgClient.updateBandwidthRateLimit(updateBandwidthRateLimitRequest);
            String returnGatewayARN = updateBandwidthRateLimitResult.getGatewayARN();
            System.out.println("Updated the bandwidth rate limits of " + returnGatewayARN);
            System.out.println("Upload bandwidth limit = " + uploadRate + " bits per second");
            System.out.println("Download bandwidth limit = " + downloadRate + " bits per second");
        }
        catch (AmazonClientException ex)
        {
            System.err.println("Error updating gateway bandwith.\n" + ex.toString());
        }
    }        
}
```

## Aggiornamento dei limiti di velocità di larghezza di banda del gateway utilizzando il AWS SDK per .NET
<a name="MaintenanceUpdateBandwidthDotNet-common"></a>

Se aggiorni i limiti di velocità della larghezza di banda a livello di programmazione, puoi modificare i limiti automaticamente per un periodo di tempo, ad esempio usando attività pianificate. L'esempio seguente illustra come aggiornare i limiti di velocità della larghezza di banda di un gateway usando AWS SDK per .NET. Per usare il codice di esempio, devi avere familiarità con l'esecuzione di un'applicazione di console .NET. Per ulteriori informazioni, consulta [Nozioni di base](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/net-dg-setup.html) nella *Guida per gli sviluppatori di AWS SDK per .NET .* 

**Example : Aggiornamento dei limiti di velocità di larghezza di banda del gateway utilizzando il AWS SDK per .NET**  
L'esempio di codice C\# seguente aggiorna i limiti di velocità della larghezza di banda di un gateway. Per utilizzare questo codice di esempio, è necessario fornire l'endpoint del servizio, il nome della risorsa Amazon (ARN) del gateway e i limiti di download e caricamento. Per un elenco degli endpoint di AWS servizio che è possibile utilizzare con Storage Gateway, vedere [Gateway di archiviazione AWS Endpoints and Quotas nel](https://docs.aws.amazon.com/general/latest/gr/sg.html). *Riferimenti generali di AWS*  

```
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 = 51200;  // Bits per second, minimum 51200
        static long downloadRate = 102400;   // Bits per second, minimum 102400

        public static void Main(string[] args)
        {
            // Create a Storage Gateway client
            sgConfig = new AmazonStorageGatewayConfig();
            sgConfig.ServiceURL = serviceURL;
            sgClient = new AmazonStorageGatewayClient(sgConfig);

            UpdateBandwidth(gatewayARN, uploadRate, downloadRate);

            Console.WriteLine("\nTo continue, press Enter.");
            Console.Read();
        }

        public static void UpdateBandwidth(string gatewayARN, long uploadRate, long downloadRate)
        {
            try
            {
                UpdateBandwidthRateLimitRequest updateBandwidthRateLimitRequest =
                    new UpdateBandwidthRateLimitRequest()
                    .WithGatewayARN(gatewayARN)
                    .WithAverageDownloadRateLimitInBitsPerSec(downloadRate)
                    .WithAverageUploadRateLimitInBitsPerSec(uploadRate);

                UpdateBandwidthRateLimitResponse updateBandwidthRateLimitResponse = sgClient.UpdateBandwidthRateLimit(updateBandwidthRateLimitRequest);
                String returnGatewayARN = updateBandwidthRateLimitResponse.UpdateBandwidthRateLimitResult.GatewayARN;
                Console.WriteLine("Updated the bandwidth rate limits of " + returnGatewayARN);
                Console.WriteLine("Upload bandwidth limit = " + uploadRate + " bits per second");
                Console.WriteLine("Download bandwidth limit = " + downloadRate + " bits per second");
            }
            catch (AmazonStorageGatewayException ex)
            {
                Console.WriteLine("Error updating gateway bandwith.\n" + ex.ToString());
            }
        }
    }
}
```

## Aggiornamento dei limiti di velocità di larghezza di banda del gateway utilizzando il AWS Tools for Windows PowerShell
<a name="MaintenanceUpdateBandwidthPowerShell-common"></a>

Se aggiorni i limiti di velocità della larghezza di banda a livello di programmazione, puoi modificare i limiti automaticamente per un periodo di tempo, ad esempio usando attività pianificate. L'esempio seguente illustra come aggiornare i limiti di velocità della larghezza di banda di un gateway usando AWS Tools for Windows PowerShell. Per utilizzare il codice di esempio, è necessario avere dimestichezza con l'esecuzione di uno PowerShell script. Per ulteriori informazioni, consulta [Nozioni di base](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-started.html) nella *Guida per l'utente di AWS Strumenti per PowerShell *. 

**Example : Aggiornamento dei limiti di velocità di larghezza di banda del gateway utilizzando il AWS Tools for Windows PowerShell**  
Il seguente esempio di PowerShell script aggiorna i limiti di velocità di larghezza di banda di un gateway. Per utilizzare questo script di esempio, è necessario fornire il nome della risorsa Amazon (ARN) del gateway e i limiti di download e caricamento.   

```
<#
.DESCRIPTION
    Update Gateway bandwidth limits.
    
.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 = 51200
$DownloadBandwidthRate = 102400
$gatewayARN = "*** provide gateway ARN ***"

#Update Bandwidth Rate Limits
Update-SGBandwidthRateLimit -GatewayARN $gatewayARN `
                            -AverageUploadRateLimitInBitsPerSec $UploadBandwidthRate `
                            -AverageDownloadRateLimitInBitsPerSec $DownloadBandwidthRate

$limits =  Get-SGBandwidthRateLimit -GatewayARN $gatewayARN

Write-Output("`nGateway: " + $gatewayARN);
Write-Output("`nNew Upload Rate: " + $limits.AverageUploadRateLimitInBitsPerSec)
Write-Output("`nNew Download Rate: " + $limits.AverageDownloadRateLimitInBitsPerSec)
```