Projects - Get

Referenz

Dienst:: Visual Studio

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

Projects_Get
Ruft die Details einer Team Services-Projektressource ab.

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

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

Antworten

Name	Typ	Beschreibung
200 OK	ProjectResource	Der Vorgang wurde erfolgreich ausgeführt. Die Antwort enthält die Details der aktualisierten Teamprojektressource.
404 Not Found		Das Projekt oder Azure-Abonnement wurde nicht gefunden.

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

Get a project resource

Beispielanforderung

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

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

Definitionen

Name	Beschreibung
ApplicationTarget	Definiert die Zielressourcen für eine VSTS-Pipeline.
ApplicationTargetType	Typ des Ziels.
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	Verarbeiten einer Vorlage, 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	Typ des Ziels.

ApplicationTargetType

Typ des Ziels.

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 globalen Autorisierungsdetailswörterbuch 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 mit 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

Verarbeiten einer Vorlage, 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 zum Konfigurieren einer Bootstrappipeline im VSTS-Projekt.
properties.ownerUpn	string	Optionaler UPN des Besitzers, für den das Projekt erstellt wird.
properties.processTemplateId	ProcessTemplate	Verarbeiten einer Vorlage, 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 globalen Autorisierungsdetailswörterbuch 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