Create a URL for an object

post

https://api.linode.com/{apiVersion}/object-storage/buckets/{regionId}/{bucket}/object-url

Creates a pre-signed URL to access a single object in a bucket. Use it to share, create, or delete objects by using the appropriate HTTP method in your request body's method parameter.

📘
The request header sent in an Object Storage operation can't exceed eight KB in total size.

Permissions and scopes

To call this operation, you need the following:

OAuth scopes. Your user needs these scopes assigned. Learn more.
- Scopes: object_storage:read_write

Path Params

apiVersion

string

enum

required

Enum Call either the v4 URL, or v4beta for operations still in Beta.

Allowed:

regionId

string

required

Identifies a region where this bucket lives.

📘
You can use a clusterId in place of regionId in requests for buckets that you created using the legacy version of the API. Run List clusters to see each cluster id.

bucket

string

required

The bucket name.

Body Params

content_type

string | null

The expected Content-type header of the request this signed URL will be valid for. If provided, the Content-type header must be sent with the request when this URL is used, and must be the same as it was when the signed URL was created. Required for all methods except GET or DELETE.

expires_in

integer | null

360 to 3600

Defaults to 3600

How long this signed URL is valid, in seconds.

method

string

required

Defaults to GET

The HTTP method allowed to be used with the pre-signed URL.

name

string

required

The name of the object that will be accessed with the pre-signed URL. This object need not exist, and no error will be returned if it doesn't. This behavior is useful for generating pre-signed URLs to upload new objects to by setting the method to PUT.

Responses

Language

Credentials

Loading…

Response

Choose an example:

application/json

200The URL with which to access your object.

defaultSee Errors for the range of possible error response codes.