文档

PutProject - 创建一个项目

更新时间:

目前支持创建文档标准型、图片标准型和视频标准型项目,请根据需要处理的内容类型创建相应项目。

接口说明

  • 此接口已不再维护,建议使用新版(2020-09-30 版本)接口 CreateProject 。关于新版与旧版 API 的对比,请参见新旧版本使用指引中的新版与旧版 API 对应关系说明章节。
  • 建议通过控制台创建项目,以便您了解和确认计费相关信息。具体操作,请参见创建项目

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
imm:PutProjectcreate
  • 全部资源
    *

请求参数

名称类型必填描述示例值
Projectstring

项目名称。

项目名称的长度限制为 1~50 字符,只能包含英文字母,数字和短横线(-),必须以英文字母开头,且不能为 ALL(保留字)。

immtest
ServiceRolestring

服务角色,授权给 IMM 服务以访问其他云资源(例如 OSS)的权限,默认值为 AliyunIMMDefaultRole。

您也可以通过 RAM 控制台创建授权角色。具体操作,请参见创建普通服务角色

AliyunIMMDefaultRole

返回参数

名称类型描述示例值
object
Projectstring

项目名称,和请求时一致。

immtest
ModifyTimestring

项目的修改时间。

创建项目后,如果未更新过项目,则项目的修改时间和项目的创建时间相同。

2020-11-10T03:50:28Z
Typestring

2021.04.01 以后创建的项目类型默认为内容管理,已创建的项目不受影响。

项目的类型,和请求时一致。

DocStarter
CUinteger

2021.04.01 以后创建的类型为内容管理的项目该字段无效。

当 BillingType 设置为 ByCU 时,此参数才生效。

每秒能够处理的最大请求数,和请求时一致。

5
ServiceRolestring

服务角色,和请求时一致。

如果创建项目时未指定此参数,则返回值为空。

AliyunIMMDefaultRole
RequestIdstring

当次请求的 Request ID。

7F7D235C-76FF-4B65-800C-8238AE3F7230
Endpointstring

项目所在地域的服务地址。

imm.cn-hangzhou.aliyuncs.com
CreateTimestring

项目的创建时间。

2020-11-10T03:50:28Z
RegionIdstring

项目所在地域的 ID。

cn-hangzhou
BillingTypestring

2021.04.01 以后创建的类型为内容管理的项目该字段无效。

计费类型,和请求时一致。

ByCU

示例

正常返回示例

JSON格式

{
  "Project": "immtest",
  "ModifyTime": "2020-11-10T03:50:28Z",
  "Type": "DocStarter",
  "CU": 5,
  "ServiceRole": "AliyunIMMDefaultRole",
  "RequestId": "7F7D235C-76FF-4B65-800C-8238AE3F7230",
  "Endpoint": "imm.cn-hangzhou.aliyuncs.com",
  "CreateTime": "2020-11-10T03:50:28Z",
  "RegionId": "cn-hangzhou",
  "BillingType": "ByCU"
}

错误码

访问错误中心查看更多错误码。

错误码

HttpCode错误码错误信息描述
400InvalidParameter.ProjectThe input parameter Project is not valid. Only (a ~ z. A ~ Z. 0 ~ 9. -) allowed and start with a letter. less than 50 chars指定的 Project 名称无效。
400InvalidProject.AlreadyExistThe resource Project already exists. Please check.指定的 Project 已存在。
400InvalidProject.DeletingThe resource Project is deleting. Please check.指定的 Project 正在删除中,项目会在北京时间次日凌晨删除。删除后,才可以新建同名的项目,如果需要立即创建同名的项目,请使用钉钉搜索钉钉群号 31690030817 加入钉钉群进行反馈。
400InvalidParameter.TypeThe input parameter Type is not valid. Please refer to document.Type 的类型不合法,请参考 Type 参数的描述进行设置。
400InvalidParameter.CUThe input parameter CU is not valid. Please refer to document.CU 值不合法,请参考 CU 参数的描述进行设置。