Projects - Create

Referencia

Servicio:: Visual Studio

Versión de la API:: 2017-11-01-preview

Projects_Create
Crea un proyecto de Team Services en la colección con el nombre especificado. 'VersionControlOption' y 'ProcessTemplateId' deben especificarse en las propiedades del recurso. Valores válidos para VersionControlOption: Git, Tfvc. Valores válidos para ProcessTemplateId: 6B724908-EF14-45CF-84F8-768B5384DA45, ADCC42AB-9882-485E-A3ED-7678F01F66BC, 27450541-8E31-4150-9947-DC59F998FC01 (estos identificadores corresponden a las plantillas de proceso de Scrum, Agile y CMMI).

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.visualstudio/account/{rootResourceName}/project/{resourceName}?api-version=2017-11-01-preview

Con parámetros opcionales:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.visualstudio/account/{rootResourceName}/project/{resourceName}?api-version=2017-11-01-preview&validating={validating}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
resourceGroupName	path	True	string	Nombre del grupo de recursos dentro de la suscripción de Azure.
resourceName	path	True	string	Nombre del proyecto de Team Services.
rootResourceName	path	True	string	Nombre de la cuenta de Team Services.
subscriptionId	path	True	string	Identificador de la suscripción de Azure.
api-version	query	True	string	Versión de la API
validating	query		string	Este parámetro se omite y debe establecerse en una cadena vacía.

Cuerpo de la solicitud

Nombre	Tipo	Description
kind	ProjectResourceKind	Tipo de recurso de proyecto
location	string	Ubicación del recurso
properties.bootstrapPipelineTemplate	PipelineTemplate	Plantilla usada para configurar una canalización de arranque en el proyecto de VSTS.
properties.ownerUpn	string	UPN opcional del propietario, en nombre del que se está creando el proyecto.
properties.processTemplateId	ProcessTemplate	Plantilla de proceso que se va a usar en el proyecto.
properties.versionControlOption	VersionControlOption	Control de versiones que se va a usar para el repositorio predeterminado creado en el proyecto.
tags	object	Etiquetas del recurso.

Respuestas

Nombre	Tipo	Description
200 OK	ProjectResource	La operación se realizó correctamente. La respuesta contiene los detalles del recurso de proyecto de equipo creado o actualizado.
202 Accepted		La operación se realizó correctamente. Se ha puesto en cola un trabajo para crear el recurso del proyecto de equipo. El URI para supervisar el estado del trabajo se proporciona en el encabezado "location".

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

Ejemplos

Create a project resource

Solicitud de ejemplo

HTTP

PUT https://management.azure.com/subscriptions/0de7f055-dbea-498d-8e9e-da287eedca90/resourceGroups/VS-Example-Group/providers/microsoft.visualstudio/account/ExampleAccount/project/ExampleProject?api-version=2017-11-01-preview

{
  "id": "/subscriptions/0de7f055-dbea-498d-8e9e-da287eedca90/resourceGroups/VS-Example-Group/providers/Microsoft.VisualStudio/account/ExampleAccount/project/ExampleProject",
  "name": "ExampleProject",
  "type": "Microsoft.VisualStudio/account/project",
  "location": "Central US",
  "tags": {},
  "properties": {
    "processTemplateId": "Scrum",
    "versionControlOption": "Git",
    "bootstrapPipelineTemplate": {
      "applicationSource": {
        "sourceType": "CodeTemplate",
        "applicationType": "NodeJs",
        "applicationConfiguration": {
          "nodeJsVersion": "8.5.0"
        }
      },
      "applicationTarget": {
        "targetType": "WindowsAppService",
        "resources": [
          {
            "id": "/subscriptions/ea99dfc9-1597-48ed-85f6-9bf922591395/resourceGroups/testrg/providers/Microsoft.Web/sites/MyWebSite",
            "role": "AppService"
          }
        ]
      },
      "authorizationDetails": {
        "azure": {
          "authorizationType": "authorizationToken",
          "parameters": {
            "token": "AAD_Access_Token_For_VSTS_Resource"
          }
        }
      }
    }
  }
}

Respuesta de muestra

status code:: 200

{
  "id": "/subscriptions/0de7f055-dbea-498d-8e9e-da287eedca90/resourceGroups/VS-Example-Group/providers/microsoft.visualstudio/account/ExampleAccount/project/ExampleProject",
  "name": "ExampleProject",
  "type": "microsoft.visualstudio/account/project",
  "location": "North Central US",
  "tags": {},
  "kind": "bootstrappedProject",
  "properties": {
    "processTemplateId": "Scrum",
    "versionControlOption": "Git",
    "tfsUniqueIdentifier": "vstfs:///Classification/TeamProject/7a4e6ba5-35bf-4667-86a4-9b598a88fa25",
    "bootstrapPipelineTemplate": {
      "applicationSource": {
        "sourceType": "CodeTemplate",
        "applicationType": "NodeJs",
        "applicationConfiguration": {
          "nodeJsVersion": "8.5.0"
        }
      },
      "applicationTarget": {
        "targetType": "WindowsAppService",
        "resources": [
          {
            "id": "/subscriptions/ea99dfc9-1597-48ed-85f6-9bf922591395/resourceGroups/testrg/providers/Microsoft.Web/sites/MyWebSite",
            "role": "AppService"
          }
        ]
      },
      "authorizationDetails": {}
    }
  }
}

status code:: 202

location: https://management.azure.com/subscriptions/0de7f055-dbea-498d-8e9e-da287eedca90/resourceGroups/VS-Example-Group/providers/microsoft.visualstudio/account/ExampleAccount/project/ExampleProject/subContainers/ExampleProject/status/?api-version=2017-11-01-preview&jobId=126167d2-d710-4b5d-80a8-a1d58717142d&operation=put
retry-after: 5

Definiciones

Nombre	Description
ApplicationTarget	Define los recursos de destino para una canalización de VSTS.
ApplicationTargetType	Tipo de destino.
ApplicationType	Tipo de aplicación.
Authorization	Define el tipo de autorización y sus parámetros.
AuthorizationType	Tipo de autorización.
CodeRepository	Define un repositorio de código.
CodeRepositoryApplicationSource	Define la aplicación de origen, cuando reside en un repositorio de código.
CodeRepositoryType	Tipo de repositorio de código.
CodeTemplateApplicationSource	Define la plantilla de aplicación de origen.
PipelineTemplate	Define una plantilla de canalización de VSTS.
ProcessTemplate	Plantilla de proceso que se va a usar en el proyecto.
ProjectResource	Un recurso de proyecto de Visual Studio Team Services.
ProjectResourceKind	Tipo de recurso de proyecto
TargetResource	Define un único recurso usado como destino para una canalización de VSTS.
VersionControlOption	Control de versiones que se va a usar para el repositorio predeterminado creado en el proyecto.

ApplicationTarget

Define los recursos de destino para una canalización de VSTS.

Nombre	Tipo	Description
resources	TargetResource[]	Lista de recursos de destino.
targetType	ApplicationTargetType	Tipo de destino.

ApplicationTargetType

Tipo de destino.

Nombre	Tipo	Description
WindowsAppService	string

ApplicationType

Tipo de aplicación.

Nombre	Tipo	Description
AspDotNet	string
AspDotNetCore	string
NodeJs	string

Authorization

Define el tipo de autorización y sus parámetros.

Nombre	Tipo	Description
authorizationType	AuthorizationType	Tipo de autorización.
parameters	object	Parámetros de autorización correspondientes al tipo de autorización.

AuthorizationType

Tipo de autorización.

Nombre	Tipo	Description
authorizationToken	string
personalAccessToken	string

CodeRepository

Define un repositorio de código.

Nombre	Tipo	Description
authorizationReference	string	Referencia a la información de autorización usada para acceder al repositorio de código. Este valor se usa como clave en el diccionario de detalles de autorización global.
defaultBranch	string	Rama predeterminada para la que se debe configurar la integración continua en la canalización de VSTS.
id	string	Identificador único del repositorio de código.
properties	object	Propiedades específicas del repositorio.
repositoryType	CodeRepositoryType	Tipo de repositorio de código.

CodeRepositoryApplicationSource

Define la aplicación de origen, cuando reside en un repositorio de código.

Nombre	Tipo	Description
applicationConfiguration	object	Propiedades específicas de la aplicación.
applicationType	ApplicationType	Tipo de aplicación.
repository	CodeRepository	Repositorio de código donde reside el origen de la aplicación.
sourceType	string: CodeRepository	Tipo de origen de la aplicación.

CodeRepositoryType

Tipo de repositorio de código.

Nombre	Tipo	Description
gitHub	string
vstsGit	string

CodeTemplateApplicationSource

Define la plantilla de aplicación de origen.

Nombre	Tipo	Description
applicationConfiguration	object	Propiedades específicas de la aplicación.
applicationType	ApplicationType	Tipo de aplicación.
sourceType	string: CodeTemplate	Tipo de origen de la aplicación.

PipelineTemplate

Define una plantilla de canalización de VSTS.

Nombre	Tipo	Description
applicationSource	ApplicationSource: CodeRepositoryApplicationSource CodeTemplateApplicationSource	Aplicación de origen para la canalización de VSTS.
applicationTarget	ApplicationTarget	Recursos de destino para la canalización de VSTS.
authorizationDetails	<string, Authorization>	Diccionario global de detalles de autorización usados por la canalización, con un nombre descriptivo como clave. Un recurso individual de la canalización puede hacer referencia a una información de autorización específica con el nombre descriptivo.

ProcessTemplate

Plantilla de proceso que se va a usar en el proyecto.

Nombre	Tipo	Description
Agile	string
Cmmi	string
Scrum	string

ProjectResource

Un recurso de proyecto de Visual Studio Team Services.

Nombre	Tipo	Description
id	string	Identificador único del recurso.
kind	ProjectResourceKind	Tipo de recurso de proyecto
location	string	Ubicación del recurso
name	string	Nombre del recurso.
properties.bootstrapPipelineTemplate	PipelineTemplate	Plantilla usada para configurar una canalización de arranque en el proyecto de VSTS.
properties.ownerUpn	string	UPN opcional del propietario, en nombre del que se está creando el proyecto.
properties.processTemplateId	ProcessTemplate	Plantilla de proceso que se va a usar en el proyecto.
properties.tfsUniqueIdentifier	string	Identificador único del proyecto de VSTS.
properties.versionControlOption	VersionControlOption	Control de versiones que se va a usar para el repositorio predeterminado creado en el proyecto.
tags	object	Etiquetas del recurso.
type	string	Tipo de recurso.

ProjectResourceKind

Tipo de recurso de proyecto

Nombre	Tipo	Description
bootstrappedProject	string
project	string

TargetResource

Define un único recurso usado como destino para una canalización de VSTS.

Nombre	Tipo	Description
authorizationReference	string	Referencia a la información de autorización usada para acceder al recurso de destino. Este valor se usa como clave en el diccionario de detalles de autorización global.
id	string	Identificador único del recurso de destino.
role	string	Rol del recurso de destino.

VersionControlOption

Control de versiones que se va a usar para el repositorio predeterminado creado en el proyecto.

Nombre	Tipo	Description
Git	string
Tfvc	string

Compartir a través de