次の方法で共有

Projects - Create

  • リファレンス
サービス:
Visual Studio
API バージョン:
2017-11-01-preview

Projects_Create
指定した名前の Team Services プロジェクトをコレクションに作成します。 'VersionControlOption' と 'ProcessTemplateId' は、リソースのプロパティで指定する必要があります。 VersionControlOption の有効な値: Git、Tfvc。 ProcessTemplateId の有効な値: 6B724908-EF14-45CF-84F8-768B5384DA45, ADCC42AB-9882-485E-A3ED-7678F01F66BC、27450541-8E31-4150-9947-DC59F998FC01 (これらの ID は、スクラム、アジャイル、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}

URI パラメーター

名前 / 必須 型 説明
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 バージョン
validating
 query

string

このパラメーターは無視され、空の文字列に設定する必要があります。

要求本文

名前 型 説明
kind

ProjectResourceKind

プロジェクト リソースの種類
location

string

リソースの場所。
properties.bootstrapPipelineTemplate

PipelineTemplate

VSTS プロジェクトでブートストラップ パイプラインを構成するために使用されるテンプレート。
properties.ownerUpn

string

プロジェクトの作成中の代理として所有者の省略可能な UPN。
properties.processTemplateId

ProcessTemplate

プロジェクトで使用するプロセス テンプレート。
properties.versionControlOption

VersionControlOption

プロジェクトで作成された既定のリポジトリに使用するバージョン コントロール。
tags

object

リソース タグ。

応答

名前 型 説明
200 OK

ProjectResource

操作が成功しました。 応答には、作成または更新されたチーム プロジェクト リソースの詳細が含まれます。
202 Accepted

操作が成功しました。 チーム プロジェクト リソースを作成するジョブがキューに登録されました。 ジョブの状態を監視する URI は、"location" ヘッダーに用意されています。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前 説明
user_impersonation ユーザー アカウントの借用

例

Create a project resource

要求のサンプル

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

応答のサンプル

状態コード:
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": {}
    }
  }
}
状態コード:
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

定義

名前 説明
ApplicationTarget

VSTS パイプラインのターゲット リソースを定義します。
ApplicationTargetType

ターゲットの種類。
ApplicationType

アプリケーションの種類。
Authorization

承認の種類とそのパラメーターを定義します。
AuthorizationType

承認の種類。
CodeRepository

コード リポジトリを定義します。
CodeRepositoryApplicationSource

ソース アプリケーションがコード リポジトリに存在する場合に定義します。
CodeRepositoryType

コード リポジトリの種類。
CodeTemplateApplicationSource

ソース アプリケーション テンプレートを定義します。
PipelineTemplate

VSTS パイプライン テンプレートを定義します。
ProcessTemplate

プロジェクトで使用するプロセス テンプレート。
ProjectResource

Visual Studio Team Services プロジェクト リソース。
ProjectResourceKind

プロジェクト リソースの種類
TargetResource

VSTS パイプラインのターゲットとして使用される 1 つのリソースを定義します。
VersionControlOption

プロジェクトで作成された既定のリポジトリに使用するバージョン コントロール。

ApplicationTarget

VSTS パイプラインのターゲット リソースを定義します。

名前 型 説明
resources

TargetResource[]

ターゲット リソースの一覧。
targetType

ApplicationTargetType

ターゲットの種類。

ApplicationTargetType

ターゲットの種類。

名前 型 説明
WindowsAppService

string

ApplicationType

アプリケーションの種類。

名前 型 説明
AspDotNet

string

AspDotNetCore

string

NodeJs

string

Authorization

承認の種類とそのパラメーターを定義します。

名前 型 説明
authorizationType

AuthorizationType

承認の種類。
parameters

object

承認の種類に対応する承認パラメーター。

AuthorizationType

承認の種類。

名前 型 説明
authorizationToken

string

personalAccessToken

string

CodeRepository

コード リポジトリを定義します。

名前 型 説明
authorizationReference

string

コード リポジトリへのアクセスに使用される承認情報への参照。 この値は、グローバル承認詳細ディクショナリのキーとして使用されます。
defaultBranch

string

VSTS パイプラインで継続的インテグレーションを構成する必要がある既定のブランチ。
id

string

コード リポジトリの一意識別子。
properties

object

リポジトリ固有のプロパティ。
repositoryType

CodeRepositoryType

コード リポジトリの種類。

CodeRepositoryApplicationSource

ソース アプリケーションがコード リポジトリに存在する場合に定義します。

名前 型 説明
applicationConfiguration

object

アプリケーション固有のプロパティ。
applicationType

ApplicationType

アプリケーションの種類。
repository

CodeRepository

アプリケーション ソースが存在するコード リポジトリ。
sourceType string:

CodeRepository

アプリケーション ソースの種類。

CodeRepositoryType

コード リポジトリの種類。

名前 型 説明
gitHub

string

vstsGit

string

CodeTemplateApplicationSource

ソース アプリケーション テンプレートを定義します。

名前 型 説明
applicationConfiguration

object

アプリケーション固有のプロパティ。
applicationType

ApplicationType

アプリケーションの種類。
sourceType string:

CodeTemplate

アプリケーション ソースの種類。

PipelineTemplate

VSTS パイプライン テンプレートを定義します。

名前 型 説明
applicationSource ApplicationSource:

VSTS パイプラインのソース アプリケーション。
applicationTarget

ApplicationTarget

VSTS パイプラインのターゲット リソース。
authorizationDetails

<string,  Authorization>

パイプラインで使用される承認の詳細のグローバル ディクショナリ。フレンドリ名をキーとして使用します。 パイプライン内の個々のリソースは、フレンドリ名を使用して特定の承認情報を参照できます。

ProcessTemplate

プロジェクトで使用するプロセス テンプレート。

名前 型 説明
Agile

string

Cmmi

string

Scrum

string

ProjectResource

Visual Studio Team Services プロジェクト リソース。

名前 型 説明
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

プロジェクト リソースの種類

名前 型 説明
bootstrappedProject

string

project

string

TargetResource

VSTS パイプラインのターゲットとして使用される 1 つのリソースを定義します。

名前 型 説明
authorizationReference

string

ターゲット リソースへのアクセスに使用される承認情報への参照。 この値は、グローバル承認詳細ディクショナリのキーとして使用されます。
id

string

ターゲット リソースの一意識別子。
role

string

ターゲット リソースのロール。

VersionControlOption

プロジェクトで作成された既定のリポジトリに使用するバージョン コントロール。

名前 型 説明
Git

string

Tfvc

string