Unggah objek ke ember S3 di Outposts

Objek adalah entitas dasar yang disimpan di Amazon S3 di Outposts. Setiap objek dimuat dalam bucket. Anda harus menggunakan titik akses untuk mengakses objek apa pun dalam bucket Outposts. Saat menentukan bucket untuk operasi objek, Anda menggunakan titik akses Amazon Resource Name (ARN) atau alias titik akses. Untuk informasi selengkapnya tentang alias titik akses, lihat Menggunakan alias gaya bucket untuk titik akses bucket S3 di Outposts.

Contoh berikut menunjukkan ARN format untuk S3 pada jalur akses Outposts, yang mencakup Wilayah AWS kode untuk Wilayah tempat Pos Luar berada, Akun AWS ID, ID Outpost, dan nama titik akses:

arn:aws:s3-outposts:region:account-id:outpost/outpost-id/accesspoint/accesspoint-name

Untuk informasi lebih lanjut tentang S3 di ARNs Outposts, lihat. Sumber daya ARNs untuk S3 di Outposts

Dengan Amazon S3 di Outposts, data objek selalu disimpan di Outpost. Saat AWS memasang rak Outpost, data Anda tetap lokal di Outpost Anda untuk memenuhi persyaratan residensi data. Objek Anda tidak akan meninggalkan Outpost dan tidak berada di Wilayah 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 RESTAPI, AWS Command Line Interface (AWS CLI), dan AWS SDKs untuk mengunggah dan mengelola objek Anda melalui titik akses Anda.

Berikut AWS CLI dan AWS SDK for Java contoh menunjukkan cara mengunggah objek ke bucket S3 di Outposts dengan menggunakan titik akses.

AWS CLI

Contoh berikut menempatkan objek bernama sample-object.xml ke bucket S3 di Outposts (s3-outposts:PutObject) menggunakan AWS CLI. Untuk menggunakan perintah ini, ganti masing-masing user input placeholder dengan informasi Anda sendiri. Untuk informasi selengkapnya tentang perintah ini, lihat put-object dalam Referensi AWS CLI .

aws s3api put-object --bucket arn:aws:s3-outposts:Region:123456789012:outpost/op-01ac5d28a6a232904/accesspoint/example-outposts-access-point --key sample-object.xml --body sample-object.xml

SDK for Java

Contoh berikut menempatkan objek ke dalam S3 pada Outposts bucket dengan menggunakan for JavaSDK. Untuk menggunakan contoh ini, ganti masing-masing user input placeholder dengan informasi Anda sendiri.

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