View a markdown version of this page

Contoh Amazon S3 menggunakan AWS CLI - AWS Command Line Interface
Tindakan

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Contoh Amazon S3 menggunakan AWS CLI

Contoh kode berikut menunjukkan cara melakukan tindakan dan menerapkan skenario umum dengan menggunakan AWS Command Line Interface dengan Amazon S3.

Tindakan merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.

Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.

Tindakan

Contoh kode berikut menunjukkan cara menggunakanabort-multipart-upload.

AWS CLI

Untuk membatalkan unggahan multipart yang ditentukan

Per abort-multipart-upload intah berikut membatalkan upload multipart untuk kunci multipart/01 dalam bucket. amzn-s3-demo-bucket

aws s3api abort-multipart-upload \
    --bucket amzn-s3-demo-bucket \
    --key multipart/01 \
    --upload-id dfRtDYU0WWCCcH43C3WFbkRONycyCpTJJvxu2i5GYkZljF.Yxwh6XG7WfS2vC4to6HiV6Yjlx.cph0gtNBtJ8P3URCSbB7rjxI5iEwVDmgaXZOGgkk5nVTW16HOQ5l0R

ID unggahan yang diperlukan oleh perintah ini dikeluarkan oleh create-multipart-upload dan juga dapat diambil denganlist-multipart-uploads.

Contoh kode berikut menunjukkan cara menggunakancomplete-multipart-upload.

AWS CLI

Perintah berikut menyelesaikan unggahan multipart untuk kunci multipart/01 dalam bucket: amzn-s3-demo-bucket

aws s3api complete-multipart-upload --multipart-upload file://mpustruct --bucket amzn-s3-demo-bucket --key 'multipart/01' --upload-id dfRtDYU0WWCCcH43C3WFbkRONycyCpTJJvxu2i5GYkZljF.Yxwh6XG7WfS2vC4to6HiV6Yjlx.cph0gtNBtJ8P3URCSbB7rjxI5iEwVDmgaXZOGgkk5nVTW16HOQ5l0R

ID unggahan yang diperlukan oleh perintah ini dikeluarkan oleh create-multipart-upload dan juga dapat diambil denganlist-multipart-uploads.

Opsi upload multipart dalam perintah di atas mengambil struktur JSON yang menjelaskan bagian-bagian dari unggahan multipart yang harus dirakit kembali ke dalam file lengkap. Dalam contoh ini, file:// awalan digunakan untuk memuat struktur JSON dari file di folder lokal bernamampustruct.

Mpustruct:

{
  "Parts": [
    {
      "ETag": "e868e0f4719e394144ef36531ee6824c",
      "PartNumber": 1
    },
    {
      "ETag": "6bb2b12753d66fe86da4998aa33fffb0",
      "PartNumber": 2
    },
    {
      "ETag": "d0a0112e841abec9c9ec83406f0159c8",
      "PartNumber": 3
    }
  ]
}

Nilai ETag untuk setiap bagian yang diunggah dikeluarkan setiap kali Anda mengunggah bagian menggunakan upload-part perintah dan juga dapat diambil dengan memanggil list-parts atau dihitung dengan mengambil checksum MD5 dari setiap bagian.

Output:

{
    "ETag": "\"3944a9f7a4faab7f78788ff6210f63f0-3\"",
    "Bucket": "amzn-s3-demo-bucket",
    "Location": "https://amzn-s3-demo-bucket.s3.amazonaws.com/multipart%2F01",
    "Key": "multipart/01"
}

Contoh kode berikut menunjukkan cara menggunakancopy-object.

AWS CLI

Perintah berikut menyalin objek dari bucket-1 kebucket-2:

aws s3api copy-object --copy-source bucket-1/test.txt --key test.txt --bucket bucket-2

Output:

{
    "CopyObjectResult": {
        "LastModified": "2015-11-10T01:07:25.000Z",
        "ETag": "\"589c8b79c230a6ecd5a7e1d040a9a030\""
    },
    "VersionId": "YdnYvTCVDqRRFA.NFJjy36p0hxifMlkA"
}

  • Untuk detail API, lihat CopyObject di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakancp.

AWS CLI

Contoh 1: Menyalin file lokal ke S3

Per cp intah berikut menyalin satu file ke bucket dan kunci tertentu:

aws s3 cp test.txt s3://amzn-s3-demo-bucket/test2.txt

Output:

upload: test.txt to s3://amzn-s3-demo-bucket/test2.txt

Contoh 2: Menyalin file lokal ke S3 dengan tanggal kedaluwarsa

Per cp intah berikut menyalin satu file ke bucket dan kunci tertentu yang kedaluwarsa pada stempel waktu ISO 8601 yang ditentukan:

aws s3 cp test.txt s3://amzn-s3-demo-bucket/test2.txt \
    --expires 2014-10-01T20:30:00Z

Output:

upload: test.txt to s3://amzn-s3-demo-bucket/test2.txt

Contoh 3: Menyalin file dari S3 ke S3

Per cp intah berikut menyalin satu objek S3 ke bucket dan kunci tertentu:

aws s3 cp s3://amzn-s3-demo-bucket/test.txt s3://amzn-s3-demo-bucket/test2.txt

Output:

copy: s3://amzn-s3-demo-bucket/test.txt to s3://amzn-s3-demo-bucket/test2.txt

Contoh 4: Menyalin objek S3 ke file lokal

Per cp intah berikut menyalin satu objek ke file tertentu secara lokal:

aws s3 cp s3://amzn-s3-demo-bucket/test.txt test2.txt

Output:

download: s3://amzn-s3-demo-bucket/test.txt to test2.txt

Contoh 5: Menyalin objek S3 dari satu bucket ke bucket lainnya

Per cp intah berikut menyalin satu objek ke bucket tertentu sambil mempertahankan nama aslinya:

aws s3 cp s3://amzn-s3-demo-bucket/test.txt s3://amzn-s3-demo-bucket2/

Output:

copy: s3://amzn-s3-demo-bucket/test.txt to s3://amzn-s3-demo-bucket2/test.txt

Contoh 6: Menyalin objek S3 secara rekursif ke direktori lokal

Ketika diteruskan dengan parameter--recursive, cp perintah berikut secara rekursif menyalin semua objek di bawah awalan dan bucket yang ditentukan ke direktori tertentu. Dalam contoh ini, bucket amzn-s3-demo-bucket memiliki objek test1.txt dantest2.txt:

aws s3 cp s3://amzn-s3-demo-bucket . \
    --recursive

Output:

download: s3://amzn-s3-demo-bucket/test1.txt to test1.txt
download: s3://amzn-s3-demo-bucket/test2.txt to test2.txt

Contoh 7: Menyalin file lokal secara rekursif ke S3

Ketika diteruskan dengan parameter--recursive, cp perintah berikut secara rekursif menyalin semua file di bawah direktori tertentu ke bucket dan awalan tertentu sambil mengecualikan beberapa file dengan menggunakan --exclude parameter. Dalam contoh ini, direktori myDir memiliki file test1.txt dantest2.jpg:

aws s3 cp myDir s3://amzn-s3-demo-bucket/ \
    --recursive \
    --exclude "*.jpg"

Output:

upload: myDir/test1.txt to s3://amzn-s3-demo-bucket/test1.txt

Contoh 8: Menyalin objek S3 secara rekursif ke bucket lain

Ketika diteruskan dengan parameter--recursive, cp perintah berikut secara rekursif menyalin semua objek di bawah bucket tertentu ke bucket lain sambil mengecualikan beberapa objek dengan menggunakan --exclude parameter. Dalam contoh ini, bucket amzn-s3-demo-bucket memiliki objek test1.txt dananother/test1.txt:

aws s3 cp s3://amzn-s3-demo-bucket/ s3://amzn-s3-demo-bucket2/ \
    --recursive \
    --exclude "another/*"

Output:

copy: s3://amzn-s3-demo-bucket/test1.txt to s3://amzn-s3-demo-bucket2/test1.txt

Anda dapat menggabungkan --exclude dan memilih --include untuk menyalin hanya objek yang cocok dengan pola, tidak termasuk yang lainnya:

aws s3 cp s3://amzn-s3-demo-bucket/logs/ s3://amzn-s3-demo-bucket2/logs/ \
    --recursive \
    --exclude "*" \
    --include "*.log"

Output:

copy: s3://amzn-s3-demo-bucket/logs/test/test.log to s3://amzn-s3-demo-bucket2/logs/test/test.log
copy: s3://amzn-s3-demo-bucket/logs/test3.log to s3://amzn-s3-demo-bucket2/logs/test3.log

Contoh 9: Mengatur Daftar Kontrol Akses (ACL) saat menyalin objek S3

Per cp intah berikut menyalin satu objek ke bucket dan kunci tertentu saat mengatur ACL ke: public-read-write

aws s3 cp s3://amzn-s3-demo-bucket/test.txt s3://amzn-s3-demo-bucket/test2.txt \
    --acl public-read-write

Output:

copy: s3://amzn-s3-demo-bucket/test.txt to s3://amzn-s3-demo-bucket/test2.txt

Perhatikan bahwa jika Anda menggunakan --acl opsi ini, pastikan bahwa setiap kebijakan IAM terkait menyertakan "s3:PutObjectAcl" tindakan:

aws iam get-user-policy \
    --user-name myuser \
    --policy-name mypolicy

Output:

{
    "UserName": "myuser",
    "PolicyName": "mypolicy",
    "PolicyDocument": {
        "Version":"2012-10-17",
        "Statement": [
            {
                "Action": [
                    "s3:PutObject",
                    "s3:PutObjectAcl"
                ],
                "Resource": [
                    "arn:aws:s3:::amzn-s3-demo-bucket/*"
                ],
                "Effect": "Allow",
                "Sid": "Stmt1234567891234"
            }
        ]
    }
}

Contoh 10: Memberikan izin untuk objek S3

Per cp intah berikut menggambarkan penggunaan --grants opsi untuk memberikan akses baca ke semua pengguna yang diidentifikasi oleh URI dan kontrol penuh ke pengguna tertentu yang diidentifikasi oleh ID Canonical mereka:

aws s3 cp file.txt s3://amzn-s3-demo-bucket/ --grants read=uri=http://acs.amazonaws.com/groups/global/AllUsers full=id=79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be

Output:

upload: file.txt to s3://amzn-s3-demo-bucket/file.txt

Contoh 11: Mengunggah aliran file lokal ke S3

PowerShell dapat mengubah pengkodean atau menambahkan CRLF ke input pipa.

Per cp intah berikut mengunggah aliran file lokal dari input standar ke bucket dan kunci tertentu:

aws s3 cp - s3://amzn-s3-demo-bucket/stream.txt

Contoh 12: Mengunggah aliran file lokal yang lebih besar dari 50GB ke S3

Per cp intah berikut mengunggah aliran file lokal 51GB dari input standar ke bucket dan kunci tertentu. --expected-sizeOpsi harus disediakan, atau unggahan mungkin gagal ketika mencapai batas bagian default 10.000:

aws s3 cp - s3://amzn-s3-demo-bucket/stream.txt --expected-size 54760833024

Contoh 13: Mengunduh objek S3 sebagai aliran file lokal

PowerShell dapat mengubah pengkodean atau menambahkan CRLF ke output yang disalurkan atau dialihkan.

Per cp intah berikut mengunduh objek S3 secara lokal sebagai aliran ke output standar. Mengunduh sebagai aliran saat ini tidak kompatibel dengan --recursive parameter:

aws s3 cp s3://amzn-s3-demo-bucket/stream.txt -

Contoh 14: Mengunggah ke titik akses S3

Per cp intah berikut mengunggah satu file (mydoc.txt) ke titik akses (myaccesspoint) pada tombol (mykey):

aws s3 cp mydoc.txt s3://arn:aws:s3:us-west-2:123456789012:accesspoint/myaccesspoint/mykey

Output:

upload: mydoc.txt to s3://arn:aws:s3:us-west-2:123456789012:accesspoint/myaccesspoint/mykey

Contoh 15: Mengunduh dari titik akses S3

Per cp intah berikut mengunduh satu objek (mykey) dari titik akses (myaccesspoint) ke file lokal (mydoc.txt):

aws s3 cp s3://arn:aws:s3:us-west-2:123456789012:accesspoint/myaccesspoint/mykey mydoc.txt

Output:

download: s3://arn:aws:s3:us-west-2:123456789012:accesspoint/myaccesspoint/mykey to mydoc.txt

  • Untuk detail API, lihat Cp di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakancreate-bucket.

AWS CLI

Contoh 1: Untuk membuat bucket

create-bucketContoh berikut membuat bucket bernamaamzn-s3-demo-bucket:

aws s3api create-bucket \
    --bucket amzn-s3-demo-bucket \
    --region us-east-1

Output:

{
    "Location": "/amzn-s3-demo-bucket"
}

Lihat informasi yang lebih lengkap di Membuat bucket dalam Panduan Pengguna Amazon S3.

Contoh 2: Untuk membuat bucket dengan pemilik dipaksakan

create-bucketContoh berikut membuat bucket bernama amzn-s3-demo-bucket yang menggunakan pengaturan yang dipaksakan pemilik bucket untuk Kepemilikan Objek S3.

aws s3api create-bucket \
    --bucket amzn-s3-demo-bucket \
    --region us-east-1 \
    --object-ownership BucketOwnerEnforced

Output:

{
    "Location": "/amzn-s3-demo-bucket"
}

Untuk informasi selengkapnya, lihat Mengontrol kepemilikan objek dan menonaktifkan ACL di Panduan Pengguna Amazon S3.

Contoh 3: Untuk membuat bucket di luar wilayah ``us-east-1``

create-bucketContoh berikut membuat bucket bernama amzn-s3-demo-bucket di eu-west-1 wilayah tersebut. Daerah di luar us-east-1 memerlukan yang sesuai LocationConstraint untuk ditentukan untuk membuat bucket di wilayah yang diinginkan.

aws s3api create-bucket \
    --bucket amzn-s3-demo-bucket \
    --region eu-west-1 \
    --create-bucket-configuration LocationConstraint=eu-west-1

Output:

{
    "Location": "http://amzn-s3-demo-bucket.s3.amazonaws.com/"
}

Lihat informasi yang lebih lengkap di Membuat bucket dalam Panduan Pengguna Amazon S3.

  • Untuk detail API, lihat CreateBucket di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakancreate-multipart-upload.

AWS CLI

Perintah berikut membuat unggahan multipart di bucket amzn-s3-demo-bucket dengan kunci: multipart/01

aws s3api create-multipart-upload --bucket amzn-s3-demo-bucket --key 'multipart/01'

Output:

{
    "Bucket": "amzn-s3-demo-bucket",
    "UploadId": "dfRtDYU0WWCCcH43C3WFbkRONycyCpTJJvxu2i5GYkZljF.Yxwh6XG7WfS2vC4to6HiV6Yjlx.cph0gtNBtJ8P3URCSbB7rjxI5iEwVDmgaXZOGgkk5nVTW16HOQ5l0R",
    "Key": "multipart/01"
}

File yang sudah selesai akan diberi 01 nama dalam folder yang disebut multipart dalam bucketamzn-s3-demo-bucket. Simpan ID unggahan, kunci, dan nama bucket untuk digunakan dengan upload-part perintah.

Contoh kode berikut menunjukkan cara menggunakandelete-bucket-analytics-configuration.

AWS CLI

Untuk menghapus konfigurasi analitik untuk bucket

delete-bucket-analytics-configurationContoh berikut menghapus konfigurasi analitik untuk bucket dan ID yang ditentukan.

aws s3api delete-bucket-analytics-configuration \
    --bucket amzn-s3-demo-bucket \
    --id 1

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakandelete-bucket-cors.

AWS CLI

Perintah berikut menghapus konfigurasi Ber Cross-Origin bagi Sumber Daya dari bucket bernama: amzn-s3-demo-bucket

aws s3api delete-bucket-cors --bucket amzn-s3-demo-bucket

Contoh kode berikut menunjukkan cara menggunakandelete-bucket-encryption.

AWS CLI

Untuk menghapus konfigurasi enkripsi sisi server dari bucket

delete-bucket-encryptionContoh berikut menghapus konfigurasi enkripsi sisi server dari bucket yang ditentukan.

aws s3api delete-bucket-encryption \
    --bucket amzn-s3-demo-bucket

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakandelete-bucket-intelligent-tiering-configuration.

AWS CLI

Untuk menghapus Intelligent-Tiering konfigurasi S3 pada bucket

delete-bucket-intelligent-tiering-configurationContoh berikut menghapus Intelligent-Tiering konfigurasi S3, bernama ExampleConfig, pada bucket.

aws s3api delete-bucket-intelligent-tiering-configuration \
    --bucket amzn-s3-demo-bucket \
    --id ExampleConfig

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menggunakan S3 Intelligent-Tiering di Panduan Pengguna Amazon S3.

Contoh kode berikut menunjukkan cara menggunakandelete-bucket-inventory-configuration.

AWS CLI

Untuk menghapus konfigurasi inventaris dari bucket

delete-bucket-inventory-configurationContoh berikut menghapus konfigurasi inventaris dengan ID 1 untuk bucket yang ditentukan.

aws s3api delete-bucket-inventory-configuration \
    --bucket amzn-s3-demo-bucket \
    --id 1

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakandelete-bucket-lifecycle.

AWS CLI

Perintah berikut menghapus konfigurasi siklus hidup dari bucket bernama: amzn-s3-demo-bucket

aws s3api delete-bucket-lifecycle --bucket amzn-s3-demo-bucket

Contoh kode berikut menunjukkan cara menggunakandelete-bucket-metrics-configuration.

AWS CLI

Untuk menghapus konfigurasi metrik untuk bucket

delete-bucket-metrics-configurationContoh berikut menghapus konfigurasi metrik untuk bucket dan ID yang ditentukan.

aws s3api delete-bucket-metrics-configuration \
    --bucket amzn-s3-demo-bucket \
    --id 123

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakandelete-bucket-ownership-controls.

AWS CLI

Untuk menghapus pengaturan kepemilikan bucket dari bucket

delete-bucket-ownership-controlsContoh berikut menghapus pengaturan kepemilikan bucket dari bucket.

aws s3api delete-bucket-ownership-controls \
    --bucket amzn-s3-demo-bucket

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mengatur Kepemilikan Objek pada bucket yang ada di Panduan Pengguna Amazon S3.

Contoh kode berikut menunjukkan cara menggunakandelete-bucket-policy.

AWS CLI

Perintah berikut menghapus kebijakan bucket dari bucket bernama: amzn-s3-demo-bucket

aws s3api delete-bucket-policy --bucket amzn-s3-demo-bucket

Contoh kode berikut menunjukkan cara menggunakandelete-bucket-replication.

AWS CLI

Perintah berikut menghapus konfigurasi replikasi dari bucket bernama: amzn-s3-demo-bucket

aws s3api delete-bucket-replication --bucket amzn-s3-demo-bucket

Contoh kode berikut menunjukkan cara menggunakandelete-bucket-tagging.

AWS CLI

Perintah berikut menghapus konfigurasi penandaan dari bucket bernama: amzn-s3-demo-bucket

aws s3api delete-bucket-tagging --bucket amzn-s3-demo-bucket

Contoh kode berikut menunjukkan cara menggunakandelete-bucket-website.

AWS CLI

Perintah berikut menghapus konfigurasi situs web dari bucket bernama: amzn-s3-demo-bucket

aws s3api delete-bucket-website --bucket amzn-s3-demo-bucket

Contoh kode berikut menunjukkan cara menggunakandelete-bucket.

AWS CLI

Perintah berikut menghapus bucket bernama: amzn-s3-demo-bucket

aws s3api delete-bucket --bucket amzn-s3-demo-bucket --region us-east-1

  • Untuk detail API, lihat DeleteBucket di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakandelete-object-tagging.

AWS CLI

Untuk menghapus set tag objek

delete-object-taggingContoh berikut menghapus tag dengan kunci yang ditentukan dari objekdoc1.rtf.

aws s3api delete-object-tagging \
    --bucket amzn-s3-demo-bucket \
    --key doc1.rtf

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakandelete-object.

AWS CLI

Perintah berikut menghapus objek bernama test.txt dari bucket bernama: amzn-s3-demo-bucket

aws s3api delete-object --bucket amzn-s3-demo-bucket --key test.txt

Jika pembuatan versi bucket diaktifkan, output akan berisi ID versi dari penanda hapus:

{
  "VersionId": "9_gKg5vG56F.TTEUdwkxGpJ3tNDlWlGq",
  "DeleteMarker": true
}

Untuk informasi selengkapnya tentang menghapus objek, lihat Menghapus Objek di Panduan Pengembang Amazon S3.

  • Untuk detail API, lihat DeleteObject di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakandelete-objects.

AWS CLI

Perintah berikut menghapus objek dari bucket bernama: amzn-s3-demo-bucket

aws s3api delete-objects --bucket amzn-s3-demo-bucket --delete file://delete.json

delete.jsonadalah dokumen JSON di direktori saat ini yang menentukan objek yang akan dihapus:

{
  "Objects": [
    {
      "Key": "test1.txt"
    }
  ],
  "Quiet": false
}

Output:

{
    "Deleted": [
        {
            "DeleteMarkerVersionId": "mYAT5Mc6F7aeUL8SS7FAAqUPO1koHwzU",
            "Key": "test1.txt",
            "DeleteMarker": true
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakandelete-public-access-block.

AWS CLI

Untuk menghapus konfigurasi akses publik blok untuk bucket

delete-public-access-blockContoh berikut menghapus konfigurasi akses publik blok pada bucket yang ditentukan.

aws s3api delete-public-access-block \
    --bucket amzn-s3-demo-bucket

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakanget-bucket-accelerate-configuration.

AWS CLI

Untuk mengambil konfigurasi percepatan dari bucket

get-bucket-accelerate-configurationContoh berikut mengambil konfigurasi akselerasi untuk bucket yang ditentukan.

aws s3api get-bucket-accelerate-configuration \
    --bucket amzn-s3-demo-bucket

Output:

{
    "Status": "Enabled"
}

Contoh kode berikut menunjukkan cara menggunakanget-bucket-acl.

AWS CLI

Perintah berikut mengambil daftar kontrol akses untuk bucket bernama: amzn-s3-demo-bucket

aws s3api get-bucket-acl --bucket amzn-s3-demo-bucket

Output:

{
    "Owner": {
        "DisplayName": "my-username",
        "ID": "7009a8971cd538e11f6b6606438875e7c86c5b672f46db45460ddcd087d36c32"
    },
    "Grants": [
        {
            "Grantee": {
                "DisplayName": "my-username",
                "ID": "7009a8971cd538e11f6b6606438875e7c86c5b672f46db45460ddcd087d36c32"
            },
            "Permission": "FULL_CONTROL"
        }
    ]
}

  • Untuk detail API, lihat GetBucketAcl di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-bucket-analytics-configuration.

AWS CLI

Untuk mengambil konfigurasi analitik untuk bucket dengan ID tertentu

get-bucket-analytics-configurationContoh berikut menampilkan konfigurasi analitik untuk bucket dan ID yang ditentukan.

aws s3api get-bucket-analytics-configuration \
    --bucket amzn-s3-demo-bucket \
    --id 1

Output:

{
    "AnalyticsConfiguration": {
        "StorageClassAnalysis": {},
        "Id": "1"
    }
}

Contoh kode berikut menunjukkan cara menggunakanget-bucket-cors.

AWS CLI

Perintah berikut mengambil konfigurasi Ber Cross-Origin bagi Sumber Daya untuk bucket bernama: amzn-s3-demo-bucket

aws s3api get-bucket-cors --bucket amzn-s3-demo-bucket

Output:

{
    "CORSRules": [
        {
            "AllowedHeaders": [
                "*"
            ],
            "ExposeHeaders": [
                "x-amz-server-side-encryption"
            ],
            "AllowedMethods": [
                "PUT",
                "POST",
                "DELETE"
            ],
            "MaxAgeSeconds": 3000,
            "AllowedOrigins": [
                "http://www.example.com"
            ]
        },
        {
            "AllowedHeaders": [
                "Authorization"
            ],
            "MaxAgeSeconds": 3000,
            "AllowedMethods": [
                "GET"
            ],
            "AllowedOrigins": [
                "*"
            ]
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakanget-bucket-encryption.

AWS CLI

Untuk mengambil konfigurasi enkripsi sisi server untuk bucket

get-bucket-encryptionContoh berikut mengambil konfigurasi enkripsi sisi server untuk bucket. amzn-s3-demo-bucket

aws s3api get-bucket-encryption \
    --bucket amzn-s3-demo-bucket

Output:

{
    "ServerSideEncryptionConfiguration": {
        "Rules": [
            {
                "ApplyServerSideEncryptionByDefault": {
                    "SSEAlgorithm": "AES256"
                }
            }
        ]
    }
}

Contoh kode berikut menunjukkan cara menggunakanget-bucket-intelligent-tiering-configuration.

AWS CLI

Untuk mengambil Intelligent-Tiering konfigurasi S3 pada bucket

get-bucket-intelligent-tiering-configurationContoh berikut mengambil Intelligent-Tiering konfigurasi S3, bernama ExampleConfig, pada bucket.

aws s3api get-bucket-intelligent-tiering-configuration \
    --bucket amzn-s3-demo-bucket \
    --id ExampleConfig

Output:

{
    "IntelligentTieringConfiguration": {
        "Id": "ExampleConfig2",
        "Filter": {
            "Prefix": "images"
        },
        "Status": "Enabled",
        "Tierings": [
            {
                "Days": 90,
                "AccessTier": "ARCHIVE_ACCESS"
            },
            {
                "Days": 180,
                "AccessTier": "DEEP_ARCHIVE_ACCESS"
            }
        ]
    }
}

Untuk informasi selengkapnya, lihat Menggunakan S3 Intelligent-Tiering di Panduan Pengguna Amazon S3.

Contoh kode berikut menunjukkan cara menggunakanget-bucket-inventory-configuration.

AWS CLI

Untuk mengambil konfigurasi inventaris untuk bucket

get-bucket-inventory-configurationContoh berikut mengambil konfigurasi inventaris untuk bucket yang ditentukan dengan ID1.

aws s3api get-bucket-inventory-configuration \
    --bucket amzn-s3-demo-bucket \
    --id 1

Output:

{
    "InventoryConfiguration": {
        "IsEnabled": true,
        "Destination": {
            "S3BucketDestination": {
                "Format": "ORC",
                "Bucket": "arn:aws:s3:::amzn-s3-demo-bucket",
                "AccountId": "123456789012"
            }
        },
        "IncludedObjectVersions": "Current",
        "Id": "1",
        "Schedule": {
            "Frequency": "Weekly"
        }
    }
}

Contoh kode berikut menunjukkan cara menggunakanget-bucket-lifecycle-configuration.

AWS CLI

Perintah berikut mengambil konfigurasi siklus hidup untuk bucket bernama: amzn-s3-demo-bucket

aws s3api get-bucket-lifecycle-configuration --bucket amzn-s3-demo-bucket

Output:

{
    "Rules": [
        {
            "ID": "Move rotated logs to Glacier",
            "Prefix": "rotated/",
            "Status": "Enabled",
            "Transitions": [
                {
                    "Date": "2015-11-10T00:00:00.000Z",
                    "StorageClass": "GLACIER"
                }
            ]
        },
        {
            "Status": "Enabled",
            "Prefix": "",
            "NoncurrentVersionTransitions": [
                {
                    "NoncurrentDays": 0,
                    "StorageClass": "GLACIER"
                }
            ],
            "ID": "Move old versions to Glacier"
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakanget-bucket-lifecycle.

AWS CLI

Perintah berikut mengambil konfigurasi siklus hidup untuk bucket bernama: amzn-s3-demo-bucket

aws s3api get-bucket-lifecycle --bucket amzn-s3-demo-bucket

Output:

{
  "Rules": [
    {
      "ID": "Move to Glacier after sixty days (objects in logs/2015/)",
      "Prefix": "logs/2015/",
      "Status": "Enabled",
      "Transition": {
        "Days": 60,
        "StorageClass": "GLACIER"
      }
    },
    {
      "Expiration": {
        "Date": "2016-01-01T00:00:00.000Z"
      },
      "ID": "Delete 2014 logs in 2016.",
      "Prefix": "logs/2014/",
      "Status": "Enabled"
    }
  ]
}

Contoh kode berikut menunjukkan cara menggunakanget-bucket-location.

AWS CLI

Perintah berikut mengambil batasan lokasi untuk bucket bernamaamzn-s3-demo-bucket, jika ada batasan:

aws s3api get-bucket-location --bucket amzn-s3-demo-bucket

Output:

{
    "LocationConstraint": "us-west-2"
}

Contoh kode berikut menunjukkan cara menggunakanget-bucket-logging.

AWS CLI

Untuk mengambil status logging untuk bucket

get-bucket-loggingContoh berikut mengambil status logging untuk bucket yang ditentukan.

aws s3api get-bucket-logging \
    --bucket amzn-s3-demo-bucket

Output:

{
    "LoggingEnabled": {
        "TargetPrefix": "",
        "TargetBucket": "amzn-s3-demo-bucket-logs"
          }
}

Contoh kode berikut menunjukkan cara menggunakanget-bucket-metrics-configuration.

AWS CLI

Untuk mengambil konfigurasi metrik untuk bucket dengan ID tertentu

get-bucket-metrics-configurationContoh berikut menampilkan konfigurasi metrik untuk bucket dan ID yang ditentukan.

aws s3api get-bucket-metrics-configuration \
    --bucket amzn-s3-demo-bucket \
    --id 123

Output:

{
    "MetricsConfiguration": {
        "Filter": {
            "Prefix": "logs"
        },
        "Id": "123"
    }
}

Contoh kode berikut menunjukkan cara menggunakanget-bucket-notification-configuration.

AWS CLI

Perintah berikut mengambil konfigurasi notifikasi untuk bucket bernama: amzn-s3-demo-bucket

aws s3api get-bucket-notification-configuration --bucket amzn-s3-demo-bucket

Output:

{
    "TopicConfigurations": [
        {
            "Id": "YmQzMmEwM2EjZWVlI0NGItNzVtZjI1MC00ZjgyLWZDBiZWNl",
            "TopicArn": "arn:aws:sns:us-west-2:123456789012:my-notification-topic",
            "Events": [
                "s3:ObjectCreated:*"
            ]
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakanget-bucket-notification.

AWS CLI

Perintah berikut mengambil konfigurasi notifikasi untuk bucket bernama: amzn-s3-demo-bucket

aws s3api get-bucket-notification --bucket amzn-s3-demo-bucket

Output:

{
    "TopicConfiguration": {
        "Topic": "arn:aws:sns:us-west-2:123456789012:my-notification-topic",
        "Id": "YmQzMmEwM2EjZWVlI0NGItNzVtZjI1MC00ZjgyLWZDBiZWNl",
        "Event": "s3:ObjectCreated:*",
        "Events": [
            "s3:ObjectCreated:*"
        ]
    }
}

Contoh kode berikut menunjukkan cara menggunakanget-bucket-ownership-controls.

AWS CLI

Untuk mengambil pengaturan kepemilikan bucket dari bucket

get-bucket-ownership-controlsContoh berikut mengambil pengaturan kepemilikan bucket dari bucket.

aws s3api get-bucket-ownership-controls \
    --bucket amzn-s3-demo-bucket

Output:

{
    "OwnershipControls": {
        "Rules": [
            {
                "ObjectOwnership": "BucketOwnerEnforced"
            }
        ]
    }
}

Untuk informasi selengkapnya, lihat Melihat setelan Kepemilikan Objek untuk bucket S3 di Panduan Pengguna Amazon S3.

Contoh kode berikut menunjukkan cara menggunakanget-bucket-policy-status.

AWS CLI

Untuk mengambil status kebijakan untuk bucket yang menunjukkan apakah bucket bersifat publik

get-bucket-policy-statusContoh berikut mengambil status kebijakan untuk bucketamzn-s3-demo-bucket.

aws s3api get-bucket-policy-status \
    --bucket amzn-s3-demo-bucket

Output:

{
    "PolicyStatus": {
        "IsPublic": false
    }
}

Contoh kode berikut menunjukkan cara menggunakanget-bucket-policy.

AWS CLI

Perintah berikut mengambil kebijakan bucket untuk bucket bernama: amzn-s3-demo-bucket

aws s3api get-bucket-policy --bucket amzn-s3-demo-bucket

Output:

{
    "Policy": "{\"Version\":\"2008-10-17\",\"Statement\":[{\"Sid\":\"\",\"Effect\":\"Allow\",\"Principal\":\"*\",\"Action\":\"s3:GetObject\",\"Resource\":\"arn:aws:s3:::amzn-s3-demo-bucket/*\"},{\"Sid\":\"\",\"Effect\":\"Deny\",\"Principal\":\"*\",\"Action\":\"s3:GetObject\",\"Resource\":\"arn:aws:s3:::amzn-s3-demo-bucket/secret/*\"}]}"
}

Dapatkan dan masukkan kebijakan bucket Contoh berikut menunjukkan bagaimana Anda dapat mengunduh kebijakan bucket Amazon S3, membuat modifikasi pada file, dan kemudian menggunakannya put-bucket-policy untuk menerapkan kebijakan bucket yang dimodifikasi. Untuk mengunduh kebijakan bucket ke file, Anda dapat menjalankan:

aws s3api get-bucket-policy --bucket amzn-s3-demo-bucket --query Policy --output text > policy.json

Anda kemudian dapat memodifikasi policy.json file sesuai kebutuhan. Akhirnya Anda dapat menerapkan kebijakan yang dimodifikasi ini kembali ke bucket S3 dengan menjalankan:

policy.jsonberkas sesuai kebutuhan. Akhirnya Anda dapat menerapkan kebijakan yang dimodifikasi ini kembali ke bucket S3 dengan menjalankan:

berkas sesuai kebutuhan. Akhirnya Anda dapat menerapkan kebijakan yang dimodifikasi ini kembali ke bucket S3 dengan menjalankan:

aws s3api put-bucket-policy --bucket amzn-s3-demo-bucket --policy file://policy.json

Contoh kode berikut menunjukkan cara menggunakanget-bucket-replication.

AWS CLI

Perintah berikut mengambil konfigurasi replikasi untuk bucket bernama: amzn-s3-demo-bucket

aws s3api get-bucket-replication --bucket amzn-s3-demo-bucket

Output:

{
    "ReplicationConfiguration": {
        "Rules": [
            {
                "Status": "Enabled",
                "Prefix": "",
                "Destination": {
                    "Bucket": "arn:aws:s3:::amzn-s3-demo-bucket-backup",
                    "StorageClass": "STANDARD"
                },
                "ID": "ZmUwNzE4ZmQ4tMjVhOS00MTlkLOGI4NDkzZTIWJjNTUtYTA1"
            }
        ],
        "Role": "arn:aws:iam::123456789012:role/s3-replication-role"
    }
}

Contoh kode berikut menunjukkan cara menggunakanget-bucket-request-payment.

AWS CLI

Untuk mengambil konfigurasi permintaan pembayaran untuk bucket

get-bucket-request-paymentContoh berikut mengambil konfigurasi pemohon membayar untuk bucket yang ditentukan.

aws s3api get-bucket-request-payment \
    --bucket amzn-s3-demo-bucket

Output:

{
    "Payer": "BucketOwner"
}

Contoh kode berikut menunjukkan cara menggunakanget-bucket-tagging.

AWS CLI

Perintah berikut mengambil konfigurasi penandaan untuk bucket bernama: amzn-s3-demo-bucket

aws s3api get-bucket-tagging --bucket amzn-s3-demo-bucket

Output:

{
    "TagSet": [
        {
            "Value": "marketing",
            "Key": "organization"
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakanget-bucket-versioning.

AWS CLI

Perintah berikut mengambil konfigurasi versioning untuk bucket bernama: amzn-s3-demo-bucket

aws s3api get-bucket-versioning --bucket amzn-s3-demo-bucket

Output:

{
    "Status": "Enabled"
}

Contoh kode berikut menunjukkan cara menggunakanget-bucket-website.

AWS CLI

Perintah berikut mengambil konfigurasi situs web statis untuk bucket bernama: amzn-s3-demo-bucket

aws s3api get-bucket-website --bucket amzn-s3-demo-bucket

Output:

{
    "IndexDocument": {
        "Suffix": "index.html"
    },
    "ErrorDocument": {
        "Key": "error.html"
    }
}

Contoh kode berikut menunjukkan cara menggunakanget-object-acl.

AWS CLI

Perintah berikut mengambil daftar kontrol akses untuk objek dalam bucket bernama: amzn-s3-demo-bucket

aws s3api get-object-acl --bucket amzn-s3-demo-bucket --key index.html

Output:

{
    "Owner": {
        "DisplayName": "my-username",
        "ID": "7009a8971cd538e11f6b6606438875e7c86c5b672f46db45460ddcd087d36c32"
    },
    "Grants": [
        {
            "Grantee": {
                "DisplayName": "my-username",
                "ID": "7009a8971cd538e11f6b6606438875e7c86c5b672f46db45460ddcd087d36c32"
            },
            "Permission": "FULL_CONTROL"
        },
        {
            "Grantee": {
                "URI": "http://acs.amazonaws.com/groups/global/AllUsers"
            },
            "Permission": "READ"
        }
    ]
}

  • Untuk detail API, lihat GetObjectAcl di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-object-attributes.

AWS CLI

Untuk mengambil metadata dari objek tanpa mengembalikan objek itu sendiri

get-object-attributesContoh berikut mengambil metadata dari objekdoc1.rtf.

aws s3api get-object-attributes \
    --bucket amzn-s3-demo-bucket \
    --key doc1.rtf \
    --object-attributes "StorageClass" "ETag" "ObjectSize"

Output:

{
    "LastModified": "2022-03-15T19:37:31+00:00",
    "VersionId": "IuCPjXTDzHNfldAuitVBIKJpF2p1fg4P",
    "ETag": "b662d79adeb7c8d787ea7eafb9ef6207",
    "StorageClass": "STANDARD",
    "ObjectSize": 405
}

Untuk informasi selengkapnya, lihat GetObjectAttributes di Referensi API Amazon S3.

Contoh kode berikut menunjukkan cara menggunakanget-object-legal-hold.

AWS CLI

Mengambil status Legal Hold dari suatu objek

get-object-legal-holdContoh berikut mengambil status Legal Hold untuk objek yang ditentukan.

aws s3api get-object-legal-hold \
    --bucket amzn-s3-demo-bucket-with-object-lock \
    --key doc1.rtf

Output:

{
    "LegalHold": {
        "Status": "ON"
    }
}

Contoh kode berikut menunjukkan cara menggunakanget-object-lock-configuration.

AWS CLI

Untuk mengambil konfigurasi kunci objek untuk bucket

get-object-lock-configurationContoh berikut mengambil konfigurasi kunci objek untuk bucket yang ditentukan.

aws s3api get-object-lock-configuration \
    --bucket amzn-s3-demo-bucket-with-object-lock

Output:

{
    "ObjectLockConfiguration": {
        "ObjectLockEnabled": "Enabled",
        "Rule": {
            "DefaultRetention": {
                "Mode": "COMPLIANCE",
                "Days": 50
            }
        }
    }
}

Contoh kode berikut menunjukkan cara menggunakanget-object-retention.

AWS CLI

Untuk mengambil konfigurasi retensi objek untuk objek

get-object-retentionContoh berikut mengambil konfigurasi retensi objek untuk objek yang ditentukan.

aws s3api get-object-retention \
    --bucket amzn-s3-demo-bucket-with-object-lock \
    --key doc1.rtf

Output:

{
    "Retention": {
        "Mode": "GOVERNANCE",
        "RetainUntilDate": "2025-01-01T00:00:00.000Z"
    }
}

Contoh kode berikut menunjukkan cara menggunakanget-object-tagging.

AWS CLI

Untuk mengambil tag yang dilampirkan ke objek

get-object-taggingContoh berikut mengambil nilai-nilai untuk kunci yang ditentukan dari objek yang ditentukan.

aws s3api get-object-tagging \
    --bucket amzn-s3-demo-bucket \
    --key doc1.rtf

Output:

{
    "TagSet": [
        {
            "Value": "confidential",
            "Key": "designation"
        }
    ]
}

get-object-taggingContoh berikut mencoba untuk mengambil set tag dari objekdoc2.rtf, yang tidak memiliki tag.

aws s3api get-object-tagging \
    --bucket amzn-s3-demo-bucket \
    --key doc2.rtf

Output:

{
    "TagSet": []
}

get-object-taggingContoh berikut mengambil set tag objekdoc3.rtf, yang memiliki beberapa tag.

aws s3api get-object-tagging \
    --bucket amzn-s3-demo-bucket \
    --key doc3.rtf

Output:

{
    "TagSet": [
        {
            "Value": "confidential",
            "Key": "designation"
        },
        {
            "Value": "finance",
            "Key": "department"
        },
        {
            "Value": "payroll",
            "Key": "team"
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakanget-object-torrent.

AWS CLI

Perintah berikut membuat torrent untuk objek dalam bucket bernamaamzn-s3-demo-bucket:

aws s3api get-object-torrent --bucket amzn-s3-demo-bucket --key large-video-file.mp4 large-video-file.torrent

File torrent disimpan secara lokal di folder saat ini. Perhatikan bahwa nama file keluaran (large-video-file.torrent) ditentukan tanpa nama opsi dan harus menjadi argumen terakhir dalam perintah.

Contoh kode berikut menunjukkan cara menggunakanget-object.

AWS CLI

Contoh berikut menggunakan get-object perintah untuk mengunduh objek dari Amazon S3:

aws s3api get-object --bucket text-content --key dir/my_images.tar.bz2 my_images.tar.bz2

Perhatikan bahwa parameter outfile ditentukan tanpa nama opsi seperti “--outfile”. Nama file output harus menjadi parameter terakhir dalam perintah.

Contoh di bawah ini menunjukkan penggunaan --range untuk mengunduh rentang byte tertentu dari suatu objek. Perhatikan rentang byte perlu diawali dengan “bytes=”:

aws s3api get-object --bucket text-content --key dir/my_data --range bytes=8888-9999 my_data_range

Untuk informasi selengkapnya tentang mengambil objek, lihat Mendapatkan Objek di Panduan Pengembang Amazon S3.

  • Untuk detail API, lihat GetObject di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-public-access-block.

AWS CLI

Untuk mengatur atau memodifikasi konfigurasi akses publik blok untuk bucket

get-public-access-blockContoh berikut menampilkan konfigurasi akses publik blok untuk bucket yang ditentukan.

aws s3api get-public-access-block \
    --bucket amzn-s3-demo-bucket

Output:

{
    "PublicAccessBlockConfiguration": {
        "IgnorePublicAcls": true,
        "BlockPublicPolicy": true,
        "BlockPublicAcls": true,
        "RestrictPublicBuckets": true
    }
}

Contoh kode berikut menunjukkan cara menggunakanhead-bucket.

AWS CLI

Perintah berikut memverifikasi akses ke bucket bernama: amzn-s3-demo-bucket

aws s3api head-bucket --bucket amzn-s3-demo-bucket

Jika bucket ada dan Anda memiliki akses ke sana, tidak ada output yang dikembalikan. Jika tidak, pesan kesalahan akan ditampilkan. Contoh:

A client error (404) occurred when calling the HeadBucket operation: Not Found

  • Untuk detail API, lihat HeadBucket di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanhead-object.

AWS CLI

Perintah berikut mengambil metadata untuk objek dalam bucket bernama: amzn-s3-demo-bucket

aws s3api head-object --bucket amzn-s3-demo-bucket --key index.html

Output:

{
    "AcceptRanges": "bytes",
    "ContentType": "text/html",
    "LastModified": "Thu, 16 Apr 2015 18:19:14 GMT",
    "ContentLength": 77,
    "VersionId": "null",
    "ETag": "\"30a6ec7e1a9ad79c203d05a589c8b400\"",
    "Metadata": {}
}

  • Untuk detail API, lihat HeadObject di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-bucket-analytics-configurations.

AWS CLI

Untuk mengambil daftar konfigurasi analitik untuk bucket

Berikut ini list-bucket-analytics-configurations mengambil daftar konfigurasi analitik untuk bucket yang ditentukan.

aws s3api list-bucket-analytics-configurations \
    --bucket amzn-s3-demo-bucket

Output:

{
    "AnalyticsConfigurationList": [
        {
            "StorageClassAnalysis": {},
            "Id": "1"
        }
    ],
    "IsTruncated": false
}

Contoh kode berikut menunjukkan cara menggunakanlist-bucket-intelligent-tiering-configurations.

AWS CLI

Untuk mengambil semua Intelligent-Tiering konfigurasi S3 pada bucket

list-bucket-intelligent-tiering-configurationsContoh berikut mengambil semua Intelligent-Tiering konfigurasi S3 pada bucket.

aws s3api list-bucket-intelligent-tiering-configurations \
    --bucket amzn-s3-demo-bucket

Output:

{
    "IsTruncated": false,
    "IntelligentTieringConfigurationList": [
        {
            "Id": "ExampleConfig",
            "Filter": {
                "Prefix": "images"
            },
            "Status": "Enabled",
            "Tierings": [
                {
                    "Days": 90,
                    "AccessTier": "ARCHIVE_ACCESS"
                },
                {
                    "Days": 180,
                    "AccessTier": "DEEP_ARCHIVE_ACCESS"
                }
            ]
        },
        {
            "Id": "ExampleConfig2",
            "Status": "Disabled",
            "Tierings": [
                {
                    "Days": 730,
                    "AccessTier": "ARCHIVE_ACCESS"
                }
            ]
        },
        {
            "Id": "ExampleConfig3",
            "Filter": {
                "Tag": {
                    "Key": "documents",
                    "Value": "taxes"
                }
            },
            "Status": "Enabled",
            "Tierings": [
                {
                    "Days": 90,
                    "AccessTier": "ARCHIVE_ACCESS"
                },
                {
                    "Days": 365,
                    "AccessTier": "DEEP_ARCHIVE_ACCESS"
                }
            ]
        }
    ]
}

Untuk informasi selengkapnya, lihat Menggunakan S3 Intelligent-Tiering di Panduan Pengguna Amazon S3.

Contoh kode berikut menunjukkan cara menggunakanlist-bucket-inventory-configurations.

AWS CLI

Untuk mengambil daftar konfigurasi inventaris untuk bucket

list-bucket-inventory-configurationsContoh berikut mencantumkan konfigurasi inventaris untuk bucket yang ditentukan.

aws s3api list-bucket-inventory-configurations \
    --bucket amzn-s3-demo-bucket

Output:

{
    "InventoryConfigurationList": [
        {
            "IsEnabled": true,
            "Destination": {
                "S3BucketDestination": {
                    "Format": "ORC",
                    "Bucket": "arn:aws:s3:::amzn-s3-demo-bucket",
                    "AccountId": "123456789012"
                }
            },
            "IncludedObjectVersions": "Current",
            "Id": "1",
            "Schedule": {
                "Frequency": "Weekly"
            }
        },
        {
            "IsEnabled": true,
            "Destination": {
                "S3BucketDestination": {
                    "Format": "CSV",
                    "Bucket": "arn:aws:s3:::amzn-s3-demo-bucket",
                    "AccountId": "123456789012"
                }
            },
            "IncludedObjectVersions": "Current",
            "Id": "2",
            "Schedule": {
                "Frequency": "Daily"
            }
        }
    ],
    "IsTruncated": false
}

Contoh kode berikut menunjukkan cara menggunakanlist-bucket-metrics-configurations.

AWS CLI

Untuk mengambil daftar konfigurasi metrik untuk bucket

list-bucket-metrics-configurationsContoh berikut mengambil daftar konfigurasi metrik untuk bucket yang ditentukan.

aws s3api list-bucket-metrics-configurations \
    --bucket amzn-s3-demo-bucket

Output:

{
    "IsTruncated": false,
    "MetricsConfigurationList": [
        {
            "Filter": {
                "Prefix": "logs"
            },
            "Id": "123"
        },
        {
            "Filter": {
                "Prefix": "tmp"
            },
            "Id": "234"
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakanlist-buckets.

AWS CLI

Perintah berikut menggunakan list-buckets perintah untuk menampilkan nama semua bucket Amazon S3 Anda (di semua wilayah):

aws s3api list-buckets --query "Buckets[].Name"

Opsi kueri memfilter output dari list-buckets bawah ke hanya nama bucket.

Untuk informasi selengkapnya tentang bucket, lihat Bekerja dengan Bucket Amazon S3 di Panduan Pengembang Amazon S3.

  • Untuk detail API, lihat ListBuckets di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-multipart-uploads.

AWS CLI

Perintah berikut mencantumkan semua unggahan multipart aktif untuk bucket bernama: amzn-s3-demo-bucket

aws s3api list-multipart-uploads --bucket amzn-s3-demo-bucket

Output:

{
    "Uploads": [
        {
            "Initiator": {
                "DisplayName": "username",
                "ID": "arn:aws:iam::0123456789012:user/username"
            },
            "Initiated": "2015-06-02T18:01:30.000Z",
            "UploadId": "dfRtDYU0WWCCcH43C3WFbkRONycyCpTJJvxu2i5GYkZljF.Yxwh6XG7WfS2vC4to6HiV6Yjlx.cph0gtNBtJ8P3URCSbB7rjxI5iEwVDmgaXZOGgkk5nVTW16HOQ5l0R",
            "StorageClass": "STANDARD",
            "Key": "multipart/01",
            "Owner": {
                "DisplayName": "aws-account-name",
                "ID": "100719349fc3b6dcd7c820a124bf7aecd408092c3d7b51b38494939801fc248b"
            }
        }
    ],
    "CommonPrefixes": []
}

Pengunggahan multipart yang sedang berlangsung dikenakan biaya penyimpanan di Amazon S3. Selesaikan atau batalkan unggahan multipart aktif untuk menghapus bagian-bagiannya dari akun Anda.

Contoh kode berikut menunjukkan cara menggunakanlist-object-versions.

AWS CLI

Perintah berikut mengambil informasi versi untuk objek dalam bucket bernama: amzn-s3-demo-bucket

aws s3api list-object-versions --bucket amzn-s3-demo-bucket --prefix index.html

Output:

{
    "DeleteMarkers": [
        {
            "Owner": {
                "DisplayName": "my-username",
                "ID": "7009a8971cd660687538875e7c86c5b672fe116bd438f46db45460ddcd036c32"
            },
            "IsLatest": true,
            "VersionId": "B2VsEK5saUNNHKcOAJj7hIE86RozToyq",
            "Key": "index.html",
            "LastModified": "2015-11-10T00:57:03.000Z"
        },
        {
            "Owner": {
                "DisplayName": "my-username",
                "ID": "7009a8971cd660687538875e7c86c5b672fe116bd438f46db45460ddcd036c32"
            },
            "IsLatest": false,
            "VersionId": ".FLQEZscLIcfxSq.jsFJ.szUkmng2Yw6",
            "Key": "index.html",
            "LastModified": "2015-11-09T23:32:20.000Z"
        }
    ],
    "Versions": [
        {
            "LastModified": "2015-11-10T00:20:11.000Z",
            "VersionId": "Rb_l2T8UHDkFEwCgJjhlgPOZC0qJ.vpD",
            "ETag": "\"0622528de826c0df5db1258a23b80be5\"",
            "StorageClass": "STANDARD",
            "Key": "index.html",
            "Owner": {
                "DisplayName": "my-username",
                "ID": "7009a8971cd660687538875e7c86c5b672fe116bd438f46db45460ddcd036c32"
            },
            "IsLatest": false,
            "Size": 38
        },
        {
            "LastModified": "2015-11-09T23:26:41.000Z",
            "VersionId": "rasWWGpgk9E4s0LyTJgusGeRQKLVIAFf",
            "ETag": "\"06225825b8028de826c0df5db1a23be5\"",
            "StorageClass": "STANDARD",
            "Key": "index.html",
            "Owner": {
                "DisplayName": "my-username",
                "ID": "7009a8971cd660687538875e7c86c5b672fe116bd438f46db45460ddcd036c32"
            },
            "IsLatest": false,
            "Size": 38
        },
        {
            "LastModified": "2015-11-09T22:50:50.000Z",
            "VersionId": "null",
            "ETag": "\"d1f45267a863c8392e07d24dd592f1b9\"",
            "StorageClass": "STANDARD",
            "Key": "index.html",
            "Owner": {
                "DisplayName": "my-username",
                "ID": "7009a8971cd660687538875e7c86c5b672fe116bd438f46db45460ddcd036c32"
            },
            "IsLatest": false,
            "Size": 533823
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakanlist-objects-v2.

AWS CLI

Untuk mendapatkan daftar objek dalam ember

list-objects-v2Contoh berikut mencantumkan objek dalam bucket yang ditentukan.

aws s3api list-objects-v2 \
    --bucket amzn-s3-demo-bucket

Output:

{
    "Contents": [
        {
            "LastModified": "2019-11-05T23:11:50.000Z",
            "ETag": "\"621503c373607d548b37cff8778d992c\"",
            "StorageClass": "STANDARD",
            "Key": "doc1.rtf",
            "Size": 391
        },
        {
            "LastModified": "2019-11-05T23:11:50.000Z",
            "ETag": "\"a2cecc36ab7c7fe3a71a273b9d45b1b5\"",
            "StorageClass": "STANDARD",
            "Key": "doc2.rtf",
            "Size": 373
        },
        {
            "LastModified": "2019-11-05T23:11:50.000Z",
            "ETag": "\"08210852f65a2e9cb999972539a64d68\"",
            "StorageClass": "STANDARD",
            "Key": "doc3.rtf",
            "Size": 399
        },
        {
            "LastModified": "2019-11-05T23:11:50.000Z",
            "ETag": "\"d1852dd683f404306569471af106988e\"",
            "StorageClass": "STANDARD",
            "Key": "doc4.rtf",
            "Size": 6225
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakanlist-objects.

AWS CLI

Contoh berikut menggunakan list-objects perintah untuk menampilkan nama semua objek dalam bucket yang ditentukan:

aws s3api list-objects --bucket text-content --query 'Contents[].{Key: Key, Size: Size}'

Contoh menggunakan --query argumen untuk memfilter output dari list-objects bawah ke nilai kunci dan ukuran untuk setiap objek

Untuk informasi selengkapnya tentang objek, lihat Bekerja dengan Objek Amazon S3 di Panduan Pengembang Amazon S3.

  • Untuk detail API, lihat ListObjects di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-parts.

AWS CLI

Perintah berikut mencantumkan semua bagian yang telah diunggah untuk unggahan multipart dengan kunci multipart/01 dalam bucket: amzn-s3-demo-bucket

aws s3api list-parts --bucket amzn-s3-demo-bucket --key 'multipart/01' --upload-id dfRtDYU0WWCCcH43C3WFbkRONycyCpTJJvxu2i5GYkZljF.Yxwh6XG7WfS2vC4to6HiV6Yjlx.cph0gtNBtJ8P3URCSbB7rjxI5iEwVDmgaXZOGgkk5nVTW16HOQ5l0R

Output:

{
    "Owner": {
        "DisplayName": "aws-account-name",
        "ID": "100719349fc3b6dcd7c820a124bf7aecd408092c3d7b51b38494939801fc248b"
    },
    "Initiator": {
        "DisplayName": "username",
        "ID": "arn:aws:iam::0123456789012:user/username"
    },
    "Parts": [
        {
            "LastModified": "2015-06-02T18:07:35.000Z",
            "PartNumber": 1,
            "ETag": "\"e868e0f4719e394144ef36531ee6824c\"",
            "Size": 5242880
        },
        {
            "LastModified": "2015-06-02T18:07:42.000Z",
            "PartNumber": 2,
            "ETag": "\"6bb2b12753d66fe86da4998aa33fffb0\"",
            "Size": 5242880
        },
        {
            "LastModified": "2015-06-02T18:07:47.000Z",
            "PartNumber": 3,
            "ETag": "\"d0a0112e841abec9c9ec83406f0159c8\"",
            "Size": 5242880
        }
    ],
    "StorageClass": "STANDARD"
}

  • Untuk detail API, lihat ListParts di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanls.

AWS CLI

Contoh 1: Mencantumkan semua bucket milik pengguna

Per ls intah berikut mencantumkan semua bucket yang dimiliki oleh pengguna. Dalam contoh ini, pengguna memiliki bucket amzn-s3-demo-bucket danamzn-s3-demo-bucket2. Stempel waktu adalah tanggal bucket dibuat, ditampilkan di zona waktu mesin Anda. Tanggal ini dapat berubah saat membuat perubahan pada bucket Anda, seperti mengedit kebijakan bucket-nya. Perhatikan jika s3:// digunakan untuk argumen path<S3Uri>, itu akan mencantumkan semua bucket juga.

aws s3 ls

Output:

2013-07-11 17:08:50 amzn-s3-demo-bucket
2013-07-24 14:55:44 amzn-s3-demo-bucket2

Contoh 2: Mencantumkan semua awalan dan objek dalam bucket

Per ls intah berikut mencantumkan objek dan awalan umum di bawah bucket dan awalan tertentu. Dalam contoh ini, pengguna memiliki bucket amzn-s3-demo-bucket dengan objek test.txt dansomePrefix/test.txt. Yang LastWriteTime dan Length sewenang-wenang. Perhatikan bahwa karena ls perintah tidak memiliki interaksi dengan sistem file lokal, skema s3:// URI tidak diperlukan untuk menyelesaikan ambiguitas dan dapat dihilangkan.

aws s3 ls s3://amzn-s3-demo-bucket

Output:

                           PRE somePrefix/
2013-07-25 17:06:27         88 test.txt

Contoh 3: Mencantumkan semua awalan dan objek dalam bucket dan awalan tertentu

Per ls intah berikut mencantumkan objek dan awalan umum di bawah bucket dan awalan tertentu. Namun, tidak ada objek atau awalan umum di bawah bucket dan awalan yang ditentukan.

aws s3 ls s3://amzn-s3-demo-bucket/noExistPrefix

Output:

None

Contoh 4: Daftar semua awalan dan objek secara rekursif dalam bucket

Per ls intah berikut akan secara rekursif mencantumkan objek dalam bucket. Alih-alih PRE dirname/ ditampilkan dalam output, semua konten dalam bucket akan dicantumkan secara berurutan.

aws s3 ls s3://amzn-s3-demo-bucket \
    --recursive

Output:

2013-09-02 21:37:53         10 a.txt
2013-09-02 21:37:53    2863288 foo.zip
2013-09-02 21:32:57         23 foo/bar/.baz/a
2013-09-02 21:32:58         41 foo/bar/.baz/b
2013-09-02 21:32:57        281 foo/bar/.baz/c
2013-09-02 21:32:57         73 foo/bar/.baz/d
2013-09-02 21:32:57        452 foo/bar/.baz/e
2013-09-02 21:32:57        896 foo/bar/.baz/hooks/bar
2013-09-02 21:32:57        189 foo/bar/.baz/hooks/foo
2013-09-02 21:32:57        398 z.txt

Contoh 5: Meringkas semua awalan dan objek dalam ember

Perintah berikut menunjukkan ls perintah yang sama menggunakan opsi --human reading dan --. --yang dapat dibaca manusia menampilkan ukuran file di. Bytes/MiB/KiB/GiB/TiB/PiB/EiB --menampilkan jumlah total objek dan ukuran total di akhir daftar hasil:

aws s3 ls s3://amzn-s3-demo-bucket \
    --recursive \
    --human-readable \
    --summarize

Output:

2013-09-02 21:37:53   10 Bytes a.txt
2013-09-02 21:37:53  2.9 MiB foo.zip
2013-09-02 21:32:57   23 Bytes foo/bar/.baz/a
2013-09-02 21:32:58   41 Bytes foo/bar/.baz/b
2013-09-02 21:32:57  281 Bytes foo/bar/.baz/c
2013-09-02 21:32:57   73 Bytes foo/bar/.baz/d
2013-09-02 21:32:57  452 Bytes foo/bar/.baz/e
2013-09-02 21:32:57  896 Bytes foo/bar/.baz/hooks/bar
2013-09-02 21:32:57  189 Bytes foo/bar/.baz/hooks/foo
2013-09-02 21:32:57  398 Bytes z.txt

Total Objects: 10
   Total Size: 2.9 MiB

Contoh 6: Mendaftarkan dari titik akses S3

Per ls intah berikut mencantumkan objek dari access point (myaccesspoint):

aws s3 ls s3://arn:aws:s3:us-west-2:123456789012:accesspoint/myaccesspoint/

Output:

                           PRE somePrefix/
2013-07-25 17:06:27         88 test.txt

  • Untuk detail API, lihat Ls di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanmb.

AWS CLI

Contoh 1: Buat bucket

Per mb intah berikut membuat bucket. Dalam contoh ini, pengguna membuat bucketamzn-s3-demo-bucket. Bucket dibuat di wilayah yang ditentukan dalam file konfigurasi pengguna:

aws s3 mb s3://amzn-s3-demo-bucket

Output:

make_bucket: s3://amzn-s3-demo-bucket

Contoh 2: Buat bucket di wilayah yang ditentukan

Per mb intah berikut membuat bucket di wilayah yang ditentukan oleh --region parameter. Dalam contoh ini, pengguna membuat bucket amzn-s3-demo-bucket di wilayahus-west-1:

aws s3 mb s3://amzn-s3-demo-bucket \
    --region us-west-1

Output:

make_bucket: s3://amzn-s3-demo-bucket

Contoh 3: Buat bucket dengan tag tertentu

Per mb intah berikut membuat bucket dengan tag tertentu menggunakan --tags parameter. Dalam contoh ini, pengguna membuat bucket amzn-s3-demo-bucket dengan dua tag dengan kunci Key1 danKey2, masing-masing.

aws s3 mb s3://amzn-s3-demo-bucket \
    --tags Key1 Value1 \
    --tags Key2 Value2

Output:

make_bucket: s3://amzn-s3-demo-bucket

  • Untuk detail API, lihat Mb di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanmv.

AWS CLI

Contoh 1: Memindahkan file lokal ke bucket yang ditentukan

Per mv intah berikut memindahkan satu file ke bucket dan kunci tertentu.

aws s3 mv test.txt s3://amzn-s3-demo-bucket/test2.txt

Output:

move: test.txt to s3://amzn-s3-demo-bucket/test2.txt

Contoh 2: Memindahkan objek ke bucket dan kunci yang ditentukan

Per mv intah berikut memindahkan objek S3 tunggal ke bucket dan kunci tertentu.

aws s3 mv s3://amzn-s3-demo-bucket/test.txt s3://amzn-s3-demo-bucket/test2.txt

Output:

move: s3://amzn-s3-demo-bucket/test.txt to s3://amzn-s3-demo-bucket/test2.txt

Contoh 3: Pindahkan objek S3 ke direktori lokal

Per mv intah berikut memindahkan objek tunggal ke file tertentu secara lokal.

aws s3 mv s3://amzn-s3-demo-bucket/test.txt test2.txt

Output:

move: s3://amzn-s3-demo-bucket/test.txt to test2.txt

Contoh 4: Memindahkan objek dengan nama aslinya ke bucket yang ditentukan

Per mv intah berikut memindahkan satu objek ke bucket tertentu sambil mempertahankan nama aslinya:

aws s3 mv s3://amzn-s3-demo-bucket/test.txt s3://amzn-s3-demo-bucket2/

Output:

move: s3://amzn-s3-demo-bucket/test.txt to s3://amzn-s3-demo-bucket2/test.txt

Contoh 5: Pindahkan semua objek dan awalan dalam bucket ke direktori lokal

Ketika diteruskan dengan parameter--recursive, mv perintah berikut secara rekursif memindahkan semua objek di bawah awalan dan bucket yang ditentukan ke direktori tertentu. Dalam contoh ini, ember amzn-s3-demo-bucket memiliki objek test1.txt dantest2.txt.

aws s3 mv s3://amzn-s3-demo-bucket . \
    --recursive

Output:

move: s3://amzn-s3-demo-bucket/test1.txt to test1.txt
move: s3://amzn-s3-demo-bucket/test2.txt to test2.txt

Contoh 6: Pindahkan semua objek dan awalan dalam bucket ke direktori lokal, kecuali file ``.jpg``

Ketika diteruskan dengan parameter--recursive, mv perintah berikut secara rekursif memindahkan semua file di bawah direktori tertentu ke bucket dan awalan tertentu sambil mengecualikan beberapa file dengan menggunakan --exclude parameter. Dalam contoh ini, direktori myDir memiliki file test1.txt dantest2.jpg.

aws s3 mv myDir s3://amzn-s3-demo-bucket/ \
    --recursive \
    --exclude "*.jpg"

Output:

move: myDir/test1.txt to s3://amzn-s3-demo-bucket2/test1.txt

Contoh 7: Pindahkan semua objek dan awalan dalam bucket ke direktori lokal, kecuali awalan yang ditentukan

Ketika diteruskan dengan parameter--recursive, mv perintah berikut secara rekursif memindahkan semua objek di bawah bucket tertentu ke bucket lain sambil mengecualikan beberapa objek dengan menggunakan --exclude parameter. Dalam contoh ini, ember amzn-s3-demo-bucket memiliki objek test1.txt dananother/test1.txt.

aws s3 mv s3://amzn-s3-demo-bucket/ s3://amzn-s3-demo-bucket2/ \
    --recursive \
    --exclude "amzn-s3-demo-bucket/another/*"

Output:

move: s3://amzn-s3-demo-bucket/test1.txt to s3://amzn-s3-demo-bucket2/test1.txt

Contoh 8: Pindahkan objek ke bucket yang ditentukan dan atur ACL

Per mv intah berikut memindahkan satu objek ke bucket dan kunci tertentu saat mengatur ACL kepublic-read-write.

aws s3 mv s3://amzn-s3-demo-bucket/test.txt s3://amzn-s3-demo-bucket/test2.txt \
    --acl public-read-write

Output:

move: s3://amzn-s3-demo-bucket/test.txt to s3://amzn-s3-demo-bucket/test2.txt

Contoh 9: Pindahkan file lokal ke bucket yang ditentukan dan berikan izin

Per mv intah berikut menggambarkan penggunaan --grants opsi untuk memberikan akses baca ke semua pengguna dan kontrol penuh untuk pengguna tertentu yang diidentifikasi oleh alamat email mereka.

aws s3 mv file.txt s3://amzn-s3-demo-bucket/ \
    --grants read=uri=http://acs.amazonaws.com/groups/global/AllUsers full=emailaddress=user@example.com

Output:

move: file.txt to s3://amzn-s3-demo-bucket/file.txt

Contoh 10: Memindahkan file ke titik akses S3

Per mv intah berikut memindahkan satu file bernama mydoc.txt ke titik akses yang dinam myaccesspoint ai pada kunci bernamamykey.

aws s3 mv mydoc.txt s3://arn:aws:s3:us-west-2:123456789012:accesspoint/myaccesspoint/mykey

Output:

move: mydoc.txt to s3://arn:aws:s3:us-west-2:123456789012:accesspoint/myaccesspoint/mykey

  • Untuk detail API, lihat M v di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanpresign.

AWS CLI

Contoh 1: Untuk membuat URL yang ditandatangani sebelumnya dengan masa pakai default satu jam yang menautkan ke objek dalam bucket S3

Per presign intah berikut menghasilkan URL yang telah ditandatangani sebelumnya untuk bucket dan kunci tertentu yang valid selama satu jam.

aws s3 presign s3://amzn-s3-demo-bucket/test2.txt

Output:

https://amzn-s3-demo-bucket.s3.us-west-2.amazonaws.com/key?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAEXAMPLE123456789%2F20210621%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20210621T041609Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=EXAMPLE1234494d5fba3fed607f98018e1dfc62e2529ae96d844123456

Contoh 2: Untuk membuat URL yang ditandatangani sebelumnya dengan masa pakai khusus yang menautkan ke objek dalam bucket S3

Per presign intah berikut menghasilkan URL yang telah ditandatangani sebelumnya untuk bucket dan kunci tertentu yang valid selama satu minggu.

aws s3 presign s3://amzn-s3-demo-bucket/test2.txt \
    --expires-in 604800

Output:

https://amzn-s3-demo-bucket.s3.us-west-2.amazonaws.com/key?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAEXAMPLE123456789%2F20210621%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20210621T041609Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=EXAMPLE1234494d5fba3fed607f98018e1dfc62e2529ae96d844123456

Untuk informasi selengkapnya, lihat Berbagi Objek dengan Orang Lain di Panduan Pengembang Amazon S3.

  • Untuk detail API, lihat Presign di Refer ensi Per AWS CLI intah.

Contoh kode berikut menunjukkan cara menggunakanput-bucket-accelerate-configuration.

AWS CLI

Untuk mengatur konfigurasi akselerasi dari bucket

put-bucket-accelerate-configurationContoh berikut mengaktifkan konfigurasi akselerasi untuk bucket yang ditentukan.

aws s3api put-bucket-accelerate-configuration \
    --bucket amzn-s3-demo-bucket \
    --accelerate-configuration Status=Enabled

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakanput-bucket-acl.

AWS CLI

Contoh ini memberikan full control kepada dua AWS pengguna (user1@example.com dan user2@example.com) dan read izin untuk semua orang:

aws s3api put-bucket-acl --bucket amzn-s3-demo-bucket --grant-full-control emailaddress=user1@example.com,emailaddress=user2@example.com --grant-read uri=http://acs.amazonaws.com/groups/global/AllUsers

Lihat http://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTacl.html untuk detail tentang ACL khusus (perintah ACL s3api, sepertiput-bucket-acl, menggunakan notasi argumen singkatan yang sama).

  • Untuk detail API, lihat PutBucketAcl di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanput-bucket-analytics-configuration.

AWS CLI

Untuk menyetel konfigurasi analitik untuk bucket

put-bucket-analytics-configurationContoh berikut mengonfigurasi analitik untuk bucket yang ditentukan.

aws s3api put-bucket-analytics-configuration \
    --bucket amzn-s3-demo-bucket --id 1 \
    --analytics-configuration '{"Id": "1","StorageClassAnalysis": {}}'

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakanput-bucket-cors.

AWS CLI

Contoh berikut mengaktifkanPUT,POST, dan DELETE meminta dari www.example.com, dan mengaktifkan GET permintaan dari domain apa pun:

aws s3api put-bucket-cors --bucket amzn-s3-demo-bucket --cors-configuration file://cors.json

cors.json:
{
  "CORSRules": [
    {
      "AllowedOrigins": ["http://www.example.com"],
      "AllowedHeaders": ["*"],
      "AllowedMethods": ["PUT", "POST", "DELETE"],
      "MaxAgeSeconds": 3000,
      "ExposeHeaders": ["x-amz-server-side-encryption"]
    },
    {
      "AllowedOrigins": ["*"],
      "AllowedHeaders": ["Authorization"],
      "AllowedMethods": ["GET"],
      "MaxAgeSeconds": 3000
    }
  ]
}

Contoh kode berikut menunjukkan cara menggunakanput-bucket-encryption.

AWS CLI

Untuk mengkonfigurasi enkripsi sisi server untuk bucket

put-bucket-encryptionContoh berikut menetapkan enkripsi AES256 sebagai default untuk bucket yang ditentukan.

aws s3api put-bucket-encryption \
    --bucket amzn-s3-demo-bucket \
    --server-side-encryption-configuration '{"Rules": [{"ApplyServerSideEncryptionByDefault": {"SSEAlgorithm": "AES256"}}]}'

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakanput-bucket-intelligent-tiering-configuration.

AWS CLI

Untuk memperbarui Intelligent-Tiering konfigurasi S3 pada bucket

put-bucket-intelligent-tiering-configurationContoh berikut memperbarui Intelligent-Tiering konfigurasi S3, bernama ExampleConfig, pada bucket. Konfigurasi akan mentransisikan objek yang belum diakses di bawah gambar awalan ke Akses Arsip setelah 90 hari dan Akses Arsip Dalam setelah 180 hari.

aws s3api put-bucket-intelligent-tiering-configuration \
    --bucket amzn-s3-demo-bucket \
    --id "ExampleConfig" \
    --intelligent-tiering-configuration file://intelligent-tiering-configuration.json

Isi dari intelligent-tiering-configuration.json:

{
    "Id": "ExampleConfig",
    "Status": "Enabled",
    "Filter": {
        "Prefix": "images"
        },
    "Tierings": [
        {
            "Days": 90,
            "AccessTier": "ARCHIVE_ACCESS"
        },
        {
            "Days": 180,
            "AccessTier": "DEEP_ARCHIVE_ACCESS"
        }
    ]
}

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mengatur Kepemilikan Objek pada bucket yang ada di Panduan Pengguna Amazon S3.

Contoh kode berikut menunjukkan cara menggunakanput-bucket-inventory-configuration.

AWS CLI

Contoh 1: Untuk mengatur konfigurasi inventaris untuk bucket

put-bucket-inventory-configurationContoh berikut menetapkan laporan ORC-formatted inventaris mingguan untuk bucketamzn-s3-demo-bucket.

aws s3api put-bucket-inventory-configuration \
    --bucket amzn-s3-demo-bucket \
    --id 1 \
    --inventory-configuration '{"Destination": { "S3BucketDestination": { "AccountId": "123456789012", "Bucket": "arn:aws:s3:::amzn-s3-demo-bucket", "Format": "ORC" }}, "IsEnabled": true, "Id": "1", "IncludedObjectVersions": "Current", "Schedule": { "Frequency": "Weekly" }}'

Perintah ini tidak menghasilkan output.

Contoh 2: Untuk mengatur konfigurasi inventaris untuk bucket

put-bucket-inventory-configurationContoh berikut menetapkan laporan CSV-formatted inventaris harian untuk bucketamzn-s3-demo-bucket.

aws s3api put-bucket-inventory-configuration \
    --bucket amzn-s3-demo-bucket \
    --id 2 \
    --inventory-configuration '{"Destination": { "S3BucketDestination": { "AccountId": "123456789012", "Bucket": "arn:aws:s3:::amzn-s3-demo-bucket", "Format": "CSV" }}, "IsEnabled": true, "Id": "2", "IncludedObjectVersions": "Current", "Schedule": { "Frequency": "Daily" }}'

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakanput-bucket-lifecycle-configuration.

AWS CLI

Perintah berikut menerapkan konfigurasi siklus hidup ke bucket bernamaamzn-s3-demo-bucket:

aws s3api put-bucket-lifecycle-configuration --bucket amzn-s3-demo-bucket --lifecycle-configuration  file://lifecycle.json

File lifecycle.json adalah dokumen JSON di folder saat ini yang menentukan dua aturan:

{
    "Rules": [
        {
            "ID": "Move rotated logs to Glacier",
            "Prefix": "rotated/",
            "Status": "Enabled",
            "Transitions": [
                {
                    "Date": "2015-11-10T00:00:00.000Z",
                    "StorageClass": "GLACIER"
                }
            ]
        },
        {
            "Status": "Enabled",
            "Prefix": "",
            "NoncurrentVersionTransitions": [
                {
                    "NoncurrentDays": 2,
                    "StorageClass": "GLACIER"
                }
            ],
            "ID": "Move old versions to Glacier"
        }
    ]
}

Aturan pertama memindahkan file dengan awalan rotated ke Glacier pada tanggal yang ditentukan. Aturan kedua memindahkan versi objek lama ke Glacier ketika mereka tidak lagi terkini. Untuk informasi tentang format stempel waktu yang dapat diterima, lihat Menentukan Nilai Parameter di Panduan Pengguna AWS CLI.

Contoh kode berikut menunjukkan cara menggunakanput-bucket-lifecycle.

AWS CLI

Perintah berikut menerapkan konfigurasi siklus hidup ke bucketamzn-s3-demo-bucket:

aws s3api put-bucket-lifecycle --bucket amzn-s3-demo-bucket --lifecycle-configuration file://lifecycle.json

File lifecycle.json adalah dokumen JSON di folder saat ini yang menentukan dua aturan:

{
  "Rules": [
    {
      "ID": "Move to Glacier after sixty days (objects in logs/2015/)",
      "Prefix": "logs/2015/",
      "Status": "Enabled",
      "Transition": {
        "Days": 60,
        "StorageClass": "GLACIER"
      }
    },
    {
      "Expiration": {
        "Date": "2016-01-01T00:00:00.000Z"
      },
      "ID": "Delete 2014 logs in 2016.",
      "Prefix": "logs/2014/",
      "Status": "Enabled"
    }
  ]
}

Aturan pertama memindahkan file ke Amazon Glacier setelah enam puluh hari. Aturan kedua menghapus file dari Amazon S3 pada tanggal yang ditentukan. Untuk informasi tentang format stempel waktu yang dapat diterima, lihat Menentukan Nilai Parameter di Panduan Pengguna AWS CLI.

Setiap aturan dalam contoh di atas menentukan kebijakan (TransitionatauExpiration) dan awalan file (nama folder) yang diterapkan. Anda juga dapat membuat aturan yang berlaku untuk seluruh bucket dengan menentukan awalan kosong:

{
  "Rules": [
    {
      "ID": "Move to Glacier after sixty days (all objects in bucket)",
      "Prefix": "",
      "Status": "Enabled",
      "Transition": {
        "Days": 60,
        "StorageClass": "GLACIER"
      }
    }
  ]
}

Contoh kode berikut menunjukkan cara menggunakanput-bucket-logging.

AWS CLI

Contoh 1: Untuk mengatur logging kebijakan bucket

put-bucket-loggingContoh berikut menetapkan kebijakan logging untuk amz n-s3-demo-bucket. Pertama, berikan izin utama layanan logging dalam kebijakan bucket Anda menggunakan put-bucket-policy perintah.

aws s3api put-bucket-policy \
    --bucket amzn-s3-demo-bucket \
    --policy file://policy.json

Isi dari policy.json:

{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Sid": "S3ServerAccessLogsPolicy",
            "Effect": "Allow",
            "Principal": {"Service": "logging.s3.amazonaws.com"},
            "Action": "s3:PutObject",
            "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/Logs/*",
            "Condition": {
                "ArnLike": {"aws:SourceARN": "arn:aws:s3:::SOURCE-BUCKET-NAME"},
                "StringEquals": {"aws:SourceAccount": "SOURCE-AWS-ACCOUNT-ID"}
            }
        }
    ]
}

Untuk menerapkan kebijakan logging, gunakanput-bucket-logging.

aws s3api put-bucket-logging \
    --bucket amzn-s3-demo-bucket \
    --bucket-logging-status file://logging.json

Isi dari logging.json:

{
     "LoggingEnabled": {
         "TargetBucket": "amzn-s3-demo-bucket",
         "TargetPrefix": "Logs/"
     }
 }

Per put-bucket-policy intah diperlukan untuk memberikan s3:PutObject izin kepada prinsipal layanan logging.

Untuk informasi selengkapnya, lihat Logging Akses Server Amazon S3 di Panduan Pengguna Amazon S3.

Contoh 2: Untuk mengatur kebijakan bucket untuk akses log hanya ke satu pengguna

put-bucket-loggingContoh berikut menetapkan kebijakan logging untuk amz n-s3-demo-bucket. AWS Pengguna bob@example.com akan memiliki kontrol penuh atas file log, dan tidak ada orang lain yang memiliki akses apa pun. Pertama, berikan izin S3 denganput-bucket-acl.

aws s3api put-bucket-acl \
    --bucket amzn-s3-demo-bucket \
    --grant-write URI=http://acs.amazonaws.com/groups/s3/LogDelivery \
    --grant-read-acp URI=http://acs.amazonaws.com/groups/s3/LogDelivery

Kemudian terapkan kebijakan logging menggunakanput-bucket-logging.

aws s3api put-bucket-logging \
    --bucket amzn-s3-demo-bucket \
    --bucket-logging-status file://logging.json

Isi dari logging.json:

{
    "LoggingEnabled": {
        "TargetBucket": "amzn-s3-demo-bucket",
        "TargetPrefix": "amzn-s3-demo-bucket-logs/",
        "TargetGrants": [
            {
                "Grantee": {
                    "Type": "AmazonCustomerByEmail",
                    "EmailAddress": "bob@example.com"
                },
                "Permission": "FULL_CONTROL"
            }
        ]
    }
}

put-bucket-aclperintah diperlukan untuk memberikan sistem pengiriman log S3 izin yang diperlukan (izin tulis dan baca-cp).

Untuk informasi selengkapnya, lihat Logging Akses Server Amazon S3 di Panduan Pengembang Amazon S3.

Contoh kode berikut menunjukkan cara menggunakanput-bucket-metrics-configuration.

AWS CLI

Untuk mengatur konfigurasi metrik untuk bucket

put-bucket-metrics-configurationContoh berikut menetapkan konfigurasi metrik dengan ID 123 untuk bucket yang ditentukan.

aws s3api put-bucket-metrics-configuration \
    --bucket amzn-s3-demo-bucket \
    --id 123 \
    --metrics-configuration '{"Id": "123", "Filter": {"Prefix": "logs"}}'

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakanput-bucket-notification-configuration.

AWS CLI

Untuk mengaktifkan notifikasi yang ditentukan ke bucket

put-bucket-notification-configurationContoh berikut menerapkan konfigurasi notifikasi ke bucket bernamaamzn-s3-demo-bucket. File notification.json adalah dokumen JSON di folder saat ini yang menentukan topik SNS dan jenis acara untuk dipantau.

aws s3api put-bucket-notification-configuration \
    --bucket amzn-s3-demo-bucket \
    --notification-configuration file://notification.json

Isi dari notification.json:

{
    "TopicConfigurations": [
        {
            "TopicArn": "arn:aws:sns:us-west-2:123456789012:s3-notification-topic",
            "Events": [
                "s3:ObjectCreated:*"
            ]
        }
    ]
}

Topik SNS harus memiliki kebijakan IAM yang melekat padanya yang memungkinkan Amazon S3 untuk menerbitkannya.

{
    "Version":"2012-10-17",
    "Id": "example-ID",
    "Statement": [
        {
            "Sid": "example-statement-ID",
            "Effect": "Allow",
            "Principal": {
                "Service": "s3.amazonaws.com"
            },
            "Action": [
                "SNS:Publish"
            ],
            "Resource": "arn:aws:sns:us-west-2:123456789012::s3-notification-topic",
            "Condition": {
                "ArnLike": {
                    "aws:SourceArn": "arn:aws:s3:*:*:amzn-s3-demo-bucket"
                }
            }
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakanput-bucket-notification.

AWS CLI

Menerapkan konfigurasi notifikasi ke bucket bernamaamzn-s3-demo-bucket:

aws s3api put-bucket-notification --bucket amzn-s3-demo-bucket --notification-configuration file://notification.json

File notification.json adalah dokumen JSON di folder saat ini yang menentukan topik SNS dan jenis acara untuk dipantau:

{
  "TopicConfiguration": {
    "Event": "s3:ObjectCreated:*",
    "Topic": "arn:aws:sns:us-west-2:123456789012:s3-notification-topic"
  }
}

Topik SNS harus memiliki kebijakan IAM yang dilampirkan padanya yang memungkinkan Amazon S3 untuk menerbitkannya:

{
 "Version":"2012-10-17",
 "Id": "example-ID",
 "Statement": [
  {
   "Sid": "example-statement-ID",
   "Effect": "Allow",
   "Principal": {
     "Service": "s3.amazonaws.com"
   },
   "Action": [
    "SNS:Publish"
   ],
   "Resource": "arn:aws:sns:us-west-2:123456789012:amzn-s3-demo-bucket",
   "Condition": {
      "ArnLike": {
      "aws:SourceArn": "arn:aws:s3:*:*:amzn-s3-demo-bucket"
    }
   }
  }
 ]
}

Contoh kode berikut menunjukkan cara menggunakanput-bucket-ownership-controls.

AWS CLI

Untuk memperbarui pengaturan kepemilikan bucket dari bucket

put-bucket-ownership-controlsContoh berikut memperbarui pengaturan kepemilikan bucket dari bucket.

aws s3api put-bucket-ownership-controls \
    --bucket amzn-s3-demo-bucket \
    --ownership-controls="Rules=[{ObjectOwnership=BucketOwnerEnforced}]"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mengatur Kepemilikan Objek pada bucket yang ada di Panduan Pengguna Amazon S3.

Contoh kode berikut menunjukkan cara menggunakanput-bucket-policy.

AWS CLI

Contoh ini memungkinkan semua pengguna untuk mengambil objek apa pun di amzn-s3-dem o-bucket kecuali yang ada di. MySecretFolder Ini juga put memberikan dan delete izin kepada pengguna root AWS akun1234-5678-9012:

aws s3api put-bucket-policy --bucket amzn-s3-demo-bucket --policy file://policy.json

policy.json:
{
   "Statement": [
      {
         "Effect": "Allow",
         "Principal": "*",
         "Action": "s3:GetObject",
         "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*"
      },
      {
         "Effect": "Deny",
         "Principal": "*",
         "Action": "s3:GetObject",
         "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/MySecretFolder/*"
      },
      {
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws:iam::123456789012:root"
         },
         "Action": [
            "s3:DeleteObject",
            "s3:PutObject"
         ],
         "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*"
      }
   ]
}

Contoh kode berikut menunjukkan cara menggunakanput-bucket-replication.

AWS CLI

Untuk mengkonfigurasi replikasi untuk bucket S3

put-bucket-replicationContoh berikut menerapkan konfigurasi replikasi ke bucket S3 yang ditentukan.

aws s3api put-bucket-replication \
    --bucket amzn-s3-demo-bucket1 \
    --replication-configuration file://replication.json

Isi dari replication.json:

{
    "Role": "arn:aws:iam::123456789012:role/s3-replication-role",
    "Rules": [
        {
            "Status": "Enabled",
            "Priority": 1,
            "DeleteMarkerReplication": { "Status": "Disabled" },
            "Filter" : { "Prefix": ""},
            "Destination": {
                "Bucket": "arn:aws:s3:::amzn-s3-demo-bucket2"
            }
        }
    ]
}

Bucket tujuan harus mengaktifkan pembuatan versi. Peran yang ditentukan harus memiliki izin untuk menulis ke bucket tujuan dan memiliki hubungan kepercayaan yang memungkinkan Amazon S3 untuk mengambil peran tersebut.

Contoh kebijakan izin peran:

{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetReplicationConfiguration",
                "s3:ListBucket"
            ],
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-bucket1"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetObjectVersion",
                "s3:GetObjectVersionAcl",
                "s3:GetObjectVersionTagging"
            ],
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-bucket1/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "s3:ReplicateObject",
                "s3:ReplicateDelete",
                "s3:ReplicateTags"
            ],
            "Resource": "arn:aws:s3:::amzn-s3-demo-bucket2/*"
        }
    ]
}

Contoh kebijakan hubungan kepercayaan:

{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "s3.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
        }
    ]
}

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Ini adalah judul topik di Panduan Pengguna Konsol Layanan Penyimpanan Sederhana Amazon.

Contoh kode berikut menunjukkan cara menggunakanput-bucket-request-payment.

AWS CLI

Contoh 1: Untuk mengaktifkan konfigurasi ``requester pays`` untuk bucket

put-bucket-request-paymentContoh berikut mengaktifkan requester pays untuk bucket yang ditentukan.

aws s3api put-bucket-request-payment \
    --bucket amzn-s3-demo-bucket \
    --request-payment-configuration '{"Payer":"Requester"}'

Perintah ini tidak menghasilkan output.

Contoh 2: Untuk menonaktifkan konfigurasi ``requester pays`` untuk bucket

put-bucket-request-paymentContoh berikut menonaktifkan requester pays untuk bucket yang ditentukan.

aws s3api put-bucket-request-payment \
    --bucket amzn-s3-demo-bucket \
    --request-payment-configuration '{"Payer":"BucketOwner"}'

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakanput-bucket-tagging.

AWS CLI

Perintah berikut menerapkan konfigurasi penandaan ke bucket bernama: amzn-s3-demo-bucket

aws s3api put-bucket-tagging --bucket amzn-s3-demo-bucket --tagging file://tagging.json

File tagging.json adalah dokumen JSON di folder saat ini yang menentukan tag:

{
   "TagSet": [
     {
       "Key": "organization",
       "Value": "marketing"
     }
   ]
}

Atau terapkan konfigurasi penandaan amzn-s3-demo-bucket langsung dari baris perintah:

aws s3api put-bucket-tagging --bucket amzn-s3-demo-bucket --tagging 'TagSet=[{Key=organization,Value=marketing}]'

Contoh kode berikut menunjukkan cara menggunakanput-bucket-versioning.

AWS CLI

Perintah berikut memungkinkan pembuatan versi pada bucket bernama: amzn-s3-demo-bucket

aws s3api put-bucket-versioning --bucket amzn-s3-demo-bucket --versioning-configuration Status=Enabled

Perintah berikut memungkinkan pembuatan versi, dan menggunakan kode mfa

aws s3api put-bucket-versioning --bucket amzn-s3-demo-bucket --versioning-configuration Status=Enabled --mfa "SERIAL 123456"

Contoh kode berikut menunjukkan cara menggunakanput-bucket-website.

AWS CLI

Menerapkan konfigurasi situs web statis ke bucket bernamaamzn-s3-demo-bucket:

aws s3api put-bucket-website --bucket amzn-s3-demo-bucket --website-configuration file://website.json

File website.json adalah dokumen JSON di folder saat ini yang menentukan indeks dan halaman kesalahan untuk situs web:

{
    "IndexDocument": {
        "Suffix": "index.html"
    },
    "ErrorDocument": {
        "Key": "error.html"
    }
}

Contoh kode berikut menunjukkan cara menggunakanput-object-acl.

AWS CLI

Perintah berikut memberikan full control kepada dua AWS pengguna (user1@example.com dan user2@example.com) dan read izin untuk semua orang:

aws s3api put-object-acl --bucket amzn-s3-demo-bucket --key file.txt --grant-full-control emailaddress=user1@example.com,emailaddress=user2@example.com --grant-read uri=http://acs.amazonaws.com/groups/global/AllUsers

Lihat http://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTacl.html untuk detail tentang ACL khusus (perintah ACL s3api, sepertiput-object-acl, menggunakan notasi argumen singkatan yang sama).

  • Untuk detail API, lihat PutObjectAcl di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanput-object-legal-hold.

AWS CLI

Untuk menerapkan Penahanan Legal ke objek

put-object-legal-holdContoh berikut menetapkan Legal Hold pada objekdoc1.rtf.

aws s3api put-object-legal-hold \
    --bucket amzn-s3-demo-bucket-with-object-lock \
    --key doc1.rtf \
    --legal-hold Status=ON

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakanput-object-lock-configuration.

AWS CLI

Untuk mengatur konfigurasi kunci objek pada bucket

put-object-lock-configurationContoh berikut menetapkan kunci objek 50 hari pada bucket yang ditentukan.

aws s3api put-object-lock-configuration \
    --bucket amzn-s3-demo-bucket-with-object-lock \
    --object-lock-configuration '{ "ObjectLockEnabled": "Enabled", "Rule": { "DefaultRetention": { "Mode": "COMPLIANCE", "Days": 50 }}}'

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakanput-object-retention.

AWS CLI

Untuk mengatur konfigurasi retensi objek untuk objek

put-object-retentionContoh berikut menetapkan konfigurasi retensi objek untuk objek yang ditentukan hingga 2025-01-01.

aws s3api put-object-retention \
    --bucket amzn-s3-demo-bucket-with-object-lock \
    --key doc1.rtf \
    --retention '{ "Mode": "GOVERNANCE", "RetainUntilDate": "2025-01-01T00:00:00" }'

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakanput-object-tagging.

AWS CLI

Untuk mengatur tag pada objek

put-object-taggingContoh berikut menetapkan tag dengan kunci designation dan nilai confidential pada objek yang ditentukan.

aws s3api put-object-tagging \
    --bucket amzn-s3-demo-bucket \
    --key doc1.rtf \
    --tagging '{"TagSet": [{ "Key": "designation", "Value": "confidential" }]}'

Perintah ini tidak menghasilkan output.

put-object-taggingContoh berikut menetapkan beberapa set tag pada objek tertentu.

aws s3api put-object-tagging \
    --bucket amzn-s3-demo-bucket-example \
    --key doc3.rtf \
    --tagging '{"TagSet": [{ "Key": "designation", "Value": "confidential" }, { "Key": "department", "Value": "finance" }, { "Key": "team", "Value": "payroll" } ]}'

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakanput-object.

AWS CLI

Contoh 1: Mengunggah objek ke Amazon S3

Contoh put-object perintah berikut mengunggah objek ke Amazon S3.

aws s3api put-object \
    --bucket amzn-s3-demo-bucket \
    --key my-dir/MySampleImage.png \
    --body MySampleImage.png

Untuk informasi selengkapnya tentang mengunggah objek, lihat Mengunggah http://docs.aws.amazon.com/AmazonS3/latest/dev/UploadingObjects.html Objek < > di Panduan Pengembang Amazon S3.

Contoh 2: Unggah file video ke Amazon S3

Contoh put-object perintah berikut mengunggah file video.

aws s3api put-object \
    --bucket amzn-s3-demo-bucket \
    --key my-dir/big-video-file.mp4 \
    --body /media/videos/f-sharp-3-data-services.mp4

Untuk informasi selengkapnya tentang mengunggah objek, lihat Mengunggah http://docs.aws.amazon.com/AmazonS3/latest/dev/UploadingObjects.html Objek < > di Panduan Pengembang Amazon S3.

  • Untuk detail API, lihat PutObject di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanput-public-access-block.

AWS CLI

Untuk mengatur konfigurasi akses publik blok untuk bucket

put-public-access-blockContoh berikut menetapkan konfigurasi akses publik blok terbatas untuk bucket yang ditentukan.

aws s3api put-public-access-block \
    --bucket amzn-s3-demo-bucket \
    --public-access-block-configuration "BlockPublicAcls=true,IgnorePublicAcls=true,BlockPublicPolicy=true,RestrictPublicBuckets=true"

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakanrb.

AWS CLI

Contoh 1: Hapus bucket

Per rb intah berikut menghapus ember. Dalam contoh ini, bucket pengguna adalahamzn-s3-demo-bucket. Perhatikan bahwa ember harus kosong untuk menghapus:

aws s3 rb s3://amzn-s3-demo-bucket

Output:

remove_bucket: amzn-s3-demo-bucket

Contoh 2: Memaksa menghapus bucket

Per rb intah berikut menggunakan --force parameter untuk terlebih dahulu menghapus semua objek dalam bucket dan kemudian menghapus bucket itu sendiri. Dalam contoh ini, bucket pengguna adalah amzn-s3-demo-bucket dan objek di dalamnya amzn-s3-demo-bucket adalah test1.txt dantest2.txt:

aws s3 rb s3://amzn-s3-demo-bucket \
    --force

Output:

delete: s3://amzn-s3-demo-bucket/test1.txt
delete: s3://amzn-s3-demo-bucket/test2.txt
remove_bucket: amzn-s3-demo-bucket

  • Untuk detail API, lihat Rb di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanrestore-object.

AWS CLI

Untuk membuat permintaan pemulihan untuk objek

restore-objectContoh berikut mengembalikan objek Amazon S3 Glacier yang ditentukan untuk bucket my-glacier-bucket selama 10 hari.

aws s3api restore-object \
    --bucket my-glacier-bucket \
    --key doc1.rtf \
    --restore-request Days=10

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakanrm.

AWS CLI

Contoh 1: Hapus objek S3

Per rm intah berikut menghapus satu objek S3:

aws s3 rm s3://amzn-s3-demo-bucket/test2.txt

Output:

delete: s3://amzn-s3-demo-bucket/test2.txt

Contoh 2: Hapus semua konten dalam bucket

Per rm intah berikut secara rekursif menghapus semua objek di bawah bucket dan awalan tertentu ketika diteruskan dengan parameter. --recursive Dalam contoh ini, bucket amzn-s3-demo-bucket berisi objek test1.txt dantest2.txt:

aws s3 rm s3://amzn-s3-demo-bucket \
    --recursive

Output:

delete: s3://amzn-s3-demo-bucket/test1.txt
delete: s3://amzn-s3-demo-bucket/test2.txt

Contoh 3: Hapus semua konten dalam bucket, kecuali file ``.jpg``

Per rm intah berikut secara rekursif menghapus semua objek di bawah bucket dan awalan tertentu ketika diteruskan dengan parameter --recursive sambil mengecualikan beberapa objek dengan menggunakan parameter. --exclude Dalam contoh ini, bucket amzn-s3-demo-bucket memiliki objek test1.txt dantest2.jpg:

aws s3 rm s3://amzn-s3-demo-bucket/ \
    --recursive \
    --exclude "*.jpg"

Output:

delete: s3://amzn-s3-demo-bucket/test1.txt

Contoh 4: Hapus semua konten dalam bucket, kecuali objek di bawah awalan yang ditentukan

Per rm intah berikut secara rekursif menghapus semua objek di bawah bucket dan awalan tertentu ketika diteruskan dengan parameter --recursive sambil mengecualikan semua objek di bawah awalan tertentu dengan menggunakan parameter. --exclude Dalam contoh ini, bucket amzn-s3-demo-bucket memiliki objek test1.txt dananother/test.txt:

aws s3 rm s3://amzn-s3-demo-bucket/ \
    --recursive \
    --exclude "another/*"

Output:

delete: s3://amzn-s3-demo-bucket/test1.txt

Contoh 5: Menghapus objek dari titik akses S3

Per rm intah berikut menghapus satu objek (mykey) dari titik akses (myaccesspoint).

aws s3 rm s3://arn:aws:s3:us-west-2:123456789012:accesspoint/myaccesspoint/mykey

Output:

delete: s3://arn:aws:s3:us-west-2:123456789012:accesspoint/myaccesspoint/mykey

  • Untuk detail API, lihat Rm di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanselect-object-content.

AWS CLI

Untuk memfilter konten objek Amazon S3 berdasarkan pernyataan SQL

select-object-contentContoh berikut menyaring objek my-data-file.csv dengan pernyataan SQL yang ditentukan dan mengirimkan output ke file.

aws s3api select-object-content \
    --bucket amzn-s3-demo-bucket \
    --key my-data-file.csv \
    --expression "select * from s3object limit 100" \
    --expression-type 'SQL' \
    --input-serialization '{"CSV": {}, "CompressionType": "NONE"}' \
    --output-serialization '{"CSV": {}}' "output.csv"

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakansync.

AWS CLI

Contoh 1: Sinkronkan semua objek lokal ke bucket yang ditentukan

Per sync intah berikut menyinkronkan objek dari direktori lokal ke awalan dan bucket yang ditentukan dengan mengunggah file lokal ke S3. File lokal akan memerlukan pengunggahan jika ukuran file lokal berbeda dari ukuran objek S3, waktu modifikasi terakhir dari file lokal lebih baru dari waktu modifikasi terakhir dari objek S3, atau file lokal tidak ada di bawah bucket dan awalan yang ditentukan. Dalam contoh ini, pengguna menyinkronkan bucket amzn-s3-demo-bucket ke direktori lokal saat ini. Direktori lokal saat ini berisi file test.txt dantest2.txt. Ember tidak amzn-s3-demo-bucket mengandung benda.

aws s3 sync . s3://amzn-s3-demo-bucket

Output:

upload: test.txt to s3://amzn-s3-demo-bucket/test.txt
upload: test2.txt to s3://amzn-s3-demo-bucket/test2.txt

Contoh 2: Sinkronkan semua objek S3 dari bucket S3 yang ditentukan ke bucket lain

Per sync intah berikut menyinkronkan objek di bawah awalan dan bucket tertentu ke objek di bawah awalan dan bucket tertentu lainnya dengan menyalin objek S3. Objek S3 akan memerlukan penyalinan jika ukuran dua objek S3 berbeda, waktu modifikasi terakhir sumber lebih baru dari waktu modifikasi terakhir tujuan, atau objek S3 tidak ada di bawah bucket dan tujuan awalan yang ditentukan.

Dalam contoh ini, pengguna menyinkronkan bucket amzn-s3-demo-bucket ke bucketamzn-s3-demo-bucket2. Ember amzn-s3-demo-bucket berisi benda-benda test.txt dantest2.txt. Ember tidak amzn-s3-demo-bucket2 mengandung objek:

aws s3 sync s3://amzn-s3-demo-bucket s3://amzn-s3-demo-bucket2

Output:

copy: s3://amzn-s3-demo-bucket/test.txt to s3://amzn-s3-demo-bucket2/test.txt
copy: s3://amzn-s3-demo-bucket/test2.txt to s3://amzn-s3-demo-bucket2/test2.txt

Contoh 3: Sinkronkan semua objek S3 dari bucket S3 yang ditentukan ke direktori lokal

Per sync intah berikut menyinkronkan file dari bucket S3 yang ditentukan ke direktori lokal dengan mengunduh objek S3. Objek S3 akan memerlukan pengunduhan jika ukuran objek S3 berbeda dari ukuran file lokal, waktu modifikasi terakhir dari objek S3 lebih baru dari waktu modifikasi terakhir dari file lokal, atau objek S3 tidak ada di direktori lokal. Perhatikan bahwa ketika objek diunduh dari S3, waktu modifikasi terakhir dari file lokal diubah menjadi waktu modifikasi terakhir dari objek S3. Dalam contoh ini, pengguna menyinkronkan bucket amzn-s3-demo-bucket ke direktori lokal saat ini. Ember amzn-s3-demo-bucket berisi benda-benda test.txt dantest2.txt. Direktori lokal saat ini tidak memiliki file:

aws s3 sync s3://amzn-s3-demo-bucket .

Output:

download: s3://amzn-s3-demo-bucket/test.txt to test.txt
download: s3://amzn-s3-demo-bucket/test2.txt to test2.txt

Contoh 4: Sinkronkan semua objek lokal ke bucket yang ditentukan dan menghapus semua file yang tidak cocok

Per sync intah berikut menyinkronkan objek di bawah awalan dan bucket tertentu ke file di direktori lokal dengan mengunggah file lokal ke S3. Karena --delete parameter, file apa pun yang ada di bawah awalan dan bucket yang ditentukan tetapi tidak ada di direktori lokal akan dihapus. Dalam contoh ini, pengguna menyinkronkan bucket amzn-s3-demo-bucket ke direktori lokal saat ini. Direktori lokal saat ini berisi file test.txt dantest2.txt. Ember amzn-s3-demo-bucket berisi objektest3.txt:

aws s3 sync . s3://amzn-s3-demo-bucket \
    --delete

Output:

upload: test.txt to s3://amzn-s3-demo-bucket/test.txt
upload: test2.txt to s3://amzn-s3-demo-bucket/test2.txt
delete: s3://amzn-s3-demo-bucket/test3.txt

Contoh 5: Sinkronkan semua objek lokal ke bucket yang ditentukan kecuali file ``.jpg``

Per sync intah berikut menyinkronkan objek di bawah awalan dan bucket tertentu ke file di direktori lokal dengan mengunggah file lokal ke S3. Karena --exclude parameter, semua file yang cocok dengan pola yang ada di S3 dan lokal akan dikecualikan dari sinkronisasi. Dalam contoh ini, pengguna menyinkronkan bucket amzn-s3-demo-bucket ke direktori lokal saat ini. Direktori lokal saat ini berisi file test.jpg dantest2.txt. Ember amzn-s3-demo-bucket berisi objek test.jpg dengan ukuran yang berbeda dari lokaltest.jpg:

aws s3 sync . s3://amzn-s3-demo-bucket \
    --exclude "*.jpg"

Output:

upload: test2.txt to s3://amzn-s3-demo-bucket/test2.txt

Contoh 6: Sinkronkan semua objek lokal ke bucket yang ditentukan kecuali file direktori yang ditentukan

Per sync intah berikut menyinkronkan file di bawah direktori lokal ke objek di bawah awalan dan bucket tertentu dengan mengunduh objek S3. Contoh ini menggunakan flag --exclude parameter untuk mengecualikan direktori tertentu dan awalan S3 dari sync perintah. Dalam contoh ini, pengguna menyinkronkan direktori lokal saat ini ke bucketamzn-s3-demo-bucket. Direktori lokal saat ini berisi file test.txt dananother/test2.txt. Ember amzn-s3-demo-bucket berisi benda-benda another/test5.txt dantest1.txt:

aws s3 sync s3://amzn-s3-demo-bucket/ . \
    --exclude "*another/*"

Output:

download: s3://amzn-s3-demo-bucket/test1.txt to test1.txt

Contoh 7: Sinkronkan semua objek antar bucket di berbagai wilayah

Per sync intah berikut menyinkronkan file antara dua bucket di wilayah yang berbeda:

aws s3 sync s3://my-us-west-2-bucket s3://my-us-east-1-bucket \
    --source-region us-west-2 \
    --region us-east-1

Output:

download: s3://my-us-west-2-bucket/test1.txt to s3://my-us-east-1-bucket/test1.txt

Contoh 8: Sinkronisasi ke titik akses S3

Per sync intah berikut menyinkronkan direktori saat ini ke titik akses (myaccesspoint):

aws s3 sync . s3://arn:aws:s3:us-west-2:123456789012:accesspoint/myaccesspoint/

Output:

upload: test.txt to s3://arn:aws:s3:us-west-2:123456789012:accesspoint/myaccesspoint/test.txt
upload: test2.txt to s3://arn:aws:s3:us-west-2:123456789012:accesspoint/myaccesspoint/test2.txt

  • Untuk detail API, lihat Sin kronisasi di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanupload-part-copy.

AWS CLI

Untuk mengunggah bagian dari objek dengan menyalin data dari objek yang ada sebagai sumber data

upload-part-copyContoh berikut mengunggah bagian dengan menyalin data dari objek yang ada sebagai sumber data.

aws s3api upload-part-copy \
    --bucket amzn-s3-demo-bucket \
    --key "Map_Data_June.mp4" \
    --copy-source "amzn-s3-demo-bucket/copy_of_Map_Data_June.mp4" \
    --part-number 1 \
    --upload-id "bq0tdE1CDpWQYRPLHuNG50xAT6pA5D.m_RiBy0ggOH6b13pVRY7QjvLlf75iFdJqp_2wztk5hvpUM2SesXgrzbehG5hViyktrfANpAD0NO.Nk3XREBqvGeZF6U3ipiSm"

Output:

{
    "CopyPartResult": {
        "LastModified": "2019-12-13T23:16:03.000Z",
        "ETag": "\"711470fc377698c393d94aed6305e245\""
    }
}

Contoh kode berikut menunjukkan cara menggunakanupload-part.

AWS CLI

Perintah berikut mengunggah bagian pertama dalam unggahan multipart yang dimulai dengan perintah: create-multipart-upload

aws s3api upload-part --bucket amzn-s3-demo-bucket --key 'multipart/01' --part-number 1 --body part01 --upload-id  "dfRtDYU0WWCCcH43C3WFbkRONycyCpTJJvxu2i5GYkZljF.Yxwh6XG7WfS2vC4to6HiV6Yjlx.cph0gtNBtJ8P3URCSbB7rjxI5iEwVDmgaXZOGgkk5nVTW16HOQ5l0R"

bodyOpsi mengambil nama atau jalur file lokal untuk diunggah (jangan gunakan file://awalan). Ukuran bagian minimum adalah 5 MB. ID Unggah dikembalikan oleh create-multipart-upload dan juga dapat diambil denganlist-multipart-uploads. Bucket dan key ditentukan saat Anda membuat upload multipart.

Output:

{
    "ETag": "\"e868e0f4719e394144ef36531ee6824c\""
}

Simpan nilai ETag dari setiap bagian untuk nanti. Mereka diminta untuk menyelesaikan unggahan multipart.

  • Untuk detail API, lihat UploadPart di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanwebsite.

AWS CLI

Konfigurasikan bucket S3 sebagai situs web statis

Perintah berikut mengonfigurasi bucket bernama amzn-s3-demo-bucket sebagai situs web statis. Opsi dokumen indeks menentukan file di amzn-s3-demo-bucket mana pengunjung akan diarahkan ketika mereka menavigasi ke URL situs web. Dalam hal ini, bucket berada di wilayah us-west-2, sehingga situs akan muncul di. http://amzn-s3-demo-bucket.s3-website-us-west-2.amazonaws.com

Semua file dalam bucket yang muncul di situs statis harus dikonfigurasi untuk memungkinkan pengunjung membukanya. Izin file dikonfigurasi secara terpisah dari konfigurasi situs web bucket.

aws s3 website s3://amzn-s3-demo-bucket/ \
    --index-document index.html \
    --error-document error.html

Untuk informasi tentang hosting situs web statis di Amazon S3, lihat Hosting Situs Web Statis di Panduan Pengembang Layanan Penyimpanan Sederhana Amazon.

  • Untuk detail API, lihat Situs Web di Refer AWS CLI ensi Perintah.