Menggunakan AWS CLI Menggunakan Java SDK Format ARN ember Membuat ember S3 pada perangkat Snowball Edge Membuat dan mengelola konfigurasi siklus hidup objek menggunakan AWS CLI Bekerja dengan ember S3 pada perangkat Snowball Edge

Bekerja dengan ember S3 pada perangkat Snowball Edge

Anda dapat membuat bucket Amazon S3 di perangkat Snowball Edge untuk menyimpan dan mengambil objek di tempat untuk aplikasi yang memerlukan akses data lokal, pemrosesan data lokal, dan residensi data. Penyimpanan yang kompatibel dengan Amazon S3 pada perangkat Snow Family menyediakan kelas penyimpanan baruSNOW, yang menggunakan API Amazon S3, dan dirancang untuk menyimpan data secara tahan lama dan berlebihan di beberapa perangkat Snowball Edge. Anda dapat menggunakan API dan fitur yang sama pada bucket Snowball Edge yang Anda lakukan di Amazon S3, termasuk kebijakan siklus hidup bucket, enkripsi, dan penandaan.

Menggunakan AWS CLI

Ikuti petunjuk ini untuk bekerja dengan bucket Amazon S3 di perangkat Anda menggunakan. AWS CLI

Untuk mengatur AWS CLI

Buat profil untuk titik akhir objek di~/.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

Dapatkan sertifikat dari perangkat Anda. Untuk selengkapnya, lihat Panduan Pengembang Snowball Edge.
Jika Anda menginstal SDK di lingkungan virtual, aktifkan menggunakan perintah berikut:
```
source your-virtual-environment-name/bin/activate
```

Setelah mengatur operasi, Anda dapat mengaksesnya menggunakan panggilan API dengan file AWS CLI. Dalam contoh berikut, cert adalah sertifikat perangkat yang baru saja Anda peroleh menggunakan IAM.

Mengakses operasi objek

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

Mengakses operasi bucket

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

Menggunakan Java SDK

Gunakan contoh berikut untuk bekerja dengan objek Amazon S3 menggunakan 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();

Format ARN ember

Anda dapat menggunakan format Amazon Resource Name (ARN) yang tercantum di sini untuk mengidentifikasi bucket Amazon S3 pada perangkat Snowball Edge:


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

Di mana partisi adalah partisi Wilayah tempat Anda memesan perangkat Snowball Edge Anda. device-id adalah job_id jika perangkat adalah perangkat Snowball Edge mandiri, atau cluster_id jika Anda memiliki cluster Snowball Edge.

Membuat ember S3 pada perangkat Snowball Edge

Anda dapat membuat bucket Amazon S3 di perangkat Snowball Edge untuk menyimpan dan mengambil objek di tepi untuk aplikasi yang memerlukan akses data lokal, pemrosesan data lokal, dan residensi data. Penyimpanan yang kompatibel dengan Amazon S3 pada perangkat Snow Family menyediakan kelas penyimpanan baruSNOW, yang menggunakan Amazon S3 dan dirancang untuk menyimpan data secara tahan lama dan berlebihan di beberapa perangkat. Anda dapat menggunakan API dan fitur yang sama seperti yang Anda lakukan di bucket Amazon S3, termasuk kebijakan siklus hidup bucket, enkripsi, dan penandaan.

Contoh berikut membuat bucket Amazon S3 untuk perangkat Snowball Edge menggunakan. AWS CLI Untuk menjalankan perintah ini, ganti placeholder input pengguna dengan informasi Anda sendiri.


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

Membuat dan mengelola konfigurasi siklus hidup objek menggunakan AWS CLI

Anda dapat menggunakan Siklus Hidup Amazon S3 untuk mengoptimalkan kapasitas penyimpanan untuk penyimpanan yang kompatibel dengan Amazon S3 di perangkat Snow Family. Anda dapat membuat aturan siklus hidup untuk menjadikan objek kedaluwarsa seiring bertambahnya umur objek atau digantikan oleh versi yang lebih baru. Anda dapat membuat, mengaktifkan, menonaktifkan, atau menghapus aturan siklus hidup. Untuk informasi selengkapnya tentang Siklus Hidup Amazon S3, lihat Mengelola siklus hidup penyimpanan Anda.

catatan

Akun AWS Yang membuat bucket memilikinya dan merupakan satu-satunya yang dapat membuat, mengaktifkan, menonaktifkan, atau menghapus aturan siklus hidup.

Untuk membuat dan mengelola konfigurasi siklus hidup penyimpanan yang kompatibel dengan Amazon S3 di bucket perangkat Keluarga Salju menggunakan AWS Command Line Interface AWS CLI(), lihat contoh berikut.

PASANG konfigurasi siklus hidup pada bucket Snowball Edge

AWS CLI Contoh berikut menempatkan kebijakan konfigurasi siklus hidup pada bucket Snowball Edge. Kebijakan ini menetapkan bahwa semua objek yang memiliki awalan bertanda (myprefix) dan tag akan kedaluwarsa setelah 10 hari. Untuk menggunakan contoh ini, ganti setiap placeholder masukan pengguna dengan informasi Anda sendiri.

Pertama, simpan kebijakan konfigurasi siklus hidup ke file JSON. Untuk contoh ini, file tersebut diberi namalifecycle-example.json.


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

Setelah Anda menyimpan file, kirimkan file JSON sebagai bagian dari put-bucket-lifecycle-configuration perintah. Untuk menggunakan perintah ini, ganti setiap placeholder input pengguna dengan informasi Anda sendiri.


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

Untuk informasi selengkapnya tentang perintah ini, lihat put-bucket-lifecycle-configurationdi Referensi AWS CLI Perintah.

Bekerja dengan ember S3 pada perangkat Snowball Edge

Dengan penyimpanan yang kompatibel dengan Amazon S3 di perangkat Snow Family, Anda dapat membuat bucket Amazon S3 di perangkat Snowball Edge untuk menyimpan dan mengambil objek di tempat untuk aplikasi yang memerlukan akses data lokal, pemrosesan data lokal, dan residensi data. Penyimpanan yang kompatibel dengan Amazon S3 pada perangkat Snow Family menyediakan kelas penyimpanan baruSNOW, yang menggunakan API Amazon S3, dan dirancang untuk menyimpan data secara tahan lama dan berlebihan di beberapa perangkat Snowball Edge. Anda dapat menggunakan API dan fitur yang sama pada bucket Snowball Edge yang Anda lakukan di Amazon S3, termasuk kebijakan siklus hidup bucket, enkripsi, dan penandaan. Anda dapat menggunakan penyimpanan yang kompatibel dengan Amazon S3 di perangkat Snow Family menggunakan AWS Command Line Interface (AWS CLI) atau AWS SDK.

Tentukan apakah Anda dapat mengakses penyimpanan yang kompatibel dengan Amazon S3 di ember perangkat Snow Family

Contoh berikut menggunakan head-bucket perintah untuk menentukan apakah bucket Amazon S3 ada dan Anda memiliki izin untuk mengaksesnya menggunakan. AWS CLI Untuk menggunakan perintah ini, ganti setiap placeholder input pengguna dengan informasi Anda sendiri.


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

Ambil daftar ember atau ember regional

Gunakan list-regional-buckets atau list buckets untuk mencantumkan penyimpanan yang kompatibel dengan Amazon S3 di ember perangkat Keluarga Salju menggunakan perangkat. AWS CLI


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

Untuk informasi selengkapnya tentang list-regional-buckets perintah, lihat list-regional-bucketsdi Referensi AWS CLI Perintah.


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

Untuk informasi selengkapnya tentang list-buckets perintah, lihat list-buckets di Command Reference AWS CLI

Contoh SDK for Java berikut mendapatkan daftar bucket pada perangkat Snowball Edge. Untuk informasi selengkapnya, lihat ListBucketsdi Referensi API 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());
  }

PowerShell Contoh berikut mendapatkan daftar bucket pada perangkat Snowball Edge.



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

Contoh .NET berikut mendapatkan daftar bucket pada perangkat 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" 
        });
    }
}

Dapatkan ember

Contoh berikut mendapatkan penyimpanan yang kompatibel dengan Amazon S3 di bucket perangkat Snow Family menggunakan. AWS CLI Untuk menggunakan perintah ini, ganti setiap placeholder input pengguna dengan informasi Anda sendiri.


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

Untuk informasi selengkapnya tentang perintah ini, lihat get-bucket di AWS CLI Command Reference.

Contoh penyimpanan Amazon S3 yang kompatibel di perangkat Snow Family berikut mendapatkan bucket menggunakan SDK for Java. Untuk informasi selengkapnya, lihat GetBucketdi Referensi API 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());
}

Hapus ember

penting

Akun AWS Yang membuat ember memilikinya dan merupakan satu-satunya yang dapat menghapusnya.
Ember perangkat Snow Family harus kosong sebelum dapat dihapus.
Anda tidak dapat memulihkan bucket setelah dihapus.

Contoh berikut menghapus penyimpanan yang kompatibel dengan Amazon S3 di bucket perangkat Snow Family menggunakan perangkat. AWS CLI Untuk menggunakan perintah ini, ganti setiap placeholder input pengguna dengan informasi Anda sendiri.


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

Untuk informasi selengkapnya tentang perintah ini, lihat delete-bucket di Referensi AWS CLI Perintah.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Menyiapkan dan memulai penyimpanan yang kompatibel dengan Amazon S3 di perangkat Snow Family

Bekerja dengan objek S3 pada perangkat Snowball Edge