# Swift

{% code fullWidth="true" %}

```
名称:
   singularity storage update swift - OpenStack Swift（Rackspace Cloud Files、Memset Memstore、OVH）

用法:
   singularity storage update swift [命令选项] <名称|ID>

说明:
   --env-auth
      从标准的OpenStack环境变量中获取Swift凭据。

      示例:
         | false | 在下一步输入Swift凭据。
         | true  | 从环境变量获取Swift凭据。
         |       | 如果使用此选项，请留空其他字段。

   --user
      登录用户名（OS_USERNAME）。

   --key
      API密钥或密码（OS_PASSWORD）。

   --auth
      服务器的身份验证URL（OS_AUTH_URL）。

      示例:
         | https://auth.api.rackspacecloud.com/v1.0     | Rackspace US
         | https://lon.auth.api.rackspacecloud.com/v1.0 | Rackspace UK
         | https://identity.api.rackspacecloud.com/v2.0 | Rackspace v2
         | https://auth.storage.memset.com/v1.0         | Memset Memstore UK
         | https://auth.storage.memset.com/v2.0         | Memset Memstore UK v2
         | https://auth.cloud.ovh.net/v3                | OVH

   --user-id
      用户ID（v3身份验证可选）- 大多数Swift系统使用用户，并将此字段留空（OS_USER_ID）。

   --domain
      用户域（v3身份验证可选）（OS_USER_DOMAIN_NAME）。

   --tenant
      租户名称（v1身份验证可选，否则需要此选项或租户ID）（OS_TENANT_NAME或OS_PROJECT_NAME）。

   --tenant-id
      租户ID（v1身份验证可选，否则需要此选项或租户）（OS_TENANT_ID）。

   --tenant-domain
      租户域（v3身份验证可选）（OS_PROJECT_DOMAIN_NAME）。

   --region
      区域名称（OS_REGION_NAME）。

   --storage-url
      存储URL（OS_STORAGE_URL）。

   --auth-token
      替代身份验证的身份验证令牌（可选）（OS_AUTH_TOKEN）。

   --application-credential-id
      应用凭据ID（OS_APPLICATION_CREDENTIAL_ID）。

   --application-credential-name
      应用凭据名称（OS_APPLICATION_CREDENTIAL_NAME）。

   --application-credential-secret
      应用凭据密码（OS_APPLICATION_CREDENTIAL_SECRET）。

   --auth-version
      身份验证版本（可选）- 如果身份验证URL没有版本，则设置为（1,2,3）（ST_AUTH_VERSION）。

   --endpoint-type
      选择服务目录中的端点类型（OS_ENDPOINT_TYPE）。

      示例:
         | public   | 公共（默认值，如果不确定，请选择此项）
         | internal | 内部（使用内部服务网络）
         | admin    | 管理员

   --leave-parts-on-error
      如果为true，则在失败时避免调用中止上传。
      
      对于不同会话之间的恢复上传操作，应设置为true。

   --storage-policy
      创建新容器时要使用的存储策略。
      
      创建新容器时应用指定的存储策略。此策略之后无法更改。允许的配置值及其含义取决于您的Swift存储供应商。

      示例:
         | <未设置> | 默认值
         | pcs     | OVH公共云存储
         | pca     | OVH公共云归档

   --chunk-size
      文件大小超过此值时，文件将被分片成_segemnts容器。
      
      文件大小超过此值时，文件将被分片成_segemnts容器。默认值为5 GiB，这是其最大值。

   --no-chunk
      在流式上传期间不要对文件进行分片。
      
      在进行流式上传（例如使用rcat或mount）时，设置此标志将导致Swift后端不上传分片文件。
      
      这将限制最大上传大小为5 GiB。但是，非分片文件更易处理且具有MD5SUM哈希值。
      
      在执行常规复制操作时，rclone仍会将大于chunk_size的文件分片。

   --no-large-objects
      禁用静态和动态大对象的支持。
      
      Swift无法透明地存储大于5 GiB的文件。有两种方式可以实现，即静态大对象或动态大对象，但API不允许rclone在不进行对象的HEAD请求的情况下确定文件是静态还是动态大对象。由于这些对象需要以不同的方式处理，这意味着rclone必须对对象发出HEAD请求，例如在读取校验和时。
      
      当设置`no_large_objects`时，rclone将假定没有存储静态或动态大对象。这意味着它可以停止执行额外的HEAD调用，这反过来极大地增加了性能，尤其是在设置了`--checksum`的情况下执行的Swift到Swift传输。
      
      设置此选项意味着`no_chunk`，并且不会上传以分片方式创建的文件，因此大于5 GiB的文件在上传时将失败。
      
      如果设置此选项，而实际上存在静态或动态大对象，则这些对象的哈希值将不正确。下载会成功，但是其他操作（例如删除和复制）将失败。
      

   --encoding
      后端的编码方式。
      
      有关更多信息，请参见[概述中的编码部分](/overview/#encoding)。

选项:
   --application-credential-id value      应用凭据ID（OS_APPLICATION_CREDENTIAL_ID）。[$APPLICATION_CREDENTIAL_ID]
   --application-credential-name value    应用凭据名称（OS_APPLICATION_CREDENTIAL_NAME）。[$APPLICATION_CREDENTIAL_NAME]
   --application-credential-secret value  应用凭据密码（OS_APPLICATION_CREDENTIAL_SECRET）。[$APPLICATION_CREDENTIAL_SECRET]
   --auth value                           服务器的身份验证URL（OS_AUTH_URL）。[$AUTH]
   --auth-token value                     替代身份验证的身份验证令牌（OS_AUTH_TOKEN）（可选）。[$AUTH_TOKEN]
   --auth-version value                   身份验证版本（可选）- 如果身份验证URL没有版本，则设置为（1,2,3）（ST_AUTH_VERSION）。 (默认值: 0) [$AUTH_VERSION]
   --domain value                         用户域（v3身份验证可选）（OS_USER_DOMAIN_NAME）[$DOMAIN]
   --endpoint-type value                  选择服务目录中的端点类型（OS_ENDPOINT_TYPE）。 (默认值: "public") [$ENDPOINT_TYPE]
   --env-auth                             从标准的OpenStack环境变量中获取Swift凭据（默认值: false）[$ENV_AUTH]
   --help, -h                             显示帮助信息
   --key value                            API密钥或密码（OS_PASSWORD）。[$KEY]
   --region value                         区域名称（OS_REGION_NAME）。[$REGION]
   --storage-policy value                 创建新容器时要使用的存储策略。[$STORAGE_POLICY]
   --storage-url value                    存储URL（OS_STORAGE_URL）。[$STORAGE_URL]
   --tenant value                         租户名称（v1身份验证可选，否则需要此选项或租户ID）（OS_TENANT_NAME或OS_PROJECT_NAME）。[$TENANT]
   --tenant-domain value                  租户域（v3身份验证可选）（OS_PROJECT_DOMAIN_NAME）。[$TENANT_DOMAIN]
   --tenant-id value                      租户ID（v1身份验证可选，否则需要此选项或租户）（OS_TENANT_ID）。[$TENANT_ID]
   --user value                           登录用户名（OS_USERNAME）。[$USER]
   --user-id value                        用户ID（v3身份验证可选）- 大多数Swift系统使用用户，并将此字段留空（OS_USER_ID）。[$USER_ID]

   高级选项

   --chunk-size value      文件大小超过此值时，文件将被分片成_segemnts容器。 (默认值: "5Gi") [$CHUNK_SIZE]
   --encoding value        后端的编码方式。 (默认值: "Slash,InvalidUtf8") [$ENCODING]
   --leave-parts-on-error  如果为true，则在失败时避免调用中止上传。 (默认值: false) [$LEAVE_PARTS_ON_ERROR]
   --no-chunk              在流式上传期间不要对文件进行分片。 (默认值: false) [$NO_CHUNK]
   --no-large-objects      禁用静态和动态大对象的支持 (默认值: false) [$NO_LARGE_OBJECTS]

```

{% endcode %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://data-programs.gitbook.io/singularity/zh/cli-reference/storage/update/swift.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.