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

Contoh kode berikut menunjukkan cara melakukan tindakan dan mengimplementasikan skenario umum dengan menggunakan gletser AWS Command Line Interface with S3.

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

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

Tindakan

Contoh kode berikut menunjukkan cara menggunakanabort-multipart-upload.

AWS CLI

Perintah berikut menghapus unggahan multipart yang sedang berlangsung ke vault bernama: my-vault

aws glacier abort-multipart-upload --account-id - --vault-name my-vault --upload-id 19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ

Perintah ini tidak menghasilkan output apa pun. Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan. ID unggahan dikembalikan oleh aws glacier initiate-multipart-upload perintah dan juga dapat diperoleh dengan menggunakanaws glacier list-multipart-uploads.

Untuk informasi selengkapnya tentang unggahan multipart ke Amazon Glacier menggunakan, AWS CLI lihat Menggunakan Amazon Glacier di Panduan Pengguna.AWS CLI

Contoh kode berikut menunjukkan cara menggunakanabort-vault-lock.

AWS CLI

Untuk membatalkan proses penguncian vault yang sedang berlangsung

abort-vault-lockContoh berikut menghapus kebijakan kunci vault dari vault yang ditentukan dan mengatur ulang status kunci kunci vault menjadi tidak terkunci.

aws glacier abort-vault-lock \
    --account-id - \
    --vault-name MyVaultName

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Batalkan Kunci Vault (DELETEkebijakan kunci) di Panduan Pengembang Amazon Glacier. API

  • Untuk API detailnya, lihat AbortVaultLockdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanadd-tags-to-vault.

AWS CLI

Perintah berikut menambahkan dua tag ke vault bernamamy-vault:

aws glacier add-tags-to-vault --account-id - --vault-name my-vault --tags id=1234,date=july2015

Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.

  • Untuk API detailnya, lihat AddTagsToVaultdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakancomplete-multipart-upload.

AWS CLI

Perintah berikut menyelesaikan unggahan multipart untuk arsip 3 MiB:

aws glacier complete-multipart-upload --archive-size 3145728 --checksum 9628195fcdbcbbe76cdde456d4646fa7de5f219fb39823836d81f0cc0e18aa67 --upload-id 19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ --account-id - --vault-name my-vault

Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.

ID unggahan dikembalikan oleh aws glacier initiate-multipart-upload perintah dan juga dapat diperoleh dengan menggunakanaws glacier list-multipart-uploads. Parameter checksum mengambil hash pohon SHA -256 dari arsip dalam heksadesimal.

Untuk informasi selengkapnya tentang unggahan multipart ke Amazon Glacier menggunakan AWS CLI, termasuk petunjuk cara menghitung hash pohon, lihat Menggunakan Amazon Glacier di Panduan Pengguna.AWS CLI

Contoh kode berikut menunjukkan cara menggunakancomplete-vault-lock.

AWS CLI

Untuk menyelesaikan proses penguncian vault yang sedang berlangsung

complete-vault-lockContoh berikut melengkapi progres penguncian yang sedang berlangsung untuk vault yang ditentukan dan menyetel status kunci kunci vault ke. Locked Anda mendapatkan nilai untuk lock-id parameter saat Anda menjalankaninitiate-lock-process.

aws glacier complete-vault-lock \
    --account-id - \
    --vault-name MyVaultName \
    --lock-id 9QZgEXAMPLEPhvL6xEXAMPLE

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Complete Vault Lock (POSTlockId) di Panduan Pengembang APIAmazon Glacier.

Contoh kode berikut menunjukkan cara menggunakancreate-vault.

AWS CLI

Perintah berikut membuat vault baru bernamamy-vault:

aws glacier create-vault --vault-name my-vault --account-id -

Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.

  • Untuk API detailnya, lihat CreateVaultdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandelete-archive.

AWS CLI

Untuk menghapus arsip dari vault

delete-archiveContoh berikut menghapus arsip yang ditentukan dariexample_vault.

aws glacier delete-archive \
    --account-id 111122223333  \
    --vault-name example_vault \
    --archive-id Sc0u9ZP8yaWkmh-XGlIvAVprtLhaLCGnNwNl5I5x9HqPIkX5mjc0DrId3Ln-Gi_k2HzmlIDZUz117KSdVMdMXLuFWi9PJUitxWO73edQ43eTlMWkH0pd9zVSAuV_XXZBVhKhyGhJ7w

Perintah ini tidak menghasilkan output.

  • Untuk API detailnya, lihat DeleteArchivedi Referensi AWS CLI Perintah.

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

AWS CLI

Untuk menghapus kebijakan akses vault

delete-vault-access-policyContoh berikut menghapus kebijakan akses untuk vault yang ditentukan.

aws glacier delete-vault-access-policy \
    --account-id 111122223333 \
    --vault-name example_vault

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakandelete-vault-notifications.

AWS CLI

Untuk menghapus SNS notifikasi untuk vault

delete-vault-notificationsContoh berikut menghapus notifikasi yang dikirim oleh Amazon Simple Notification Service (AmazonSNS) untuk vault yang ditentukan.

aws glacier delete-vault-notifications \
    --account-id 111122223333 \
    --vault-name example_vault

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakandelete-vault.

AWS CLI

Perintah berikut menghapus vault bernama: my-vault

aws glacier delete-vault --vault-name my-vault --account-id -

Perintah ini tidak menghasilkan output apa pun. Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.

  • Untuk API detailnya, lihat DeleteVaultdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandescribe-job.

AWS CLI

Perintah berikut mengambil informasi tentang pekerjaan pengambilan inventaris pada vault bernama: my-vault

aws glacier describe-job --account-id - --vault-name my-vault --job-id zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW

Output:

{
    "InventoryRetrievalParameters": {
        "Format": "JSON"
    },
    "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault",
    "Completed": false,
    "JobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW",
    "Action": "InventoryRetrieval",
    "CreationDate": "2015-07-17T20:23:41.616Z",
    "StatusCode": "InProgress"
}

ID pekerjaan dapat ditemukan di output aws glacier initiate-job danaws glacier list-jobs. Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.

  • Untuk API detailnya, lihat DescribeJobdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandescribe-vault.

AWS CLI

Perintah berikut mengambil data tentang vault bernama: my-vault

aws glacier describe-vault --vault-name my-vault --account-id -

Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.

  • Untuk API detailnya, lihat DescribeVaultdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-data-retrieval-policy.

AWS CLI

Perintah berikut mendapatkan kebijakan pengambilan data untuk akun yang sedang digunakan:

aws glacier get-data-retrieval-policy --account-id -

Output:

{
    "Policy": {
        "Rules": [
            {
                "BytesPerHour": 10737418240,
                "Strategy": "BytesPerHour"
            }
        ]
    }
}

Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.

Contoh kode berikut menunjukkan cara menggunakanget-job-output.

AWS CLI

Perintah berikut menyimpan output dari pekerjaan inventaris vault ke file di direktori saat ini bernamaoutput.json:

aws glacier get-job-output --account-id - --vault-name my-vault --job-id zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW output.json

job-idTersedia dalam output dariaws glacier list-jobs. Perhatikan bahwa nama file output adalah argumen posisi yang tidak diawali dengan nama opsi. Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.

Output:

{
    "status": 200,
    "acceptRanges": "bytes",
    "contentType": "application/json"
}

output.json:

{"VaultARN":"arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault","InventoryDate":"2015-04-07T00:26:18Z","ArchiveList":[{"ArchiveId":"kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw","ArchiveDescription":"multipart upload test","CreationDate":"2015-04-06T22:24:34Z","Size":3145728,"SHA256TreeHash":"9628195fcdbcbbe76cdde932d4646fa7de5f219fb39823836d81f0cc0e18aa67"}]}

  • Untuk API detailnya, lihat GetJobOutputdi Referensi AWS CLI Perintah.

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

AWS CLI

Untuk mengambil kebijakan akses vault

get-vault-access-policyContoh berikut mengambil kebijakan akses untuk vault yang ditentukan.

aws glacier get-vault-access-policy \
    --account-id 111122223333 \
    --vault-name example_vault

Output:

{
    "policy": {
        "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:ListJobs\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"},{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:UploadArchive\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"}]}"
    }
}

Contoh kode berikut menunjukkan cara menggunakanget-vault-lock.

AWS CLI

Untuk mendapatkan detail kunci brankas

get-vault-lockContoh berikut mengambil detail tentang kunci untuk brankas yang ditentukan.

aws glacier get-vault-lock \
    --account-id - \
    --vault-name MyVaultName

Output:

{
    "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"Define-vault-lock\",\"Effect\":\"Deny\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:99999999999:vaults/MyVaultName\",\"Condition\":{\"NumericLessThanEquals\":{\"glacier:ArchiveAgeinDays\":\"365\"}}}]}",
    "State": "Locked",
    "CreationDate": "2019-07-29T22:25:28.640Z"
}

Untuk informasi selengkapnya, lihat Mendapatkan Kunci Vault (GETkebijakan kunci) di Panduan Pengembang Amazon Glacier. API

  • Untuk API detailnya, lihat GetVaultLockdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-vault-notifications.

AWS CLI

Perintah berikut mendapatkan deskripsi konfigurasi notifikasi untuk vault bernamamy-vault:

aws glacier get-vault-notifications --account-id - --vault-name my-vault

Output:

{
    "vaultNotificationConfig": {
        "Events": [
            "InventoryRetrievalCompleted",
            "ArchiveRetrievalCompleted"
        ],
        "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault"
    }
}

Jika tidak ada pemberitahuan yang dikonfigurasi untuk brankas, kesalahan akan dikembalikan. Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.

Contoh kode berikut menunjukkan cara menggunakaninitiate-job.

AWS CLI

Perintah berikut memulai pekerjaan untuk mendapatkan inventaris my-vault vault:

aws glacier initiate-job --account-id - --vault-name my-vault --job-parameters '{"Type": "inventory-retrieval"}'

Output:

{
    "location": "/0123456789012/vaults/my-vault/jobs/zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW",
    "jobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW"
}

Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.

Perintah berikut memulai pekerjaan untuk mengambil arsip dari vault: my-vault

aws glacier initiate-job --account-id - --vault-name my-vault --job-parameters file://job-archive-retrieval.json

job-archive-retrieval.jsonadalah JSON file di folder lokal yang menentukan jenis pekerjaan, ID arsip, dan beberapa parameter opsional:

{
  "Type": "archive-retrieval",
  "ArchiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw",
  "Description": "Retrieve archive on 2015-07-17",
  "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-topic"
}

Arsip IDs tersedia dalam output aws glacier upload-archive danaws glacier get-job-output.

Output:

{
    "location": "/011685312445/vaults/mwunderl/jobs/l7IL5-EkXyEY9Ws95fClzIbk2O5uLYaFdAYOi-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav",
    "jobId": "l7IL5-EkXy2O5uLYaFdAYOiEY9Ws95fClzIbk-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav"
}

Lihat Memulai Pekerjaan di Referensi API Amazon Glacier untuk detail tentang format parameter pekerjaan.

  • Untuk API detailnya, lihat InitiateJobdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakaninitiate-multipart-upload.

AWS CLI

Perintah berikut memulai unggahan multipart ke vault bernama my-vault dengan ukuran bagian 1 MiB (1024 x 1024 byte) per file:

aws glacier initiate-multipart-upload --account-id - --part-size 1048576 --vault-name my-vault --archive-description "multipart upload test"

Parameter deskripsi arsip adalah opsional. Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.

Perintah ini mengeluarkan ID unggahan saat berhasil. Gunakan ID unggahan saat mengunggah setiap bagian arsip Anda. aws glacier upload-multipart-part Untuk informasi selengkapnya tentang unggahan multipart ke Amazon Glacier menggunakan, AWS CLI lihat Menggunakan Amazon Glacier di Panduan Pengguna.AWS CLI

Contoh kode berikut menunjukkan cara menggunakaninitiate-vault-lock.

AWS CLI

Untuk memulai proses penguncian vault

initiate-vault-lockContoh berikut menginstal kebijakan kunci vault pada vault yang ditentukan dan menyetel status kunci kunci vault ke. InProgress Anda harus menyelesaikan proses dengan menelepon complete-vault-lock dalam waktu 24 jam untuk mengatur status kunci brankas. Locked

aws glacier initiate-vault-lock \
    --account-id - \
    --vault-name MyVaultName \
    --policy file://vault_lock_policy.json

Isi dari vault_lock_policy.json:

{"Policy":"{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"Define-vault-lock\",\"Effect\":\"Deny\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:999999999999:vaults/examplevault\",\"Condition\":{\"NumericLessThanEquals\":{\"glacier:ArchiveAgeinDays\":\"365\"}}}]}"}

Outputnya adalah ID kunci vault yang dapat Anda gunakan untuk menyelesaikan proses penguncian vault.

{
    "lockId": "9QZgEXAMPLEPhvL6xEXAMPLE"
}

Untuk informasi selengkapnya, lihat Memulai Kunci Vault (POSTkebijakan kunci) di Panduan Pengembang Amazon Glacier. API

Contoh kode berikut menunjukkan cara menggunakanlist-jobs.

AWS CLI

Perintah berikut mencantumkan pekerjaan yang sedang berlangsung dan baru saja diselesaikan untuk vault bernama: my-vault

aws glacier list-jobs --account-id - --vault-name my-vault

Output:

{
    "JobList": [
        {
            "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault",
            "RetrievalByteRange": "0-3145727",
            "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault",
            "Completed": false,
            "SHA256TreeHash": "9628195fcdbcbbe76cdde932d4646fa7de5f219fb39823836d81f0cc0e18aa67",
            "JobId": "l7IL5-EkXyEY9Ws95fClzIbk2O5uLYaFdAYOi-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav",
            "ArchiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw",
            "JobDescription": "Retrieve archive on 2015-07-17",
            "ArchiveSizeInBytes": 3145728,
            "Action": "ArchiveRetrieval",
            "ArchiveSHA256TreeHash": "9628195fcdbcbbe76cdde932d4646fa7de5f219fb39823836d81f0cc0e18aa67",
            "CreationDate": "2015-07-17T21:16:13.840Z",
            "StatusCode": "InProgress"
        },
        {
            "InventoryRetrievalParameters": {
                "Format": "JSON"
            },
            "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault",
            "Completed": false,
            "JobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW",
            "Action": "InventoryRetrieval",
            "CreationDate": "2015-07-17T20:23:41.616Z",
            "StatusCode": ""InProgress""
        }
    ]
}

Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.

  • Untuk API detailnya, lihat ListJobsdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-multipart-uploads.

AWS CLI

Perintah berikut menunjukkan semua unggahan multipart yang sedang berlangsung untuk vault bernama: my-vault

aws glacier list-multipart-uploads --account-id - --vault-name my-vault

Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.

Untuk informasi selengkapnya tentang unggahan multipart ke Amazon Glacier menggunakan, AWS CLI lihat Menggunakan Amazon Glacier di Panduan Pengguna.AWS CLI

Contoh kode berikut menunjukkan cara menggunakanlist-parts.

AWS CLI

Perintah berikut mencantumkan bagian yang diunggah untuk unggahan multibagian ke vault bernama: my-vault

aws glacier list-parts --account-id - --vault-name my-vault --upload-id "SYZi7qnL-YGqGwAm8Kn3BLP2ElNCvnB-5961R09CSaPmPwkYGHOqeN_nX3-Vhnd2yF0KfB5FkmbnBU9GubbdrCs8ut-D"

Output:

{
    "MultipartUploadId": "SYZi7qnL-YGqGwAm8Kn3BLP2ElNCvnB-5961R09CSaPmPwkYGHOqeN_nX3-Vhnd2yF0KfB5FkmbnBU9GubbdrCs8ut-D",
    "Parts": [
        {
            "RangeInBytes": "0-1048575",
            "SHA256TreeHash": "e1f2a7cd6e047350f69b9f8cfa60fa606fe2f02802097a9a026360a7edc1f553"
        },
        {
            "RangeInBytes": "1048576-2097151",
            "SHA256TreeHash": "43cf3061fb95796aed99a11a6aa3cd8f839eed15e655ab0a597126210636aee6"
        }
    ],
    "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault",
    "CreationDate": "2015-07-18T00:05:23.830Z",
    "PartSizeInBytes": 1048576
}

Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.

Untuk informasi selengkapnya tentang unggahan multipart ke Amazon Glacier menggunakan, AWS CLI lihat Menggunakan Amazon Glacier di Panduan Pengguna.AWS CLI

  • Untuk API detailnya, lihat ListPartsdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-provisioned-capacity.

AWS CLI

Untuk mengambil unit kapasitas yang disediakan

list-provisioned-capacityContoh berikut mengambil rincian untuk setiap unit kapasitas yang disediakan untuk akun yang ditentukan.

aws glacier list-provisioned-capacity \
    --account-id 111122223333

Output:

{
    "ProvisionedCapacityList": [
        {
            "CapacityId": "HpASAuvfRFiVDbOjMfEIcr8K",
            "ExpirationDate": "2020-03-18T19:59:24.000Z",
            "StartDate": "2020-02-18T19:59:24.912Z"
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakanlist-tags-for-vault.

AWS CLI

Perintah berikut mencantumkan tag yang diterapkan ke vault bernamamy-vault:

aws glacier list-tags-for-vault --account-id - --vault-name my-vault

Output:

{
    "Tags": {
        "date": "july2015",
        "id": "1234"
    }
}

Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.

Contoh kode berikut menunjukkan cara menggunakanlist-vaults.

AWS CLI

Perintah berikut mencantumkan vault di akun dan wilayah default:

aws glacier list-vaults --account-id -

Output:

{
    "VaultList": [
        {
            "SizeInBytes": 3178496,
            "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault",
            "LastInventoryDate": "2015-04-07T00:26:19.028Z",
            "VaultName": "my-vault",
            "NumberOfArchives": 1,
            "CreationDate": "2015-04-06T21:23:45.708Z"
        }
    ]
}

Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.

  • Untuk API detailnya, lihat ListVaultsdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanpurchase-provisioned-capacity.

AWS CLI

Untuk membeli unit kapasitas yang disediakan

purchase-provisioned-capacityContoh berikut membeli unit kapasitas yang disediakan.

aws glacier purchase-provisioned-capacity \
    --account-id 111122223333

Output:

{
    "capacityId": "HpASAuvfRFiVDbOjMfEIcr8K"
}

Contoh kode berikut menunjukkan cara menggunakanremove-tags-from-vault.

AWS CLI

Perintah berikut menghapus tag dengan kunci date dari vault bernamamy-vault:

aws glacier remove-tags-from-vault --account-id - --vault-name my-vault --tag-keys date

Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.

Contoh kode berikut menunjukkan cara menggunakanset-data-retrieval-policy.

AWS CLI

Perintah berikut mengonfigurasi kebijakan pengambilan data untuk akun yang sedang digunakan:

aws glacier set-data-retrieval-policy --account-id - --policy file://data-retrieval-policy.json

data-retrieval-policy.jsonadalah JSON file di folder saat ini yang menentukan kebijakan pengambilan data:

{
  "Rules":[
     {
         "Strategy":"BytesPerHour",
         "BytesPerHour":10737418240
      }
   ]
}

Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.

Perintah berikut menetapkan kebijakan pengambilan data untuk FreeTier menggunakan JSON inline:

aws glacier set-data-retrieval-policy --account-id - --policy '{"Rules":[{"Strategy":"FreeTier"}]}'

Lihat Mengatur Kebijakan Pengambilan Data di Referensi APIAmazon Glacier untuk detail tentang format kebijakan.

Contoh kode berikut menunjukkan cara menggunakanset-vault-access-policy.

AWS CLI

Untuk menyetel kebijakan akses vault

set-vault-access-policyContoh berikut melampirkan kebijakan izin ke vault yang ditentukan.

aws glacier set-vault-access-policy \
    --account-id 111122223333 \
    --vault-name example_vault
    --policy '{"Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:ListJobs\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"},{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:UploadArchive\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"}]}"}'

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakanset-vault-notifications.

AWS CLI

Perintah berikut mengonfigurasi SNS notifikasi untuk vault bernama: my-vault

aws glacier set-vault-notifications --account-id - --vault-name my-vault --vault-notification-config file://notificationconfig.json

notificationconfig.jsonadalah JSON file di folder saat ini yang menentukan SNS topik dan peristiwa yang akan diterbitkan:

{
  "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault",
  "Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"]
}

Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.

Contoh kode berikut menunjukkan cara menggunakanupload-archive.

AWS CLI

Perintah berikut mengunggah arsip di folder saat ini bernama archive.zip ke vault bernama: my-vault

aws glacier upload-archive --account-id - --vault-name my-vault --body archive.zip

Output:

{
    "archiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw",
    "checksum": "969fb39823836d81f0cc028195fcdbcbbe76cdde932d4646fa7de5f21e18aa67",
    "location": "/0123456789012/vaults/my-vault/archives/kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw"
}

Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.

Untuk mengambil arsip yang diunggah, mulailah pekerjaan pengambilan dengan perintah aws glacier initiate-job.

  • Untuk API detailnya, lihat UploadArchivedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanupload-multipart-part.

AWS CLI

Perintah berikut mengunggah bagian 1 MiB (1024 x 1024 byte) pertama dari sebuah arsip:

aws glacier upload-multipart-part --body part1 --range 'bytes 0-1048575/*' --account-id - --vault-name my-vault --upload-id 19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ

Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.

Parameter body mengambil jalur ke file bagian pada sistem file lokal. Parameter rentang mengambil rentang HTTP konten yang menunjukkan byte yang ditempati bagian dalam arsip yang lengkap. ID unggahan dikembalikan oleh aws glacier initiate-multipart-upload perintah dan juga dapat diperoleh dengan menggunakanaws glacier list-multipart-uploads.

Untuk informasi selengkapnya tentang unggahan multipart ke Amazon Glacier menggunakan, AWS CLI lihat Menggunakan Amazon Glacier di Panduan Pengguna.AWS CLI