Plans - Create

Service:

Work

API Version:

7.1-preview.1

Ekip için yeni bir plan ekleme

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
organization	path	True	string	Azure DevOps kuruluşunun adı.
project	path	True	string	Proje Kimliği veya proje adı
api-version	query	True	string	Kullanılacak API'nin sürümü. Bu, api'nin bu sürümünü kullanmak için '7.1-preview.1' olarak ayarlanmalıdır.

İstek Gövdesi

Name	Tür	Description
description	string	Planın açıklaması
name	string	Oluşturulacak planın adı.
properties	object	Plan özellikleri.
type	PlanType	Oluşturulacak plan türü.

Yanıtlar

Name	Tür	Description
200 OK	Plan	başarılı işlem

Güvenlik

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.work_write	İş öğelerini ve sorgularını okuma, oluşturma ve güncelleştirme, pano meta verilerini güncelleştirme, alan ve yineleme yollarını diğer iş öğesi izlemeyle ilgili meta verileri okuma, sorguları yürütme ve hizmet kancaları aracılığıyla iş öğesi olayları hakkında bildirim alma olanağı verir.

Tanımlar

Name	Description
CreatePlan
IdentityRef
Plan	Plan tanımı için veri sözleşmesi
PlanType	Oluşturulacak plan türü.
PlanUserPermissions	Kullanıcının plana sahip olduğu izin kümesini gösteren bit bayrağı.
ReferenceLinks	REST başvuru bağlantılarının koleksiyonunu temsil eden sınıf.

CreatePlan

Name	Tür	Description
description	string	Planın açıklaması
name	string	Oluşturulacak planın adı.
properties	object	Plan özellikleri.
type	PlanType	Oluşturulacak plan türü.

IdentityRef

Name	Tür	Description
_links	ReferenceLinks	Bu alan, grafik konusuyla ilgili sıfır veya daha fazla ilgi çekici bağlantı içerir. Bu bağlantılar, bu grafik konusu hakkında ek ilişkiler veya daha ayrıntılı bilgi edinmek için çağrılabilir.
descriptor	string	Tanımlayıcı, sistem çalışırken graf konusuna başvurmanın birincil yoludur. Bu alan, hem Hesaplar hem de Kuruluşlar genelinde aynı graf konusunu benzersiz olarak tanımlar.
directoryAlias	string	Kullanım dışı - IdentityRef "_links" sözlüğündeki "self" girişinde başvuruda bulunılan Graph kullanıcısı sorgulanarak alınabilir
displayName	string	Bu, grafik konusunun benzersiz olmayan görünen adıdır. Bu alanı değiştirmek için kaynak sağlayıcıdaki değerini değiştirmeniz gerekir.
id	string
imageUrl	string	Kullanım dışı - IdentityRef "_links" sözlüğündeki "avatar" girişinde kullanılabilir
inactive	boolean	Kullanım dışı - GraphUser "_links" sözlüğündeki "membershipState" girdisinde başvurulan Graph üyelik durumu sorgulanarak alınabilir
isAadIdentity	boolean	Kullanım dışı - Tanımlayıcının konu türünden çıkarılabilir (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Kullanım dışı - Tanımlayıcının konu türünden çıkarılabilir (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	Kullanım dışı - ToIdentityRef'in önceden var olan uygulamalarının çoğunda kullanımda değil
uniqueName	string	Kullanım dışı - bunun yerine Domain+PrincipalName kullanın
url	string	Bu URL, bu grafik konusunun kaynak kaynağına giden tam yoldur.

Plan

Plan tanımı için veri sözleşmesi

Name	Tür	Description
createdByIdentity	IdentityRef	Bu planı oluşturan kimlik. ScaledAgileViewComponent4'e yükseltmeden önce kayıtlar için varsayılan değer null olur.
createdDate	string	Planın oluşturulduğu tarih
description	string	Planın açıklaması
id	string	Planın kimliği
lastAccessed	string	Plana en son erişildiği tarih. Varsayılan değer null'dır.
modifiedByIdentity	IdentityRef	Bu planı son değiştiren kimlik. ScaledAgileViewComponent4'e yükseltmeden önce kayıtlar için varsayılan değer null olur.
modifiedDate	string	Planın en son değiştirildiği tarih. Plan ilk oluşturulduğunda varsayılan olarak CreatedDate olarak ayarlanır.
name	string	Planın adı
properties	object	Planla ilişkilendirilmiş PlanPropertyCollection örneği. Bunlar planın türüne bağlıdır. Örneğin DeliveryTimelineView, DeliveryViewPropertyCollection türünde olabilir.
revision	integer	Planın düzeltmesi. Kullanıcıların birbirlerinin değişikliklerinin üzerine yazılmasını engellemek için kullanılır.
type	PlanType	Planın türü
url	string	Rest API aracılığıyla planı bulmak için kaynak URL'si
userPermissions	PlanUserPermissions	Kullanıcının plana sahip olduğu izin kümesini gösteren bit bayrağı.

PlanType

Oluşturulacak plan türü.

Name	Tür	Description
deliveryTimelineView	string

PlanUserPermissions

Kullanıcının plana sahip olduğu izin kümesini gösteren bit bayrağı.

Name	Tür	Description
allPermissions	string	Bu plan için tam denetim izni.
delete	string	Bu planı silme izni.
edit	string	Bu planı güncelleştirme izni.
manage	string	Bu planı yönetme izni.
none	string	Hiçbiri
view	string	Bu planı görüntüleme izni.

ReferenceLinks

REST başvuru bağlantılarının koleksiyonunu temsil eden sınıf.

Name	Tür	Description
links	object	Bağlantıların salt okunur görünümü. Başvuru bağlantıları salt okunur olduğundan, bunları yalnızca salt okunur olarak kullanıma açmak istiyoruz.