As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Gerenciar a largura de banda de um Gateway de Arquivos do Amazon S3
Você pode limitar a taxa de transferência de upload do seu gateway para controlar AWS a quantidade de largura de banda de rede que o gateway usa. Por padrão, um gateway ativado não tem limites para taxas.
Você pode configurar um bandwidth-rate-limit cronograma usando o Console de gerenciamento da AWS, um kit de desenvolvimento de AWS software (SDK) ou a AWS Storage Gateway API (consulte [UpdateBandwidthRateLimitSchedule](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_UpdateBandwidthRateLimitSchedule.html)a *referência da API do AWS Storage Gateway*). Ao usar uma programação de limite de taxa de largura de banda, é possível configurar limites para serem alterados automaticamente ao longo do dia ou da semana. Para obter mais informações, consulte [Visualize e edite a bandwidth-rate-limit programação do seu gateway usando o console do Storage Gateway](#SchedulingBandwidthThrottling).
Você pode monitorar a taxa de transferência de upload do seu gateway usando a `CloudBytesUploaded` métrica na guia **Monitoramento** no console do Storage Gateway ou na Amazon CloudWatch.
**nota**
Os limites de taxa de largura de banda se aplicam somente aos uploads de arquivos do Storage Gateway. Outras operações de gateway não são afetadas.
A limitação da taxa de largura de banda funciona equilibrando o throughput de todos os arquivos cujo upload é feito, calculada com base na média por segundo. Embora seja possível que os uploads ultrapassem brevemente o limite da taxa de largura de banda por um determinado micro ou milissegundo, isso normalmente não resulta em grandes picos por longos períodos.
Atualmente, não há suporte para a configuração de limites e horários de taxa de largura de banda para o tipo Amazon FSx File Gateway.
**Topics**
+ [Visualize e edite a bandwidth-rate-limit programação do seu gateway usando o console do Storage Gateway](#SchedulingBandwidthThrottling)
+ [Atualizando os limites de taxa de largura de banda do gateway usando o AWS SDK para Java](#MaintenanceUpdateBandwidthJava-common)
+ [Atualizando os limites de taxa de largura de banda do gateway usando o AWS SDK para .NET](#MaintenanceUpdateBandwidthDotNet-common)
+ [Atualizando os limites de taxa de largura de banda do gateway usando o AWS Tools for Windows PowerShell](#MaintenanceUpdateBandwidthPowerShell-common)
## Visualize e edite a bandwidth-rate-limit programação do seu gateway usando o console do Storage Gateway
Esta seção descreve como visualizar e editar a programação de limite de taxa de largura de banda para o gateway.
**Como visualizar e editar a programação do limite da taxa de largura de banda**
1. Abra o console do Storage Gateway em [https://console.aws.amazon.com/storagegateway/casa](https://console.aws.amazon.com/storagegateway/).
1. No painel de navegação, escolha **Gateways** e, em seguida, o gateway que você deseja gerenciar.
1. Em **Ações**, escolha **Editar programação do limite da taxa de largura de banda**.
A bandwidth-rate-limit programação atual do gateway é exibida na página **Editar programação de limite de taxa de largura de** banda. Por padrão, um gateway novo não tem nenhum limite de taxa de largura de banda definido.
1. (Opcional) Escolha **Adicionar novo limite de taxa de largura de banda** para adicionar um novo intervalo configurável à programação. Para cada intervalo adicionado, insira as seguintes informações:
+ **Taxa de upload**: insira o limite da taxa de upload, em megabits por segundo (Mbps). O valor mínimo é 100 Mbps.
+ **Dias da semana**: selecione o dia ou dias da semana em que deseja que o intervalo seja aplicado. Você pode aplicar o intervalo em dias úteis (segunda a sexta-feira), fins de semana (sábado e domingo), todos os dias da semana ou em um dia específico por semana. Para aplicar o limite de taxa de largura de banda de maneira uniforme e constante em todos os dias e em todos os horários, escolha **Sem programação**.
+ **Hora de início**: insira a hora de início do intervalo de largura de banda, usando o formato HH:MM e o fuso horário em relação ao UTC para o seu gateway.
**nota**
Seu bandwidth-rate-limit intervalo começa no início do minuto especificado aqui.
+ **Hora de término**: insira a hora de término do intervalo de largura de banda, usando o formato HH:MM e o fuso horário em relação ao GMT para o seu gateway.
**Importante**
O bandwidth-rate-limit intervalo termina no final do minuto especificado aqui. Para agendar um intervalo que termine no final de uma hora, insira **59**.
Para programar intervalos contínuos consecutivos, fazendo a transição no início da hora, sem interrupção entre os intervalos, insira **59** para o minuto final do primeiro intervalo. Insira **00** para o minuto inicial do intervalo seguinte.
1. (Opcional) Repita a etapa anterior conforme necessário até que sua bandwidth-rate-limit programação seja concluída. Se precisar excluir um intervalo da sua agenda, escolha **Remover**.
**Importante**
Bandwidth-rate-limitos intervalos não podem se sobrepor. A hora de início de um intervalo deve ocorrer após a hora de término de um intervalo anterior e antes da hora de início de um intervalo seguinte.
1. Ao concluir, escolha **Salvar alterações**.
## Atualizando os limites de taxa de largura de banda do gateway usando o AWS SDK para Java
Ao atualizar os limites de taxa de largura de banda de forma programática, é possível ajustá-los automaticamente ao longo de um período, por exemplo, usando tarefas programadas. O exemplo a seguir demonstra como atualizar os limites de taxa de largura de banda de um gateway usando o AWS SDK para Java. Para usar o código de exemplo, você deve estar familiarizado com a execução de aplicativos em console Java. Para obter mais informações, consulte [Conceitos básicos](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/java-dg-setup.html) no *Guia do desenvolvedor do AWS SDK para Java *.
**Example : Atualizando os limites de taxa de largura de banda do gateway usando o AWS SDK para Java**
O exemplo de código Java a seguir atualiza os limites de taxa de largura de banda de um gateway. Para usar este exemplo de código, você deve fornecer o endpoint de serviço, o nome do recurso da Amazon (ARN) do gateway e o limite de upload. Para obter uma lista de endpoints de serviço da AWS com os quais é possível usar o Storage Gateway, consulte [Endpoints e cotas do AWS Storage Gateway](https://docs.aws.amazon.com/general/latest/gr/sg.html) na *Referência geral da 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());
}
}
}
```
## Atualizando os limites de taxa de largura de banda do gateway usando o AWS SDK para .NET
Ao atualizar os limites de taxa de largura de banda de forma programática, é possível ajustá-los automaticamente ao longo de um período, por exemplo, usando tarefas programadas. O exemplo a seguir demonstra como atualizar os limites de taxa de largura de banda de um gateway usando o AWS Software Development Kit (SDK) para.NET. Para usar o código de exemplo, você deve estar familiarizado com a execução de aplicativos em console do .NET. Para obter mais informações, consulte [Conceitos básicos](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/net-dg-setup.html) no *Guia do desenvolvedor do AWS SDK para .NET *.
**Example : Atualizando os limites de taxa de largura de banda do gateway usando o AWS SDK para .NET**
O exemplo de código C\$1 a seguir atualiza os limites de taxa de largura de banda de um gateway. Para usar este exemplo de código, você deve fornecer o endpoint de serviço, o nome do recurso da Amazon (ARN) do gateway e o limite de upload. Para obter uma lista de endpoints de serviço da AWS com os quais é possível usar o Storage Gateway, consulte [Endpoints e cotas do AWS Storage Gateway](https://docs.aws.amazon.com/general/latest/gr/sg.html) na *Referência geral da 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());
}
}
}
}
```
## Atualizando os limites de taxa de largura de banda do gateway usando o AWS Tools for Windows PowerShell
Ao atualizar os limites de taxa de largura de banda de forma programática, é possível ajustá-los automaticamente ao longo de um período, por exemplo, usando tarefas programadas. O exemplo a seguir demonstra como atualizar os limites de taxa de largura de banda de um gateway usando o AWS Tools for Windows PowerShell. Para usar o código de exemplo, você deve estar familiarizado com a execução de um PowerShell script. Para obter mais informações, consulte [Conceitos básicos](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-started.html) no *Guia do usuário do Ferramentas da AWS para PowerShell *.
**Example : Atualizando os limites de taxa de largura de banda do gateway usando o AWS Tools for Windows PowerShell**
O exemplo de PowerShell script a seguir atualiza os limites da taxa de largura de banda de um gateway. Para usar este exemplo de script, você deve fornecer o nome do recurso da Amazon (ARN) do gateway e o limite de upload.
```
<#
.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)
```