pulumi-azuredevops 3.11.0a1755582172__tar.gz → 3.11.0a1756160177__tar.gz

{pulumi_azuredevops-3.11.0a1755582172 → pulumi_azuredevops-3.11.0a1756160177}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pulumi_azuredevops
-Version: 3.11.0a1755582172
+Version: 3.11.0a1756160177
 Summary: A Pulumi package for creating and managing Azure DevOps.
 License: Apache-2.0
 Project-URL: Homepage, https://pulumi.io

{pulumi_azuredevops-3.11.0a1755582172 → pulumi_azuredevops-3.11.0a1756160177}/pulumi_azuredevops/config/__init__.pyi

@@ -14,6 +14,11 @@ else:
     from typing_extensions import NotRequired, TypedDict, TypeAlias
 from .. import _utilities
 
+auxiliaryTenantIds: Optional[str]
+"""
+List of auxiliary Tenant IDs required for multi-tenancy and cross-tenant scenarios.
+"""
+
 clientCertificate: Optional[str]
 """
 Base64 encoded certificate to use to authenticate to the service principal.
@@ -31,12 +36,13 @@ Path to a certificate to use to authenticate to the service principal.
 
 clientId: Optional[str]
 """
-The service principal client or managed service principal id which should be used.
+The service principal client id which should be used for AAD auth.
 """
 
-clientIdApply: Optional[str]
-
-clientIdPlan: Optional[str]
+clientIdFilePath: Optional[str]
+"""
+The path to a file containing the Client ID which should be used.
+"""
 
 clientSecret: Optional[str]
 """
@@ -48,9 +54,9 @@ clientSecretPath: Optional[str]
 Path to a file containing a client secret for authenticating to a service principal.
 """
 
-oidcAudience: Optional[str]
+oidcAzureServiceConnectionId: Optional[str]
 """
-Set the audience when requesting OIDC tokens.
+The Azure Pipelines Service Connection ID to use for authentication.
 """
 
 oidcRequestToken: Optional[str]
@@ -65,8 +71,6 @@ The URL for the OIDC provider from which to request an ID token. For use when au
 using OpenID Connect.
 """
 
-oidcTfcTag: Optional[str]
-
 oidcToken: Optional[str]
 """
 OIDC token to authenticate as a service principal.
@@ -89,20 +93,21 @@ The personal access token which should be used.
 
 tenantId: Optional[str]
 """
-The service principal tenant id which should be used.
+The service principal tenant id which should be used for AAD auth.
 """
 
-tenantIdApply: Optional[str]
-
-tenantIdPlan: Optional[str]
+useCli: Optional[bool]
+"""
+Use Azure CLI to authenticate. Defaults to `true`.
+"""
 
 useMsi: Optional[bool]
 """
-Use an Azure Managed Service Identity.
+Use an Azure Managed Service Identity. Defaults to `false`.
 """
 
 useOidc: Optional[bool]
 """
-Use an OIDC token to authenticate to a service principal.
+Use an OIDC token to authenticate to a service principal. Defaults to `false`.
 """
 

{pulumi_azuredevops-3.11.0a1755582172 → pulumi_azuredevops-3.11.0a1756160177}/pulumi_azuredevops/config/vars.py

@@ -20,6 +20,13 @@ __config__ = pulumi.Config('azuredevops')
 
 
 class _ExportableConfig(types.ModuleType):
+    @_builtins.property
+    def auxiliary_tenant_ids(self) -> Optional[str]:
+        """
+        List of auxiliary Tenant IDs required for multi-tenancy and cross-tenant scenarios.
+        """
+        return __config__.get('auxiliaryTenantIds')
+
     @_builtins.property
     def client_certificate(self) -> Optional[str]:
         """
@@ -44,17 +51,16 @@ class _ExportableConfig(types.ModuleType):
     @_builtins.property
     def client_id(self) -> Optional[str]:
         """
-        The service principal client or managed service principal id which should be used.
+        The service principal client id which should be used for AAD auth.
         """
         return __config__.get('clientId')
 
     @_builtins.property
-    def client_id_apply(self) -> Optional[str]:
-        return __config__.get('clientIdApply')
-
-    @_builtins.property
-    def client_id_plan(self) -> Optional[str]:
-        return __config__.get('clientIdPlan')
+    def client_id_file_path(self) -> Optional[str]:
+        """
+        The path to a file containing the Client ID which should be used.
+        """
+        return __config__.get('clientIdFilePath')
 
     @_builtins.property
     def client_secret(self) -> Optional[str]:
@@ -71,11 +77,11 @@ class _ExportableConfig(types.ModuleType):
         return __config__.get('clientSecretPath')
 
     @_builtins.property
-    def oidc_audience(self) -> Optional[str]:
+    def oidc_azure_service_connection_id(self) -> Optional[str]:
         """
-        Set the audience when requesting OIDC tokens.
+        The Azure Pipelines Service Connection ID to use for authentication.
         """
-        return __config__.get('oidcAudience')
+        return __config__.get('oidcAzureServiceConnectionId')
 
     @_builtins.property
     def oidc_request_token(self) -> Optional[str]:
@@ -93,10 +99,6 @@ class _ExportableConfig(types.ModuleType):
         """
         return __config__.get('oidcRequestUrl')
 
-    @_builtins.property
-    def oidc_tfc_tag(self) -> Optional[str]:
-        return __config__.get('oidcTfcTag')
-
     @_builtins.property
     def oidc_token(self) -> Optional[str]:
         """
@@ -128,29 +130,28 @@ class _ExportableConfig(types.ModuleType):
     @_builtins.property
     def tenant_id(self) -> Optional[str]:
         """
-        The service principal tenant id which should be used.
+        The service principal tenant id which should be used for AAD auth.
         """
         return __config__.get('tenantId')
 
     @_builtins.property
-    def tenant_id_apply(self) -> Optional[str]:
-        return __config__.get('tenantIdApply')
-
-    @_builtins.property
-    def tenant_id_plan(self) -> Optional[str]:
-        return __config__.get('tenantIdPlan')
+    def use_cli(self) -> Optional[bool]:
+        """
+        Use Azure CLI to authenticate. Defaults to `true`.
+        """
+        return __config__.get_bool('useCli')
 
     @_builtins.property
     def use_msi(self) -> Optional[bool]:
         """
-        Use an Azure Managed Service Identity.
+        Use an Azure Managed Service Identity. Defaults to `false`.
         """
         return __config__.get_bool('useMsi')
 
     @_builtins.property
     def use_oidc(self) -> Optional[bool]:
         """
-        Use an OIDC token to authenticate to a service principal.
+        Use an OIDC token to authenticate to a service principal. Defaults to `false`.
         """
         return __config__.get_bool('useOidc')
 

{pulumi_azuredevops-3.11.0a1755582172 → pulumi_azuredevops-3.11.0a1756160177}/pulumi_azuredevops/get_user.py

@@ -149,6 +149,19 @@ def get_user(descriptor: Optional[_builtins.str] = None,
 
     ~>**NOTE:** If you only have the Storage Key(UUID) of the user, you can use `get_descriptor` to resolve the Storage Key(UUID) to a `descriptor`.
 
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_azuredevops as azuredevops
+
+    example = azuredevops.get_user(descriptor="descriptor")
+    ```
+
+    ## Relevant Links
+
+    - [Azure DevOps Service REST API 7.1 - Graph Users API](https://learn.microsoft.com/en-us/rest/api/azure/devops/graph/users/get?view=azure-devops-rest-7.1)
+
 
     :param _builtins.str descriptor: The descriptor of the user.
     """
@@ -174,6 +187,19 @@ def get_user_output(descriptor: Optional[pulumi.Input[_builtins.str]] = None,
 
     ~>**NOTE:** If you only have the Storage Key(UUID) of the user, you can use `get_descriptor` to resolve the Storage Key(UUID) to a `descriptor`.
 
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_azuredevops as azuredevops
+
+    example = azuredevops.get_user(descriptor="descriptor")
+    ```
+
+    ## Relevant Links
+
+    - [Azure DevOps Service REST API 7.1 - Graph Users API](https://learn.microsoft.com/en-us/rest/api/azure/devops/graph/users/get?view=azure-devops-rest-7.1)
+
 
     :param _builtins.str descriptor: The descriptor of the user.
     """

{pulumi_azuredevops-3.11.0a1755582172 → pulumi_azuredevops-3.11.0a1756160177}/pulumi_azuredevops/git_repository_branch.py

@@ -249,6 +249,14 @@ class GitRepositoryBranch(pulumi.CustomResource):
             ref_commit_id=example_git_repository_branch.last_commit_id)
         ```
 
+        ## Import
+
+        Azure DevOps Git Repository Branch can be imported using the `repository ID:branchName`.
+
+        ```sh
+        $ pulumi import azuredevops:index/gitRepositoryBranch:GitRepositoryBranch example "00000000-0000-0000-0000-000000000000:main"
+        ```
+
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[_builtins.str] name: The name of the branch in short format not prefixed with `refs/heads/`.
@@ -293,6 +301,14 @@ class GitRepositoryBranch(pulumi.CustomResource):
             ref_commit_id=example_git_repository_branch.last_commit_id)
         ```
 
+        ## Import
+
+        Azure DevOps Git Repository Branch can be imported using the `repository ID:branchName`.
+
+        ```sh
+        $ pulumi import azuredevops:index/gitRepositoryBranch:GitRepositoryBranch example "00000000-0000-0000-0000-000000000000:main"
+        ```
+
         :param str resource_name: The name of the resource.
         :param GitRepositoryBranchArgs args: The arguments to use to populate this resource's properties.
         :param pulumi.ResourceOptions opts: Options for the resource.