View a markdown version of this page

Contoh Kontrol 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 Kontrol Amazon S3 menggunakan AWS CLI

Contoh kode berikut menunjukkan cara melakukan tindakan dan menerapkan skenario umum dengan menggunakan AWS Command Line Interface dengan Kontrol 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 menggunakancreate-access-point.

AWS CLI

Untuk membuat titik akses

create-access-pointContoh berikut membuat titik akses bernama finance-ap untuk bucket business-records di akun 123456789012. Sebelum menjalankan contoh ini, ganti nama titik akses, nama bucket, dan nomor akun dengan nilai yang sesuai untuk kasus penggunaan Anda.

aws s3control create-access-point \
    --account-id 123456789012 \
    --bucket business-records \
    --name finance-ap

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Membuat Titik Akses di Panduan Pengembang Layanan Penyimpanan Sederhana Amazon.

Contoh kode berikut menunjukkan cara menggunakancreate-job.

AWS CLI

Cara membuat pekerjaan operasi batch Amazon S3

create-jobContoh berikut membuat pekerjaan operasi batch Amazon S3 untuk menandai objek sebagaiconfidential` in the bucket ``employee-records.

aws s3control create-job \
    --account-id 123456789012 \
    --operation '{"S3PutObjectTagging": { "TagSet": [{"Key":"confidential", "Value":"true"}] }}' \
    --report '{"Bucket":"arn:aws:s3:::employee-records-logs","Prefix":"batch-op-create-job", "Format":"Report_CSV_20180820","Enabled":true,"ReportScope":"AllTasks"}' \
    --manifest '{"Spec":{"Format":"S3BatchOperations_CSV_20180820","Fields":["Bucket","Key"]},"Location":{"ObjectArn":"arn:aws:s3:::employee-records-logs/inv-report/7a6a9be4-072c-407e-85a2-ec3e982f773e.csv","ETag":"69f52a4e9f797e987155d9c8f5880897"}}' \
    --priority 42 \
    --role-arn arn:aws:iam::123456789012:role/S3BatchJobRole

Output:

{
    "JobId": "93735294-df46-44d5-8638-6356f335324e"
}

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

Contoh kode berikut menunjukkan cara menggunakandelete-access-point-policy.

AWS CLI

Untuk menghapus kebijakan titik akses

delete-access-point-policyContoh berikut menghapus kebijakan titik akses dari titik akses yang disebutkan finance-ap di akun 123456789012. Sebelum menjalankan contoh ini, ganti nama titik akses dan nomor akun dengan nilai yang sesuai untuk kasus penggunaan Anda.

aws s3control delete-access-point-policy \
    --account-id 123456789012 \
    --name finance-ap

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mengelola Akses Data dengan Amazon S3 Access Points di Panduan Pengembang Amazon Simple Storage Service.

Contoh kode berikut menunjukkan cara menggunakandelete-access-point.

AWS CLI

Untuk menghapus titik akses

delete-access-pointContoh berikut menghapus titik akses bernama finance-ap di akun 123456789012. Sebelum menjalankan contoh ini, ganti nama titik akses dan nomor akun dengan nilai yang sesuai untuk kasus penggunaan Anda.

aws s3control delete-access-point \
    --account-id 123456789012 \
    --name finance-ap

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mengelola Akses Data dengan Amazon S3 Access Points di Panduan Pengembang Amazon Simple Storage Service.

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

AWS CLI

Untuk menghapus setelan akses publik blokir untuk akun

delete-public-access-blockContoh berikut menghapus pengaturan akses publik blokir untuk akun yang ditentukan.

aws s3control delete-public-access-block \
    --account-id 123456789012

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakandescribe-job.

AWS CLI

Untuk menjelaskan pekerjaan operasi batch Amazon S3

Berikut ini describe-job menyediakan parameter konfigurasi dan status untuk pekerjaan operasi batch yang ditentukan.

aws s3control describe-job \
    --account-id 123456789012 \
    --job-id 93735294-df46-44d5-8638-6356f335324e

Output:

{
    "Job": {
        "TerminationDate": "2019-10-03T21:49:53.944Z",
        "JobId": "93735294-df46-44d5-8638-6356f335324e",
        "FailureReasons": [],
        "Manifest": {
            "Spec": {
                "Fields": [
                    "Bucket",
                    "Key"
                ],
                "Format": "S3BatchOperations_CSV_20180820"
            },
            "Location": {
                "ETag": "69f52a4e9f797e987155d9c8f5880897",
                "ObjectArn": "arn:aws:s3:::employee-records-logs/inv-report/7a6a9be4-072c-407e-85a2-ec3e982f773e.csv"
            }
        },
        "Operation": {
            "S3PutObjectTagging": {
                "TagSet": [
                    {
                        "Value": "true",
                        "Key": "confidential"
                    }
                ]
            }
        },
        "RoleArn": "arn:aws:iam::123456789012:role/S3BatchJobRole",
        "ProgressSummary": {
            "TotalNumberOfTasks": 8,
            "NumberOfTasksFailed": 0,
            "NumberOfTasksSucceeded": 8
        },
        "Priority": 42,
        "Report": {
            "ReportScope": "AllTasks",
            "Format": "Report_CSV_20180820",
            "Enabled": true,
            "Prefix": "batch-op-create-job",
            "Bucket": "arn:aws:s3:::employee-records-logs"
        },
        "JobArn": "arn:aws:s3:us-west-2:123456789012:job/93735294-df46-44d5-8638-6356f335324e",
        "CreationTime": "2019-10-03T21:48:48.048Z",
        "Status": "Complete"
    }
}

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

Contoh kode berikut menunjukkan cara menggunakanget-access-point-policy-status.

AWS CLI

Untuk mengambil status kebijakan titik akses

get-access-point-policy-statusContoh berikut mengambil status kebijakan titik akses untuk titik akses yang dinamai finance-ap di akun 123456789012. Status kebijakan titik akses menunjukkan apakah kebijakan titik akses mengizinkan akses publik. Sebelum menjalankan contoh ini, ganti nama titik akses dan nomor akun dengan nilai yang sesuai untuk kasus penggunaan Anda.

aws s3control get-access-point-policy-status \
    --account-id 123456789012 \
    --name finance-ap

Output:

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

Untuk informasi selengkapnya tentang kapan kebijakan titik akses dianggap publik, lihat Ar ti “Publik” di Panduan Pengembang Layanan Penyimpanan Sederhana Amazon.

Contoh kode berikut menunjukkan cara menggunakanget-access-point-policy.

AWS CLI

Untuk mengambil kebijakan titik akses

get-access-point-policyContoh berikut mengambil kebijakan titik akses dari titik akses yang dinamai finance-ap di akun 123456789012. Sebelum menjalankan contoh ini, ganti nama titik akses dan nomor akun dengan nilai yang sesuai untuk kasus penggunaan Anda.

aws s3control get-access-point-policy \
    --account-id 123456789012 \
    --name finance-ap

Output:

{
    "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::123456789012:role/Admin\"},\"Action\":\"s3:GetObject\",\"Resource\":\"arn:aws:s3:us-west-2:123456789012:accesspoint/finance-ap/object/records/*\"}]}"
}

Untuk informasi selengkapnya, lihat Mengelola Akses Data dengan Amazon S3 Access Points di Panduan Pengembang Amazon Simple Storage Service.

Contoh kode berikut menunjukkan cara menggunakanget-access-point.

AWS CLI

Untuk mengambil detail konfigurasi titik akses

get-access-pointContoh berikut mengambil detail konfigurasi untuk titik akses yang dinamai finance-ap di akun 123456789012. Sebelum menjalankan contoh ini, ganti nama titik akses dan nomor akun dengan nilai yang sesuai untuk kasus penggunaan Anda.

aws s3control get-access-point \
    --account-id 123456789012 \
    --name finance-ap

Output:

{
    "Name": "finance-ap",
    "Bucket": "business-records",
    "NetworkOrigin": "Internet",
    "PublicAccessBlockConfiguration": {
        "BlockPublicAcls": false,
        "IgnorePublicAcls": false,
        "BlockPublicPolicy": false,
        "RestrictPublicBuckets": false
    },
    "CreationDate": "2020-01-01T00:00:00Z"
}

Untuk informasi selengkapnya, lihat Mengelola Akses Data dengan Amazon S3 Access Points di Panduan Pengembang Amazon Simple Storage Service.

Contoh kode berikut menunjukkan cara menggunakanget-multi-region-access-point-routes.

AWS CLI

Untuk menanyakan konfigurasi rute Multi-Region Access Point saat ini

get-multi-region-access-point-routesContoh berikut mengembalikan konfigurasi routing saat ini untuk Multi-Region Access Point yang ditentukan.

aws s3control get-multi-region-access-point-routes \
    --region Region \
    --account-id 111122223333 \
    --mrap MultiRegionAccessPoint_ARN

Output:

{
    "Mrap": "arn:aws:s3::111122223333:accesspoint/0000000000000.mrap",
    "Routes": [
        {
            "Bucket": "amzn-s3-demo-bucket1",
            "Region": "ap-southeast-2",
            "TrafficDialPercentage": 100
        },
        {
            "Bucket": "amzn-s3-demo-bucket2",
            "Region": "us-west-1",
            "TrafficDialPercentage": 0
        }
    ]
}

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

AWS CLI

Untuk mencantumkan setelan akses blok publik untuk akun

get-public-access-blockContoh berikut menampilkan pengaturan akses publik blok untuk akun yang ditentukan.

aws s3control get-public-access-block \
    --account-id 123456789012

Output:

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

Contoh kode berikut menunjukkan cara menggunakanlist-access-points.

AWS CLI

Contoh 1: Untuk mengambil daftar semua titik akses untuk akun

list-access-pointsContoh berikut menampilkan daftar semua titik akses yang dilampirkan ke bucket yang dimiliki oleh akun 123456789012.

aws s3control list-access-points \
    --account-id 123456789012

Output:

{
    "AccessPointList": [
        {
            "Name": "finance-ap",
            "NetworkOrigin": "Internet",
            "Bucket": "business-records"
        },
        {
            "Name": "managers-ap",
            "NetworkOrigin": "Internet",
            "Bucket": "business-records"
        },
        {
            "Name": "private-network-ap",
            "NetworkOrigin": "VPC",
            "VpcConfiguration": {
                "VpcId": "1a2b3c"
            },
            "Bucket": "business-records"
        },
        {
            "Name": "customer-ap",
            "NetworkOrigin": "Internet",
            "Bucket": "external-docs"
        },
        {
            "Name": "public-ap",
            "NetworkOrigin": "Internet",
            "Bucket": "external-docs"
        }
    ]
}

Contoh 2: Untuk mengambil daftar semua titik akses untuk bucket

list-access-pointsContoh berikut mengambil daftar semua titik akses yang dilampirkan ke bucket yang external-docs dimiliki oleh akun 123456789012.

aws s3control list-access-points \
    --account-id 123456789012 \
    --bucket external-docs

Output:

{
    "AccessPointList": [
        {
            "Name": "customer-ap",
            "NetworkOrigin": "Internet",
            "Bucket": "external-docs"
        },
        {
            "Name": "public-ap",
            "NetworkOrigin": "Internet",
            "Bucket": "external-docs"
        }
    ]
}

Untuk informasi selengkapnya, lihat Mengelola Akses Data dengan Amazon S3 Access Points di Panduan Pengembang Amazon Simple Storage Service.

Contoh kode berikut menunjukkan cara menggunakanlist-jobs.

AWS CLI

Untuk membuat daftar akun pekerjaan operasi batch Amazon S3

list-jobsContoh berikut mencantumkan semua pekerjaan operasi batch terbaru untuk akun yang ditentukan.

aws s3control list-jobs \
    --account-id 123456789012

Output:

{
    "Jobs": [
        {
            "Operation": "S3PutObjectTagging",
            "ProgressSummary": {
                "NumberOfTasksFailed": 0,
                "NumberOfTasksSucceeded": 8,
                "TotalNumberOfTasks": 8
            },
            "CreationTime": "2019-10-03T21:48:48.048Z",
            "Status": "Complete",
            "JobId": "93735294-df46-44d5-8638-6356f335324e",
            "Priority": 42
        },
        {
            "Operation": "S3PutObjectTagging",
            "ProgressSummary": {
                "NumberOfTasksFailed": 0,
                "NumberOfTasksSucceeded": 0,
                "TotalNumberOfTasks": 0
            },
            "CreationTime": "2019-10-03T21:46:07.084Z",
            "Status": "Failed",
            "JobId": "3f3c7619-02d3-4779-97f6-1d98dd313108",
            "Priority": 42
        },
    ]
}

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

Contoh kode berikut menunjukkan cara menggunakanput-access-point-policy.

AWS CLI

Untuk menetapkan kebijakan titik akses

put-access-point-policyContoh berikut menempatkan kebijakan titik akses yang ditentukan untuk titik akses finance-ap di akun 123456789012. Jika titik akses finance-ap sudah memiliki kebijakan, perintah ini menggantikan kebijakan yang ada dengan yang ditentukan dalam perintah ini. Sebelum menjalankan contoh ini, ganti nomor akun, nama titik akses, dan pernyataan kebijakan dengan nilai yang sesuai untuk kasus penggunaan Anda.

aws s3control put-access-point-policy \
    --account-id 123456789012 \
    --name finance-ap \
    --policy file://ap-policy.json

Isi dari ap-policy.json:

{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::123456789012:user/Alice"
            },
            "Action": "s3:GetObject",
            "Resource": "arn:aws:s3:us-west-2:123456789012:accesspoint/finance-ap/object/Alice/*"
        }
    ]
}

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mengelola Akses Data dengan Amazon S3 Access Points di Panduan Pengembang Amazon Simple Storage Service.

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

AWS CLI

Cara mengedit setelan akses publik blokir untuk akun

put-public-access-blockContoh berikut mengalihkan semua pengaturan akses publik blokir true untuk akun yang ditentukan.

aws s3control put-public-access-block \
    --account-id 123456789012 \
    --public-access-block-configuration '{"BlockPublicAcls": true, "IgnorePublicAcls": true, "BlockPublicPolicy": true, "RestrictPublicBuckets": true}'

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakansubmit-multi-region-access-point-routes.

AWS CLI

Untuk memperbarui konfigurasi perutean Multi-Region Access Point

submit-multi-region-access-point-routesContoh berikut memperbarui status routing amzn-s3-demo-bucket1 dan amzn-s3-demo-bucket2 di Wil ap-southeast-2 ayah untuk Titik Multi-Region Akses Anda.

aws s3control submit-multi-region-access-point-routes \
    --region ap-southeast-2 \
    --account-id 111122223333 \
    --mrap MultiRegionAccessPoint_ARN \
    --route-updates Bucket=amzn-s3-demo-bucket1,TrafficDialPercentage=100 Bucket=amzn-s3-demo-bucket2,TrafficDialPercentage=0

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakanupdate-job-priority.

AWS CLI

Untuk memperbarui prioritas pekerjaan dari pekerjaan operasi batch Amazon S3

update-job-priorityContoh berikut memperbarui pekerjaan yang ditentukan ke prioritas baru.

aws s3control update-job-priority \
    --account-id 123456789012 \
    --job-id 8d9a18fe-c303-4d39-8ccc-860d372da386 \
    --priority 52

Output:

{
    "JobId": "8d9a18fe-c303-4d39-8ccc-860d372da386",
    "Priority": 52
}

Contoh kode berikut menunjukkan cara menggunakanupdate-job-status.

AWS CLI

Untuk memperbarui status pekerjaan operasi batch Amazon S3

update-job-statusContoh berikut membatalkan pekerjaan yang ditentukan yang sedang menunggu persetujuan.

aws s3control update-job-status \
    --account-id 123456789012 \
    --job-id 8d9a18fe-c303-4d39-8ccc-860d372da386 \
    --requested-job-status Cancelled

Output:

{
    "Status": "Cancelled",
    "JobId": "8d9a18fe-c303-4d39-8ccc-860d372da386"
}

update-job-statusContoh berikut mengkonfirmasi dan menjalankan yang ditentukan yang sedang menunggu persetujuan.

aws s3control update-job-status \
    --account-id 123456789012 \
    --job-id 5782949f-3301-4fb3-be34-8d5bab54dbca \
    --requested-job-status Ready

Output::

{
    "Status": "Ready",
    "JobId": "5782949f-3301-4fb3-be34-8d5bab54dbca"
}

update-job-statusContoh berikut membatalkan pekerjaan yang ditentukan yang sedang berjalan.

 aws s3control update-job-status \
    --account-id 123456789012 \
    --job-id 5782949f-3301-4fb3-be34-8d5bab54dbca \
    --requested-job-status Cancelled

Output::
{
         "Status": "Cancelling",
         "JobId": "5782949f-3301-4fb3-be34-8d5bab54dbca"
}