How to use the S3 API
Before you start
To use the API:
- Create a service account.
- Add the service account to a group to grant it necessary permissions.
- Create a static access key.
To access the HTTP API directly, you need static key authentication, which is supported by the tools listed in Supported tools.
For a list of supported Amazon S3 HTTP API methods, see the API reference.
General API request format
General Object Storage API request format:
{GET|HEAD|PUT|DELETE} /<bucket_name>/<object_key> HTTP/2
Host: storage.ai.nebius.cloud
Content-Length: length
Date: date
Authorization: authorization string (AWS Signature Version 4)
Request_body
The request contains an HTTP method, bucket name, and object key.
The bucket name can be specified as part of the host name. In this case, the request will look like this:
{GET|HEAD|PUT|DELETE} /<object_key>} HTTP/2
Host: <bucket_name>.storage.ai.nebius.cloud
...
The set of headers depends on the specific request and is described in the documentation for the corresponding request.
If you use the API directly (without an SDK or apps), you need to generate the Authorization
header yourself for authenticating requests. Find out how to do this in the Amazon S3 documentation: Authenticating Requests (AWS Signature Version 4)
Request URL
URLs can take one of the following forms:
https://storage.ai.nebius.cloud/<bucket_name>/<object_key>?<query parameters>
http://<bucket_name>.storage.ai.nebius.cloud/<object_key>?<query parameters>
The URL contains the bucket name, object key, and query parameters. See an example of possible query parameters in the Get object method description.
Note
If you use AWS SDK for .NET, access the s3.ai.nebius.cloud
host.