调用UpdateImage接口更新媒体集中用户自定义的图片信息。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | UpdateImage |
操作接口名称,系统规定参数,固定取值为UpdateImage。 |
ImageUri | String | 是 | oss://imm-test/testcases/face1.jpg |
图片的OSS Uri。 OSS地址规则为 |
Project | String | 是 | immimagetest |
项目名称。 |
SetId | String | 是 | ser001 |
媒体集的唯一标识。 |
RegionId | String | 否 | cn-hangzhou |
项目所在地域的ID。 |
RemarksA | String | 否 | remarksa1 |
标记信息,为使用者预留的筛选参数,用于记录所需要的信息。 |
RemarksB | String | 否 | remarksb1 |
标记信息,为使用者预留的筛选参数,用于记录所需要的信息。 |
SourceType | String | 否 | image |
源数据的类型,包括如下选项:
|
SourceUri | String | 否 | oss://imm-test/testcases/face1.jpg |
图片的OSS Uri。 OSS地址规则为 |
SourcePosition | String | 否 | oss://imm-test/testcases/ |
图片的存储位置。 |
RemarksC | String | 否 | remarksc1 |
标记信息,为使用者预留的筛选参数,用于记录所需要的信息。 |
RemarksD | String | 否 | remarksd1 |
标记信息,为使用者预留的筛选参数,用于记录所需要的信息。 |
ExternalId | String | 否 | externalId002 |
外部ID,用于和您的应用层的ID(如果有)进行绑定。 |
RemarksArrayA | String | 否 | ["remarka11","remarka12"] |
标记信息列表。 |
RemarksArrayB | String | 否 | ["remarkb11","remarkb12"] |
标记信息列表。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
CreateTime | String | 2020-11-24T10:56:52.461Z |
图片加入媒体集的时间。 |
ExternalId | String | externalId002 |
外部ID,用于和您的应用层的ID(如果有)进行绑定。 |
ImageUri | String | oss://imm-test/testcases/face1.jpg |
图片的OSS Uri。 |
ModifyTime | String | 2020-11-25T10:56:52.461Z |
图片的修改时间。 |
RemarksA | String | remarksa1 |
标记信息。 如果更新图片时未设置此参数,则返回值为图片加入媒体集时设置的标记信息。 |
RemarksArrayA | String | ["remarka11","remarka12"] |
标记信息列表。 如果更新图片时未设置此参数,则返回值为图片加入媒体集时设置的标记信息列表。 |
RemarksArrayB | String | ["remarkb11","remarkb12"] |
标记信息列表。 如果更新图片时未设置此参数,则返回值为图片加入媒体集时设置的标记信息列表。 |
RemarksB | String | remarksb1 |
标记信息。 如果更新图片时未设置此参数,则返回值为图片加入媒体集时设置的标记信息。 |
RemarksC | String | remarksc1 |
标记信息。 如果更新图片时未设置此参数,则返回值为图片加入媒体集时设置的标记信息。 |
RemarksD | String | remarksd1 |
标记信息。 如果更新图片时未设置此参数,则返回值为图片加入媒体集时设置的标记信息。 |
RequestId | String | 7A25A44E-5E7D-4F0C-95C5-BA5BD96B7890 |
当次请求的Request ID。 |
SetId | String | set001 |
媒体集的唯一标识。 |
示例
请求示例
http(s)://[Endpoint]/?Action=UpdateImage
&ImageUri=oss://imm-test/testcases/face1.jpg
&Project=immimagetest
&SetId=ser001
&<公共请求参数>
正常返回示例
XML
格式
<ModifyTime>2020-11-25T10:56:52.461Z</ModifyTime>
<RequestId>7A25A44E-5E7D-4F0C-95C5-BA5BD96B7890</RequestId>
<ExternalId>externalId002</ExternalId>
<CreateTime>2020-11-24T10:56:52.461Z</CreateTime>
<RemarksA>remarksa1</RemarksA>
<ImageUri>oss://imm-test/testcases/face1.jpg</ImageUri>
<RemarksB>remarksb1</RemarksB>
<RemarksArrayB>["remarkb11","remarkb12"]</RemarksArrayB>
<RemarksC>remarksc1</RemarksC>
<RemarksD>remarksd1</RemarksD>
<RemarksArrayA>["remarka11","remarka12"]</RemarksArrayA>
<SetId>set001</SetId>
JSON
格式
{
"ModifyTime": "2020-11-25T10:56:52.461Z",
"RequestId": "7A25A44E-5E7D-4F0C-95C5-BA5BD96B7890",
"ExternalId": "externalId002",
"CreateTime": "2020-11-24T10:56:52.461Z",
"RemarksA": "remarksa1",
"ImageUri": "oss://imm-test/testcases/face1.jpg",
"RemarksB": "remarksb1",
"RemarksArrayB": "[\"remarkb11\",\"remarkb12\"]",
"RemarksC": "remarksc1",
"RemarksD": "remarksd1",
"RemarksArrayA": "[\"remarka11\",\"remarka12\"]",
"SetId": "set001"
}