pulumi-azuredevops 3.9.0a1745040263__py3-none-any.whl → 3.10.0__py3-none-any.whl

pulumi_azuredevops/get_git_repository_file.py

@@ -0,0 +1,201 @@
+# 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 builtins
+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__ = [
+    'GetGitRepositoryFileResult',
+    'AwaitableGetGitRepositoryFileResult',
+    'get_git_repository_file',
+    'get_git_repository_file_output',
+]
+
+@pulumi.output_type
+class GetGitRepositoryFileResult:
+    """
+    A collection of values returned by getGitRepositoryFile.
+    """
+    def __init__(__self__, branch=None, content=None, file=None, id=None, last_commit_message=None, repository_id=None, tag=None):
+        if branch and not isinstance(branch, str):
+            raise TypeError("Expected argument 'branch' to be a str")
+        pulumi.set(__self__, "branch", branch)
+        if content and not isinstance(content, str):
+            raise TypeError("Expected argument 'content' to be a str")
+        pulumi.set(__self__, "content", content)
+        if file and not isinstance(file, str):
+            raise TypeError("Expected argument 'file' to be a str")
+        pulumi.set(__self__, "file", file)
+        if id and not isinstance(id, str):
+            raise TypeError("Expected argument 'id' to be a str")
+        pulumi.set(__self__, "id", id)
+        if last_commit_message and not isinstance(last_commit_message, str):
+            raise TypeError("Expected argument 'last_commit_message' to be a str")
+        pulumi.set(__self__, "last_commit_message", last_commit_message)
+        if repository_id and not isinstance(repository_id, str):
+            raise TypeError("Expected argument 'repository_id' to be a str")
+        pulumi.set(__self__, "repository_id", repository_id)
+        if tag and not isinstance(tag, str):
+            raise TypeError("Expected argument 'tag' to be a str")
+        pulumi.set(__self__, "tag", tag)
+
+    @property
+    @pulumi.getter
+    def branch(self) -> Optional[builtins.str]:
+        return pulumi.get(self, "branch")
+
+    @property
+    @pulumi.getter
+    def content(self) -> builtins.str:
+        """
+        The file content.
+        """
+        return pulumi.get(self, "content")
+
+    @property
+    @pulumi.getter
+    def file(self) -> builtins.str:
+        return pulumi.get(self, "file")
+
+    @property
+    @pulumi.getter
+    def id(self) -> builtins.str:
+        """
+        The provider-assigned unique ID for this managed resource.
+        """
+        return pulumi.get(self, "id")
+
+    @property
+    @pulumi.getter(name="lastCommitMessage")
+    def last_commit_message(self) -> builtins.str:
+        """
+        The commit message for the file.
+        """
+        return pulumi.get(self, "last_commit_message")
+
+    @property
+    @pulumi.getter(name="repositoryId")
+    def repository_id(self) -> builtins.str:
+        return pulumi.get(self, "repository_id")
+
+    @property
+    @pulumi.getter
+    def tag(self) -> Optional[builtins.str]:
+        return pulumi.get(self, "tag")
+
+
+class AwaitableGetGitRepositoryFileResult(GetGitRepositoryFileResult):
+    # pylint: disable=using-constant-test
+    def __await__(self):
+        if False:
+            yield self
+        return GetGitRepositoryFileResult(
+            branch=self.branch,
+            content=self.content,
+            file=self.file,
+            id=self.id,
+            last_commit_message=self.last_commit_message,
+            repository_id=self.repository_id,
+            tag=self.tag)
+
+
+def get_git_repository_file(branch: Optional[builtins.str] = None,
+                            file: Optional[builtins.str] = None,
+                            repository_id: Optional[builtins.str] = None,
+                            tag: Optional[builtins.str] = None,
+                            opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetGitRepositoryFileResult:
+    """
+    Use this data source to get an existing Git Repository File.
+
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_azuredevops as azuredevops
+
+    example = azuredevops.get_project(name="Example Project")
+    # Load a specific Git repository by name
+    example_get_git_repository = azuredevops.get_git_repository(project_id=example.id,
+        name="Example Repository")
+    example_get_git_repository_file = azuredevops.get_git_repository_file(repository_id=example_get_git_repository.id,
+        branch="refs/heads/main",
+        file="MyFile.txt")
+    ```
+
+
+    :param builtins.str branch: The git branch to use. Conflicts with `tag`; one or the other must be specified.
+    :param builtins.str file: The path of the file to get.
+    :param builtins.str repository_id: The ID of the Git repository.
+    :param builtins.str tag: The tag to use.Conflicts with `branch`; one or the other must be specified.
+    """
+    __args__ = dict()
+    __args__['branch'] = branch
+    __args__['file'] = file
+    __args__['repositoryId'] = repository_id
+    __args__['tag'] = tag
+    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke('azuredevops:index/getGitRepositoryFile:getGitRepositoryFile', __args__, opts=opts, typ=GetGitRepositoryFileResult).value
+
+    return AwaitableGetGitRepositoryFileResult(
+        branch=pulumi.get(__ret__, 'branch'),
+        content=pulumi.get(__ret__, 'content'),
+        file=pulumi.get(__ret__, 'file'),
+        id=pulumi.get(__ret__, 'id'),
+        last_commit_message=pulumi.get(__ret__, 'last_commit_message'),
+        repository_id=pulumi.get(__ret__, 'repository_id'),
+        tag=pulumi.get(__ret__, 'tag'))
+def get_git_repository_file_output(branch: Optional[pulumi.Input[Optional[builtins.str]]] = None,
+                                   file: Optional[pulumi.Input[builtins.str]] = None,
+                                   repository_id: Optional[pulumi.Input[builtins.str]] = None,
+                                   tag: Optional[pulumi.Input[Optional[builtins.str]]] = None,
+                                   opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetGitRepositoryFileResult]:
+    """
+    Use this data source to get an existing Git Repository File.
+
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_azuredevops as azuredevops
+
+    example = azuredevops.get_project(name="Example Project")
+    # Load a specific Git repository by name
+    example_get_git_repository = azuredevops.get_git_repository(project_id=example.id,
+        name="Example Repository")
+    example_get_git_repository_file = azuredevops.get_git_repository_file(repository_id=example_get_git_repository.id,
+        branch="refs/heads/main",
+        file="MyFile.txt")
+    ```
+
+
+    :param builtins.str branch: The git branch to use. Conflicts with `tag`; one or the other must be specified.
+    :param builtins.str file: The path of the file to get.
+    :param builtins.str repository_id: The ID of the Git repository.
+    :param builtins.str tag: The tag to use.Conflicts with `branch`; one or the other must be specified.
+    """
+    __args__ = dict()
+    __args__['branch'] = branch
+    __args__['file'] = file
+    __args__['repositoryId'] = repository_id
+    __args__['tag'] = tag
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('azuredevops:index/getGitRepositoryFile:getGitRepositoryFile', __args__, opts=opts, typ=GetGitRepositoryFileResult)
+    return __ret__.apply(lambda __response__: GetGitRepositoryFileResult(
+        branch=pulumi.get(__response__, 'branch'),
+        content=pulumi.get(__response__, 'content'),
+        file=pulumi.get(__response__, 'file'),
+        id=pulumi.get(__response__, 'id'),
+        last_commit_message=pulumi.get(__response__, 'last_commit_message'),
+        repository_id=pulumi.get(__response__, 'repository_id'),
+        tag=pulumi.get(__response__, 'tag')))

pulumi_azuredevops/get_group.py

@@ -54,7 +54,7 @@ class GetGroupResult:
     @pulumi.getter
     def descriptor(self) -> builtins.str:
         """
-        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.
+        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. In format of `vssgp.xxxxxxxxxxxxxxxxxxx`
         """
         return pulumi.get(self, "descriptor")
 

pulumi_azuredevops/get_serviceendpoint_dockerregistry.py

@@ -0,0 +1,282 @@
+# 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 builtins
+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__ = [
+    'GetServiceendpointDockerregistryResult',
+    'AwaitableGetServiceendpointDockerregistryResult',
+    'get_serviceendpoint_dockerregistry',
+    'get_serviceendpoint_dockerregistry_output',
+]
+
+@pulumi.output_type
+class GetServiceendpointDockerregistryResult:
+    """
+    A collection of values returned by getServiceendpointDockerregistry.
+    """
+    def __init__(__self__, authorization=None, description=None, docker_email=None, docker_password=None, docker_registry=None, docker_username=None, id=None, project_id=None, registry_type=None, service_endpoint_id=None, service_endpoint_name=None):
+        if authorization and not isinstance(authorization, dict):
+            raise TypeError("Expected argument 'authorization' to be a dict")
+        pulumi.set(__self__, "authorization", authorization)
+        if description and not isinstance(description, str):
+            raise TypeError("Expected argument 'description' to be a str")
+        pulumi.set(__self__, "description", description)
+        if docker_email and not isinstance(docker_email, str):
+            raise TypeError("Expected argument 'docker_email' to be a str")
+        pulumi.set(__self__, "docker_email", docker_email)
+        if docker_password and not isinstance(docker_password, str):
+            raise TypeError("Expected argument 'docker_password' to be a str")
+        pulumi.set(__self__, "docker_password", docker_password)
+        if docker_registry and not isinstance(docker_registry, str):
+            raise TypeError("Expected argument 'docker_registry' to be a str")
+        pulumi.set(__self__, "docker_registry", docker_registry)
+        if docker_username and not isinstance(docker_username, str):
+            raise TypeError("Expected argument 'docker_username' to be a str")
+        pulumi.set(__self__, "docker_username", docker_username)
+        if id and not isinstance(id, str):
+            raise TypeError("Expected argument 'id' to be a str")
+        pulumi.set(__self__, "id", id)
+        if project_id and not isinstance(project_id, str):
+            raise TypeError("Expected argument 'project_id' to be a str")
+        pulumi.set(__self__, "project_id", project_id)
+        if registry_type and not isinstance(registry_type, str):
+            raise TypeError("Expected argument 'registry_type' to be a str")
+        pulumi.set(__self__, "registry_type", registry_type)
+        if service_endpoint_id and not isinstance(service_endpoint_id, str):
+            raise TypeError("Expected argument 'service_endpoint_id' to be a str")
+        pulumi.set(__self__, "service_endpoint_id", service_endpoint_id)
+        if service_endpoint_name and not isinstance(service_endpoint_name, str):
+            raise TypeError("Expected argument 'service_endpoint_name' to be a str")
+        pulumi.set(__self__, "service_endpoint_name", service_endpoint_name)
+
+    @property
+    @pulumi.getter
+    def authorization(self) -> Mapping[str, builtins.str]:
+        """
+        The Authorization scheme.
+        """
+        return pulumi.get(self, "authorization")
+
+    @property
+    @pulumi.getter
+    def description(self) -> builtins.str:
+        """
+        The Service Endpoint description.
+        """
+        return pulumi.get(self, "description")
+
+    @property
+    @pulumi.getter(name="dockerEmail")
+    def docker_email(self) -> builtins.str:
+        """
+        The email for Docker account user.
+        """
+        return pulumi.get(self, "docker_email")
+
+    @property
+    @pulumi.getter(name="dockerPassword")
+    def docker_password(self) -> builtins.str:
+        """
+        The password for the account user identified above.
+        """
+        return pulumi.get(self, "docker_password")
+
+    @property
+    @pulumi.getter(name="dockerRegistry")
+    def docker_registry(self) -> builtins.str:
+        """
+        The URL of the Docker registry.
+        """
+        return pulumi.get(self, "docker_registry")
+
+    @property
+    @pulumi.getter(name="dockerUsername")
+    def docker_username(self) -> builtins.str:
+        """
+        The identifier of the Docker account user.
+        """
+        return pulumi.get(self, "docker_username")
+
+    @property
+    @pulumi.getter
+    def id(self) -> builtins.str:
+        """
+        The provider-assigned unique ID for this managed resource.
+        """
+        return pulumi.get(self, "id")
+
+    @property
+    @pulumi.getter(name="projectId")
+    def project_id(self) -> builtins.str:
+        return pulumi.get(self, "project_id")
+
+    @property
+    @pulumi.getter(name="registryType")
+    def registry_type(self) -> builtins.str:
+        """
+        Can be "DockerHub" or "Others" (Default "DockerHub")
+        """
+        return pulumi.get(self, "registry_type")
+
+    @property
+    @pulumi.getter(name="serviceEndpointId")
+    def service_endpoint_id(self) -> builtins.str:
+        return pulumi.get(self, "service_endpoint_id")
+
+    @property
+    @pulumi.getter(name="serviceEndpointName")
+    def service_endpoint_name(self) -> builtins.str:
+        return pulumi.get(self, "service_endpoint_name")
+
+
+class AwaitableGetServiceendpointDockerregistryResult(GetServiceendpointDockerregistryResult):
+    # pylint: disable=using-constant-test
+    def __await__(self):
+        if False:
+            yield self
+        return GetServiceendpointDockerregistryResult(
+            authorization=self.authorization,
+            description=self.description,
+            docker_email=self.docker_email,
+            docker_password=self.docker_password,
+            docker_registry=self.docker_registry,
+            docker_username=self.docker_username,
+            id=self.id,
+            project_id=self.project_id,
+            registry_type=self.registry_type,
+            service_endpoint_id=self.service_endpoint_id,
+            service_endpoint_name=self.service_endpoint_name)
+
+
+def get_serviceendpoint_dockerregistry(project_id: Optional[builtins.str] = None,
+                                       service_endpoint_id: Optional[builtins.str] = None,
+                                       service_endpoint_name: Optional[builtins.str] = None,
+                                       opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetServiceendpointDockerregistryResult:
+    """
+    Use this data source to access information about an existing Docker Registry Service Endpoint.
+
+    ## Example Usage
+
+    ### By Service Endpoint ID
+
+    ```python
+    import pulumi
+    import pulumi_azuredevops as azuredevops
+
+    example = azuredevops.get_project(name="Example Project")
+    example_get_serviceendpoint_dockerregistry = azuredevops.get_serviceendpoint_dockerregistry(project_id=example.id,
+        service_endpoint_id="00000000-0000-0000-0000-000000000000")
+    pulumi.export("serviceEndpointName", example_get_serviceendpoint_dockerregistry.service_endpoint_name)
+    ```
+
+    ### By Service Endpoint Name
+
+    ```python
+    import pulumi
+    import pulumi_azuredevops as azuredevops
+
+    example = azuredevops.get_project(name="Example Project")
+    example_get_serviceendpoint_dockerregistry = azuredevops.get_serviceendpoint_dockerregistry(project_id=example.id,
+        service_endpoint_name="Example-Service-Endpoint")
+    pulumi.export("serviceEndpointId", serviceendpoint["id"])
+    ```
+
+
+    :param builtins.str project_id: The ID of the project.
+    :param builtins.str service_endpoint_id: the ID of the Service Endpoint.
+    :param builtins.str service_endpoint_name: the Name of the Service Endpoint.
+           
+           > **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
+    __args__['serviceEndpointId'] = service_endpoint_id
+    __args__['serviceEndpointName'] = service_endpoint_name
+    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke('azuredevops:index/getServiceendpointDockerregistry:getServiceendpointDockerregistry', __args__, opts=opts, typ=GetServiceendpointDockerregistryResult).value
+
+    return AwaitableGetServiceendpointDockerregistryResult(
+        authorization=pulumi.get(__ret__, 'authorization'),
+        description=pulumi.get(__ret__, 'description'),
+        docker_email=pulumi.get(__ret__, 'docker_email'),
+        docker_password=pulumi.get(__ret__, 'docker_password'),
+        docker_registry=pulumi.get(__ret__, 'docker_registry'),
+        docker_username=pulumi.get(__ret__, 'docker_username'),
+        id=pulumi.get(__ret__, 'id'),
+        project_id=pulumi.get(__ret__, 'project_id'),
+        registry_type=pulumi.get(__ret__, 'registry_type'),
+        service_endpoint_id=pulumi.get(__ret__, 'service_endpoint_id'),
+        service_endpoint_name=pulumi.get(__ret__, 'service_endpoint_name'))
+def get_serviceendpoint_dockerregistry_output(project_id: Optional[pulumi.Input[builtins.str]] = None,
+                                              service_endpoint_id: Optional[pulumi.Input[Optional[builtins.str]]] = None,
+                                              service_endpoint_name: Optional[pulumi.Input[Optional[builtins.str]]] = None,
+                                              opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetServiceendpointDockerregistryResult]:
+    """
+    Use this data source to access information about an existing Docker Registry Service Endpoint.
+
+    ## Example Usage
+
+    ### By Service Endpoint ID
+
+    ```python
+    import pulumi
+    import pulumi_azuredevops as azuredevops
+
+    example = azuredevops.get_project(name="Example Project")
+    example_get_serviceendpoint_dockerregistry = azuredevops.get_serviceendpoint_dockerregistry(project_id=example.id,
+        service_endpoint_id="00000000-0000-0000-0000-000000000000")
+    pulumi.export("serviceEndpointName", example_get_serviceendpoint_dockerregistry.service_endpoint_name)
+    ```
+
+    ### By Service Endpoint Name
+
+    ```python
+    import pulumi
+    import pulumi_azuredevops as azuredevops
+
+    example = azuredevops.get_project(name="Example Project")
+    example_get_serviceendpoint_dockerregistry = azuredevops.get_serviceendpoint_dockerregistry(project_id=example.id,
+        service_endpoint_name="Example-Service-Endpoint")
+    pulumi.export("serviceEndpointId", serviceendpoint["id"])
+    ```
+
+
+    :param builtins.str project_id: The ID of the project.
+    :param builtins.str service_endpoint_id: the ID of the Service Endpoint.
+    :param builtins.str service_endpoint_name: the Name of the Service Endpoint.
+           
+           > **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
+    __args__['serviceEndpointId'] = service_endpoint_id
+    __args__['serviceEndpointName'] = service_endpoint_name
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('azuredevops:index/getServiceendpointDockerregistry:getServiceendpointDockerregistry', __args__, opts=opts, typ=GetServiceendpointDockerregistryResult)
+    return __ret__.apply(lambda __response__: GetServiceendpointDockerregistryResult(
+        authorization=pulumi.get(__response__, 'authorization'),
+        description=pulumi.get(__response__, 'description'),
+        docker_email=pulumi.get(__response__, 'docker_email'),
+        docker_password=pulumi.get(__response__, 'docker_password'),
+        docker_registry=pulumi.get(__response__, 'docker_registry'),
+        docker_username=pulumi.get(__response__, 'docker_username'),
+        id=pulumi.get(__response__, 'id'),
+        project_id=pulumi.get(__response__, 'project_id'),
+        registry_type=pulumi.get(__response__, 'registry_type'),
+        service_endpoint_id=pulumi.get(__response__, 'service_endpoint_id'),
+        service_endpoint_name=pulumi.get(__response__, 'service_endpoint_name')))

pulumi_azuredevops/git.py

@@ -321,6 +321,7 @@ class _GitState:
         pulumi.set(self, "web_url", value)
 
 
+@pulumi.type_token("azuredevops:index/git:Git")
 class Git(pulumi.CustomResource):
     @overload
     def __init__(__self__,

pulumi_azuredevops/git_permissions.py

@@ -49,6 +49,9 @@ class GitPermissionsArgs:
                | PullRequestContribute   | Contribute to pull requests                            |
                | PullRequestBypassPolicy | Bypass policies when completing pull requests          |
         :param pulumi.Input[builtins.str] principal: The **group** principal to assign the permissions.
+               
+               > **Note**  The `descriptor` of the user/group not the `ID`. Some resources in this provider use the `descriptor`
+               as resource ID. It is recommended to check before use.
         :param pulumi.Input[builtins.str] project_id: The ID of the project to assign the permissions.
         :param pulumi.Input[builtins.str] branch_name: The name of the branch to assign the permissions.
                
@@ -102,6 +105,9 @@ class GitPermissionsArgs:
     def principal(self) -> pulumi.Input[builtins.str]:
         """
         The **group** principal to assign the permissions.
+
+        > **Note**  The `descriptor` of the user/group not the `ID`. Some resources in this provider use the `descriptor`
+        as resource ID. It is recommended to check before use.
         """
         return pulumi.get(self, "principal")
 
@@ -195,6 +201,9 @@ class _GitPermissionsState:
                | PullRequestContribute   | Contribute to pull requests                            |
                | PullRequestBypassPolicy | Bypass policies when completing pull requests          |
         :param pulumi.Input[builtins.str] principal: The **group** principal to assign the permissions.
+               
+               > **Note**  The `descriptor` of the user/group not the `ID`. Some resources in this provider use the `descriptor`
+               as resource ID. It is recommended to check before use.
         :param pulumi.Input[builtins.str] project_id: The ID of the project to assign the permissions.
         :param pulumi.Input[builtins.bool] replace: Replace (`true`) or merge (`false`) the permissions. Default: `true`
         :param pulumi.Input[builtins.str] repository_id: The ID of the GIT repository to assign the permissions
@@ -262,6 +271,9 @@ class _GitPermissionsState:
     def principal(self) -> Optional[pulumi.Input[builtins.str]]:
         """
         The **group** principal to assign the permissions.
+
+        > **Note**  The `descriptor` of the user/group not the `ID`. Some resources in this provider use the `descriptor`
+        as resource ID. It is recommended to check before use.
         """
         return pulumi.get(self, "principal")
 
@@ -306,6 +318,7 @@ class _GitPermissionsState:
         pulumi.set(self, "repository_id", value)
 
 
+@pulumi.type_token("azuredevops:index/gitPermissions:GitPermissions")
 class GitPermissions(pulumi.CustomResource):
     @overload
     def __init__(__self__,
@@ -517,6 +530,9 @@ class GitPermissions(pulumi.CustomResource):
                | PullRequestContribute   | Contribute to pull requests                            |
                | PullRequestBypassPolicy | Bypass policies when completing pull requests          |
         :param pulumi.Input[builtins.str] principal: The **group** principal to assign the permissions.
+               
+               > **Note**  The `descriptor` of the user/group not the `ID`. Some resources in this provider use the `descriptor`
+               as resource ID. It is recommended to check before use.
         :param pulumi.Input[builtins.str] project_id: The ID of the project to assign the permissions.
         :param pulumi.Input[builtins.bool] replace: Replace (`true`) or merge (`false`) the permissions. Default: `true`
         :param pulumi.Input[builtins.str] repository_id: The ID of the GIT repository to assign the permissions
@@ -789,6 +805,9 @@ class GitPermissions(pulumi.CustomResource):
                | PullRequestContribute   | Contribute to pull requests                            |
                | PullRequestBypassPolicy | Bypass policies when completing pull requests          |
         :param pulumi.Input[builtins.str] principal: The **group** principal to assign the permissions.
+               
+               > **Note**  The `descriptor` of the user/group not the `ID`. Some resources in this provider use the `descriptor`
+               as resource ID. It is recommended to check before use.
         :param pulumi.Input[builtins.str] project_id: The ID of the project to assign the permissions.
         :param pulumi.Input[builtins.bool] replace: Replace (`true`) or merge (`false`) the permissions. Default: `true`
         :param pulumi.Input[builtins.str] repository_id: The ID of the GIT repository to assign the permissions
@@ -847,6 +866,9 @@ class GitPermissions(pulumi.CustomResource):
     def principal(self) -> pulumi.Output[builtins.str]:
         """
         The **group** principal to assign the permissions.
+
+        > **Note**  The `descriptor` of the user/group not the `ID`. Some resources in this provider use the `descriptor`
+        as resource ID. It is recommended to check before use.
         """
         return pulumi.get(self, "principal")
 

pulumi_azuredevops/git_repository_branch.py

@@ -208,6 +208,7 @@ class _GitRepositoryBranchState:
         pulumi.set(self, "repository_id", value)
 
 
+@pulumi.type_token("azuredevops:index/gitRepositoryBranch:GitRepositoryBranch")
 class GitRepositoryBranch(pulumi.CustomResource):
     @overload
     def __init__(__self__,