CreatePhoto
描述
提交事务以完成上传照片。
- 请在使用该接口前确认已完全理解了上传流程中的内容。
- 调用该接口前需要开启事务,请参考CreateTransaction接口。
请求参数
参数名 | 类型 | 是否必须 | 说明 |
---|---|---|---|
Action | String | 是 | CreatePhoto |
FileId | String | 是 | 开启上传事务时获取到的文件ID |
PhotoTitle | String | 是 | 照片的名称 |
SessionId | String | 是 | 开启上传事务时获取到的SessionId |
StoreName | String | 是 | PhotoStore的名称 |
UploadType | String | 是 | 自定义上传类型,比如用dailybackup表示自动备份,manual表示手动上传 |
Remark | String | 否 | 备注,支持长度为2048的中英文字符。如果Remark的内容有可能被显示在网页中,请在显示时对Remark内容做html转义以防止被注入攻击。 |
LibraryId | String | 否 | 照片库标识。采用AK认证时必选,采用STS认证时可选。了解不同认证方式的区别。 |
ShareExpireTime | Long | 否 | 可选值0或者大于当前时间的时间戳(单位:毫秒),不可以小于当前时间。当值大于当前时间戳时,表示在该时间戳之前,可以生成供公共访问的访问地址。默认值为0表示只能生成带鉴权访问的访问地址。参见分享照片。 |
Staging | Boolean | 否 | 可选值:true,false。默认值为false。当为true时,表示照片上传后的默认状态为staging。参见照片审核。 |
TakenAt | Long | 否 | 指定照片的拍摄时间戳。如果照片中没有Exif,或者Exif中没有照片的拍摄时间,将采用该参数指定的值作为照片的拍摄时间。合法取值为13位数字,大于0且小于当前时间戳。单位:毫秒。 |
请求示例
https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=CreatePhoto
&FileId=ZUBaS964T3OYtqaal9MaZwAAAApwZDIE
&PhotoTitle=demo-1.jpg
&SessionId=hLB2ktiDiXojjjINEsQNCwACowAAAAFdRAPCZQAAAApwZAYD
&StoreName=cloudphoto-demo
&UploadType=manual
&LibraryId=alice-001
&ShareExpireTime=1530085463134
&Staging=false
&<公共请求参数>
返回参数
参数名 | 类型 | 说明 |
---|---|---|
RequestId | String | 唯一标识本次请求的ID |
Code | String | 响应状态码,Success表示成功的响应 |
Message | String | 响应状态详细描述 |
Action | String | CreatePhoto |
Photo | Photo | Photo对象 |
Photo
参数名 | 类型 | 说明 |
---|---|---|
Ctime | String | 创建的时间戳,单位:毫秒 |
FileId | String | 照片对应到存储在OSS上的文件名 |
Height | Integer | 照片的高度 |
Id | Long | 记录的唯一标识 |
Md5 | String | 文件的Md5值。如果文件是以OSS分块上传方式上传的话,文件MD5为异步计算,在计算完成以前,MD5值为空。 |
Mtime | String | 最后修改的时间戳,单位:毫秒 |
State | String | 文件的状态 |
Title | String | 照片的名称 |
Width | Integer | 照片的宽度 |
Remark | String | 备注,200个中英文字符 |
TakenAt | Long | 照片的拍摄时间戳、单位:毫秒 |
返回示例
JSON格式
{
"Action":"CreatePhoto",
"Message":"success",
"RequestId":"A793DE62-050F-4D05-94A7-117DD4F97772",
"Code":"Success",
"Photo":{
"Md5":"6b680a5ec98537d18c87e9bb40fc0683",
"Mtime":1500085463134,
"State":"active",
"Height":1200,
"Id":822879673959591936,
"Ctime":1500085463134,
"Width":800,
"Title":"demo-1.jpg",
"FileId":"ZUBaS964T3OYtqaal9MaZwAAAApwZDIE",
"Remark":"",
"TakenAt":1500085463134,
"ShareExpireTime": 1530085463134
}
}
XML格式
<?xml version="1.0" encoding="UTF-8"?>
<CreatePhotoResponse>
<Action>CreatePhoto</Action>
<Message>success</Message>
<RequestId>E08384DD-8BD1-45EB-85CE-6B0D1F4B5D4E</RequestId>
<Photo>
<Mtime>1499946613428</Mtime>
<Md5>6b680a5ec98537d18c87e9bb40fc0683</Md5>
<State>active</State>
<Height>1200</Height>
<Ctime>1499946613428</Ctime>
<Id>822297296078114816</Id>
<Width>800</Width>
<FileId>MkM1N9sjSLe_LWWyxcA80wAAAApwZDIE</FileId>
<Title>demo-1.jpg</Title>
<Remark><Remark/>
<TakenAt>1499946613428</TakenAt>
<ShareExpireTime>1530085463134</ShareExpireTime>
</Photo>
<Code>Success</Code>
</CreatePhotoResponse>
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论