Skip to main content
Version: 0.1.2

S3 coverage

Every S3 operation the emulator advertises, and what Emuplane does with it. The rule is simple and it is enforced on every test run: an operation with no test fails the build, and an operation the console cannot reach is marked as such rather than quietly omitted.

Two columns matter:

  • Shown in the console — a page performs or displays it. An em dash means the operation works over the wire and nowhere in the UI.
  • Emuplane test — the test that exercises it, in this version.

The table is generated in the implementation repository and copied here, so what you read is what the ledger says. Work that is planned rather than done is tracked on this repository's project board.

npm run s3:coverage # reads my-docs/S3.md, rewrites the block above
  • Operations upstream advertises: 84
  • Console actions (/api/exec, the create page): 5
  • Operations with an emuplane test: 84
  • Operations shown in the console: 63
  • GET operations (Get/List/Head/Describe) shown in the console: 35 of 35
  • Operations with no emuplane test: 0

Buckets and objects​

OperationConsole actionShown in the consoleEmuplane test
CreateBucketcreate-bucketBuckets page › Create buckettests/s3/test_create.py, tests/control/test_gateway.py, tests/control/test_parity.py
DeleteBucketdelete-bucketBuckets page › Deletetests/control/test_gateway.py, tests/control/test_parity.py
ListBucketsBuckets pageBuckets page › tabletests/control/test_api.py (via /api/browse), tests/control/test_parity.py
HeadBucketBucket page (region check)Bucket page (HeadBucket decides the region)tests/control/test_gateway.py (301 path), tests/s3/test_objects.py, tests/control/test_api.py
PutObjectput-objectBucket page › Objects › Uploadtests/control/test_api.py, tests/s3/test_objects.py, tests/control/test_parity.py, tests/control/test_object_upload.py
GetObjectBucket page (Objects)Bucket page › Objects › opentests/s3/test_objects.py, tests/control/test_parity.py, tests/control/test_object_upload.py
DeleteObjectdelete-objectBucket page › Objects › open › Deletetests/web/s3.test.jsx (object view), tests/s3/test_catalogue.py, tests/control/test_parity.py
HeadObjectBucket page (Objects)Bucket page › Objects › open (size, ETag, last modified)tests/control/test_gateway.py (301 path), tests/s3/test_objects.py (HEAD first), tests/control/test_api.py
CopyObjectBucket page (Objects)Bucket page › Objects › open › Copytests/s3/test_objects.py, tests/control/test_api.py, tests/web/s3.test.jsx
ListObjects v1/v2list-objectsBucket page › Objectstests/control/test_api.py (v2), tests/control/test_parity.py, tests/s3/test_objects.py (v1)
DeleteObjectsdelete-objectBuckets page › Emptytests/s3/test_objects.py (Empty)

Bucket configuration​

OperationConsole actionShown in the consoleEmuplane test
GetBucketVersioningBucket page (Properties)Bucket page › Propertiestests/s3/test_create.py
PutBucketVersioningBucket page (Properties, Edit)Bucket page › Properties › Edittests/s3/test_create.py, tests/control/test_api.py, tests/web/s3.test.jsx
GetBucketEncryptionBucket page (Properties)Bucket page › Propertiestests/s3/test_create.py, tests/control/test_api.py
PutBucketEncryptionBucket page (Properties, Edit)Bucket page › Properties › Edittests/s3/test_create.py, tests/s3/test_objects.py, tests/control/test_api.py, tests/web/s3.test.jsx
DeleteBucketEncryption—Bucket page › Properties › Remove default encryptiontests/s3/test_objects.py, tests/control/test_api.py, tests/web/s3.test.jsx
GetBucketLifecycleConfigurationBucket page (Configuration documents)Bucket page › Configuration documentstests/s3/test_objects.py (documents)
PutBucketLifecycleConfigurationBucket page (Configuration documents, Edit)Bucket page › Configuration documents › Edittests/s3/test_objects.py (lifecycle round trip), tests/control/test_api.py (cors), tests/web/s3.test.jsx
DeleteBucketLifecycleBucket page (Configuration documents, Remove)Bucket page › Configuration documents › Removetests/s3/test_objects.py (lifecycle round trip)
GetBucketCorsBucket page (Configuration documents)Bucket page › Configuration documentstests/s3/test_objects.py (documents)
PutBucketCorsBucket page (Configuration documents, Edit)Bucket page › Configuration documents › Edittests/s3/test_objects.py (cors round trip), tests/control/test_api.py, tests/web/s3.test.jsx
DeleteBucketCorsBucket page (Configuration documents, Remove)Bucket page › Configuration documents › Removetests/s3/test_objects.py (cors round trip), tests/control/test_api.py
GetBucketAclBucket page (Configuration documents)Bucket page › Configuration documentstests/s3/test_objects.py (documents), tests/control/test_api.py
PutBucketAclBucket page (Configuration documents, Edit)Bucket page › Configuration documents › Edit (ACL-enabled buckets)tests/s3/test_objects.py (ACL enabled/disabled), tests/web/s3.test.jsx
GetBucketTaggingBucket page (Properties)Bucket page › Propertiestests/s3/test_create.py, tests/control/test_api.py
PutBucketTaggingBucket page (Properties, Edit), Create page (tags)Create bucket page › Tags, Bucket page › Properties › Tags › Edittests/s3/test_create.py, tests/s3/test_objects.py, tests/control/test_api.py, tests/web/s3.test.jsx
DeleteBucketTaggingBucket page (Properties, Remove tags)Bucket page › Properties › Tags › Remove tagstests/s3/test_objects.py, tests/control/test_api.py, tests/web/s3.test.jsx
GetBucketPolicyBucket page (Configuration documents)Bucket page › Configuration documentstests/s3/test_objects.py (documents), tests/control/test_api.py
PutBucketPolicyBucket page (Configuration documents, Edit)Bucket page › Configuration documents › Edittests/s3/test_objects.py (policy round trip), tests/control/test_api.py, tests/web/s3.test.jsx
DeleteBucketPolicyBucket page (Configuration documents, Remove)Bucket page › Configuration documents › Removetests/s3/test_objects.py (policy round trip), tests/control/test_api.py
GetBucketNotificationConfigurationBucket page (Configuration documents)Bucket page › Configuration documentstests/s3/test_objects.py (documents)
PutBucketNotificationConfiguration——tests/s3/test_operations.py (EventBridge rule)
GetBucketLoggingBucket page (Configuration documents)Bucket page › Configuration documentstests/s3/test_objects.py (documents)
PutBucketLogging——tests/s3/test_operations.py (logging written and read)
PutPublicAccessBlockBucket page (Permissions, Save)Bucket page › Permissions › Savetests/s3/test_create.py
GetPublicAccessBlockBucket page (Permissions)Bucket page › Permissionstests/s3/test_create.py
DeletePublicAccessBlock——tests/s3/test_operations.py (access block removed)

Objects in depth​

OperationConsole actionShown in the consoleEmuplane test
ListObjectVersionsBucket page (Configuration documents)Bucket page › Configuration documentstests/s3/test_objects.py
CreateMultipartUpload——tests/s3/test_operations.py (multipart)
UploadPart——tests/s3/test_operations.py (multipart)
CompleteMultipartUpload——tests/s3/test_operations.py (multipart)
AbortMultipartUpload——tests/s3/test_operations.py (multipart aborted)
GetObjectTagging—Bucket page › Objects › open › Tagstests/s3/test_operations.py (object tags)
PutObjectTagging——tests/s3/test_operations.py (object tags)
DeleteObjectTagging——tests/s3/test_operations.py (object tags)
PutObjectAnnotation——tests/s3/test_operations.py (annotations)
GetObjectAnnotation—Bucket page › Objects › open › Annotations › nametests/s3/test_operations.py (annotations)
ListObjectAnnotations—Bucket page › Objects › open › Annotationstests/s3/test_operations.py (annotations)
DeleteObjectAnnotation——tests/s3/test_operations.py (annotations)

Object Lock​

OperationConsole actionShown in the consoleEmuplane test
PutObjectLockConfigurationCreate page (Object Lock)Create bucket page › Object Locktests/s3/test_create.py (at create)
GetObjectLockConfigurationCreate page (Copy settings)Create bucket page › Copy settingstests/s3/test_create.py
PutObjectRetention——tests/s3/test_operations.py (retention)
GetObjectRetention—Bucket page › Objects › open › Object Locktests/s3/test_operations.py (retention)
PutObjectLegalHold——tests/s3/test_operations.py (legal hold)
GetObjectLegalHold—Bucket page › Objects › open › Object Locktests/s3/test_operations.py (legal hold)

Replication and access points​

OperationConsole actionShown in the consoleEmuplane test
PutBucketReplication——tests/s3/test_operations.py (replication config)
GetBucketReplicationBucket page (Configuration documents)Bucket page › Configuration documentstests/s3/test_objects.py (documents)
DeleteBucketReplication——tests/s3/test_operations.py (replication removed)
CreateAccessPointAccess Points pageAccess Points page › Create access pointtests/s3/test_access_points.py, tests/control/test_access_point_api.py
GetAccessPointAccess Points pageAccess Points page › row detailstests/s3/test_access_points.py (row details)
ListAccessPointsAccess Points pageAccess Points page › General purpose bucketstests/s3/test_access_points.py, tests/control/test_access_point_api.py
DeleteAccessPointAccess Points pageAccess Points page › Deletetests/s3/test_access_points.py, tests/control/test_access_point_api.py
PutAccessPointPolicyAccess Points page (Edit policy)Access Points page › Edit policytests/s3/test_access_points.py, tests/control/test_access_point_api.py
GetAccessPointPolicyAccess Points page (Edit policy)Access Points page › Edit policytests/s3/test_access_points.py, tests/control/test_access_point_api.py
DeleteAccessPointPolicyAccess Points page (Remove policy)Access Points page › Remove policytests/s3/test_access_points.py, tests/control/test_access_point_api.py

Multi-Region Access Points and Object Lambda​

OperationConsole actionShown in the consoleEmuplane test
CreateMultiRegionAccessPointAccess Points page (Multi-Region create)Access Points page › Multi-Region › Createtests/s3/test_operations.py (MRAP create + describe), tests/control/test_mrap_create_api.py
DeleteMultiRegionAccessPointAccess Points page (Multi-Region delete)Access Points page › Multi-Region › Deletetests/s3/test_operations.py (MRAP deleted), tests/control/test_mrap_actions_api.py
PutMultiRegionAccessPointPolicyAccess Points page (Multi-Region edit policy)Access Points page › Multi-Region › Edit policytests/s3/test_operations.py (MRAP read + policy), tests/control/test_mrap_actions_api.py
DescribeMultiRegionAccessPointOperationAccess Points page (Multi-Region create)Access Points page › Multi-Region › Create (operation status)tests/s3/test_operations.py (MRAP create + describe), tests/control/test_mrap_create_api.py
GetMultiRegionAccessPoint—Access Points page › Multi-Region › View detailstests/s3/test_operations.py (MRAP read + policy)
GetMultiRegionAccessPointPolicy—Access Points page › Multi-Region › View detailstests/s3/test_operations.py (MRAP read + policy)
ListMultiRegionAccessPointsAccess Points page (Multi-Region tab)Access Points page › Multi-Regiontests/s3/test_access_points.py, tests/control/test_access_point_api.py
GetMultiRegionAccessPointRoutes—Access Points page › Multi-Region › View detailstests/s3/test_operations.py (MRAP routes)
SubmitMultiRegionAccessPointRoutesAccess Points page (Multi-Region traffic dials)Access Points page › Multi-Region › View details › Routes › Edit traffic dialstests/s3/test_operations.py (MRAP routes), tests/control/test_mrap_actions_api.py
CreateAccessPointForObjectLambda——tests/s3/test_operations.py (Object Lambda create + read)
GetAccessPointForObjectLambda—Access Points page › Object Lambda › View detailstests/s3/test_operations.py (Object Lambda create + read)
ListAccessPointsForObjectLambdaAccess Points page (Object Lambda tab)Access Points page › Object Lambdatests/s3/test_access_points.py, tests/control/test_access_point_api.py
DeleteAccessPointForObjectLambda——tests/s3/test_operations.py (Object Lambda deleted)
GetAccessPointConfigurationForObjectLambda—Access Points page › Object Lambda › View detailstests/s3/test_operations.py (Object Lambda configuration)
PutAccessPointConfigurationForObjectLambda——tests/s3/test_operations.py (Object Lambda configuration)
PutAccessPointPolicyForObjectLambda——tests/s3/test_operations.py (Object Lambda policy)
GetAccessPointPolicyForObjectLambda—Access Points page › Object Lambda › View detailstests/s3/test_operations.py (Object Lambda policy)
DeleteAccessPointPolicyForObjectLambda——tests/s3/test_operations.py (Object Lambda policy)
WriteGetObjectResponse——tests/s3/test_operations.py (unknown route refused)

GET operations​

  • ListBuckets — Buckets page › table
  • HeadBucket — Bucket page (HeadBucket decides the region)
  • GetObject — Bucket page › Objects › open
  • HeadObject — Bucket page › Objects › open (size, ETag, last modified)
  • ListObjects v1/v2 — Bucket page › Objects
  • GetBucketVersioning — Bucket page › Properties
  • GetBucketEncryption — Bucket page › Properties
  • GetBucketLifecycleConfiguration — Bucket page › Configuration documents
  • GetBucketCors — Bucket page › Configuration documents
  • GetBucketAcl — Bucket page › Configuration documents
  • GetBucketTagging — Bucket page › Properties
  • GetBucketPolicy — Bucket page › Configuration documents
  • GetBucketNotificationConfiguration — Bucket page › Configuration documents
  • GetBucketLogging — Bucket page › Configuration documents
  • ListObjectVersions — Bucket page › Configuration documents
  • GetObjectLockConfiguration — Create bucket page › Copy settings
  • GetObjectRetention — Bucket page › Objects › open › Object Lock
  • GetObjectLegalHold — Bucket page › Objects › open › Object Lock
  • GetBucketReplication — Bucket page › Configuration documents
  • GetObjectTagging — Bucket page › Objects › open › Tags
  • GetObjectAnnotation — Bucket page › Objects › open › Annotations › name
  • ListObjectAnnotations — Bucket page › Objects › open › Annotations
  • DescribeMultiRegionAccessPointOperation — Access Points page › Multi-Region › Create (operation status)
  • GetMultiRegionAccessPoint — Access Points page › Multi-Region › View details
  • GetMultiRegionAccessPointPolicy — Access Points page › Multi-Region › View details
  • ListMultiRegionAccessPoints — Access Points page › Multi-Region
  • GetMultiRegionAccessPointRoutes — Access Points page › Multi-Region › View details
  • GetAccessPoint — Access Points page › row details
  • ListAccessPoints — Access Points page › General purpose buckets
  • GetAccessPointPolicy — Access Points page › Edit policy
  • GetAccessPointForObjectLambda — Access Points page › Object Lambda › View details
  • ListAccessPointsForObjectLambda — Access Points page › Object Lambda
  • GetAccessPointConfigurationForObjectLambda — Access Points page › Object Lambda › View details
  • GetAccessPointPolicyForObjectLambda — Access Points page › Object Lambda › View details
  • GetPublicAccessBlock — Bucket page › Permissions