s3.buckets.accessEverything that can reach a bucket: keys limited to it, principals whose policies allow it, temporary credentials, public access, website
Decided as the S3 gateway decides a signed request. A key’s limit never grants: a key limited to this bucket works only when its account’s policies (or the bucket policy) allow the same. keys needs iam:ListAccessKeys, principals and temporary need iam:ListUsers, bucketPolicy needs s3:GetBucketPolicy; a part the caller may not read is null and named in hidden.
Request syntax
GET /s3/api/buckets/{name}/accessPath parameters
nameRequiredstring
Constraints: 3-63 chars, /^[a-z0-9][a-z0-9-]*[a-z0-9]$/
Response
200; data is { bucket, address, keys, principals, onlyEveryBucket, temporary, publicAccess, website, bucketPolicy, hidden }. Each key: accessKeyId, owner, limit { access, prefix }, access { list, read, write, delete, prefix } and works (works, partial, none, inactive): what it really may do, its account’s policies AND its limit. Each principal: kind (user, service_account, role), name, access, grants (the policies that allow it, how they reach the principal, and whether they allow every bucket), byBucketPolicy, deniedBy and unlimitedKeys.
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:GetBucket 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 buckets access namecurl -X GET "https://console.platform.deutschecloud.app/s3/api/buckets/name/access" \
-H "Authorization: EWS-ACCESS-KEY $ACCESS_KEY"Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_s3_buckets_access.