API

Create a URL for an object

post
https://api.linode.com//object-storage/buckets///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.

Permissions and scopes

To call this operation, you need permissions, based on the model you're using:

  • OAuth scopes. Your user needs these scopes assigned. Learn more.

    • Scopes: object_storage:read_write
Path Params
string
enum
required

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

Allowed:
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.

string
required

The bucket name.

Body Params
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.

integer | null
360 to 3600
Defaults to 3600

How long this signed URL is valid, in seconds.

string
required
Defaults to GET

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

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

Updated 16 days ago

Language
Credentials
LoadingLoading…
Response
Choose an example:
application/json

Updated 16 days ago