全部产品
云市场

EditPhotos

更新时间:2018-01-15 18:10:40

描述

批量编辑照片,可设置照片的分享时间,备注和Title。

在服务可用的情况下,该接口总是返回Success,需要根据返回结果里面的Result来判断具体单张照片的处理结果。

支持的SDK版本:1.1.5+

请求参数

参数名 类型 是否必须 说明
Action String EditPhotos
PhotoId.1 Long 照片的唯一标识,如果有多张照片,请按照规则增加一个参数,比如2张照片,另外一个参数为PhotoId.2
Remark String 需要设置的备注,如果不需要修改备注,就不用传该参数。
ShareExpireTime String 需要设置的分享时间,可选值为0或者大于当前时间的时间戳,(单位:毫秒)。
Title String 需要设置的Title,如果不需要修改Title,就不用传该参数。
StoreName String PhotoStore的名称
LibraryId String 照片库标识。采用AK认证时必选,采用STS认证时可选。了解不同认证方式的区别。

其中,ShareExpireTime,Title和Remark三个参数需要至少提供一个。没有传的那个参数的值就不会被修改。

请求示例

  1. https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=EditPhotos
  2. &PhotoId.1=859482148925661184
  3. &Remark=new remark
  4. &ShareExpireTime=1508815333015
  5. &StoreName=cloudphoto-regression-store
  6. &Title=new title
  7. &<公共请求参数>

返回参数

参数名 类型 说明
RequestId String 唯一标识本次请求的ID
Code String 响应状态码,Success表示成功的响应
Message String 响应状态详细描述
Action String EditPhotos
Results 数组 详见结果信息

Results

参数名 类型 说明
Code String 状态码,Success表示成功
Id String 照片的Id
Message String 详细信息

返回示例

JSON格式

  1. {
  2. "Action":"EditPhotos",
  3. "Message":"success",
  4. "RequestId":"5151C3D6-C675-416A-B68F-ACD0888CCE90",
  5. "Results":[
  6. {
  7. "Message":"success",
  8. "Id":859482148925661184,
  9. "Code":"Success"
  10. }
  11. ],
  12. "Code":"Success"
  13. }

XML格式

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <EditPhotosResponse>
  3. <Action>EditPhotos</Action>
  4. <Message>success</Message>
  5. <RequestId>1F202858-4EFF-400F-84FE-72C18CBBC1FF</RequestId>
  6. <Results>
  7. <Result>
  8. <Message>success</Message>
  9. <Id>859482148925661184</Id>
  10. <Code>Success</Code>
  11. </Result>
  12. </Results>
  13. <Code>Success</Code>
  14. </EditPhotosResponse>