b7ed9d3dfe
Rename sections to chapters for the command references. Update cli-reference to remove single "command references" chapter and add a chapter per command. Adjust training-guides. Change-Id: I64b30bca4915eed4f312bb3d2b5692c11b19fc81
783 lines
22 KiB
XML
783 lines
22 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<chapter xmlns="http://docbook.org/ns/docbook"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
|
|
xml:id="swiftclient_commands">
|
|
|
|
<!-- This file is automatically generated, do not edit -->
|
|
|
|
<?dbhtml stop-chunking?>
|
|
|
|
<title>swift commands</title>
|
|
<para>The swift client is the command-line interface (CLI) for the
|
|
OpenStack Object Storage API and its extensions.</para>
|
|
<para>For help on a specific <command>swift</command>
|
|
command, enter:
|
|
</para>
|
|
<screen><prompt>$</prompt> <userinput><command>swift</command> <option>help</option> <replaceable>COMMAND</replaceable></userinput></screen>
|
|
|
|
<section xml:id="swiftclient_command_usage">
|
|
<title>swift usage</title>
|
|
<screen><computeroutput> [--debug] [--info] [--quiet] [--auth <auth_url>]
|
|
[--auth-version <auth_version>] [--user <username>]
|
|
[--key <api_key>] [--retries <num_retries>]
|
|
[--os-username <auth-user-name>] [--os-password <auth-password>]
|
|
[--os-tenant-id <auth-tenant-id>]
|
|
[--os-tenant-name <auth-tenant-name>]
|
|
[--os-auth-url <auth-url>] [--os-auth-token <auth-token>]
|
|
[--os-storage-url <storage-url>] [--os-region-name <region-name>]
|
|
[--os-service-type <service-type>]
|
|
[--os-endpoint-type <endpoint-type>]
|
|
[--os-cacert <ca-certificate>] [--insecure]
|
|
[--no-ssl-compression]
|
|
<subcommand> ...
|
|
</computeroutput></screen>
|
|
<variablelist wordsize="10">
|
|
<title>Subcommands</title>
|
|
<varlistentry>
|
|
<term><command>delete</command></term>
|
|
<listitem>
|
|
<para>
|
|
Delete a container or objects within a container
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>download</command></term>
|
|
<listitem>
|
|
<para>
|
|
Download objects from containers
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>list</command></term>
|
|
<listitem>
|
|
<para>
|
|
Lists the containers for the account or the objects
|
|
for a container
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>post</command></term>
|
|
<listitem>
|
|
<para>
|
|
Updates meta information for the account, container,
|
|
or object; creates containers if not present
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>stat</command></term>
|
|
<listitem>
|
|
<para>
|
|
Displays information for the account, container,
|
|
or object
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>upload</command></term>
|
|
<listitem>
|
|
<para>
|
|
Uploads files or directories to the given container
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="swiftclient_command_examples">
|
|
<title>swift examples</title>
|
|
<screen><computeroutput> swift -A https://auth.api.rackspacecloud.com/v1.0 -U user -K api_key stat -v
|
|
swift --os-auth-url https://api.example.com/v2.0 --os-tenant-name tenant \
|
|
--os-username user --os-password password list
|
|
swift --os-auth-token 6ee5eb33efad4e45ab46806eac010566 \
|
|
--os-storage-url https://10.1.5.2:8080/v1/AUTH_ced809b6a4baea7aeab61a \
|
|
list
|
|
swift list --lh
|
|
</computeroutput></screen>
|
|
</section>
|
|
<section xml:id="swiftclient_command_optional">
|
|
<title>swift optional arguments</title>
|
|
<variablelist wordsize="10">
|
|
<varlistentry>
|
|
<term><command>--version</command></term>
|
|
<listitem>
|
|
<para>
|
|
show program's version number and exit
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>-h, --help</command></term>
|
|
<listitem>
|
|
<para>
|
|
show this help message and exit
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>-s, --snet</command></term>
|
|
<listitem>
|
|
<para>
|
|
Use SERVICENET internal network
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>-v, --verbose</command></term>
|
|
<listitem>
|
|
<para>
|
|
Print more info
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--debug</command></term>
|
|
<listitem>
|
|
<para>
|
|
Show the curl commands and results of all http queries
|
|
regardless of result status.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--info</command></term>
|
|
<listitem>
|
|
<para>
|
|
Show the curl commands and results of all http
|
|
queries which return an error.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>-q, --quiet</command></term>
|
|
<listitem>
|
|
<para>
|
|
Suppress status output
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>-A AUTH, --auth=AUTH URL</command></term>
|
|
<listitem>
|
|
<para>
|
|
for obtaining an auth token
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>-V AUTH_VERSION, --auth-version=AUTH_VERSION</command></term>
|
|
<listitem>
|
|
<para>
|
|
Specify a version for authentication. Defaults to 1.0.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>-U USER, --user=USER</command></term>
|
|
<listitem>
|
|
<para>
|
|
User name for obtaining an auth token.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>-K KEY, --key=KEY</command></term>
|
|
<listitem>
|
|
<para>
|
|
Key for obtaining an auth token.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>-R RETRIES, --retries=RETRIES</command></term>
|
|
<listitem>
|
|
<para>
|
|
The number of times to retry a failed connection.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--os-username=<auth-user-name></command></term>
|
|
<listitem>
|
|
<para>
|
|
Openstack username. Defaults to <code>env[OS_USERNAME]</code>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--os-password=<auth-password></command></term>
|
|
<listitem>
|
|
<para>
|
|
Openstack password. Defaults to <code>env[OS_PASSWORD]</code>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--os-tenant-id=<auth-tenant-id></command></term>
|
|
<listitem>
|
|
<para>
|
|
OpenStack tenant ID. Defaults to <code>env[OS_TENANT_ID]</code>
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--os-tenant-name=<auth-tenant-name></command></term>
|
|
<listitem>
|
|
<para>
|
|
Openstack tenant name. Defaults to
|
|
<code>env[OS_TENANT_NAME]</code>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--os-auth-url=<auth-url></command></term>
|
|
<listitem>
|
|
<para>
|
|
Openstack auth URL. Defaults to <code>env[OS_AUTH_URL]</code>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--os-auth-token=<auth-token></command></term>
|
|
<listitem>
|
|
<para>
|
|
Openstack token. Defaults to <code>env[OS_AUTH_TOKEN]</code>. Used
|
|
with --os-storage-url to bypass the usual
|
|
username/password authentication.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--os-storage-url=<storage-url></command></term>
|
|
<listitem>
|
|
<para>
|
|
Openstack storage URL. Defaults to
|
|
<code>env[OS_STORAGE_URL]</code>. Overrides the storage url
|
|
returned during auth. Will bypass authentication when
|
|
used with --os-auth-token.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--os-region-name=<region-name></command></term>
|
|
<listitem>
|
|
<para>
|
|
Openstack region name. Defaults to <code>env[OS_REGION_NAME]</code>
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--os-service-type=<service-type></command></term>
|
|
<listitem>
|
|
<para>
|
|
Openstack Service type. Defaults to
|
|
<code>env[OS_SERVICE_TYPE]</code>
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--os-endpoint-type=<endpoint-type></command></term>
|
|
<listitem>
|
|
<para>
|
|
Openstack Endpoint type. Defaults to
|
|
<code>env[OS_ENDPOINT_TYPE]</code>
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--os-cacert=<ca-certificate></command></term>
|
|
<listitem>
|
|
<para>
|
|
Specify a CA bundle file to use in verifying a TLS
|
|
(https) server certificate. Defaults to <code>env[OS_CACERT]</code>
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--insecure</command></term>
|
|
<listitem>
|
|
<para>
|
|
Allow swiftclient to access insecure keystone server.
|
|
The keystone's certificate will not be verified.
|
|
Defaults to <code>env[SWIFTCLIENT_INSECURE]</code> (set to 'true'
|
|
to enable).
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--no-ssl-compression</command></term>
|
|
<listitem>
|
|
<para>
|
|
Disable SSL compression when using https. This may
|
|
increase performance.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="swiftclient_subcommand_delete">
|
|
<title>swift delete command</title>
|
|
<screen><computeroutput>Usage: Delete a container or objects within a container
|
|
</computeroutput></screen>
|
|
<para>
|
|
</para> <variablelist wordsize="10">
|
|
<title>Positional arguments</title>
|
|
<varlistentry>
|
|
<term><command><container></command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of container to delete from
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>[object]</command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of object to delete. Specify multiple times
|
|
for multiple objects
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
<variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--all</command></term>
|
|
<listitem>
|
|
<para>
|
|
Delete all containers and objects
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--leave-segments</command></term>
|
|
<listitem>
|
|
<para>
|
|
Do not delete segments of manifest objects
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--object-threads <threads></command></term>
|
|
<listitem>
|
|
<para>
|
|
Number of threads to use for deleting objects
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--container-threads <threads></command></term>
|
|
<listitem>
|
|
<para>
|
|
Number of threads to use for deleting containers
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="swiftclient_subcommand_download">
|
|
<title>swift download command</title>
|
|
<screen><computeroutput>Usage: Download objects from containers
|
|
</computeroutput></screen>
|
|
<para>
|
|
</para> <variablelist wordsize="10">
|
|
<title>Positional arguments</title>
|
|
<varlistentry>
|
|
<term><command><container></command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of container to download from. To download a
|
|
whole account, omit this and specify --all.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command><object></command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of object to download. Specify multiple times
|
|
for multiple objects. Omit this to download all
|
|
objects from the container.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
<variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--all</command></term>
|
|
<listitem>
|
|
<para>
|
|
Indicates that you really want to download
|
|
everything in the account
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--marker</command></term>
|
|
<listitem>
|
|
<para>
|
|
Marker to use when starting a container or account
|
|
download
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--prefix <prefix></command></term>
|
|
<listitem>
|
|
<para>
|
|
Only download items beginning with <prefix>
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--output <out_file></command></term>
|
|
<listitem>
|
|
<para>
|
|
For a single file download, stream the output to
|
|
<out_file>. Specifying "-" as <out_file> will
|
|
redirect to stdout
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--object-threads <threads></command></term>
|
|
<listitem>
|
|
<para>
|
|
Number of threads to use for downloading objects
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--container-threads <threads></command></term>
|
|
<listitem>
|
|
<para>
|
|
Number of threads to use for deleting containers
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--no-download</command></term>
|
|
<listitem>
|
|
<para>
|
|
Perform download(s), but don't actually write anything
|
|
to disk
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--header <header_name:header_value></command></term>
|
|
<listitem>
|
|
<para>
|
|
Adds a customized request header to the query, like
|
|
"Range" or "If-Match". This argument is repeatable.
|
|
Example --header "content-type:text/plain"
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="swiftclient_subcommand_list">
|
|
<title>swift list command</title>
|
|
<screen><computeroutput>Usage: Lists the containers for the account or the objects for a container
|
|
</computeroutput></screen>
|
|
<para>
|
|
</para> <variablelist wordsize="10">
|
|
<title>Positional arguments</title>
|
|
<varlistentry>
|
|
<term><command>[container]</command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of container to list object in
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
<variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--long</command></term>
|
|
<listitem>
|
|
<para>
|
|
Long listing format, similar to ls -l
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--lh</command></term>
|
|
<listitem>
|
|
<para>
|
|
Report sizes in human readable format similar to ls -lh
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--totals</command></term>
|
|
<listitem>
|
|
<para>
|
|
Used with -l or --ls, only report totals
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--prefix</command></term>
|
|
<listitem>
|
|
<para>
|
|
Only list items beginning with the prefix
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--delimiter</command></term>
|
|
<listitem>
|
|
<para>
|
|
Roll up items with the given delimiter. For containers
|
|
only. See OpenStack Swift API documentation for what
|
|
this means.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="swiftclient_subcommand_post">
|
|
<title>swift post command</title>
|
|
<screen><computeroutput>Usage: Updates meta information for the account, container, or object.
|
|
If the container is not found, it will be created automatically.
|
|
</computeroutput></screen>
|
|
<para>
|
|
</para> <variablelist wordsize="10">
|
|
<title>Positional arguments</title>
|
|
<varlistentry>
|
|
<term><command><container></command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of container to post to
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>[object]</command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of object to post. Specify multiple times
|
|
for multiple objects
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
<variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--read-acl <acl></command></term>
|
|
<listitem>
|
|
<para>
|
|
Read ACL for containers. Quick summary of ACL syntax:
|
|
.r:*, .r:-.example.com, .r:www.example.com, account1,
|
|
account2:user2
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--write-acl <acl></command></term>
|
|
<listitem>
|
|
<para>
|
|
Write ACL for containers. Quick summary of ACL syntax:
|
|
account1 account2:user2
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--sync-to <sync-to></command></term>
|
|
<listitem>
|
|
<para>
|
|
Sync To for containers, for multi-cluster replication
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--sync-key <sync-key></command></term>
|
|
<listitem>
|
|
<para>
|
|
Sync Key for containers, for multi-cluster replication
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--meta <name:value></command></term>
|
|
<listitem>
|
|
<para>
|
|
Sets a meta data item. This option may be repeated.
|
|
Example: -m Color:Blue -m Size:Large
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--header <header></command></term>
|
|
<listitem>
|
|
<para>
|
|
Set request headers. This option may be repeated.
|
|
Example -H "content-type:text/plain"
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="swiftclient_subcommand_stat">
|
|
<title>swift stat command</title>
|
|
<screen><computeroutput>Usage: Displays information for the account, container, or object
|
|
</computeroutput></screen>
|
|
<para>
|
|
</para> <variablelist wordsize="10">
|
|
<title>Positional arguments</title>
|
|
<varlistentry>
|
|
<term><command><container></command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of container to stat from
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command><object></command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of object to stat. Specify multiple times
|
|
for multiple objects
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
<variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--lh</command></term>
|
|
<listitem>
|
|
<para>
|
|
Report sizes in human readable format similar to ls -lh
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="swiftclient_subcommand_upload">
|
|
<title>swift upload command</title>
|
|
<screen><computeroutput>Usage: Uploads specified files and directories to the given container
|
|
</computeroutput></screen>
|
|
<para>
|
|
</para> <variablelist wordsize="10">
|
|
<title>Positional arguments</title>
|
|
<varlistentry>
|
|
<term><command><container></command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of container to upload to
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command><file_or_directory></command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of file or directory to upload. Specify multiple
|
|
times for multiple uploads
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
<variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--changed</command></term>
|
|
<listitem>
|
|
<para>
|
|
Only upload files that have changed since the last
|
|
upload
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--segment-size <size></command></term>
|
|
<listitem>
|
|
<para>
|
|
Upload files in segments no larger than <size> and
|
|
then create a "manifest" file that will download all
|
|
the segments as if it were the original file
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--segment-container <container></command></term>
|
|
<listitem>
|
|
<para>
|
|
Upload the segments into the specified container. If
|
|
not specified, the segments will be uploaded to a
|
|
<container>_segments container so as to not pollute the
|
|
main <container> listings.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--leave-segments</command></term>
|
|
<listitem>
|
|
<para>
|
|
Indicates that you want the older segments of manifest
|
|
objects left alone (in the case of overwrites)
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--object-threads <threads></command></term>
|
|
<listitem>
|
|
<para>
|
|
Number of threads to use for uploading full objects.
|
|
Default is 10.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--segment-threads <threads></command></term>
|
|
<listitem>
|
|
<para>
|
|
Number of threads to use for uploading object segments.
|
|
Default is 10.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--header <header></command></term>
|
|
<listitem>
|
|
<para>
|
|
Set request headers with the syntax header:value.
|
|
This option may be repeated.
|
|
Example -H "content-type:text/plain".
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--use-slo</command></term>
|
|
<listitem>
|
|
<para>
|
|
When used in conjunction with --segment-size will
|
|
create a Static Large Object instead of the default
|
|
Dynamic Large Object.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--object-name <object-name></command></term>
|
|
<listitem>
|
|
<para>
|
|
Upload file and name object to <object-name> or upload
|
|
dir and use <object-name> as object prefix instead of
|
|
folder name
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
</chapter>
|