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

PutProject_Project 操作_API手册_智能媒体管理

admin 阿里云技术文档 2020-02-11 210 0
阿里云服务器优惠

PutProject

描述

创建 IMM 项目。强烈建议使用 控制台 进行项目创建操作，以便您确认计费相关信息。

注意：

您需要通过实名认证后方可执行本操作。

请求参数

名称 类型 是否必填 描述
Action String 是 PutProject
Project String 是 项目名，参考 命名规范
ServiceRole String 否 服务角色，本项目将拥有该角色的权限
BillingType String 否 计费类型，可选类型如下
ByCU : 按最大CU计费。
ByUsage : 按调用次数计费，目前仅对 Type = DocStarter 文档标准型开放。
默认不填写为 ByUsage ，即按调用次数计费。
对于 Type 为 PhotoStarter / VideoStarter 类型，需要显示指定 BillingType = ByCU ，不能留空。但是VideoStarter类型不计算CU费用，而是按照视频时长计费。
涉及收费，使用前请务必阅读 计费说明 。
CU Integer 否 注意：CU 是计费项目。Project 计算能力，表示 Project 所支持的最大并发请求数，最大 QPS。
仅当 BillingType 为 ByCU 时可以设置，取值范围 [0, 20]。
Type String 是 Project 类型，不同的 Project 类型支持的API操作不同，可选类型如下
DocStarter: 文档标准型，支持调用文档转换 API 和 预览
PhotoStarter: 图片标准型，支持标签、人脸识别等图片相关 API
VideoStarter: 视频标准型，视频类相关 API

项目名命名规范

  • 只能包含英文字母，数字和短横线
  • 必须以英文字母开头
  • 字符长度限制为50
  • 不能为 ALL（保留字）

返回参数

名称 类型 描述
RequestId String 用户发送的每次接口调用请求，无论成功与否，系统都会返回一个唯一识别码 RequestId 给用户
Project String 项目名
ServiceRole String 服务角色，本项目将拥有该角色的权限
CU Integer Project 计算能力
BillingType String 计费类型
Type String Project 类型
CreateTime String 创建时间，例如”2018-08-02T03:50:28Z”
ModifyTime String 修改时间，例如”2018-08-02T03:50:28Z”

示例

请求示例

  1. POST https://imm.cn-hangzhou.aliyuncs.com
  2. ?Action=PutProject
  3. &Project=test&Type=DocStarter&CU=1
  4. ...

此处的示例，目的是展示关键参数，还需要其他的公共参数才能正常调用，推荐使用 SDK 来发送 API。

返回示例

  1. {
  2.     "RequestId": "FF3B7D81-66AE-47E0-BF69-157DCF187514",
  3.     "Project" : "test",
  4.     "ServiceRole ": "" ,
  5.     "CU":1,
  6.     "BillingType": "ByCU"
  7.     "Type":"DocStarter",
  8.     "CreateTime": "2018-08-02T03:50:28Z",
  9.     "ModifyTime": "2018-08-02T03:50:28Z"
  10. }

错误码

错误代码 错误信息 HTTP 状态码 说明
InvalidParameter.Project The input parameter Project is not valid. Only (a ~ z. A ~ Z. 0 ~ 9. -) allowed and start with a letter. less than 50 chars 400 指定的 Project 名字无效
InvalidProject.AlreadyExist The resource Project already exists. Please check. 400 指定的 Project 已经存在
InvalidProject.Deleting The resource Project is deleting. Please check. 400 指定的 Project 正在删除中，Project 会在北京时间第二天凌晨删除，删除后，才可以新建同名的 Project，如果有特殊要求，需要马上创建，请提交工单
InvalidParameter.Type The input parameter Type is not valid. Please refer to document. 400 Type 类型不合法，请参考 Type 参数说明
InvalidParameter.CU The input parameter CU is not valid. Please refer to document. 400 CU 不合法，请参考 CU 说明

若在使用中有疑问，请参考 FAQ，或者进入 钉钉用户群 实时交流。

版权声明

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

评论

-----