VK Cloud logo

Getting started

Getting the endpoint

In the personal dashboard, find the required endpoint in the S3 Object Storage block.

Authorization and authentication

Most requests to VK Object Storage require authentication.

Authentication data is specified in the Authorization header of the request:

Authorization: <ТИП_ПОДПИСИ>-<АЛГОРИТМ_ПОДПИСИ> Credential=<КЛЮЧ_ДОСТУПА>/<ДАТА>/<РЕГИОН>/s3/aws4_request,SignedHeaders=<ЗАГОЛОВКИ>,Signature=<ПОДПИСЬ>

Here:

  • <ТИП_ПОДПИСИ> — AWS4.

  • <АЛГОРИТМ_ПОДПИСИ> — HMAC-SHA256.

  • <КЛЮЧ_ДОСТУПА> — the key identifier for accessing VK Object Storage.

  • <ДАТА> — the date in YYYYMMDD format.

  • <РЕГИОН> — the account region. Available values:

    • ru-msk — Moscow region;
    • kz-ast — Kazakhstan region.
  • <ЗАГОЛОВКИ> — the list of headers used to compute the signature. Headers must be lowercase and arranged in alphabetical order.

  • <ПОДПИСЬ> — the computed signature of the request.

Example request with authorization:

PUT / HTTP/1.1Host: my-test-bucket1.hb.ru-msk.vkcloud-storage.rux-amz-acl: public-readx-amz-content-sha256: c6f1fc479f5f690c443b73a258aacc06ddad09eca0b001e9640ff2cd56fe5710x-amz-date: 20200831T173143ZAuthorization: AWS4-HMAC-SHA256 Credential=II5JDQBAN3JYM4DNEB6C/20200831/ru-msk/s3/aws4_request,SignedHeaders=host;x-amz-acl;x-amz-content-sha256;x-amz-date,Signature=6cab03bef74a80a0441ab7fd33c829a2cdb46bba07e82da518cdb78ac238fda5<CreateBucketConfiguration>  <LocationConstraint>ru-msk</LocationConstraint></CreateBucketConfiguration>
Was this article helpful?