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á.
# Gerenciando a largura de banda do seu gateway de fitas
Você pode limitar (ou limitar) a taxa de transferência de upload do gateway para AWS ou a taxa de transferência de AWS download para seu gateway. Usar a limitação de largura de banda ajuda você a controlar a quantidade de largura de banda de rede usada pelo seu gateway. Por padrão, um gateway ativado não tem limites de taxa para upload ou download.
Você pode especificar o limite de taxa usando ou programaticamente usando a Console de gerenciamento da AWS API Storage Gateway (consulte [UpdateBandwidthRateLimit](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_UpdateBandwidthRateLimit.html)) ou um kit de desenvolvimento de AWS software (SDK). Com o controle de utilização programático da largura de banda, é possível alterar os limites automaticamente durante o dia como, por exemplo, programando tarefas para alterar a largura de banda.
Também é possível definir o controle de utilização de largura de banda baseada em agendamento para seu gateway. Você agenda a limitação da largura de banda definindo um ou mais intervalos. bandwidth-rate-limit Para obter mais informações, consulte [Controle de utilização da largura de banda por meio do agendamento usando o console do Storage Gateway](#SchedulingBandwidthThrottling).
**Definir uma única configuração para limitação de largura de banda é o equivalente funcional de definir uma programação com um único bandwidth-rate-limit intervalo definido para **todos os dias**, com uma hora de **início `00:00` e uma hora** de término de.** `23:59`
**nota**
As informações nesta seção são específicas para gateways de fitas e volumes. Para gerenciar a largura de banda de um gateway de arquivos do Amazon S3, consulte [Como gerenciar a largura de banda do gateway de arquivos do Amazon S3](https://docs.aws.amazon.com/filegateway/latest/files3/MaintenanceUpdateBandwidth-common.html). Atualmente, os limites de taxa de largura de banda não são suportados pelo Amazon FSx File Gateway.
**Topics**
+ [Como alterar o controle de utilização da largura de banda por meio do console do Storage Gateway](#MaintenanceUpdateBandwidthConsole-common)
+ [Controle de utilização da largura de banda por meio do agendamento 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)
## Como alterar o controle de utilização da largura de banda por meio do console do Storage Gateway
O procedimento a seguir mostra como alterar o controle de utilização da largura de banda de um gateway por meio do console do Storage Gateway.
**Para alterar o controle de largura de banda de um gateway por meio do console**
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 limite da taxa de largura de banda**.
1. Na caixa de diálogo **Editar limites de taxa**, insira os novos valores de limite e escolha **Salvar**. Suas alterações são exibidas na guia **Details** de seu gateway.
## Controle de utilização da largura de banda por meio do agendamento usando o console do Storage Gateway
O procedimento a seguir mostra como alterar o controle de utilização da largura de banda de um gateway usando o console do Storage Gateway.
**Para adicionar ou modificar um agendamento para controle de utilização da largura de banda do gateway**
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 do gateway é exibida na caixa de diálogo **Editar programação de limite de taxa de largura** de banda. Por padrão, uma nova bandwidth-rate-limit agenda de gateway está vazia.
1. Na caixa de diálogo **Editar programação de limite de taxa de largura** de banda, escolha **Adicionar novo item** para adicionar um novo bandwidth-rate-limit intervalo. Insira as seguintes informações para cada bandwidth-rate-limit intervalo:
+ **Dias da semana** — Você pode criar o bandwidth-rate-limit intervalo para os dias da semana (de segunda a sexta-feira), para fins de semana (sábado e domingo), para todos os dias da semana ou para um ou mais dias específicos da semana.
+ **Hora de término**: insira a hora de término para o intervalo de largura de banda no fuso horário local do gateway, usando o formato HH:MM.
**nota**
Seu bandwidth-rate-limit intervalo começa no início do minuto que você especifica aqui.
+ **Hora de término** — Insira a hora de término do bandwidth-rate-limit intervalo no fuso horário local do gateway, usando o formato HH:MM.
**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.
+ **Taxa de download**: insira o limite da taxa de download, em kilobits por segundo (Kbps), ou selecione **Sem limite** para desativar o controle de utilização da largura de banda para download. O valor mínimo da taxa de download é 100 Kbps.
+ **Taxa de upload**: insira o limite da taxa de upload, em Kbps, ou selecione **Sem limite** para desativar o controle de utilização da largura de banda para upload. O valor mínimo da taxa de upload é 50 Kbps.
Para modificar seus bandwidth-rate-limit intervalos, você pode inserir valores revisados para os parâmetros do intervalo.
Para remover seus bandwidth-rate-limit intervalos, você pode escolher **Remover** à direita do intervalo a ser excluído.
Quando você tiver concluído as alterações, escolha **Salvar**.
1. Continue adicionando bandwidth-rate-limit intervalos escolhendo **Adicionar novo item** e inserindo o dia, os horários de início e término e os limites de taxa de download e upload.
**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. Depois de inserir todos os bandwidth-rate-limit intervalos, escolha **Salvar alterações** para salvar sua bandwidth-rate-limit agenda.
Quando a bandwidth-rate-limit programação for atualizada com sucesso, você poderá ver os limites atuais da taxa de download e upload no painel **Detalhes** do gateway.
## Atualizando os limites de taxa de largura de banda do gateway usando o AWS SDK para Java
Ao atualizar programaticamente os limites de taxa de largura de banda, é possível ajustar limites automaticamente ao longo de um período como, 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. Você precisa atualizar o código e fornecer o endpoint de serviço, o nome do recurso da Amazon (ARN) para o gateway e os limites de upload e download. Para obter uma lista dos endpoints de AWS serviço que você pode usar com o Storage Gateway, consulte [AWS Storage Gateway Endpoints and Quotas](https://docs.aws.amazon.com/general/latest/gr/sg.html) no. *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.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());
}
}
}
```
## Atualizando os limites de taxa de largura de banda do gateway usando o AWS SDK para .NET
Ao atualizar programaticamente os limites de taxa de largura de banda, é possível ajustar limites automaticamente ao longo de um período como, por exemplo, usando tarefas programadas. O exemplo a seguir demonstra como atualizar os limites de taxa de largura de banda de um gateway por meio do AWS 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\# a seguir atualiza os limites de taxa de largura de banda de um gateway. Você precisa atualizar o código e fornecer o endpoint de serviço, o nome do recurso da Amazon (ARN) para o gateway e os limites de upload e download. Para obter uma lista dos endpoints de AWS serviço que você pode usar com o Storage Gateway, consulte [AWS Storage Gateway Endpoints and Quotas](https://docs.aws.amazon.com/general/latest/gr/sg.html) no. *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 = 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());
}
}
}
}
```
## Atualizando os limites de taxa de largura de banda do gateway usando o AWS Tools for Windows PowerShell
Ao atualizar programaticamente os limites de taxa de largura de banda, é possível ajustar limites automaticamente ao longo de um período como, 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. Você precisa atualizar este script de exemplo e fornecer o nome do recurso da Amazon (ARN) para o gateway e os limites de upload e download.
```
<#
.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)
```