pulumi-azuredevops 3.6.0a1737523387__py3-none-any.whl → 3.7.0a1738589303__py3-none-any.whl

pulumi_azuredevops/get_git_repository.py

@@ -73,7 +73,7 @@ class GetGitRepositoryResult:
     @pulumi.getter
     def disabled(self) -> bool:
         """
-        Is the repository disabled?
+        Indicates whether the repository is disabled.
         """
         return pulumi.get(self, "disabled")
 
@@ -94,7 +94,7 @@ class GetGitRepositoryResult:
     @pulumi.getter
     def name(self) -> str:
         """
-        Git repository name.
+        The name of the Git repository.
         """
         return pulumi.get(self, "name")
 
@@ -134,7 +134,7 @@ class GetGitRepositoryResult:
     @pulumi.getter
     def url(self) -> str:
         """
-        Details REST API endpoint for the Git Repository.
+        The details REST API endpoint for the Git Repository.
         """
         return pulumi.get(self, "url")
 
@@ -142,7 +142,7 @@ class GetGitRepositoryResult:
     @pulumi.getter(name="webUrl")
     def web_url(self) -> str:
         """
-        Url of the Git repository web view
+        The Url of the Git repository web view
         """
         return pulumi.get(self, "web_url")
 
@@ -190,8 +190,8 @@ def get_git_repository(name: Optional[str] = None,
     - [Azure DevOps Service REST API 7.0 - Git API](https://docs.microsoft.com/en-us/rest/api/azure/devops/git/?view=azure-devops-rest-7.0)
 
 
-    :param str name: Name of the Git repository to retrieve
-    :param str project_id: ID of project to list Git repositories
+    :param str name: The Name of the Git repository to retrieve
+    :param str project_id: The ID of project to list Git repositories
     """
     __args__ = dict()
     __args__['name'] = name
@@ -235,8 +235,8 @@ def get_git_repository_output(name: Optional[pulumi.Input[str]] = None,
     - [Azure DevOps Service REST API 7.0 - Git API](https://docs.microsoft.com/en-us/rest/api/azure/devops/git/?view=azure-devops-rest-7.0)
 
 
-    :param str name: Name of the Git repository to retrieve
-    :param str project_id: ID of project to list Git repositories
+    :param str name: The Name of the Git repository to retrieve
+    :param str project_id: The ID of project to list Git repositories
     """
     __args__ = dict()
     __args__['name'] = name

pulumi_azuredevops/get_group.py

@@ -147,8 +147,8 @@ def get_group(name: Optional[str] = None,
     - **Work Items**: Read
 
 
-    :param str name: The Group Name.
-    :param str project_id: The Project ID. If no project ID is specified the project collection groups will be searched.
+    :param str name: The Name of the Group.
+    :param str project_id: The ID of the Project. If `project_id` is not specified the project collection groups will be searched.
     """
     __args__ = dict()
     __args__['name'] = name
@@ -196,8 +196,8 @@ def get_group_output(name: Optional[pulumi.Input[str]] = None,
     - **Work Items**: Read
 
 
-    :param str name: The Group Name.
-    :param str project_id: The Project ID. If no project ID is specified the project collection groups will be searched.
+    :param str name: The Name of the Group.
+    :param str project_id: The ID of the Project. If `project_id` is not specified the project collection groups will be searched.
     """
     __args__ = dict()
     __args__['name'] = name

pulumi_azuredevops/get_groups.py

@@ -42,7 +42,7 @@ class GetGroupsResult:
     @pulumi.getter
     def groups(self) -> Sequence['outputs.GetGroupsGroupResult']:
         """
-        A set of existing groups in your Azure DevOps Organization or project with details about every single group which includes:
+        A `groups` blocks as documented below. A set of existing groups in your Azure DevOps Organization or project with details about every single group which includes:
         """
         return pulumi.get(self, "groups")
 
@@ -94,7 +94,7 @@ def get_groups(project_id: Optional[str] = None,
     - [Azure DevOps Service REST API 7.0 - Groups - List](https://docs.microsoft.com/en-us/rest/api/azure/devops/graph/groups/list?view=azure-devops-rest-7.0)
 
 
-    :param str project_id: The Project ID. If no project ID is specified all groups of an organization will be returned
+    :param str project_id: The ID of the Project. If no project ID is specified all groups of an organization will be returned
     """
     __args__ = dict()
     __args__['projectId'] = project_id
@@ -128,7 +128,7 @@ def get_groups_output(project_id: Optional[pulumi.Input[Optional[str]]] = None,
     - [Azure DevOps Service REST API 7.0 - Groups - List](https://docs.microsoft.com/en-us/rest/api/azure/devops/graph/groups/list?view=azure-devops-rest-7.0)
 
 
-    :param str project_id: The Project ID. If no project ID is specified all groups of an organization will be returned
+    :param str project_id: The ID of the Project. If no project ID is specified all groups of an organization will be returned
     """
     __args__ = dict()
     __args__['projectId'] = project_id

pulumi_azuredevops/get_identity_group.py

@@ -43,6 +43,9 @@ class GetIdentityGroupResult:
     @property
     @pulumi.getter
     def descriptor(self) -> str:
+        """
+        The descriptor of the identity group.
+        """
         return pulumi.get(self, "descriptor")
 
     @property

pulumi_azuredevops/get_identity_groups.py

@@ -42,7 +42,7 @@ class GetIdentityGroupsResult:
     @pulumi.getter
     def groups(self) -> Sequence['outputs.GetIdentityGroupsGroupResult']:
         """
-        A set of existing groups in your Azure DevOps Organization or project with details about every single group which includes:
+        A `groups` blocks as documented below. A set of existing groups in your Azure DevOps Organization or project with details about every single group.
         """
         return pulumi.get(self, "groups")
 

pulumi_azuredevops/get_identity_users.py

@@ -43,6 +43,9 @@ class GetIdentityUsersResult:
     @property
     @pulumi.getter
     def descriptor(self) -> str:
+        """
+        The descriptor of the user.
+        """
         return pulumi.get(self, "descriptor")
 
     @property
@@ -56,9 +59,6 @@ class GetIdentityUsersResult:
     @property
     @pulumi.getter
     def name(self) -> str:
-        """
-        This is the PrincipalName of this identity 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 identity member.
-        """
         return pulumi.get(self, "name")
 
     @property
@@ -87,7 +87,7 @@ def get_identity_users(name: Optional[str] = None,
 
 
     :param str name: The PrincipalName of this identity member from the source provider.
-    :param str search_filter: The type of search to perform. Default is `General`. Possible values are `AccountName`, `DisplayName`, and `MailAddress`.
+    :param str search_filter: The type of search to perform. Possible values are: `AccountName`, `DisplayName`, and `MailAddress`. Default is `General`.
     """
     __args__ = dict()
     __args__['name'] = name
@@ -108,7 +108,7 @@ def get_identity_users_output(name: Optional[pulumi.Input[str]] = None,
 
 
     :param str name: The PrincipalName of this identity member from the source provider.
-    :param str search_filter: The type of search to perform. Default is `General`. Possible values are `AccountName`, `DisplayName`, and `MailAddress`.
+    :param str search_filter: The type of search to perform. Possible values are: `AccountName`, `DisplayName`, and `MailAddress`. Default is `General`.
     """
     __args__ = dict()
     __args__['name'] = name

pulumi_azuredevops/get_pool.py

@@ -46,11 +46,17 @@ class GetPoolResult:
     @property
     @pulumi.getter(name="autoProvision")
     def auto_provision(self) -> bool:
+        """
+        Specifies whether a queue should be automatically provisioned for each project collection.
+        """
         return pulumi.get(self, "auto_provision")
 
     @property
     @pulumi.getter(name="autoUpdate")
     def auto_update(self) -> bool:
+        """
+        Specifies whether or not agents within the pool should be automatically updated.
+        """
         return pulumi.get(self, "auto_update")
 
     @property
@@ -64,11 +70,17 @@ class GetPoolResult:
     @property
     @pulumi.getter
     def name(self) -> str:
+        """
+        The name of the agent pool
+        """
         return pulumi.get(self, "name")
 
     @property
     @pulumi.getter(name="poolType")
     def pool_type(self) -> str:
+        """
+        Specifies whether the agent pool type is Automation or Deployment.
+        """
         return pulumi.get(self, "pool_type")
 
 
@@ -105,7 +117,7 @@ def get_pool(name: Optional[str] = None,
 
     ## Relevant Links
 
-    - [Azure DevOps Service REST API 7.0 - Agent Pools - Get](https://docs.microsoft.com/en-us/rest/api/azure/devops/distributedtask/pools/get?view=azure-devops-rest-7.0)
+    - [Azure DevOps Service REST API 7.1 - Agent Pools - Get](https://docs.microsoft.com/en-us/rest/api/azure/devops/distributedtask/pools/get?view=azure-devops-rest-7.1)
 
 
     :param str name: Name of the Agent Pool.
@@ -141,7 +153,7 @@ def get_pool_output(name: Optional[pulumi.Input[str]] = None,
 
     ## Relevant Links
 
-    - [Azure DevOps Service REST API 7.0 - Agent Pools - Get](https://docs.microsoft.com/en-us/rest/api/azure/devops/distributedtask/pools/get?view=azure-devops-rest-7.0)
+    - [Azure DevOps Service REST API 7.1 - Agent Pools - Get](https://docs.microsoft.com/en-us/rest/api/azure/devops/distributedtask/pools/get?view=azure-devops-rest-7.1)
 
 
     :param str name: Name of the Agent Pool.

pulumi_azuredevops/get_pools.py

@@ -39,7 +39,7 @@ class GetPoolsResult:
     @pulumi.getter(name="agentPools")
     def agent_pools(self) -> Sequence['outputs.GetPoolsAgentPoolResult']:
         """
-        A list of existing agent pools in your Azure DevOps Organization with the following details about every agent pool:
+        An `agent_pools` blocks as documented below. A list of existing agent pools in your Azure DevOps Organization with the following details about every agent pool:
         """
         return pulumi.get(self, "agent_pools")
 
@@ -81,7 +81,7 @@ def get_pools(opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetPoolsR
 
     ## Relevant Links
 
-    - [Azure DevOps Service REST API 7.0 - Agent Pools - Get](https://docs.microsoft.com/en-us/rest/api/azure/devops/distributedtask/pools/get?view=azure-devops-rest-7.0)
+    - [Azure DevOps Service REST API 7.1 - Agent Pools - Get](https://docs.microsoft.com/en-us/rest/api/azure/devops/distributedtask/pools/get?view=azure-devops-rest-7.1)
     """
     __args__ = dict()
     opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
@@ -109,7 +109,7 @@ def get_pools_output(opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOut
 
     ## Relevant Links
 
-    - [Azure DevOps Service REST API 7.0 - Agent Pools - Get](https://docs.microsoft.com/en-us/rest/api/azure/devops/distributedtask/pools/get?view=azure-devops-rest-7.0)
+    - [Azure DevOps Service REST API 7.1 - Agent Pools - Get](https://docs.microsoft.com/en-us/rest/api/azure/devops/distributedtask/pools/get?view=azure-devops-rest-7.1)
     """
     __args__ = dict()
     opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)

pulumi_azuredevops/get_project.py

@@ -58,6 +58,9 @@ class GetProjectResult:
     @property
     @pulumi.getter
     def description(self) -> str:
+        """
+        The description of the project.
+        """
         return pulumi.get(self, "description")
 
     @property
@@ -76,11 +79,17 @@ class GetProjectResult:
     @property
     @pulumi.getter
     def name(self) -> Optional[str]:
+        """
+        The name of the project.
+        """
         return pulumi.get(self, "name")
 
     @property
     @pulumi.getter(name="processTemplateId")
     def process_template_id(self) -> str:
+        """
+        The process template ID for the project.
+        """
         return pulumi.get(self, "process_template_id")
 
     @property
@@ -91,16 +100,25 @@ class GetProjectResult:
     @property
     @pulumi.getter(name="versionControl")
     def version_control(self) -> str:
+        """
+        The version control of the project.
+        """
         return pulumi.get(self, "version_control")
 
     @property
     @pulumi.getter
     def visibility(self) -> str:
+        """
+        The visibility of the project.
+        """
         return pulumi.get(self, "visibility")
 
     @property
     @pulumi.getter(name="workItemTemplate")
     def work_item_template(self) -> str:
+        """
+        The work item template for the project.
+        """
         return pulumi.get(self, "work_item_template")
 
 
@@ -141,9 +159,16 @@ def get_project(name: Optional[str] = None,
 
     - [Azure DevOps Service REST API 7.0 - Projects - Get](https://docs.microsoft.com/en-us/rest/api/azure/devops/core/projects/get?view=azure-devops-rest-7.0)
 
+    ## PAT Permissions Required
+
+    - **Project & Team**: Read
+    - **Work Items**: Read
+
 
     :param str name: Name of the Project.
     :param str project_id: ID of the Project.
+           
+           > **NOTE:** One of either `project_id` or `name` must be specified.
     """
     __args__ = dict()
     __args__['name'] = name
@@ -181,9 +206,16 @@ def get_project_output(name: Optional[pulumi.Input[Optional[str]]] = None,
 
     - [Azure DevOps Service REST API 7.0 - Projects - Get](https://docs.microsoft.com/en-us/rest/api/azure/devops/core/projects/get?view=azure-devops-rest-7.0)
 
+    ## PAT Permissions Required
+
+    - **Project & Team**: Read
+    - **Work Items**: Read
+
 
     :param str name: Name of the Project.
     :param str project_id: ID of the Project.
+           
+           > **NOTE:** One of either `project_id` or `name` must be specified.
     """
     __args__ = dict()
     __args__['name'] = name

pulumi_azuredevops/get_projects.py

@@ -61,7 +61,7 @@ class GetProjectsResult:
     @pulumi.getter
     def projects(self) -> Sequence['outputs.GetProjectsProjectResult']:
         """
-        A list of existing projects in your Azure DevOps Organization with details about every project which includes:
+        A list of `projects` blocks as documented below. A list of existing projects in your Azure DevOps Organization with details about every project which includes:
         """
         return pulumi.get(self, "projects")
 
@@ -69,7 +69,7 @@ class GetProjectsResult:
     @pulumi.getter
     def state(self) -> Optional[str]:
         """
-        Project state.
+        The state of the Project.
         """
         return pulumi.get(self, "state")
 
@@ -114,7 +114,7 @@ def get_projects(name: Optional[str] = None,
     :param str name: Name of the Project, if not specified all projects will be returned.
     :param str state: State of the Project, if not specified all projects will be returned. Valid values are `all`, `deleting`, `new`, `wellFormed`, `createPending`, `unchanged`,`deleted`.
            
-           DataSource without specifying any arguments will return all projects.
+           > **NOTE:** DataSource without specifying any arguments will return all projects.
     """
     __args__ = dict()
     __args__['name'] = name
@@ -155,7 +155,7 @@ def get_projects_output(name: Optional[pulumi.Input[Optional[str]]] = None,
     :param str name: Name of the Project, if not specified all projects will be returned.
     :param str state: State of the Project, if not specified all projects will be returned. Valid values are `all`, `deleting`, `new`, `wellFormed`, `createPending`, `unchanged`,`deleted`.
            
-           DataSource without specifying any arguments will return all projects.
+           > **NOTE:** DataSource without specifying any arguments will return all projects.
     """
     __args__ = dict()
     __args__['name'] = name

pulumi_azuredevops/get_repositories.py

@@ -77,7 +77,7 @@ class GetRepositoriesResult:
     @pulumi.getter
     def repositories(self) -> Sequence['outputs.GetRepositoriesRepositoryResult']:
         """
-        A list of existing projects in your Azure DevOps Organization with details about every project which includes:
+        A `repositories` blocks as documented below. A list of existing projects in your Azure DevOps Organization with details about every project.
         """
         return pulumi.get(self, "repositories")
 
@@ -123,7 +123,9 @@ def get_repositories(include_hidden: Optional[bool] = None,
     - [Azure DevOps Service REST API 7.0 - Git API](https://docs.microsoft.com/en-us/rest/api/azure/devops/git/?view=azure-devops-rest-7.0)
 
 
-    :param bool include_hidden: DataSource without specifying any arguments will return all Git repositories of an organization.
+    :param bool include_hidden: Defaults to `false`.
+           
+           DataSource without specifying any arguments will return all Git repositories of an organization.
     :param str name: Name of the Git repository to retrieve; requires `project_id` to be specified as well
     :param str project_id: ID of project to list Git repositories
     """
@@ -168,7 +170,9 @@ def get_repositories_output(include_hidden: Optional[pulumi.Input[Optional[bool]
     - [Azure DevOps Service REST API 7.0 - Git API](https://docs.microsoft.com/en-us/rest/api/azure/devops/git/?view=azure-devops-rest-7.0)
 
 
-    :param bool include_hidden: DataSource without specifying any arguments will return all Git repositories of an organization.
+    :param bool include_hidden: Defaults to `false`.
+           
+           DataSource without specifying any arguments will return all Git repositories of an organization.
     :param str name: Name of the Git repository to retrieve; requires `project_id` to be specified as well
     :param str project_id: ID of project to list Git repositories
     """

pulumi_azuredevops/get_securityrole_definitions.py

@@ -91,12 +91,12 @@ def get_securityrole_definitions(scope: Optional[str] = None,
 
     ## Relevant Links
 
-    - [Azure DevOps Service REST API 7.0 - Roledefinitions - List](https://learn.microsoft.com/en-us/rest/api/azure/devops/securityroles/roledefinitions/list?view=azure-devops-rest-7.1)
+    - [Azure DevOps Service REST API 7.0 - Role Definitions - List](https://learn.microsoft.com/en-us/rest/api/azure/devops/securityroles/roledefinitions/list?view=azure-devops-rest-7.1)
 
 
     :param str scope: Name of the Scope for which Security Role Definitions will be returned.
            
-           DataSource without specifying any arguments will return all projects.
+           > **NOTE:** DataSource without specifying any arguments will return all projects.
     """
     __args__ = dict()
     __args__['scope'] = scope
@@ -124,12 +124,12 @@ def get_securityrole_definitions_output(scope: Optional[pulumi.Input[str]] = Non
 
     ## Relevant Links
 
-    - [Azure DevOps Service REST API 7.0 - Roledefinitions - List](https://learn.microsoft.com/en-us/rest/api/azure/devops/securityroles/roledefinitions/list?view=azure-devops-rest-7.1)
+    - [Azure DevOps Service REST API 7.0 - Role Definitions - List](https://learn.microsoft.com/en-us/rest/api/azure/devops/securityroles/roledefinitions/list?view=azure-devops-rest-7.1)
 
 
     :param str scope: Name of the Scope for which Security Role Definitions will be returned.
            
-           DataSource without specifying any arguments will return all projects.
+           > **NOTE:** DataSource without specifying any arguments will return all projects.
     """
     __args__ = dict()
     __args__['scope'] = scope

pulumi_azuredevops/get_service_endpoint_azure_rm.py

@@ -86,7 +86,7 @@ class GetServiceEndpointAzureRMResult:
     @pulumi.getter
     def authorization(self) -> Mapping[str, str]:
         """
-        The Authorization Scheme Map.
+        The Authorization scheme.
         """
         return pulumi.get(self, "authorization")
 
@@ -282,8 +282,8 @@ def get_service_endpoint_azure_rm(project_id: Optional[str] = None,
     :param str service_endpoint_id: the ID of the Service Endpoint.
     :param str service_endpoint_name: the Name of the Service Endpoint.
            
-           > **NOTE:** One of either `service_endpoint_id` or `service_endpoint_name` must be specified.
-           > **NOTE:** When supplying `service_endpoint_name`, take care to ensure that this is a unique name.
+           > **NOTE:** 1. One of either `service_endpoint_id` or `service_endpoint_name` must be specified.
+           <br>2. When supplying `service_endpoint_name`, take care to ensure that this is a unique name.
     """
     __args__ = dict()
     __args__['projectId'] = project_id
@@ -349,8 +349,8 @@ def get_service_endpoint_azure_rm_output(project_id: Optional[pulumi.Input[str]]
     :param str service_endpoint_id: the ID of the Service Endpoint.
     :param str service_endpoint_name: the Name of the Service Endpoint.
            
-           > **NOTE:** One of either `service_endpoint_id` or `service_endpoint_name` must be specified.
-           > **NOTE:** When supplying `service_endpoint_name`, take care to ensure that this is a unique name.
+           > **NOTE:** 1. One of either `service_endpoint_id` or `service_endpoint_name` must be specified.
+           <br>2. When supplying `service_endpoint_name`, take care to ensure that this is a unique name.
     """
     __args__ = dict()
     __args__['projectId'] = project_id

pulumi_azuredevops/get_service_endpoint_github.py

@@ -50,7 +50,7 @@ class GetServiceEndpointGithubResult:
     @pulumi.getter
     def authorization(self) -> Mapping[str, str]:
         """
-        Specifies the Authorization Scheme Map.
+        The Authorization scheme.
         """
         return pulumi.get(self, "authorization")
 
@@ -58,7 +58,7 @@ class GetServiceEndpointGithubResult:
     @pulumi.getter
     def description(self) -> str:
         """
-        Specifies the description of the Service Endpoint.
+        The description of the Service Endpoint.
         """
         return pulumi.get(self, "description")
 
@@ -138,8 +138,8 @@ def get_service_endpoint_github(project_id: Optional[str] = None,
     :param str service_endpoint_id: the ID of the Service Endpoint.
     :param str service_endpoint_name: the Name of the Service Endpoint.
            
-           > **NOTE:** One of either `service_endpoint_id` or `service_endpoint_name` must be specified.
-           > **NOTE:** When supplying `service_endpoint_name`, take care to ensure that this is a unique name.
+           > **NOTE:** 1. One of either `service_endpoint_id` or `service_endpoint_name` must be specified.
+           <br>2. When supplying `service_endpoint_name`, take care to ensure that this is a unique name.
     """
     __args__ = dict()
     __args__['projectId'] = project_id
@@ -193,8 +193,8 @@ def get_service_endpoint_github_output(project_id: Optional[pulumi.Input[str]] =
     :param str service_endpoint_id: the ID of the Service Endpoint.
     :param str service_endpoint_name: the Name of the Service Endpoint.
            
-           > **NOTE:** One of either `service_endpoint_id` or `service_endpoint_name` must be specified.
-           > **NOTE:** When supplying `service_endpoint_name`, take care to ensure that this is a unique name.
+           > **NOTE:** 1. One of either `service_endpoint_id` or `service_endpoint_name` must be specified.
+           <br>2. When supplying `service_endpoint_name`, take care to ensure that this is a unique name.
     """
     __args__ = dict()
     __args__['projectId'] = project_id

pulumi_azuredevops/get_service_principal.py

@@ -0,0 +1,153 @@
+# coding=utf-8
+# *** WARNING: this file was generated by the Pulumi Terraform Bridge (tfgen) Tool. ***
+# *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+import copy
+import warnings
+import sys
+import pulumi
+import pulumi.runtime
+from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
+from . import _utilities
+
+__all__ = [
+    'GetServicePrincipalResult',
+    'AwaitableGetServicePrincipalResult',
+    'get_service_principal',
+    'get_service_principal_output',
+]
+
+@pulumi.output_type
+class GetServicePrincipalResult:
+    """
+    A collection of values returned by getServicePrincipal.
+    """
+    def __init__(__self__, descriptor=None, display_name=None, id=None, origin=None, origin_id=None):
+        if descriptor and not isinstance(descriptor, str):
+            raise TypeError("Expected argument 'descriptor' to be a str")
+        pulumi.set(__self__, "descriptor", descriptor)
+        if display_name and not isinstance(display_name, str):
+            raise TypeError("Expected argument 'display_name' to be a str")
+        pulumi.set(__self__, "display_name", display_name)
+        if id and not isinstance(id, str):
+            raise TypeError("Expected argument 'id' to be a str")
+        pulumi.set(__self__, "id", id)
+        if origin and not isinstance(origin, str):
+            raise TypeError("Expected argument 'origin' to be a str")
+        pulumi.set(__self__, "origin", origin)
+        if origin_id and not isinstance(origin_id, str):
+            raise TypeError("Expected argument 'origin_id' to be a str")
+        pulumi.set(__self__, "origin_id", origin_id)
+
+    @property
+    @pulumi.getter
+    def descriptor(self) -> str:
+        """
+        The descriptor of the Service Principal.
+        """
+        return pulumi.get(self, "descriptor")
+
+    @property
+    @pulumi.getter(name="displayName")
+    def display_name(self) -> str:
+        return pulumi.get(self, "display_name")
+
+    @property
+    @pulumi.getter
+    def id(self) -> str:
+        """
+        The provider-assigned unique ID for this managed resource.
+        """
+        return pulumi.get(self, "id")
+
+    @property
+    @pulumi.getter
+    def origin(self) -> str:
+        """
+        The origin of the Service Principal.
+        """
+        return pulumi.get(self, "origin")
+
+    @property
+    @pulumi.getter(name="originId")
+    def origin_id(self) -> str:
+        """
+        The origin ID of the Service Principal..
+        """
+        return pulumi.get(self, "origin_id")
+
+
+class AwaitableGetServicePrincipalResult(GetServicePrincipalResult):
+    # pylint: disable=using-constant-test
+    def __await__(self):
+        if False:
+            yield self
+        return GetServicePrincipalResult(
+            descriptor=self.descriptor,
+            display_name=self.display_name,
+            id=self.id,
+            origin=self.origin,
+            origin_id=self.origin_id)
+
+
+def get_service_principal(display_name: Optional[str] = None,
+                          opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetServicePrincipalResult:
+    """
+    Use this data source to access information about an existing Service Principal.
+
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_azuredevops as azuredevops
+
+    example = azuredevops.get_service_principal(display_name="existing")
+    pulumi.export("id", example.id)
+    ```
+
+
+    :param str display_name: The Display Name of the Service Principal. Changing this forces a new Service Principal to be created.
+    """
+    __args__ = dict()
+    __args__['displayName'] = display_name
+    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke('azuredevops:index/getServicePrincipal:getServicePrincipal', __args__, opts=opts, typ=GetServicePrincipalResult).value
+
+    return AwaitableGetServicePrincipalResult(
+        descriptor=pulumi.get(__ret__, 'descriptor'),
+        display_name=pulumi.get(__ret__, 'display_name'),
+        id=pulumi.get(__ret__, 'id'),
+        origin=pulumi.get(__ret__, 'origin'),
+        origin_id=pulumi.get(__ret__, 'origin_id'))
+def get_service_principal_output(display_name: Optional[pulumi.Input[str]] = None,
+                                 opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetServicePrincipalResult]:
+    """
+    Use this data source to access information about an existing Service Principal.
+
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_azuredevops as azuredevops
+
+    example = azuredevops.get_service_principal(display_name="existing")
+    pulumi.export("id", example.id)
+    ```
+
+
+    :param str display_name: The Display Name of the Service Principal. Changing this forces a new Service Principal to be created.
+    """
+    __args__ = dict()
+    __args__['displayName'] = display_name
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('azuredevops:index/getServicePrincipal:getServicePrincipal', __args__, opts=opts, typ=GetServicePrincipalResult)
+    return __ret__.apply(lambda __response__: GetServicePrincipalResult(
+        descriptor=pulumi.get(__response__, 'descriptor'),
+        display_name=pulumi.get(__response__, 'display_name'),
+        id=pulumi.get(__response__, 'id'),
+        origin=pulumi.get(__response__, 'origin'),
+        origin_id=pulumi.get(__response__, 'origin_id')))