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” |
示例
请求示例
POST https://imm.cn-hangzhou.aliyuncs.com
?Action=PutProject
&Project=test&Type=DocStarter&CU=1
...
此处的示例,目的是展示关键参数,还需要其他的公共参数才能正常调用,推荐使用 SDK 来发送 API。
返回示例
{
"RequestId": "FF3B7D81-66AE-47E0-BF69-157DCF187514",
"Project" : "test",
"ServiceRole ": "" ,
"CU":1,
"BillingType": "ByCU"
"Type":"DocStarter",
"CreateTime": "2018-08-02T03:50:28Z",
"ModifyTime": "2018-08-02T03:50:28Z"
}
错误码
错误代码 | 错误信息 | 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 说明 |
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论