Projects - Create

Référence

Service:: Visual Studio

Version d'API:: 2017-11-01-preview

Projects_Create
Crée un projet Team Services dans la collection avec le nom spécifié. 'VersionControlOption' et 'ProcessTemplateId' doivent être spécifiés dans les propriétés de ressource. Valeurs valides pour VersionControlOption : Git, Tfvc. Valeurs valides pour ProcessTemplateId : 6B724908-EF14-45CF-84F8-768B5384DA45, ADCC42AB-9882-485E-A3ED-7678F01F66BC, 27450541-8E31-4150-9947-DC59F998FC01 (ces ID correspondent aux modèles de processus Scrum, Agile et CMMI).

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

Avec des paramètres facultatifs:

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
resourceGroupName	path	True	string	Nom du groupe de ressources au sein de l’abonnement Azure.
resourceName	path	True	string	Nom du projet Team Services.
rootResourceName	path	True	string	Nom du compte Team Services.
subscriptionId	path	True	string	Identificateur d’abonnement Azure.
api-version	query	True	string	Version d'API
validating	query		string	Ce paramètre est ignoré et doit être défini sur une chaîne vide.

Corps de la demande

Nom	Type	Description
kind	ProjectResourceKind	Type de ressource de projet
location	string	Emplacement de la ressource.
properties.bootstrapPipelineTemplate	PipelineTemplate	Modèle utilisé pour configurer un pipeline d’amorçage dans le projet VSTS.
properties.ownerUpn	string	UPN facultatif du propriétaire, pour le compte de qui le projet est en cours de création.
properties.processTemplateId	ProcessTemplate	Modèle de processus à utiliser dans le projet.
properties.versionControlOption	VersionControlOption	Contrôle de version à utiliser pour le référentiel par défaut créé dans le projet.
tags	object	Balises de ressource.

Réponses

Nom	Type	Description
200 OK	ProjectResource	L’opération a réussi. La réponse contient les détails de la ressource de projet d’équipe créée ou mise à jour.
202 Accepted		L’opération a réussi. Un travail pour créer la ressource de projet d’équipe a été mis en file d’attente. L’URI permettant de surveiller la status du travail est fourni dans l’en-tête « location ».

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	Emprunter l’identité de votre compte d’utilisateur

Exemples

Create a project resource

Exemple de requête

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"
          }
        }
      }
    }
  }
}

Exemple de réponse

Code d’état:: 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": {}
    }
  }
}

Code d’état:: 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

Définitions

Nom	Description
ApplicationTarget	Définit les ressources cibles pour un pipeline VSTS.
ApplicationTargetType	Type de cible.
ApplicationType	Type d’application.
Authorization	Définit le type d’autorisation et ses paramètres.
AuthorizationType	Type d’autorisation.
CodeRepository	Définit un dépôt de code.
CodeRepositoryApplicationSource	Définit l’application source lorsqu’elle réside dans un référentiel de code.
CodeRepositoryType	Type de référentiel de code.
CodeTemplateApplicationSource	Définit le modèle d’application source.
PipelineTemplate	Définit un modèle de pipeline VSTS.
ProcessTemplate	Modèle de processus à utiliser dans le projet.
ProjectResource	Ressource de projet Visual Studio Team Services.
ProjectResourceKind	Type de ressource de projet
TargetResource	Définit une ressource unique utilisée comme cible pour un pipeline VSTS.
VersionControlOption	Contrôle de version à utiliser pour le référentiel par défaut créé dans le projet.

ApplicationTarget

Définit les ressources cibles pour un pipeline VSTS.

Nom	Type	Description
resources	TargetResource[]	Liste des ressources cibles.
targetType	ApplicationTargetType	Type de cible.

ApplicationTargetType

Type de cible.

Nom	Type	Description
WindowsAppService	string

ApplicationType

Type d’application.

Nom	Type	Description
AspDotNet	string
AspDotNetCore	string
NodeJs	string

Authorization

Définit le type d’autorisation et ses paramètres.

Nom	Type	Description
authorizationType	AuthorizationType	Type d’autorisation.
parameters	object	Paramètres d’autorisation correspondant au type d’autorisation.

AuthorizationType

Type d’autorisation.

Nom	Type	Description
authorizationToken	string
personalAccessToken	string

CodeRepository

Définit un dépôt de code.

Nom	Type	Description
authorizationReference	string	Référence aux informations d’autorisation utilisées pour accéder au référentiel de code. Cette valeur est utilisée comme clé dans le dictionnaire des détails de l’autorisation globale.
defaultBranch	string	Branche par défaut pour laquelle l’intégration continue doit être configurée dans le pipeline VSTS.
id	string	Identificateur unique du référentiel de code.
properties	object	Propriétés spécifiques au référentiel.
repositoryType	CodeRepositoryType	Type de référentiel de code.

CodeRepositoryApplicationSource

Définit l’application source lorsqu’elle réside dans un référentiel de code.

Nom	Type	Description
applicationConfiguration	object	Propriétés spécifiques à l’application.
applicationType	ApplicationType	Type d’application.
repository	CodeRepository	Référentiel de code où réside la source d’application.
sourceType	string: CodeRepository	Type de source d’application.

CodeRepositoryType

Type de référentiel de code.

Nom	Type	Description
gitHub	string
vstsGit	string

CodeTemplateApplicationSource

Définit le modèle d’application source.

Nom	Type	Description
applicationConfiguration	object	Propriétés spécifiques à l’application.
applicationType	ApplicationType	Type d’application.
sourceType	string: CodeTemplate	Type de source d’application.

PipelineTemplate

Définit un modèle de pipeline VSTS.

Nom	Type	Description
applicationSource	ApplicationSource: CodeRepositoryApplicationSource CodeTemplateApplicationSource	Application source pour le pipeline VSTS.
applicationTarget	ApplicationTarget	Ressources cibles pour le pipeline VSTS.
authorizationDetails	<string, Authorization>	Dictionnaire global des détails d’autorisation utilisés par le pipeline, avec un nom convivial comme clé. Une ressource individuelle dans le pipeline peut faire référence à des informations d’autorisation spécifiques à l’aide du nom convivial.

ProcessTemplate

Modèle de processus à utiliser dans le projet.

Nom	Type	Description
Agile	string
Cmmi	string
Scrum	string

ProjectResource

Ressource de projet Visual Studio Team Services.

Nom	Type	Description
id	string	Identificateur unique de la ressource.
kind	ProjectResourceKind	Type de ressource de projet
location	string	Emplacement de la ressource.
name	string	Nom de la ressource.
properties.bootstrapPipelineTemplate	PipelineTemplate	Modèle utilisé pour configurer un pipeline d’amorçage dans le projet VSTS.
properties.ownerUpn	string	UPN facultatif du propriétaire, pour le compte de qui le projet est en cours de création.
properties.processTemplateId	ProcessTemplate	Modèle de processus à utiliser dans le projet.
properties.tfsUniqueIdentifier	string	Identificateur unique du projet VSTS.
properties.versionControlOption	VersionControlOption	Contrôle de version à utiliser pour le référentiel par défaut créé dans le projet.
tags	object	Balises de ressource.
type	string	Type de ressource.

ProjectResourceKind

Type de ressource de projet

Nom	Type	Description
bootstrappedProject	string
project	string

TargetResource

Définit une ressource unique utilisée comme cible pour un pipeline VSTS.

Nom	Type	Description
authorizationReference	string	Référence aux informations d’autorisation utilisées pour accéder à la ressource cible. Cette valeur est utilisée comme clé dans le dictionnaire des détails de l’autorisation globale.
id	string	Identificateur unique de la ressource cible.
role	string	Rôle de la ressource cible.

VersionControlOption

Contrôle de version à utiliser pour le référentiel par défaut créé dans le projet.

Nom	Type	Description
Git	string
Tfvc	string

Partager via