» azuredevops_project

Manages a project within Azure DevOps.

» Example Usage

resource "azuredevops_project" "project" {
  project_name       = "Test Project"
  description        = "Test Project Description"
  visibility         = "private"
  version_control    = "Git"
  work_item_template = "Agile"

  features = {
      "testplans" = "disabled"
      "artifacts" = "disabled"

» Argument Reference

The following arguments are supported:

  • project_name - (Required) The Project Name.
  • description - (Optional) The Description of the Project.
  • visibility - (Optional) Specifies the visibility of the Project. Valid values: private or public. Defaults to private.
  • version_control - (Optional) Specifies the version control system. Valid values: Git or Tfvc. Defaults to Git.
  • work_item_template - (Optional) Specifies the work item template. Defaults to Agile.
  • features - (Optional) Defines the status (enabled, disabled) of the project features.
    Valid features boards, repositories, pipelines, testplans, artifacts

It's possible to define project features both within the azuredevops_project_features resource and via the features block by using the azuredevops_project resource. However it's not possible to use both methods to manage group members, since there'll be conflicts.

» Attributes Reference

In addition to all arguments above, the following attributes are exported:

» Import

Azure DevOps Projects can be imported using the project name or by the project Guid, e.g.

$ terraform import azuredevops_project.project "Test Project"


$ terraform import azuredevops_project.project 782a8123-1019-xxxx-xxxx-xxxxxxxx

» PAT Permissions Required

  • Project & Team: Read, Write, & Manage