Plans - Create

Service:

Work

API Version:

7.1-preview.1

Menambahkan paket baru untuk tim

POST https://dev.azure.com/{organization}/{project}/_apis/work/plans?api-version=7.1-preview.1

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
organization	path	True	string	Nama organisasi Azure DevOps.
project	path	True	string	ID proyek atau nama proyek
api-version	query	True	string	Versi API yang akan digunakan. Ini harus diatur ke '7.1-preview.1' untuk menggunakan versi api ini.

Isi Permintaan

Nama	Jenis	Deskripsi
description	string	Deskripsi paket
name	string	Nama rencana yang akan dibuat.
properties	object	Properti paket.
type	PlanType	Jenis rencana yang akan dibuat.

Respons

Nama	Jenis	Deskripsi
200 OK	Plan	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.work_write	Memberikan kemampuan untuk membaca, membuat, dan memperbarui item dan kueri kerja, memperbarui metadata papan, membaca area dan jalur perulangan item kerja lainnya yang melacak metadata terkait, menjalankan kueri, dan untuk menerima pemberitahuan tentang peristiwa item kerja melalui kait layanan.

Definisi

Nama	Deskripsi
CreatePlan
IdentityRef
Plan	Kontrak data untuk definisi rencana
PlanType	Jenis rencana yang akan dibuat.
PlanUserPermissions	Bendera bit yang menunjukkan sekumpulan izin yang dimiliki pengguna ke paket.
ReferenceLinks	Kelas untuk mewakili kumpulan tautan referensi REST.

CreatePlan

Nama	Jenis	Deskripsi
description	string	Deskripsi paket
name	string	Nama rencana yang akan dibuat.
properties	object	Properti paket.
type	PlanType	Jenis rencana yang akan dibuat.

IdentityRef

Nama	Jenis	Deskripsi
_links	ReferenceLinks	Bidang ini berisi nol atau lebih tautan menarik tentang subjek grafik. Tautan ini dapat dipanggil untuk mendapatkan hubungan tambahan atau informasi lebih rinci tentang subjek grafik ini.
descriptor	string	Deskriptor adalah cara utama untuk mereferensikan subjek grafik saat sistem berjalan. Bidang ini akan secara unik mengidentifikasi subjek grafik yang sama di seluruh Akun dan Organisasi.
directoryAlias	string	Tidak digunakan lagi - Dapat diambil dengan mengkueri pengguna Graph yang direferensikan dalam entri "mandiri" kamus IdentityRef "_links"
displayName	string	Ini adalah nama tampilan subjek grafik yang tidak unik. Untuk mengubah bidang ini, Anda harus mengubah nilainya di penyedia sumber.
id	string
imageUrl	string	Tidak digunakan lagi - Tersedia dalam entri "avatar" kamus IdentityRef "_links"
inactive	boolean	Tidak digunakan lagi - Dapat diambil dengan mengkueri status keanggotaan Graph yang direferensikan dalam entri "membershipState" dari kamus "_links" GraphUser
isAadIdentity	boolean	Tidak digunakan lagi - Dapat disimpulkan dari jenis subjek deskriptor (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Tidak digunakan lagi - Dapat disimpulkan dari jenis subjek deskriptor (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	Tidak digunakan lagi - tidak digunakan dalam sebagian besar implementasi ToIdentityRef yang sudah ada sebelumnya
uniqueName	string	Tidak digunakan lagi - gunakan Domain+PrincipalName sebagai gantinya
url	string	Url ini adalah rute lengkap ke sumber daya sumber subjek grafik ini.

Plan

Kontrak data untuk definisi rencana

Nama	Jenis	Deskripsi
createdByIdentity	IdentityRef	Identitas yang membuat rencana ini. Default ke null untuk rekaman sebelum memutakhirkan ke ScaledAgileViewComponent4.
createdDate	string	Tanggal saat paket dibuat
description	string	Deskripsi paket
id	string	Id paket
lastAccessed	string	Tanggal saat paket terakhir diakses. Defaultnya adalah null.
modifiedByIdentity	IdentityRef	Identitas yang terakhir mengubah rencana ini. Default ke null untuk rekaman sebelum memutakhirkan ke ScaledAgileViewComponent4.
modifiedDate	string	Tanggal ketika paket terakhir diubah. Default ke CreatedDate saat paket pertama kali dibuat.
name	string	Nama paket
properties	object	Instans PlanPropertyCollection yang terkait dengan paket. Ini tergantung pada jenis rencana. Misalnya, DeliveryTimelineView, jenisnya adalah DeliveryViewPropertyCollection.
revision	integer	Revisi rencana. Digunakan untuk melindungi pengguna agar tidak menimpa perubahan satu sama lain.
type	PlanType	Jenis paket
url	string	Url sumber daya untuk menemukan paket melalui rest api
userPermissions	PlanUserPermissions	Bendera bit yang menunjukkan sekumpulan izin yang dimiliki pengguna ke paket.

PlanType

Jenis rencana yang akan dibuat.

Nama	Jenis	Deskripsi
deliveryTimelineView	string

PlanUserPermissions

Bendera bit yang menunjukkan sekumpulan izin yang dimiliki pengguna ke paket.

Nama	Jenis	Deskripsi
allPermissions	string	Izin kontrol penuh untuk paket ini.
delete	string	Izin untuk menghapus rencana ini.
edit	string	Izin untuk memperbarui paket ini.
manage	string	Izin untuk mengelola rencana ini.
none	string	Tidak ada
view	string	Izin untuk melihat paket ini.

ReferenceLinks

Kelas untuk mewakili kumpulan tautan referensi REST.

Nama	Jenis	Deskripsi
links	object	Tampilan baca-saja dari tautan. Karena tautan Referensi bersifat baca-saja, kami hanya ingin mengeksposnya sebagai baca saja.