OBS PHP SDK-复制对象:请求参数
下载OBS PHP SDK用户手册完整版
请求参数
|
字段名 |
类型 |
约束 |
说明 |
|---|---|---|---|
|
Bucket |
string |
必选 |
目标桶名。 |
|
Key |
string |
必选 |
目标对象名。 |
|
ACL |
string |
可选 |
复制对象时可指定的预定义访问策略。 |
|
StorageClass |
string |
可选 |
复制时设置对象的存储类型。 |
|
CopySource |
string |
必选 |
指定源桶、源对象和源对象版本号（可为空）的参数，格式：源桶名/源对象名?versionId=源对象版本号。 |
|
CopySourceIfMatch |
string |
可选 |
如果源对象的ETag值与该参数值相同，则进行复制，否则抛出异常。 |
|
CopySourceIfModifiedSince |
string 或 \DateTime |
可选 |
如果源对象的修改时间晚于该参数值指定的时间，则进行复制，否则抛出异常。该参数值为字符串时必须符合http://www.ietf.org/rfc/rfc2616.txt规定的HTTP时间格式。 |
|
CopySourceIfNoneMatch |
string |
可选 |
如果源对象的ETag值与该参数值不相同，则进行复制，否则抛出异常。 |
|
CopySourceIfUnmodifiedSince |
string 或 \DateTime |
可选 |
如果源对象的修改时间早于该参数值指定的时间，则进行复制，否则抛出异常。该参数值为字符串时必须符合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 |
associative array |
可选 |
目标对象的自定义元数据。 |
|
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可以一起使用。
