**此頁面僅適用於使用 Vaults 和 2012 年原始 REST API 的 Amazon Glacier 服務的現有客戶。**

如果您要尋找封存儲存解決方案，建議您在 Amazon Glacier Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive 中使用 Amazon Glacier 儲存類別。 Amazon S3 若要進一步了解這些儲存選項，請參閱 [Amazon Glacier 儲存類別](https://aws.amazon.com/s3/storage-classes/glacier/)。

Amazon Glacier （原始獨立保存庫型服務） 不再接受新客戶。Amazon Glacier 是一項獨立服務，具有自己的 APIs，可將資料存放在保存庫中，並與 Amazon S3 和 Amazon S3 Glacier 儲存類別不同。您現有的資料將在 Amazon Glacier 中無限期保持安全且可存取。不需要遷移。對於低成本、長期的封存儲存， AWS 建議使用 [Amazon S3 Glacier 儲存類別](https://aws.amazon.com/s3/storage-classes/glacier/)，透過 S3 儲存貯體型 APIs、完整 AWS 區域 可用性、降低成本 AWS 和服務整合，提供卓越的客戶體驗。如果您想要增強功能，請考慮使用我們的解決方案指南，將資料從 Amazon S3 Glacier 保存庫傳輸至 Amazon S3 Glacier 儲存類別，以遷移至 Amazon S3 Glacier 儲存類別。 [AWS Amazon Glacier Amazon S3 ](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/)

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 在 Amazon Glacier 中擷取保存庫中繼資料 適用於 .NET 的 AWS SDK
<a name="retrieving-vault-info-sdk-dotnet"></a>

**Topics**
+ [擷取保存庫的保存庫中繼資料](#retrieve-vault-info-sdk-dotnet-lowlevel-one-vault)
+ [擷取區域中所有保存庫的保存庫中繼資料](#retrieve-vault-info-sdk-dotnet-lowlevel-all-vaults)
+ [範例：使用 的低階 API 擷取保存庫中繼資料 適用於 .NET 的 AWS SDK](#creating-vaults-sdk-dotnet-example)

## 擷取保存庫的保存庫中繼資料
<a name="retrieve-vault-info-sdk-dotnet-lowlevel-one-vault"></a>

您可以擷取特定保存庫或特定 AWS 區域中所有保存庫的中繼資料。以下是使用 適用於 .NET 的 AWS SDK的低階 API 為特定保存庫擷取保存庫中繼資料的步驟。

 

1. 建立 `AmazonGlacierClient` 類別的執行個體 (用戶端)。

   您需要指定保存庫所在的 AWS 區域。您使用此用戶端執行的所有操作都會套用到該 AWS 區域。

1. 您可以透過建立 `DescribeVaultRequest` 類別的執行個體來提供請求資訊。

   Amazon Glacier (Amazon Glacier) 要求您提供保存庫名稱和帳戶 ID。如果您不提供帳戶 ID，則會使用與您提供來簽署請求之登入資料關聯的帳戶 ID。如需詳細資訊，請參閱[適用於 .NET 的 AWS SDK 搭配 Amazon Glacier 使用](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 保存庫)](api-vault-get.md)。

## 擷取區域中所有保存庫的保存庫中繼資料
<a name="retrieve-vault-info-sdk-dotnet-lowlevel-all-vaults"></a>

您也可以使用 `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 會傳回最多 10 個保存庫，如 Amazon Glacier API 所設定。

請注意，清單中為每個保存庫傳回的資訊與透過呼叫特定保存庫的 `DescribeVault` 方法所獲得的資訊相同。

 

**注意**  
`ListVaults` 方法呼叫底層 REST API (請參閱 [「列出保存庫」(GET 保存庫)](api-vaults-get.md))。

## 範例：使用 的低階 API 擷取保存庫中繼資料 適用於 .NET 的 AWS SDK
<a name="creating-vaults-sdk-dotnet-example"></a>

如需運作中程式碼範例，請參閱「[範例：使用 的低階 API 的保存庫操作 適用於 .NET 的 AWS SDK](creating-vaults-dotnet-sdk.md#vault-operations-example-dotnet-lowlevel)」。C\$1 程式碼範例建立保存庫和擷取保存庫中繼資料。