Teams - Create
팀 프로젝트에서 팀을 만듭니다.
가능한 오류 시나리오 잘못된 프로젝트 이름/ID(프로젝트가 없음) 404 잘못된 팀 이름 또는 설명 400 팀이 이미 400 불충분한 권한 400
POST https://dev.azure.com/{organization}/_apis/projects/{projectId}/teams?api-version=7.1-preview.3
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
organization
|
path | True |
string |
Azure DevOps 조직의 이름입니다. |
project
|
path | True |
string |
팀을 만들 팀 프로젝트의 이름 또는 ID(GUID)입니다. |
api-version
|
query | True |
string |
사용할 API의 버전입니다. 이 버전의 api를 사용하려면 '7.1-preview.3'으로 설정해야 합니다. |
요청 본문
Name | 형식 | Description |
---|---|---|
description |
string |
팀 설명 |
id |
string |
팀(ID) Guid입니다. Team Foundation ID입니다. |
identity |
팀 ID. |
|
identityUrl |
string |
이 팀에 대한 ID REST API URL |
name |
string |
팀 이름 |
projectId |
string |
|
projectName |
string |
|
url |
string |
Team REST API Url |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
성공적인 작업 |
보안
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
Name | Description |
---|---|
vso.project_manage | 프로젝트 및 팀을 만들고, 읽고, 업데이트하고, 삭제할 수 있는 기능을 부여합니다. |
예제
Sample Request
POST https://dev.azure.com/fabrikam/_apis/projects/8e5a3cfb-fed3-46f3-8657-e3b175cd0305/teams?api-version=7.1-preview.3
{
"name": "My new team"
}
Sample Response
{
"id": "8e8aa4ff-848a-474a-9033-93190137c8e4",
"name": "My New Team",
"url": "https://dev.azure.com/fabrikam/_apis/projects/8e5a3cfb-fed3-46f3-8657-e3b175cd0305/teams/8e8aa4ff-848a-474a-9033-93190137c8e4",
"description": "",
"identityUrl": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/8e8aa4ff-848a-474a-9033-93190137c8e4"
}
정의
Name | Description |
---|---|
Identity | |
Identity |
ID 설명자는 SID 또는 PUID와 같은 고유 식별자와 함께 ID 형식(Windows SID, Passport)에 대한 래퍼입니다. |
Properties |
클래스는 키-값 쌍의 컬렉션으로 속성 모음을 나타냅니다. 를 제외한 모든 기본 형식의 값(을 |
Web |
Identity
Name | 형식 | Description |
---|---|---|
customDisplayName |
string |
ID에 대한 사용자 지정 표시 이름(있는 경우)입니다. 이 속성을 빈 문자열로 설정하면 기존 사용자 지정 표시 이름이 지워지게 됩니다. 이 속성을 null로 설정해도 기존 지속형 값에는 영향을 미치지 않습니다(null 값이 유선 또는 데이터베이스로 전송되지 않기 때문에). |
descriptor |
ID 설명자는 SID 또는 PUID와 같은 고유 식별자와 함께 ID 형식(Windows SID, Passport)에 대한 래퍼입니다. |
|
id |
string |
ID 식별자입니다. 스토리지 키 또는 VSID라고도 함 |
isActive |
boolean |
true이면 id에 organization Azure Devops 그룹에 멤버 자격이 있습니다. |
isContainer |
boolean |
TRUE이면 ID가 그룹입니다. |
masterId |
string |
|
memberIds |
string[] |
ID의 멤버 ID입니다(그룹만 해당). |
memberOf |
ID 설명자는 SID 또는 PUID와 같은 고유 식별자와 함께 ID 형식(Windows SID, Passport)에 대한 래퍼입니다. |
|
members |
ID 설명자는 SID 또는 PUID와 같은 고유 식별자와 함께 ID 형식(Windows SID, Passport)에 대한 래퍼입니다. |
|
metaTypeId |
integer |
|
properties |
클래스는 키-값 쌍의 컬렉션으로 속성 모음을 나타냅니다. 를 제외한 모든 기본 형식의 값(을 |
|
providerDisplayName |
string |
원본 ID 공급자가 지정한 ID의 표시 이름입니다. |
resourceVersion |
integer |
|
socialDescriptor |
string |
|
subjectDescriptor |
string |
Graph 엔터티의 주체 설명자입니다. |
uniqueUserId |
integer |
IdentityDescriptor
ID 설명자는 SID 또는 PUID와 같은 고유 식별자와 함께 ID 형식(Windows SID, Passport)에 대한 래퍼입니다.
Name | 형식 | Description |
---|---|---|
identifier |
string |
이 ID의 고유 식별자이며 256자를 초과하지 않고 유지됩니다. |
identityType |
string |
설명자 유형(예: Windows, Passport 등)입니다. |
PropertiesCollection
클래스는 키-값 쌍의 컬렉션으로 속성 모음을 나타냅니다. 를 제외한 모든 기본 형식의 값(을 TypeCode != TypeCode.Object
제외한 DBNull
모든 형식)이 허용됩니다. Byte[], Int32, Double, DateType 및 String 형식의 값은 해당 형식을 유지하며 다른 기본 형식은 String으로 다시 조정됩니다. byte[] base64로 인코딩된 문자열로 예상됩니다.
Name | 형식 | Description |
---|---|---|
count |
integer |
컬렉션의 속성 수입니다. |
item |
object |
|
keys |
string[] |
컬렉션의 키 집합입니다. |
values |
string[] |
컬렉션의 값 집합입니다. |
WebApiTeam
Name | 형식 | Description |
---|---|---|
description |
string |
팀 설명 |
id |
string |
팀(ID) Guid입니다. Team Foundation ID입니다. |
identity |
팀 ID. |
|
identityUrl |
string |
이 팀에 대한 ID REST API URL |
name |
string |
팀 이름 |
projectId |
string |
|
projectName |
string |
|
url |
string |
Team REST API Url |