group.html.markdown

layout	page_title	description
azuredevops	AzureDevops: azuredevops_group	Use this data source to access information about an existing Group within Azure DevOps.

Data Source: azuredevops_group

Use this data source to access information about an existing Group within Azure DevOps

Example Usage

data "azuredevops_project" "example" {
  name = "Example Project"
}

data "azuredevops_group" "example" {
  project_id = data.azuredevops_project.example.id
  name       = "Example Group"
}

output "group_id" {
  value = data.azuredevops_group.example.id
}

output "group_descriptor" {
  value = data.azuredevops_group.example.descriptor
}

data "azuredevops_group" "example-collection-group" {
  name = "Project Collection Administrators"
}

output "collection_group_id" {
  value = data.azuredevops_group.example.id
}

output "collection_group_descriptor" {
  value = data.azuredevops_group.example.descriptor
}

Argument Reference

The following arguments are supported:

• name - (Required) The Group Name.

• project_id - (Optional) The Project ID. If no project ID is specified the project collection groups will be searched.

Attributes Reference

The following attributes are exported:

• id - The ID for this resource is the group descriptor. See below.
• descriptor - The Descriptor is the primary way to reference the graph subject. This field will uniquely identify the same graph subject across both Accounts and Organizations.
• origin - The type of source provider for the origin identifier (ex:AD, AAD, MSA)
• origin_id - The unique identifier from the system of origin. Typically a sid, object id or Guid. Linking and unlinking operations can cause this value to change for a user because the user is not backed by a different provider and has a different unique id in the new provider.
• group_id - The ID of the group.

Relevant Links

• Azure DevOps Service REST API 7.0 - Groups - Get

PAT Permissions Required

• Graph: Read
• Work Items: Read