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 para la puerta de enlace de archivo de Amazon S3
Puede limitar el rendimiento de carga desde su puerta de enlace AWS para controlar la cantidad de ancho de banda de red que utiliza la puerta de enlace. De forma predeterminada, una puerta de enlace activada no tiene límites de carga o descarga.
Puede configurar una bandwidth-rate-limit programación mediante el Consola de administración de AWS kit de desarrollo de AWS software (SDK) o la AWS Storage Gateway API (consulte la *referencia de [UpdateBandwidthRateLimitSchedule](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_UpdateBandwidthRateLimitSchedule.html)la API AWS de Storage Gateway*). Al utilizar una programación de límite de velocidad de ancho de banda, puede configurar los límites para que cambien automáticamente a lo largo del día o de la semana. Para obtener más información, consulte [Vea y edite la bandwidth-rate-limit programación de su gateway mediante la consola Storage Gateway](#SchedulingBandwidthThrottling).
Puede supervisar el rendimiento de carga de su pasarela mediante la `CloudBytesUploaded` métrica de la pestaña **Monitorización** de la consola de Storage Gateway o en Amazon CloudWatch.
**nota**
Los límites de velocidad de ancho de banda se aplican únicamente a las cargas de archivos de Storage Gateway. El resto de las operaciones de puerta de enlace no se ven afectadas.
La limitación de la velocidad de ancho de banda funciona equilibrando el rendimiento de todos los archivos que se cargan, promediado a lo largo de cada segundo. Si bien es posible que las cargas superen brevemente el límite de velocidad de ancho de banda durante un microsegundo o milisegundo determinado, esto no suele provocar picos importantes durante periodos de tiempo más prolongados.
Actualmente, el tipo Amazon FSx File Gateway no admite la configuración de límites y horarios de velocidad de ancho de banda.
**Topics**
+ [Vea y edite la bandwidth-rate-limit programación de su gateway mediante la consola Storage Gateway](#SchedulingBandwidthThrottling)
+ [Actualización de los límites de ancho de banda de la puerta de enlace mediante el AWS SDK para Java](#MaintenanceUpdateBandwidthJava-common)
+ [Actualización de los límites de ancho de banda de la puerta de enlace mediante el AWS SDK para .NET](#MaintenanceUpdateBandwidthDotNet-common)
+ [Actualización de los límites de ancho de banda de la puerta de enlace mediante el AWS Tools for Windows PowerShell](#MaintenanceUpdateBandwidthPowerShell-common)
## Vea y edite la bandwidth-rate-limit programación de su gateway mediante la consola Storage Gateway
En esta sección, se describe cómo ver y editar la programación de límite de velocidad de ancho de banda de su puerta de enlace.
**Cómo ver y editar la programación de límite de velocidad de ancho de banda**
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 actual de la puerta de enlace se muestra en la página **Editar la programación del límite de velocidad de ancho** de banda. De forma predeterminada, una puerta de enlace nueva no tiene límites de velocidad de ancho de banda definidos.
1. (Opcional) Seleccione **Agregar nuevo límite de velocidad de ancho de banda** para agregar un nuevo intervalo configurable a la programación. Para cada intervalo que agregue, introduzca la siguiente información:
+ **Velocidad de carga**: introduzca el límite de velocidad de carga, en megabits por segundo (Mbps). El valor mínimo es 100 Mbps.
+ **Días de la semana**: seleccione el día o los días durante los que desee que se aplique el intervalo. Puede aplicar el intervalo los días laborables (de lunes a viernes), los fines de semana (sábados y domingos), todos los días de la semana o un día específico de la semana. Para aplicar el límite de ancho de banda de manera uniforme y constante todos los días y en todo momento, elija **Sin programación**.
+ **Hora de inicio**: introduzca la hora de inicio del intervalo de ancho de banda utilizando el formato HH:MM y desplazamiento de la zona horaria a partir de UTC para la puerta de enlace.
**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 intervalo de ancho de banda utilizando el formato HH:MM y desplazamiento de la zona horaria a partir de GMT para la puerta de enlace.
**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.
1. (Opcional) Repita el paso anterior según sea necesario hasta completar la bandwidth-rate-limit programación. Si necesita eliminar un intervalo de la programación, elija **Eliminar**.
**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. Cuando haya finalizado, elija **Guardar cambios**.
## Actualización de los límites de ancho de banda de la puerta de enlace mediante el AWS SDK para Java
Si actualiza los límites de velocidad de ancho de banda mediante programación, puede ajustar estos 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 Gateway 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 el límite de carga. Para obtener una lista de los puntos de conexión de servicio de AWS con los que puede utilizar Storage Gateway, consulte [Puntos de enlace y cuotas de AWS Storage Gateway](https://docs.aws.amazon.com/general/latest/gr/sg.html) en la *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. 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());
}
}
}
```
## Actualización de los límites de ancho de banda de la puerta de enlace mediante el AWS SDK para .NET
Si actualiza los límites de velocidad de ancho de banda mediante programación, puede ajustar estos límites automáticamente durante un periodo de tiempo, por ejemplo, mediante la utilización de tareas programadas. El siguiente ejemplo muestra cómo actualizar los límites de ancho de banda de una puerta de enlace mediante el kit de desarrollo de AWS software (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\$1 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 el límite de carga. Para obtener una lista de los puntos de conexión de servicio de AWS con los que puede utilizar Storage Gateway, consulte [Puntos de enlace y cuotas de AWS Storage Gateway](https://docs.aws.amazon.com/general/latest/gr/sg.html) en la *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 = 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 bandwidthRateLimitIntervals = new List();
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());
}
}
}
}
```
## Actualización de los límites de ancho de banda de la puerta de enlace mediante el AWS Tools for Windows PowerShell
Si actualiza los límites de velocidad de ancho de banda mediante programación, puede ajustar estos 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 el límite de carga.
```
<#
.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)
```