GitHub v6.3.0 published on Monday, Sep 16, 2024 by Pulumi
github.getOrganization
Explore with Pulumi AI
Use this data source to retrieve basic information about a GitHub Organization.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as github from "@pulumi/github";
const example = github.getOrganization({
name: "github",
});
import pulumi
import pulumi_github as github
example = github.get_organization(name="github")
package main
import (
"github.com/pulumi/pulumi-github/sdk/v6/go/github"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := github.GetOrganization(ctx, &github.GetOrganizationArgs{
Name: "github",
}, nil)
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Github = Pulumi.Github;
return await Deployment.RunAsync(() =>
{
var example = Github.GetOrganization.Invoke(new()
{
Name = "github",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.github.GithubFunctions;
import com.pulumi.github.inputs.GetOrganizationArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
final var example = GithubFunctions.getOrganization(GetOrganizationArgs.builder()
.name("github")
.build());
}
}
variables:
example:
fn::invoke:
Function: github:getOrganization
Arguments:
name: github
Using getOrganization
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getOrganization(args: GetOrganizationArgs, opts?: InvokeOptions): Promise<GetOrganizationResult>
function getOrganizationOutput(args: GetOrganizationOutputArgs, opts?: InvokeOptions): Output<GetOrganizationResult>
def get_organization(ignore_archived_repos: Optional[bool] = None,
name: Optional[str] = None,
summary_only: Optional[bool] = None,
opts: Optional[InvokeOptions] = None) -> GetOrganizationResult
def get_organization_output(ignore_archived_repos: Optional[pulumi.Input[bool]] = None,
name: Optional[pulumi.Input[str]] = None,
summary_only: Optional[pulumi.Input[bool]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetOrganizationResult]
func GetOrganization(ctx *Context, args *GetOrganizationArgs, opts ...InvokeOption) (*GetOrganizationResult, error)
func GetOrganizationOutput(ctx *Context, args *GetOrganizationOutputArgs, opts ...InvokeOption) GetOrganizationResultOutput
> Note: This function is named GetOrganization
in the Go SDK.
public static class GetOrganization
{
public static Task<GetOrganizationResult> InvokeAsync(GetOrganizationArgs args, InvokeOptions? opts = null)
public static Output<GetOrganizationResult> Invoke(GetOrganizationInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetOrganizationResult> getOrganization(GetOrganizationArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: github:index/getOrganization:getOrganization
arguments:
# arguments dictionary
The following arguments are supported:
- Name string
- The name of the organization.
- Ignore
Archived boolRepos - Whether or not to include archived repos in the
repositories
list. Defaults tofalse
. - Summary
Only bool - Exclude the repos, members and other attributes from the returned result. Defaults to
false
.
- Name string
- The name of the organization.
- Ignore
Archived boolRepos - Whether or not to include archived repos in the
repositories
list. Defaults tofalse
. - Summary
Only bool - Exclude the repos, members and other attributes from the returned result. Defaults to
false
.
- name String
- The name of the organization.
- ignore
Archived BooleanRepos - Whether or not to include archived repos in the
repositories
list. Defaults tofalse
. - summary
Only Boolean - Exclude the repos, members and other attributes from the returned result. Defaults to
false
.
- name string
- The name of the organization.
- ignore
Archived booleanRepos - Whether or not to include archived repos in the
repositories
list. Defaults tofalse
. - summary
Only boolean - Exclude the repos, members and other attributes from the returned result. Defaults to
false
.
- name str
- The name of the organization.
- ignore_
archived_ boolrepos - Whether or not to include archived repos in the
repositories
list. Defaults tofalse
. - summary_
only bool - Exclude the repos, members and other attributes from the returned result. Defaults to
false
.
- name String
- The name of the organization.
- ignore
Archived BooleanRepos - Whether or not to include archived repos in the
repositories
list. Defaults tofalse
. - summary
Only Boolean - Exclude the repos, members and other attributes from the returned result. Defaults to
false
.
getOrganization Result
The following output properties are available:
- Advanced
Security boolEnabled For New Repositories - Whether advanced security is enabled for new repositories.
- Default
Repository stringPermission - Default permission level members have for organization repositories.
- Dependabot
Alerts boolEnabled For New Repositories - Whether Dependabot alerts is automatically enabled for new repositories.
- Dependabot
Security boolUpdates Enabled For New Repositories - Whether Dependabot security updates is automatically enabled for new repositories.
- Dependency
Graph boolEnabled For New Repositories - Whether dependency graph is automatically enabled for new repositories.
- Description string
- The organization account description
- Id string
- The provider-assigned unique ID for this managed resource.
- Login string
- The members login
- Members List<string>
- Deprecated: use
users
instead by replacinggithub_organization.example.members
togithub_organization.example.users[*].login
which will give you the same value, expect this field to be removed in next major version - Members
Allowed stringRepository Creation Type - The type of repository allowed to be created by members of the organization. Can be one of
ALL
,PUBLIC
,PRIVATE
,NONE
. - Members
Can boolCreate Internal Repositories - Whether organization members can create internal repositories.
- Members
Can boolCreate Pages - Whether organization members can create pages sites.
- Members
Can boolCreate Private Pages - Whether organization members can create private pages sites.
- Members
Can boolCreate Private Repositories - Whether organization members can create private repositories.
- Members
Can boolCreate Public Pages - Whether organization members can create public pages sites.
- Members
Can boolCreate Public Repositories - Whether organization members can create public repositories.
- Members
Can boolCreate Repositories - Whether non-admin organization members can create repositories.
- Members
Can boolFork Private Repositories - Whether organization members can create private repository forks.
- Name string
- The organization's public profile name
- Node
Id string - GraphQL global node ID for use with the v4 API
- Orgname string
- The organization's name as used in URLs and the API
- Plan string
- The organization account plan name
- Repositories List<string>
- (
list
) A list of the full names of the repositories in the organization formatted asowner/name
strings - Secret
Scanning boolEnabled For New Repositories - Whether secret scanning is automatically enabled for new repositories.
- Secret
Scanning boolPush Protection Enabled For New Repositories - Whether secret scanning push protection is automatically enabled for new repositories.
- Two
Factor boolRequirement Enabled - Whether two-factor authentication is required for all members of the organization.
- Users
List<Immutable
Dictionary<string, string>> - (
list
) A list with the members of the organization with following fields: - Web
Commit boolSignoff Required - Whether organization members must sign all commits.
- Ignore
Archived boolRepos - Summary
Only bool
- Advanced
Security boolEnabled For New Repositories - Whether advanced security is enabled for new repositories.
- Default
Repository stringPermission - Default permission level members have for organization repositories.
- Dependabot
Alerts boolEnabled For New Repositories - Whether Dependabot alerts is automatically enabled for new repositories.
- Dependabot
Security boolUpdates Enabled For New Repositories - Whether Dependabot security updates is automatically enabled for new repositories.
- Dependency
Graph boolEnabled For New Repositories - Whether dependency graph is automatically enabled for new repositories.
- Description string
- The organization account description
- Id string
- The provider-assigned unique ID for this managed resource.
- Login string
- The members login
- Members []string
- Deprecated: use
users
instead by replacinggithub_organization.example.members
togithub_organization.example.users[*].login
which will give you the same value, expect this field to be removed in next major version - Members
Allowed stringRepository Creation Type - The type of repository allowed to be created by members of the organization. Can be one of
ALL
,PUBLIC
,PRIVATE
,NONE
. - Members
Can boolCreate Internal Repositories - Whether organization members can create internal repositories.
- Members
Can boolCreate Pages - Whether organization members can create pages sites.
- Members
Can boolCreate Private Pages - Whether organization members can create private pages sites.
- Members
Can boolCreate Private Repositories - Whether organization members can create private repositories.
- Members
Can boolCreate Public Pages - Whether organization members can create public pages sites.
- Members
Can boolCreate Public Repositories - Whether organization members can create public repositories.
- Members
Can boolCreate Repositories - Whether non-admin organization members can create repositories.
- Members
Can boolFork Private Repositories - Whether organization members can create private repository forks.
- Name string
- The organization's public profile name
- Node
Id string - GraphQL global node ID for use with the v4 API
- Orgname string
- The organization's name as used in URLs and the API
- Plan string
- The organization account plan name
- Repositories []string
- (
list
) A list of the full names of the repositories in the organization formatted asowner/name
strings - Secret
Scanning boolEnabled For New Repositories - Whether secret scanning is automatically enabled for new repositories.
- Secret
Scanning boolPush Protection Enabled For New Repositories - Whether secret scanning push protection is automatically enabled for new repositories.
- Two
Factor boolRequirement Enabled - Whether two-factor authentication is required for all members of the organization.
- Users []map[string]string
- (
list
) A list with the members of the organization with following fields: - Web
Commit boolSignoff Required - Whether organization members must sign all commits.
- Ignore
Archived boolRepos - Summary
Only bool
- advanced
Security BooleanEnabled For New Repositories - Whether advanced security is enabled for new repositories.
- default
Repository StringPermission - Default permission level members have for organization repositories.
- dependabot
Alerts BooleanEnabled For New Repositories - Whether Dependabot alerts is automatically enabled for new repositories.
- dependabot
Security BooleanUpdates Enabled For New Repositories - Whether Dependabot security updates is automatically enabled for new repositories.
- dependency
Graph BooleanEnabled For New Repositories - Whether dependency graph is automatically enabled for new repositories.
- description String
- The organization account description
- id String
- The provider-assigned unique ID for this managed resource.
- login String
- The members login
- members List<String>
- Deprecated: use
users
instead by replacinggithub_organization.example.members
togithub_organization.example.users[*].login
which will give you the same value, expect this field to be removed in next major version - members
Allowed StringRepository Creation Type - The type of repository allowed to be created by members of the organization. Can be one of
ALL
,PUBLIC
,PRIVATE
,NONE
. - members
Can BooleanCreate Internal Repositories - Whether organization members can create internal repositories.
- members
Can BooleanCreate Pages - Whether organization members can create pages sites.
- members
Can BooleanCreate Private Pages - Whether organization members can create private pages sites.
- members
Can BooleanCreate Private Repositories - Whether organization members can create private repositories.
- members
Can BooleanCreate Public Pages - Whether organization members can create public pages sites.
- members
Can BooleanCreate Public Repositories - Whether organization members can create public repositories.
- members
Can BooleanCreate Repositories - Whether non-admin organization members can create repositories.
- members
Can BooleanFork Private Repositories - Whether organization members can create private repository forks.
- name String
- The organization's public profile name
- node
Id String - GraphQL global node ID for use with the v4 API
- orgname String
- The organization's name as used in URLs and the API
- plan String
- The organization account plan name
- repositories List<String>
- (
list
) A list of the full names of the repositories in the organization formatted asowner/name
strings - secret
Scanning BooleanEnabled For New Repositories - Whether secret scanning is automatically enabled for new repositories.
- secret
Scanning BooleanPush Protection Enabled For New Repositories - Whether secret scanning push protection is automatically enabled for new repositories.
- two
Factor BooleanRequirement Enabled - Whether two-factor authentication is required for all members of the organization.
- users List<Map<String,String>>
- (
list
) A list with the members of the organization with following fields: - web
Commit BooleanSignoff Required - Whether organization members must sign all commits.
- ignore
Archived BooleanRepos - summary
Only Boolean
- advanced
Security booleanEnabled For New Repositories - Whether advanced security is enabled for new repositories.
- default
Repository stringPermission - Default permission level members have for organization repositories.
- dependabot
Alerts booleanEnabled For New Repositories - Whether Dependabot alerts is automatically enabled for new repositories.
- dependabot
Security booleanUpdates Enabled For New Repositories - Whether Dependabot security updates is automatically enabled for new repositories.
- dependency
Graph booleanEnabled For New Repositories - Whether dependency graph is automatically enabled for new repositories.
- description string
- The organization account description
- id string
- The provider-assigned unique ID for this managed resource.
- login string
- The members login
- members string[]
- Deprecated: use
users
instead by replacinggithub_organization.example.members
togithub_organization.example.users[*].login
which will give you the same value, expect this field to be removed in next major version - members
Allowed stringRepository Creation Type - The type of repository allowed to be created by members of the organization. Can be one of
ALL
,PUBLIC
,PRIVATE
,NONE
. - members
Can booleanCreate Internal Repositories - Whether organization members can create internal repositories.
- members
Can booleanCreate Pages - Whether organization members can create pages sites.
- members
Can booleanCreate Private Pages - Whether organization members can create private pages sites.
- members
Can booleanCreate Private Repositories - Whether organization members can create private repositories.
- members
Can booleanCreate Public Pages - Whether organization members can create public pages sites.
- members
Can booleanCreate Public Repositories - Whether organization members can create public repositories.
- members
Can booleanCreate Repositories - Whether non-admin organization members can create repositories.
- members
Can booleanFork Private Repositories - Whether organization members can create private repository forks.
- name string
- The organization's public profile name
- node
Id string - GraphQL global node ID for use with the v4 API
- orgname string
- The organization's name as used in URLs and the API
- plan string
- The organization account plan name
- repositories string[]
- (
list
) A list of the full names of the repositories in the organization formatted asowner/name
strings - secret
Scanning booleanEnabled For New Repositories - Whether secret scanning is automatically enabled for new repositories.
- secret
Scanning booleanPush Protection Enabled For New Repositories - Whether secret scanning push protection is automatically enabled for new repositories.
- two
Factor booleanRequirement Enabled - Whether two-factor authentication is required for all members of the organization.
- users {[key: string]: string}[]
- (
list
) A list with the members of the organization with following fields: - web
Commit booleanSignoff Required - Whether organization members must sign all commits.
- ignore
Archived booleanRepos - summary
Only boolean
- advanced_
security_ boolenabled_ for_ new_ repositories - Whether advanced security is enabled for new repositories.
- default_
repository_ strpermission - Default permission level members have for organization repositories.
- dependabot_
alerts_ boolenabled_ for_ new_ repositories - Whether Dependabot alerts is automatically enabled for new repositories.
- dependabot_
security_ boolupdates_ enabled_ for_ new_ repositories - Whether Dependabot security updates is automatically enabled for new repositories.
- dependency_
graph_ boolenabled_ for_ new_ repositories - Whether dependency graph is automatically enabled for new repositories.
- description str
- The organization account description
- id str
- The provider-assigned unique ID for this managed resource.
- login str
- The members login
- members Sequence[str]
- Deprecated: use
users
instead by replacinggithub_organization.example.members
togithub_organization.example.users[*].login
which will give you the same value, expect this field to be removed in next major version - members_
allowed_ strrepository_ creation_ type - The type of repository allowed to be created by members of the organization. Can be one of
ALL
,PUBLIC
,PRIVATE
,NONE
. - members_
can_ boolcreate_ internal_ repositories - Whether organization members can create internal repositories.
- members_
can_ boolcreate_ pages - Whether organization members can create pages sites.
- members_
can_ boolcreate_ private_ pages - Whether organization members can create private pages sites.
- members_
can_ boolcreate_ private_ repositories - Whether organization members can create private repositories.
- members_
can_ boolcreate_ public_ pages - Whether organization members can create public pages sites.
- members_
can_ boolcreate_ public_ repositories - Whether organization members can create public repositories.
- members_
can_ boolcreate_ repositories - Whether non-admin organization members can create repositories.
- members_
can_ boolfork_ private_ repositories - Whether organization members can create private repository forks.
- name str
- The organization's public profile name
- node_
id str - GraphQL global node ID for use with the v4 API
- orgname str
- The organization's name as used in URLs and the API
- plan str
- The organization account plan name
- repositories Sequence[str]
- (
list
) A list of the full names of the repositories in the organization formatted asowner/name
strings - secret_
scanning_ boolenabled_ for_ new_ repositories - Whether secret scanning is automatically enabled for new repositories.
- secret_
scanning_ boolpush_ protection_ enabled_ for_ new_ repositories - Whether secret scanning push protection is automatically enabled for new repositories.
- two_
factor_ boolrequirement_ enabled - Whether two-factor authentication is required for all members of the organization.
- users Sequence[Mapping[str, str]]
- (
list
) A list with the members of the organization with following fields: - web_
commit_ boolsignoff_ required - Whether organization members must sign all commits.
- ignore_
archived_ boolrepos - summary_
only bool
- advanced
Security BooleanEnabled For New Repositories - Whether advanced security is enabled for new repositories.
- default
Repository StringPermission - Default permission level members have for organization repositories.
- dependabot
Alerts BooleanEnabled For New Repositories - Whether Dependabot alerts is automatically enabled for new repositories.
- dependabot
Security BooleanUpdates Enabled For New Repositories - Whether Dependabot security updates is automatically enabled for new repositories.
- dependency
Graph BooleanEnabled For New Repositories - Whether dependency graph is automatically enabled for new repositories.
- description String
- The organization account description
- id String
- The provider-assigned unique ID for this managed resource.
- login String
- The members login
- members List<String>
- Deprecated: use
users
instead by replacinggithub_organization.example.members
togithub_organization.example.users[*].login
which will give you the same value, expect this field to be removed in next major version - members
Allowed StringRepository Creation Type - The type of repository allowed to be created by members of the organization. Can be one of
ALL
,PUBLIC
,PRIVATE
,NONE
. - members
Can BooleanCreate Internal Repositories - Whether organization members can create internal repositories.
- members
Can BooleanCreate Pages - Whether organization members can create pages sites.
- members
Can BooleanCreate Private Pages - Whether organization members can create private pages sites.
- members
Can BooleanCreate Private Repositories - Whether organization members can create private repositories.
- members
Can BooleanCreate Public Pages - Whether organization members can create public pages sites.
- members
Can BooleanCreate Public Repositories - Whether organization members can create public repositories.
- members
Can BooleanCreate Repositories - Whether non-admin organization members can create repositories.
- members
Can BooleanFork Private Repositories - Whether organization members can create private repository forks.
- name String
- The organization's public profile name
- node
Id String - GraphQL global node ID for use with the v4 API
- orgname String
- The organization's name as used in URLs and the API
- plan String
- The organization account plan name
- repositories List<String>
- (
list
) A list of the full names of the repositories in the organization formatted asowner/name
strings - secret
Scanning BooleanEnabled For New Repositories - Whether secret scanning is automatically enabled for new repositories.
- secret
Scanning BooleanPush Protection Enabled For New Repositories - Whether secret scanning push protection is automatically enabled for new repositories.
- two
Factor BooleanRequirement Enabled - Whether two-factor authentication is required for all members of the organization.
- users List<Map<String>>
- (
list
) A list with the members of the organization with following fields: - web
Commit BooleanSignoff Required - Whether organization members must sign all commits.
- ignore
Archived BooleanRepos - summary
Only Boolean
Package Details
- Repository
- GitHub pulumi/pulumi-github
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
github
Terraform Provider.