Teams - Create

Referensi

Service:: Core

API Version:: 7.1-preview.3

Buat tim dalam proyek tim.

Kemungkinan skenario kegagalan Nama/ID proyek tidak valid (proyek tidak ada) 404 Nama tim tidak valid atau deskripsi 400 Tim sudah ada 400 Hak istimewa tidak mencukupi 400

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
organization	path	True	string	Nama organisasi Azure DevOps.
projectId	path	True	string	Nama atau ID (GUID) proyek tim untuk membuat tim.
api-version	query	True	string	Versi API yang akan digunakan. Ini harus diatur ke '7.1-preview.3' untuk menggunakan versi api ini.

Isi Permintaan

Nama	Jenis	Deskripsi
description	string	Deskripsi tim
id	string	Panduan Tim (Identitas). ID Yayasan Tim.
identity	Identity	Identitas tim.
identityUrl	string	Url REST API Identitas ke tim ini
name	string	Nama tim
projectId	string
projectName	string
url	string	Url REST API Tim

Respons

Nama	Jenis	Deskripsi
200 OK	WebApiTeam	operasi berhasil

Keamanan

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

Nama	Deskripsi
vso.project_manage	Memberikan kemampuan untuk membuat, membaca, memperbarui, dan menghapus proyek dan tim.

Contoh

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"
}

Definisi

Nama	Deskripsi
Identity
IdentityDescriptor	Deskriptor identitas adalah pembungkus untuk jenis identitas (Windows SID, Paspor) bersama dengan pengidentifikasi unik seperti SID atau PUID.
PropertiesCollection	Kelas mewakili tas properti sebagai kumpulan pasangan kunci-nilai. Nilai semua jenis primitif (jenis apa pun dengan ) `TypeCode != TypeCode.Object`kecuali `DBNull` diterima. Nilai jenis Byte[], Int32, Double, DateType dan String mempertahankan jenisnya, primitif lainnya disesuaikan sebagai String. Byte[] diharapkan sebagai string yang dikodekan base64.
WebApiTeam

Identity

Nama	Jenis	Deskripsi
customDisplayName	string	Nama tampilan kustom untuk identitas (jika ada). Mengatur properti ini ke string kosong akan menghapus nama tampilan kustom yang ada. Mengatur properti ini ke null tidak akan memengaruhi nilai persisten yang ada (karena nilai null tidak dikirim melalui kawat atau ke database)
descriptor	IdentityDescriptor	Deskriptor identitas adalah pembungkus untuk jenis identitas (Windows SID, Paspor) bersama dengan pengidentifikasi unik seperti SID atau PUID.
id	string	Pengidentifikasi Identitas. Juga disebut Kunci Penyimpanan, atau VSID
isActive	boolean	True jika identitas memiliki keanggotaan di grup Azure Devops mana pun di organisasi.
isContainer	boolean	True jika identitas adalah grup.
masterId	string
memberIds	string[]	Id anggota identitas (hanya grup).
memberOf	IdentityDescriptor[]	Deskriptor identitas adalah pembungkus untuk jenis identitas (Windows SID, Paspor) bersama dengan pengidentifikasi unik seperti SID atau PUID.
members	IdentityDescriptor[]	Deskriptor identitas adalah pembungkus untuk jenis identitas (Windows SID, Paspor) bersama dengan pengidentifikasi unik seperti SID atau PUID.
metaTypeId	integer
properties	PropertiesCollection	Kelas mewakili tas properti sebagai kumpulan pasangan kunci-nilai. Nilai semua jenis primitif (jenis apa pun dengan ) `TypeCode != TypeCode.Object`kecuali `DBNull` diterima. Nilai jenis Byte[], Int32, Double, DateType dan String mempertahankan jenisnya, primitif lainnya disesuaikan sebagai String. Byte[] diharapkan sebagai string yang dikodekan base64.
providerDisplayName	string	Nama tampilan untuk identitas seperti yang ditentukan oleh idP sumber.
resourceVersion	integer
socialDescriptor	string
subjectDescriptor	string	Pendeskripsi subjek entitas Graph.
uniqueUserId	integer

IdentityDescriptor

Deskriptor identitas adalah pembungkus untuk jenis identitas (Windows SID, Paspor) bersama dengan pengidentifikasi unik seperti SID atau PUID.

Nama	Jenis	Deskripsi
identifier	string	Pengidentifikasi unik untuk identitas ini, tidak melebihi 256 karakter, yang akan dipertahankan.
identityType	string	Jenis deskriptor (misalnya, Windows, Paspor, dll.).

PropertiesCollection

Kelas mewakili tas properti sebagai kumpulan pasangan kunci-nilai. Nilai semua jenis primitif (jenis apa pun dengan ) TypeCode != TypeCode.Objectkecuali DBNull diterima. Nilai jenis Byte[], Int32, Double, DateType dan String mempertahankan jenisnya, primitif lainnya disesuaikan sebagai String. Byte[] diharapkan sebagai string yang dikodekan base64.

Nama	Jenis	Deskripsi
count	integer	Jumlah properti dalam koleksi.
item	object
keys	string[]	Sekumpulan kunci dalam koleksi.
values	string[]	Kumpulan nilai dalam koleksi.

WebApiTeam

Nama	Jenis	Deskripsi
description	string	Deskripsi tim
id	string	Panduan Tim (Identitas). ID Yayasan Tim.
identity	Identity	Identitas tim.
identityUrl	string	Url REST API Identitas ke tim ini
name	string	Nama tim
projectId	string
projectName	string
url	string	Url REST API Tim

Share via