全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 钉钉智能硬件
智能云相册

CreatePhoto

更新时间:2017-12-05 19:54:09

描述

提交事务以完成上传照片。

  1. 请在使用该接口前确认已完全理解了上传流程中的内容。
  2. 调用该接口前需要开启事务,请参考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。参见照片审核

请求示例

  1. https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=CreatePhoto
  2. &FileId=ZUBaS964T3OYtqaal9MaZwAAAApwZDIE
  3. &PhotoTitle=demo-1.jpg
  4. &SessionId=hLB2ktiDiXojjjINEsQNCwACowAAAAFdRAPCZQAAAApwZAYD
  5. &StoreName=cloudphoto-demo
  6. &UploadType=manual
  7. &LibraryId=alice-001
  8. &ShareExpireTime=1530085463134
  9. &Staging=false
  10. &<公共请求参数>

返回参数

参数名 类型 说明
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格式

  1. {
  2. "Action":"CreatePhoto",
  3. "Message":"success",
  4. "RequestId":"A793DE62-050F-4D05-94A7-117DD4F97772",
  5. "Code":"Success",
  6. "Photo":{
  7. "Md5":"6b680a5ec98537d18c87e9bb40fc0683",
  8. "Mtime":1500085463134,
  9. "State":"active",
  10. "Height":1200,
  11. "Id":822879673959591936,
  12. "Ctime":1500085463134,
  13. "Width":800,
  14. "Title":"demo-1.jpg",
  15. "FileId":"ZUBaS964T3OYtqaal9MaZwAAAApwZDIE",
  16. "Remark":"",
  17. "TakenAt":1500085463134,
  18. "ShareExpireTime": 1530085463134
  19. }
  20. }

XML格式

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <CreatePhotoResponse>
  3. <Action>CreatePhoto</Action>
  4. <Message>success</Message>
  5. <RequestId>E08384DD-8BD1-45EB-85CE-6B0D1F4B5D4E</RequestId>
  6. <Photo>
  7. <Mtime>1499946613428</Mtime>
  8. <Md5>6b680a5ec98537d18c87e9bb40fc0683</Md5>
  9. <State>active</State>
  10. <Height>1200</Height>
  11. <Ctime>1499946613428</Ctime>
  12. <Id>822297296078114816</Id>
  13. <Width>800</Width>
  14. <FileId>MkM1N9sjSLe_LWWyxcA80wAAAApwZDIE</FileId>
  15. <Title>demo-1.jpg</Title>
  16. <Remark><Remark/>
  17. <TakenAt>1499946613428</TakenAt>
  18. <ShareExpireTime>1530085463134</ShareExpireTime>
  19. </Photo>
  20. <Code>Success</Code>
  21. </CreatePhotoResponse>
本文导读目录