**이 페이지는 볼트와 2012년부터 원래 REST API를 사용하는 Amazon Glacier 서비스의 기존 고객만 사용할 수 있습니다.**
아카이브 스토리지 솔루션을 찾고 있다면 Amazon S3의 Amazon Glacier 스토리지 클래스, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval 및 S3 Glacier Deep Archive를 사용하는 것이 좋습니다. 이러한 스토리지 옵션에 대한 자세한 내용은 [Amazon Glacier 스토리지 클래스](https://aws.amazon.com/s3/storage-classes/glacier/)를 참조하세요.
Amazon Glacier(기존 독립 실행형 볼트 기반 서비스)는 더 이상 신규 고객을 받지 않습니다. Amazon Glacier는 데이터를 볼트에 저장하고 Amazon S3 및 Amazon S3 Glacier 스토리지 클래스와 구별되는 자체 API를 갖춘 독립 실행형 서비스입니다. 기존 데이터는 Amazon Glacier에서 무기한으로 안전하게 보관되며 액세스 가능합니다. 마이그레이션은 필요하지 않습니다. 저비용 장기 아카이브 스토리지의 경우는 [S3 버킷 기반 API, 전체 가용성, 저렴한 비용 및 서비스 통합을 통해 우수한 고객 경험을 제공하는 Amazon S3 Glacier 스토리지 클래스](https://aws.amazon.com/s3/storage-classes/glacier/)를 AWS 권장합니다. S3 APIs AWS 리전 AWS 향상된 기능을 원하는 경우 [Amazon Glacier 볼트에서 Amazon S3 Glacier 스토리지 클래스로 데이터를 전송하기 위한AWS 솔루션 지침](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/)을 사용하여 Amazon S3 Glacier 스토리지 클래스로 마이그레이션하는 것이 좋습니다.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon Glacier에서 볼트 메타데이터 검색
볼트 생성 날짜, 볼트의 아카이브 수, 볼트 내 모든 아카이브의 총 크기 등 볼트에 대한 정보를 검색할 수 있습니다. Amazon Glacier(Amazon Glacier)는 특정 볼트 또는 계정의 특정 AWS 리전에 있는 모든 볼트에 대해이 정보를 검색할 수 있는 API 호출을 제공합니다.
볼트 목록을 검색하는 경우 Amazon Glacier가 볼트 이름의 ASCII 값을 기준으로 정렬된 목록을 반환합니다. 목록에 포함되는 볼트 수는 최대 1,000개입니다. 응답은 항상 확인하여 목록을 계속 이어가는 마커가 있는지 살펴야 합니다. 항목이 더 이상 없는 경우에는 marker 필드가 `null` 값을 갖습니다. 응답으로 반환되는 볼트 수는 옵션으로 제한할 수 있습니다. 응답으로 반환할 볼트가 더 있는 경우에는 결과에 페이지가 매겨집니다. 이후 다음 볼트를 가져오려면 요청을 추가로 전송해야 합니다.
**Topics**
+ [를 사용하여 Amazon Glacier에서 볼트 메타데이터 검색 AWS SDK for Java](retrieving-vault-info-sdk-java.md)
+ [를 사용하여 Amazon Glacier에서 볼트 메타데이터 검색 AWS SDK for .NET](retrieving-vault-info-sdk-dotnet.md)
+ [REST API를 사용하여 볼트 메타데이터 검색](listing-vaults-rest-api.md)
+ [AWS Command Line Interface를 사용하여 Amazon Glacier에서 볼트 메타데이터 검색](retrieving-vault-info-cli.md)
# 를 사용하여 Amazon Glacier에서 볼트 메타데이터 검색 AWS SDK for Java
**Topics**
+ [볼트 메타데이터 검색](#retrieve-vault-info-sdk-java-lowlevel-one-vault)
+ [리전에 속하는 모든 볼트의 메타데이터 검색](#retrieve-vault-info-sdk-java-lowlevel-all-vaults)
+ [예제: Amazon SDK for Java를 사용하여 볼트 메타데이터 검색](#retrieving-vault-info-sdk-java-example)
## 볼트 메타데이터 검색
특정 볼트 또는 특정 AWS 리전의 모든 볼트에 대한 메타데이터를 검색할 수 있습니다. 다음은 Amazon SDK for Java의 로우레벨 API를 사용해 특정 볼트용 볼트 메타데이터를 검색하는 단계입니다.
1. `AmazonGlacierClient` 클래스(클라이언트)의 인스턴스를 만듭니다.
볼트가 있는 AWS 리전을 지정해야 합니다. 이 클라이언트를 사용하여 수행하는 모든 작업은 해당 AWS 리전에 적용됩니다.
1. `DescribeVaultRequest` 클래스 인스턴스를 생성하여 요청 정보를 입력합니다.
Amazon Glacier(Amazon Glacier)는 볼트 이름과 사용자의 계정 ID를 요구합니다. 계정 ID를 입력하지 않는 경우에는 요청 서명을 위해 입력하는 자격 증명과 연결되어 있는 계정 ID로 간주합니다. 자세한 내용은 [Amazon Glacier AWS SDK for Java 에서 사용](using-aws-sdk-for-java.md) 단원을 참조하십시오.
1. 요청 객체를 파라미터로 입력하여 `describeVault` 메서드를 실행합니다.
Amazon Glacier가 반환하는 볼트 메타데이터 정보는 `DescribeVaultResult` 객체에서 사용할 수 있습니다.
다음은 위에서 설명한 단계를 나타내는 Java 코드 조각입니다.
```
DescribeVaultRequest request = new DescribeVaultRequest()
.withVaultName("*** provide vault name***");
DescribeVaultResult result = client.describeVault(request);
System.out.print(
"\nCreationDate: " + result.getCreationDate() +
"\nLastInventoryDate: " + result.getLastInventoryDate() +
"\nNumberOfArchives: " + result.getNumberOfArchives() +
"\nSizeInBytes: " + result.getSizeInBytes() +
"\nVaultARN: " + result.getVaultARN() +
"\nVaultName: " + result.getVaultName());
```
**참고**
기본 REST API에 대한 자세한 내용은 [볼트 설명(GET vault)](api-vault-get.md) 섹션을 참조하세요.
## 리전에 속하는 모든 볼트의 메타데이터 검색
`listVaults` 메서드를 사용하여 특정 AWS 리전의 모든 볼트에 대한 메타데이터를 검색할 수도 있습니다.
다음은 `us-west-2` 리전에 속하는 볼트 목록을 가져오는 Java 코드 조각입니다. 요청에 따라 응답으로 반환되는 볼트 수는 5개로 제한됩니다. 그런 다음 코드 조각은 일련의 `listVaults` 호출을 수행하여 AWS 리전에서 전체 볼트 목록을 검색합니다.
```
AmazonGlacierClient client;
client.setEndpoint("https://glacier.us-west-2.amazonaws.com/");
String marker = null;
do {
ListVaultsRequest request = new ListVaultsRequest()
.withLimit("5")
.withMarker(marker);
ListVaultsResult listVaultsResult = client.listVaults(request);
List vaultList = listVaultsResult.getVaultList();
marker = listVaultsResult.getMarker();
for (DescribeVaultOutput vault : vaultList) {
System.out.println(
"\nCreationDate: " + vault.getCreationDate() +
"\nLastInventoryDate: " + vault.getLastInventoryDate() +
"\nNumberOfArchives: " + vault.getNumberOfArchives() +
"\nSizeInBytes: " + vault.getSizeInBytes() +
"\nVaultARN: " + vault.getVaultARN() +
"\nVaultName: " + vault.getVaultName());
}
} while (marker != null);
```
위의 코드 조각에서 요청 시에 `Limit`값을 지정하지 않으면 Amazon Glacier가 Amazon Glacier API의 설정에 따라 최대 10개까지 볼트를 반환합니다. 목록을 조회할 볼트가 더 있는 경우에는 응답 본문의 `marker` 필드에 새로운 요청과 함께 목록이 계속되는 지점에 볼트의 Amazon 리소스 이름(ARN)이 추가됩니다. 그렇지 않으면 `marker` 필드는 null 값을 갖습니다.
참고로 목록의 각 볼트마다 반환되는 정보는 특정 볼트에서 `describeVault` 메서드를 호출하여 가져오는 정보와 동일합니다.
**참고**
`listVaults` 메서드는 기본 REST API를 호출합니다([볼트 목록 조회(GET vaults)](api-vaults-get.md) 참조).
## 예제: Amazon SDK for Java를 사용하여 볼트 메타데이터 검색
유효 코드 예제를 보려면 [예제: AWS SDK for Java를 사용하여 볼트 생성](creating-vaults-sdk-java.md#creating-vaults-sdk-java-example) 섹션을 참조하세요. Java 코드 예제는 볼트를 생성한 후 볼트 메타데이터를 가져옵니다.
# 를 사용하여 Amazon Glacier에서 볼트 메타데이터 검색 AWS SDK for .NET
**Topics**
+ [볼트 메타데이터 검색](#retrieve-vault-info-sdk-dotnet-lowlevel-one-vault)
+ [리전에 속하는 모든 볼트의 메타데이터 검색](#retrieve-vault-info-sdk-dotnet-lowlevel-all-vaults)
+ [예:의 하위 수준 API를 사용하여 볼트 메타데이터 검색 AWS SDK for .NET](#creating-vaults-sdk-dotnet-example)
## 볼트 메타데이터 검색
특정 볼트 또는 특정 AWS 리전의 모든 볼트에 대한 메타데이터를 검색할 수 있습니다. 다음은 AWS SDK for .NET의 로우레벨 API를 사용해 특정 볼트의 메타데이터를 가져오는 단계입니다.
1. `AmazonGlacierClient` 클래스(클라이언트)의 인스턴스를 만듭니다.
볼트가 있는 AWS 리전을 지정해야 합니다. 이 클라이언트를 사용하여 수행하는 모든 작업은 해당 AWS 리전에 적용됩니다.
1. `DescribeVaultRequest` 클래스 인스턴스를 생성하여 요청 정보를 입력합니다.
Amazon Glacier(Amazon Glacier)는 볼트 이름과 사용자의 계정 ID를 요구합니다. 계정 ID를 입력하지 않는 경우에는 요청 서명을 위해 입력하는 자격 증명과 연결되어 있는 계정 ID로 간주합니다. 자세한 내용은 [Amazon Glacier와 함께 AWS SDK for .NET 사용](using-aws-sdk-for-dot-net.md) 단원을 참조하십시오.
1. 요청 객체를 파라미터로 입력하여 `DescribeVault` 메서드를 실행합니다.
Amazon Glacier가 반환하는 볼트 메타데이터 정보는 `DescribeVaultResult` 객체에서 사용할 수 있습니다.
다음은 위에서 설명한 단계를 나타내는 C\$1 코드 조각입니다. 이 코드 조각은 미국 서부(오레곤) 리전에 속하는 기존 볼트에 대한 메타데이터 정보를 검색합니다.
```
AmazonGlacierClient client;
client = new AmazonGlacierClient(Amazon.RegionEndpoint.USWest2);
DescribeVaultRequest describeVaultRequest = new DescribeVaultRequest()
{
VaultName = "*** Provide vault name ***"
};
DescribeVaultResponse describeVaultResponse = client.DescribeVault(describeVaultRequest);
Console.WriteLine("\nVault description...");
Console.WriteLine(
"\nVaultName: " + describeVaultResponse.VaultName +
"\nVaultARN: " + describeVaultResponse.VaultARN +
"\nVaultCreationDate: " + describeVaultResponse.CreationDate +
"\nNumberOfArchives: " + describeVaultResponse.NumberOfArchives +
"\nSizeInBytes: " + describeVaultResponse.SizeInBytes +
"\nLastInventoryDate: " + describeVaultResponse.LastInventoryDate
);
```
**참고**
기본 REST API에 대한 자세한 내용은 [볼트 설명(GET vault)](api-vault-get.md) 섹션을 참조하세요.
## 리전에 속하는 모든 볼트의 메타데이터 검색
`ListVaults` 메서드를 사용하여 특정 AWS 리전의 모든 볼트에 대한 메타데이터를 검색할 수도 있습니다.
다음은 미국 서부(오레곤)의 볼트 목록을 검색하는 C\$1 코드 조각입니다. 요청에 따라 응답으로 반환되는 볼트 수는 5개로 제한됩니다. 그런 다음 코드 조각은 일련의 `ListVaults` 호출을 수행하여 AWS 리전에서 전체 볼트 목록을 검색합니다.
```
AmazonGlacierClient client;
client = new AmazonGlacierClient(Amazon.RegionEndpoint.USWest2);
string lastMarker = null;
Console.WriteLine("\n List of vaults in your account in the specific AWS Region ...");
do
{
ListVaultsRequest request = new ListVaultsRequest()
{
Limit = 5,
Marker = lastMarker
};
ListVaultsResponse response = client.ListVaults(request);
foreach (DescribeVaultOutput output in response.VaultList)
{
Console.WriteLine("Vault Name: {0} \tCreation Date: {1} \t #of archives: {2}",
output.VaultName, output.CreationDate, output.NumberOfArchives);
}
lastMarker = response.Marker;
} while (lastMarker != null);
```
위의 코드 조각에서 요청 시에 `Limit`값을 지정하지 않으면 Amazon Glacier가 Amazon Glacier API의 설정에 따라 최대 10개까지 볼트를 반환합니다.
참고로 목록의 각 볼트마다 반환되는 정보는 특정 볼트에서 `DescribeVault` 메서드를 호출하여 가져오는 정보와 동일합니다.
**참고**
`ListVaults` 메서드는 기본 REST API를 호출합니다([볼트 목록 조회(GET vaults)](api-vaults-get.md) 참조).
## 예:의 하위 수준 API를 사용하여 볼트 메타데이터 검색 AWS SDK for .NET
유효 코드 예제를 보려면 [예:의 하위 수준 API를 사용한 볼트 작업 AWS SDK for .NET](creating-vaults-dotnet-sdk.md#vault-operations-example-dotnet-lowlevel) 섹션을 참조하세요. C\$1 코드 예제는 볼트를 생성한 후 볼트 메타데이터를 가져옵니다.
# REST API를 사용하여 볼트 메타데이터 검색
REST API를 사용하여 볼트 목록을 조회하려면 [볼트 목록 조회(GET vaults)](api-vaults-get.md) 섹션을 참조하세요. 하나의 볼트에 대해 설명하려면 [볼트 설명(GET vault)](api-vault-get.md) 섹션을 참조하세요.
# AWS Command Line Interface를 사용하여 Amazon Glacier에서 볼트 메타데이터 검색
이 예시에서는 AWS Command Line Interface(AWS CLI)를 사용하여 Amazon Glacier(Amazon Glacier)에서 볼트 정보 및 메타데이터를 검색하는 방법을 보여줍니다.
**Topics**
+ [(전제 조건) AWS CLI 설정](#Creating-Vaults-CLI-Setup)
+ [예제: AWS CLI를 사용하여 볼트 메타데이터 검색](#Retrieving-Vault-Metadata-CLI-Implementation)
## (전제 조건) AWS CLI 설정
1. AWS CLI를 다운로드하고 구성합니다. 관련 지침은 *AWS Command Line Interface 사용 설명서*에서 다음 토픽을 참조하세요.
[AWS Command Line Interface 설치](https://docs.aws.amazon.com/cli/latest/userguide/installing.html)
[AWS Command Line Interface 구성](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html)
1. 명령 프롬프트에 다음 명령을 입력하여 사용자의 AWS CLI 설정을 확인합니다. 이러한 명령은 명시적으로 자격 증명을 제공하지 않으므로 기본 프로파일의 자격 증명이 사용됩니다.
+ help 명령을 사용해 보십시오.
```
aws help
```
+ 구성된 계정의 Amazon Glacier 볼트 목록을 가져오려면 `list-vaults` 명령을 사용합니다. *123456789012*를 사용자의 AWS 계정 ID로 바꿉니다.
```
aws glacier list-vaults --account-id 123456789012
```
+ AWS CLI를 위한 현재 구성데이터를 보려면 `aws configure list` 명령을 사용합니다.
```
aws configure list
```
## 예제: AWS CLI를 사용하여 볼트 메타데이터 검색
+ `describe-vault` 명령을 사용하여 *111122223333* 계정에 있는 *awsexamplevault*라는 이름의 볼트를 설명하세요.
```
aws glacier describe-vault --vault-name awsexamplevault --account-id 111122223333
```