Projects - Get

Référence

Service:: Visual Studio

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

Projects_Get
Obtient les détails d’une ressource de projet Team Services.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
resourceGroupName	path	True	string	Nom du groupe de ressources dans l’abonnement Azure.
resourceName	path	True	string	Nom du projet Team Services.
rootResourceName	path	True	string	Nom du compte Team Services.
subscriptionId	path	True	string	Identificateur d’abonnement Azure.
api-version	query	True	string	Version d'API

Réponses

Nom	Type	Description
200 OK	ProjectResource	L’opération a réussi. La réponse contient les détails de la ressource de projet d’équipe mise à jour.
404 Not Found		Le projet ou l’abonnement Azure est introuvable.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	Emprunter l’identité de votre compte d’utilisateur

Exemples

Get a project resource

Exemple de requête

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

Exemple de réponse

Code d’état:: 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": {}
    }
  }
}

Code d’état:: 404

Définitions

Nom	Description
ApplicationTarget	Définit les ressources cibles pour un pipeline VSTS.
ApplicationTargetType	Type de cible.
ApplicationType	Type d’application.
Authorization	Définit le type d’autorisation et ses paramètres.
AuthorizationType	Type d’autorisation.
CodeRepository	Définit un référentiel de code.
CodeRepositoryApplicationSource	Définit l’application source lorsqu’elle réside dans un référentiel de code.
CodeRepositoryType	Type de référentiel de code.
CodeTemplateApplicationSource	Définit le modèle d’application source.
PipelineTemplate	Définit un modèle de pipeline VSTS.
ProcessTemplate	Modèle de processus à utiliser dans le projet.
ProjectResource	Ressource de projet Visual Studio Team Services.
ProjectResourceKind	Type de ressource de projet
TargetResource	Définit une ressource unique utilisée comme cible pour un pipeline VSTS.
VersionControlOption	Contrôle de version à utiliser pour le dépôt par défaut créé dans le projet.

ApplicationTarget

Définit les ressources cibles pour un pipeline VSTS.

Nom	Type	Description
resources	TargetResource[]	Liste des ressources cibles.
targetType	ApplicationTargetType	Type de cible.

ApplicationTargetType

Type de cible.

Nom	Type	Description
WindowsAppService	string

ApplicationType

Type d’application.

Nom	Type	Description
AspDotNet	string
AspDotNetCore	string
NodeJs	string

Authorization

Définit le type d’autorisation et ses paramètres.

Nom	Type	Description
authorizationType	AuthorizationType	Type d’autorisation.
parameters	object	Paramètres d’autorisation correspondant au type d’autorisation.

AuthorizationType

Type d’autorisation.

Nom	Type	Description
authorizationToken	string
personalAccessToken	string

CodeRepository

Définit un référentiel de code.

Nom	Type	Description
authorizationReference	string	Référence aux informations d’autorisation utilisées pour accéder au référentiel de code. Cette valeur est utilisée comme clé dans le dictionnaire global des détails d’autorisation.
defaultBranch	string	Branche par défaut pour laquelle l’intégration continue doit être configurée dans le pipeline VSTS.
id	string	Identificateur unique du référentiel de code.
properties	object	Propriétés spécifiques au dépôt.
repositoryType	CodeRepositoryType	Type de référentiel de code.

CodeRepositoryApplicationSource

Définit l’application source lorsqu’elle réside dans un référentiel de code.

Nom	Type	Description
applicationConfiguration	object	Propriétés spécifiques à l’application.
applicationType	ApplicationType	Type d’application.
repository	CodeRepository	Référentiel de code où réside la source de l’application.
sourceType	string: CodeRepository	Type de source d’application.

CodeRepositoryType

Type de référentiel de code.

Nom	Type	Description
gitHub	string
vstsGit	string

CodeTemplateApplicationSource

Définit le modèle d’application source.

Nom	Type	Description
applicationConfiguration	object	Propriétés spécifiques à l’application.
applicationType	ApplicationType	Type d’application.
sourceType	string: CodeTemplate	Type de source d’application.

PipelineTemplate

Définit un modèle de pipeline VSTS.

Nom	Type	Description
applicationSource	ApplicationSource: CodeRepositoryApplicationSource CodeTemplateApplicationSource	Application source pour le pipeline VSTS.
applicationTarget	ApplicationTarget	Ressources cibles pour le pipeline VSTS.
authorizationDetails	<string, Authorization>	Dictionnaire global des détails d’autorisation utilisés par le pipeline, avec un nom convivial comme clé. Une ressource individuelle dans le pipeline peut faire référence à des informations d’autorisation spécifiques à l’aide du nom convivial.

ProcessTemplate

Modèle de processus à utiliser dans le projet.

Nom	Type	Description
Agile	string
Cmmi	string
Scrum	string

ProjectResource

Ressource de projet Visual Studio Team Services.

Nom	Type	Description
id	string	Identificateur unique de la ressource.
kind	ProjectResourceKind	Type de ressource de projet
location	string	Emplacement de la ressource.
name	string	Nom de la ressource.
properties.bootstrapPipelineTemplate	PipelineTemplate	Modèle utilisé pour configurer un pipeline d’amorçage dans le projet VSTS.
properties.ownerUpn	string	UPN facultatif du propriétaire, pour le compte duquel le projet est en cours de création.
properties.processTemplateId	ProcessTemplate	Modèle de processus à utiliser dans le projet.
properties.tfsUniqueIdentifier	string	Identificateur unique du projet VSTS.
properties.versionControlOption	VersionControlOption	Contrôle de version à utiliser pour le dépôt par défaut créé dans le projet.
tags	object	Balises de ressource.
type	string	Type de ressource.

ProjectResourceKind

Type de ressource de projet

Nom	Type	Description
bootstrappedProject	string
project	string

TargetResource

Définit une ressource unique utilisée comme cible pour un pipeline VSTS.

Nom	Type	Description
authorizationReference	string	Référence aux informations d’autorisation utilisées pour accéder à la ressource cible. Cette valeur est utilisée comme clé dans le dictionnaire global des détails d’autorisation.
id	string	Identificateur unique de la ressource cible.
role	string	Rôle de la ressource cible.

VersionControlOption

Contrôle de version à utiliser pour le dépôt par défaut créé dans le projet.

Nom	Type	Description
Git	string
Tfvc	string

Partager via