Contoh Amazon S3 menggunakan AWS CLI

Untuk membatalkan unggahan multipart yang ditentukan

abort-multipart-uploadPerintah berikut membatalkan unggahan multibagian untuk kunci multipart/01 di bucket. my-bucket

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

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

Perintah berikut menyelesaikan unggahan multipart untuk kunci multipart/01 di bucket: my-bucket

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

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

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

mpustruct:

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

ETagNilai untuk setiap bagian adalah upload adalah output setiap kali Anda mengunggah bagian menggunakan upload-part perintah dan juga dapat diambil dengan memanggil list-parts atau dihitung dengan mengambil MD5 checksum dari setiap bagian.

Output:

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

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"
}

Contoh 1: Menyalin file lokal ke S3

cpPerintah berikut menyalin satu file ke bucket dan kunci tertentu:

aws s3 cp test.txt s3://mybucket/test2.txt

Output:

upload: test.txt to s3://mybucket/test2.txt

Contoh 2: Menyalin file lokal ke S3 dengan tanggal kedaluwarsa

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

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

Output:

upload: test.txt to s3://mybucket/test2.txt

Contoh 3: Menyalin file dari S3 ke S3

cpPerintah berikut menyalin objek s3 tunggal ke bucket dan kunci tertentu:

aws s3 cp s3://mybucket/test.txt s3://mybucket/test2.txt

Output:

copy: s3://mybucket/test.txt to s3://mybucket/test2.txt

Contoh 4: Menyalin objek S3 ke file lokal

cpPerintah berikut menyalin satu objek ke file tertentu secara lokal:

aws s3 cp s3://mybucket/test.txt test2.txt

Output:

download: s3://mybucket/test.txt to test2.txt

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

cpPerintah berikut menyalin satu objek ke bucket tertentu sambil mempertahankan nama aslinya:

aws s3 cp s3://mybucket/test.txt s3://mybucket2/

Output:

copy: s3://mybucket/test.txt to s3://mybucket2/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 ember yang ditentukan ke direktori tertentu. Dalam contoh ini, ember mybucket memiliki objek test1.txt dantest2.txt:

aws s3 cp s3://mybucket . \
    --recursive

Output:

download: s3://mybucket/test1.txt to test1.txt
download: s3://mybucket/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 sementara mengecualikan beberapa file dengan menggunakan parameter. --exclude Dalam contoh ini, direktori myDir memiliki file test1.txt dantest2.jpg:

aws s3 cp myDir s3://mybucket/ \
    --recursive \
    --exclude "*.jpg"

Output:

upload: myDir/test1.txt to s3://mybucket/test1.txt

Contoh 8: Menyalin objek S3 secara rekursif ke ember 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 parameter. --exclude Dalam contoh ini, ember mybucket memiliki objek test1.txt dananother/test1.txt:

aws s3 cp s3://mybucket/ s3://mybucket2/ \
    --recursive \
    --exclude "another/*"

Output:

copy: s3://mybucket/test1.txt to s3://mybucket2/test1.txt

Anda dapat menggabungkan --exclude dan --include opsi untuk menyalin hanya objek yang cocok dengan pola, tidak termasuk semua yang lain:

aws s3 cp s3://mybucket/logs/ s3://mybucket2/logs/ \
    --recursive \
    --exclude "*" \
    --include "*.log"

Output:

copy: s3://mybucket/logs/test/test.log to s3://mybucket2/logs/test/test.log
copy: s3://mybucket/logs/test3.log to s3://mybucket2/logs/test3.log

Contoh 9: Mengatur Access Control List (ACL) saat menyalin objek S3

cpPerintah berikut menyalin satu objek ke bucket dan kunci tertentu saat menyetel ACL kepublic-read-write:

aws s3 cp s3://mybucket/test.txt s3://mybucket/test2.txt \
    --acl public-read-write

Output:

copy: s3://mybucket/test.txt to s3://mybucket/test2.txt

Perhatikan bahwa jika Anda menggunakan --acl opsi, pastikan bahwa setiap IAM kebijakan 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:::mybucket/*"
                ],
                "Effect": "Allow",
                "Sid": "Stmt1234567891234"
            }
        ]
    }
}

Contoh 10: Memberikan izin untuk objek S3

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

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

Output:

upload: file.txt to s3://mybucket/file.txt

Contoh 11: Mengunggah aliran file lokal ke S3

PowerShell dapat mengubah pengkodean atau menambahkan input CRLF ke pipa.

cpPerintah berikut mengunggah aliran file lokal dari input standar ke bucket dan kunci tertentu:

aws s3 cp - s3://mybucket/stream.txt

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

cpPerintah 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://mybucket/stream.txt --expected-size 54760833024

Contoh 13: Mengunduh objek S3 sebagai aliran file lokal

PowerShell dapat mengubah pengkodean atau menambahkan output CRLF ke pipa atau dialihkan.

cpPerintah 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://mybucket/stream.txt -

Contoh 14: Mengunggah ke titik akses S3

cpPerintah berikut mengunggah satu file (mydoc.txt) ke titik akses (myaccesspoint) di key (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

cpPerintah 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

Contoh 1: Untuk membuat ember

create-bucketContoh berikut membuat bucket bernamamy-bucket:

aws s3api create-bucket \
    --bucket my-bucket \
    --region us-east-1

Output:

{
    "Location": "/my-bucket"
}

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

Contoh 2: Untuk membuat ember dengan pemilik diberlakukan

create-bucketContoh berikut membuat bucket bernama yang menggunakan setelan my-bucket yang diterapkan pemilik bucket untuk Kepemilikan Objek S3.

aws s3api create-bucket \
    --bucket my-bucket \
    --region us-east-1 \
    --object-ownership BucketOwnerEnforced

Output:

{
    "Location": "/my-bucket"
}

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

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

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

aws s3api create-bucket \
    --bucket my-bucket \
    --region eu-west-1 \
    --create-bucket-configuration LocationConstraint=eu-west-1

Output:

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

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

Perintah berikut membuat unggahan multipart di bucket my-bucket dengan kuncimultipart/01:

aws s3api create-multipart-upload --bucket my-bucket --key 'multipart/01'

Output:

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

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

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 my-bucket \
    --id 1

Perintah ini tidak menghasilkan output.

Perintah berikut menghapus konfigurasi Cross-Origin Resource Sharing dari bucket bernama: my-bucket

aws s3api delete-bucket-cors --bucket my-bucket

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 my-bucket

Perintah ini tidak menghasilkan output.

Untuk menghapus konfigurasi S3 Intelligent-Tiering pada bucket

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

aws s3api delete-bucket-intelligent-tiering-configuration \
    --bucket DOC-EXAMPLE-BUCKET \
    --id ExampleConfig

Perintah ini tidak menghasilkan output.

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

Untuk menghapus konfigurasi inventaris bucket

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

aws s3api delete-bucket-inventory-configuration \
    --bucket my-bucket \
    --id 1

Perintah ini tidak menghasilkan output.

Perintah berikut menghapus konfigurasi siklus hidup dari bucket bernama: my-bucket

aws s3api delete-bucket-lifecycle --bucket my-bucket

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 my-bucket \
    --id 123

Perintah ini tidak menghasilkan output.

Untuk menghapus pengaturan kepemilikan bucket dari bucket

delete-bucket-ownership-controlsContoh berikut menghapus setelan kepemilikan bucket pada bucket.

aws s3api delete-bucket-ownership-controls \
    --bucket DOC-EXAMPLE-BUCKET

Perintah ini tidak menghasilkan output.

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

Perintah berikut menghapus kebijakan bucket dari bucket bernamamy-bucket:

aws s3api delete-bucket-policy --bucket my-bucket

Perintah berikut menghapus konfigurasi replikasi dari bucket bernama: my-bucket

aws s3api delete-bucket-replication --bucket my-bucket

Perintah berikut menghapus konfigurasi penandaan dari bucket bernama: my-bucket

aws s3api delete-bucket-tagging --bucket my-bucket

Perintah berikut menghapus konfigurasi situs web dari bucket bernamamy-bucket:

aws s3api delete-bucket-website --bucket my-bucket

Perintah berikut menghapus bucket bernamamy-bucket:

aws s3api delete-bucket --bucket my-bucket --region us-east-1

Untuk menghapus set tag dari suatu objek

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

aws s3api delete-object-tagging \
    --bucket my-bucket \
    --key doc1.rtf

Perintah ini tidak menghasilkan output.

Perintah berikut menghapus objek bernama test.txt dari bucket bernamamy-bucket:

aws s3api delete-object --bucket my-bucket --key test.txt

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

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

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

Perintah berikut menghapus objek dari bucket bernamamy-bucket:

aws s3api delete-objects --bucket my-bucket --delete file://delete.json

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

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

Output:

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

Untuk menghapus konfigurasi blokir akses publik untuk bucket

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

aws s3api delete-public-access-block \
    --bucket my-bucket

Perintah ini tidak menghasilkan output.

Untuk mengambil konfigurasi percepatan bucket

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

aws s3api get-bucket-accelerate-configuration \
    --bucket my-bucket

Output:

{
    "Status": "Enabled"
}

Perintah berikut mengambil daftar kontrol akses untuk bucket bernamamy-bucket:

aws s3api get-bucket-acl --bucket my-bucket

Output:

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

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 my-bucket \
    --id 1

Output:

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

Perintah berikut mengambil konfigurasi Cross-Origin Resource Sharing untuk bucket bernama: my-bucket

aws s3api get-bucket-cors --bucket my-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": [
                "*"
            ]
        }
    ]
}

Untuk mengambil konfigurasi enkripsi sisi server untuk bucket

get-bucket-encryptionContoh berikut mengambil konfigurasi enkripsi sisi server untuk bucket. my-bucket

aws s3api get-bucket-encryption \
    --bucket my-bucket

Output:

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

Untuk mengambil konfigurasi S3 Intelligent-Tiering pada bucket

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

aws s3api get-bucket-intelligent-tiering-configuration \
    --bucket DOC-EXAMPLE-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.

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 my-bucket \
    --id 1

Output:

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

Perintah berikut mengambil konfigurasi siklus hidup untuk bucket bernama: my-bucket

aws s3api get-bucket-lifecycle-configuration --bucket my-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"
        }
    ]
}

Perintah berikut mengambil konfigurasi siklus hidup untuk bucket bernama: my-bucket

aws s3api get-bucket-lifecycle --bucket my-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"
    }
  ]
}

Perintah berikut mengambil batasan lokasi untuk bucket bernamamy-bucket, jika ada kendala:

aws s3api get-bucket-location --bucket my-bucket

Output:

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

Untuk mengambil status logging untuk bucket

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

aws s3api get-bucket-logging \
    --bucket my-bucket

Output:

{
    "LoggingEnabled": {
        "TargetPrefix": "",
        "TargetBucket": "my-bucket-logs"
          }
}

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 my-bucket \
    --id 123

Output:

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

Perintah berikut mengambil konfigurasi notifikasi untuk bucket bernamamy-bucket:

aws s3api get-bucket-notification-configuration --bucket my-bucket

Output:

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

Perintah berikut mengambil konfigurasi notifikasi untuk bucket bernamamy-bucket:

aws s3api get-bucket-notification --bucket my-bucket

Output:

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

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 DOC-EXAMPLE-BUCKET

Output:

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

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

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

get-bucket-policy-statusContoh berikut mengambil status kebijakan untuk bucketmy-bucket.

aws s3api get-bucket-policy-status \
    --bucket my-bucket

Output:

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

Perintah berikut mengambil kebijakan bucket untuk bucket bernamamy-bucket:

aws s3api get-bucket-policy --bucket my-bucket

Output:

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

Contoh policyThe berikut menunjukkan cara 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 mybucket --query Policy --output text > policy.json

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

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

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

aws s3api put-bucket-policy --bucket mybucket --policy file://policy.json

Perintah berikut mengambil konfigurasi replikasi untuk bucket bernama: my-bucket

aws s3api get-bucket-replication --bucket my-bucket

Output:

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

Untuk mengambil konfigurasi pembayaran permintaan untuk bucket

get-bucket-request-paymentContoh berikut mengambil konfigurasi requester pay untuk bucket yang ditentukan.

aws s3api get-bucket-request-payment \
    --bucket my-bucket

Output:

{
    "Payer": "BucketOwner"
}

Perintah berikut mengambil konfigurasi penandaan untuk bucket bernama: my-bucket

aws s3api get-bucket-tagging --bucket my-bucket

Output:

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

Perintah berikut mengambil konfigurasi pembuatan versi untuk bucket bernama: my-bucket

aws s3api get-bucket-versioning --bucket my-bucket

Output:

{
    "Status": "Enabled"
}

Perintah berikut mengambil konfigurasi situs web statis untuk bucket bernamamy-bucket:

aws s3api get-bucket-website --bucket my-bucket

Output:

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

Perintah berikut mengambil daftar kontrol akses untuk objek dalam bucket bernamamy-bucket:

aws s3api get-object-acl --bucket my-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 mengambil metadata dari objek tanpa mengembalikan objek itu sendiri

get-object-attributesContoh berikut mengambil metadata dari objek. doc1.rtf

aws s3api get-object-attributes \
    --bucket my-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 GetObjectAttributesdi Referensi Amazon S3API.

Mengambil status Legal Hold dari suatu objek

get-object-legal-holdContoh berikut mengambil status Penahanan Hukum untuk objek yang ditentukan.

aws s3api get-object-legal-hold \
    --bucket my-bucket-with-object-lock \
    --key doc1.rtf

Output:

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

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 my-bucket-with-object-lock

Output:

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

Untuk mengambil konfigurasi retensi objek untuk objek

get-object-retentionContoh berikut mengambil konfigurasi retensi objek untuk objek tertentu.

aws s3api get-object-retention \
    --bucket my-bucket-with-object-lock \
    --key doc1.rtf

Output:

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

Untuk mengambil tag yang dilampirkan ke objek

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

aws s3api get-object-tagging \
    --bucket my-bucket \
    --key doc1.rtf

Output:

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

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

aws s3api get-object-tagging \
    --bucket my-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 my-bucket \
    --key doc3.rtf

Output:

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

Perintah berikut membuat torrent untuk objek dalam bucket bernamamy-bucket:

aws s3api get-object-torrent --bucket my-bucket --key large-video-file.mp4 large-video-file.torrent

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

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 men-download rentang byte tertentu dari sebuah objek. Perhatikan rentang byte perlu diawali dengan “byte =”:

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 menyetel atau memodifikasi konfigurasi blokir akses publik untuk bucket

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

aws s3api get-public-access-block \
    --bucket my-bucket

Output:

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

Perintah berikut memverifikasi akses ke bucket bernamamy-bucket:

aws s3api head-bucket --bucket my-bucket

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

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

Perintah berikut mengambil metadata untuk objek dalam bucket bernama: my-bucket

aws s3api head-object --bucket my-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 mengambil daftar konfigurasi analitik untuk bucket

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

aws s3api list-bucket-analytics-configurations \
    --bucket my-bucket

Output:

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

Untuk mengambil semua konfigurasi S3 Intelligent-Tiering pada bucket

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

aws s3api list-bucket-intelligent-tiering-configurations \
    --bucket DOC-EXAMPLE-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.

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 my-bucket

Output:

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

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 my-bucket

Output:

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

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 menyaring output dari list-buckets down ke hanya nama bucket.

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

Perintah berikut mencantumkan semua unggahan multipart aktif untuk bucket bernama: my-bucket

aws s3api list-multipart-uploads --bucket my-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": []
}

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

Perintah berikut mengambil informasi versi untuk objek dalam bucket bernamamy-bucket:

aws s3api list-object-versions --bucket my-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
        }
    ]
}

Untuk mendapatkan daftar objek dalam ember

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

aws s3api list-objects-v2 \
    --bucket my-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 berikut menggunakan list-objects perintah untuk menampilkan nama-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 list-objects turun ke nilai kunci dan ukuran untuk setiap objek

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

Perintah berikut mencantumkan semua bagian yang telah diunggah untuk unggahan multibagian dengan kunci multipart/01 di bucket: my-bucket

aws s3api list-parts --bucket my-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"
}

Contoh 1: Daftar semua bucket milik pengguna

lsPerintah berikut mencantumkan semua bucket yang dimiliki oleh pengguna. Dalam contoh ini, pengguna memiliki ember mybucket dan. mybucket2 Stempel waktu adalah tanggal ember dibuat, ditunjukkan di zona waktu mesin Anda. Tanggal ini dapat berubah saat membuat perubahan pada bucket Anda, seperti mengedit kebijakan bucket. Perhatikan jika s3:// digunakan untuk argumen jalur<S3Uri>, itu akan mencantumkan semua bucket juga.

aws s3 ls

Output:

2013-07-11 17:08:50 mybucket
2013-07-24 14:55:44 mybucket2

Contoh 2: Daftar semua awalan dan objek dalam ember

lsPerintah berikut mencantumkan objek dan awalan umum di bawah bucket dan awalan yang ditentukan. Dalam contoh ini, pengguna memiliki ember mybucket dengan objek test.txt dansomePrefix/test.txt. Itu LastWriteTime dan Length sewenang-wenang. Perhatikan bahwa karena ls perintah tidak memiliki interaksi dengan sistem file lokal, s3:// URI skema tidak diperlukan untuk menyelesaikan ambiguitas dan dapat dihilangkan.

aws s3 ls s3://mybucket

Output:

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

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

lsPerintah berikut mencantumkan objek dan awalan umum di bawah bucket dan awalan yang ditentukan. Namun, tidak ada objek atau awalan umum di bawah ember dan awalan yang ditentukan.

aws s3 ls s3://mybucket/noExistPrefix

Output:

None

Contoh 4: Secara rekursif mencantumkan semua awalan dan objek dalam ember

lsPerintah berikut akan secara rekursif mencantumkan objek dalam ember. Alih-alih ditampilkan PRE dirname/ di output, semua konten dalam ember akan terdaftar secara berurutan.

aws s3 ls s3://mybucket \
    --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

lsPerintah berikut menunjukkan perintah yang sama menggunakan opsi --human-readable dan --summarize. --human-readable menampilkan ukuran file di. Bytes/MiB/KiB/GiB/TiB/PiB/EiB --summarize menampilkan jumlah total objek dan ukuran total di akhir daftar hasil:

aws s3 ls s3://mybucket \
    --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: Daftar dari titik akses S3

Berikut daftar ls perintah 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

Contoh 1: Buat ember

mbPerintah berikut membuat ember. Dalam contoh ini, pengguna membuat embermybucket. Bucket dibuat di wilayah yang ditentukan dalam file konfigurasi pengguna:

aws s3 mb s3://mybucket

Output:

make_bucket: s3://mybucket

Contoh 2: Buat ember di wilayah yang ditentukan

mbPerintah berikut membuat bucket di wilayah yang ditentukan oleh --region parameter. Dalam contoh ini, pengguna membuat bucket mybucket di wilayah tersebutus-west-1:

aws s3 mb s3://mybucket \
    --region us-west-1

Output:

make_bucket: s3://mybucket

Contoh 1: Pindahkan file lokal ke bucket yang ditentukan

mvPerintah berikut memindahkan satu file ke bucket dan kunci tertentu.

aws s3 mv test.txt s3://mybucket/test2.txt

Output:

move: test.txt to s3://mybucket/test2.txt

Contoh 2: Pindahkan objek ke bucket dan kunci yang ditentukan

mvPerintah berikut memindahkan objek s3 tunggal ke bucket dan kunci tertentu.

aws s3 mv s3://mybucket/test.txt s3://mybucket/test2.txt

Output:

move: s3://mybucket/test.txt to s3://mybucket/test2.txt

Contoh 3: Pindahkan objek S3 ke direktori lokal

mvPerintah berikut memindahkan satu objek ke file tertentu secara lokal.

aws s3 mv s3://mybucket/test.txt test2.txt

Output:

move: s3://mybucket/test.txt to test2.txt

Contoh 4: Pindahkan objek dengan nama aslinya ke ember yang ditentukan

mvPerintah berikut memindahkan satu objek ke bucket tertentu sambil mempertahankan nama aslinya:

aws s3 mv s3://mybucket/test.txt s3://mybucket2/

Output:

move: s3://mybucket/test.txt to s3://mybucket2/test.txt

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

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

aws s3 mv s3://mybucket . \
    --recursive

Output:

move: s3://mybucket/test1.txt to test1.txt
move: s3://mybucket/test2.txt to test2.txt

Contoh 6: Pindahkan semua objek dan awalan dalam ember 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 sementara mengecualikan beberapa file dengan menggunakan parameter. --exclude Dalam contoh ini, direktori myDir memiliki file test1.txt dantest2.jpg.

aws s3 mv myDir s3://mybucket/ \
    --recursive \
    --exclude "*.jpg"

Output:

move: myDir/test1.txt to s3://mybucket2/test1.txt

Contoh 7: Pindahkan semua objek dan awalan dalam ember 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 parameter. --exclude Dalam contoh ini, ember mybucket memiliki objek test1.txt dananother/test1.txt.

aws s3 mv s3://mybucket/ s3://mybucket2/ \
    --recursive \
    --exclude "mybucket/another/*"

Output:

move: s3://mybucket/test1.txt to s3://mybucket2/test1.txt

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

mvPerintah berikut memindahkan satu objek ke bucket dan kunci tertentu saat menyetel ACL kepublic-read-write.

aws s3 mv s3://mybucket/test.txt s3://mybucket/test2.txt \
    --acl public-read-write

Output:

move: s3://mybucket/test.txt to s3://mybucket/test2.txt

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

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

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

Output:

move: file.txt to s3://mybucket/file.txt

Contoh 10: Pindahkan file ke titik akses S3

mvPerintah berikut memindahkan satu file bernama mydoc.txt ke titik akses bernama myaccesspoint 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

Contoh 1: Untuk membuat pra-tanda tangan URL dengan masa pakai default satu jam yang menautkan ke objek dalam bucket S3

presignPerintah berikut menghasilkan pra-tanda tangan URL untuk bucket dan kunci tertentu yang valid selama satu jam.

aws s3 presign s3://DOC-EXAMPLE-BUCKET/test2.txt

Output:

https://DOC-EXAMPLE-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=EXAMBLE1234494d5fba3fed607f98018e1dfc62e2529ae96d844123456

Contoh 2: Untuk membuat pra-ditandatangani URL dengan masa pakai kustom yang menautkan ke objek dalam bucket S3

presignPerintah berikut menghasilkan pra-tanda tangan URL untuk bucket dan kunci tertentu yang berlaku selama satu minggu.

aws s3 presign s3://DOC-EXAMPLE-BUCKET/test2.txt \
    --expires-in 604800

Output:

https://DOC-EXAMPLE-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=EXAMBLE1234494d5fba3fed607f98018e1dfc62e2529ae96d844123456

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

Untuk mengatur konfigurasi percepatan ember

put-bucket-accelerate-configurationContoh berikut memungkinkan konfigurasi percepatan untuk bucket yang ditentukan.

aws s3api put-bucket-accelerate-configuration \
    --bucket my-bucket \
    --accelerate-configuration Status=Enabled

Perintah ini tidak menghasilkan output.

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 MyBucket --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 kustom ACLs (ACLperintah s3api, sepertiput-bucket-acl, gunakan notasi argumen singkatan yang sama).

Untuk menetapkan konfigurasi analitik untuk bucket

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

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

Perintah ini tidak menghasilkan output.

Contoh berikut memungkinkanPUT,POST, dan DELETE permintaan dari www.example.com, dan memungkinkan GET permintaan dari domain apa pun:

aws s3api put-bucket-cors --bucket MyBucket --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
    }
  ]
}

Untuk mengonfigurasi enkripsi sisi server untuk bucket

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

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

Perintah ini tidak menghasilkan output.

Untuk memperbarui konfigurasi S3 Intelligent-Tiering pada bucket

put-bucket-intelligent-tiering-configurationContoh berikut memperbarui konfigurasi S3 Intelligent-Tiering, bernama ExampleConfig, pada bucket. Konfigurasi akan mengalihkan 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 DOC-EXAMPLE-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 Menyetel Kepemilikan Objek pada bucket yang ada di Panduan Pengguna Amazon S3.

Contoh 1: Untuk mengatur konfigurasi inventaris untuk bucket

put-bucket-inventory-configurationContoh berikut menetapkan laporan inventaris ORC berformat mingguan untuk bucket. my-bucket

aws s3api put-bucket-inventory-configuration \
    --bucket my-bucket \
    --id 1 \
    --inventory-configuration '{"Destination": { "S3BucketDestination": { "AccountId": "123456789012", "Bucket": "arn:aws:s3:::my-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 inventaris CSV berformat harian untuk bucket. my-bucket

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

Perintah ini tidak menghasilkan output.

Perintah berikut menerapkan konfigurasi siklus hidup ke bucket bernama: my-bucket

aws s3api put-bucket-lifecycle-configuration --bucket my-bucket --lifecycle-configuration  file://lifecycle.json

File lifecycle.json adalah JSON dokumen dalam 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 dalam Panduan Pengguna.AWS CLI

Perintah berikut menerapkan konfigurasi siklus hidup ke bucket: my-bucket

aws s3api put-bucket-lifecycle --bucket my-bucket --lifecycle-configuration file://lifecycle.json

File lifecycle.json adalah JSON dokumen dalam 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 dalam Panduan Pengguna.AWS CLI

Setiap aturan dalam contoh di atas menentukan kebijakan (TransitionatauExpiration) dan awalan file (nama folder) yang berlaku. 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 1: Untuk mengatur pencatatan kebijakan bucket

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

aws s3api put-bucket-policy \
    --bucket MyBucket \
    --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:::MyBucket/Logs/*",
            "Condition": {
                "ArnLike": {"aws:SourceARN": "arn:aws:s3:::SOURCE-BUCKET-NAME"},
                "StringEquals": {"aws:SourceAccount": "SOURCE-AWS-ACCOUNT-ID"}
            }
        }
    ]
}

Untuk menerapkan kebijakan pencatatan, gunakanput-bucket-logging.

aws s3api put-bucket-logging \
    --bucket MyBucket \
    --bucket-logging-status file://logging.json

Isi dari logging.json:

{
     "LoggingEnabled": {
         "TargetBucket": "MyBucket",
         "TargetPrefix": "Logs/"
     }
 }

put-bucket-policyPerintah 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 menetapkan kebijakan bucket untuk akses log hanya ke satu pengguna

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

aws s3api put-bucket-acl \
    --bucket MyBucket \
    --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 MyBucket \
    --bucket-logging-status file://logging.json

Isi dari logging.json:

{
    "LoggingEnabled": {
        "TargetBucket": "MyBucket",
        "TargetPrefix": "MyBucketLogs/",
        "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-acp).

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

Untuk menyetel 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 my-bucket \
    --id 123 \
    --metrics-configuration '{"Id": "123", "Filter": {"Prefix": "logs"}}'

Perintah ini tidak menghasilkan output.

Untuk mengaktifkan notifikasi yang ditentukan ke bucket

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

aws s3api put-bucket-notification-configuration \
    --bucket my-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:*"
            ]
        }
    ]
}

SNSTopik harus memiliki IAM kebijakan yang dilampirkan padanya yang memungkinkan Amazon S3 untuk mempublikasikannya.

{
    "Version": "2008-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:*:*:my-bucket"
                }
            }
        }
    ]
}

Menerapkan konfigurasi notifikasi ke bucket bernamamy-bucket:

aws s3api put-bucket-notification --bucket my-bucket --notification-configuration file://notification.json

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

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

SNSTopik harus memiliki IAM kebijakan yang dilampirkan padanya yang memungkinkan Amazon S3 untuk mempublikasikannya:

{
 "Version": "2008-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:my-bucket",
   "Condition": {
      "ArnLike": {
      "aws:SourceArn": "arn:aws:s3:*:*:my-bucket"
    }
   }
  }
 ]
}

Untuk memperbarui setelan kepemilikan bucket pada bucket

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

aws s3api put-bucket-ownership-controls \
    --bucket DOC-EXAMPLE-BUCKET \
    --ownership-controls="Rules=[{ObjectOwnership=BucketOwnerEnforced}]"

Perintah ini tidak menghasilkan output.

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

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

aws s3api put-bucket-policy --bucket MyBucket --policy file://policy.json

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

Untuk mengonfigurasi replikasi untuk bucket S3

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

aws s3api put-bucket-replication \
    --bucket AWSDOC-EXAMPLE-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:::AWSDOC-EXAMPLE-BUCKET2"
            }
        }
    ]
}

Bucket tujuan harus mengaktifkan 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:::AWSDOC-EXAMPLE-BUCKET1"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetObjectVersion",
                "s3:GetObjectVersionAcl",
                "s3:GetObjectVersionTagging"
            ],
            "Resource": [
                "arn:aws:s3:::AWSDOC-EXAMPLE-BUCKET1/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "s3:ReplicateObject",
                "s3:ReplicateDelete",
                "s3:ReplicateTags"
            ],
            "Resource": "arn:aws:s3:::AWSDOC-EXAMPLE-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 1: Untuk mengaktifkan konfigurasi ``requester pays`` untuk sebuah bucket

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

aws s3api put-bucket-request-payment \
    --bucket my-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 my-bucket \
    --request-payment-configuration '{"Payer":"BucketOwner"}'

Perintah ini tidak menghasilkan output.

Perintah berikut menerapkan konfigurasi penandaan ke bucket bernamamy-bucket:

aws s3api put-bucket-tagging --bucket my-bucket --tagging file://tagging.json

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

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

Atau terapkan konfigurasi penandaan my-bucket langsung dari baris perintah:

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

Perintah berikut memungkinkan pembuatan versi pada bucket bernama: my-bucket

aws s3api put-bucket-versioning --bucket my-bucket --versioning-configuration Status=Enabled

Perintah berikut memungkinkan pembuatan versi, dan menggunakan kode mfa

aws s3api put-bucket-versioning --bucket my-bucket --versioning-configuration Status=Enabled --mfa "SERIAL 123456"

Menerapkan konfigurasi situs web statis ke bucket bernamamy-bucket:

aws s3api put-bucket-website --bucket my-bucket --website-configuration file://website.json

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

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

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 MyBucket --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 kustom ACLs (ACLperintah s3api, sepertiput-object-acl, gunakan notasi argumen singkatan yang sama).

Untuk menerapkan Penahanan Hukum pada suatu objek

put-object-legal-holdContoh berikut menetapkan Penahanan Hukum pada objekdoc1.rtf.

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

Perintah ini tidak menghasilkan output.

Untuk mengatur konfigurasi kunci objek pada ember

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

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

Perintah ini tidak menghasilkan output.

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 my-bucket-with-object-lock \
    --key doc1.rtf \
    --retention '{ "Mode": "GOVERNANCE", "RetainUntilDate": "2025-01-01T00:00:00" }'

Perintah ini tidak menghasilkan output.

Untuk mengatur tag pada objek

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

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

Perintah ini tidak menghasilkan output.

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

aws s3api put-object-tagging \
    --bucket my-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 berikut menggunakan put-object perintah untuk mengunggah objek ke Amazon S3:

aws s3api put-object --bucket text-content --key dir-1/my_images.tar.bz2 --body my_images.tar.bz2

Contoh berikut menunjukkan unggahan file video (File video ditentukan menggunakan sintaks sistem file Windows. ):

aws s3api put-object --bucket text-content --key dir-1/big-video-file.mp4 --body e:\media\videos\f-sharp-3-data-services.mp4

Untuk informasi selengkapnya tentang mengunggah objek, lihat Mengunggah Objek di Panduan Pengembang Amazon S3.

Untuk mengatur konfigurasi blokir akses publik untuk bucket

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

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

Perintah ini tidak menghasilkan output.

Contoh 1: Hapus ember

rbPerintah berikut menghapus ember. Dalam contoh ini, bucket pengguna adalahmybucket. Perhatikan bahwa ember harus kosong untuk menghapus:

aws s3 rb s3://mybucket

Output:

remove_bucket: mybucket

Contoh 2: Paksa menghapus ember

rbPerintah berikut menggunakan --force parameter untuk pertama-tama menghapus semua objek di ember dan kemudian menghapus ember itu sendiri. Dalam contoh ini, bucket pengguna adalah mybucket dan objek di dalamnya mybucket adalah test1.txt dantest2.txt:

aws s3 rb s3://mybucket \
    --force

Output:

delete: s3://mybucket/test1.txt
delete: s3://mybucket/test2.txt
remove_bucket: mybucket

Untuk membuat permintaan pemulihan untuk objek

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

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

Perintah ini tidak menghasilkan output.

Contoh 1: Hapus objek S3

rmPerintah berikut menghapus objek s3 tunggal:

aws s3 rm s3://mybucket/test2.txt

Output:

delete: s3://mybucket/test2.txt

Contoh 2: Hapus semua konten dalam ember

rmPerintah berikut secara rekursif menghapus semua objek di bawah bucket dan awalan tertentu ketika diteruskan dengan parameter. --recursive Dalam contoh ini, ember mybucket berisi objek test1.txt dantest2.txt:

aws s3 rm s3://mybucket \
    --recursive

Output:

delete: s3://mybucket/test1.txt
delete: s3://mybucket/test2.txt

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

rmPerintah berikut secara rekursif menghapus semua objek di bawah bucket dan awalan tertentu ketika diteruskan dengan parameter --recursive sementara mengecualikan beberapa objek dengan menggunakan parameter. --exclude Dalam contoh ini, ember mybucket memiliki objek test1.txt dantest2.jpg:

aws s3 rm s3://mybucket/ \
    --recursive \
    --exclude "*.jpg"

Output:

delete: s3://mybucket/test1.txt

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

rmPerintah berikut secara rekursif menghapus semua objek di bawah bucket dan awalan tertentu ketika diteruskan dengan parameter --recursive sementara mengecualikan semua objek di bawah awalan tertentu dengan menggunakan parameter. --exclude Dalam contoh ini, ember mybucket memiliki objek test1.txt dananother/test.txt:

aws s3 rm s3://mybucket/ \
    --recursive \
    --exclude "another/*"

Output:

delete: s3://mybucket/test1.txt

Contoh 5: Hapus objek dari titik akses S3

rmPerintah berikut menghapus satu objek (mykey) dari titik akses (myaccesspoint). :: rm Perintah 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 memfilter konten objek Amazon S3 berdasarkan pernyataan SQL

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

aws s3api select-object-content \
    --bucket my-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 1: Sinkronkan semua objek lokal ke bucket yang ditentukan

syncPerintah 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 ember dan awalan yang ditentukan. Dalam contoh ini, pengguna menyinkronkan bucket mybucket ke direktori lokal saat ini. Direktori lokal saat ini berisi file test.txt dan filetest2.txt. Ember tidak mybucket berisi benda.

aws s3 sync . s3://mybucket

Output:

upload: test.txt to s3://mybucket/test.txt
upload: test2.txt to s3://mybucket/test2.txt

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

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

Dalam contoh ini, pengguna menyinkronkan bucket mybucket ke bucketmybucket2. Ember mybucket berisi benda-benda test.txt dantest2.txt. Ember tidak mybucket2 berisi benda:

aws s3 sync s3://mybucket s3://mybucket2

Output:

copy: s3://mybucket/test.txt to s3://mybucket2/test.txt
copy: s3://mybucket/test2.txt to s3://mybucket2/test2.txt

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

syncPerintah 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 ke waktu modifikasi terakhir dari objek S3. Dalam contoh ini, pengguna menyinkronkan bucket mybucket ke direktori lokal saat ini. Ember mybucket berisi benda-benda test.txt dantest2.txt. Direktori lokal saat ini tidak memiliki file:

aws s3 sync s3://mybucket .

Output:

download: s3://mybucket/test.txt to test.txt
download: s3://mybucket/test2.txt to test2.txt

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

syncPerintah berikut menyinkronkan objek di bawah awalan dan bucket yang ditentukan ke file di direktori lokal dengan mengunggah file lokal ke S3. Karena --delete parameternya, 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 mybucket ke direktori lokal saat ini. Direktori lokal saat ini berisi file test.txt dan filetest2.txt. Ember mybucket berisi objektest3.txt:

aws s3 sync . s3://mybucket \
    --delete

Output:

upload: test.txt to s3://mybucket/test.txt
upload: test2.txt to s3://mybucket/test2.txt
delete: s3://mybucket/test3.txt

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

syncPerintah berikut menyinkronkan objek di bawah awalan dan bucket yang ditentukan ke file di direktori lokal dengan mengunggah file lokal ke S3. Karena --exclude parameternya, semua file yang cocok dengan pola yang ada di S3 dan secara lokal akan dikecualikan dari sinkronisasi. Dalam contoh ini, pengguna menyinkronkan bucket mybucket ke direktori lokal saat ini. Direktori lokal saat ini berisi file test.jpg dan filetest2.txt. Ember mybucket berisi objek dengan test.jpg ukuran yang berbeda dari lokaltest.jpg:

aws s3 sync . s3://mybucket \
    --exclude "*.jpg"

Output:

upload: test2.txt to s3://mybucket/test2.txt

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

syncPerintah berikut menyinkronkan file di bawah direktori lokal ke objek di bawah awalan dan ember tertentu dengan mengunduh objek S3. Contoh ini menggunakan flag --exclude parameter untuk mengecualikan direktori tertentu dan awalan S3 dari perintah. sync Dalam contoh ini, pengguna menyinkronkan direktori lokal saat ini ke bucketmybucket. Direktori lokal saat ini berisi file test.txt dan fileanother/test2.txt. Ember mybucket berisi benda-benda another/test5.txt dantest1.txt:

aws s3 sync s3://mybucket/ . \
    --exclude "*another/*"

Output:

download: s3://mybucket/test1.txt to test1.txt

Contoh 7: Sinkronkan semua objek antar ember di berbagai wilayah

syncPerintah 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: Sinkronkan ke titik akses S3

syncPerintah 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 meng-upload 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 my-bucket \
    --key "Map_Data_June.mp4" \
    --copy-source "my-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\""
    }
}

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

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

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

Output:

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

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

Konfigurasikan bucket S3 sebagai situs web statis

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

Semua file dalam ember 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://my-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.