UploadsApi
Last updated
Last updated
All URIs are relative to https://s3.eu-central-3.ionoscloud.com
Method | HTTP request | Description |
---|---|---|
AbortMultipartUpload
Other parameters are passed through a pointer to an apiAbortMultipartUploadRequest struct via the builder pattern
map[string]interface{}
Content-Type: Not defined
Accept: application/xmlaplication/xml
Each operation can use different server URL defined using OperationServers
map in the Configuration
. An operation is uniquely identified by "UploadsApiService.AbortMultipartUpload"
string. Similar rules for overriding default operation server index and variables apply by using sw.ContextOperationServerIndices
and sw.ContextOperationServerVariables
context maps.
CompleteMultipartUpload
Other parameters are passed through a pointer to an apiCompleteMultipartUploadRequest struct via the builder pattern
Content-Type: application/xml
Accept: application/xml
Each operation can use different server URL defined using OperationServers
map in the Configuration
. An operation is uniquely identified by "UploadsApiService.CompleteMultipartUpload"
string. Similar rules for overriding default operation server index and variables apply by using sw.ContextOperationServerIndices
and sw.ContextOperationServerVariables
context maps.
CreateMultipartUpload
Other parameters are passed through a pointer to an apiCreateMultipartUploadRequest struct via the builder pattern
Content-Type: Not defined
Accept: application/xml
Each operation can use different server URL defined using OperationServers
map in the Configuration
. An operation is uniquely identified by "UploadsApiService.CreateMultipartUpload"
string. Similar rules for overriding default operation server index and variables apply by using sw.ContextOperationServerIndices
and sw.ContextOperationServerVariables
context maps.
ListMultipartUploads
Other parameters are passed through a pointer to an apiListMultipartUploadsRequest struct via the builder pattern
Content-Type: Not defined
Accept: application/xml
Each operation can use different server URL defined using OperationServers
map in the Configuration
. An operation is uniquely identified by "UploadsApiService.ListMultipartUploads"
string. Similar rules for overriding default operation server index and variables apply by using sw.ContextOperationServerIndices
and sw.ContextOperationServerVariables
context maps.
ListParts
Other parameters are passed through a pointer to an apiListPartsRequest struct via the builder pattern
Content-Type: Not defined
Accept: application/xml
Each operation can use different server URL defined using OperationServers
map in the Configuration
. An operation is uniquely identified by "UploadsApiService.ListParts"
string. Similar rules for overriding default operation server index and variables apply by using sw.ContextOperationServerIndices
and sw.ContextOperationServerVariables
context maps.
UploadPart
Other parameters are passed through a pointer to an apiUploadPartRequest struct via the builder pattern
map[string]interface{}
Content-Type: application/xml
Accept: application/xml
Each operation can use different server URL defined using OperationServers
map in the Configuration
. An operation is uniquely identified by "UploadsApiService.UploadPart"
string. Similar rules for overriding default operation server index and variables apply by using sw.ContextOperationServerIndices
and sw.ContextOperationServerVariables
context maps.
UploadPartCopy
Other parameters are passed through a pointer to an apiUploadPartCopyRequest struct via the builder pattern
Content-Type: Not defined
Accept: application/xml
Each operation can use different server URL defined using OperationServers
map in the Configuration
. An operation is uniquely identified by "UploadsApiService.UploadPartCopy"
string. Similar rules for overriding default operation server index and variables apply by using sw.ContextOperationServerIndices
and sw.ContextOperationServerVariables
context maps.
Name | Type | Description | Notes |
---|---|---|---|
Name | Type | Description | Notes |
---|---|---|---|
Name | Type | Description | Notes |
---|---|---|---|
Name | Type | Description | Notes |
---|---|---|---|
Name | Type | Description | Notes |
---|---|---|---|
Name | Type | Description | Notes |
---|---|---|---|
Name | Type | Description | Notes |
---|---|---|---|
Name | Type | Description | Notes |
---|---|---|---|
Name | Type | Description | Notes |
---|---|---|---|
Name | Type | Description | Notes |
---|---|---|---|
Name | Type | Description | Notes |
---|---|---|---|
Name | Type | Description | Notes |
---|---|---|---|
Name | Type | Description | Notes |
---|---|---|---|
Name | Type | Description | Notes |
---|---|---|---|
Delete /{Bucket}/{Key}?uploadId
AbortMultipartUpload
Post /{Bucket}/{Key}?uploadId
CompleteMultipartUpload
Post /{Bucket}/{Key}?uploads
CreateMultipartUpload
Get /{Bucket}?uploads
ListMultipartUploads
Get /{Bucket}/{Key}?uploadId
ListParts
Put /{Bucket}/{Key}?uploadId
UploadPart
Put /{Bucket}/{Key}?x-amz-copy-source&partNumber&uploadId
UploadPartCopy
ctx
context.Context
context for authentication, logging, cancellation, deadlines, tracing, etc.
bucket
string
key
string
Key of the object for which the multipart upload was initiated. <p> Possible values: length ≥ 1 </p>
uploadId
string
Upload ID that identifies the multipart upload.
ctx
context.Context
context for authentication, logging, cancellation, deadlines, tracing, etc.
bucket
string
key
string
Object key for which the multipart upload was initiated.
uploadId
string
ID for the initiated multipart upload.
example
ctx
context.Context
context for authentication, logging, cancellation, deadlines, tracing, etc.
bucket
string
key
string
Object key for which the multipart upload is to be initiated.
uploads
bool
cacheControl
string
Specifies caching behavior along the request/reply chain.
contentDisposition
string
Specifies presentational information for the object.
contentEncoding
string
Specifies what content encodings have been applied to the object and thus what decoding mechanisms must be applied to obtain the media-type referenced by the Content-Type header field.
contentType
string
A standard MIME type describing the format of the object data.
expires
time.Time
The date and time at which the object is no longer cacheable.
xAmzServerSideEncryption
string
The server-side encryption algorithm used when storing this object in IONOS S3 Object Storage (AES256).
xAmzStorageClass
string
IONOS S3 Object Storage uses the STANDARD Storage Class to store newly created objects. The STANDARD storage class provides high durability and high availability.
xAmzWebsiteRedirectLocation
string
If the bucket is configured as a website, redirects requests for this object to another object in the same bucket or to an external URL. IONOS S3 Object Storage stores the value of this header in the object metadata.
xAmzServerSideEncryptionCustomerAlgorithm
string
Specifies the algorithm to use to when encrypting the object (AES256).
xAmzServerSideEncryptionCustomerKey
string
Specifies the customer-provided encryption key for IONOS S3 Object Storage to use in encrypting data. This value is used to store the object and then it is discarded; IONOS S3 Object Storage does not store the encryption key. The key must be appropriate for use with the algorithm specified in the `x-amz-server-side-encryption-customer-algorithm` header.
xAmzServerSideEncryptionCustomerKeyMD5
string
Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321. IONOS S3 Object Storage uses this header for a message integrity check to ensure that the encryption key was transmitted without error.
xAmzObjectLockMode
string
Specifies the Object Lock mode that you want to apply to the uploaded object.
xAmzObjectLockRetainUntilDate
time.Time
Specifies the date and time when you want the Object Lock to expire.
xAmzObjectLockLegalHold
string
Specifies whether you want to apply a Legal Hold to the uploaded object.
xAmzMeta
A map of metadata to store with the object in S3.
ctx
context.Context
context for authentication, logging, cancellation, deadlines, tracing, etc.
bucket
string
uploads
bool
delimiter
string
<p>Character you use to group keys.</p> <p>All keys that contain the same string between the prefix, if specified, and the first occurrence of the delimiter after the prefix are grouped under a single result element, `CommonPrefixes`. If you don't specify the prefix parameter, then the substring starts at the beginning of the key. The keys that are grouped under `CommonPrefixes` result element are not returned elsewhere in the response.</p>
encodingType
string
keyMarker
string
<p>Together with upload-id-marker, this parameter specifies the multipart upload after which listing should begin.</p> <p>If `upload-id-marker` is not specified, only the keys lexicographically greater than the specified `key-marker` will be included in the list.</p> <p>If `upload-id-marker` is specified, any multipart uploads for a key equal to the `key-marker` might also be included, provided those multipart uploads have upload IDs lexicographically greater than the specified `upload-id-marker`.</p>
maxUploads
int32
Sets the maximum number of multipart uploads, from 1 to 1,000, to return in the response body. 1,000 is the maximum number of uploads that can be returned in a response.
prefix
string
Lists in-progress uploads only for those keys that begin with the specified prefix. You can use prefixes to separate a bucket into different grouping of keys. (You can think of using prefix to make groups in the same way you'd use a folder in a file system.)
uploadIdMarker
string
Together with key-marker, specifies the multipart upload after which listing should begin. If key-marker is not specified, the upload-id-marker parameter is ignored. Otherwise, any multipart uploads for a key equal to the key-marker might be included in the list only if they have an upload ID lexicographically greater than the specified `upload-id-marker`.
maxUploads2
string
Pagination limit
keyMarker2
string
Pagination token
uploadIdMarker2
string
Pagination token
ctx
context.Context
context for authentication, logging, cancellation, deadlines, tracing, etc.
bucket
string
key
string
Object key for which the multipart upload was initiated.
uploadId
string
Upload ID identifying the multipart upload whose parts are being listed.
maxParts
int32
Sets the maximum number of parts to return.
partNumberMarker
int32
Specifies the part after which listing should begin. Only parts with higher part numbers will be listed.
partNumberMarker2
string
Pagination token
ctx
context.Context
context for authentication, logging, cancellation, deadlines, tracing, etc.
bucket
string
key
string
Object key for which the multipart upload was initiated.
partNumber
int32
Part number of part being uploaded. This is a positive integer between 1 and 10,000.
uploadId
string
Upload ID identifying the multipart upload whose part is being uploaded.
uploadPartRequest
contentLength
int32
Size of the body in bytes. This parameter is useful when the size of the body cannot be determined automatically.
contentMD5
string
xAmzServerSideEncryptionCustomerAlgorithm
string
Specifies the algorithm to use to when encrypting the object (AES256).
xAmzServerSideEncryptionCustomerKey
string
Specifies the customer-provided encryption key for IONOS S3 Object Storage to use in encrypting data. This value is used to store the object and then it is discarded; IONOS S3 Object Storage does not store the encryption key. The key must be appropriate for use with the algorithm specified in the `x-amz-server-side-encryption-customer-algorithm header`. This must be the same encryption key specified in the initiate multipart upload request.
xAmzServerSideEncryptionCustomerKeyMD5
string
Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321. IONOS S3 Object Storage uses this header for a message integrity check to ensure that the encryption key was transmitted without error.
ctx
context.Context
context for authentication, logging, cancellation, deadlines, tracing, etc.
bucket
string
key
string
Object key for which the multipart upload was initiated.
xAmzCopySource
string
<p>Specifies the source object for the copy operation. </p>
partNumber
int32
Part number of part being copied. This is a positive integer between 1 and 10,000.
uploadId
string
Upload ID identifying the multipart upload whose part is being copied.
xAmzCopySourceIfMatch
string
Copies the object if its entity tag (ETag) matches the specified tag.
xAmzCopySourceIfModifiedSince
time.Time
Copies the object if it has been modified since the specified time.
xAmzCopySourceIfNoneMatch
string
Copies the object if its entity tag (ETag) is different than the specified ETag.
xAmzCopySourceIfUnmodifiedSince
time.Time
Copies the object if it hasn't been modified since the specified time.
xAmzCopySourceRange
string
The range of bytes to copy from the source object. The range value must use the form bytes=first-last, where the first and last are the zero-based byte offsets to copy. For example, bytes=0-9 indicates that you want to copy the first 10 bytes of the source. You can copy a range only if the source object is greater than 5 MB.
xAmzServerSideEncryptionCustomerAlgorithm
string
Specifies the algorithm to use to when encrypting the object (AES256).