{"openapi":"3.0.0","info":{"description":"Amazon Simple Storage Service (S3) data-plane API: list and read buckets and objects, manage object versioning and multipart uploads, read and delete bucket configuration (ACLs, tags, encryption, lifecycle, policy, replication), plus presigned-URL generation for uploads and downloads","version":["v1"]},"servers":[{"description":"Amazon Simple Storage Service (S3) data-plane API: list and read buckets and objects, manage object versioning and multipart uploads, read and delete bucket configuration (ACLs, tags, encryption, lifecycle, policy, replication), plus presigned-URL generation for uploads and downloads","url":"https://api.apirails.com/awss3"}],"paths":{"/signed-url":{"get":{"tags":["Signed URL (Custom)"],"parameters":[{"name":"type","in":"query","description":"Request type","schema":{"type":"enum","example":"","items":{"type":"string","enum":["upload","get"]}}},{"name":"acl","in":"query","description":"ACL of the file object, only applicable for upload. Default: private","schema":{"type":"enum","example":"","items":{"type":"string","enum":["private","public-read","public-read-write","authenticated-read","aws-exec-read","bucket-owner-read","bucket-owner-full-control"]}}},{"name":"bucket","in":"query","description":"User's AWS S3 bucket name","required":true,"schema":{"type":"string","example":""}},{"name":"expires_in","in":"query","description":"Expire the signed url after this duration (in second). Default : 300 seconds","schema":{"type":"number","example":""}},{"name":"key_name","in":"query","description":"File name to be signed","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"","api_endpoint":"/awss3/signed-url"},"summary":"Generate signed url for AWS S3 (custom endpoint)","description":"API Rails custom endpoint (not an AWS S3 API reference operation) — Generate AWS S3 signed url for reading a file from S3 bucket.","security":[{"bearerAuth":[]}]}},"/buckets":{"get":{"tags":["Buckets"],"parameters":[{"name":"bucket-region","in":"query","description":"Limits the response to buckets that are located in the specified Amazon Web Services Region…","schema":{"type":"string","example":""}},{"name":"continuation-token","in":"query","description":"ContinuationToken indicates to Amazon S3 that the list is being continued on this bucket with a token…","schema":{"type":"string","example":""}},{"name":"max-buckets","in":"query","description":"Maximum number of buckets to be returned in response…","schema":{"type":"number","example":""}},{"name":"prefix","in":"query","description":"Limits the response to bucket names that begin with the specified bucket name prefix.","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html","api_endpoint":"https://s3.{region}.amazonaws.com/"},"summary":"List buckets","description":"List all buckets owned by the authenticated sender. S3 serves this at the service root; the portal path is /buckets because the bare provider root is reserved.","security":[{"bearerAuth":[]}]}},"/directory-buckets":{"get":{"tags":["Buckets"],"parameters":[{"name":"continuation-token","in":"query","description":"Continuation token from a previous ListDirectoryBuckets response, for paginated results","schema":{"type":"string","example":""}},{"name":"max-directory-buckets","in":"query","description":"Maximum number of directory buckets to return in the response","schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListDirectoryBuckets.html","api_endpoint":"https://s3express-control.{region}.amazonaws.com/"},"summary":"List directory buckets","description":"List directory buckets (S3 Express One Zone). Served at the root of the S3 Express control-plane host; inputs are query parameters. Requires the s3express:ListAllMyDirectoryBuckets permission.","security":[{"bearerAuth":[]}]}},"/{bucket}":{"get":{"tags":["Objects"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}},{"name":"continuation-token","in":"query","description":"ContinuationToken indicates to Amazon S3 that the list is being continued on this bucket with a token…","schema":{"type":"string","example":""}},{"name":"delimiter","in":"query","description":"A delimiter is a character that you use to group keys…","schema":{"type":"string","example":""}},{"name":"encoding-type","in":"query","description":"Encoding type used by Amazon S3 to encode the object keys in the response…","schema":{"type":"string","example":""}},{"name":"fetch-owner","in":"query","description":"The owner field is not present in ListObjectsV2 by default…","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"max-keys","in":"query","description":"Sets the maximum number of keys returned in the response…","schema":{"type":"number","example":""}},{"name":"prefix","in":"query","description":"Limits the response to keys that begin with the specified prefix…","schema":{"type":"string","example":""}},{"name":"start-after","in":"query","description":"StartAfter is where you want Amazon S3 to start listing from…","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectsV2.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?list-type=2"},"summary":"List objects in a bucket","description":"Returns some or all (up to 1,000) of the objects in a bucket with each request.","security":[{"bearerAuth":[]}]},"delete":{"tags":["Buckets"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/"},"summary":"Delete empty bucket","description":"Deletes the S3 bucket.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/{bucket}/abac":{"get":{"tags":["ABAC"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAbac.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?abac"},"summary":"Get bucket ABAC policy status","description":"Returns the attribute-based access control (ABAC) property of the general purpose bucket.","security":[{"bearerAuth":[]}]}},"/{bucket}/accelerate":{"get":{"tags":["Accelerate"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAccelerateConfiguration.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?accelerate"},"summary":"Get bucket transfer acceleration status","description":"This implementation of the GET action uses the accelerate subresource to return the Transfer Acceleration state of a bucket, which is either Enabled or Suspended .","security":[{"bearerAuth":[]}]}},"/{bucket}/acl":{"get":{"tags":["Access Control"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAcl.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?acl"},"summary":"Get bucket ACL","description":"This implementation of the GET action uses the acl subresource to return the access control list (ACL) of a bucket.","security":[{"bearerAuth":[]}]}},"/{bucket}/analytics":{"get":{"tags":["Analytics Configurations"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"query","description":"The ID that identifies the analytics configuration.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAnalyticsConfiguration.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?analytics"},"summary":"Get bucket analytics configuration","description":"This implementation of the GET action returns an analytics configuration (identified by the analytics configuration ID) from the bucket.","security":[{"bearerAuth":[]}]},"delete":{"tags":["Analytics Configurations"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"query","description":"The ID that identifies the analytics configuration.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketAnalyticsConfiguration.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?analytics"},"summary":"Delete bucket analytics configuration","description":"Deletes an analytics configuration for the bucket (specified by the analytics configuration ID).","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/{bucket}/analytics-configurations":{"get":{"tags":["Analytics Configurations"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}},{"name":"continuation-token","in":"query","description":"The ContinuationToken that represents a placeholder from where this request should begin.","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketAnalyticsConfigurations.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?analytics"},"summary":"List bucket analytics configurations","description":"Lists the analytics configurations for the bucket.","security":[{"bearerAuth":[]}]}},"/{bucket}/cors":{"get":{"tags":["Access Control"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketCors.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?cors"},"summary":"Get bucket CORS configuration","description":"Returns the Cross-Origin Resource Sharing (CORS) configuration information set for the bucket.","security":[{"bearerAuth":[]}]},"delete":{"tags":["Access Control"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketCors.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?cors"},"summary":"Delete bucket CORS configuration","description":"Deletes the cors configuration information set for the bucket.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/{bucket}/encryption":{"get":{"tags":["Encryption"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?encryption"},"summary":"Get bucket encryption configuration","description":"Returns the default encryption configuration for an Amazon S3 bucket.","security":[{"bearerAuth":[]}]},"delete":{"tags":["Encryption"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?encryption"},"summary":"Delete bucket encryption configuration","description":"This implementation of the DELETE action resets the default encryption for the bucket as server-side encryption with Amazon S3 managed keys (SSE-S3).","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/{bucket}/intelligent-tiering":{"get":{"tags":["Intelligent Tiering"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"query","description":"The ID used to identify the S3 Intelligent-Tiering configuration.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketIntelligentTieringConfiguration.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?intelligent-tiering"},"summary":"Get bucket intelligent tiering configuration","description":"Gets the S3 Intelligent-Tiering configuration from the specified bucket.","security":[{"bearerAuth":[]}]},"delete":{"tags":["Intelligent Tiering"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"query","description":"The ID used to identify the S3 Intelligent-Tiering configuration.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketIntelligentTieringConfiguration.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?intelligent-tiering"},"summary":"Delete bucket intelligent tiering configuration","description":"Deletes the S3 Intelligent-Tiering configuration from the specified bucket.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/{bucket}/intelligent-tiering-configurations":{"get":{"tags":["Intelligent Tiering"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}},{"name":"continuation-token","in":"query","description":"The ContinuationToken that represents a placeholder from where this request should begin.","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketIntelligentTieringConfigurations.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?intelligent-tiering"},"summary":"List bucket intelligent tiering configurations","description":"Lists the S3 Intelligent-Tiering configuration from the specified bucket.","security":[{"bearerAuth":[]}]}},"/{bucket}/inventory":{"get":{"tags":["Inventory Configurations"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"query","description":"The ID used to identify the inventory configuration.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketInventoryConfiguration.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?inventory"},"summary":"Get bucket inventory configuration","description":"Returns an S3 Inventory configuration (identified by the inventory configuration ID) from the bucket.","security":[{"bearerAuth":[]}]},"delete":{"tags":["Inventory Configurations"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"query","description":"The ID used to identify the inventory configuration.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketInventoryConfiguration.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?inventory"},"summary":"Delete bucket inventory configuration","description":"Deletes an S3 Inventory configuration (identified by the inventory ID) from the bucket.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/{bucket}/inventory-configurations":{"get":{"tags":["Inventory Configurations"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}},{"name":"continuation-token","in":"query","description":"The marker used to continue an inventory configuration listing that has been truncated…","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketInventoryConfigurations.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?inventory"},"summary":"List bucket inventory configurations","description":"Returns a list of S3 Inventory configurations for the bucket.","security":[{"bearerAuth":[]}]}},"/{bucket}/lifecycle":{"get":{"tags":["Lifecycle"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?lifecycle"},"summary":"Get bucket lifecycle configuration","description":"Returns the lifecycle configuration information set on the bucket.","security":[{"bearerAuth":[]}]},"delete":{"tags":["Lifecycle"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?lifecycle"},"summary":"Delete bucket lifecycle configuration","description":"Deletes the lifecycle configuration from the specified bucket.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/{bucket}/location":{"get":{"tags":["Buckets"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLocation.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?location"},"summary":"Get bucket region","description":"Using the GetBucketLocation operation is no longer a best practice.","security":[{"bearerAuth":[]}]}},"/{bucket}/logging":{"get":{"tags":["Logging"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLogging.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?logging"},"summary":"Get bucket logging configuration","description":"Returns the logging status of a bucket and the permissions users have to view and modify that status.","security":[{"bearerAuth":[]}]}},"/{bucket}/metadata-configuration":{"get":{"tags":["S3 Metadata"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetadataConfiguration.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?metadataConfiguration"},"summary":"Get bucket metadata configuration","description":"Retrieves the S3 Metadata configuration for a general purpose bucket.","security":[{"bearerAuth":[]}]},"delete":{"tags":["S3 Metadata"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetadataConfiguration.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?metadataConfiguration"},"summary":"Delete bucket metadata configuration","description":"Deletes an S3 Metadata configuration from a general purpose bucket.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/{bucket}/metadata-table":{"get":{"tags":["S3 Metadata"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetadataTableConfiguration.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?metadataTable"},"summary":"Get bucket metadata table configuration","description":"We recommend that you retrieve your S3 Metadata configurations by using the V2 GetBucketMetadataTableConfiguration API operation.","security":[{"bearerAuth":[]}]},"delete":{"tags":["S3 Metadata"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetadataTableConfiguration.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?metadataTable"},"summary":"Delete bucket metadata table configuration","description":"We recommend that you delete your S3 Metadata configurations by using the V2 DeleteBucketMetadataTableConfiguration API operation.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/{bucket}/metrics":{"get":{"tags":["Metrics Configurations"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"query","description":"The ID used to identify the metrics configuration…","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetricsConfiguration.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?metrics"},"summary":"Get bucket metrics configuration","description":"Gets a metrics configuration (specified by the metrics configuration ID) from the bucket.","security":[{"bearerAuth":[]}]},"delete":{"tags":["Metrics Configurations"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"query","description":"The ID used to identify the metrics configuration…","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetricsConfiguration.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?metrics"},"summary":"Delete bucket metrics configuration","description":"Deletes a metrics configuration for the Amazon CloudWatch request metrics (specified by the metrics configuration ID) from the bucket.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/{bucket}/metrics-configurations":{"get":{"tags":["Metrics Configurations"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}},{"name":"continuation-token","in":"query","description":"The marker that is used to continue a metrics configuration listing that has been truncated…","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketMetricsConfigurations.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?metrics"},"summary":"List bucket metrics configurations","description":"Lists the metrics configurations for the bucket.","security":[{"bearerAuth":[]}]}},"/{bucket}/multipart-uploads":{"get":{"tags":["Multipart Uploads"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}},{"name":"delimiter","in":"query","description":"Character you use to group keys…","schema":{"type":"string","example":""}},{"name":"encoding-type","in":"query","description":"Encoding type used by Amazon S3 to encode the object keys in the response…","schema":{"type":"string","example":""}},{"name":"key-marker","in":"query","description":"Specifies the multipart upload after which listing should begin…","schema":{"type":"string","example":""}},{"name":"max-uploads","in":"query","description":"Sets the maximum number of multipart uploads, from 1 to 1,000, to return in the response body…","schema":{"type":"number","example":""}},{"name":"prefix","in":"query","description":"Lists in-progress uploads only for those keys that begin with the specified prefix…","schema":{"type":"string","example":""}},{"name":"upload-id-marker","in":"query","description":"Together with key-marker, specifies the multipart upload after which listing should begin…","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?uploads"},"summary":"List in-progress multipart uploads","description":"This operation lists in-progress multipart uploads in a bucket.","security":[{"bearerAuth":[]}]}},"/{bucket}/notification":{"get":{"tags":["Notifications"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketNotificationConfiguration.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?notification"},"summary":"Get bucket notification configuration","description":"Returns the notification configuration of a bucket.","security":[{"bearerAuth":[]}]}},"/{bucket}/object-lock":{"get":{"tags":["Object Lock"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectLockConfiguration.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?object-lock"},"summary":"Get bucket object lock configuration","description":"Gets the Object Lock configuration for a bucket.","security":[{"bearerAuth":[]}]}},"/{bucket}/ownership-controls":{"get":{"tags":["Ownership"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketOwnershipControls.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?ownershipControls"},"summary":"Get bucket ownership controls","description":"Retrieves OwnershipControls for an Amazon S3 bucket.","security":[{"bearerAuth":[]}]},"delete":{"tags":["Ownership"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketOwnershipControls.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?ownershipControls"},"summary":"Delete bucket ownership controls","description":"Removes OwnershipControls for an Amazon S3 bucket.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/{bucket}/policy":{"get":{"tags":["Policy"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketPolicy.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?policy"},"summary":"Get bucket policy","description":"Returns the policy of a specified bucket.","security":[{"bearerAuth":[]}]},"delete":{"tags":["Policy"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketPolicy.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?policy"},"summary":"Delete bucket policy","description":"Deletes the policy of a specified bucket.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/{bucket}/policy-status":{"get":{"tags":["Policy"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketPolicyStatus.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?policyStatus"},"summary":"Get bucket policy status","description":"Retrieves the policy status for an Amazon S3 bucket, indicating whether the bucket is public.","security":[{"bearerAuth":[]}]}},"/{bucket}/public-access-block":{"get":{"tags":["Public Access Block"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetPublicAccessBlock.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?publicAccessBlock"},"summary":"Get bucket public access block","description":"Retrieves the PublicAccessBlock configuration for an Amazon S3 bucket.","security":[{"bearerAuth":[]}]},"delete":{"tags":["Public Access Block"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeletePublicAccessBlock.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?publicAccessBlock"},"summary":"Delete bucket public access block","description":"Removes the PublicAccessBlock configuration for an Amazon S3 bucket.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/{bucket}/replication":{"get":{"tags":["Replication"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketReplication.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?replication"},"summary":"Get bucket replication configuration","description":"Returns the replication configuration of a bucket.","security":[{"bearerAuth":[]}]},"delete":{"tags":["Replication"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketReplication.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?replication"},"summary":"Delete bucket replication configuration","description":"Deletes the replication configuration from the bucket.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/{bucket}/request-payment":{"get":{"tags":["Request Payment"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketRequestPayment.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?requestPayment"},"summary":"Get bucket request payer configuration","description":"Returns the request payment configuration of a bucket.","security":[{"bearerAuth":[]}]}},"/{bucket}/tagging":{"get":{"tags":["Bucket Tagging"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketTagging.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?tagging"},"summary":"Get bucket tags","description":"Returns the tag set associated with the general purpose bucket.","security":[{"bearerAuth":[]}]},"delete":{"tags":["Bucket Tagging"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketTagging.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?tagging"},"summary":"Delete bucket tags","description":"Deletes tags from the general purpose bucket if attribute based access control (ABAC) is not enabled for the bucket.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/{bucket}/versioning":{"get":{"tags":["Object Versioning"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?versioning"},"summary":"Get bucket versioning configuration","description":"Returns the versioning state of a bucket.","security":[{"bearerAuth":[]}]}},"/{bucket}/versions":{"get":{"tags":["Object Versioning"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}},{"name":"delimiter","in":"query","description":"A delimiter is a character that you specify to group keys…","schema":{"type":"string","example":""}},{"name":"encoding-type","in":"query","description":"Encoding type used by Amazon S3 to encode the object keys in the response…","schema":{"type":"string","example":""}},{"name":"key-marker","in":"query","description":"Specifies the key to start with when listing objects in a bucket.","schema":{"type":"string","example":""}},{"name":"max-keys","in":"query","description":"Sets the maximum number of keys returned in the response…","schema":{"type":"number","example":""}},{"name":"prefix","in":"query","description":"Use this parameter to select only those keys that begin with the specified prefix…","schema":{"type":"string","example":""}},{"name":"version-id-marker","in":"query","description":"Specifies the object version you want to start listing from.","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectVersions.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?versions"},"summary":"List object versions","description":"Returns metadata about all versions of the objects in a bucket.","security":[{"bearerAuth":[]}]}},"/{bucket}/website":{"get":{"tags":["Website"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketWebsite.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?website"},"summary":"Get bucket website configuration","description":"Returns the website configuration for a bucket.","security":[{"bearerAuth":[]}]},"delete":{"tags":["Website"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketWebsite.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/?website"},"summary":"Delete bucket website configuration","description":"This action removes the website configuration for a bucket.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/{bucket}/object/{key(.+)}/acl":{"get":{"tags":["Access Control"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}},{"name":"key","in":"path","description":"Object key (may contain slashes)","required":true,"schema":{"type":"string","example":""}},{"name":"versionId","in":"query","description":"Version ID used to reference a specific version of the object…","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/{key}?acl"},"summary":"Get object ACL","description":"Returns the access control list (ACL) of an object.","security":[{"bearerAuth":[]}]}},"/{bucket}/object/{key(.+)}/annotation":{"get":{"tags":["Annotations"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}},{"name":"key","in":"path","description":"Object key (may contain slashes)","required":true,"schema":{"type":"string","example":""}},{"name":"annotationName","in":"query","description":"The name of the annotation to retrieve…","required":true,"schema":{"type":"string","example":""}},{"name":"versionId","in":"query","description":"The version ID of the object.","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAnnotation.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/{key}?annotation"},"summary":"Get object annotation","description":"Retrieves an annotation from an Amazon S3 object.","security":[{"bearerAuth":[]}]},"delete":{"tags":["Annotations"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}},{"name":"key","in":"path","description":"Object key (may contain slashes)","required":true,"schema":{"type":"string","example":""}},{"name":"annotationName","in":"query","description":"The name of the annotation to delete…","required":true,"schema":{"type":"string","example":""}},{"name":"versionId","in":"query","description":"The version ID of the object.","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObjectAnnotation.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/{key}?annotation"},"summary":"Delete object annotation","description":"Deletes a specific annotation from an Amazon S3 object.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/{bucket}/object/{key(.+)}/annotations":{"get":{"tags":["Annotations"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}},{"name":"key","in":"path","description":"Object key (may contain slashes)","required":true,"schema":{"type":"string","example":""}},{"name":"annotation-prefix","in":"query","description":"Filter results to annotations whose name begins with the specified prefix.","schema":{"type":"string","example":""}},{"name":"continuation-token","in":"query","description":"Continuation token returned by a previous request to retrieve the next page.","schema":{"type":"string","example":""}},{"name":"max-annotation-results","in":"query","description":"The maximum number of annotations to return in the response…","schema":{"type":"number","example":""}},{"name":"versionId","in":"query","description":"The version ID of the object.","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectAnnotations.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/{key}?annotation"},"summary":"List object annotations","description":"Lists the annotations attached to an Amazon S3 object.","security":[{"bearerAuth":[]}]}},"/{bucket}/object/{key(.+)}/attributes":{"get":{"tags":["Objects"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}},{"name":"key","in":"path","description":"Object key (may contain slashes)","required":true,"schema":{"type":"string","example":""}},{"name":"versionId","in":"query","description":"The version ID used to reference a specific version of the object…","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/{key}?attributes"},"summary":"Get object attributes","description":"Retrieves all of the metadata from an object without returning the object itself.","security":[{"bearerAuth":[]}]}},"/{bucket}/object/{key(.+)}/legal-hold":{"get":{"tags":["Object Lock"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}},{"name":"key","in":"path","description":"Object key (may contain slashes)","required":true,"schema":{"type":"string","example":""}},{"name":"versionId","in":"query","description":"The version ID of the object whose legal hold status you want to retrieve.","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectLegalHold.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/{key}?legal-hold"},"summary":"Get object legal hold status","description":"Gets an object's current legal hold status.","security":[{"bearerAuth":[]}]}},"/{bucket}/object/{key(.+)}/multipart-upload":{"delete":{"tags":["Multipart Uploads"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}},{"name":"key","in":"path","description":"Object key (may contain slashes)","required":true,"schema":{"type":"string","example":""}},{"name":"uploadId","in":"query","description":"Upload ID that identifies the multipart upload.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/{key}"},"summary":"Abort multipart upload","description":"This operation aborts a multipart upload.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/{bucket}/object/{key(.+)}/multipart-uploads":{"post":{"tags":["Multipart Uploads"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}},{"name":"key","in":"path","description":"Object key (may contain slashes)","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/{key}?uploads"},"summary":"Create multipart upload","description":"End of support notice: As of October 1, 2025, Amazon S3 has discontinued support for Email Grantee Access Control Lists (ACLs).","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/{bucket}/object/{key(.+)}/parts":{"get":{"tags":["Multipart Uploads"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}},{"name":"key","in":"path","description":"Object key (may contain slashes)","required":true,"schema":{"type":"string","example":""}},{"name":"max-parts","in":"query","description":"Sets the maximum number of parts to return.","schema":{"type":"number","example":""}},{"name":"part-number-marker","in":"query","description":"Specifies the part after which listing should begin…","schema":{"type":"number","example":""}},{"name":"uploadId","in":"query","description":"Upload ID identifying the multipart upload whose parts are being listed.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/{key}"},"summary":"List uploaded parts","description":"Lists the parts that have been uploaded for a specific multipart upload.","security":[{"bearerAuth":[]}]}},"/{bucket}/object/{key(.+)}/retention":{"get":{"tags":["Object Lock"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}},{"name":"key","in":"path","description":"Object key (may contain slashes)","required":true,"schema":{"type":"string","example":""}},{"name":"versionId","in":"query","description":"The version ID for the object whose retention settings you want to retrieve.","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectRetention.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/{key}?retention"},"summary":"Get object retention settings","description":"Retrieves an object's retention settings.","security":[{"bearerAuth":[]}]}},"/{bucket}/object/{key(.+)}/tagging":{"get":{"tags":["Object Tagging"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}},{"name":"key","in":"path","description":"Object key (may contain slashes)","required":true,"schema":{"type":"string","example":""}},{"name":"versionId","in":"query","description":"The versionId of the object for which to get the tagging information.","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/{key}?tagging"},"summary":"Get object tags","description":"Returns the tag-set of an object.","security":[{"bearerAuth":[]}]},"delete":{"tags":["Object Tagging"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}},{"name":"key","in":"path","description":"Object key (may contain slashes)","required":true,"schema":{"type":"string","example":""}},{"name":"versionId","in":"query","description":"The versionId of the object that the tag-set will be removed from.","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObjectTagging.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/{key}?tagging"},"summary":"Delete object tags","description":"Removes the entire tag set from the specified object.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/{bucket}/object/{key(.+)}/torrent":{"get":{"tags":["Objects"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}},{"name":"key","in":"path","description":"Object key (may contain slashes)","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTorrent.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/{key}?torrent"},"summary":"Get object torrent (legacy)","description":"Returns torrent files from a bucket.","security":[{"bearerAuth":[]}]}},"/{bucket}/object/{key(.+)}":{"get":{"tags":["Objects"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}},{"name":"key","in":"path","description":"Object key (may contain slashes)","required":true,"schema":{"type":"string","example":""}},{"name":"partNumber","in":"query","description":"Part number of the object being read…","schema":{"type":"number","example":""}},{"name":"response-cache-control","in":"query","description":"Sets the Cache-Control header of the response.","schema":{"type":"string","example":""}},{"name":"response-content-disposition","in":"query","description":"Sets the Content-Disposition header of the response.","schema":{"type":"string","example":""}},{"name":"response-content-encoding","in":"query","description":"Sets the Content-Encoding header of the response.","schema":{"type":"string","example":""}},{"name":"response-content-language","in":"query","description":"Sets the Content-Language header of the response.","schema":{"type":"string","example":""}},{"name":"response-content-type","in":"query","description":"Sets the Content-Type header of the response.","schema":{"type":"string","example":""}},{"name":"response-expires","in":"query","description":"Sets the Expires header of the response.","schema":{"type":"string","example":""}},{"name":"versionId","in":"query","description":"Version ID used to reference a specific version of the object…","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/{key}"},"summary":"Get object","description":"Retrieves an object from Amazon S3.","security":[{"bearerAuth":[]}]},"delete":{"tags":["Objects"],"parameters":[{"name":"bucket","in":"path","description":"Name of the general purpose bucket","required":true,"schema":{"type":"string","example":""}},{"name":"key","in":"path","description":"Object key (may contain slashes)","required":true,"schema":{"type":"string","example":""}},{"name":"versionId","in":"query","description":"Version ID used to reference a specific version of the object…","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html","api_endpoint":"https://{bucket}.s3.{region}.amazonaws.com/{key}"},"summary":"Delete object","description":"Removes an object from a bucket.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}]}