AWS SDK for Java를 사용하여 Amazon Glacier에서 볼트 메타데이터 검색 - Amazon Glacier
볼트 메타데이터 검색리전에 속하는 모든 볼트의 메타데이터 검색예제: Java를 사용한 볼트 작업

이 페이지는 볼트와 2012년부터 원래 REST API를 사용하는 Amazon Glacier 서비스의 기존 고객만 사용할 수 있습니다.

아카이브 스토리지 솔루션을 찾고 있다면 Amazon S3의 Amazon Glacier 스토리지 클래스, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval 및 S3 Glacier Deep Archive를 사용하는 것이 좋습니다. 이러한 스토리지 옵션에 대한 자세한 내용은 Amazon Glacier 스토리지 클래스를 참조하세요.

Amazon Glacier(기존 독립 실행형 볼트 기반 서비스)는 2025년 12월 15일부터 기존 고객에게 영향을 주지 않고 더 이상 신규 고객을 받지 않습니다. Amazon Glacier는 데이터를 볼트에 저장하고 Amazon S3 및 Amazon S3 Glacier 스토리지 클래스와 구별되는 자체 API를 갖춘 독립 실행형 서비스입니다. 기존 데이터는 Amazon Glacier에서 무기한으로 안전하게 보관되며 액세스 가능합니다. 마이그레이션은 필요하지 않습니다. 저비용 장기 아카이브 스토리지의 경우, AWS에서는 S3 버킷 기반 API, 전체 AWS 리전 가용성, 저렴한 비용 및 AWS 서비스 통합을 통해 우수한 고객 경험을 제공하는 Amazon S3 Glacier 스토리지 클래스를 권장합니다. 향상된 기능을 원하는 경우 Amazon Glacier 볼트에서 Amazon S3 Glacier 스토리지 클래스로 데이터를 전송하기 위한 AWS 솔루션 지침을 사용하여 Amazon S3 Glacier 스토리지 클래스로 마이그레이션하는 것이 좋습니다.

AWS SDK for Java를 사용하여 Amazon Glacier에서 볼트 메타데이터 검색

볼트 메타데이터 검색

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

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

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

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

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

  3. 요청 객체를 파라미터로 입력하여 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) 섹션을 참조하세요.

리전에 속하는 모든 볼트의 메타데이터 검색

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<DescribeVaultOutput> 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) 참조).

예제: Amazon SDK for Java를 사용하여 볼트 메타데이터 검색

유효 코드 예제를 보려면 예제: AWS SDK for Java를 사용하여 볼트 생성 섹션을 참조하세요. Java 코드 예제는 볼트를 생성한 후 볼트 메타데이터를 가져옵니다.