Create Temporary Access Credentials

client.R2.TemporaryCredentials.New(ctx, params) (*TemporaryCredentialNewResponse, error)

POST/accounts/{account_id}/r2/temp-access-credentials

Creates temporary access credentials on a bucket that can be optionally scoped to prefixes or objects.

Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

ParametersExpand Collapse

params TemporaryCredentialNewParams

AccountID param.Field[string]

Path param: Account ID.

maxLength32

TemporaryCredential param.Field[TemporaryCredential]

Body param

ReturnsExpand Collapse

type TemporaryCredentialNewResponse struct{…}

AccessKeyID stringoptional

ID for new access key.

SecretAccessKey stringoptional

Secret access key.

SessionToken stringoptional

Security token.

Create Temporary Access Credentials

package main

import (
  "context"
  "fmt"

  "github.com/cloudflare/cloudflare-go"
  "github.com/cloudflare/cloudflare-go/option"
  "github.com/cloudflare/cloudflare-go/r2"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  temporaryCredential, err := client.R2.TemporaryCredentials.New(context.TODO(), r2.TemporaryCredentialNewParams{
    AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
    TemporaryCredential: r2.TemporaryCredentialParam{
      Bucket: cloudflare.F("example-bucket"),
      ParentAccessKeyID: cloudflare.F("example-access-key-id"),
      Permission: cloudflare.F(r2.TemporaryCredentialPermissionObjectReadWrite),
      TTLSeconds: cloudflare.F(3600.000000),
    },
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", temporaryCredential.AccessKeyID)
}

{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    "string"
  ],
  "result": {
    "accessKeyId": "example-access-key-id",
    "secretAccessKey": "example-secret-key",
    "sessionToken": "example-session-token"
  },
  "success": true
}

Returns Examples

{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    "string"
  ],
  "result": {
    "accessKeyId": "example-access-key-id",
    "secretAccessKey": "example-secret-key",
    "sessionToken": "example-session-token"
  },
  "success": true
}