Sign in

Create an access key

Create a runtime credential, stored in the replicated metadata: every node of a cluster accepts it, this one at once and the others within seconds. The access key and secret are generated when not supplied. The secret is returned only in this response and cannot be retrieved later.

post/api/v1/access-keys

Request

  • Base URL: http://localhost:8090
  • URL: http://localhost:8090/api/v1/access-keys
  • Auth: none declared

Request body

access_keystring

Access key ID; generated when omitted.

secret_keystring

Secret access key; generated when omitted.

Example request

{
  "grants": [
    {
      "bucket": "uploads-*"
    }
  ]
}

Response

Created credential (includes the secret).

access_keystring required
secret_keystring required

Secret access key — shown once, not retrievable later.

created_atstring date-time required

Example response

{
  "grants": [
    {
      "bucket": "uploads-*"
    }
  ]
}

Changes

No recorded changes to this operation across all 21 revisions of this API.