17.3. 配置选项

bucketNameOrArn *

bucket 名称

S3 Bucket 名称或 Amazon Resource Name (ARN)。

字符串

keyName *

键名称

通过端点参数在存储桶中设置元素的密钥名称。在流上传中，使用默认配置，这是进度创建文件的基础。

字符串

region *

AWS 区域

用于访问的 AWS 区域。

字符串

accessKey

访问密钥

从 AWS 获取的访问密钥。

字符串

autoCreateBucket

autocreate Bucket

设置 S3 存储桶自动创建的 bucketName。

布尔值

False

batchMessageNumber

批量消息号

在流传输上传模式中制作批处理的消息数量。

整数

10

batchSize

批处理大小

流上传模式的批处理大小（以字节为单位）。

整数

1000000

forcePathStyle

强制路径样式

在访问 AWS S3 存储桶时强制路径风格。

布尔值

False

namingStrategy

命名策略

在流上传模式中使用的命名策略。有 2 个枚举，值可以是 progressive、random 之一。

字符串

progressive

overrideEndpoint

端点覆盖

选择这个选项来覆盖端点 URI。要使用这个选项，还必须为 uriEndpointOverride 选项提供 URI。

布尔值

False

profileCredentialsName

配置集凭证名称

如果使用配置集凭证供应商，此参数会设置配置集名称。

字符串

restartingPolicy

重启策略

在流上传模式中使用的重启策略。有 2 个 enums，值可以是 覆盖 之一，lastPart。

字符串

lastPart

secretKey

机密密钥

从 AWS 获取的 secret 密钥。

字符串

sessionToken

会话令牌

当用户需要假定 IAM 角色时使用的 Amazon AWS Session Token。

字符串

streamingUploadTimeout

流上传超时

在流上传模式为 true 时，此选项会将超时设置为完成上传。

整数

uriEndpointOverride

覆盖 Endpoint URI

覆盖端点 URI。要使用这个选项，还必须选择 overrideEndpoint 选项。

字符串

useDefaultCredentialsProvider

默认凭证提供程序

设置 S3 客户端是否应该希望通过默认凭据提供程序加载凭据，或者希望传递静态凭据。

布尔值

False

useProfileCredentialsProvider

配置集凭证供应商

设置 S3 客户端是否应该预期通过配置集凭据提供程序加载凭据。

布尔值

False

useSessionCredentials

会话凭证

设置 S3 客户端是否应该预期使用 Session Credentials。这在用户需要假设 IAM 角色在 S3 中执行操作时非常有用。

布尔值

False