azuredevops.getUsers
Explore with Pulumi AI
Use this data source to access information about an existing users within Azure DevOps.
Using getUsers
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getUsers(args: GetUsersArgs, opts?: InvokeOptions): Promise<GetUsersResult>
function getUsersOutput(args: GetUsersOutputArgs, opts?: InvokeOptions): Output<GetUsersResult>
def get_users(features: Optional[GetUsersFeatures] = None,
origin: Optional[str] = None,
origin_id: Optional[str] = None,
principal_name: Optional[str] = None,
subject_types: Optional[Sequence[str]] = None,
opts: Optional[InvokeOptions] = None) -> GetUsersResult
def get_users_output(features: Optional[pulumi.Input[GetUsersFeaturesArgs]] = None,
origin: Optional[pulumi.Input[str]] = None,
origin_id: Optional[pulumi.Input[str]] = None,
principal_name: Optional[pulumi.Input[str]] = None,
subject_types: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetUsersResult]
func GetUsers(ctx *Context, args *GetUsersArgs, opts ...InvokeOption) (*GetUsersResult, error)
func GetUsersOutput(ctx *Context, args *GetUsersOutputArgs, opts ...InvokeOption) GetUsersResultOutput
> Note: This function is named GetUsers
in the Go SDK.
public static class GetUsers
{
public static Task<GetUsersResult> InvokeAsync(GetUsersArgs args, InvokeOptions? opts = null)
public static Output<GetUsersResult> Invoke(GetUsersInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetUsersResult> getUsers(GetUsersArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: azuredevops:index/getUsers:getUsers
arguments:
# arguments dictionary
The following arguments are supported:
- Features
Pulumi.
Azure Dev Ops. Inputs. Get Users Features A
features
block as defined below.DataSource without specifying any arguments will return all users inside an organization.
List of possible subject types
- Origin string
- The type of source provider for the
origin_id
parameter (ex:AD, AAD, MSA) The supported origins are listed below. - Origin
Id string - The unique identifier from the system of origin.
- Principal
Name string - The PrincipalName of this graph member from the source provider.
- Subject
Types List<string> - A list of user subject subtypes to reduce the retrieved results, e.g.
msa
,aad
,svc
(service identity),imp
(imported identity), etc. The supported subject types are listed below.
- Features
Get
Users Features A
features
block as defined below.DataSource without specifying any arguments will return all users inside an organization.
List of possible subject types
- Origin string
- The type of source provider for the
origin_id
parameter (ex:AD, AAD, MSA) The supported origins are listed below. - Origin
Id string - The unique identifier from the system of origin.
- Principal
Name string - The PrincipalName of this graph member from the source provider.
- Subject
Types []string - A list of user subject subtypes to reduce the retrieved results, e.g.
msa
,aad
,svc
(service identity),imp
(imported identity), etc. The supported subject types are listed below.
- features
Get
Users Features A
features
block as defined below.DataSource without specifying any arguments will return all users inside an organization.
List of possible subject types
- origin String
- The type of source provider for the
origin_id
parameter (ex:AD, AAD, MSA) The supported origins are listed below. - origin
Id String - The unique identifier from the system of origin.
- principal
Name String - The PrincipalName of this graph member from the source provider.
- subject
Types List<String> - A list of user subject subtypes to reduce the retrieved results, e.g.
msa
,aad
,svc
(service identity),imp
(imported identity), etc. The supported subject types are listed below.
- features
Get
Users Features A
features
block as defined below.DataSource without specifying any arguments will return all users inside an organization.
List of possible subject types
- origin string
- The type of source provider for the
origin_id
parameter (ex:AD, AAD, MSA) The supported origins are listed below. - origin
Id string - The unique identifier from the system of origin.
- principal
Name string - The PrincipalName of this graph member from the source provider.
- subject
Types string[] - A list of user subject subtypes to reduce the retrieved results, e.g.
msa
,aad
,svc
(service identity),imp
(imported identity), etc. The supported subject types are listed below.
- features
Get
Users Features A
features
block as defined below.DataSource without specifying any arguments will return all users inside an organization.
List of possible subject types
- origin str
- The type of source provider for the
origin_id
parameter (ex:AD, AAD, MSA) The supported origins are listed below. - origin_
id str - The unique identifier from the system of origin.
- principal_
name str - The PrincipalName of this graph member from the source provider.
- subject_
types Sequence[str] - A list of user subject subtypes to reduce the retrieved results, e.g.
msa
,aad
,svc
(service identity),imp
(imported identity), etc. The supported subject types are listed below.
- features Property Map
A
features
block as defined below.DataSource without specifying any arguments will return all users inside an organization.
List of possible subject types
- origin String
- The type of source provider for the
origin_id
parameter (ex:AD, AAD, MSA) The supported origins are listed below. - origin
Id String - The unique identifier from the system of origin.
- principal
Name String - The PrincipalName of this graph member from the source provider.
- subject
Types List<String> - A list of user subject subtypes to reduce the retrieved results, e.g.
msa
,aad
,svc
(service identity),imp
(imported identity), etc. The supported subject types are listed below.
getUsers Result
The following output properties are available:
- Id string
- The provider-assigned unique ID for this managed resource.
- Users
List<Pulumi.
Azure Dev Ops. Outputs. Get Users User> - A set of existing users in your Azure DevOps Organization with details about every single user which includes:
- Features
Pulumi.
Azure Dev Ops. Outputs. Get Users Features - Origin string
- The type of source provider for the origin identifier (ex:AD, AAD, MSA)
- Origin
Id string - 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.
- Principal
Name string - This is the PrincipalName of this graph member from the source provider. The source provider may change this field over time and it is not guaranteed to be immutable for the life of the graph member by VSTS.
- Subject
Types List<string>
- Id string
- The provider-assigned unique ID for this managed resource.
- Users
[]Get
Users User - A set of existing users in your Azure DevOps Organization with details about every single user which includes:
- Features
Get
Users Features - Origin string
- The type of source provider for the origin identifier (ex:AD, AAD, MSA)
- Origin
Id string - 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.
- Principal
Name string - This is the PrincipalName of this graph member from the source provider. The source provider may change this field over time and it is not guaranteed to be immutable for the life of the graph member by VSTS.
- Subject
Types []string
- id String
- The provider-assigned unique ID for this managed resource.
- users
List<Get
Users User> - A set of existing users in your Azure DevOps Organization with details about every single user which includes:
- features
Get
Users Features - origin String
- The type of source provider for the origin identifier (ex:AD, AAD, MSA)
- origin
Id String - 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.
- principal
Name String - This is the PrincipalName of this graph member from the source provider. The source provider may change this field over time and it is not guaranteed to be immutable for the life of the graph member by VSTS.
- subject
Types List<String>
- id string
- The provider-assigned unique ID for this managed resource.
- users
Get
Users User[] - A set of existing users in your Azure DevOps Organization with details about every single user which includes:
- features
Get
Users Features - origin string
- The type of source provider for the origin identifier (ex:AD, AAD, MSA)
- origin
Id string - 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.
- principal
Name string - This is the PrincipalName of this graph member from the source provider. The source provider may change this field over time and it is not guaranteed to be immutable for the life of the graph member by VSTS.
- subject
Types string[]
- id str
- The provider-assigned unique ID for this managed resource.
- users
Sequence[Get
Users User] - A set of existing users in your Azure DevOps Organization with details about every single user which includes:
- features
Get
Users Features - origin str
- The type of source provider for the origin identifier (ex:AD, AAD, MSA)
- origin_
id str - 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.
- principal_
name str - This is the PrincipalName of this graph member from the source provider. The source provider may change this field over time and it is not guaranteed to be immutable for the life of the graph member by VSTS.
- subject_
types Sequence[str]
- id String
- The provider-assigned unique ID for this managed resource.
- users List<Property Map>
- A set of existing users in your Azure DevOps Organization with details about every single user which includes:
- features Property Map
- origin String
- The type of source provider for the origin identifier (ex:AD, AAD, MSA)
- origin
Id String - 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.
- principal
Name String - This is the PrincipalName of this graph member from the source provider. The source provider may change this field over time and it is not guaranteed to be immutable for the life of the graph member by VSTS.
- subject
Types List<String>
Supporting Types
GetUsersFeatures
- Concurrent
Workers int Number of workers to process user data concurrently.
Note Setting
concurrent_workers
to a value greater than 1 can greatly decrease the time it takes to read the data source.
- Concurrent
Workers int Number of workers to process user data concurrently.
Note Setting
concurrent_workers
to a value greater than 1 can greatly decrease the time it takes to read the data source.
- concurrent
Workers Integer Number of workers to process user data concurrently.
Note Setting
concurrent_workers
to a value greater than 1 can greatly decrease the time it takes to read the data source.
- concurrent
Workers number Number of workers to process user data concurrently.
Note Setting
concurrent_workers
to a value greater than 1 can greatly decrease the time it takes to read the data source.
- concurrent_
workers int Number of workers to process user data concurrently.
Note Setting
concurrent_workers
to a value greater than 1 can greatly decrease the time it takes to read the data source.
- concurrent
Workers Number Number of workers to process user data concurrently.
Note Setting
concurrent_workers
to a value greater than 1 can greatly decrease the time it takes to read the data source.
GetUsersUser
- Descriptor string
- The descriptor is the primary way to reference the graph subject while the system is running. This field will uniquely identify the same graph subject across both Accounts and Organizations.
- Display
Name string - This is the non-unique display name of the graph subject. To change this field, you must alter its value in the source provider.
- Id string
- The user ID.
- Mail
Address string - The email address of record for a given graph member. This may be different than the principal name.
- Origin string
- The type of source provider for the
origin_id
parameter (ex:AD, AAD, MSA) The supported origins are listed below. - Principal
Name string - The PrincipalName of this graph member from the source provider.
- Origin
Id string - The unique identifier from the system of origin.
- Descriptor string
- The descriptor is the primary way to reference the graph subject while the system is running. This field will uniquely identify the same graph subject across both Accounts and Organizations.
- Display
Name string - This is the non-unique display name of the graph subject. To change this field, you must alter its value in the source provider.
- Id string
- The user ID.
- Mail
Address string - The email address of record for a given graph member. This may be different than the principal name.
- Origin string
- The type of source provider for the
origin_id
parameter (ex:AD, AAD, MSA) The supported origins are listed below. - Principal
Name string - The PrincipalName of this graph member from the source provider.
- Origin
Id string - The unique identifier from the system of origin.
- descriptor String
- The descriptor is the primary way to reference the graph subject while the system is running. This field will uniquely identify the same graph subject across both Accounts and Organizations.
- display
Name String - This is the non-unique display name of the graph subject. To change this field, you must alter its value in the source provider.
- id String
- The user ID.
- mail
Address String - The email address of record for a given graph member. This may be different than the principal name.
- origin String
- The type of source provider for the
origin_id
parameter (ex:AD, AAD, MSA) The supported origins are listed below. - principal
Name String - The PrincipalName of this graph member from the source provider.
- origin
Id String - The unique identifier from the system of origin.
- descriptor string
- The descriptor is the primary way to reference the graph subject while the system is running. This field will uniquely identify the same graph subject across both Accounts and Organizations.
- display
Name string - This is the non-unique display name of the graph subject. To change this field, you must alter its value in the source provider.
- id string
- The user ID.
- mail
Address string - The email address of record for a given graph member. This may be different than the principal name.
- origin string
- The type of source provider for the
origin_id
parameter (ex:AD, AAD, MSA) The supported origins are listed below. - principal
Name string - The PrincipalName of this graph member from the source provider.
- origin
Id string - The unique identifier from the system of origin.
- descriptor str
- The descriptor is the primary way to reference the graph subject while the system is running. This field will uniquely identify the same graph subject across both Accounts and Organizations.
- display_
name str - This is the non-unique display name of the graph subject. To change this field, you must alter its value in the source provider.
- id str
- The user ID.
- mail_
address str - The email address of record for a given graph member. This may be different than the principal name.
- origin str
- The type of source provider for the
origin_id
parameter (ex:AD, AAD, MSA) The supported origins are listed below. - principal_
name str - The PrincipalName of this graph member from the source provider.
- origin_
id str - The unique identifier from the system of origin.
- descriptor String
- The descriptor is the primary way to reference the graph subject while the system is running. This field will uniquely identify the same graph subject across both Accounts and Organizations.
- display
Name String - This is the non-unique display name of the graph subject. To change this field, you must alter its value in the source provider.
- id String
- The user ID.
- mail
Address String - The email address of record for a given graph member. This may be different than the principal name.
- origin String
- The type of source provider for the
origin_id
parameter (ex:AD, AAD, MSA) The supported origins are listed below. - principal
Name String - The PrincipalName of this graph member from the source provider.
- origin
Id String - The unique identifier from the system of origin.
Package Details
- Repository
- Azure DevOps pulumi/pulumi-azuredevops
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
azuredevops
Terraform Provider.