Plans - Create
Agregar un nuevo plan para el equipo
POST https://dev.azure.com/{organization}/{project}/_apis/work/plans?api-version=7.1-preview.1
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 "7.1-preview.1" 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 |
Tipo de plan que se va a crear. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
operación correcta |
Seguridad
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
Nombre | Description |
---|---|
vso.work_write | Concede la capacidad de leer, crear y actualizar elementos de trabajo y consultas, actualizar metadatos del panel, leer áreas de lectura e iteraciones rutas de acceso a otros metadatos relacionados de seguimiento de elementos de trabajo, ejecutar consultas y recibir notificaciones sobre eventos de elementos de trabajo a través de enlaces de servicio. |
Definiciones
Nombre | Description |
---|---|
Create |
|
Identity |
|
Plan |
Contrato de datos para la definición del plan |
Plan |
Tipo de plan que se va a crear. |
Plan |
Marca de bits que indica el conjunto de permisos que un usuario tiene en el plan. |
Reference |
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 |
Tipo de plan que se va a crear. |
IdentityRef
Nombre | Tipo | Description |
---|---|---|
_links |
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 |
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 |
lastAccessed |
string |
Fecha en la que se obtuvo acceso por última vez al plan. El valor predeterminado es null. |
modifiedByIdentity |
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 |
Tipo del plan |
|
url |
string |
Dirección URL del recurso para buscar el plan a través de la API rest. |
userPermissions |
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 |
None |
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. |