pulumi-gitlab 9.5.0a1761172288__py3-none-any.whl → 9.8.1__py3-none-any.whl

pulumi_gitlab/get_project_secure_file.py

@@ -0,0 +1,247 @@
+# coding=utf-8
+# *** WARNING: this file was generated by pulumi-language-python. ***
+# *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+import builtins as _builtins
+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
+from . import outputs
+
+__all__ = [
+    'GetProjectSecureFileResult',
+    'AwaitableGetProjectSecureFileResult',
+    'get_project_secure_file',
+    'get_project_secure_file_output',
+]
+
+@pulumi.output_type
+class GetProjectSecureFileResult:
+    """
+    A collection of values returned by getProjectSecureFile.
+    """
+    def __init__(__self__, checksum=None, checksum_algorithm=None, content=None, created_at=None, expires_at=None, id=None, metadata=None, name=None, project=None, secure_file_id=None):
+        if checksum and not isinstance(checksum, str):
+            raise TypeError("Expected argument 'checksum' to be a str")
+        pulumi.set(__self__, "checksum", checksum)
+        if checksum_algorithm and not isinstance(checksum_algorithm, str):
+            raise TypeError("Expected argument 'checksum_algorithm' to be a str")
+        pulumi.set(__self__, "checksum_algorithm", checksum_algorithm)
+        if content and not isinstance(content, str):
+            raise TypeError("Expected argument 'content' to be a str")
+        pulumi.set(__self__, "content", content)
+        if created_at and not isinstance(created_at, str):
+            raise TypeError("Expected argument 'created_at' to be a str")
+        pulumi.set(__self__, "created_at", created_at)
+        if expires_at and not isinstance(expires_at, str):
+            raise TypeError("Expected argument 'expires_at' to be a str")
+        pulumi.set(__self__, "expires_at", expires_at)
+        if id and not isinstance(id, str):
+            raise TypeError("Expected argument 'id' to be a str")
+        pulumi.set(__self__, "id", id)
+        if metadata and not isinstance(metadata, dict):
+            raise TypeError("Expected argument 'metadata' to be a dict")
+        pulumi.set(__self__, "metadata", metadata)
+        if name and not isinstance(name, str):
+            raise TypeError("Expected argument 'name' to be a str")
+        pulumi.set(__self__, "name", name)
+        if project and not isinstance(project, str):
+            raise TypeError("Expected argument 'project' to be a str")
+        pulumi.set(__self__, "project", project)
+        if secure_file_id and not isinstance(secure_file_id, int):
+            raise TypeError("Expected argument 'secure_file_id' to be a int")
+        pulumi.set(__self__, "secure_file_id", secure_file_id)
+
+    @_builtins.property
+    @pulumi.getter
+    def checksum(self) -> _builtins.str:
+        """
+        The checksum of the file
+        """
+        return pulumi.get(self, "checksum")
+
+    @_builtins.property
+    @pulumi.getter(name="checksumAlgorithm")
+    def checksum_algorithm(self) -> _builtins.str:
+        """
+        The checksum algorithm used
+        """
+        return pulumi.get(self, "checksum_algorithm")
+
+    @_builtins.property
+    @pulumi.getter
+    def content(self) -> _builtins.str:
+        """
+        The contents of the secure file
+        """
+        return pulumi.get(self, "content")
+
+    @_builtins.property
+    @pulumi.getter(name="createdAt")
+    def created_at(self) -> _builtins.str:
+        """
+        The time the secure file was uploaded
+        """
+        return pulumi.get(self, "created_at")
+
+    @_builtins.property
+    @pulumi.getter(name="expiresAt")
+    def expires_at(self) -> _builtins.str:
+        """
+        The time the secure file will expire
+        """
+        return pulumi.get(self, "expires_at")
+
+    @_builtins.property
+    @pulumi.getter
+    def id(self) -> _builtins.str:
+        """
+        The ID of this data source. In the format `<project:id>`
+        """
+        return pulumi.get(self, "id")
+
+    @_builtins.property
+    @pulumi.getter
+    def metadata(self) -> 'outputs.GetProjectSecureFileMetadataResult':
+        """
+        metadata returned by the gitlab api about the secure file
+        """
+        return pulumi.get(self, "metadata")
+
+    @_builtins.property
+    @pulumi.getter
+    def name(self) -> Optional[_builtins.str]:
+        """
+        The name for the secure file, unique per project
+        """
+        return pulumi.get(self, "name")
+
+    @_builtins.property
+    @pulumi.getter
+    def project(self) -> _builtins.str:
+        """
+        The ID or full path of the project the secure file resides.
+        """
+        return pulumi.get(self, "project")
+
+    @_builtins.property
+    @pulumi.getter(name="secureFileId")
+    def secure_file_id(self) -> _builtins.int:
+        """
+        The id of the secure file in gitlab
+        """
+        return pulumi.get(self, "secure_file_id")
+
+
+class AwaitableGetProjectSecureFileResult(GetProjectSecureFileResult):
+    # pylint: disable=using-constant-test
+    def __await__(self):
+        if False:
+            yield self
+        return GetProjectSecureFileResult(
+            checksum=self.checksum,
+            checksum_algorithm=self.checksum_algorithm,
+            content=self.content,
+            created_at=self.created_at,
+            expires_at=self.expires_at,
+            id=self.id,
+            metadata=self.metadata,
+            name=self.name,
+            project=self.project,
+            secure_file_id=self.secure_file_id)
+
+
+def get_project_secure_file(name: Optional[_builtins.str] = None,
+                            project: Optional[_builtins.str] = None,
+                            secure_file_id: Optional[_builtins.int] = None,
+                            opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetProjectSecureFileResult:
+    """
+    The `ProjectSecureFile` data source allows the contents of a secure file to be retrieved by either Name or ID.
+
+    **Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/secure_files/)
+
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_gitlab as gitlab
+
+    by_id = gitlab.get_project_secure_file(project="123",
+        secure_file_id=123)
+    by_name = gitlab.get_project_secure_file(project="123",
+        name="secret.pem")
+    ```
+
+
+    :param _builtins.str name: The name for the secure file, unique per project
+    :param _builtins.str project: The ID or full path of the project the secure file resides.
+    :param _builtins.int secure_file_id: The id of the secure file in gitlab
+    """
+    __args__ = dict()
+    __args__['name'] = name
+    __args__['project'] = project
+    __args__['secureFileId'] = secure_file_id
+    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke('gitlab:index/getProjectSecureFile:getProjectSecureFile', __args__, opts=opts, typ=GetProjectSecureFileResult).value
+
+    return AwaitableGetProjectSecureFileResult(
+        checksum=pulumi.get(__ret__, 'checksum'),
+        checksum_algorithm=pulumi.get(__ret__, 'checksum_algorithm'),
+        content=pulumi.get(__ret__, 'content'),
+        created_at=pulumi.get(__ret__, 'created_at'),
+        expires_at=pulumi.get(__ret__, 'expires_at'),
+        id=pulumi.get(__ret__, 'id'),
+        metadata=pulumi.get(__ret__, 'metadata'),
+        name=pulumi.get(__ret__, 'name'),
+        project=pulumi.get(__ret__, 'project'),
+        secure_file_id=pulumi.get(__ret__, 'secure_file_id'))
+def get_project_secure_file_output(name: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
+                                   project: Optional[pulumi.Input[_builtins.str]] = None,
+                                   secure_file_id: Optional[pulumi.Input[Optional[_builtins.int]]] = None,
+                                   opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetProjectSecureFileResult]:
+    """
+    The `ProjectSecureFile` data source allows the contents of a secure file to be retrieved by either Name or ID.
+
+    **Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/secure_files/)
+
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_gitlab as gitlab
+
+    by_id = gitlab.get_project_secure_file(project="123",
+        secure_file_id=123)
+    by_name = gitlab.get_project_secure_file(project="123",
+        name="secret.pem")
+    ```
+
+
+    :param _builtins.str name: The name for the secure file, unique per project
+    :param _builtins.str project: The ID or full path of the project the secure file resides.
+    :param _builtins.int secure_file_id: The id of the secure file in gitlab
+    """
+    __args__ = dict()
+    __args__['name'] = name
+    __args__['project'] = project
+    __args__['secureFileId'] = secure_file_id
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('gitlab:index/getProjectSecureFile:getProjectSecureFile', __args__, opts=opts, typ=GetProjectSecureFileResult)
+    return __ret__.apply(lambda __response__: GetProjectSecureFileResult(
+        checksum=pulumi.get(__response__, 'checksum'),
+        checksum_algorithm=pulumi.get(__response__, 'checksum_algorithm'),
+        content=pulumi.get(__response__, 'content'),
+        created_at=pulumi.get(__response__, 'created_at'),
+        expires_at=pulumi.get(__response__, 'expires_at'),
+        id=pulumi.get(__response__, 'id'),
+        metadata=pulumi.get(__response__, 'metadata'),
+        name=pulumi.get(__response__, 'name'),
+        project=pulumi.get(__response__, 'project'),
+        secure_file_id=pulumi.get(__response__, 'secure_file_id')))

pulumi_gitlab/get_project_tag.py

@@ -65,7 +65,7 @@ class GetProjectTagResult:
     @pulumi.getter
     def id(self) -> _builtins.str:
         """
-        The provider-assigned unique ID for this managed resource.
+        The ID of this datasource. In the format `<project:name>`.
         """
         return pulumi.get(self, "id")
 
@@ -97,7 +97,7 @@ class GetProjectTagResult:
     @pulumi.getter
     def protected(self) -> _builtins.bool:
         """
-        Bool, true if tag has tag protection.
+        True if tag has tag protection.
         """
         return pulumi.get(self, "protected")
 

pulumi_gitlab/get_project_tags.py

@@ -51,7 +51,7 @@ class GetProjectTagsResult:
     @pulumi.getter
     def id(self) -> _builtins.str:
         """
-        The provider-assigned unique ID for this managed resource.
+        The ID of this datasource. In the format `<project:hash-of-other-options>`.
         """
         return pulumi.get(self, "id")
 

pulumi_gitlab/get_projects.py

@@ -153,7 +153,7 @@ class GetProjectsResult:
     @pulumi.getter(name="minAccessLevel")
     def min_access_level(self) -> Optional[_builtins.int]:
         """
-        Limit to projects where current user has at least this access level, refer to the [official documentation](https://docs.gitlab.com/api/members/) for values. Cannot be used with `group_id`.
+        Limit to projects where current user has at least this access level, refer to the [official documentation](https://docs.gitlab.com/user/permissions/#default-roles) for values. Cannot be used with `group_id`.
         """
         return pulumi.get(self, "min_access_level")
 
@@ -381,7 +381,7 @@ def get_projects(archived: Optional[_builtins.bool] = None,
     :param _builtins.bool include_subgroups: Include projects in subgroups of this group. Default is `false`. Needs `group_id`.
     :param _builtins.int max_queryable_pages: The maximum number of project results pages that may be queried. Prevents overloading your Gitlab instance in case of a misconfiguration.
     :param _builtins.bool membership: Limit by projects that the current user is a member of.
-    :param _builtins.int min_access_level: Limit to projects where current user has at least this access level, refer to the [official documentation](https://docs.gitlab.com/api/members/) for values. Cannot be used with `group_id`.
+    :param _builtins.int min_access_level: Limit to projects where current user has at least this access level, refer to the [official documentation](https://docs.gitlab.com/user/permissions/#default-roles) for values. Cannot be used with `group_id`.
     :param _builtins.str order_by: Return projects ordered ordered by: `id`, `name`, `path`, `created_at`, `updated_at`, `last_activity_at`, `similarity`, `repository_size`, `storage_size`, `packages_size`, `wiki_size`. Some values or only available in certain circumstances. See [upstream docs](https://docs.gitlab.com/api/projects/#list-all-projects) for details.
     :param _builtins.bool owned: Limit by projects owned by the current user.
     :param _builtins.int page: The first page to begin the query on.
@@ -505,7 +505,7 @@ def get_projects_output(archived: Optional[pulumi.Input[Optional[_builtins.bool]
     :param _builtins.bool include_subgroups: Include projects in subgroups of this group. Default is `false`. Needs `group_id`.
     :param _builtins.int max_queryable_pages: The maximum number of project results pages that may be queried. Prevents overloading your Gitlab instance in case of a misconfiguration.
     :param _builtins.bool membership: Limit by projects that the current user is a member of.
-    :param _builtins.int min_access_level: Limit to projects where current user has at least this access level, refer to the [official documentation](https://docs.gitlab.com/api/members/) for values. Cannot be used with `group_id`.
+    :param _builtins.int min_access_level: Limit to projects where current user has at least this access level, refer to the [official documentation](https://docs.gitlab.com/user/permissions/#default-roles) for values. Cannot be used with `group_id`.
     :param _builtins.str order_by: Return projects ordered ordered by: `id`, `name`, `path`, `created_at`, `updated_at`, `last_activity_at`, `similarity`, `repository_size`, `storage_size`, `packages_size`, `wiki_size`. Some values or only available in certain circumstances. See [upstream docs](https://docs.gitlab.com/api/projects/#list-all-projects) for details.
     :param _builtins.bool owned: Limit by projects owned by the current user.
     :param _builtins.int page: The first page to begin the query on.

pulumi_gitlab/get_release_link.py

@@ -62,7 +62,7 @@ class GetReleaseLinkResult:
     @pulumi.getter(name="directAssetUrl")
     def direct_asset_url(self) -> _builtins.str:
         """
-        Full path for a [Direct Asset link](https://docs.gitlab.com/user/project/releases/index/#permanent-links-to-release-assets).
+        Full path for a [Direct Asset link](https://docs.gitlab.com/user/project/releases/release_fields/#permanent-links-to-latest-release-assets).
         """
         return pulumi.get(self, "direct_asset_url")
 
@@ -78,7 +78,7 @@ class GetReleaseLinkResult:
     @pulumi.getter
     def filepath(self) -> _builtins.str:
         """
-        Relative path for a [Direct Asset link](https://docs.gitlab.com/user/project/releases/index/#permanent-links-to-release-assets).
+        Relative path for a [Direct Asset link](https://docs.gitlab.com/user/project/releases/release_fields/#permanent-links-to-latest-release-assets).
         """
         return pulumi.get(self, "filepath")
 
@@ -118,7 +118,7 @@ class GetReleaseLinkResult:
     @pulumi.getter
     def project(self) -> _builtins.str:
         """
-        The ID or [URL-encoded path of the project](https://docs.gitlab.com/api/index/#namespaced-path-encoding).
+        The ID or Namespace path of the project.
         """
         return pulumi.get(self, "project")
 
@@ -168,7 +168,7 @@ def get_release_link(link_id: Optional[_builtins.int] = None,
 
 
     :param _builtins.int link_id: The ID of the link.
-    :param _builtins.str project: The ID or [URL-encoded path of the project](https://docs.gitlab.com/api/index/#namespaced-path-encoding).
+    :param _builtins.str project: The ID or Namespace path of the project.
     :param _builtins.str tag_name: The tag associated with the Release.
     """
     __args__ = dict()
@@ -200,7 +200,7 @@ def get_release_link_output(link_id: Optional[pulumi.Input[_builtins.int]] = Non
 
 
     :param _builtins.int link_id: The ID of the link.
-    :param _builtins.str project: The ID or [URL-encoded path of the project](https://docs.gitlab.com/api/index/#namespaced-path-encoding).
+    :param _builtins.str project: The ID or Namespace path of the project.
     :param _builtins.str tag_name: The tag associated with the Release.
     """
     __args__ = dict()

pulumi_gitlab/get_release_links.py

@@ -53,7 +53,7 @@ class GetReleaseLinksResult:
     @pulumi.getter
     def project(self) -> _builtins.str:
         """
-        The ID or [URL-encoded path of the project](https://docs.gitlab.com/api/index/#namespaced-path-encoding).
+        The ID or Namespace path of the project.
         """
         return pulumi.get(self, "project")
 
@@ -95,7 +95,7 @@ def get_release_links(project: Optional[_builtins.str] = None,
     **Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/releases/links/)
 
 
-    :param _builtins.str project: The ID or [URL-encoded path of the project](https://docs.gitlab.com/api/index/#namespaced-path-encoding).
+    :param _builtins.str project: The ID or Namespace path of the project.
     :param _builtins.str tag_name: The tag associated with the Release.
     """
     __args__ = dict()
@@ -118,7 +118,7 @@ def get_release_links_output(project: Optional[pulumi.Input[_builtins.str]] = No
     **Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/releases/links/)
 
 
-    :param _builtins.str project: The ID or [URL-encoded path of the project](https://docs.gitlab.com/api/index/#namespaced-path-encoding).
+    :param _builtins.str project: The ID or Namespace path of the project.
     :param _builtins.str tag_name: The tag associated with the Release.
     """
     __args__ = dict()

pulumi_gitlab/get_security_policy_document.py

@@ -0,0 +1,170 @@
+# coding=utf-8
+# *** WARNING: this file was generated by pulumi-language-python. ***
+# *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+import builtins as _builtins
+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
+from . import outputs
+from ._inputs import *
+
+__all__ = [
+    'GetSecurityPolicyDocumentResult',
+    'AwaitableGetSecurityPolicyDocumentResult',
+    'get_security_policy_document',
+    'get_security_policy_document_output',
+]
+
+@pulumi.output_type
+class GetSecurityPolicyDocumentResult:
+    """
+    A collection of values returned by getSecurityPolicyDocument.
+    """
+    def __init__(__self__, id=None, scan_execution_policies=None, yaml=None):
+        if id and not isinstance(id, str):
+            raise TypeError("Expected argument 'id' to be a str")
+        pulumi.set(__self__, "id", id)
+        if scan_execution_policies and not isinstance(scan_execution_policies, list):
+            raise TypeError("Expected argument 'scan_execution_policies' to be a list")
+        pulumi.set(__self__, "scan_execution_policies", scan_execution_policies)
+        if yaml and not isinstance(yaml, str):
+            raise TypeError("Expected argument 'yaml' to be a str")
+        pulumi.set(__self__, "yaml", yaml)
+
+    @_builtins.property
+    @pulumi.getter
+    def id(self) -> _builtins.str:
+        """
+        Unique identifier for this policy document (hash of generated YAML).
+        """
+        return pulumi.get(self, "id")
+
+    @_builtins.property
+    @pulumi.getter(name="scanExecutionPolicies")
+    def scan_execution_policies(self) -> Optional[Sequence['outputs.GetSecurityPolicyDocumentScanExecutionPolicyResult']]:
+        """
+        Scan execution policy configuration. Multiple policies can be specified.
+        """
+        return pulumi.get(self, "scan_execution_policies")
+
+    @_builtins.property
+    @pulumi.getter
+    def yaml(self) -> _builtins.str:
+        """
+        The generated policy document in YAML format, ready to write to `.gitlab/security-policies/policy.yml`.
+        """
+        return pulumi.get(self, "yaml")
+
+
+class AwaitableGetSecurityPolicyDocumentResult(GetSecurityPolicyDocumentResult):
+    # pylint: disable=using-constant-test
+    def __await__(self):
+        if False:
+            yield self
+        return GetSecurityPolicyDocumentResult(
+            id=self.id,
+            scan_execution_policies=self.scan_execution_policies,
+            yaml=self.yaml)
+
+
+def get_security_policy_document(scan_execution_policies: Optional[Sequence[Union['GetSecurityPolicyDocumentScanExecutionPolicyArgs', 'GetSecurityPolicyDocumentScanExecutionPolicyArgsDict']]] = None,
+                                 opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetSecurityPolicyDocumentResult:
+    """
+    Generates a GitLab security policy YAML document from structured configuration.
+    This data source performs pure transformation without any API calls.
+
+    **Upstream API**: [GitLab Security Policies Documentation](https://docs.gitlab.com/ee/user/application_security/policies/scan_execution_policies/)
+
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_gitlab as gitlab
+
+    # Use this with `gitlab_repository_file` to manage your policies using native HCL
+    scan = gitlab.get_security_policy_document(scan_execution_policies=[{
+        "name": "Basic SAST Policy",
+        "enabled": True,
+        "rules": [{
+            "type": "pipeline",
+            "branch_type": "all",
+        }],
+        "actions": [{
+            "scan": "sast",
+        }],
+    }])
+    # See `gitlab_project_security_policy_attachment` or `gitlab_group_security_policy_attachment`
+    # for how to link a security policy project to a project or group.
+    policy = gitlab.RepositoryFile("policy",
+        project="1234",
+        ref="main",
+        file_path=".gitlab/security-policies/policy.yml",
+        content=scan.yaml)
+    ```
+
+
+    :param Sequence[Union['GetSecurityPolicyDocumentScanExecutionPolicyArgs', 'GetSecurityPolicyDocumentScanExecutionPolicyArgsDict']] scan_execution_policies: Scan execution policy configuration. Multiple policies can be specified.
+    """
+    __args__ = dict()
+    __args__['scanExecutionPolicies'] = scan_execution_policies
+    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke('gitlab:index/getSecurityPolicyDocument:getSecurityPolicyDocument', __args__, opts=opts, typ=GetSecurityPolicyDocumentResult).value
+
+    return AwaitableGetSecurityPolicyDocumentResult(
+        id=pulumi.get(__ret__, 'id'),
+        scan_execution_policies=pulumi.get(__ret__, 'scan_execution_policies'),
+        yaml=pulumi.get(__ret__, 'yaml'))
+def get_security_policy_document_output(scan_execution_policies: Optional[pulumi.Input[Optional[Sequence[Union['GetSecurityPolicyDocumentScanExecutionPolicyArgs', 'GetSecurityPolicyDocumentScanExecutionPolicyArgsDict']]]]] = None,
+                                        opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetSecurityPolicyDocumentResult]:
+    """
+    Generates a GitLab security policy YAML document from structured configuration.
+    This data source performs pure transformation without any API calls.
+
+    **Upstream API**: [GitLab Security Policies Documentation](https://docs.gitlab.com/ee/user/application_security/policies/scan_execution_policies/)
+
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_gitlab as gitlab
+
+    # Use this with `gitlab_repository_file` to manage your policies using native HCL
+    scan = gitlab.get_security_policy_document(scan_execution_policies=[{
+        "name": "Basic SAST Policy",
+        "enabled": True,
+        "rules": [{
+            "type": "pipeline",
+            "branch_type": "all",
+        }],
+        "actions": [{
+            "scan": "sast",
+        }],
+    }])
+    # See `gitlab_project_security_policy_attachment` or `gitlab_group_security_policy_attachment`
+    # for how to link a security policy project to a project or group.
+    policy = gitlab.RepositoryFile("policy",
+        project="1234",
+        ref="main",
+        file_path=".gitlab/security-policies/policy.yml",
+        content=scan.yaml)
+    ```
+
+
+    :param Sequence[Union['GetSecurityPolicyDocumentScanExecutionPolicyArgs', 'GetSecurityPolicyDocumentScanExecutionPolicyArgsDict']] scan_execution_policies: Scan execution policy configuration. Multiple policies can be specified.
+    """
+    __args__ = dict()
+    __args__['scanExecutionPolicies'] = scan_execution_policies
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('gitlab:index/getSecurityPolicyDocument:getSecurityPolicyDocument', __args__, opts=opts, typ=GetSecurityPolicyDocumentResult)
+    return __ret__.apply(lambda __response__: GetSecurityPolicyDocumentResult(
+        id=pulumi.get(__response__, 'id'),
+        scan_execution_policies=pulumi.get(__response__, 'scan_execution_policies'),
+        yaml=pulumi.get(__response__, 'yaml')))

pulumi_gitlab/get_user.py

@@ -424,6 +424,22 @@ def get_user(email: Optional[_builtins.str] = None,
 
     **Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/users/#get-a-single-user)
 
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_gitlab as gitlab
+    import pulumi_std as std
+
+    example = gitlab.get_user(username="myuser")
+    # Example using `for_each`
+    example_two = {__key: gitlab.get_user(username=__value) for __key, __value in std.toset(input=[
+        "user1",
+        "user2",
+        "user3",
+    ]).result}
+    ```
+
 
     :param _builtins.str email: The public email address of the user.
     :param _builtins.bool email_exact_match: (Experimental) If true, returns only an exact match. Otherwise, fuzzy matching might return the closest result. If no exact match is available, the data source returns an error.
@@ -487,6 +503,22 @@ def get_user_output(email: Optional[pulumi.Input[Optional[_builtins.str]]] = Non
 
     **Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/users/#get-a-single-user)
 
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_gitlab as gitlab
+    import pulumi_std as std
+
+    example = gitlab.get_user(username="myuser")
+    # Example using `for_each`
+    example_two = {__key: gitlab.get_user(username=__value) for __key, __value in std.toset(input=[
+        "user1",
+        "user2",
+        "user3",
+    ]).result}
+    ```
+
 
     :param _builtins.str email: The public email address of the user.
     :param _builtins.bool email_exact_match: (Experimental) If true, returns only an exact match. Otherwise, fuzzy matching might return the closest result. If no exact match is available, the data source returns an error.

pulumi_gitlab/global_level_notifications.py

@@ -636,7 +636,7 @@ class GlobalLevelNotifications(pulumi.CustomResource):
         """
         The `GlobalLevelNotifications` resource allows to manage global notifications.
 
-        **Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/notification_settings/#group--project-level-notification-settings)
+        **Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/notification_settings/#get-group-or-project-notification-settings)
 
         ## Import
 
@@ -694,7 +694,7 @@ class GlobalLevelNotifications(pulumi.CustomResource):
         """
         The `GlobalLevelNotifications` resource allows to manage global notifications.
 
-        **Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/notification_settings/#group--project-level-notification-settings)
+        **Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/notification_settings/#get-group-or-project-notification-settings)
 
         ## Import