Recupero di metadati di vault in Amazon S3 Glacier mediante l'AWS SDK for .NET - Amazon S3 Glacier
Recupero di metadati di vault per un vaultRecupero di metadati di vault per tutti i vault in una regioneEsempio: operazioni di vault con .NET

Questa pagina è riservata ai clienti esistenti del servizio S3 Glacier che utilizzano Vaults e l'API REST originale del 2012.

Se stai cercando soluzioni di archiviazione, ti consigliamo di utilizzare le classi di storage S3 Glacier in Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive. Per ulteriori informazioni su queste opzioni di storage, consulta le classi di storage S3 Glacier e lo storage dei dati a lungo termine con le classi di storage S3 Glacier nella Amazon S3 User Guide. Queste classi di storage utilizzano l'API Amazon S3, sono disponibili in tutte le regioni e possono essere gestite all'interno della console Amazon S3. Offrono funzionalità come Storage Cost Analysis, Storage Lens, funzionalità di sicurezza tra cui diverse opzioni di crittografia e altro ancora.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Recupero di metadati di vault in Amazon S3 Glacier mediante l'AWS SDK for .NET

Recupero di metadati di vault per un vault

Puoi recuperare metadati per un determinato vault o per tutti i vault in una determinata regione AWS. Di seguito è riportata la procedura per recuperare metadati per un determinato vault utilizzando l'API di basso livello del kit AWS SDK for .NET.

  1. Crea un'istanza della classe AmazonGlacierClient (client).

    Devi specificare la regione AWS in cui si trova il vault. Tutte le operazioni che esegui utilizzando questo client si applicano a quella regione AWS.

  2. Fornisci informazioni sulla richiesta creando un'istanza della classe DescribeVaultRequest.

    Amazon S3 Glacier (S3 Glacier) richiede di fornire un nome di vault e il tuo ID account. Se non specifichi un ID account, viene utilizzato l'ID account associato alle credenziali che hai fornito per firmare la richiesta. Per ulteriori informazioni, consulta Utilizzo di AWS SDK for .NET con Amazon S3 Glacier.

  3. Eseguire il metodo DescribeVault fornendo l'oggetto della richiesta come parametro.

    Le informazioni sui metadati di vault che S3 Glacier restituisce sono disponibili nell'oggetto DescribeVaultResult.

Il seguente frammento di codice C# illustra la procedura precedente. Il frammento di codice recupera informazioni sui metadati di un vault esistente nella regione Stati Uniti occidentali (Oregon). 

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 
   );

Nota

Per informazioni sulla REST API sottostante, consulta Describe Vault (GET vault).

Recupero di metadati di vault per tutti i vault in una regione

Puoi utilizzare il metodo ListVaults anche per recuperare metadati per tutti i vault in una regione AWS specifica.

Il seguente frammento di codice C# recupera un elenco di vault nella regione Stati Uniti occidentali (Oregon). La richiesta limita a 5 il numero di vault restituiti nella risposta. Il frammento di codice effettua una serie di chiamate ListVaults per recuperare l'intero elenco di vault dalla regione 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);

Nel segmento di codice precedente, se non specifichi il valore Limit nella richiesta, S3 Glacier restituisce fino a 10 vault, come definito dall'API di S3 Glacier.

Nota che le informazioni restituite per ogni vault nell'elenco sono le stesse che ottieni chiamando il metodo DescribeVault per un determinato vault.

Nota

Il metodo ListVaults chiama la REST API sottostante (consulta List Vaults (GET vaults)).

Esempio: recupero di metadati di vault mediante l'API di basso livello del kit AWS SDK for .NET

Per un esempio di codice, consulta Esempio: operazioni di vault con l'API di basso livello del kit AWS SDK for .NET. L'esempio di codice C# crea un vault e ne recupera i metadati.