Skip to main content
FuseFuse
IntegrationsAwsActions

List S3 buckets

List general-purpose S3 buckets with pagination. Returns bucket Region when AWS supplies it. Requires s3:ListAllMyBuckets.

Agent markdown

s3.buckets.list · AWS · v1

Details

Risk
Read
Idempotency
Safe
Availability
Default
Exposure
REST, SDK, MCP
MCP hints
readOnly=true, destructive=false, idempotent=true, openWorld=true

Scopes

  • s3:ListAllMyBuckets

Input

Input schema
NameTypeRequiredConstraints
(root)objectYesadditionalProperties false
page_sizeintegerNominimum 1; maximum 1000
cursorstringNominLength 1; maxLength 16384; pattern ^(?!.*://)[^\x00-\x1f\x7f]+$
prefixstringNominLength 1; maxLength 1024

Output

Output schema
NameTypeRequiredConstraints
(root)objectYesadditionalProperties false
bucketsarray<object>YesmaxItems 1000
buckets[]objectYesadditionalProperties false
buckets[].namestringYesminLength 3; maxLength 63; pattern ^[a-z0-9][a-z0-9.-]{1,61}[a-z0-9]$
buckets[].created_atstringNominLength 1; maxLength 64
buckets[].regionstringNominLength 1; maxLength 64
next_cursorstringNominLength 1; maxLength 16384; pattern ^(?!.*://)[^\x00-\x1f\x7f]+$

Raw schema

Input
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "page_size": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 16384,
      "pattern": "^(?!.*://)[^\\x00-\\x1f\\x7f]+$"
    },
    "prefix": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1024
    }
  }
}
Output
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "buckets": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "name": {
            "type": "string",
            "minLength": 3,
            "maxLength": 63,
            "pattern": "^[a-z0-9][a-z0-9.-]{1,61}[a-z0-9]$"
          },
          "created_at": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          },
          "region": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          }
        },
        "required": [
          "name"
        ]
      },
      "maxItems": 1000
    },
    "next_cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 16384,
      "pattern": "^(?!.*://)[^\\x00-\\x1f\\x7f]+$"
    }
  },
  "required": [
    "buckets"
  ]
}