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

CreateTransaction

更新时间:2017-09-20 17:51:28

描述

开启上传事务,获取上传文件需要访问OSS的临时凭证和其他相关信息。

请在使用该接口前确认已完全理解了上传流程中的内容。

请求参数

参数名 类型 是否必须 说明
Action String CreateTransaction
Ext String 文件的扩展名
Force Boolean 保留参数,设置为true
Md5 String 待上传文件的Md5,如果提供了且合法,将用于验证文件上传。
Size Integer 待上传文件的大小
StoreName String PhotoStore的名称
LibraryId String 照片库标识。采用AK认证时必选,采用STS认证时可选。了解不同认证方式的区别。

请求示例

  1. https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=CreateTransaction
  2. &Ext=jpg
  3. &Force=true
  4. &Md5=6b680a5ec98537d18c87e9bb40fc0683
  5. &Size=102933
  6. &StoreName=cloudphoto-demo
  7. &LibraryId=alice-001
  8. &<公共请求参数>

返回参数

参数名 类型 说明
RequestId String 唯一标识本次请求的ID
Code String 响应状态码,Success表示成功的响应
Message String 响应状态详细描述
Action String CreateTransaction
Transaction Transaction Transaction对象

Transaction

参数名 类型 说明
Upload Upload Upload对象

Upload

参数名 类型 说明
AccessKeyId String 用于上传文件到OSS的临时AccessKeyId
AccessKeySecret String 用于上传文件到OSS的临时Secret
Bucket String 用于上传文件到OSS的Bucket
FileId String 待上传文件对应到存储在OSS上的文件名,CreatePhoto接口需要用到这个值
ObjectKey String 待上传文件在OSS Bucket中的路径,文件上传后,将存储在对应OSS Bucket的这个路径
OssEndpoint String 文件将要上传到的OSS的EndPoint
SessionId String 表示一个上传文件的会话ID,CreatePhoto接口需要用到这个值
StsToken String 用于上传文件到OSS的临时Security Token

返回示例

JSON格式

  1. {
  2. "Transaction":{
  3. "Upload":{
  4. "SessionId":"hLB2ktiDiXojjjINEsQNCwACowAAAAFdRAPCZQAAAApwZAYD",
  5. "AccessKeySecret":"AVPraikAoJxNKPZQBAm5Rh6RbbtkvaM2typxPCAJtSCT",
  6. "StsToken":"CAISjQN1q6Ft5B2yfSjIq7b4JujkuLBw5fC9VEH8pmYPSeJ/3vHbizz2IH9PdXRuCe4esv00mmlW7PYelqZ4T5hYSVTEatd3q5ha9AT5mwBDcnD2v9I+k5SANTW5rneZtZagzIybIfrZfvCyEQ6m8gZ43br9cxi7QlWhKufnoJV7b9MRLH/aCD1dH4VuOxdFos0XPmezUPG2KUzOg3HMNENyphEGZAodj56y2cqB8BHToUTnw+sO3eTLL4OjctNnMeV+Mdi81/ckcbHagmwCskIUrvYm1PcepGme4o7BXgta5xKbP/LU9cFoaQN0Y699ALJDtvXn0vZ8vfHfj4Tw1xEIMexQVGPTTZyph/n5MuqSZ4hlSe3cCmjU29mLZ7z8gRwNSFsyLBx4V/sMCAcpU0J2G2GCcfX6pgmWPVv+ccXfjvFqi6gS5k7z4N+HK2KIR7ikyisCMvc+FRh3bE9Lgzy/KvNfKFIVLQk3W6zmRIFyfQ1YoqfvoAHKVip8yX1asfTjY+/MvaQSeVJF4DqPaTB3GoABlIGUlPCAACMtFZQPHnj5aWKuY1Hfit7365daG/Zp2UUNEYMWwNWMw23WwAmBh3iQ7PnRoLmSKPwGXx+tRoid+xlxIDPm3bqlWtpkSaNSsHswqMeF6d0sNjG+NyIQ3f89q/1o1jcm+i8OKddzZ8xDsnu0gtWu7ahbJIsEpFIdv4s=",
  7. "AccessKeyId":"STS.JuMmRPUoQR2VVgMBfZEmS14pi",
  8. "Bucket":"cloudphoto-demo",
  9. "ObjectKey":"stores/cloudphoto-demo/data/ZUBaS964T3OYtqaal9MaZwAAAApwZDIE",
  10. "OssEndpoint":"http://oss-cn-shanghai.aliyuncs.com",
  11. "FileId":"ZUBaS964T3OYtqaal9MaZwAAAApwZDIE"
  12. }
  13. },
  14. "Action":"CreateTransaction",
  15. "Message":"success",
  16. "RequestId":"AE1425D0-1A04-4C28-A121-DE4BE33BC8F7",
  17. "Code":"Success"
  18. }

XML格式

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <CreateTransactionResponse>
  3. <Transaction>
  4. <Upload>
  5. <SessionId>pCoPsrk3CzFr4D-wHpHLzgACowAAAAFdRAPKWQAAAApwZAYD</SessionId>
  6. <AccessKeySecret>B2xArrNPUDogbQpvY69zZ9qzNNxWf8TV7nzKs3mVQfVd</AccessKeySecret>
  7. <StsToken>CAISjQN1q6Ft5B2yfSjIrYDWCszjrq5UwLqzU0XEsEwvav8ehbfNszz2IH9PdXRuCe4esv00mmlW7PYelqZ4T5hYSVTEatd3q5ha9AT5ixBDcnD2v9I+k5SANTW5rneZtZagzIybIfrZfvCyEQ6m8gZ43br9cxi7QlWhKufnoJV7b9MRLH/aCD1dH4VuOxdFos0XPmezUPG2KUzOg3HMNENyphEGZAodj56y2cqB8BHToUTnw+sO3eTLL4OjctNnMeV+Mdi81/ckcbHagmwCskIUrvYm1PcepGme4o7BXgta5xKbP/LU9cFoaQN0Y699ALJDtvXn0vZ8vfHfj4Tw1xEIMexQVGPTTZyph/TqHKaFFc9hSejcFy3Dyu6VCqHSvyoNSFsyLBx4V/sMCAcpU0J2G2GCcfX6pgmWPVv+ccXfjvFqi6gS5k7z4N+HK2KIR7ikyisCMvc+FRh3bE9Lgzy/KvNfKFIVLQk3W6zmRIFyfQ1YoqfvoAHKVip8yX1asfTjY+/MvaQSeVJF4DqPaTB3GoABGOtX6ePhCBjjXTNs556iGRm9olEfcXmkLLl9PoQR0gP8Dyw4MP0Nbp3w47X/ImB4u1X5HgS4YPdFjl+98MssWR+KOFcq+EreAOlqlm+KpahtXQJRRJK5pP+af4OwCQdHwI1DkNKm6IbKuQcfTrmU6zvvfiWIzKWcxOUgcv+6Sog=</StsToken>
  8. <AccessKeyId>STS.LCcAvWCquwxXQcuTLzfp2jrfQ</AccessKeyId>
  9. <Bucket>cloudphoto-demo</Bucket>
  10. <ObjectKey>stores/cloudphoto-demo/data/WFl-DKq0T6OD1fpVrTPOdAAAAApwZDIE</ObjectKey>
  11. <OssEndpoint>http://oss-cn-shanghai.aliyuncs.com</OssEndpoint>
  12. <FileId>WFl-DKq0T6OD1fpVrTPOdAAAAApwZDIE</FileId>
  13. </Upload>
  14. </Transaction>
  15. <Action>CreateTransaction</Action>
  16. <Message>success</Message>
  17. <RequestId>5C32C7CA-9CCB-4831-9022-26A611E1E32E</RequestId>
  18. <Code>Success</Code>
  19. </CreateTransactionResponse>
本文导读目录