Glacier (S3 Glacier)

Implementation details for API glacier

Coverage Overview

S3 Glacier (Glacier) is supported by LocalStack only in the pro image.

AvailabilityTesting*
OperationImplementedImageInternal Test SuiteExternal Test SuiteTerraform ValidatedAWS ValidatedSnapshot TestedDetails
AbortMultipartUpload
AbortVaultLock
AddTagsToVault✔️pro✔️Show Tests
CompleteMultipartUpload
CompleteVaultLock
CreateVault✔️pro✔️✔️✔️✔️Show Tests
DeleteArchive✔️pro✔️
DeleteVault✔️pro✔️✔️✔️✔️Show Tests
DeleteVaultAccessPolicy✔️pro
DeleteVaultNotifications✔️pro
DescribeJob✔️pro
DescribeVault✔️pro✔️✔️Show Tests
GetDataRetrievalPolicy
GetJobOutput✔️pro✔️Show Tests
GetVaultAccessPolicy✔️pro✔️Show Tests
GetVaultLock
GetVaultNotifications✔️pro✔️Show Tests
InitiateJob✔️pro✔️✔️✔️✔️Show Tests
InitiateMultipartUpload
InitiateVaultLock
ListJobs✔️pro✔️
ListMultipartUploads
ListParts
ListProvisionedCapacity
ListTagsForVault✔️pro✔️Show Tests
ListVaults✔️pro✔️Show Tests
PurchaseProvisionedCapacity
RemoveTagsFromVault✔️pro
SetDataRetrievalPolicy
SetVaultAccessPolicy✔️pro
SetVaultNotifications✔️pro
UploadArchive✔️pro✔️✔️✔️✔️Show Tests
UploadMultipartPart

Terminology

  • Internal Test Suite: tested by LocalStack's internal integration test suite
  • External Test Suite: covered by an external integration test suite, that runs against LocalStack
  • Terraform Validated: operation tested with Terraform
  • AWS Validated: the integration test that includes this operation call was validated against AWS
  • Snapshot Tested: the operation is part of a snapshot parity test, which verifies the responses by LocalStack and AWS are the same

Testing Details

This section gives an overview about the internal integration test suite and the specific test cases that recorded the API call.

How to read the test details?

For each operation we put up a list of the related integration test cases.
Those operation calls have been recorded during the exeuction of the outlined test cases. Some calls might be internal, i.e., they are not explicitly called in the test, but are triggered implicitly by the LocalStack framework.

  • Parameters: The tests are ordered by the parameters used, which are highlighted in bold.
  • Test Details: LocalStack Community or LocalStack Pro indicates where the test originates. For each test you see:
    • test name
    • status code returned (which is the expected one for the test case)
    • information about validation:
      • AWS validated the test is validated against AWS, meaning it run successfully against real AWS as well
      • Snapshot Tested this is a snapshot parity test, meaning the responses are validated against AWS


AddTagsToVault

Parameters: Tags, accountId, vaultName
  • LocalStack Pro
    • test_appsync_deployed LocalStack Pro: tests/aws/test_terraform.py::TestTerraform::test_appsync_deployed HTTP Status Code: 204
Parameters: accountId, vaultName
  • LocalStack Pro
    • test_invalid_vault_name LocalStack Pro: tests/aws/services/glacier/test_glacier.py::TestGlacier::test_invalid_vault_name HTTP Status Code: 404 (ResourceNotFoundException)

CreateVault

Parameters: accountId, vaultName
  • LocalStack Pro
    • test_inventory_retrieval LocalStack Pro: tests/aws/services/glacier/test_glacier.py::TestGlacier::test_inventory_retrieval HTTP Status Code: 201
    • test_select_query_archive LocalStack Pro: tests/aws/services/glacier/test_glacier.py::TestGlacier::test_select_query_archive HTTP Status Code: 201 AWS validated Snapshot Tested
    • test_appsync_deployed LocalStack Pro: tests/aws/test_terraform.py::TestTerraform::test_appsync_deployed HTTP Status Code: 201

DeleteVault

Parameters: accountId, vaultName
  • LocalStack Pro
    • test_inventory_retrieval LocalStack Pro: tests/aws/services/glacier/test_glacier.py::TestGlacier::test_inventory_retrieval HTTP Status Code: 204
    • test_select_query_archive LocalStack Pro: tests/aws/services/glacier/test_glacier.py::TestGlacier::test_select_query_archive HTTP Status Code: 204 AWS validated Snapshot Tested
    • test_glacier_deployed LocalStack Pro: tests/aws/test_terraform.py::TestTerraform::test_glacier_deployed HTTP Status Code: 204

DescribeVault

Parameters: accountId, vaultName
  • LocalStack Pro
    • test_appsync_deployed LocalStack Pro: tests/aws/test_terraform.py::TestTerraform::test_appsync_deployed HTTP Status Code: 200
    • test_glacier_deployed LocalStack Pro: tests/aws/test_terraform.py::TestTerraform::test_glacier_deployed HTTP Status Code: 200

GetJobOutput

Parameters: accountId, jobId, vaultName
  • LocalStack Pro
    • test_inventory_retrieval LocalStack Pro: tests/aws/services/glacier/test_glacier.py::TestGlacier::test_inventory_retrieval HTTP Status Code: 200
    • test_inventory_retrieval LocalStack Pro: tests/aws/services/glacier/test_glacier.py::TestGlacier::test_inventory_retrieval HTTP Status Code: 200
    • test_inventory_retrieval LocalStack Pro: tests/aws/services/glacier/test_glacier.py::TestGlacier::test_inventory_retrieval HTTP Status Code: 404 (404)

GetVaultAccessPolicy

Parameters: accountId, vaultName
  • LocalStack Pro
    • test_appsync_deployed LocalStack Pro: tests/aws/test_terraform.py::TestTerraform::test_appsync_deployed HTTP Status Code: 200
    • test_glacier_deployed LocalStack Pro: tests/aws/test_terraform.py::TestTerraform::test_glacier_deployed HTTP Status Code: 200

GetVaultNotifications

Parameters: accountId, vaultName
  • LocalStack Pro
    • test_invalid_vault_name LocalStack Pro: tests/aws/services/glacier/test_glacier.py::TestGlacier::test_invalid_vault_name HTTP Status Code: 404 (ResourceNotFoundException)
    • test_appsync_deployed LocalStack Pro: tests/aws/test_terraform.py::TestTerraform::test_appsync_deployed HTTP Status Code: 404 (ResourceNotFoundException)
    • test_glacier_deployed LocalStack Pro: tests/aws/test_terraform.py::TestTerraform::test_glacier_deployed HTTP Status Code: 404 (ResourceNotFoundException)

InitiateJob

Parameters: accountId, jobParameters, vaultName
  • LocalStack Pro
    • test_inventory_retrieval LocalStack Pro: tests/aws/services/glacier/test_glacier.py::TestGlacier::test_inventory_retrieval HTTP Status Code: 202
    • test_select_query_archive LocalStack Pro: tests/aws/services/glacier/test_glacier.py::TestGlacier::test_select_query_archive HTTP Status Code: 202 AWS validated Snapshot Tested

ListTagsForVault

Parameters: accountId, vaultName
  • LocalStack Pro
    • test_appsync_deployed LocalStack Pro: tests/aws/test_terraform.py::TestTerraform::test_appsync_deployed HTTP Status Code: 200
    • test_glacier_deployed LocalStack Pro: tests/aws/test_terraform.py::TestTerraform::test_glacier_deployed HTTP Status Code: 200

ListVaults

Parameters: accountId
  • LocalStack Pro
    • test_glacier_deployed LocalStack Pro: tests/aws/test_terraform.py::TestTerraform::test_glacier_deployed HTTP Status Code: 200

UploadArchive

Parameters: accountId, body, checksum, vaultName
  • LocalStack Pro
    • test_select_query_archive LocalStack Pro: tests/aws/services/glacier/test_glacier.py::TestGlacier::test_select_query_archive HTTP Status Code: 201 AWS validated Snapshot Tested


Last modified March 20, 2023: improve Coverage Docs (#505) (46f2fb0c0)