1. Docs
  2. Reference
  3. API
  4. azuredevops
  5. Core
  6. Project

Project

Manages a project within Azure DevOps.

PAT Permissions Required

  • Project & Team: Read, Write, & Manage

Example Usage

using Pulumi;
using AzureDevOps = Pulumi.AzureDevOps;

class MyStack : Stack
{
    public MyStack()
    {
        var project = new AzureDevOps.Core.Project("project", new AzureDevOps.Core.ProjectArgs
        {
            Description = "Test Project Description",
            Features = 
            {
                { "artifacts", "disabled" },
                { "testplans", "disabled" },
            },
            ProjectName = "Test Project",
            VersionControl = "Git",
            Visibility = "private",
            WorkItemTemplate = "Agile",
        });
    }

}

package main

import (
    "github.com/pulumi/pulumi-azuredevops/sdk/go/azuredevops/Core"
    "github.com/pulumi/pulumi/sdk/v2/go/pulumi"
)

func main() {
    pulumi.Run(func(ctx *pulumi.Context) error {
        project, err := Core.NewProject(ctx, "project", &Core.ProjectArgs{
            Description: pulumi.String("Test Project Description"),
            Features: map[string]interface{}{
                "artifacts": "disabled",
                "testplans": "disabled",
            },
            ProjectName:      pulumi.String("Test Project"),
            VersionControl:   pulumi.String("Git"),
            Visibility:       pulumi.String("private"),
            WorkItemTemplate: pulumi.String("Agile"),
        })
        if err != nil {
            return err
        }
        return nil
    })
}
import pulumi
import pulumi_azuredevops as azuredevops

project = azuredevops.core.Project("project",
    description="Test Project Description",
    features={
        "artifacts": "disabled",
        "testplans": "disabled",
    },
    project_name="Test Project",
    version_control="Git",
    visibility="private",
    work_item_template="Agile")
import * as pulumi from "@pulumi/pulumi";
import * as azuredevops from "@pulumi/azuredevops";

const project = new azuredevops.Core.Project("project", {
    description: "Test Project Description",
    features: {
        artifacts: "disabled",
        testplans: "disabled",
    },
    projectName: "Test Project",
    versionControl: "Git",
    visibility: "private",
    workItemTemplate: "Agile",
});

Create a Project Resource

new Project(name: string, args: ProjectArgs, opts?: CustomResourceOptions);
def Project(resource_name, opts=None, description=None, features=None, project_name=None, version_control=None, visibility=None, work_item_template=None, __props__=None);
func NewProject(ctx *Context, name string, args ProjectArgs, opts ...ResourceOption) (*Project, error)
public Project(string name, ProjectArgs args, CustomResourceOptions? opts = null)
name string
The unique name of the resource.
args ProjectArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name str
The unique name of the resource.
opts ResourceOptions
A bag of options that control this resource's behavior.
ctx Context
Context object for the current deployment.
name string
The unique name of the resource.
args ProjectArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name string
The unique name of the resource.
args ProjectArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.

Project Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Programming Model docs.

Inputs

The Project resource accepts the following input properties:

ProjectName string

The Project Name.

Description string

The Description of the Project.

Features Dictionary<string, string>

Defines the status (enabled, disabled) of the project features.
Valid features boards, repositories, pipelines, testplans, artifacts

VersionControl string

Specifies the version control system. Valid values: Git or Tfvc. Defaults to Git.

Visibility string

Specifies the visibility of the Project. Valid values: private or public. Defaults to private.

WorkItemTemplate string

Specifies the work item template. Defaults to Agile.

ProjectName string

The Project Name.

Description string

The Description of the Project.

Features map[string]string

Defines the status (enabled, disabled) of the project features.
Valid features boards, repositories, pipelines, testplans, artifacts

VersionControl string

Specifies the version control system. Valid values: Git or Tfvc. Defaults to Git.

Visibility string

Specifies the visibility of the Project. Valid values: private or public. Defaults to private.

WorkItemTemplate string

Specifies the work item template. Defaults to Agile.

projectName string

The Project Name.

description string

The Description of the Project.

features {[key: string]: string}

Defines the status (enabled, disabled) of the project features.
Valid features boards, repositories, pipelines, testplans, artifacts

versionControl string

Specifies the version control system. Valid values: Git or Tfvc. Defaults to Git.

visibility string

Specifies the visibility of the Project. Valid values: private or public. Defaults to private.

workItemTemplate string

Specifies the work item template. Defaults to Agile.

project_name str

The Project Name.

description str

The Description of the Project.

features Dict[str, str]

Defines the status (enabled, disabled) of the project features.
Valid features boards, repositories, pipelines, testplans, artifacts

version_control str

Specifies the version control system. Valid values: Git or Tfvc. Defaults to Git.

visibility str

Specifies the visibility of the Project. Valid values: private or public. Defaults to private.

work_item_template str

Specifies the work item template. Defaults to Agile.

Outputs

All input properties are implicitly available as output properties. Additionally, the Project resource produces the following output properties:

Id string
The provider-assigned unique ID for this managed resource.
ProcessTemplateId string

The Process Template ID used by the Project.

Id string
The provider-assigned unique ID for this managed resource.
ProcessTemplateId string

The Process Template ID used by the Project.

id string
The provider-assigned unique ID for this managed resource.
processTemplateId string

The Process Template ID used by the Project.

id str
The provider-assigned unique ID for this managed resource.
process_template_id str

The Process Template ID used by the Project.

Look up an Existing Project Resource

Get an existing Project resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

public static get(name: string, id: Input<ID>, state?: ProjectState, opts?: CustomResourceOptions): Project
static get(resource_name, id, opts=None, description=None, features=None, process_template_id=None, project_name=None, version_control=None, visibility=None, work_item_template=None, __props__=None);
func GetProject(ctx *Context, name string, id IDInput, state *ProjectState, opts ...ResourceOption) (*Project, error)
public static Project Get(string name, Input<string> id, ProjectState? state, CustomResourceOptions? opts = null)
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
resource_name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.

The following state arguments are supported:

Description string

The Description of the Project.

Features Dictionary<string, string>

Defines the status (enabled, disabled) of the project features.
Valid features boards, repositories, pipelines, testplans, artifacts

ProcessTemplateId string

The Process Template ID used by the Project.

ProjectName string

The Project Name.

VersionControl string

Specifies the version control system. Valid values: Git or Tfvc. Defaults to Git.

Visibility string

Specifies the visibility of the Project. Valid values: private or public. Defaults to private.

WorkItemTemplate string

Specifies the work item template. Defaults to Agile.

Description string

The Description of the Project.

Features map[string]string

Defines the status (enabled, disabled) of the project features.
Valid features boards, repositories, pipelines, testplans, artifacts

ProcessTemplateId string

The Process Template ID used by the Project.

ProjectName string

The Project Name.

VersionControl string

Specifies the version control system. Valid values: Git or Tfvc. Defaults to Git.

Visibility string

Specifies the visibility of the Project. Valid values: private or public. Defaults to private.

WorkItemTemplate string

Specifies the work item template. Defaults to Agile.

description string

The Description of the Project.

features {[key: string]: string}

Defines the status (enabled, disabled) of the project features.
Valid features boards, repositories, pipelines, testplans, artifacts

processTemplateId string

The Process Template ID used by the Project.

projectName string

The Project Name.

versionControl string

Specifies the version control system. Valid values: Git or Tfvc. Defaults to Git.

visibility string

Specifies the visibility of the Project. Valid values: private or public. Defaults to private.

workItemTemplate string

Specifies the work item template. Defaults to Agile.

description str

The Description of the Project.

features Dict[str, str]

Defines the status (enabled, disabled) of the project features.
Valid features boards, repositories, pipelines, testplans, artifacts

process_template_id str

The Process Template ID used by the Project.

project_name str

The Project Name.

version_control str

Specifies the version control system. Valid values: Git or Tfvc. Defaults to Git.

visibility str

Specifies the visibility of the Project. Valid values: private or public. Defaults to private.

work_item_template str

Specifies the work item template. Defaults to Agile.

Package Details

Repository
https://github.com/pulumi/pulumi-azuredevops
License
Apache-2.0
Notes
This Pulumi package is based on the azuredevops Terraform Provider.