Skip to main content

multipart_uploads

Creates, updates, deletes, gets or lists a multipart_uploads resource.

Overview​

Namemultipart_uploads
TypeResource
Idoci.object_storage.multipart_uploads

Fields​

The following fields are returned by SELECT queries:

Multipart uploads provide efficient and resilient uploads, especially for large objects. Multipart uploads also accommodate<br />objects that are too large for a single upload operation. With multipart uploads, individual parts of an object can be<br />uploaded in parallel to reduce the amount of time you spend uploading. Multipart uploads can also minimize the impact<br />of network failures by letting you retry a failed part upload instead of requiring you to retry an entire object upload.<br />See [Using Multipart Uploads](/Content/Object/Tasks/usingmultipartuploads.htm).<br /><br />To use any of the API operations, you must be authorized in an IAM policy. If you are not authorized,<br />talk to an administrator. If you are an administrator who needs to write policies to give users access, see<br />[Getting Started with Policies](/Content/Identity/Concepts/policygetstarted.htm).<br />

NameDatatypeDescription
bucketstringThe bucket in which the in-progress multipart upload is stored.
namespacestringThe Object Storage namespace in which the in-progress multipart upload is stored.
objectstringThe object name of the in-progress multipart upload.
storageTierstringThe storage tier that the object is stored in. (Standard, InfrequentAccess, Archive) (x-obmcs-top-level-enum: #/definitions/StorageTier)
timeCreatedstring (date-time)The date and time the upload was created, as described in [RFC 2616](https:​//tools.ietf.org/html/rfc2616#section-14.29).
uploadIdstringThe unique identifier for the in-progress multipart upload.

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
listselectnamespaceName, bucketName, regionlimit, page, opc-client-request-idLists all of the in-progress multipart uploads for the given bucket in the given Object Storage namespace.<br />
createinsertnamespaceName, bucketName, region, objectif-match, if-none-match, opc-client-request-id, opc-sse-customer-algorithm, opc-sse-customer-key, opc-sse-customer-key-sha256, opc-sse-kms-key-idStarts a new multipart upload to a specific object in the given bucket in the given namespace.<br /><br />See [Object Names](/Content/Object/Tasks/managingobjects.htm#namerequirements)<br />for object naming requirements.<br />

Parameters​

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
bucketNamestringThe name of the bucket. Avoid entering confidential information. Example: my-new-bucket1
namespaceNamestringThe Object Storage namespace used for the request.
regionstringOCI region identifier (e.g. us-ashburn-1, ap-sydney-1); resolves from OCI_REGION when not supplied in the query. (default: us-ashburn-1, x-stackQL-envVar: OCI_REGION)
if-matchstringThe entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload the resource.
if-none-matchstringThe entity tag (ETag) to avoid matching. The only valid value is '*', which indicates that the request should fail if the resource already exists.
limitintegerFor list pagination. The maximum number of results per page, or items to return in a paginated "List" call. For important details about how pagination works, see [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
opc-client-request-idstringThe client request ID for tracing.
opc-sse-customer-algorithmstringThe optional header that specifies "AES256" as the encryption algorithm. For more information, see [Using Your Own Keys for Server-Side Encryption](/Content/Object/Tasks/usingyourencryptionkeys.htm).
opc-sse-customer-keystringThe optional header that specifies the base64-encoded 256-bit encryption key to use to encrypt or decrypt the data. For more information, see [Using Your Own Keys for Server-Side Encryption](/Content/Object/Tasks/usingyourencryptionkeys.htm).
opc-sse-customer-key-sha256stringThe optional header that specifies the base64-encoded SHA256 hash of the encryption key. This value is used to check the integrity of the encryption key. For more information, see [Using Your Own Keys for Server-Side Encryption](/Content/Object/Tasks/usingyourencryptionkeys.htm).
opc-sse-kms-key-idstringThe [OCID](/Content/General/Concepts/identifiers.htm) of a master encryption key used to call the Key Management service to generate a data encryption key or to encrypt or decrypt a data encryption key.
pagestringFor list pagination. The value of the opc-next-page response header from the previous "List" call. For important details about how pagination works, see [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).

SELECT examples​

Lists all of the in-progress multipart uploads for the given bucket in the given Object Storage namespace.<br />

SELECT
bucket,
namespace,
object,
storageTier,
timeCreated,
uploadId
FROM oci.object_storage.multipart_uploads
WHERE namespaceName = '{{ namespaceName }}' -- required
AND bucketName = '{{ bucketName }}' -- required
AND region = '{{ region }}' -- required
AND limit = '{{ limit }}'
AND page = '{{ page }}'
AND opc-client-request-id = '{{ opc-client-request-id }}'
;

INSERT examples​

Starts a new multipart upload to a specific object in the given bucket in the given namespace.<br /><br />See [Object Names](/Content/Object/Tasks/managingobjects.htm#namerequirements)<br />for object naming requirements.<br />

INSERT INTO oci.object_storage.multipart_uploads (
cacheControl,
contentDisposition,
contentEncoding,
contentLanguage,
contentType,
metadata,
object,
storageTier,
namespaceName,
bucketName,
region,
if-match,
if-none-match,
opc-client-request-id,
opc-sse-customer-algorithm,
opc-sse-customer-key,
opc-sse-customer-key-sha256,
opc-sse-kms-key-id
)
SELECT 
'{{ cacheControl }}',
'{{ contentDisposition }}',
'{{ contentEncoding }}',
'{{ contentLanguage }}',
'{{ contentType }}',
'{{ metadata }}',
'{{ object }}' /* required */,
'{{ storageTier }}',
'{{ namespaceName }}',
'{{ bucketName }}',
'{{ region }}',
'{{ if-match }}',
'{{ if-none-match }}',
'{{ opc-client-request-id }}',
'{{ opc-sse-customer-algorithm }}',
'{{ opc-sse-customer-key }}',
'{{ opc-sse-customer-key-sha256 }}',
'{{ opc-sse-kms-key-id }}'
RETURNING
bucket,
namespace,
object,
storageTier,
timeCreated,
uploadId
;