Projects - Create

参考

Service:: Core

API Version:: 7.1-preview.4

对要创建的项目进行排队。使用 GetOperation 定期检查创建项目状态。

POST https://dev.azure.com/{organization}/_apis/projects?api-version=7.1-preview.4

URI 参数

名称	在	必需	类型	说明
organization	path	True	string	Azure DevOps 组织的名称。
api-version	query	True	string	要使用的 API 版本。这应设置为“7.1-preview.4”才能使用此版本的 API。

请求正文

名称	类型	说明
_links	ReferenceLinks	指向与此对象相关的其他对象的链接。
abbreviation	string	项目缩写。
capabilities	object	此项目具有 (的功能集，例如过程模板 & 版本控制) 。
defaultTeam	WebApiTeamRef	默认团队的浅层引用。
defaultTeamImageUrl	string	默认团队标识图像的 URL。
description	string	如果有任何) ，项目说明 (。
id	string	项目标识符。
lastUpdateTime	string	Project 上次更新时间。
name	string	项目名称。
revision	integer	项目修订。
state	ProjectState	项目状态。
url	string	对象完整版本的 URL。
visibility	ProjectVisibility	项目可见性。

响应

名称	类型	说明
200 OK	OperationReference	成功的操作

安全性

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Scopes

名称	说明
vso.project_manage	授予创建、读取、更新和删除项目和团队的能力。

示例

Sample Request

HTTP

POST https://dev.azure.com/fabrikam/_apis/projects?api-version=7.1-preview.4

{
  "name": "FabrikamTravel",
  "description": "Frabrikam travel app for Windows Phone",
  "capabilities": {
    "versioncontrol": {
      "sourceControlType": "Git"
    },
    "processTemplate": {
      "templateTypeId": "6b724908-ef14-45cf-84f8-768b5384da45"
    }
  }
}

Sample Response

Status code:: 202

{
  "id": "066488b8-b14e-43d1-befc-a2e655266e2b",
  "status": "queued",
  "url": "https://dev.azure.com/fabrikam/_apis/operations/066488b8-b14e-43d1-befc-a2e655266e2b"
}

定义

名称	说明
OperationReference	异步操作的引用。
OperationStatus	操作的当前状态。
ProjectState	项目的当前状态。
ProjectVisibility	指示项目对谁可见。
ReferenceLinks	表示 REST 引用链接集合的类。
TeamProject	表示团队项目对象。
WebApiTeamRef

OperationReference

异步操作的引用。

名称	类型	说明
id	string	操作的唯一标识符。
pluginId	string	插件的唯一标识符。
status	OperationStatus	操作的当前状态。
url	string	用于获取完整操作对象的 URL。

OperationStatus

操作的当前状态。

名称	类型	说明
cancelled	string	操作已被用户取消。
failed	string	操作已完成，但失败。
inProgress	string	操作正在进行中。
notSet	string	操作未设置状态。
queued	string	操作已排队。
succeeded	string	操作已成功完成。

ProjectState

项目的当前状态。

名称	类型	说明
all	string	所有项目，不考虑状态，已删除。
createPending	string	项目已排队等待创建，但该过程尚未启动。
deleted	string	已删除项目。
deleting	string	正在删除 Project。
new	string	项目正在创建过程中。
unchanged	string	项目尚未更改。
wellFormed	string	项目已完全创建并可供使用。

ProjectVisibility

指示项目对谁可见。

名称	类型	说明
private	string	项目仅对具有显式访问权限的用户可见。
public	string	项目对所有人都可见。

ReferenceLinks

表示 REST 引用链接集合的类。

名称	类型	说明
links	object	链接的只读视图。由于引用链接是只读的，因此我们只想将其公开为只读。

TeamProject

表示团队项目对象。

名称	类型	说明
_links	ReferenceLinks	指向与此对象相关的其他对象的链接。
abbreviation	string	项目缩写。
capabilities	object	此项目具有 (的功能集，例如过程模板 & 版本控制) 。
defaultTeam	WebApiTeamRef	默认团队的浅层引用。
defaultTeamImageUrl	string	默认团队标识图像的 URL。
description	string	如果有任何) ，项目说明 (。
id	string	项目标识符。
lastUpdateTime	string	Project 上次更新时间。
name	string	项目名称。
revision	integer	项目修订。
state	ProjectState	项目状态。
url	string	对象完整版本的 URL。
visibility	ProjectVisibility	项目可见性。

WebApiTeamRef

名称	类型	说明
id	string	团队 (标识) Guid。 Team Foundation ID。
name	string	球队名称
url	string	团队 REST API URL

Share via