Projects - Create

Referenz

Dienst:: Visual Studio

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

Projects_Create
Erstellt ein Team Services-Projekt in der Auflistung mit dem angegebenen Namen. "VersionControlOption" und "ProcessTemplateId" müssen in den Ressourceneigenschaften angegeben werden. Gültige Werte für VersionControlOption: Git, Tfvc. Gültige Werte für ProcessTemplateId: 6B724908-EF14-45CF-84F8-768B5384DA45, ADCC42AB-9882-485E-A3ED-7678F01F66BC, 27450541-8E31-4150-9947-DC59F998FC01 (diese IDs entsprechen Den Prozessvorlagen Scrum, Agile und CMMI).

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

Mit optionalen Parametern:

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-Parameter

Name	In	Erforderlich	Typ	Beschreibung
resourceGroupName	path	True	string	Name der Ressourcengruppe innerhalb des Azure-Abonnements.
resourceName	path	True	string	Name des Team Services-Projekts.
rootResourceName	path	True	string	Name des Team Services-Kontos.
subscriptionId	path	True	string	Der Azure-Abonnementbezeichner.
api-version	query	True	string	API-Version
validating	query		string	Dieser Parameter wird ignoriert und sollte auf eine leere Zeichenfolge festgelegt werden.

Anforderungstext

Name	Typ	Beschreibung
kind	ProjectResourceKind	Art der Projektressource
location	string	Ressourcenspeicherort
properties.bootstrapPipelineTemplate	PipelineTemplate	Vorlage, die zum Konfigurieren einer Bootstrappipeline im VSTS-Projekt verwendet wird.
properties.ownerUpn	string	Optionaler UPN des Besitzers, für den das Projekt erstellt wird.
properties.processTemplateId	ProcessTemplate	Prozessvorlage, die im Projekt verwendet werden soll.
properties.versionControlOption	VersionControlOption	Versionskontrolle, die für das im Projekt erstellte Standardrepository verwendet werden soll.
tags	object	Ressourcentags.

Antworten

Name	Typ	Beschreibung
200 OK	ProjectResource	Der Vorgang wurde erfolgreich ausgeführt. Die Antwort enthält die Details der erstellten oder aktualisierten Teamprojektressource.
202 Accepted		Der Vorgang wurde erfolgreich ausgeführt. Ein Auftrag zum Erstellen der Teamprojektressource wurde in die Warteschlange gestellt. Der URI zum Überwachen der status des Auftrags wird im Header "location" bereitgestellt.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

Create a project resource

Beispielanforderung

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

Beispiel für eine Antwort

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

Definitionen

Name	Beschreibung
ApplicationTarget	Definiert die Zielressourcen für eine VSTS-Pipeline.
ApplicationTargetType	Zieltyp.
ApplicationType	Der Typ der Anwendung.
Authorization	Definiert den Autorisierungstyp und seine Parameter.
AuthorizationType	Art der Autorisierung.
CodeRepository	Definiert ein Coderepository.
CodeRepositoryApplicationSource	Definiert die Quellanwendung, wenn sie sich in einem Coderepository befindet.
CodeRepositoryType	Typ des Coderepositorys.
CodeTemplateApplicationSource	Definiert die Quellanwendungsvorlage.
PipelineTemplate	Definiert eine VSTS-Pipelinevorlage.
ProcessTemplate	Prozessvorlage, die im Projekt verwendet werden soll.
ProjectResource	Eine Visual Studio Team Services Projektressource.
ProjectResourceKind	Art der Projektressource
TargetResource	Definiert eine einzelne Ressource, die als Ziel für eine VSTS-Pipeline verwendet wird.
VersionControlOption	Versionskontrolle, die für das im Projekt erstellte Standardrepository verwendet werden soll.

ApplicationTarget

Definiert die Zielressourcen für eine VSTS-Pipeline.

Name	Typ	Beschreibung
resources	TargetResource[]	Liste der Zielressourcen.
targetType	ApplicationTargetType	Zieltyp.

ApplicationTargetType

Zieltyp.

Name	Typ	Beschreibung
WindowsAppService	string

ApplicationType

Der Typ der Anwendung.

Name	Typ	Beschreibung
AspDotNet	string
AspDotNetCore	string
NodeJs	string

Authorization

Definiert den Autorisierungstyp und seine Parameter.

Name	Typ	Beschreibung
authorizationType	AuthorizationType	Art der Autorisierung.
parameters	object	Autorisierungsparameter, die dem Autorisierungstyp entsprechen.

AuthorizationType

Art der Autorisierung.

Name	Typ	Beschreibung
authorizationToken	string
personalAccessToken	string

CodeRepository

Definiert ein Coderepository.

Name	Typ	Beschreibung
authorizationReference	string	Verweis auf die Autorisierungsinformationen, die für den Zugriff auf das Coderepository verwendet werden. Dieser Wert wird als Schlüssel im Wörterbuch für globale Autorisierungsdetails verwendet.
defaultBranch	string	Standardbranch, für den continuous Integration in der VSTS-Pipeline konfiguriert werden soll.
id	string	Eindeutiger Bezeichner des Coderepositorys.
properties	object	Repositoryspezifische Eigenschaften.
repositoryType	CodeRepositoryType	Typ des Coderepositorys.

CodeRepositoryApplicationSource

Definiert die Quellanwendung, wenn sie sich in einem Coderepository befindet.

Name	Typ	Beschreibung
applicationConfiguration	object	Anwendungsspezifische Eigenschaften.
applicationType	ApplicationType	Der Typ der Anwendung.
repository	CodeRepository	Coderepository, in dem sich die Anwendungsquelle befindet.
sourceType	string: CodeRepository	Typ der Anwendungsquelle.

CodeRepositoryType

Typ des Coderepositorys.

Name	Typ	Beschreibung
gitHub	string
vstsGit	string

CodeTemplateApplicationSource

Definiert die Quellanwendungsvorlage.

Name	Typ	Beschreibung
applicationConfiguration	object	Anwendungsspezifische Eigenschaften.
applicationType	ApplicationType	Der Typ der Anwendung.
sourceType	string: CodeTemplate	Typ der Anwendungsquelle.

PipelineTemplate

Definiert eine VSTS-Pipelinevorlage.

Name	Typ	Beschreibung
applicationSource	ApplicationSource: CodeRepositoryApplicationSource CodeTemplateApplicationSource	Quellanwendung für die VSTS-Pipeline.
applicationTarget	ApplicationTarget	Zielressourcen für die VSTS-Pipeline.
authorizationDetails	<string, Authorization>	Globales Wörterbuch der Autorisierungsdetails, die von der Pipeline verwendet werden, mit einem Anzeigenamen als Schlüssel. Einzelne Ressourcen in der Pipeline können mithilfe des Anzeigenamens auf bestimmte Autorisierungsinformationen verweisen.

ProcessTemplate

Prozessvorlage, die im Projekt verwendet werden soll.

Name	Typ	Beschreibung
Agile	string
Cmmi	string
Scrum	string

ProjectResource

Eine Visual Studio Team Services Projektressource.

Name	Typ	Beschreibung
id	string	Eindeutiger Bezeichner der Ressource.
kind	ProjectResourceKind	Art der Projektressource
location	string	Ressourcenspeicherort
name	string	Name der Ressource.
properties.bootstrapPipelineTemplate	PipelineTemplate	Vorlage, die zum Konfigurieren einer Bootstrappipeline im VSTS-Projekt verwendet wird.
properties.ownerUpn	string	Optionaler UPN des Besitzers, für den das Projekt erstellt wird.
properties.processTemplateId	ProcessTemplate	Prozessvorlage, die im Projekt verwendet werden soll.
properties.tfsUniqueIdentifier	string	Eindeutiger Bezeichner des VSTS-Projekts.
properties.versionControlOption	VersionControlOption	Versionskontrolle, die für das im Projekt erstellte Standardrepository verwendet werden soll.
tags	object	Ressourcentags.
type	string	Der Ressourcentyp.

ProjectResourceKind

Art der Projektressource

Name	Typ	Beschreibung
bootstrappedProject	string
project	string

TargetResource

Definiert eine einzelne Ressource, die als Ziel für eine VSTS-Pipeline verwendet wird.

Name	Typ	Beschreibung
authorizationReference	string	Verweis auf die Autorisierungsinformationen, die für den Zugriff auf die Zielressource verwendet werden. Dieser Wert wird als Schlüssel im Wörterbuch für globale Autorisierungsdetails verwendet.
id	string	Eindeutiger Bezeichner der Zielressource.
role	string	Rolle der Zielressource.

VersionControlOption

Versionskontrolle, die für das im Projekt erstellte Standardrepository verwendet werden soll.

Name	Typ	Beschreibung
Git	string
Tfvc	string

Freigeben über