Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Memulai dengan menggunakanAWS CLI dan SDK for Java
Dengan Amazon S3 di Outposts, Anda dapat membuat bucket S3 di Outposts AWS Anda dan dengan mudah menyimpan dan mengambil objek on-premise untuk aplikasi yang memerlukan akses data lokal, pengolahan data lokal, dan residensi data. S3 pada Outposts menyediakan kelas penyimpanan baru, S3 Outposts (OUTPOSTS), yang menggunakan API Amazon S3, dan dirancang untuk menyimpan data secara tahan lama dan redundan di beberapa perangkat dan server di AndaAWS Outposts. Anda berkomunikasi dengan bucket Outpost Anda dengan menggunakan titik akses dan koneksi titik akhir melalui Virtual Private Cloud (VPC). Anda dapat menggunakan API dan fitur yang sama di bucket Outpost seperti yang Anda lakukan di bucket Amazon S3, seperti kebijakan akses, enkripsi, dan pemberian tag. Anda dapat menggunakan S3 di Outposts melaluiAWS Management Console,AWS Command Line Interface (AWS CLI),AWS SDK, atau REST API. Untuk informasi selengkapnya, lihat Apa itu Amazon S3 di Outposts?
Untuk memulai dengan S3 di Outposts, Anda harus membuat bucket, titik akses, dan titik akhir. Kemudian, Anda dapat mengunggah objek ke bucket Anda. Contoh-contoh berikut menunjukkan cara memulai dengan S3 on Outposts dengan menggunakan SDK for Java.AWS CLI Untuk memulai dengan menggunakan konsol, lihatMemulai dengan menggunakanAWS Management Console.
Langkah 1: Buat bucket
BerikutAWS CLI dan SDK untuk contoh Java menunjukkan cara untuk membuat S3 pada Outposts ember.
- AWS CLI
-
Contoh berikut membuat bucket S3 on Outposts () dengan menggunakan bucket S3 on Outposts (s3-outposts:CreateBucket) dengan menggunakan bucket S3 on Outposts () dengan menggunakanAWS CLI. Untuk menjalankan perintah ini, gantiuser input
placeholders
aws s3control create-bucket --bucket example-outposts-bucket --outpost-id op-01ac5d28a6a232904
- SDK for Java
-
Contoh berikut membuat bucket S3 on Outposts (s3-outposts:CreateBucket) dengan menggunakan SDK for Java.
import com.amazonaws.services.s3control.model.*;
public String createBucket(String bucketName) {
CreateBucketRequest reqCreateBucket = new CreateBucketRequest()
.withBucket(bucketName)
.withOutpostId(OutpostId)
.withCreateBucketConfiguration(new CreateBucketConfiguration());
CreateBucketResult respCreateBucket = s3ControlClient.createBucket(reqCreateBucket);
System.out.printf("CreateBucket Response: %s%n", respCreateBucket.toString());
return respCreateBucket.getBucketArn();
}
Langkah 2: Buat titik akses
Untuk mengakses bucket Amazon S3 pada Outposts, Anda harus membuat dan mengonfigurasi titik akses. Contoh-contoh ini bagaimana Anda cara membuat titik akses dengan menggunakanAWS CLI dan SDK for Java.
Titik akses menyederhanakan pengelolaan akses data dalam skala besar untuk set data bersama di Amazon S3. Titik akses diberi nama titik akhir jaringan yang dilampirkan ke bucket yang dapat Anda gunakan untuk melakukan operasi objek Amazon S3, seperti GetObject dan PutObject. Dengan S3 di Outposts, Anda harus menggunakan titik akses untuk mengakses objek apapun di Outposts, Anda harus menggunakan titik akses untuk mengakses objek apapun dalam bucket Outposts, Anda harus menggunakan titik akses untuk mengakses objek apapun di Outposts, Titik akses hanya mendukung virtual-host-style pengalamatan.
- AWS CLI
-
Contoh AWS CLI berikut membuat titik akses untuk bucket Outposts. Untuk menjalankan perintah ini, gantiuser input placeholders
aws s3control create-access-point --account-id 123456789012 --name example-outposts-access-point --bucket "arn:aws:s3-outposts:region123456789012:outpost/op-01ac5d28a6a232904/bucket/example-outposts-bucket" --vpc-configuration VpcId=example-vpc-12345
- SDK for Java
-
Contoh SDK untuk Java berikut membuat titik akses untuk bucket Outposts. Untuk menggunakan contoh ini, gantiuser input placeholders
import com.amazonaws.services.s3control.model.*;
public String createAccessPoint(String bucketArn, String accessPointName) {
CreateAccessPointRequest reqCreateAP = new CreateAccessPointRequest()
.withAccountId(AccountId)
.withBucket(bucketArn)
.withName(accessPointName)
.withVpcConfiguration(new VpcConfiguration().withVpcId("vpc-12345"));
CreateAccessPointResult respCreateAP = s3ControlClient.createAccessPoint(reqCreateAP);
System.out.printf("CreateAccessPoint Response: %s%n", respCreateAP.toString());
return respCreateAP.getAccessPointArn();
}
Langkah 3: Buat titik akhir
Untuk pertean permintaan ke titik akses Amazon S3 di Outposts, Anda harus membuat dan mengonfigurasi S3 di titik akhir Outposts, Anda harus membuat dan mengonfigurasi S3 di titik akhir Outposts, Anda harus membuat dan mengonfigurasi S3 di titik akhir Outposts. Untuk membuat titik akhir, Anda memerlukan koneksi aktif dengan tautan layanan Anda ke wilayah asal Outposts Anda. Setiap cloud pribadi virtual (VPC) di Outpost Anda dapat memiliki satu titik akhir terkait. Untuk informasi lebih lanjut tentang kuota titik akhir, lihat S3 di persyaratan jaringan Outposts. Anda harus membuat titik akhir agar dapat mengakses bucket Outposts Anda dan melakukan operasi objek. Untuk informasi selengkapnya, lihat Titik akhir.
Contoh-contoh ini menunjukkan kepada Anda cara membuat titik akhir dengan menggunakanAWS CLI dan SDK for Java. Untuk informasi lebih lanjut tentang izin yang diperlukan untuk membuat dan mengelola titik akhir, lihatIzin untuk titik akhir S3 di Outposts.
- AWS CLI
-
AWS CLIContoh berikut membuat titik akhir untuk Outpost dengan menggunakan jenis akses sumber daya VPC. VPC berasal dari subnet. Untuk menjalankan perintah ini, gantiuser input placeholders
aws s3outposts create-endpoint --outpost-id op-01ac5d28a6a232904 --subnet-id subnet-8c7a57c5 --security-group-id sg-ab19e0d1
AWS CLIContoh berikut membuat endpoint untuk Outpost dengan menggunakan milik pelanggan IP address pool (CoIP pool) jenis akses. Untuk menjalankan perintah ini, gantiuser input placeholders
aws s3outposts create-endpoint --outpost-id op-01ac5d28a6a232904 --subnet-id subnet-8c7a57c5 --security-group-id sg-ab19e0d1 --access-type CustomerOwnedIp --customer-owned-ipv4-pool ipv4pool-coip-12345678901234567
- SDK for Java
-
Contoh SDK untuk Java berikut membuat titik akhir untuk Outpost. Untuk menggunakan contoh ini, gantiuser input placeholders
import com.amazonaws.services.s3outposts.AmazonS3Outposts;
import com.amazonaws.services.s3outposts.AmazonS3OutpostsClientBuilder;
import com.amazonaws.services.s3outposts.model.CreateEndpointRequest;
import com.amazonaws.services.s3outposts.model.CreateEndpointResult;
public void createEndpoint() {
AmazonS3Outposts s3OutpostsClient = AmazonS3OutpostsClientBuilder
.standard().build();
CreateEndpointRequest createEndpointRequest = new CreateEndpointRequest()
.withOutpostId("op-0d79779cef3c30a40")
.withSubnetId("subnet-8c7a57c5")
.withSecurityGroupId("sg-ab19e0d1")
.withAccessType("CustomerOwnedIp")
.withCustomerOwnedIpv4Pool("ipv4pool-coip-12345678901234567");
// Use .withAccessType and .withCustomerOwnedIpv4Pool only when the access type is
// customer-owned IP address pool (CoIP pool)
CreateEndpointResult createEndpointResult = s3OutpostsClient.createEndpoint(createEndpointRequest);
System.out.println("Endpoint is created and its ARN is " + createEndpointResult.getEndpointArn());
}
Langkah 4: Unggah sebuah objek ke bucket S3 on Outposts
Objek adalah entitas dasar yang disimpan di Amazon S3 pada Outposts. Setiap objek dimuat dalam bucket. Anda harus menggunakan titik akses untuk mengakses objek apapun di bucket Outposts. Saat Anda menentukan bucket untuk operasi objek, Anda menggunakan titik akses Amazon Resource Name (ARN) atau alias titik akses. Untuk informasi lebih lanjut tentang titik akses alias, lihatMenggunakan alias untuk titik akses bucket S3 di Outposts Anda di bucket S3 di Outposts.
Contoh berikut menunjukkan format ARN untuk S3 di Outposts access points, yang mencakupWilayah AWS kode untuk Wilayah yang Outpost homed ke,Akun AWS ID, Outpost ID, dan nama access point:
arn:aws:s3-outposts:region:account-id:outpost/outpost-id/accesspoint/accesspoint-name
Untuk informasi lebih lanjut tentang S3 di Outposts ARN, lihatARN sumber daya untuk S3 di Outposts.
Dengan Amazon S3 di Outposts, data objek selalu disimpan di Outpost. KetikaAWS menginstal rak Outpost, data Anda tetap lokal untuk Outpost Anda untuk memenuhi persyaratan data-residensi. Objek Anda tidak pernah meninggalkan Outpost Anda dan tidak dalamWilayah AWS. Karena di-host In-region, Anda tidak dapat menggunakan konsol untuk mengunggah atau mengelola objek di Outpost Anda.AWS Management Console Namun, Anda dapat menggunakan REST API,AWS Command Line Interface (AWS CLI), danAWS SDK untuk mengunggah dan mengelola objek Anda melalui titik akses Anda.
Contoh berikutAWS CLI danAWS SDK for Java contoh menunjukkan cara unggah objek ke bucket S3 on Outposts dengan menggunakan titik akses.
- AWS CLI
-
Contoh berikut menempatkan objek bernamasample-object.xml ke dalam bucket S3 on Outposts (s3-outposts:PutObject) dengan menggunakanAWS CLI. Untuk menggunakan perintah ini, ganti masing-masinguser input placeholder
aws s3api put-object --bucket arn:aws:s3-outposts:Region:123456789012op-01ac5d28a6a232904/accesspoint/example-outposts-access-point --key sample-object.xml --body sample-object.xml
- SDK for Java
-
Contoh berikut menempatkan objek ke dalam bucket S3 on Outposts dengan menggunakan SDK for Java. Untuk menggunakan contoh ini, ganti masing-masinguser input
placeholder
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.services.s3.AmazonS3;
import com.amazonaws.services.s3.AmazonS3ClientBuilder;
import com.amazonaws.services.s3.model.ObjectMetadata;
import com.amazonaws.services.s3.model.PutObjectRequest;
import java.io.File;
public class PutObject {
public static void main(String[] args) {
String accessPointArn = "*** access point ARN ***";
String stringObjKeyName = "*** String object key name ***";
String fileObjKeyName = "*** File object key name ***";
String fileName = "*** Path to file to upload ***";
try {
// This code expects that you have AWS credentials set up per:
// https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/setup-credentials.html
AmazonS3 s3Client = AmazonS3ClientBuilder.standard()
.enableUseArnRegion()
.build();
// Upload a text string as a new object.
s3Client.putObject(accessPointArn, stringObjKeyName, "Uploaded String Object");
// Upload a file as a new object with ContentType and title specified.
PutObjectRequest request = new PutObjectRequest(accessPointArn, fileObjKeyName, new File(fileName));
ObjectMetadata metadata = new ObjectMetadata();
metadata.setContentType("plain/text");
metadata.addUserMetadata("title", "someTitle");
request.setMetadata(metadata);
s3Client.putObject(request);
} catch (AmazonServiceException e) {
// The call was transmitted successfully, but Amazon S3 couldn't process
// it, so it returned an error response.
e.printStackTrace();
} catch (SdkClientException e) {
// Amazon S3 couldn't be contacted for a response, or the client
// couldn't parse the response from Amazon S3.
e.printStackTrace();
}
}
}
