

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Administración del ancho de banda de la puerta de enlace de cinta
<a name="MaintenanceUpdateBandwidth-common"></a>

Puede limitar (o limitar) el rendimiento de carga desde la puerta de enlace AWS o el rendimiento de descarga desde AWS su puerta de enlace. La limitación del ancho de banda te ayuda a controlar la cantidad de ancho de banda de red que utiliza tu puerta de enlace. De forma predeterminada, una pasarela activada no tiene límites de velocidad de carga o descarga.

Puede especificar el límite de velocidad mediante la Consola de administración de AWS API Storage Gateway (consulte [UpdateBandwidthRateLimit](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_UpdateBandwidthRateLimit.html)) o un kit de desarrollo de AWS software (SDK), o mediante programación. Si limita el ancho de banda mediante programación, puede cambiar los límites automáticamente a lo largo del día, por ejemplo, programando tareas que cambien el ancho de banda.

También puede definir una limitación del ancho de banda basada en la programación para la puerta de enlace. Para programar la limitación del ancho de banda, defina uno o más intervalos. bandwidth-rate-limit Para obtener más información, consulte [Limitación del ancho de banda basada en la programación mediante la consola de Storage Gateway](#SchedulingBandwidthThrottling). 

**Configurar una configuración única para la limitación del ancho de banda es el equivalente funcional de definir una programación con un único bandwidth-rate-limit intervalo establecido para **todos los días**, con una hora de **inicio `00:00` y una hora** de finalización de.** `23:59` 

**nota**  
La información de esta sección es específica para las puertas de enlace de cinta y de volumen. Para administrar el ancho de banda de una puerta de enlace de archivo de Amazon S3, consulte [Managing Bandwidth for Your Amazon S3 File Gateway](https://docs.aws.amazon.com/filegateway/latest/files3/MaintenanceUpdateBandwidth-common.html). Actualmente, Amazon FSx File Gateway no admite límites de velocidad de ancho de banda.

**Topics**
+ [Cambio de la limitación controlada del ancho de banda mediante la consola de Storage Gateway](#MaintenanceUpdateBandwidthConsole-common)
+ [Limitación del ancho de banda basada en la programación mediante la consola de Storage Gateway](#SchedulingBandwidthThrottling)
+ [Actualización de los límites de ancho de banda de la pasarela mediante el AWS SDK para Java](#MaintenanceUpdateBandwidthJava-common)
+ [Actualización de los límites de ancho de banda de Gateway mediante el AWS SDK para .NET](#MaintenanceUpdateBandwidthDotNet-common)
+ [Actualización de los límites de ancho de banda de Gateway mediante el AWS Tools for Windows PowerShell](#MaintenanceUpdateBandwidthPowerShell-common)

## Cambio de la limitación controlada del ancho de banda mediante la consola de Storage Gateway
<a name="MaintenanceUpdateBandwidthConsole-common"></a>

En el procedimiento siguiente, se muestra cómo cambiar la limitación controlada del ancho de banda de la puerta de enlace con la consola de Storage Gateway.

**Para cambiar la limitación controlada de ancho de banda de una gateway mediante la consola**

1. Abra la consola Storage Gateway en [https://console.aws.amazon.com/storagegateway/casa](https://console.aws.amazon.com/storagegateway/).

1. En el panel de navegación izquierdo, elija **Puertas de enlace** y, a continuación, elija la puerta de enlace que desee administrar.

1. En **Acciones**, elija **Editar el límite de velocidad del ancho de banda**.

1. En el cuadro de diálogo **Editar límites de velocidad**, escriba nuevos valores para los límites y, a continuación, elija **Guardar**. Los cambios aparecen en la pestaña **Details (Detalles)** de la gateway.

## Limitación del ancho de banda basada en la programación mediante la consola de Storage Gateway
<a name="SchedulingBandwidthThrottling"></a>

En el procedimiento siguiente se muestra cómo programar cambios en la limitación del ancho de banda de una puerta de enlace utilizando la consola de Storage Gateway.

**Para agregar o modificar una programación para la limitación del ancho de banda de la puerta de enlace**

1. Abra la consola Storage Gateway en [https://console.aws.amazon.com/storagegateway/casa](https://console.aws.amazon.com/storagegateway/).

1. En el panel de navegación izquierdo, elija **Puertas de enlace** y, a continuación, elija la puerta de enlace que desee administrar.

1. En **Acciones**, elija **Editar programación de límite de velocidad de ancho de banda**.

   La bandwidth-rate-limit programación de la puerta de enlace se muestra en el cuadro de diálogo **Editar la programación del límite de velocidad de ancho** de banda. De forma predeterminada, la nueva bandwidth-rate-limit programación de la puerta de enlace está vacía. 

1. En el cuadro de diálogo **Editar el programa de límite de velocidad de ancho** de banda, elija **Agregar nuevo elemento** para agregar un nuevo bandwidth-rate-limit intervalo. Introduzca la siguiente información para cada bandwidth-rate-limit intervalo:
   + **Días de la semana**: puede crear el bandwidth-rate-limit intervalo para los días de la semana (de lunes a viernes), los fines de semana (sábado y domingo), para todos los días de la semana o para uno o más días específicos de la semana.
   + **Hora de inicio**: introduzca la hora de inicio del intervalo de ancho de banda en la zona horaria local de la puerta de enlace con el formato HH:MM.
**nota**  
El bandwidth-rate-limit intervalo comienza al principio del minuto que especifique aquí.
   + **Hora de finalización**: introduzca la hora de finalización del bandwidth-rate-limit intervalo en la zona horaria local de la puerta de enlace con el formato HH:MM. 
**importante**  
El bandwidth-rate-limit intervalo finaliza al final del minuto especificado aquí. Para programar un intervalo que finalice al final de una hora, introduzca **59**.  
Para programar intervalos continuos consecutivos, con transferencia al principio de la hora, sin interrupción entre los intervalos, introduzca **59** para el minuto final del primer intervalo. Introduzca **00** para el minuto de inicio del siguiente intervalo. 
   + **Velocidad de descarga**: introduzca el límite de velocidad de descarga en kilobits por segundo (Kbps), o seleccione **Sin límite** para desactivar la limitación del ancho de banda para la descarga. El valor mínimo de la velocidad de descarga es 100 Kbps. 
   + **Velocidad de carga**: introduzca el límite de velocidad de carga en Kbps o seleccione **Sin límite** para desactivar la limitación del ancho de banda para la carga. El valor mínimo de la velocidad de carga es 50 Kbps. 

   Para modificar los bandwidth-rate-limit intervalos, puede introducir valores revisados para los parámetros del intervalo. 

   Para eliminar bandwidth-rate-limit los intervalos, puede seleccionar **Eliminar** a la derecha del intervalo que desee eliminar.

   Cuando haya completado los cambios, elija **Guardar**.

1. Para seguir añadiendo bandwidth-rate-limit intervalos, selecciona **Añadir nuevo elemento** e introduce el día, las horas de inicio y finalización y los límites de velocidad de descarga y carga. 
**importante**  
 Bandwidth-rate-limitlos intervalos no se pueden superponer. La hora de inicio de un intervalo debe producirse después de la hora de finalización del intervalo anterior y antes de la hora de inicio del intervalo siguiente. 

1. Tras introducir todos los bandwidth-rate-limit intervalos, seleccione **Guardar cambios** para guardar la bandwidth-rate-limit programación.

Cuando la bandwidth-rate-limit programación se haya actualizado correctamente, podrás ver los límites actuales de velocidad de descarga y carga en el panel de **detalles** de la pasarela.

## Actualización de los límites de ancho de banda de la pasarela mediante el AWS SDK para Java
<a name="MaintenanceUpdateBandwidthJava-common"></a>

Si actualiza los límites de velocidad del ancho de banda mediante programación, puede ajustar los límites automáticamente durante un periodo de tiempo, por ejemplo, mediante la utilización de tareas programadas. En el siguiente ejemplo se ilustra cómo actualizar los límites de velocidad del ancho de banda de una puerta de enlace mediante AWS SDK para Java. Para utilizar el código del ejemplo, debe haberse familiarizado con la ejecución de aplicaciones de la consola de Java. Para obtener más información, consulte [Introducción](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/java-dg-setup.html) en la *Guía para desarrolladores de AWS SDK para Java *. 

**Example : Actualización de los límites de ancho de banda de la puerta de enlace mediante el AWS SDK para Java**  
El siguiente ejemplo de código Java actualiza los límites de velocidad del ancho de banda de una puerta de enlace. Debe actualizar el código y proporcionar el punto de conexión de servicio, el Nombre de recurso de Amazon (ARN) de la puerta de enlace y los límites de carga y descarga. Para obtener una lista de los puntos de enlace de AWS servicio que puede usar con Storage Gateway, consulte [AWS Storage Gateway Puntos de conexión y cuotas](https://docs.aws.amazon.com/general/latest/gr/sg.html) en. *Referencia general de 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());
        }
    }        
}
```

## Actualización de los límites de ancho de banda de Gateway mediante el AWS SDK para .NET
<a name="MaintenanceUpdateBandwidthDotNet-common"></a>

Si actualiza los límites de velocidad del ancho de banda mediante programación, puede ajustar los límites automáticamente durante un periodo de tiempo, por ejemplo, mediante la utilización de tareas programadas. En el siguiente ejemplo se ilustra cómo actualizar los límites de velocidad del ancho de banda de una puerta de enlace mediante el AWS SDK para .NET. Para utilizar el código del ejemplo, debe haberse familiarizado con la ejecución de aplicaciones de la consola de .NET. Para obtener más información, consulte [Introducción](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/net-dg-setup.html) en la *Guía para desarrolladores de AWS SDK para .NET *. 

**Example : Actualización de los límites de ancho de banda de la puerta de enlace mediante el AWS SDK para .NET**  
El siguiente ejemplo de código C\# actualiza los límites de velocidad del ancho de banda de una puerta de enlace. Debe actualizar el código y proporcionar el punto de conexión de servicio, el Nombre de recurso de Amazon (ARN) de la puerta de enlace y los límites de carga y descarga. Para obtener una lista de los puntos de enlace de AWS servicio que puede usar con Storage Gateway, consulte [AWS Storage Gateway Puntos de conexión y cuotas](https://docs.aws.amazon.com/general/latest/gr/sg.html) en. *Referencia general de 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());
            }
        }
    }
}
```

## Actualización de los límites de ancho de banda de Gateway mediante el AWS Tools for Windows PowerShell
<a name="MaintenanceUpdateBandwidthPowerShell-common"></a>

Si actualiza los límites de velocidad del ancho de banda mediante programación, puede ajustar los límites automáticamente durante un periodo de tiempo, por ejemplo, mediante la utilización de tareas programadas. En el siguiente ejemplo se ilustra cómo actualizar los límites de velocidad del ancho de banda de una puerta de enlace mediante AWS Tools for Windows PowerShell. Para usar el código de ejemplo, debe estar familiarizado con la ejecución de un PowerShell script. Para obtener más información, consulte la [introducción](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-started.html) de la *Guía del usuario de Herramientas de AWS para PowerShell *. 

**Example : Actualización de los límites de ancho de banda de Gateway mediante el AWS Tools for Windows PowerShell**  
El siguiente ejemplo de PowerShell script actualiza los límites de ancho de banda de una puerta de enlace. Para utilizar este script de ejemplo, debe proporcionar el Nombre de recurso de Amazon (ARN) de la puerta de enlace y los límites de carga y descarga.   

```
<#
.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)
```