Projects - Create

Referentie

Service:: Visual Studio

API-versie:: 2017-11-01-preview

Projects_Create
Hiermee maakt u een Team Services-project in de verzameling met de opgegeven naam. 'VersionControlOption' en 'ProcessTemplateId' moeten worden opgegeven in de resource-eigenschappen. Geldige waarden voor VersionControlOption: Git, Tfvc. Geldige waarden voor ProcessTemplateId: 6B724908-EF14-45CF-84F8-768B5384DA45, ADCC42AB-9882-485E-A3ED-7678F01F66BC, 27450541-8E31-4150-9947-DC59F998FC01 (deze id's komen overeen met Scrum-, Agile- en CMMI-processjablonen).

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

Met optionele parameters:

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

URI-parameters

Name	In	Vereist	Type	Description
resourceGroupName	path	True	string	Naam van de resourcegroep binnen het Azure-abonnement.
resourceName	path	True	string	Naam van het Team Services-project.
rootResourceName	path	True	string	Naam van het Team Services-account.
subscriptionId	path	True	string	De Azure-abonnements-id.
api-version	query	True	string	API-versie
validating	query		string	Deze parameter wordt genegeerd en moet worden ingesteld op een lege tekenreeks.

Aanvraagbody

Name	Type	Description
kind	ProjectResourceKind	Soort projectresource
location	string	Resourcelocatie.
properties.bootstrapPipelineTemplate	PipelineTemplate	Sjabloon die wordt gebruikt voor het configureren van een bootstrap-pijplijn in het VSTS-project.
properties.ownerUpn	string	Optionele UPN van de eigenaar, namens wie het project wordt gemaakt.
properties.processTemplateId	ProcessTemplate	Processjabloon voor gebruik in het project.
properties.versionControlOption	VersionControlOption	Versiebeheer dat moet worden gebruikt voor de standaardopslagplaats die in het project is gemaakt.
tags	object	Resourcetags.

Antwoorden

Name	Type	Description
200 OK	ProjectResource	De bewerking is voltooid. Het antwoord bevat de details van de gemaakte of bijgewerkte teamprojectresource.
202 Accepted		De bewerking is voltooid. Er is een taak voor het maken van de teamprojectresource in de wachtrij geplaatst. De URI voor het bewaken van de status van de taak wordt opgegeven in de 'locatie'-header.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	uw gebruikersaccount imiteren

Voorbeelden

Create a project resource

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:: 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": {}
    }
  }
}

Statuscode:: 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

Definities

Name	Description
ApplicationTarget	Definieert de doelresources voor een VSTS-pijplijn.
ApplicationTargetType	Type doel.
ApplicationType	Type toepassing.
Authorization	Definieert het autorisatietype en de bijbehorende parameters.
AuthorizationType	Type autorisatie.
CodeRepository	Definieert een codeopslagplaats.
CodeRepositoryApplicationSource	Hiermee definieert u de brontoepassing wanneer deze zich in een codeopslagplaats bevindt.
CodeRepositoryType	Type codeopslagplaats.
CodeTemplateApplicationSource	Hiermee definieert u de sjabloon voor de brontoepassing.
PipelineTemplate	Definieert een VSTS-pijplijnsjabloon.
ProcessTemplate	Processjabloon voor gebruik in het project.
ProjectResource	Een Visual Studio Team Services-projectresource.
ProjectResourceKind	Soort projectresource
TargetResource	Definieert één resource die wordt gebruikt als doel voor een VSTS-pijplijn.
VersionControlOption	Versiebeheer dat moet worden gebruikt voor de standaardopslagplaats die in het project is gemaakt.

ApplicationTarget

Definieert de doelresources voor een VSTS-pijplijn.

Name	Type	Description
resources	TargetResource[]	Lijst met doelresources.
targetType	ApplicationTargetType	Type doel.

ApplicationTargetType

Type doel.

Name	Type	Description
WindowsAppService	string

ApplicationType

Type toepassing.

Name	Type	Description
AspDotNet	string
AspDotNetCore	string
NodeJs	string

Authorization

Definieert het autorisatietype en de bijbehorende parameters.

Name	Type	Description
authorizationType	AuthorizationType	Type autorisatie.
parameters	object	Autorisatieparameters die overeenkomen met het autorisatietype.

AuthorizationType

Type autorisatie.

Name	Type	Description
authorizationToken	string
personalAccessToken	string

CodeRepository

Definieert een codeopslagplaats.

Name	Type	Description
authorizationReference	string	Verwijzing naar de autorisatiegegevens die worden gebruikt voor toegang tot de codeopslagplaats. Deze waarde wordt gebruikt als sleutel in de algemene woordenlijst met autorisatiedetails.
defaultBranch	string	Standaardbranch waarvoor continue integratie moet worden geconfigureerd in de VSTS-pijplijn.
id	string	De unieke id van de codeopslagplaats.
properties	object	Eigenschappen die specifiek zijn voor de opslagplaats.
repositoryType	CodeRepositoryType	Type codeopslagplaats.

CodeRepositoryApplicationSource

Hiermee definieert u de brontoepassing wanneer deze zich in een codeopslagplaats bevindt.

Name	Type	Description
applicationConfiguration	object	Toepassingsspecifieke eigenschappen.
applicationType	ApplicationType	Type toepassing.
repository	CodeRepository	Codeopslagplaats waar de toepassingsbron zich bevindt.
sourceType	string: CodeRepository	Type toepassingsbron.

CodeRepositoryType

Type codeopslagplaats.

Name	Type	Description
gitHub	string
vstsGit	string

CodeTemplateApplicationSource

Hiermee definieert u de sjabloon voor de brontoepassing.

Name	Type	Description
applicationConfiguration	object	Toepassingsspecifieke eigenschappen.
applicationType	ApplicationType	Type toepassing.
sourceType	string: CodeTemplate	Type toepassingsbron.

PipelineTemplate

Definieert een VSTS-pijplijnsjabloon.

Name	Type	Description
applicationSource	ApplicationSource: CodeRepositoryApplicationSource CodeTemplateApplicationSource	Brontoepassing voor de VSTS-pijplijn.
applicationTarget	ApplicationTarget	Doelresources voor de VSTS-pijplijn.
authorizationDetails	<string, Authorization>	Globale woordenlijst met autorisatiegegevens die door de pijplijn worden gebruikt, met een beschrijvende naam als sleutel. Afzonderlijke resource in de pijplijn kan verwijzen naar specifieke autorisatiegegevens met behulp van de beschrijvende naam.

ProcessTemplate

Processjabloon voor gebruik in het project.

Name	Type	Description
Agile	string
Cmmi	string
Scrum	string

ProjectResource

Een Visual Studio Team Services-projectresource.

Name	Type	Description
id	string	Unieke id van de resource.
kind	ProjectResourceKind	Soort projectresource
location	string	Resourcelocatie.
name	string	Resourcenaam.
properties.bootstrapPipelineTemplate	PipelineTemplate	Sjabloon die wordt gebruikt voor het configureren van een bootstrap-pijplijn in het VSTS-project.
properties.ownerUpn	string	Optionele UPN van de eigenaar, namens wie het project wordt gemaakt.
properties.processTemplateId	ProcessTemplate	Processjabloon voor gebruik in het project.
properties.tfsUniqueIdentifier	string	De unieke id van het VSTS-project.
properties.versionControlOption	VersionControlOption	Versiebeheer dat moet worden gebruikt voor de standaardopslagplaats die in het project is gemaakt.
tags	object	Resourcetags.
type	string	Resourcetype.

ProjectResourceKind

Soort projectresource

Name	Type	Description
bootstrappedProject	string
project	string

TargetResource

Definieert één resource die wordt gebruikt als doel voor een VSTS-pijplijn.

Name	Type	Description
authorizationReference	string	Verwijzing naar de autorisatiegegevens die worden gebruikt voor toegang tot de doelresource. Deze waarde wordt gebruikt als sleutel in de algemene woordenlijst met autorisatiedetails.
id	string	De unieke id van de doelresource.
role	string	Rol van de doelresource.

VersionControlOption

Versiebeheer dat moet worden gebruikt voor de standaardopslagplaats die in het project is gemaakt.

Name	Type	Description
Git	string
Tfvc	string

Delen via