Utilizzo dei bucket S3 su un dispositivo Snowball Edge - AWS Snowball Edge Guida per gli sviluppatori
Usando il AWS CLIUtilizzo dell'SDK JavaFormato Bucket ARNCreazione di un bucket S3 su un dispositivo Snowball EdgeCreazione e gestione di una configurazione del ciclo di vita degli oggetti utilizzando AWS CLIUtilizzo dei bucket S3 su un dispositivo Snowball Edge

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à.

Utilizzo dei bucket S3 su un dispositivo Snowball Edge

Puoi creare bucket Amazon S3 sui tuoi dispositivi Snowball Edge per archiviare e recuperare oggetti in locale per applicazioni che richiedono l'accesso locale ai dati, l'elaborazione locale dei dati e la residenza dei dati. Lo storage compatibile con Amazon S3 sui dispositivi Snow Family offre una nuova classe di storage che utilizza le API di Amazon S3 ed è progettata per archiviare i dati in modo duraturo e ridondante su più dispositivi Snowball Edge. SNOW Puoi utilizzare le stesse API e funzionalità sui bucket Snowball Edge che usi su Amazon S3, incluse le policy del ciclo di vita dei bucket, la crittografia e l'etichettatura.

Usando il AWS CLI

Segui queste istruzioni per utilizzare i bucket Amazon S3 sul tuo dispositivo utilizzando il. AWS CLI

Per configurare il AWS CLI

  1. Crea un profilo per gli endpoint degli oggetti in~/.aws/config.

    [profile your-profile]
aws_access_key_id = your-access-id
aws_secret_access_key = your-access-key
region = snow
ca_bundle = dev/apps/ca-certs/your-ca_bundle

  2. Ottieni un certificato dal tuo dispositivo. Per informazioni, consulta la Snowball Edge Developer Guide.

  3. Se hai installato l'SDK in un ambiente virtuale, attivalo utilizzando il seguente comando:

    source your-virtual-environment-name/bin/activate

Dopo aver configurato le operazioni, puoi accedervi utilizzando chiamate API con. AWS CLI Negli esempi seguenti, cert è il certificato del dispositivo che hai appena ottenuto utilizzando IAM.

Accesso alle operazioni sugli oggetti

aws s3api --profile your-profile list-objects-v2 --endpoint-url https://s3api-endpoint-ip

Accesso alle operazioni dei bucket

aws s3control --profile your-profile list-regional-buckets --account-id bucket-owner --endpoint-url https://s3ctrlapi-endpoint-ip

Utilizzo dell'SDK Java

Usa l'esempio seguente per lavorare con oggetti Amazon S3 utilizzando Java SDK.


import software.amazon.awssdk.services.s3.S3Client;
import software.amazon.awssdk.auth.credentials.AwsBasicCredentials;
import software.amazon.awssdk.auth.credentials.StaticCredentialsProvider;
import software.amazon.awssdk.http.SdkHttpClient;
import software.amazon.awssdk.http.apache.ApacheHttpClient;
import software.amazon.awssdk.regions.Region;

import java.net.URI;

AwsBasicCredentials creds = AwsBasicCredentials.create(accessKey, secretKey); // set creds by getting Access Key and Secret Key from snowball edge
SdkHttpClient httpClient = ApacheHttpClient.builder().tlsTrustManagersProvider(trustManagersProvider).build(); // set trust managers provider with client certificate from snowball edge
String s3SnowEndpoint = "10.0.0.0"; // set s3-snow object api endpoint from describe service

S3Client s3Client = S3Client.builder().httpClient(httpClient).region(Region.of("snow")).endpointOverride(new URI(s3SnowEndpoint)).credentialsProvider(StaticCredentialsProvider.create(creds)).build();

Formato Bucket ARN

Puoi utilizzare il formato Amazon Resource Name (ARN) elencato qui per identificare un bucket Amazon S3 su un dispositivo Snowball Edge:

arn:partition:s3:snow:account-id:device/device-id/bucket/bucket-name

Dove partizione è la partizione della regione in cui è stato ordinato il dispositivo Snowball Edge. device-id è job_id se il dispositivo è un dispositivo Snowball Edge autonomo o cluster_id se si dispone di un cluster Snowball Edge.

Creazione di un bucket S3 su un dispositivo Snowball Edge

Puoi creare bucket Amazon S3 sul tuo dispositivo Snowball Edge per archiviare e recuperare oggetti all'edge per applicazioni che richiedono l'accesso locale ai dati, l'elaborazione locale dei dati e la residenza dei dati. Lo storage compatibile con Amazon S3 sui dispositivi Snow Family offre una nuova classe di storageSNOW, che utilizza Amazon S3 ed è progettata per archiviare i dati in modo duraturo e ridondante su più dispositivi. Puoi utilizzare le stesse API e funzionalità dei bucket Amazon S3, tra cui le politiche del ciclo di vita dei bucket, la crittografia e l'etichettatura.

L'esempio seguente crea un bucket Amazon S3 per un dispositivo Snowball Edge utilizzando il. AWS CLI Per eseguire questo comando, sostituisci i segnaposto di input dell'utente con le tue informazioni.

aws s3control --profile your-profile create-bucket --bucket your-snow-bucket --endpoint-url https://s3ctrlapi-endpoint-ip

Creazione e gestione di una configurazione del ciclo di vita degli oggetti utilizzando AWS CLI

Puoi utilizzare Amazon S3 Lifecycle per ottimizzare la capacità di storage per lo storage compatibile con Amazon S3 sui dispositivi Snow Family. È possibile creare regole del ciclo di vita per far scadere gli oggetti man mano che invecchiano o vengono sostituiti da versioni più recenti. Puoi creare, abilitare, disabilitare o eliminare una regola del ciclo di vita. Per ulteriori informazioni sul ciclo di vita di Amazon S3, consulta Managing your storage lifecycle.

Nota

Chi crea Account AWS il bucket ne è il proprietario ed è l'unico in grado di creare, abilitare, disabilitare o eliminare una regola del ciclo di vita.

Per creare e gestire una configurazione del ciclo di vita per uno storage compatibile con Amazon S3 su dispositivi Snow Family utilizzando AWS Command Line Interface il bucket AWS CLI(), consulta gli esempi seguenti.

INSERISCI una configurazione del ciclo di vita su un bucket Snowball Edge

L' AWS CLI esempio seguente inserisce una policy di configurazione del ciclo di vita in un bucket Snowball Edge. Questa politica specifica che tutti gli oggetti con il prefisso contrassegnato (myprefix) e i tag scadono dopo 10 giorni. Per utilizzare questo esempio, sostituisci ogni segnaposto di input dell'utente con le tue informazioni.

Innanzitutto, salvate la politica di configurazione del ciclo di vita in un file JSON. In questo esempio, il file è denominato. lifecycle-example.json

{
    "Rules": [{
        "ID": "id-1",
        "Filter": {
            "And": {
                "Prefix": "myprefix",
                "Tags": [{
                        "Value": "mytagvalue1",
                        "Key": "mytagkey1"
                    },
                    {
                        "Value": "mytagvalue2",
                        "Key": "mytagkey2"
                    }
                ],
            }
        },
        "Status": "Enabled",
        "Expiration": {
            "Days": 10
        }
    }]
}

Dopo aver salvato il file, inviate il file JSON come parte del put-bucket-lifecycle-configuration comando. Per utilizzare questo comando, sostituisci ogni segnaposto di input dell'utente con le tue informazioni.

aws s3control put-bucket-lifecycle-configuration --bucket 
                example-snow-bucket --profile your-profile 
                --lifecycle-configuration file://lifecycle-example.json --endpoint-url https://s3ctrlapi-endpoint-ip

Per ulteriori informazioni su questo comando, vedere put-bucket-lifecycle-configurationnella Guida ai AWS CLI comandi.

Utilizzo dei bucket S3 su un dispositivo Snowball Edge

Con lo storage compatibile con Amazon S3 sui dispositivi Snow Family, puoi creare bucket Amazon S3 sui tuoi dispositivi Snowball Edge per archiviare e recuperare oggetti in locale per applicazioni che richiedono accesso ai dati locali, elaborazione locale dei dati e residenza dei dati. Lo storage compatibile con Amazon S3 sui dispositivi Snow Family offre una nuova classe di storage che utilizza le API di Amazon S3 ed è progettata per archiviare i dati in modo duraturo e ridondante su più dispositivi Snowball Edge. SNOW Puoi utilizzare le stesse API e funzionalità sui bucket Snowball Edge che usi su Amazon S3, incluse le policy del ciclo di vita dei bucket, la crittografia e l'etichettatura. Puoi utilizzare lo storage compatibile con Amazon S3 sui dispositivi Snow Family utilizzando AWS Command Line Interface (AWS CLI) o AWS gli SDK.

Determina se puoi accedere a un bucket di storage compatibile con Amazon S3 sui dispositivi della famiglia Snow

L'esempio seguente utilizza il head-bucket comando per determinare se esiste un bucket Amazon S3 e se si dispone delle autorizzazioni per accedervi utilizzando. AWS CLI Per utilizzare questo comando, sostituisci ogni segnaposto di input dell'utente con le tue informazioni.

aws s3api head-bucket --bucket sample-bucket --profile your-profile --endpoint-url https://s3api-endpoint-ip

Recupera un elenco di bucket o bucket regionali

Usa list-regional-buckets o list buckets per elencare lo storage compatibile con Amazon S3 sui bucket di dispositivi Snow Family utilizzando il. AWS CLI

aws s3control list-regional-buckets --account-id 123456789012 --profile your-profile --endpoint-url https://s3ctrlapi-endpoint-ip

Per ulteriori informazioni sul list-regional-buckets comando, consulta la sezione AWS CLI Command list-regional-bucketsReference.

 aws s3 list-buckets --account-id 123456789012 --endpoint-url https://s3api-endpoint-ip

Per ulteriori informazioni sul list-buckets comando, vedere list-buckets nel Command Reference AWS CLI

Il seguente esempio di SDK for Java ottiene un elenco di bucket sui dispositivi Snowball Edge. Per ulteriori informazioni, consulta il riferimento ListBucketsall'API di Amazon Simple Storage Service.


  import com.amazonaws.services.s3.model.*;
  public void listBuckets() {
    ListBucketsRequest reqListBuckets = new ListBucketsRequest()
    .withAccountId(AccountId)
    ListBucketsResult respListBuckets = s3APIClient.RegionalBuckets(reqListBuckets);
    System.out.printf("ListBuckets Response: %s%n", respListBuckets.toString());
  }

L' PowerShell esempio seguente ottiene un elenco di bucket sui dispositivi Snowball Edge.


   Get-S3CRegionalBucketList -AccountId 012345678910 -Endpoint "https://snowball_ip" -Region snow

Il seguente esempio.NET ottiene un elenco di bucket sui dispositivi Snowball Edge.


using Amazon.S3Control;
using Amazon.S3Control.Model;

namespace SnowTest;

internal class Program
{
    static async Task Main(string[] args)
    {
        var config = new AmazonS3ControlConfig
        {
            ServiceURL = "https://snowball_ip",
            AuthenticationRegion = "snow" // Note that this is not RegionEndpoint
        };        

        var client = new AmazonS3ControlClient(config);

        var response = await client.ListRegionalBucketsAsync(new ListRegionalBucketsRequest() 
        { 
            AccountId = "012345678910" 
        });
    }
}

Procurati un secchio

L'esempio seguente ottiene un bucket di storage compatibile con Amazon S3 sui dispositivi Snow Family utilizzando il. AWS CLI Per utilizzare questo comando, sostituisci ogni segnaposto di input dell'utente con le tue informazioni.

aws s3control get-bucket --account-id 123456789012 --bucket DOC-EXAMPLE-BUCKET --profile your-profile --endpoint-url https://s3ctrlapi-endpoint-ip

Per ulteriori informazioni su questo comando, vedere get-bucket nel Command Reference.AWS CLI

Il seguente esempio di storage compatibile con Amazon S3 su dispositivi Snow Family ottiene un bucket utilizzando l'SDK for Java. Per ulteriori informazioni, consulta il riferimento GetBucketall'API di Amazon Simple Storage Service.


import com.amazonaws.services.s3control.model.*;

public void getBucket(String bucketName) {

    GetBucketRequest reqGetBucket = new GetBucketRequest()
            .withBucket(bucketName)
            .withAccountId(AccountId);

    GetBucketResult respGetBucket = s3ControlClient.getBucket(reqGetBucket);
    System.out.printf("GetBucket Response: %s%n", respGetBucket.toString());
}

Eliminare un bucket

Importante

  • Chi crea Account AWS il bucket ne è il proprietario ed è l'unico che può eliminarlo.

  • I bucket dei dispositivi Snow Family devono essere vuoti prima di poter essere eliminati.

  • Non è possibile recuperare un bucket dopo che è stato eliminato.

L'esempio seguente elimina un bucket di storage compatibile con Amazon S3 sui dispositivi Snow Family utilizzando il. AWS CLI Per utilizzare questo comando, sostituisci ogni segnaposto di input dell'utente con le tue informazioni.

aws s3control delete-bucket --account-id 123456789012 --bucket DOC-EXAMPLE-BUCKET --profile your-profile --endpoint-url https://s3ctrlapi-endpoint-ip

Per ulteriori informazioni su questo comando, vedere delete-bucket nel Command Reference.AWS CLI