AWS SDK for .NET을 사용하여 Amazon S3 Glacier에서 볼트 메타데이터 검색

볼트 메타데이터 가져오기

특정 AWS 리전에 속하는 특정 볼트 또는 모든 볼트의 메타데이터를 검색할 수 있습니다. 다음은 AWS SDK for .NET의 저레벨 API를 사용해 특정 볼트의 메타데이터를 가져오는 단계입니다.

1. AmazonGlacierClient 클래스(클라이언트)의 인스턴스를 만듭니다.

   볼트가 속하는 AWS 리전을 지정해야 합니다. 이 클라이언트를 사용하여 실행하는 모든 작업이 해당 AWS 리전에 적용됩니다.

2. DescribeVaultRequest 클래스 인스턴스를 생성하여 요청 정보를 입력합니다.

   Amazon S3 Glacier(S3 Glacier)는 볼트 이름과 사용자 계정 ID를 요구합니다. 계정 ID를 입력하지 않는 경우에는 요청 서명을 위해 입력하는 자격 증명과 연결되어 있는 계정 ID로 간주합니다. 자세한 내용은 Amazon S3 Glacier와 함께 AWS SDK for .NET 사용 섹션을 참조하세요.

3. 요청 객체를 파라미터로 입력하여 DescribeVault 메서드를 실행합니다.

   S3 Glacier가 반환하는 볼트 메타데이터 정보는 DescribeVaultResult 객체에서 사용할 수 있습니다.

다음은 위에서 설명한 단계를 나타내는 C# 코드 조각입니다. 이 코드 조각은 미국 서부(오레곤) 리전에 속하는 기존 볼트에 대한 메타데이터 정보를 검색합니다.

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) 단원을 참조하십시오.

리전에 속하는 모든 볼트의 메타데이터 가져오기

ListVaults 방법을 사용하여 특정 AWS 리전에 속하는 모든 볼트의 메타데이터를 검색하는 방법도 있습니다.

다음은 미국 서부(오레곤)의 볼트 목록을 검색하는 C# 코드 조각입니다. 요청에 따라 응답으로 반환되는 볼트 수는 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 값을 지정하지 않으면 S3 Glacier가 S3 Glacier API의 설정에 따라 최대 10개의 볼트를 반환합니다.

참고로 목록의 각 볼트마다 반환되는 정보는 특정 볼트에서 DescribeVault 메서드를 호출하여 가져오는 정보와 동일합니다.

참고

ListVaults 메서드는 기본 REST API를 호출합니다(볼트 목록 조회(GET vaults) 참조).

예제: AWS SDK for .NET의 저레벨 API를 사용하는 볼트 메타데이터 가져오기

유효 코드 예제를 보려면 예제: AWS SDK for .NET의 저레벨 API를 사용하는 볼트 작업 단원을 참조하십시오. C# 코드 예제는 볼트를 생성한 후 볼트 메타데이터를 가져옵니다.