BeginInitiateMultipartUpload Method (request, callback, state)

Initiates the asynchronous execution of the InitiateMultipartUpload operation.

Declaration Syntax

public IAsyncResult BeginInitiateMultipartUpload(
	InitiateMultipartUploadRequest request,
	AsyncCallback callback,
	Object state
)

Parameters

request (InitiateMultipartUploadRequest): The InitiateMultipartUploadRequest that defines the parameters of the operation.

callback (AsyncCallback): An AsyncCallback delegate that is invoked when the operation completes.

state (Object): A user-defined state object that is passed to the callback procedure. Retrieve this object from within the callback procedure using the AsyncState property.

Return Value

An IAsyncResult that can be used to poll or wait for results, or both; this value is also needed when invoking EndInitiateMultipartUpload.

Remarks

The upload ID associates all the parts in the specific upload. You specify this upload ID in each of your subsequent Upload Part requests. You also include this upload ID in the final request to either complete, or abort the multipart upload request.

After you initiate a multipart upload and upload one or more parts, you must either complete or abort the multipart upload in order to stop getting charged for storage of the uploaded parts. Once you complete or abort the multipart upload, Amazon S3 will release the stored parts and stop charging you for their storage.

Exceptions

Exception	Condition
ArgumentNullException
WebException
AmazonS3Exception