Plans - Create

Service:

Work

API Version:

6.0

Agregar un nuevo plan para el equipo

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
organization	path	True	string	El nombre de la organización de Azure DevOps.
project	path	True	string	Id. de proyecto o nombre del proyecto
api-version	query	True	string	Versión de la API que se va a usar. Debe establecerse en "6.0" para usar esta versión de la API.

Cuerpo de la solicitud

Nombre	Tipo	Description
description	string	Descripción del plan
name	string	Nombre del plan que se va a crear.
properties	object	Propiedades del plan.
type	PlanType	Tipo de plan que se va a crear.

Respuestas

Nombre	Tipo	Description
200 OK	Plan	operación correcta

Seguridad

accessToken

Token de acceso personal. Use cualquier valor para el nombre de usuario y el token como contraseña.

Type: basic

Definiciones

Nombre	Description
CreatePlan
IdentityRef
Plan	Contrato de datos para la definición del plan
PlanType	Tipo de plan que se va a crear.
PlanUserPermissions	Marca de bits que indica el conjunto de permisos que un usuario tiene en el plan.
ReferenceLinks	Clase que representa una colección de vínculos de referencia de REST.

CreatePlan

Nombre	Tipo	Description
description	string	Descripción del plan
name	string	Nombre del plan que se va a crear.
properties	object	Propiedades del plan.
type	PlanType	Tipo de plan que se va a crear.

IdentityRef

Nombre	Tipo	Description
_links	ReferenceLinks	Este campo contiene cero o más vínculos interesantes sobre el tema del grafo. Estos vínculos se pueden invocar para obtener relaciones adicionales o información más detallada sobre este tema del grafo.
descriptor	string	El descriptor es la forma principal de hacer referencia al asunto del grafo mientras se ejecuta el sistema. Este campo identificará de forma única el mismo asunto del grafo en cuentas y organizaciones.
directoryAlias	string	En desuso: se puede recuperar consultando el usuario de Graph al que se hace referencia en la entrada "self" del diccionario IdentityRef "_links".
displayName	string	Este es el nombre para mostrar no único del asunto del grafo. Para cambiar este campo, debe modificar su valor en el proveedor de origen.
id	string
imageUrl	string	En desuso: disponible en la entrada "avatar" del diccionario "_links" de IdentityRef
inactive	boolean	En desuso: se puede recuperar consultando el estado de pertenencia de Graph al que se hace referencia en la entrada "membershipState" del diccionario GraphUser "_links".
isAadIdentity	boolean	En desuso: se puede deducir del tipo de asunto del descriptor (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	En desuso: se puede deducir del tipo de sujeto del descriptor (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	En desuso: no en uso en la mayoría de las implementaciones preexistentes de ToIdentityRef
uniqueName	string	En desuso: use Domain+PrincipalName en su lugar.
url	string	Esta dirección URL es la ruta completa al recurso de origen de este tema del grafo.

Plan

Contrato de datos para la definición del plan

Nombre	Tipo	Description
createdByIdentity	IdentityRef	Identidad que creó este plan. El valor predeterminado es NULL para los registros antes de actualizar a ScaledAgileViewComponent4.
createdDate	string	Fecha en que se creó el plan
description	string	Descripción del plan
id	string	Id. del plan
modifiedByIdentity	IdentityRef	Identidad que modificó por última vez este plan. El valor predeterminado es NULL para los registros antes de actualizar a ScaledAgileViewComponent4.
modifiedDate	string	Fecha en que se modificó por última vez el plan. El valor predeterminado es CreatedDate cuando se crea el plan por primera vez.
name	string	Nombre del plan
properties	object	Instancia planPropertyCollection asociada al plan. Dependen del tipo del plan. Por ejemplo, DeliveryTimelineView, sería de tipo DeliveryViewPropertyCollection.
revision	integer	Revisión del plan. Se usa para proteger a los usuarios de sobrescribir los cambios entre sí.
type	PlanType	Tipo del plan
url	string	Dirección URL del recurso para buscar el plan a través de la API rest.
userPermissions	PlanUserPermissions	Marca de bits que indica el conjunto de permisos que un usuario tiene en el plan.

PlanType

Tipo de plan que se va a crear.

Nombre	Tipo	Description
deliveryTimelineView	string

PlanUserPermissions

Marca de bits que indica el conjunto de permisos que un usuario tiene en el plan.

Nombre	Tipo	Description
allPermissions	string	Permiso de control total para este plan.
delete	string	Permiso para eliminar este plan.
edit	string	Permiso para actualizar este plan.
manage	string	Permiso para administrar este plan.
none	string	Ninguno
view	string	Permiso para ver este plan.

ReferenceLinks

Clase que representa una colección de vínculos de referencia de REST.

Nombre	Tipo	Description
links	object	Vista de solo lectura de los vínculos. Dado que los vínculos de referencia son de solo lectura, solo queremos exponerlos como de solo lectura.