capabilities

Prev Next

Available in Classic and VPC

Get the features and limits supported by a cluster.

Syntax

The capabilities syntax is as follows:

swift capabilities \
    [<proxy-url>] \
    [--json]

Options

This section describes the options available when running capabilities.

Optional options

These are the optional options for capabilities. Options that are not specified will use their default values.

Options Type Required Description
<proxy-url> String Optional Proxy URL of the cluster whose features to query
  • If left blank, queries the currently authenticated cluster.
--json Boolean Optional Outputs cluster feature information in JSON format.

Common options

For information about the options common to all swift subcommands, see Archive Storage options.

Examples

When you run the command, the cluster's key limits and support information for each middleware will be displayed.

Command

The following describes an example command for retrieving cluster feature information.

swift capabilities

The following describes an example command for retrieving data in JSON format.

swift capabilities --json

Output

The following describes an example output for retrieving cluster feature information.

Core: swift
 Options:
  account_autocreate: True
  account_listing_limit: 10000
  allow_account_management: True
  container_listing_limit: 10000
  extra_header_count: 0
  max_account_name_length: 256
  max_container_name_length: 256
  max_file_size: 5368709120
  max_header_size: 8192
  max_meta_count: 90
  max_meta_name_length: 128
  max_meta_overall_size: 4096
  max_meta_value_length: 256
  max_object_name_length: 1024
  policies: [{'name': 'policy-0', 'aliases': 'policy-0'}, {'name': 'standard00', 'aliases': 'standard00', 'default': True}]
  strict_cors_mode: True
  version: 2.23.1
Additional middleware: account_quotas
Additional middleware: bulk_delete
 Options:
  max_deletes_per_request: 10000
  max_failed_deletes: 1000
Additional middleware: bulk_upload
 Options:
  max_containers_per_extraction: 10000
  max_failed_extractions: 1000
Additional middleware: container_quotas
Additional middleware: container_sync
 Options:
  realms: {}
Additional middleware: formpost
Additional middleware: name_check
 Options:
  forbidden_chars: <>
  forbidden_regexp: /\./|/\.\./|/\.$|/\.\.$
  maximum_length: 1024
Additional middleware: s3api
 Options:
  allow_multipart_uploads: True
  max_bucket_listing: 1000
  max_multi_delete_objects: 1000
  max_parts_listing: 1000
  max_upload_part_num: 1000
  min_segment_size: 5242880
  s3_acl: true
Additional middleware: slo
 Options:
  max_manifest_segments: 10000
  max_manifest_size: 5368709120
  min_segment_size: 1
  yield_frequency: 10
Additional middleware: staticweb
Additional middleware: tempurl
 Options:
  allowed_digests: ['sha1', 'sha256', 'sha512']
  incoming_allow_headers: []
  incoming_remove_headers: ['x-timestamp']
  methods: ['GET', 'HEAD', 'PUT', 'POST', 'DELETE']
  outgoing_allow_headers: ['x-object-meta-public-*']
  outgoing_remove_headers: ['x-object-meta-*']

The following describes an example output in JSON format.

{
  "account_quotas": {},
  "bulk_delete": {
    "max_deletes_per_request": 10000,
    "max_failed_deletes": 1000
  },
  "bulk_upload": {
    "max_containers_per_extraction": 10000,
    "max_failed_extractions": 1000
  },
  ...
}