s3.temporary-credentials.create

Create temporary S3 credentials (15 minutes to 12 hours, default 1 hour)

POST /s3/api/temporary-credentialsIAM s3:CreateTemporaryCredentialsChanges state

Returns accessKeyId, secretAccessKey, sessionToken and expiresAt once. Every S3 request must carry the token as a signed x-amz-security-token (AWS_SESSION_TOKEN in the AWS CLI and SDKs). They are never listed and cannot be revoked; they expire.

Request syntax

POST /s3/api/temporary-credentials
{
  "durationSeconds": "number",
  "description": "string"
}

Request body

  • durationSecondsOptional

    number

    Lifetime in seconds, 900–43200 (default 3600)

    Constraints: integer, 900-43200

  • descriptionOptional

    string

    What the credentials are for

    Constraints: max 200 chars

Response

201; data is { accessKeyId, secretAccessKey, sessionToken, expiresAt, endpoint }.

A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.

Errors

  • 400The request does not pass the schema above. The body is { "error": …, "issues": […] }, one issue per field.
  • 401No credentials, or an access key that is unknown, revoked or expired.
  • 403The caller's policies do not allow s3:CreateTemporaryCredentials on this resource. The body names the action and the resource, and the refusal is recorded in the audit log.
  • 404The resource does not exist in your organization.

Examples

The required parameters only, with example values. Replace id and the other placeholders with your own.

dcloud s3 temporary-credentials create

Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_s3_temporary-credentials_create.