를 사용한 S3 Glacier 예제 AWS CLI

다음 코드 예제에서는 S3 Glacier와 AWS Command Line Interface 함께 를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다.

작업은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.

각 예제에는 컨텍스트에서 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있는 전체 소스 코드에 대한 링크가 포함되어 있습니다.

주제

작업

작업

다음 코드 예시에서는 abort-multipart-upload을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 라는 이름의 저장소에 대한 진행 중인 멀티파트 업로드를 삭제합니다my-vault.


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

이 명령은 출력을 생성하지 않습니다. Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다. 업로드 ID는 aws glacier initiate-multipart-upload 명령으로 반환되며 aws glacier list-multipart-uploads를 사용하여 가져올 수도 있습니다.

를 사용하여 Amazon Glacier에 멀티파트 업로드하는 방법에 대한 자세한 내용은 AWS CLI 사용 설명서의 Amazon Glacier 사용을 AWS CLI참조하세요.

자세한 API 내용은 명령 참조AbortMultipartUpload의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 abort-vault-lock을 사용하는 방법을 보여 줍니다.

AWS CLI

진행 중인 볼트 잠금 프로세스를 중단하려면

다음 abort-vault-lock 예제에서는 지정된 저장소에서 저장소 잠금 정책을 삭제하고 저장소 잠금의 잠금 상태를 잠금 해제로 재설정합니다.


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

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon Glacier API 개발자 안내서의 볼트 잠금 중단(DELETE 잠금 정책)을 참조하세요.

자세한 API 내용은 명령 참조AbortVaultLock의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 add-tags-to-vault을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 이름이 지정된 my-vault에 두 개의 태그를 추가합니다.


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

Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.

자세한 API 내용은 명령 참조AddTagsToVault의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 complete-multipart-upload을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 3MiB 아카이브에 대한 멀티파트 업로드를 완료합니다.


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

Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.

업로드 ID는 aws glacier initiate-multipart-upload 명령으로 반환되며 aws glacier list-multipart-uploads를 사용하여 가져올 수도 있습니다. 체크섬 파라미터는 아카이브의 SHA-256 트리 해시를 16진수로 사용합니다.

트리 해시 계산 지침을 포함하여 AWS CLI를 사용하여 Amazon Glacier에 멀티파트 업로드하는 방법에 대한 자세한 내용은 AWS CLI 사용 설명서의 Amazon Glacier 사용을 참조하세요.

자세한 API 내용은 명령 참조CompleteMultipartUpload의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 complete-vault-lock을 사용하는 방법을 보여 줍니다.

AWS CLI

진행 중인 볼트 잠금 프로세스를 완료하려면

다음 complete-vault-lock 예제에서는 지정된 저장소에 대한 진행 중인 잠금 진행 상황을 완료하고 저장소 잠금의 잠금 상태를 로 설정합니다Locked. 를 실행할 때 lock-id 파라미터 값을 가져옵니다initiate-lock-process.


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

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon Glacier API 개발자 안내서의 전체 볼트 잠금(POST lockId)을 참조하세요.

자세한 API 내용은 명령 참조CompleteVaultLock의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 create-vault을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 my-vault라는 새 볼트를 생성합니다.


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

Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.

자세한 API 내용은 명령 참조CreateVault의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 delete-archive을 사용하는 방법을 보여 줍니다.

AWS CLI

볼트에서 아카이브를 삭제하는 방법

다음 delete-archive 예시에서는 example_vault에서 지정된 아카이브를 제거합니다.


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

이 명령은 출력을 생성하지 않습니다.

자세한 API 내용은 명령 참조DeleteArchive의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 delete-vault-access-policy을 사용하는 방법을 보여 줍니다.

AWS CLI

볼트의 액세스 정책을 제거하려면

다음 delete-vault-access-policy 예제에서는 지정된 볼트에 대한 액세스 정책을 제거합니다.


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

이 명령은 출력을 생성하지 않습니다.

자세한 API 내용은 명령 참조DeleteVaultAccessPolicy의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 delete-vault-notifications을 사용하는 방법을 보여 줍니다.

AWS CLI

저장소에 대한 SNS 알림을 제거하려면

다음 delete-vault-notifications 예제에서는 지정된 저장소에 대해 Amazon Simple Notification Service(AmazonSNS)에서 보낸 알림을 제거합니다.


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

이 명령은 출력을 생성하지 않습니다.

자세한 API 내용은 명령 참조DeleteVaultNotifications의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 delete-vault을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 my-vault라는 볼트를 삭제합니다.


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

이 명령은 출력을 생성하지 않습니다. Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.

자세한 API 내용은 명령 참조DeleteVault의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 describe-job을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 my-vault라는 저장소의 인벤토리 검색 작업에 대한 정보를 검색합니다.


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

출력:


{
    "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는 aws glacier initiate-job 및 aws glacier list-jobs의 출력에서 찾을 수 있습니다. Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.

자세한 API 내용은 명령 참조DescribeJob의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 describe-vault을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 my-vault라는 볼트에 대한 데이터를 검색합니다.


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

Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.

자세한 API 내용은 명령 참조DescribeVault의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 get-data-retrieval-policy을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 사용 중인 계정에 대한 데이터 검색 정책을 가져옵니다.


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

출력:


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

Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.

자세한 API 내용은 명령 참조GetDataRetrievalPolicy의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 get-job-output을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 볼트 인벤토리 작업의 출력을 output.json라는 현재 디렉터리의 파일에 저장합니다.


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

job-id는 aws glacier list-jobs의 출력에서 확인할 수 있습니다. 참고로 출력 파일 이름은 옵션 이름이 접두사로 붙지 않는 위치 인수입니다. Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.

출력:


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

자세한 API 내용은 명령 참조GetJobOutput의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 get-vault-access-policy을 사용하는 방법을 보여 줍니다.

AWS CLI

볼트의 액세스 정책을 검색하려면

다음 get-vault-access-policy 예제에서는 지정된 볼트에 대한 액세스 정책을 검색합니다.


aws glacier get-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\"}]}"
    }
}

자세한 API 내용은 명령 참조GetVaultAccessPolicy의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 get-vault-lock을 사용하는 방법을 보여 줍니다.

AWS CLI

볼트 잠금의 세부 정보를 가져오려면

다음 get-vault-lock 예제에서는 지정된 볼트의 잠금에 대한 세부 정보를 검색했습니다.


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

출력:


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

자세한 내용은 Amazon Glacier API 개발자 안내서의 Get Vault Lock(GET lock-policy)을 참조하세요.

자세한 API 내용은 명령 참조GetVaultLock의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 get-vault-notifications을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 my-vault라는 저장소의 알림 구성 설명을 가져옵니다.


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

출력:


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

볼트에 대한 알림이 구성되지 않은 경우에는 오류가 반환됩니다. Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.

자세한 API 내용은 명령 참조GetVaultNotifications의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 initiate-job을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 볼트 인벤토리를 가져오는 작업을 시작합니다my-vault.


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

출력:


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

Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.

다음 명령은 볼트 에서 아카이브를 검색하는 작업을 시작합니다my-vault.


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

job-archive-retrieval.json 는 작업 유형, 아카이브 ID 및 일부 선택적 파라미터를 지정하는 로컬 폴더의 JSON 파일입니다.


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

아카이브IDs는 aws glacier upload-archive 및 출력에서 사용할 수 있습니다aws glacier get-job-output.

출력:


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

작업 파라미터 형식에 대한 자세한 내용은 Amazon Glacier API 참조의 작업 시작을 참조하세요.

자세한 API 내용은 명령 참조InitiateJob의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 initiate-multipart-upload을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 파일당 1MiB(1024 x 1024바이트)의 부분 크기my-vault로 라는 볼트에 대한 멀티파트 업로드를 시작합니다.


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

아카이브 설명 파라미터는 선택 사항입니다. Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.

이 명령은 성공하면 업로드 ID를 출력합니다. 를 사용하여 아카이브의 각 부분을 업로드할 때 업로드 ID를 사용합니다aws glacier upload-multipart-part. 를 사용하여 Amazon Glacier에 멀티파트 업로드하는 방법에 대한 자세한 내용은 AWS CLI 사용 설명서의 Amazon Glacier 사용을 AWS CLI참조하세요.

자세한 API 내용은 명령 참조InitiateMultipartUpload의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 initiate-vault-lock을 사용하는 방법을 보여 줍니다.

AWS CLI

볼트 잠금 프로세스를 시작하려면

다음 initiate-vault-lock 예제에서는 지정된 저장소에 저장소 잠금 정책을 설치하고 저장소 잠금의 잠금 상태를 로 설정합니다InProgress. 저장소 잠금 상태를 로 설정하려면 24시간 complete-vault-lock 이내에 를 호출하여 프로세스를 완료해야 합니다Locked.


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

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

출력은 저장소 잠금 프로세스를 완료하는 데 사용할 수 있는 저장소 잠금 ID입니다.


{
    "lockId": "9QZgEXAMPLEPhvL6xEXAMPLE"
}

자세한 내용은 Amazon Glacier API 개발자 안내서의 볼트 잠금 시작(POST 잠금 정책)을 참조하세요.

자세한 API 내용은 명령 참조InitiateVaultLock의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 list-jobs을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 my-vault라는 볼트에 대해 진행 중인 작업과 최근에 완료된 작업을 나열합니다.


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

출력:


{
    "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에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.

자세한 API 내용은 명령 참조ListJobs의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 list-multipart-uploads을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 라는 저장소에 대해 진행 중인 멀티파트 업로드를 모두 보여줍니다my-vault.


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

Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.

를 사용하여 Amazon Glacier에 멀티파트 업로드하는 방법에 대한 자세한 내용은 AWS CLI 사용 설명서의 Amazon Glacier 사용을 AWS CLI참조하세요.

자세한 API 내용은 명령 참조ListMultipartUploads의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 list-parts을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 라는 저장소에 대한 멀티파트 업로드에 대해 업로드된 부분을 나열합니다my-vault.


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

출력:


{
    "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에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.

를 사용하여 Amazon Glacier에 멀티파트 업로드하는 방법에 대한 자세한 내용은 AWS CLI 사용 설명서의 Amazon Glacier 사용을 AWS CLI참조하세요.

자세한 API 내용은 명령 참조ListParts의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 list-provisioned-capacity을 사용하는 방법을 보여 줍니다.

AWS CLI

프로비저닝된 용량 단위를 검색하려면

다음 list-provisioned-capacity 예제에서는 지정된 계정에 대해 프로비저닝된 용량 단위에 대한 세부 정보를 검색합니다.


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

출력:


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

자세한 API 내용은 명령 참조ListProvisionedCapacity의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 list-tags-for-vault을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 my-vault라는 볼트에 적용된 태그를 나열합니다.


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

출력:


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

Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.

자세한 API 내용은 명령 참조ListTagsForVault의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 list-vaults을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 기본 계정 및 리전 내 볼트를 나열합니다.


aws glacier list-vaults --account-id -

출력:


{
    "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에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.

자세한 API 내용은 명령 참조ListVaults의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 purchase-provisioned-capacity을 사용하는 방법을 보여 줍니다.

AWS CLI

프로비저닝된 용량 단위를 구매하려면

다음 purchase-provisioned-capacity 예제에서는 프로비저닝된 용량 단위를 구매합니다.


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

출력:


{
    "capacityId": "HpASAuvfRFiVDbOjMfEIcr8K"
}

자세한 API 내용은 명령 참조PurchaseProvisionedCapacity의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 remove-tags-from-vault을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 이름이 인 볼트date에서 키가 있는 태그를 제거합니다my-vault.


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

Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.

자세한 API 내용은 명령 참조RemoveTagsFromVault의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 set-data-retrieval-policy을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 사용 중인 계정에 대한 데이터 검색 정책을 구성합니다.


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

data-retrieval-policy.json 는 데이터 검색 정책을 지정하는 현재 폴더의 JSON 파일입니다.


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

Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.

다음 명령은 데이터 검색 정책을 인라인 FreeTier 사용 으로 설정합니다JSON.


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

정책 형식에 대한 자세한 내용은 Amazon Glacier API 참조의 데이터 검색 정책 설정을 참조하세요.

자세한 API 내용은 명령 참조SetDataRetrievalPolicy의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 set-vault-access-policy을 사용하는 방법을 보여 줍니다.

AWS CLI

볼트의 액세스 정책을 설정하려면

다음 set-vault-access-policy 예제에서는 권한 정책을 지정된 볼트에 연결합니다.


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\"}]}"}'

이 명령은 출력을 생성하지 않습니다.

자세한 API 내용은 명령 참조SetVaultAccessPolicy의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 set-vault-notifications을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 이름이 인 볼트에 대한 SNS 알림을 구성합니다my-vault.


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

notificationconfig.json 는 게시할 SNS 주제와 이벤트를 지정하는 현재 폴더의 JSON 파일입니다.


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

Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.

자세한 API 내용은 명령 참조SetVaultNotifications의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 upload-archive을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 archive.zip이라는 현재 폴더의 아카이브를 my-vault라는 볼트에 업로드합니다.


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

출력:


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

Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.

업로드된 아카이브를 검색하려면 aws glacier initiate-job 명령을 사용하여 검색 작업을 시작하세요.

자세한 API 내용은 명령 참조UploadArchive의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 upload-multipart-part을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 아카이브의 첫 번째 1MiB(1024 x 1024바이트) 부분을 업로드합니다.


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에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.

본문 파라미터는 로컬 파일 시스템의 부분 파일 경로를 사용합니다. 범위 파라미터는 완료된 아카이브에서 파트가 차지하는 바이트를 나타내는 HTTP 콘텐츠 범위를 취합니다. 업로드 ID는 aws glacier initiate-multipart-upload 명령으로 반환되며 aws glacier list-multipart-uploads를 사용하여 가져올 수도 있습니다.

를 사용하여 Amazon Glacier에 멀티파트 업로드하는 방법에 대한 자세한 내용은 AWS CLI 사용 설명서의 Amazon Glacier 사용을 AWS CLI참조하세요.

자세한 API 내용은 명령 참조UploadMultipartPart의 섹션을 참조하세요. AWS CLI

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

Amazon S3 콘솔

Secrets Manager