Teams - Create

참조

Service:: Core

API Version:: 7.1-preview.3

팀 프로젝트에서 팀을 만듭니다.

가능한 오류 시나리오 잘못된 프로젝트 이름/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 조직의 이름입니다.
projectId	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	Identity	팀 ID.
identityUrl	string	이 팀에 대한 ID REST API URL
name	string	팀 이름
projectId	string
projectName	string
url	string	Team REST API Url

응답

Name	형식	Description
200 OK	WebApiTeam	성공적인 작업

보안

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

HTTP

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

Status code:: 200

{
  "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
IdentityDescriptor	ID 설명자는 SID 또는 PUID와 같은 고유 식별자와 함께 ID 형식(Windows SID, Passport)에 대한 래퍼입니다.
PropertiesCollection	클래스는 키-값 쌍의 컬렉션으로 속성 모음을 나타냅니다. 를 제외한 모든 기본 형식의 값(을 `TypeCode != TypeCode.Object`제외한 `DBNull` 모든 형식)이 허용됩니다. Byte[], Int32, Double, DateType 및 String 형식의 값은 해당 형식을 유지하며 다른 기본 형식은 String으로 다시 조정됩니다. byte[] base64로 인코딩된 문자열로 예상됩니다.
WebApiTeam

Identity

Name	형식	Description
customDisplayName	string	ID에 대한 사용자 지정 표시 이름(있는 경우)입니다. 이 속성을 빈 문자열로 설정하면 기존 사용자 지정 표시 이름이 지워지게 됩니다. 이 속성을 null로 설정해도 기존 지속형 값에는 영향을 미치지 않습니다(null 값이 유선 또는 데이터베이스로 전송되지 않기 때문에).
descriptor	IdentityDescriptor	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	IdentityDescriptor[]	ID 설명자는 SID 또는 PUID와 같은 고유 식별자와 함께 ID 형식(Windows SID, Passport)에 대한 래퍼입니다.
members	IdentityDescriptor[]	ID 설명자는 SID 또는 PUID와 같은 고유 식별자와 함께 ID 형식(Windows SID, Passport)에 대한 래퍼입니다.
metaTypeId	integer
properties	PropertiesCollection	클래스는 키-값 쌍의 컬렉션으로 속성 모음을 나타냅니다. 를 제외한 모든 기본 형식의 값(을 `TypeCode != TypeCode.Object`제외한 `DBNull` 모든 형식)이 허용됩니다. Byte[], Int32, Double, DateType 및 String 형식의 값은 해당 형식을 유지하며 다른 기본 형식은 String으로 다시 조정됩니다. byte[] base64로 인코딩된 문자열로 예상됩니다.
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	Identity	팀 ID.
identityUrl	string	이 팀에 대한 ID REST API URL
name	string	팀 이름
projectId	string
projectName	string
url	string	Team REST API Url

다음을 통해 공유