OBS BrowserJS SDK-复制对象:请求参数
请求参数
字段名 |
类型 |
约束 |
说明 |
---|---|---|---|
Bucket |
String |
必选 |
目标桶名。 |
Key |
String |
必选 |
目标对象名。 |
RequestDate |
String 或 Date |
可选 |
指定请求时间。
说明:
当为String类型时,必须符合ISO8601或RFC822规范。 |
ACL |
String |
可选 |
创建对象时可指定的预定义访问策略。 |
StorageClass |
String |
可选 |
创建对象时可指定的对象的存储类型。 |
CopySource |
String |
必选 |
指定源桶、源对象和源对象版本号(可为空)的参数,格式:源桶名/源对象名?versionId=源对象版本号。 |
CopySourceIfMatch |
String |
可选 |
如果源对象的ETag值与该参数值相同,则进行复制,否则返回异常码。 |
CopySourceIfModifiedSince |
String |
可选 |
如果源对象的修改时间晚于该参数值指定的时间,则进行复制,否则返回异常码。该参数值必须符合http://www.ietf.org/rfc/rfc2616.txt规定的HTTP时间格式。 |
CopySourceIfNoneMatch |
String |
可选 |
如果源对象的ETag值与该参数值不相同,则进行复制,否则返回异常码。 |
CopySourceIfUnmodifiedSince |
String |
可选 |
如果源对象的修改时间早于该参数值指定的时间,则进行复制,否则返回异常码。该参数值必须符合http://www.ietf.org/rfc/rfc2616.txt规定的HTTP时间格式。 |
CacheControl |
String |
可选 |
复制时重写响应中的Cache-Control头。 |
ContentDisposition |
String |
可选 |
复制时重写响应中的Content-Disposition头。 |
ContentEncoding |
String |
可选 |
复制时重写响应中的Content-Encoding头。 |
ContentLanguage |
String |
可选 |
复制时重写响应中的Content-Language头。 |
ContentType |
String |
可选 |
复制时重写响应中的Content-Type头。 |
Expires |
String |
可选 |
复制时重写响应中的Expires头。 |
MetadataDirective |
String |
可选 |
复制策略。 |
Metadata |
Object |
可选 |
目标对象的自定义元数据。 |
WebsiteRedirectLocation |
String |
可选 |
当桶设置了Website配置,该参数指明对象的重定向地址。 |
SseKms |
String |
可选 |
以SSE-KMS方式加密目标对象,支持的值:
|
SseKmsKey |
String |
可选 |
SSE-KMS方式下加密目标对象的主密钥,可为空。 |
SseC |
String |
可选 |
以SSE-C方式加密目标对象,支持的值:
|
SseCKey |
String |
可选 |
SSE-C方式下加密目标对象的密钥,由AES256算法算出。 |
CopySourceSseC |
String |
可选 |
以SSE-C方式解密源对象,支持的值:
|
CopySourceSseCKey |
String |
可选 |
SSE-C方式下解密源对象的密钥,由AES256算法算出。 |
- 如果包含CopySourceIfUnmodifiedSince并且不符合,或者包含CopySourceIfMatch并且不符合,或者包含CopySourceIfModifiedSince并且不符合,或者包含CopySourceIfNoneMatch并且不符合,抛出异常中HTTP状态码为:412 precondition failed。
- CopySourceIfModifiedSince和CopySourceIfNoneMatch可以一起使用;CopySourceIfUnmodifiedSince和CopySourceIfMatch可以一起使用。