调用PutProject接口创建一个项目。

背景信息

建议使用控制台创建项目,以便您了解和确认计费相关信息。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
RegionId String cn-hangzhou

项目所在地域的ID。

Action String PutProject

操作接口名称,系统规定参数,固定取值为PutProject。

Project String immtest

项目名称。

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

ServiceRole String AliyunIMMDefaultRole

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

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

返回数据

名称 类型 示例值 描述
Project String immtest

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

ModifyTime String 2020-11-10T03:50:28Z

项目的修改时间。

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

Type String DocStarter

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

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

CU Integer 5

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

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

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

ServiceRole String AliyunIMMDefaultRole

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

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

RequestId String 7F7D235C-76FF-4B65-800C-8238AE3F7230

当次请求的Request ID。

Endpoint String imm.cn-hangzhou.aliyuncs.com

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

CreateTime String 2020-11-10T03:50:28Z

项目的创建时间。

RegionId String cn-hangzhou

项目所在地域的ID。

BillingType String ByCU

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

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

示例

请求示例

http(s)://[Endpoint]/?Action=PutProject
&Project=immtest
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

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

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

HttpCode

错误码

错误信息

描述

400

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

指定的Project名称无效。

400

InvalidProject.AlreadyExist

The resource Project already exists. Please check.

指定的Project已存在。

400

InvalidProject.Deleting

The resource Project is deleting. Please check.

指定的Project正在删除中,项目会在北京时间次日凌晨删除。删除后,才可以新建同名的项目,如果需要立即创建同名的项目,请提交工单

400

InvalidParameter.Type

The input parameter Type is not valid. Please refer to document.

Type的类型不合法,请参考Type参数的描述进行设置。

400

InvalidParameter.CU

The input parameter CU is not valid. Please refer to document.

CU值不合法,请参考CU参数的描述进行设置。