Projects - Create
Projects_Create
Vytvoří projekt Team Services v kolekci se zadaným názvem. Ve vlastnostech prostředku musí být zadány vlastnosti VersionControlOption a ProcessTemplateId. Platné hodnoty pro VersionControlOption: Git, Tfvc. Platné hodnoty pro ProcessTemplateId: 6B724908-EF14-45CF-84F8-768B5384DA45, ADCC42AB-9882-485E-A3ED-7678F01F66BC, 27450541-8E31-4150-9947-DC59F998FC01 (tato ID odpovídají šablonám procesů Scrum, Agile a CMMI).
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.visualstudio/account/{rootResourceName}/project/{resourceName}?api-version=2017-11-01-preview
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.visualstudio/account/{rootResourceName}/project/{resourceName}?api-version=2017-11-01-preview&validating={validating}
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Název skupiny prostředků v rámci předplatného Azure. |
resource
|
path | True |
string |
Název projektu Team Services. |
root
|
path | True |
string |
Název účtu Team Services. |
subscription
|
path | True |
string |
Identifikátor předplatného Azure. |
api-version
|
query | True |
string |
Verze rozhraní API |
validating
|
query |
string |
Tento parametr je ignorován a měl by být nastaven na prázdný řetězec. |
Text požadavku
Name | Typ | Description |
---|---|---|
kind |
Druh zdroje projektu |
|
location |
string |
Umístění prostředku. |
properties.bootstrapPipelineTemplate |
Šablona sloužící ke konfiguraci kanálu bootstrap v projektu VSTS |
|
properties.ownerUpn |
string |
Volitelný hlavní název uživatele (UPN) vlastníka, jehož jménem se projekt vytváří. |
properties.processTemplateId |
Šablona procesu, která se má použít v projektu. |
|
properties.versionControlOption |
Správa verzí, která se použije pro výchozí úložiště vytvořené v projektu. |
|
tags |
object |
Značky prostředků. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Operace byla úspěšná. Odpověď obsahuje podrobnosti o vytvořeném nebo aktualizovaném zdroji týmového projektu. |
|
202 Accepted |
Operace byla úspěšná. Úloha pro vytvoření zdroje týmového projektu byla zařazena do fronty. Identifikátor URI pro monitorování stavu úlohy je uvedený v hlavičce location. |
Zabezpečení
azure_auth
Tok Azure Active Directory OAuth2
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | zosobnění uživatelského účtu |
Příklady
Create a project resource
Sample Request
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"
}
}
}
}
}
}
Sample Response
{
"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": {}
}
}
}
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
Definice
Name | Description |
---|---|
Application |
Definuje cílové prostředky pro kanál VSTS. |
Application |
Typ cíle |
Application |
Typ aplikace. |
Authorization |
Definuje typ autorizace a jeho parametry. |
Authorization |
Typ autorizace. |
Code |
Definuje úložiště kódu. |
Code |
Definuje zdrojovou aplikaci, pokud se nachází v úložišti kódu. |
Code |
Typ úložiště kódu. |
Code |
Definuje šablonu zdrojové aplikace. |
Pipeline |
Definuje šablonu kanálu VSTS. |
Process |
Šablona procesu, která se má použít v projektu. |
Project |
Zdroj projektu Visual Studio Team Services. |
Project |
Druh zdroje projektu |
Target |
Definuje jeden prostředek použitý jako cíl pro kanál VSTS. |
Version |
Správa verzí, která se použije pro výchozí úložiště vytvořené v projektu. |
ApplicationTarget
Definuje cílové prostředky pro kanál VSTS.
Name | Typ | Description |
---|---|---|
resources |
Seznam cílových prostředků |
|
targetType |
Typ cíle |
ApplicationTargetType
Typ cíle
Name | Typ | Description |
---|---|---|
WindowsAppService |
string |
ApplicationType
Typ aplikace.
Name | Typ | Description |
---|---|---|
AspDotNet |
string |
|
AspDotNetCore |
string |
|
NodeJs |
string |
Authorization
Definuje typ autorizace a jeho parametry.
Name | Typ | Description |
---|---|---|
authorizationType |
Typ autorizace. |
|
parameters |
object |
Parametry autorizace odpovídající typu autorizace. |
AuthorizationType
Typ autorizace.
Name | Typ | Description |
---|---|---|
authorizationToken |
string |
|
personalAccessToken |
string |
CodeRepository
Definuje úložiště kódu.
Name | Typ | Description |
---|---|---|
authorizationReference |
string |
Odkaz na autorizační informace použité pro přístup k úložišti kódu Tato hodnota se používá jako klíč do globálního slovníku podrobností autorizace. |
defaultBranch |
string |
Výchozí větev, pro kterou by měla být nakonfigurovaná kontinuální integrace v kanálu VSTS. |
id |
string |
Jedinečný identifikátor úložiště kódu. |
properties |
object |
Vlastnosti specifické pro úložiště. |
repositoryType |
Typ úložiště kódu. |
CodeRepositoryApplicationSource
Definuje zdrojovou aplikaci, pokud se nachází v úložišti kódu.
Name | Typ | Description |
---|---|---|
applicationConfiguration |
object |
Vlastnosti specifické pro aplikaci. |
applicationType |
Typ aplikace. |
|
repository |
Úložiště kódu, ve kterém se nachází zdroj aplikace. |
|
sourceType | string: |
Typ zdroje aplikace. |
CodeRepositoryType
Typ úložiště kódu.
Name | Typ | Description |
---|---|---|
gitHub |
string |
|
vstsGit |
string |
CodeTemplateApplicationSource
Definuje šablonu zdrojové aplikace.
Name | Typ | Description |
---|---|---|
applicationConfiguration |
object |
Vlastnosti specifické pro aplikaci. |
applicationType |
Typ aplikace. |
|
sourceType |
string:
Code |
Typ zdroje aplikace. |
PipelineTemplate
Definuje šablonu kanálu VSTS.
Name | Typ | Description |
---|---|---|
applicationSource | ApplicationSource: |
Zdrojová aplikace pro kanál VSTS. |
applicationTarget |
Cílové prostředky pro kanál VSTS. |
|
authorizationDetails |
<string, Authorization> |
Globální slovník podrobností autorizace používaných kanálem s popisným názvem jako klíčem. Jednotlivé prostředky v kanálu můžou odkazovat na konkrétní autorizační informace pomocí popisného názvu. |
ProcessTemplate
Šablona procesu, která se má použít v projektu.
Name | Typ | Description |
---|---|---|
Agile |
string |
|
Cmmi |
string |
|
Scrum |
string |
ProjectResource
Zdroj projektu Visual Studio Team Services.
Name | Typ | Description |
---|---|---|
id |
string |
Jedinečný identifikátor prostředku. |
kind |
Druh zdroje projektu |
|
location |
string |
Umístění prostředku. |
name |
string |
Název prostředku. |
properties.bootstrapPipelineTemplate |
Šablona sloužící ke konfiguraci kanálu bootstrap v projektu VSTS |
|
properties.ownerUpn |
string |
Volitelný hlavní název uživatele (UPN) vlastníka, jehož jménem se projekt vytváří. |
properties.processTemplateId |
Šablona procesu, která se má použít v projektu. |
|
properties.tfsUniqueIdentifier |
string |
Jedinečný identifikátor projektu VSTS. |
properties.versionControlOption |
Správa verzí, která se použije pro výchozí úložiště vytvořené v projektu. |
|
tags |
object |
Značky prostředků. |
type |
string |
Typ prostředku. |
ProjectResourceKind
Druh zdroje projektu
Name | Typ | Description |
---|---|---|
bootstrappedProject |
string |
|
project |
string |
TargetResource
Definuje jeden prostředek použitý jako cíl pro kanál VSTS.
Name | Typ | Description |
---|---|---|
authorizationReference |
string |
Odkaz na autorizační informace použité pro přístup k cílovému prostředku. Tato hodnota se používá jako klíč do globálního slovníku podrobností autorizace. |
id |
string |
Jedinečný identifikátor cílového prostředku. |
role |
string |
Role cílového prostředku |
VersionControlOption
Správa verzí, která se použije pro výchozí úložiště vytvořené v projektu.
Name | Typ | Description |
---|---|---|
Git |
string |
|
Tfvc |
string |