开发者社区> 问答> 正文

云相册的API开发接口CreateTransaction怎么使用



描述


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


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


请求参数

参数名类型是否必须说明
ActionStringCreateTransaction
ExtString文件的扩展名
ForceBoolean保留参数,设置为true
Md5String待上传文件的Md5,如果提供了且合法,将用于验证文件上传。
SizeInteger待上传文件的大小
StoreNameStringPhotoStore的名称
LibraryIdString照片库标识。采用AK认证时必选,采用STS认证时可选。了解不同认证方式的区别。


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





返回参数

参数名类型说明
RequestIdString唯一标识本次请求的ID
CodeString响应状态码,Success表示成功的响应
MessageString响应状态详细描述
ActionStringCreateTransaction
TransactionTransactionTransaction对象


Transaction

参数名类型说明
UploadUploadUpload对象


Upload

参数名类型说明
AccessKeyIdString用于上传文件到OSS的临时AccessKeyId
AccessKeySecretString用于上传文件到OSS的临时Secret
BucketString用于上传文件到OSS的Bucket
FileIdString待上传文件对应到存储在OSS上的文件名,CreatePhoto接口需要用到这个值
ObjectKeyString待上传文件在OSS Bucket中的路径,文件上传后,将存储在对应OSS Bucket的这个路径
OssEndpointString文件将要上传到的OSS的EndPoint
SessionIdString表示一个上传文件的会话ID,CreatePhoto接口需要用到这个值
StsTokenString用于上传文件到OSS的临时Security Token


返回示例


JSON格式 {
    "Transaction":{
        "Upload":{
            "SessionId":"hLB2ktiDiXojjjINEsQNCwACowAAAAFdRAPCZQAAAApwZAYD",
            "AccessKeySecret":"AVPraikAoJxNKPZQBAm5Rh6RbbtkvaM2typxPCAJtSCT",
            "StsToken":"CAISjQN1q6Ft5B2yfSjIq7b4JujkuLBw5fC9VEH8pmYPSeJ/3vHbizz2IH9PdXRuCe4esv00mmlW7PYelqZ4T5hYSVTEatd3q5ha9AT5mwBDcnD2v9I+k5SANTW5rneZtZagzIybIfrZfvCyEQ6m8gZ43br9cxi7QlWhKufnoJV7b9MRLH/aCD1dH4VuOxdFos0XPmezUPG2KUzOg3HMNENyphEGZAodj56y2cqB8BHToUTnw+sO3eTLL4OjctNnMeV+Mdi81/ckcbHagmwCskIUrvYm1PcepGme4o7BXgta5xKbP/LU9cFoaQN0Y699ALJDtvXn0vZ8vfHfj4Tw1xEIMexQVGPTTZyph/n5MuqSZ4hlSe3cCmjU29mLZ7z8gRwNSFsyLBx4V/sMCAcpU0J2G2GCcfX6pgmWPVv+ccXfjvFqi6gS5k7z4N+HK2KIR7ikyisCMvc+FRh3bE9Lgzy/KvNfKFIVLQk3W6zmRIFyfQ1YoqfvoAHKVip8yX1asfTjY+/MvaQSeVJF4DqPaTB3GoABlIGUlPCAACMtFZQPHnj5aWKuY1Hfit7365daG/Zp2UUNEYMWwNWMw23WwAmBh3iQ7PnRoLmSKPwGXx+tRoid+xlxIDPm3bqlWtpkSaNSsHswqMeF6d0sNjG+NyIQ3f89q/1o1jcm+i8OKddzZ8xDsnu0gtWu7ahbJIsEpFIdv4s=",
            "AccessKeyId":"STS.JuMmRPUoQR2VVgMBfZEmS14pi",
            "Bucket":"cloudphoto-demo",
            "ObjectKey":"stores/cloudphoto-demo/data/ZUBaS964T3OYtqaal9MaZwAAAApwZDIE",
            "OssEndpoint":"http://oss-cn-shanghai.aliyuncs.com",
            "FileId":"ZUBaS964T3OYtqaal9MaZwAAAApwZDIE"
        }
    },
    "Action":"CreateTransaction",
    "Message":"success",
    "RequestId":"AE1425D0-1A04-4C28-A121-DE4BE33BC8F7",
    "Code":"Success"
}


XML格式 <?xml version="1.0" encoding="UTF-8"?>
<CreateTransactionResponse>
  <Transaction>
    <Upload>
      <SessionId>pCoPsrk3CzFr4D-wHpHLzgACowAAAAFdRAPKWQAAAApwZAYD</SessionId>
      <AccessKeySecret>B2xArrNPUDogbQpvY69zZ9qzNNxWf8TV7nzKs3mVQfVd</AccessKeySecret>
      <StsToken>CAISjQN1q6Ft5B2yfSjIrYDWCszjrq5UwLqzU0XEsEwvav8ehbfNszz2IH9PdXRuCe4esv00mmlW7PYelqZ4T5hYSVTEatd3q5ha9AT5ixBDcnD2v9I+k5SANTW5rneZtZagzIybIfrZfvCyEQ6m8gZ43br9cxi7QlWhKufnoJV7b9MRLH/aCD1dH4VuOxdFos0XPmezUPG2KUzOg3HMNENyphEGZAodj56y2cqB8BHToUTnw+sO3eTLL4OjctNnMeV+Mdi81/ckcbHagmwCskIUrvYm1PcepGme4o7BXgta5xKbP/LU9cFoaQN0Y699ALJDtvXn0vZ8vfHfj4Tw1xEIMexQVGPTTZyph/TqHKaFFc9hSejcFy3Dyu6VCqHSvyoNSFsyLBx4V/sMCAcpU0J2G2GCcfX6pgmWPVv+ccXfjvFqi6gS5k7z4N+HK2KIR7ikyisCMvc+FRh3bE9Lgzy/KvNfKFIVLQk3W6zmRIFyfQ1YoqfvoAHKVip8yX1asfTjY+/MvaQSeVJF4DqPaTB3GoABGOtX6ePhCBjjXTNs556iGRm9olEfcXmkLLl9PoQR0gP8Dyw4MP0Nbp3w47X/ImB4u1X5HgS4YPdFjl+98MssWR+KOFcq+EreAOlqlm+KpahtXQJRRJK5pP+af4OwCQdHwI1DkNKm6IbKuQcfTrmU6zvvfiWIzKWcxOUgcv+6Sog=</StsToken>
      <AccessKeyId>STS.LCcAvWCquwxXQcuTLzfp2jrfQ</AccessKeyId>
      <Bucket>cloudphoto-demo</Bucket>
      <ObjectKey>stores/cloudphoto-demo/data/WFl-DKq0T6OD1fpVrTPOdAAAAApwZDIE</ObjectKey>
      <OssEndpoint>http://oss-cn-shanghai.aliyuncs.com</OssEndpoint>
      <FileId>WFl-DKq0T6OD1fpVrTPOdAAAAApwZDIE</FileId>
    </Upload>
  </Transaction>
  <Action>CreateTransaction</Action>
  <Message>success</Message>
  <RequestId>5C32C7CA-9CCB-4831-9022-26A611E1E32E</RequestId>
  <Code>Success</Code>
</CreateTransactionResponse>

展开
收起
云栖大讲堂 2017-10-27 10:07:00 2024 0
0 条回答
写回答
取消 提交回答
问答排行榜
最热
最新

相关电子书

更多
Spring Boot2.0实战Redis分布式缓存 立即下载
CUDA MATH API 立即下载
API PLAYBOOK 立即下载