# objects-api ## Pages - [Object Storage API](https://docs.ezghcloud.com/objects-api/index.md) — Buckets, access keys and bucket settings for EZGH Object Storage. Objects are stored and fetched with standard S3 tools at s3.us-west-1.ezghapps.com. - [Create an access key](https://docs.ezghcloud.com/objects-api/CreateAccessKey/index.md) — Its secret is in this answer and never again. An access key acts with its owner's access: the caller's, or the bot's named in bot. - [Create a bucket](https://docs.ezghcloud.com/objects-api/CreateBucket/index.md) — Synchronous. The name is unique across EZGH; a deleted bucket's name stays its organization's for 30 days. 409 bucket_already_exists when it's taken. - [Delete an empty bucket](https://docs.ezghcloud.com/objects-api/DeleteBucket/index.md) — Synchronous. 409 bucket_not_empty when it holds objects. - [Return a bucket to SSE-EZGH](https://docs.ezghcloud.com/objects-api/DeleteBucketEncryption/index.md) — New objects use SSE-EZGH; older objects keep the key they were written with. A bucket is never without a default. Takes If-Match, and answers 412 precondition_failed when it's stale. - [Delete an object](https://docs.ezghcloud.com/objects-api/DeleteObject/index.md) - [Get an access key](https://docs.ezghcloud.com/objects-api/GetAccessKey/index.md) - [Get a bucket](https://docs.ezghcloud.com/objects-api/GetBucket/index.md) - [Get a bucket's lifecycle rules](https://docs.ezghcloud.com/objects-api/GetBucketLifecycle/index.md) — Answers an ETag. A bucket with no rules answers an empty list. - [Get a bucket's settings](https://docs.ezghcloud.com/objects-api/GetBucketSettings/index.md) — Answers an ETag. - [Get what a bucket stores](https://docs.ezghcloud.com/objects-api/GetBucketUsage/index.md) - [Get an object's metadata](https://docs.ezghcloud.com/objects-api/GetObject/index.md) - [Download an object](https://docs.ezghcloud.com/objects-api/GetObjectContent/index.md) — Always an attachment, as application/octet-stream. - [List a project's access keys, newest first](https://docs.ezghcloud.com/objects-api/ListAccessKeys/index.md) - [List a project's buckets, newest first](https://docs.ezghcloud.com/objects-api/ListBuckets/index.md) - [List a bucket's object versions and delete markers, in key order, each key's newest first](https://docs.ezghcloud.com/objects-api/ListObjectVersions/index.md) - [List a bucket's objects, in key order](https://docs.ezghcloud.com/objects-api/ListObjects/index.md) - [Change a bucket's default encryption](https://docs.ezghcloud.com/objects-api/PutBucketEncryption/index.md) — Sets a customer key from Keys, or returns the bucket to SSE-EZGH. New objects use it; older objects keep the key they were written with. The caller needs keys.keys.generateDataKey and keys.keys.decrypt on a customer key. Takes If-Match, and answers 412 precondition_failed when it's stale; 409 key_not_usable when the key can't be a default. - [Replace a bucket's lifecycle rules](https://docs.ezghcloud.com/objects-api/PutBucketLifecycle/index.md) — Replaces the whole list; an empty list removes every rule. Objects a rule expires are deleted within a day after they qualify, permanently. Setting rules needs objects.objects.delete as well as objects.buckets.update; removing them needs only objects.buckets.update. Takes If-Match, and answers 412 precondition_failed when it's stale. - [Turn a bucket's versioning on, or suspend it](https://docs.ezghcloud.com/objects-api/PutBucketVersioning/index.md) — Enabled, every write keeps the versions before it and a delete adds a delete marker. Suspended, existing versions stay and new writes replace the current one. A bucket that has had versioning never returns to null. - [Revoke an access key](https://docs.ezghcloud.com/objects-api/RevokeAccessKey/index.md) — It stops working at once, presigned links included. - [Replace a bucket's settings](https://docs.ezghcloud.com/objects-api/UpdateBucketSettings/index.md) — Takes If-Match, and answers 412 precondition_failed when it's stale. - [AccessKey](https://docs.ezghcloud.com/objects-api/schemas/AccessKey/index.md) - [AccessKeyCreate](https://docs.ezghcloud.com/objects-api/schemas/AccessKeyCreate/index.md) - [AccessKeyCreated](https://docs.ezghcloud.com/objects-api/schemas/AccessKeyCreated/index.md) - [AccessKeyList](https://docs.ezghcloud.com/objects-api/schemas/AccessKeyList/index.md) - [AccessKeyOwner](https://docs.ezghcloud.com/objects-api/schemas/AccessKeyOwner/index.md) - [Bucket](https://docs.ezghcloud.com/objects-api/schemas/Bucket/index.md) - [BucketCreate](https://docs.ezghcloud.com/objects-api/schemas/BucketCreate/index.md) - [BucketEncryption](https://docs.ezghcloud.com/objects-api/schemas/BucketEncryption/index.md) - [BucketLifecycle](https://docs.ezghcloud.com/objects-api/schemas/BucketLifecycle/index.md) - [BucketList](https://docs.ezghcloud.com/objects-api/schemas/BucketList/index.md) - [BucketSettings](https://docs.ezghcloud.com/objects-api/schemas/BucketSettings/index.md) - [BucketUsage](https://docs.ezghcloud.com/objects-api/schemas/BucketUsage/index.md) - [BucketVersioning](https://docs.ezghcloud.com/objects-api/schemas/BucketVersioning/index.md) - [CorsRule](https://docs.ezghcloud.com/objects-api/schemas/CorsRule/index.md) - [Error](https://docs.ezghcloud.com/objects-api/schemas/Error/index.md) — Every non-2xx answer. Clients branch on code, never on message. - [LifecycleRule](https://docs.ezghcloud.com/objects-api/schemas/LifecycleRule/index.md) — A rule needs expirationDays, expirationDate, abortIncompleteMultipartUploadDays, noncurrentVersionExpirationDays or expiredObjectDeleteMarker, and takes at most one of expirationDays and expirationDate. Every field is present in a response. - [Object](https://docs.ezghcloud.com/objects-api/schemas/Object/index.md) - [ObjectList](https://docs.ezghcloud.com/objects-api/schemas/ObjectList/index.md) - [ObjectVersion](https://docs.ezghcloud.com/objects-api/schemas/ObjectVersion/index.md) - [ObjectVersionList](https://docs.ezghcloud.com/objects-api/schemas/ObjectVersionList/index.md) - [QuotaExceeded](https://docs.ezghcloud.com/objects-api/schemas/QuotaExceeded/index.md) — quota_exceeded: the quota that refused the request. Never with Retry-After.