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 Amazon Resource Name (ARN) titik akses atau alias titik akses. Untuk informasi selengkapnya tentang alias titik akses, lihat Menggunakan alias untuk titik akses bucket S3 di Outposts Anda di bucket S3 di Outposts.

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

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

Untuk informasi selengkapnya tentang ARN S3 di 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 REST API, AWS Command Line Interface (AWS CLI), dan AWS SDK 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 dalam bucket S3 di Outposts menggunakan SDK for Java. Untuk menggunakan contoh ini, ganti masing-masing user input placeholder dengan informasi Anda sendiri. Untuk informasi selengkapnya, lihat Mengunggah Objek.

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