Presign an S3 request

Returns one presigned S3 request for one object key. Send it before expiresAt, with the returned headers exactly. Operations other than GetObject need the editor role. Role: viewer or higher.

POST/v1/workspaces/{workspaceId}/buckets/{bucketId}/presign

Authentication

Send your Graphon API key with every request. The value is the whole API key that Graphon showed when you created it. See Authentication.

Authorization: Bearer <GRAPHON_API_KEY>

curl \
  --url "https://storage.beta.graphon.sh/v1/workspaces/wspq7ws2np5l8z4/buckets/bktA1b2C3d4E5/presign" \
  --header "Authorization: Bearer $GRAPHON_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"operation":"PutObject","key":"incidents/checkout-timeout.json","contentType":"application/json","lengthBytes":"2048"}'

Request

Loading your session…

Response

This operation does not return a response body.

Path parameters

workspaceIdstring

The workspace id.

bucketIdstring

The bucket id.

Request body

operationstring

One of: PutObject, GetObject, CreateMultipartUpload, UploadPart, CompleteMultipartUpload, AbortMultipartUpload.

keystring

The object key.

contentTypestring (optional)

The object content type. Used by PutObject, CreateMultipartUpload.

lengthBytesstring (optional)

The body size in bytes, as a string of digits. It is signed. Used by PutObject, UploadPart.

sha256string (optional)

The base64 SHA-256 of the body. Graphon Storage signs it and rejects other bytes. Used by PutObject, UploadPart.

metadataobject (optional)

The metadata of the new object, by key. Graphon Storage signs each pair as an x-amz-meta-<key> header. A key is 1 to 128 lowercase letters, digits, periods, underscores, or hyphens. A value is printable ASCII, at most 1,024 bytes, and keys plus values take at most 2,048 bytes. A metadata field of the bucket can filter search on a key. Used by PutObject, CreateMultipartUpload.

ifNoneMatchstring (optional)

Send * to create only. Graphon Storage rejects the PUT if the key exists. One of: *. Used by PutObject.

versionIdstring (optional)

The version to read. Used by GetObject.

uploadIdstring (optional)

The multipart upload id. Used by UploadPart, CompleteMultipartUpload, AbortMultipartUpload.

partNumberinteger (optional)

The part number, from 1 to 10000. Used by UploadPart.

Was this page helpful?

View as Markdown