pulumi-github 6.11.0a1768455780__py3-none-any.whl → 6.11.0a1768966924__py3-none-any.whl

pulumi_github/actions_organization_workflow_permissions.py

@@ -0,0 +1,320 @@
+# 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
+
+__all__ = ['ActionsOrganizationWorkflowPermissionsArgs', 'ActionsOrganizationWorkflowPermissions']
+
+@pulumi.input_type
+class ActionsOrganizationWorkflowPermissionsArgs:
+    def __init__(__self__, *,
+                 organization_slug: pulumi.Input[_builtins.str],
+                 can_approve_pull_request_reviews: Optional[pulumi.Input[_builtins.bool]] = None,
+                 default_workflow_permissions: Optional[pulumi.Input[_builtins.str]] = None):
+        """
+        The set of arguments for constructing a ActionsOrganizationWorkflowPermissions resource.
+        :param pulumi.Input[_builtins.str] organization_slug: The slug of the organization.
+        :param pulumi.Input[_builtins.bool] can_approve_pull_request_reviews: Whether GitHub Actions can approve pull request reviews. Defaults to `false`.
+        :param pulumi.Input[_builtins.str] default_workflow_permissions: The default workflow permissions granted to the GITHUB_TOKEN when running workflows. Can be `read` or `write`. Defaults to `read`.
+        """
+        pulumi.set(__self__, "organization_slug", organization_slug)
+        if can_approve_pull_request_reviews is not None:
+            pulumi.set(__self__, "can_approve_pull_request_reviews", can_approve_pull_request_reviews)
+        if default_workflow_permissions is not None:
+            pulumi.set(__self__, "default_workflow_permissions", default_workflow_permissions)
+
+    @_builtins.property
+    @pulumi.getter(name="organizationSlug")
+    def organization_slug(self) -> pulumi.Input[_builtins.str]:
+        """
+        The slug of the organization.
+        """
+        return pulumi.get(self, "organization_slug")
+
+    @organization_slug.setter
+    def organization_slug(self, value: pulumi.Input[_builtins.str]):
+        pulumi.set(self, "organization_slug", value)
+
+    @_builtins.property
+    @pulumi.getter(name="canApprovePullRequestReviews")
+    def can_approve_pull_request_reviews(self) -> Optional[pulumi.Input[_builtins.bool]]:
+        """
+        Whether GitHub Actions can approve pull request reviews. Defaults to `false`.
+        """
+        return pulumi.get(self, "can_approve_pull_request_reviews")
+
+    @can_approve_pull_request_reviews.setter
+    def can_approve_pull_request_reviews(self, value: Optional[pulumi.Input[_builtins.bool]]):
+        pulumi.set(self, "can_approve_pull_request_reviews", value)
+
+    @_builtins.property
+    @pulumi.getter(name="defaultWorkflowPermissions")
+    def default_workflow_permissions(self) -> Optional[pulumi.Input[_builtins.str]]:
+        """
+        The default workflow permissions granted to the GITHUB_TOKEN when running workflows. Can be `read` or `write`. Defaults to `read`.
+        """
+        return pulumi.get(self, "default_workflow_permissions")
+
+    @default_workflow_permissions.setter
+    def default_workflow_permissions(self, value: Optional[pulumi.Input[_builtins.str]]):
+        pulumi.set(self, "default_workflow_permissions", value)
+
+
+@pulumi.input_type
+class _ActionsOrganizationWorkflowPermissionsState:
+    def __init__(__self__, *,
+                 can_approve_pull_request_reviews: Optional[pulumi.Input[_builtins.bool]] = None,
+                 default_workflow_permissions: Optional[pulumi.Input[_builtins.str]] = None,
+                 organization_slug: Optional[pulumi.Input[_builtins.str]] = None):
+        """
+        Input properties used for looking up and filtering ActionsOrganizationWorkflowPermissions resources.
+        :param pulumi.Input[_builtins.bool] can_approve_pull_request_reviews: Whether GitHub Actions can approve pull request reviews. Defaults to `false`.
+        :param pulumi.Input[_builtins.str] default_workflow_permissions: The default workflow permissions granted to the GITHUB_TOKEN when running workflows. Can be `read` or `write`. Defaults to `read`.
+        :param pulumi.Input[_builtins.str] organization_slug: The slug of the organization.
+        """
+        if can_approve_pull_request_reviews is not None:
+            pulumi.set(__self__, "can_approve_pull_request_reviews", can_approve_pull_request_reviews)
+        if default_workflow_permissions is not None:
+            pulumi.set(__self__, "default_workflow_permissions", default_workflow_permissions)
+        if organization_slug is not None:
+            pulumi.set(__self__, "organization_slug", organization_slug)
+
+    @_builtins.property
+    @pulumi.getter(name="canApprovePullRequestReviews")
+    def can_approve_pull_request_reviews(self) -> Optional[pulumi.Input[_builtins.bool]]:
+        """
+        Whether GitHub Actions can approve pull request reviews. Defaults to `false`.
+        """
+        return pulumi.get(self, "can_approve_pull_request_reviews")
+
+    @can_approve_pull_request_reviews.setter
+    def can_approve_pull_request_reviews(self, value: Optional[pulumi.Input[_builtins.bool]]):
+        pulumi.set(self, "can_approve_pull_request_reviews", value)
+
+    @_builtins.property
+    @pulumi.getter(name="defaultWorkflowPermissions")
+    def default_workflow_permissions(self) -> Optional[pulumi.Input[_builtins.str]]:
+        """
+        The default workflow permissions granted to the GITHUB_TOKEN when running workflows. Can be `read` or `write`. Defaults to `read`.
+        """
+        return pulumi.get(self, "default_workflow_permissions")
+
+    @default_workflow_permissions.setter
+    def default_workflow_permissions(self, value: Optional[pulumi.Input[_builtins.str]]):
+        pulumi.set(self, "default_workflow_permissions", value)
+
+    @_builtins.property
+    @pulumi.getter(name="organizationSlug")
+    def organization_slug(self) -> Optional[pulumi.Input[_builtins.str]]:
+        """
+        The slug of the organization.
+        """
+        return pulumi.get(self, "organization_slug")
+
+    @organization_slug.setter
+    def organization_slug(self, value: Optional[pulumi.Input[_builtins.str]]):
+        pulumi.set(self, "organization_slug", value)
+
+
+@pulumi.type_token("github:index/actionsOrganizationWorkflowPermissions:ActionsOrganizationWorkflowPermissions")
+class ActionsOrganizationWorkflowPermissions(pulumi.CustomResource):
+    @overload
+    def __init__(__self__,
+                 resource_name: str,
+                 opts: Optional[pulumi.ResourceOptions] = None,
+                 can_approve_pull_request_reviews: Optional[pulumi.Input[_builtins.bool]] = None,
+                 default_workflow_permissions: Optional[pulumi.Input[_builtins.str]] = None,
+                 organization_slug: Optional[pulumi.Input[_builtins.str]] = None,
+                 __props__=None):
+        """
+        This resource allows you to manage GitHub Actions workflow permissions for a GitHub Organization account. This controls the default permissions granted to the GITHUB_TOKEN when running workflows and whether GitHub Actions can approve pull request reviews.
+
+        You must have organization admin access to use this resource.
+
+        ## Example Usage
+
+        ```python
+        import pulumi
+        import pulumi_github as github
+
+        # Basic workflow permissions configuration
+        example = github.ActionsOrganizationWorkflowPermissions("example",
+            organization_slug="my-organization",
+            default_workflow_permissions="read",
+            can_approve_pull_request_reviews=False)
+        # Allow write permissions and PR approvals
+        permissive = github.ActionsOrganizationWorkflowPermissions("permissive",
+            organization_slug="my-organization",
+            default_workflow_permissions="write",
+            can_approve_pull_request_reviews=True)
+        ```
+
+        ## Notes
+
+        > **Note:** This resource requires a GitHub Organization account and organization admin permissions.
+
+        When this resource is destroyed, the workflow permissions will be reset to safe defaults:
+
+        * `default_workflow_permissions` = `read`
+        * `can_approve_pull_request_reviews` = `false`
+
+        ## Import
+
+        Organization Actions workflow permissions can be imported using the organization slug:
+
+        ```sh
+        $ pulumi import github:index/actionsOrganizationWorkflowPermissions:ActionsOrganizationWorkflowPermissions example my-organization
+        ```
+
+        :param str resource_name: The name of the resource.
+        :param pulumi.ResourceOptions opts: Options for the resource.
+        :param pulumi.Input[_builtins.bool] can_approve_pull_request_reviews: Whether GitHub Actions can approve pull request reviews. Defaults to `false`.
+        :param pulumi.Input[_builtins.str] default_workflow_permissions: The default workflow permissions granted to the GITHUB_TOKEN when running workflows. Can be `read` or `write`. Defaults to `read`.
+        :param pulumi.Input[_builtins.str] organization_slug: The slug of the organization.
+        """
+        ...
+    @overload
+    def __init__(__self__,
+                 resource_name: str,
+                 args: ActionsOrganizationWorkflowPermissionsArgs,
+                 opts: Optional[pulumi.ResourceOptions] = None):
+        """
+        This resource allows you to manage GitHub Actions workflow permissions for a GitHub Organization account. This controls the default permissions granted to the GITHUB_TOKEN when running workflows and whether GitHub Actions can approve pull request reviews.
+
+        You must have organization admin access to use this resource.
+
+        ## Example Usage
+
+        ```python
+        import pulumi
+        import pulumi_github as github
+
+        # Basic workflow permissions configuration
+        example = github.ActionsOrganizationWorkflowPermissions("example",
+            organization_slug="my-organization",
+            default_workflow_permissions="read",
+            can_approve_pull_request_reviews=False)
+        # Allow write permissions and PR approvals
+        permissive = github.ActionsOrganizationWorkflowPermissions("permissive",
+            organization_slug="my-organization",
+            default_workflow_permissions="write",
+            can_approve_pull_request_reviews=True)
+        ```
+
+        ## Notes
+
+        > **Note:** This resource requires a GitHub Organization account and organization admin permissions.
+
+        When this resource is destroyed, the workflow permissions will be reset to safe defaults:
+
+        * `default_workflow_permissions` = `read`
+        * `can_approve_pull_request_reviews` = `false`
+
+        ## Import
+
+        Organization Actions workflow permissions can be imported using the organization slug:
+
+        ```sh
+        $ pulumi import github:index/actionsOrganizationWorkflowPermissions:ActionsOrganizationWorkflowPermissions example my-organization
+        ```
+
+        :param str resource_name: The name of the resource.
+        :param ActionsOrganizationWorkflowPermissionsArgs args: The arguments to use to populate this resource's properties.
+        :param pulumi.ResourceOptions opts: Options for the resource.
+        """
+        ...
+    def __init__(__self__, resource_name: str, *args, **kwargs):
+        resource_args, opts = _utilities.get_resource_args_opts(ActionsOrganizationWorkflowPermissionsArgs, pulumi.ResourceOptions, *args, **kwargs)
+        if resource_args is not None:
+            __self__._internal_init(resource_name, opts, **resource_args.__dict__)
+        else:
+            __self__._internal_init(resource_name, *args, **kwargs)
+
+    def _internal_init(__self__,
+                 resource_name: str,
+                 opts: Optional[pulumi.ResourceOptions] = None,
+                 can_approve_pull_request_reviews: Optional[pulumi.Input[_builtins.bool]] = None,
+                 default_workflow_permissions: Optional[pulumi.Input[_builtins.str]] = None,
+                 organization_slug: Optional[pulumi.Input[_builtins.str]] = None,
+                 __props__=None):
+        opts = pulumi.ResourceOptions.merge(_utilities.get_resource_opts_defaults(), opts)
+        if not isinstance(opts, pulumi.ResourceOptions):
+            raise TypeError('Expected resource options to be a ResourceOptions instance')
+        if opts.id is None:
+            if __props__ is not None:
+                raise TypeError('__props__ is only valid when passed in combination with a valid opts.id to get an existing resource')
+            __props__ = ActionsOrganizationWorkflowPermissionsArgs.__new__(ActionsOrganizationWorkflowPermissionsArgs)
+
+            __props__.__dict__["can_approve_pull_request_reviews"] = can_approve_pull_request_reviews
+            __props__.__dict__["default_workflow_permissions"] = default_workflow_permissions
+            if organization_slug is None and not opts.urn:
+                raise TypeError("Missing required property 'organization_slug'")
+            __props__.__dict__["organization_slug"] = organization_slug
+        super(ActionsOrganizationWorkflowPermissions, __self__).__init__(
+            'github:index/actionsOrganizationWorkflowPermissions:ActionsOrganizationWorkflowPermissions',
+            resource_name,
+            __props__,
+            opts)
+
+    @staticmethod
+    def get(resource_name: str,
+            id: pulumi.Input[str],
+            opts: Optional[pulumi.ResourceOptions] = None,
+            can_approve_pull_request_reviews: Optional[pulumi.Input[_builtins.bool]] = None,
+            default_workflow_permissions: Optional[pulumi.Input[_builtins.str]] = None,
+            organization_slug: Optional[pulumi.Input[_builtins.str]] = None) -> 'ActionsOrganizationWorkflowPermissions':
+        """
+        Get an existing ActionsOrganizationWorkflowPermissions resource's state with the given name, id, and optional extra
+        properties used to qualify the lookup.
+
+        :param str resource_name: The unique name of the resulting resource.
+        :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
+        :param pulumi.ResourceOptions opts: Options for the resource.
+        :param pulumi.Input[_builtins.bool] can_approve_pull_request_reviews: Whether GitHub Actions can approve pull request reviews. Defaults to `false`.
+        :param pulumi.Input[_builtins.str] default_workflow_permissions: The default workflow permissions granted to the GITHUB_TOKEN when running workflows. Can be `read` or `write`. Defaults to `read`.
+        :param pulumi.Input[_builtins.str] organization_slug: The slug of the organization.
+        """
+        opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
+
+        __props__ = _ActionsOrganizationWorkflowPermissionsState.__new__(_ActionsOrganizationWorkflowPermissionsState)
+
+        __props__.__dict__["can_approve_pull_request_reviews"] = can_approve_pull_request_reviews
+        __props__.__dict__["default_workflow_permissions"] = default_workflow_permissions
+        __props__.__dict__["organization_slug"] = organization_slug
+        return ActionsOrganizationWorkflowPermissions(resource_name, opts=opts, __props__=__props__)
+
+    @_builtins.property
+    @pulumi.getter(name="canApprovePullRequestReviews")
+    def can_approve_pull_request_reviews(self) -> pulumi.Output[Optional[_builtins.bool]]:
+        """
+        Whether GitHub Actions can approve pull request reviews. Defaults to `false`.
+        """
+        return pulumi.get(self, "can_approve_pull_request_reviews")
+
+    @_builtins.property
+    @pulumi.getter(name="defaultWorkflowPermissions")
+    def default_workflow_permissions(self) -> pulumi.Output[Optional[_builtins.str]]:
+        """
+        The default workflow permissions granted to the GITHUB_TOKEN when running workflows. Can be `read` or `write`. Defaults to `read`.
+        """
+        return pulumi.get(self, "default_workflow_permissions")
+
+    @_builtins.property
+    @pulumi.getter(name="organizationSlug")
+    def organization_slug(self) -> pulumi.Output[_builtins.str]:
+        """
+        The slug of the organization.
+        """
+        return pulumi.get(self, "organization_slug")
+

pulumi_github/emu_group_mapping.py

@@ -116,8 +116,6 @@ class EmuGroupMapping(pulumi.CustomResource):
                  team_slug: Optional[pulumi.Input[_builtins.str]] = None,
                  __props__=None):
         """
-        This resource manages mappings between external groups for enterprise managed users and GitHub teams. It wraps the API detailed [here](https://docs.github.com/en/rest/reference/teams#external-groups). Note that this is a distinct resource from `TeamSyncGroupMapping`. `EmuGroupMapping` is special to the Enterprise Managed User (EMU) external group feature, whereas `TeamSyncGroupMapping` is specific to Identity Provider Groups.
-
         ## Example Usage
 
         ```python
@@ -131,10 +129,10 @@ class EmuGroupMapping(pulumi.CustomResource):
 
         ## Import
 
-        GitHub EMU External Group Mappings can be imported using the external `group_id`, e.g.
+        GitHub EMU External Group Mappings can be imported using the external `group_id` and `team_slug` separated by a colon, e.g.
 
         ```sh
-        $ pulumi import github:index/emuGroupMapping:EmuGroupMapping example_emu_group_mapping 28836
+        $ pulumi import github:index/emuGroupMapping:EmuGroupMapping example_emu_group_mapping 28836:emu-test-team
         ```
 
         :param str resource_name: The name of the resource.
@@ -149,8 +147,6 @@ class EmuGroupMapping(pulumi.CustomResource):
                  args: EmuGroupMappingArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        This resource manages mappings between external groups for enterprise managed users and GitHub teams. It wraps the API detailed [here](https://docs.github.com/en/rest/reference/teams#external-groups). Note that this is a distinct resource from `TeamSyncGroupMapping`. `EmuGroupMapping` is special to the Enterprise Managed User (EMU) external group feature, whereas `TeamSyncGroupMapping` is specific to Identity Provider Groups.
-
         ## Example Usage
 
         ```python
@@ -164,10 +160,10 @@ class EmuGroupMapping(pulumi.CustomResource):
 
         ## Import
 
-        GitHub EMU External Group Mappings can be imported using the external `group_id`, e.g.
+        GitHub EMU External Group Mappings can be imported using the external `group_id` and `team_slug` separated by a colon, e.g.
 
         ```sh
-        $ pulumi import github:index/emuGroupMapping:EmuGroupMapping example_emu_group_mapping 28836
+        $ pulumi import github:index/emuGroupMapping:EmuGroupMapping example_emu_group_mapping 28836:emu-test-team
         ```
 
         :param str resource_name: The name of the resource.

pulumi_github/get_ip_ranges.py

@@ -162,6 +162,7 @@ class GetIpRangesResult:
 
     @_builtins.property
     @pulumi.getter(name="dependabotIpv4s")
+    @_utilities.deprecated("""This attribute is no longer returned form the API, Dependabot now uses the GitHub Actions IP addresses.""")
     def dependabot_ipv4s(self) -> Sequence[_builtins.str]:
         """
         A subset of the `dependabot` array that contains IP addresses in IPv4 CIDR format.
@@ -170,6 +171,7 @@ class GetIpRangesResult:
 
     @_builtins.property
     @pulumi.getter(name="dependabotIpv6s")
+    @_utilities.deprecated("""This attribute is no longer returned form the API, Dependabot now uses the GitHub Actions IP addresses.""")
     def dependabot_ipv6s(self) -> Sequence[_builtins.str]:
         """
         A subset of the `dependabot` array that contains IP addresses in IPv6 CIDR format.
@@ -178,6 +180,7 @@ class GetIpRangesResult:
 
     @_builtins.property
     @pulumi.getter
+    @_utilities.deprecated("""This attribute is no longer returned form the API, Dependabot now uses the GitHub Actions IP addresses.""")
     def dependabots(self) -> Sequence[_builtins.str]:
         """
         An array of IP addresses in CIDR format specifying the A records for dependabot.

pulumi_github/get_repository.py

@@ -27,10 +27,13 @@ class GetRepositoryResult:
     """
     A collection of values returned by getRepository.
     """
-    def __init__(__self__, allow_auto_merge=None, allow_merge_commit=None, allow_rebase_merge=None, allow_squash_merge=None, allow_update_branch=None, archived=None, default_branch=None, delete_branch_on_merge=None, description=None, fork=None, full_name=None, git_clone_url=None, has_discussions=None, has_downloads=None, has_issues=None, has_projects=None, has_wiki=None, homepage_url=None, html_url=None, http_clone_url=None, id=None, is_template=None, merge_commit_message=None, merge_commit_title=None, name=None, node_id=None, pages=None, primary_language=None, private=None, repo_id=None, repository_licenses=None, squash_merge_commit_message=None, squash_merge_commit_title=None, ssh_clone_url=None, svn_url=None, templates=None, topics=None, visibility=None):
+    def __init__(__self__, allow_auto_merge=None, allow_forking=None, allow_merge_commit=None, allow_rebase_merge=None, allow_squash_merge=None, allow_update_branch=None, archived=None, default_branch=None, delete_branch_on_merge=None, description=None, fork=None, full_name=None, git_clone_url=None, has_discussions=None, has_downloads=None, has_issues=None, has_projects=None, has_wiki=None, homepage_url=None, html_url=None, http_clone_url=None, id=None, is_template=None, merge_commit_message=None, merge_commit_title=None, name=None, node_id=None, pages=None, primary_language=None, private=None, repo_id=None, repository_licenses=None, squash_merge_commit_message=None, squash_merge_commit_title=None, ssh_clone_url=None, svn_url=None, templates=None, topics=None, visibility=None):
         if allow_auto_merge and not isinstance(allow_auto_merge, bool):
             raise TypeError("Expected argument 'allow_auto_merge' to be a bool")
         pulumi.set(__self__, "allow_auto_merge", allow_auto_merge)
+        if allow_forking and not isinstance(allow_forking, bool):
+            raise TypeError("Expected argument 'allow_forking' to be a bool")
+        pulumi.set(__self__, "allow_forking", allow_forking)
         if allow_merge_commit and not isinstance(allow_merge_commit, bool):
             raise TypeError("Expected argument 'allow_merge_commit' to be a bool")
         pulumi.set(__self__, "allow_merge_commit", allow_merge_commit)
@@ -151,6 +154,14 @@ class GetRepositoryResult:
         """
         return pulumi.get(self, "allow_auto_merge")
 
+    @_builtins.property
+    @pulumi.getter(name="allowForking")
+    def allow_forking(self) -> _builtins.bool:
+        """
+        Whether the repository allows private forking; this is only relevant if the repository is owned by an organization and is private or internal.
+        """
+        return pulumi.get(self, "allow_forking")
+
     @_builtins.property
     @pulumi.getter(name="allowMergeCommit")
     def allow_merge_commit(self) -> _builtins.bool:
@@ -240,9 +251,10 @@ class GetRepositoryResult:
 
     @_builtins.property
     @pulumi.getter(name="hasDownloads")
+    @_utilities.deprecated("""This attribute is no longer in use, but it hasn't been removed yet. It will be removed in a future version. See https://github.com/orgs/community/discussions/102145#discussioncomment-8351756""")
     def has_downloads(self) -> _builtins.bool:
         """
-        Whether the repository has Downloads feature enabled.
+        (**DEPRECATED**) Whether the repository has Downloads feature enabled. This attribute is no longer in use, but it hasn't been removed yet. It will be removed in a future version. See [this discussion](https://github.com/orgs/community/discussions/102145#discussioncomment-8351756).
         """
         return pulumi.get(self, "has_downloads")
 
@@ -446,6 +458,7 @@ class AwaitableGetRepositoryResult(GetRepositoryResult):
             yield self
         return GetRepositoryResult(
             allow_auto_merge=self.allow_auto_merge,
+            allow_forking=self.allow_forking,
             allow_merge_commit=self.allow_merge_commit,
             allow_rebase_merge=self.allow_rebase_merge,
             allow_squash_merge=self.allow_squash_merge,
@@ -518,6 +531,7 @@ def get_repository(description: Optional[_builtins.str] = None,
 
     return AwaitableGetRepositoryResult(
         allow_auto_merge=pulumi.get(__ret__, 'allow_auto_merge'),
+        allow_forking=pulumi.get(__ret__, 'allow_forking'),
         allow_merge_commit=pulumi.get(__ret__, 'allow_merge_commit'),
         allow_rebase_merge=pulumi.get(__ret__, 'allow_rebase_merge'),
         allow_squash_merge=pulumi.get(__ret__, 'allow_squash_merge'),
@@ -587,6 +601,7 @@ def get_repository_output(description: Optional[pulumi.Input[Optional[_builtins.
     __ret__ = pulumi.runtime.invoke_output('github:index/getRepository:getRepository', __args__, opts=opts, typ=GetRepositoryResult)
     return __ret__.apply(lambda __response__: GetRepositoryResult(
         allow_auto_merge=pulumi.get(__response__, 'allow_auto_merge'),
+        allow_forking=pulumi.get(__response__, 'allow_forking'),
         allow_merge_commit=pulumi.get(__response__, 'allow_merge_commit'),
         allow_rebase_merge=pulumi.get(__response__, 'allow_rebase_merge'),
         allow_squash_merge=pulumi.get(__response__, 'allow_squash_merge'),

pulumi_github/get_team.py

@@ -27,7 +27,7 @@ class GetTeamResult:
     """
     A collection of values returned by getTeam.
     """
-    def __init__(__self__, description=None, id=None, members=None, membership_type=None, name=None, node_id=None, permission=None, privacy=None, repositories=None, repositories_detaileds=None, results_per_page=None, slug=None, summary_only=None):
+    def __init__(__self__, description=None, id=None, members=None, membership_type=None, name=None, node_id=None, notification_setting=None, permission=None, privacy=None, repositories=None, repositories_detaileds=None, results_per_page=None, slug=None, summary_only=None):
         if description and not isinstance(description, str):
             raise TypeError("Expected argument 'description' to be a str")
         pulumi.set(__self__, "description", description)
@@ -46,6 +46,9 @@ class GetTeamResult:
         if node_id and not isinstance(node_id, str):
             raise TypeError("Expected argument 'node_id' to be a str")
         pulumi.set(__self__, "node_id", node_id)
+        if notification_setting and not isinstance(notification_setting, str):
+            raise TypeError("Expected argument 'notification_setting' to be a str")
+        pulumi.set(__self__, "notification_setting", notification_setting)
         if permission and not isinstance(permission, str):
             raise TypeError("Expected argument 'permission' to be a str")
         pulumi.set(__self__, "permission", permission)
@@ -72,7 +75,7 @@ class GetTeamResult:
     @pulumi.getter
     def description(self) -> _builtins.str:
         """
-        the team's description.
+        Team's description.
         """
         return pulumi.get(self, "description")
 
@@ -88,7 +91,7 @@ class GetTeamResult:
     @pulumi.getter
     def members(self) -> Sequence[_builtins.str]:
         """
-        List of team members (list of GitHub usernames). Not returned if `summary_only = true`
+        List of team members (list of GitHub usernames). Not returned if `summary_only = true`.
         """
         return pulumi.get(self, "members")
 
@@ -101,7 +104,7 @@ class GetTeamResult:
     @pulumi.getter
     def name(self) -> _builtins.str:
         """
-        the team's full name.
+        Team's full name.
         """
         return pulumi.get(self, "name")
 
@@ -109,15 +112,24 @@ class GetTeamResult:
     @pulumi.getter(name="nodeId")
     def node_id(self) -> _builtins.str:
         """
-        the Node ID of the team.
+        Node ID of the team.
         """
         return pulumi.get(self, "node_id")
 
+    @_builtins.property
+    @pulumi.getter(name="notificationSetting")
+    def notification_setting(self) -> _builtins.str:
+        """
+        Teams's notification setting. Can be either `notifications_enabled` or `notifications_disabled`.
+        """
+        return pulumi.get(self, "notification_setting")
+
     @_builtins.property
     @pulumi.getter
+    @_utilities.deprecated("""Closing down notice.""")
     def permission(self) -> _builtins.str:
         """
-        the team's permission level.
+        (**DEPRECATED**) The permission that new repositories will be added to the team with when none is specified.
         """
         return pulumi.get(self, "permission")
 
@@ -125,7 +137,7 @@ class GetTeamResult:
     @pulumi.getter
     def privacy(self) -> _builtins.str:
         """
-        the team's privacy type.
+        Team's privacy type. Can either be `closed` or `secret`.
         """
         return pulumi.get(self, "privacy")
 
@@ -134,7 +146,7 @@ class GetTeamResult:
     @_utilities.deprecated("""Use repositories_detailed instead.""")
     def repositories(self) -> Sequence[_builtins.str]:
         """
-        (**DEPRECATED**) List of team repositories (list of repo names). Not returned if `summary_only = true`
+        (**DEPRECATED**) List of team repositories (list of repo names). Not returned if `summary_only = true`.
         """
         return pulumi.get(self, "repositories")
 
@@ -142,12 +154,13 @@ class GetTeamResult:
     @pulumi.getter(name="repositoriesDetaileds")
     def repositories_detaileds(self) -> Sequence['outputs.GetTeamRepositoriesDetailedResult']:
         """
-        List of team repositories (each item comprises of `repo_id`, `repo_name` & `role_name`). Not returned if `summary_only = true`
+        List of team repositories (each item comprises of `repo_id`, `repo_name` & `role_name`). Not returned if `summary_only = true`.
         """
         return pulumi.get(self, "repositories_detaileds")
 
     @_builtins.property
     @pulumi.getter(name="resultsPerPage")
+    @_utilities.deprecated("""This is deprecated and will be removed in a future release.""")
     def results_per_page(self) -> Optional[_builtins.int]:
         return pulumi.get(self, "results_per_page")
 
@@ -174,6 +187,7 @@ class AwaitableGetTeamResult(GetTeamResult):
             membership_type=self.membership_type,
             name=self.name,
             node_id=self.node_id,
+            notification_setting=self.notification_setting,
             permission=self.permission,
             privacy=self.privacy,
             repositories=self.repositories,
@@ -201,8 +215,8 @@ def get_team(membership_type: Optional[_builtins.str] = None,
     ```
 
 
-    :param _builtins.str membership_type: Type of membership to be requested to fill the list of members. Can be either "all" or "immediate". Default: "all"
-    :param _builtins.int results_per_page: Set the number of results per graphql query. Reducing this number can alleviate timeout errors. Accepts a value between 0 - 100. Defaults to `100`.
+    :param _builtins.str membership_type: Type of membership to be requested to fill the list of members. Can be either `all` _(default)_ or `immediate`.
+    :param _builtins.int results_per_page: (Optional) Set the number of results per REST API query. Accepts a value between 0 - 100 _(defaults to `100`)_.
     :param _builtins.str slug: The team slug.
     :param _builtins.bool summary_only: Exclude the members and repositories of the team from the returned result. Defaults to `false`.
     """
@@ -221,6 +235,7 @@ def get_team(membership_type: Optional[_builtins.str] = None,
         membership_type=pulumi.get(__ret__, 'membership_type'),
         name=pulumi.get(__ret__, 'name'),
         node_id=pulumi.get(__ret__, 'node_id'),
+        notification_setting=pulumi.get(__ret__, 'notification_setting'),
         permission=pulumi.get(__ret__, 'permission'),
         privacy=pulumi.get(__ret__, 'privacy'),
         repositories=pulumi.get(__ret__, 'repositories'),
@@ -246,8 +261,8 @@ def get_team_output(membership_type: Optional[pulumi.Input[Optional[_builtins.st
     ```
 
 
-    :param _builtins.str membership_type: Type of membership to be requested to fill the list of members. Can be either "all" or "immediate". Default: "all"
-    :param _builtins.int results_per_page: Set the number of results per graphql query. Reducing this number can alleviate timeout errors. Accepts a value between 0 - 100. Defaults to `100`.
+    :param _builtins.str membership_type: Type of membership to be requested to fill the list of members. Can be either `all` _(default)_ or `immediate`.
+    :param _builtins.int results_per_page: (Optional) Set the number of results per REST API query. Accepts a value between 0 - 100 _(defaults to `100`)_.
     :param _builtins.str slug: The team slug.
     :param _builtins.bool summary_only: Exclude the members and repositories of the team from the returned result. Defaults to `false`.
     """
@@ -265,6 +280,7 @@ def get_team_output(membership_type: Optional[pulumi.Input[Optional[_builtins.st
         membership_type=pulumi.get(__response__, 'membership_type'),
         name=pulumi.get(__response__, 'name'),
         node_id=pulumi.get(__response__, 'node_id'),
+        notification_setting=pulumi.get(__response__, 'notification_setting'),
         permission=pulumi.get(__response__, 'permission'),
         privacy=pulumi.get(__response__, 'privacy'),
         repositories=pulumi.get(__response__, 'repositories'),