› 推特 ›阿里云技术文档›正文

CreateTransaction_照片接口_API手册_智能云相册

admin 阿里云技术文档 2020-02-11 244 0

阿里云服务器优惠

CreateTransaction

描述

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

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

请求参数

参数名	类型	是否必须	说明
Action	String	是	CreateTransaction
Ext	String	是	文件的扩展名
Md5	String	是	待上传文件的Md5，如果提供了且合法，将用于验证文件上传。
Size	Integer	是	待上传文件的大小（单位：字节）
StoreName	String	是	PhotoStore的名称
LibraryId	String	否	照片库标识。采用AK认证时必选，采用STS认证时可选。了解不同认证方式的区别。

请求示例

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

返回参数

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

{
    "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>

版权声明

本文仅代表作者观点，不代表本站立场。
本文系作者授权发表，未经许可，不得转载。

评论

-----