翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# ボリュームゲートウェイの帯域幅管理
ゲートウェイから へのアップロードスループット AWS 、または からゲートウェイ AWS へのダウンロードスループットを制限 (またはスロットリング) できます。帯域幅スロットリングを使用すると、ゲートウェイで使用されるネットワーク帯域幅の量を制御できます。デフォルトでは、アクティブ化されたゲートウェイには、アップロードまたはダウンロードのレート制限はありません。
レート制限を指定するには、 を使用するか AWS マネジメントコンソール、プログラムで Storage Gateway API ([UpdateBandwidthRateLimit](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_UpdateBandwidthRateLimit.html) を参照) または AWS Software Development Kit (SDK) を使用します。帯域幅をプログラムでスロットリングすることで (例えば、帯域幅を変更するようにタスクをスケジュールすることで)、制限を 1 日を通して自動的に変更することができます。
スケジュールベースでゲートウェイの帯域幅スロットリングを定義することもできます。帯域幅スロットリングをスケジュールするには、帯域幅レート制限期間を 1 つ以上定義します。詳細については、「[Storage Gateway コンソールを使用したスケジュールベースの帯域幅スロットリング](#SchedulingBandwidthThrottling)」を参照してください。
帯域幅スロットリングの設定を 1 つにする場合、機能的には、**[毎日]**、**[開始時刻]** = `00:00`、**[終了時刻]** = `23:59` という単一の帯域幅レート制限期間でスケジュールを定義することと同じです。
**注記**
このセクションの情報は、テープゲートウェイとボリュームゲートウェイに固有の情報です。Amazon S3 ファイルゲートウェイの帯域幅を管理するには、「[Managing Bandwidth for Your Amazon S3 File Gateway](https://docs.aws.amazon.com/filegateway/latest/files3/MaintenanceUpdateBandwidth-common.html)」を参照してください。Amazon FSx ファイルゲートウェイでは、現時点では、帯域幅レート制限はサポートされていません。
**Topics**
+ [Storage Gateway コンソールを使用して帯域幅スロットリングを変更する](#MaintenanceUpdateBandwidthConsole-common)
+ [Storage Gateway コンソールを使用したスケジュールベースの帯域幅スロットリング](#SchedulingBandwidthThrottling)
+ [を使用したゲートウェイ帯域幅レート制限の更新 AWS SDK for Java](#MaintenanceUpdateBandwidthJava-common)
+ [を使用したゲートウェイ帯域幅レート制限の更新 AWS SDK for .NET](#MaintenanceUpdateBandwidthDotNet-common)
+ [を使用したゲートウェイ帯域幅レート制限の更新 AWS Tools for Windows PowerShell](#MaintenanceUpdateBandwidthPowerShell-common)
## Storage Gateway コンソールを使用して帯域幅スロットリングを変更する
次の手順は、Storage Gateway コンソールを使用してゲートウェイの帯域幅スロットリングを変更する方法を示しています。
**コンソールを使用してゲートウェイの帯域幅スロットルを変更するには**
1. Storage Gateway コンソール ([https://console.aws.amazon.com/storagegateway/home](https://console.aws.amazon.com/storagegateway/)) を開きます。
1. 左側のナビゲーションペインで **[ゲートウェイ]** を選択してから、管理対象のゲートウェイを選択します。
1. **[アクション]** で、**[帯域幅レート制限の編集]** を選択します。
1. **[速度制限の編集]** ダイアログボックスで、新しい制限値を入力し、**[保存]** をクリックします。変更はゲートウェイの [**Details**] タブに表示されます。
## Storage Gateway コンソールを使用したスケジュールベースの帯域幅スロットリング
次の手順は、Storage Gateway コンソールを使用してゲートウェイの帯域幅スロットリングのスケジュールを変更する方法を示しています。
**ゲートウェイ帯域幅スロットリングのスケジュールを追加または変更するには**
1. Storage Gateway コンソール ([https://console.aws.amazon.com/storagegateway/home](https://console.aws.amazon.com/storagegateway/)) を開きます。
1. 左側のナビゲーションペインで **[ゲートウェイ]** を選択してから、管理対象のゲートウェイを選択します。
1. **[Actions (アクション)]** で、**[Edit bandwidth rate limit schedule (帯域幅レート制限スケジュールの編集)]** を選択します。
ゲートウェイの帯域幅レート制限スケジュールは、**[帯域幅レート制限スケジュールの編集]** ダイアログボックスに表示されます。デフォルトでは、新しいゲートウェイ帯域幅レート制限スケジュールは空です。
1. **[帯域幅レート制限スケジュールの編集]** ダイアログボックスで、**[新しいエントリの追加]** を選択して、新しい帯域幅レート制限の期間を追加します。帯域幅レート制限期間ごとに次の情報を入力します。
+ **[曜日]** – 平日 (月曜日から金曜日)、週末 (土曜日と日曜日)、すべての曜日、または 1 つ以上の特定の曜日について、帯域幅レート制限期間を作成できます。
+ **[開始時刻]** – ゲートウェイのローカルタイムゾーンを使用して、帯域幅期間の開始時刻を HH:MM 形式で入力します。
**注記**
帯域幅レート制限期間は、ここで分単位で指定した 1 分間の最初から始まります。
+ **[終了時刻]** – ゲートウェイのローカルタイムゾーンを使用して、帯域幅レート制限の期間の終了時刻を HH:MM 形式で入力します。
**重要**
帯域幅レート制限期間は、ここで分単位で指定した 1 分間の最後に終了します。1 時間の終わりに終了する期間をスケジュールするには、「**59**」と入力します。
連続する期間を続けてスケジュールする際に、1 時間の開始時に移行し、期間の間に中断がないようにするには、最初の期間の終了時間を「**59**」分と入力します。後の期間の開始時間は、「**00**」分と入力します。
+ **[ダウンロード速度]** – ダウンロードのレート制限をキロビット/秒 (Kbps) で入力するか、**[無制限]** を選択して、ダウンロードの帯域幅スロットリングを無効にします。ダウンロード速度の最小値は 100 Kbps です。
+ **[アップロード速度]** – アップロードのレート制限をキロビット/秒 (Kbps) で入力するか、**[無制限]** を選択して、アップロードの帯域幅スロットリングを無効にします。アップロード速度の最小値は 50 Kbps です。
帯域幅レート制限期間を変更するには、期間パラメータの変更後の値を入力します。
帯域幅レート制限期間を削除するには、削除対象の期間の右側にある **[削除]** をクリックします。
変更が完了したら、**[保存]** をクリックします。
1. 引き続き帯域幅レート制限期間を追加するには、**[新しいエントリの追加]** を選択し、曜日、開始時刻と終了時刻、ダウンロードおよびアップロードのレート制限を入力します。
**重要**
帯域幅レート制限期間を重複させることはできません。期間の開始時間は、前の期間の終了時間より後、かつ、次の区間の開始時間より前である必要があります。
1. すべての帯域幅レート制限期間を入力したら、**[保存]** をクリックして、帯域幅レート制限スケジュールを保存します。
帯域幅レート制限スケジュールが正常に更新されると、現在のダウンロードおよびアップロードのレート制限がゲートウェイの **[詳細]** パネルに表示されます。
## を使用したゲートウェイ帯域幅レート制限の更新 AWS SDK for Java
帯域幅レート制限をプログラムで更新することで (例えば、スケジュールされたタスクを使用することで)、一定期間にわたって制限を自動的に調整できます。次の例は、 AWS SDK for Javaを使用して、ゲートウェイの帯域幅レート制限を更新する方法を示しています。サンプルコードを使用するには、Java コンソールアプリケーションの実行について理解している必要があります。詳細については、*AWS SDK for Java デベロッパーガイド*の「[Getting Started](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/java-dg-setup.html)」を参照してください。
**Example : を使用したゲートウェイ帯域幅レート制限の更新 AWS SDK for Java**
次の Java コードの例では、ゲートウェイの帯域幅レート制限を更新します。このサンプルコードを使用するには、サービスエンドポイント、ゲートウェイ Amazon リソースネーム（ARN）、およびアップロード制限とダウンロード制限を指定する必要があります。Storage Gateway で使用できる AWS サービスエンドポイントのリストについては、の[AWS Storage Gateway 「エンドポイントとクォータ](https://docs.aws.amazon.com/general/latest/gr/sg.html)」を参照してください*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());
}
}
}
```
## を使用したゲートウェイ帯域幅レート制限の更新 AWS SDK for .NET
帯域幅レート制限をプログラムで更新することで (例えば、スケジュールされたタスクを使用することで)、一定期間にわたって制限を自動的に調整できます。次の例は、 AWS SDK for .NETを使用して、ゲートウェイの帯域幅レート制限を更新する方法を示しています。サンプルコードを使用するには、.NET コンソールアプリケーションの実行について理解している必要があります。詳細については、*AWS SDK for .NET デベロッパーガイド*の「[Getting Started](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/net-dg-setup.html)」を参照してください。
**Example : を使用してゲートウェイ帯域幅レート制限を更新する AWS SDK for .NET**
次の C\# コードの例では、ゲートウェイの帯域幅レート制限を更新します。このサンプルコードを使用するには、サービスエンドポイント、ゲートウェイ Amazon リソースネーム（ARN）、およびアップロード制限とダウンロード制限を指定する必要があります。Storage Gateway で使用できる AWS サービスエンドポイントのリストについては、の[AWS Storage Gateway 「エンドポイントとクォータ](https://docs.aws.amazon.com/general/latest/gr/sg.html)」を参照してください*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());
}
}
}
}
```
## を使用したゲートウェイ帯域幅レート制限の更新 AWS Tools for Windows PowerShell
帯域幅レート制限をプログラムで更新することで (例えば、スケジュールされたタスクを使用することで)、一定期間にわたって制限を自動的に調整できます。次の例は、 AWS Tools for Windows PowerShellを使用して、ゲートウェイの帯域幅レート制限を更新する方法を示しています。サンプルコードを使用するには、PowerShell スクリプトの実行について理解している必要があります。詳細については、*AWS Tools for PowerShell ユーザーガイド*の「[使用開始](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-started.html)」を参照してください。
**Example : を使用してゲートウェイ帯域幅レート制限を更新する AWS Tools for Windows PowerShell**
次の PowerShell スクリプトの例では、ゲートウェイの帯域幅レート制限を更新します。このサンプルスクリプトを使用するには、ゲートウェイ Amazon リソースネーム (ARN)、およびアップロード制限とダウンロード制限を指定する必要があります。
```
<#
.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)
```