Projects - Get

參考

服務:: Visual Studio

API 版本:: 2017-11-01-preview

Projects_Get
取得 Team Services 專案資源的詳細數據。

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

URI 參數

名稱	位於	必要	類型	Description
resourceGroupName	path	True	string	Azure 訂用帳戶內的資源群組名稱。
resourceName	path	True	string	Team Services 項目的名稱。
rootResourceName	path	True	string	Team Services 帳戶的名稱。
subscriptionId	path	True	string	Azure 訂用帳戶標識碼。
api-version	query	True	string	API 版本

回應

名稱	類型	Description
200 OK	ProjectResource	作業成功。回應包含已更新小組專案資源的詳細數據。
404 Not Found		找不到專案或 Azure 訂用帳戶。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

Get a project resource

範例要求

HTTP

GET 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

範例回覆

狀態碼:: 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": {}
    }
  }
}

狀態碼:: 404

定義

名稱	Description
ApplicationTarget	定義 VSTS 管線的目標資源。
ApplicationTargetType	目標的類型。
ApplicationType	應用程式的類型。
Authorization	定義授權類型及其參數。
AuthorizationType	授權類型。
CodeRepository	定義程式代碼存放庫。
CodeRepositoryApplicationSource	定義來源應用程式，當它位於程式代碼存放庫時。
CodeRepositoryType	程式代碼存放庫的類型。
CodeTemplateApplicationSource	定義來源應用程式範本。
PipelineTemplate	定義 VSTS 管線範本。
ProcessTemplate	要用於專案中的程式範本。
ProjectResource	Visual Studio Team Services項目資源。
ProjectResourceKind	項目資源種類
TargetResource	定義作為 VSTS 管線目標的單一資源。
VersionControlOption	要用於專案中所建立預設存放庫的版本控制。

ApplicationTarget

定義 VSTS 管線的目標資源。

名稱	類型	Description
resources	TargetResource[]	目標資源清單。
targetType	ApplicationTargetType	目標的類型。

ApplicationTargetType

目標的類型。

名稱	類型	Description
WindowsAppService	string

ApplicationType

應用程式的類型。

名稱	類型	Description
AspDotNet	string
AspDotNetCore	string
NodeJs	string

Authorization

定義授權類型及其參數。

名稱	類型	Description
authorizationType	AuthorizationType	授權類型。
parameters	object	對應至授權類型的授權參數。

AuthorizationType

授權類型。

名稱	類型	Description
authorizationToken	string
personalAccessToken	string

CodeRepository

定義程式代碼存放庫。

名稱	類型	Description
authorizationReference	string	用來存取程式代碼存放庫之授權信息的參考。這個值會當做全域授權詳細數據字典中的索引鍵使用。
defaultBranch	string	應在 VSTS 管線中設定持續整合的預設分支。
id	string	程式代碼存放庫的唯一標識碼。
properties	object	存放庫特定屬性。
repositoryType	CodeRepositoryType	程式代碼存放庫的類型。

CodeRepositoryApplicationSource

定義來源應用程式，當它位於程式代碼存放庫時。

名稱	類型	Description
applicationConfiguration	object	應用程式特定屬性。
applicationType	ApplicationType	應用程式的類型。
repository	CodeRepository	應用程式來源所在的程式代碼存放庫。
sourceType	string: CodeRepository	應用程式來源的類型。

CodeRepositoryType

程式代碼存放庫的類型。

名稱	類型	Description
gitHub	string
vstsGit	string

CodeTemplateApplicationSource

定義來源應用程式範本。

名稱	類型	Description
applicationConfiguration	object	應用程式特定屬性。
applicationType	ApplicationType	應用程式的類型。
sourceType	string: CodeTemplate	應用程式來源的類型。

PipelineTemplate

定義 VSTS 管線範本。

名稱	類型	Description
applicationSource	ApplicationSource: CodeRepositoryApplicationSource CodeTemplateApplicationSource	VSTS 管線的來源應用程式。
applicationTarget	ApplicationTarget	VSTS 管線的目標資源。
authorizationDetails	<string, Authorization>	管線所使用的授權詳細數據全域字典，並具有易記名稱作為索引鍵。管線中的個別資源可以使用易記名稱參考特定授權資訊。

ProcessTemplate

要用於專案中的程式範本。

名稱	類型	Description
Agile	string
Cmmi	string
Scrum	string

ProjectResource

Visual Studio Team Services項目資源。

名稱	類型	Description
id	string	資源的唯一標識碼。
kind	ProjectResourceKind	項目資源種類
location	string	資源位置。
name	string	資源名稱。
properties.bootstrapPipelineTemplate	PipelineTemplate	用來在 VSTS 項目中設定啟動程式管線的範本。
properties.ownerUpn	string	正在建立項目的擁有者選擇性 UPN。
properties.processTemplateId	ProcessTemplate	要用於專案中的程式範本。
properties.tfsUniqueIdentifier	string	VSTS 專案的唯一標識碼。
properties.versionControlOption	VersionControlOption	要用於專案中所建立預設存放庫的版本控制。
tags	object	資源標籤。
type	string	資源類型。

ProjectResourceKind

項目資源種類

名稱	類型	Description
bootstrappedProject	string
project	string

TargetResource

定義作為 VSTS 管線目標的單一資源。

名稱	類型	Description
authorizationReference	string	用來存取目標資源的授權信息的參考。這個值會當做全域授權詳細數據字典中的索引鍵使用。
id	string	目標資源的唯一標識碼。
role	string	目標資源的角色。

VersionControlOption

要用於專案中所建立預設存放庫的版本控制。

名稱	類型	Description
Git	string
Tfvc	string

共用方式為