

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Tape Gateway의 대역폭 관리
<a name="MaintenanceUpdateBandwidth-common"></a>

게이트웨이에서 로 업로드 처리량을 제한(또는 제한) AWS 하거나에서 게이트웨이로 다운로드 처리량을 제한(또는 제한) AWS 할 수 있습니다. 대역폭 제한을 사용하면 게이트웨이에서 사용하는 네트워크 대역폭의 양을 제어할 수 있습니다. 기본적으로 활성화된 게이트웨이에는 업로드 또는 다운로드에 대한 속도 제한이 없습니다.

를 사용하거나 Storage Gateway API([UpdateBandwidthRateLimit](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_UpdateBandwidthRateLimit.html) 참조) 또는 AWS 소프트웨어 개발 키트(SDK)를 사용하여 AWS Management Console프로그래밍 방식으로 속도 제한을 지정할 수 있습니다. 프로그래밍 방식으로 대역폭을 조절하면 작업을 예약하여 대역폭을 변경하는 등의 방식으로 하루 종일 자동으로 제한을 변경할 수 있습니다.

게이트웨이에 대해 일정 기반 대역폭 조절을 정의할 수도 있습니다. 대역폭 속도 제한 간격을 하나 이상 정의하여 대역폭 조절을 예약할 수 있습니다. 자세한 내용은 [Storage Gateway 콘솔을 사용한 일정 기반 대역폭 조절](#SchedulingBandwidthThrottling) 단원을 참조하십시오.

대역폭 조절에 대한 설정을 하나로 구성한다는 것은 **시작 시간**을 `00:00`, **종료 시간**을 `23:59`로 설정하여 **매일** 단일 대역폭 속도 제한 간격의 일정을 정의하는 것과 기능적으로 동일합니다.

**참고**  
이 섹션의 정보는 Tape Gateway 및 Volume Gateway에만 해당됩니다. Amazon S3 File Gateway의 대역폭을 관리하려면 [Amazon S3 File Gateway의 대역폭 관리](https://docs.aws.amazon.com/filegateway/latest/files3/MaintenanceUpdateBandwidth-common.html)를 참조하세요. 현재 Amazon FSx File Gateway에는 대역폭 속도 제한이 지원되지 않습니다.

**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 콘솔을 사용하여 대역폭 조절 변경
<a name="MaintenanceUpdateBandwidthConsole-common"></a>

다음은 Storage Gateway 콘솔에서 게이트웨이의 대역폭 조절을 변경하는 방법을 보여주는 절차입니다.

**콘솔을 사용하여 게이트웨이의 대역폭 조절을 변경하려면**

1. Storage Gateway 콘솔([https://console.aws.amazon.com/storagegateway/home](https://console.aws.amazon.com/storagegateway/))을 엽니다.

1. 왼쪽 탐색 창에서 **게이트웨이**를 선택한 다음 관리할 게이트웨이를 선택합니다.

1. **작업**에서 **대역폭 제한 편집**을 선택합니다.

1. **속도 제한 편집** 대화 상자에서 새 제한 값을 입력한 다음 **저장**을 선택합니다. 변경 사항은 해당 게이트웨이의 **세부 정보** 탭에 표시됩니다.

## Storage Gateway 콘솔을 사용한 일정 기반 대역폭 조절
<a name="SchedulingBandwidthThrottling"></a>

다음은 Storage Gateway 콘솔에서 게이트웨이의 대역폭 조절 변경을 예약하는 방법을 보여 줍니다.

**게이트웨이 대역폭 조절 일정을 추가 또는 수정하려면**

1. Storage Gateway 콘솔([https://console.aws.amazon.com/storagegateway/home](https://console.aws.amazon.com/storagegateway/))을 엽니다.

1. 왼쪽 탐색 창에서 **게이트웨이**를 선택한 다음 관리할 게이트웨이를 선택합니다.

1. **작업**에서 **대역폭 속도 제한 일정 편집**을 선택합니다.

   게이트웨이의 대역폭 속도 제한 일정이 **대역폭 속도 제한 일정 편집** 대화 상자에 표시됩니다. 새 게이트웨이 대역폭 속도 제한 일정은 기본적으로 비어 있습니다.

1. **대역폭 속도 제한 일정 편집** 대화 상자에서 **새 항목 추가**를 선택하여 대역폭 속도 제한 간격을 새로 추가합니다. 각 대역폭 속도 제한 간격에 대해 다음 정보를 입력합니다.
   + **요일** - 대역폭 속도 제한 간격을 평일(월요일-금요일), 주말(토요일과 일요일), 모든 요일 또는 하나 이상의 특정 요일로 생성할 수 있습니다.
   + **시작 시간** - 대역폭 간격의 시작 시간을 게이트웨이의 현지 시간대(HH:MM 형식)로 입력합니다.
**참고**  
여기에 지정한 시간이 시작되면 대역폭 속도 제한 간격이 시작됩니다.
   + **종료 시간** - 대역폭 속도 제한 간격의 종료 시간을 게이트웨이의 현지 시간대(HH:MM 형식)로 입력합니다.
**중요**  
여기에 지정된 시간이 끝나면 대역폭 속도 제한 간격이 종료됩니다. 한 시간이 지나면 종료되는 간격을 예약하려면 **59**를 입력합니다.  
간격 사이에 중단 없이 시간 시작 시점에 전환되는 연속적인 간격을 예약하려면 첫 번째 간격의 종료 분에 **59**를 입력합니다. 다음 간격의 시작 분에는 **00**을 입력합니다.
   + **다운로드 속도** - 다운로드 속도 제한을 초당 킬로비트(Kbps) 단위로 입력하거나 **제한 없음**을 선택하여 다운로드를 위한 대역폭 조절을 비활성화합니다. 다운로드 속도의 최소값은 100Kbps입니다.
   + **업로드 속도** - 업로드 속도 제한을 Kbps 단위로 입력하거나 **제한 없음**을 선택하여 업로드를 위한 대역폭 조절을 비활성화합니다. 업로드 속도의 최소값은 50Kbps입니다.

   대역폭 속도 제한 간격을 수정하려면 간격 매개변수에 수정된 값을 입력합니다.

   대역폭 속도 제한 간격을 삭제하려면 삭제할 간격의 오른쪽에 있는 **제거**를 선택하면 됩니다.

   변경을 완료했으면 **저장**을 선택합니다.

1. **새 항목 추가**를 선택하고 날짜, 시작 및 종료 시간, 다운로드 및 업로드 속도 제한을 입력하여 대역폭 속도 제한 간격을 계속 추가합니다.
**중요**  
 대역폭 속도 제한 간격은 겹칠 수 없습니다. 간격의 시작 시간은 이전 간격의 종료 시간 이후, 다음 간격의 시작 시간 이전이어야 합니다.

1. 모든 대역폭 속도 제한 간격을 입력한 후 **변경사항 저장**을 선택하여 대역폭 속도 제한 일정을 저장합니다.

대역폭 속도 제한 일정이 성공적으로 업데이트되면 게이트웨이의 **세부 정보** 패널에서 현재 다운로드 및 업로드 속도 제한을 확인할 수 있습니다.

## 를 사용하여 게이트웨이 대역폭 속도 제한 업데이트 AWS SDK for Java
<a name="MaintenanceUpdateBandwidthJava-common"></a>

대역폭 속도 제한을 프로그래밍 방식으로 업데이트하면 일정 기간 동안 예약된 작업을 사용하는 등의 방법으로 자동으로 제한을 조정할 수 있습니다. 다음 예시는 AWS SDK for Java를 사용하여 게이트웨이의 대역폭 속도 제한을 업데이트하는 방법을 보여줍니다. 예시 코드를 사용하려면 Java 콘솔 애플리케이션을 실행하는 방법을 잘 알아야 합니다. 자세한 내용은AWS SDK for Java 개발자 안내서에서 [시작하기](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
<a name="MaintenanceUpdateBandwidthDotNet-common"></a>

대역폭 속도 제한을 프로그래밍 방식으로 업데이트하면 일정 기간 동안 예약된 작업을 사용하는 등의 방법으로 자동으로 제한을 조정할 수 있습니다. 다음 예시는 AWS SDK for .NET를 사용하여 게이트웨이의 대역폭 속도 제한을 업데이트하는 방법을 보여줍니다. 예시 코드를 사용하려면 .NET 콘솔 애플리케이션을 실행하는 방법을 잘 알아야 합니다. 자세한 내용은AWS SDK for .NET 개발자 안내서에서 [시작하기](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
<a name="MaintenanceUpdateBandwidthPowerShell-common"></a>

대역폭 속도 제한을 프로그래밍 방식으로 업데이트하면 일정 기간 동안 예약된 작업을 사용하는 등의 방법으로 자동으로 제한을 조정할 수 있습니다. 다음 예시는 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)
```