@pulumi/github 6.10.0-alpha.1766123444 → 6.10.0-alpha.1766201671

package/actionsHostedRunner.d.ts

@@ -0,0 +1,250 @@
+import * as pulumi from "@pulumi/pulumi";
+import * as inputs from "./types/input";
+import * as outputs from "./types/output";
+/**
+ * This resource allows you to create and manage GitHub-hosted runners within your GitHub organization.
+ * You must have admin access to an organization to use this resource.
+ *
+ * GitHub-hosted runners are fully managed virtual machines that run your GitHub Actions workflows. Unlike self-hosted runners, GitHub handles the infrastructure, maintenance, and scaling.
+ *
+ * ## Example Usage
+ *
+ * ### Basic Usage
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as github from "@pulumi/github";
+ *
+ * const example = new github.ActionsRunnerGroup("example", {
+ *     name: "example-runner-group",
+ *     visibility: "all",
+ * });
+ * const exampleActionsHostedRunner = new github.ActionsHostedRunner("example", {
+ *     name: "example-hosted-runner",
+ *     image: {
+ *         id: "2306",
+ *         source: "github",
+ *     },
+ *     size: "4-core",
+ *     runnerGroupId: example.id,
+ * });
+ * ```
+ *
+ * ### Advanced Usage with Optional Parameters
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as github from "@pulumi/github";
+ *
+ * const advanced = new github.ActionsRunnerGroup("advanced", {
+ *     name: "advanced-runner-group",
+ *     visibility: "selected",
+ * });
+ * const advancedActionsHostedRunner = new github.ActionsHostedRunner("advanced", {
+ *     name: "advanced-hosted-runner",
+ *     image: {
+ *         id: "2306",
+ *         source: "github",
+ *     },
+ *     size: "8-core",
+ *     runnerGroupId: advanced.id,
+ *     maximumRunners: 10,
+ *     publicIpEnabled: true,
+ * });
+ * ```
+ *
+ * ## Notes
+ *
+ * * This resource is **organization-only** and cannot be used with individual accounts.
+ * * The `image` field cannot be changed after the runner is created. Changing it will force recreation of the runner.
+ * * The `size` field can be updated to scale the runner up or down as needed.
+ * * Image IDs for GitHub-owned images are numeric strings (e.g., "2306" for Ubuntu Latest 24.04), not names like "ubuntu-latest".
+ * * Deletion of hosted runners is asynchronous. The provider will poll for up to 10 minutes (configurable via timeouts) to confirm deletion.
+ * * Runner creation and updates may take several minutes as GitHub provisions the infrastructure.
+ * * Static public IPs are subject to account limits. Check your organization's limits before enabling.
+ *
+ * ## Getting Available Images and Sizes
+ *
+ * To get a list of available images:
+ *
+ * To get available machine sizes:
+ *
+ * ## Import
+ *
+ * Hosted runners can be imported using the runner ID:
+ *
+ * ```sh
+ * $ pulumi import github:index/actionsHostedRunner:ActionsHostedRunner example 123456
+ * ```
+ */
+export declare class ActionsHostedRunner extends pulumi.CustomResource {
+    /**
+     * Get an existing ActionsHostedRunner resource's state with the given name, ID, and optional extra
+     * properties used to qualify the lookup.
+     *
+     * @param name The _unique_ name of the resulting resource.
+     * @param id The _unique_ provider ID of the resource to lookup.
+     * @param state Any extra arguments used during the lookup.
+     * @param opts Optional settings to control the behavior of the CustomResource.
+     */
+    static get(name: string, id: pulumi.Input<pulumi.ID>, state?: ActionsHostedRunnerState, opts?: pulumi.CustomResourceOptions): ActionsHostedRunner;
+    /**
+     * Returns true if the given object is an instance of ActionsHostedRunner.  This is designed to work even
+     * when multiple copies of the Pulumi SDK have been loaded into the same process.
+     */
+    static isInstance(obj: any): obj is ActionsHostedRunner;
+    /**
+     * Image configuration for the hosted runner. Cannot be changed after creation. Block supports:
+     */
+    readonly image: pulumi.Output<outputs.ActionsHostedRunnerImage>;
+    /**
+     * Whether this runner should be used to generate custom images. Cannot be changed after creation.
+     */
+    readonly imageGen: pulumi.Output<boolean | undefined>;
+    /**
+     * The version of the runner image to deploy. This is only relevant for runners using custom images.
+     */
+    readonly imageVersion: pulumi.Output<string | undefined>;
+    /**
+     * Timestamp (RFC3339) when the runner was last active.
+     */
+    readonly lastActiveOn: pulumi.Output<string>;
+    /**
+     * Detailed specifications of the machine size:
+     */
+    readonly machineSizeDetails: pulumi.Output<outputs.ActionsHostedRunnerMachineSizeDetail[]>;
+    /**
+     * Maximum number of runners to scale up to. Runners will not auto-scale above this number. Use this setting to limit costs.
+     */
+    readonly maximumRunners: pulumi.Output<number>;
+    /**
+     * Name of the hosted runner. Must be between 1 and 64 characters and may only contain alphanumeric characters, '.', '-', and '_'.
+     */
+    readonly name: pulumi.Output<string>;
+    /**
+     * Platform of the runner (e.g., "linux-x64", "win-x64").
+     */
+    readonly platform: pulumi.Output<string>;
+    /**
+     * Whether to enable static public IP for the runner. Note there are account limits. To list limits, use the GitHub API: `GET /orgs/{org}/actions/hosted-runners/limits`. Defaults to false.
+     */
+    readonly publicIpEnabled: pulumi.Output<boolean | undefined>;
+    /**
+     * List of public IP ranges assigned to this runner (only if `publicIpEnabled` is true):
+     */
+    readonly publicIps: pulumi.Output<outputs.ActionsHostedRunnerPublicIp[]>;
+    /**
+     * The ID of the runner group to assign this runner to.
+     */
+    readonly runnerGroupId: pulumi.Output<number>;
+    /**
+     * Machine size for the hosted runner (e.g., "4-core", "8-core"). Can be updated to scale the runner. To list available sizes, use the GitHub API: `GET /orgs/{org}/actions/hosted-runners/machine-sizes`.
+     */
+    readonly size: pulumi.Output<string>;
+    /**
+     * Current status of the runner (e.g., "Ready", "Provisioning").
+     */
+    readonly status: pulumi.Output<string>;
+    /**
+     * Create a ActionsHostedRunner resource with the given unique name, arguments, and options.
+     *
+     * @param name The _unique_ name of the resource.
+     * @param args The arguments to use to populate this resource's properties.
+     * @param opts A bag of options that control this resource's behavior.
+     */
+    constructor(name: string, args: ActionsHostedRunnerArgs, opts?: pulumi.CustomResourceOptions);
+}
+/**
+ * Input properties used for looking up and filtering ActionsHostedRunner resources.
+ */
+export interface ActionsHostedRunnerState {
+    /**
+     * Image configuration for the hosted runner. Cannot be changed after creation. Block supports:
+     */
+    image?: pulumi.Input<inputs.ActionsHostedRunnerImage>;
+    /**
+     * Whether this runner should be used to generate custom images. Cannot be changed after creation.
+     */
+    imageGen?: pulumi.Input<boolean>;
+    /**
+     * The version of the runner image to deploy. This is only relevant for runners using custom images.
+     */
+    imageVersion?: pulumi.Input<string>;
+    /**
+     * Timestamp (RFC3339) when the runner was last active.
+     */
+    lastActiveOn?: pulumi.Input<string>;
+    /**
+     * Detailed specifications of the machine size:
+     */
+    machineSizeDetails?: pulumi.Input<pulumi.Input<inputs.ActionsHostedRunnerMachineSizeDetail>[]>;
+    /**
+     * Maximum number of runners to scale up to. Runners will not auto-scale above this number. Use this setting to limit costs.
+     */
+    maximumRunners?: pulumi.Input<number>;
+    /**
+     * Name of the hosted runner. Must be between 1 and 64 characters and may only contain alphanumeric characters, '.', '-', and '_'.
+     */
+    name?: pulumi.Input<string>;
+    /**
+     * Platform of the runner (e.g., "linux-x64", "win-x64").
+     */
+    platform?: pulumi.Input<string>;
+    /**
+     * Whether to enable static public IP for the runner. Note there are account limits. To list limits, use the GitHub API: `GET /orgs/{org}/actions/hosted-runners/limits`. Defaults to false.
+     */
+    publicIpEnabled?: pulumi.Input<boolean>;
+    /**
+     * List of public IP ranges assigned to this runner (only if `publicIpEnabled` is true):
+     */
+    publicIps?: pulumi.Input<pulumi.Input<inputs.ActionsHostedRunnerPublicIp>[]>;
+    /**
+     * The ID of the runner group to assign this runner to.
+     */
+    runnerGroupId?: pulumi.Input<number>;
+    /**
+     * Machine size for the hosted runner (e.g., "4-core", "8-core"). Can be updated to scale the runner. To list available sizes, use the GitHub API: `GET /orgs/{org}/actions/hosted-runners/machine-sizes`.
+     */
+    size?: pulumi.Input<string>;
+    /**
+     * Current status of the runner (e.g., "Ready", "Provisioning").
+     */
+    status?: pulumi.Input<string>;
+}
+/**
+ * The set of arguments for constructing a ActionsHostedRunner resource.
+ */
+export interface ActionsHostedRunnerArgs {
+    /**
+     * Image configuration for the hosted runner. Cannot be changed after creation. Block supports:
+     */
+    image: pulumi.Input<inputs.ActionsHostedRunnerImage>;
+    /**
+     * Whether this runner should be used to generate custom images. Cannot be changed after creation.
+     */
+    imageGen?: pulumi.Input<boolean>;
+    /**
+     * The version of the runner image to deploy. This is only relevant for runners using custom images.
+     */
+    imageVersion?: pulumi.Input<string>;
+    /**
+     * Maximum number of runners to scale up to. Runners will not auto-scale above this number. Use this setting to limit costs.
+     */
+    maximumRunners?: pulumi.Input<number>;
+    /**
+     * Name of the hosted runner. Must be between 1 and 64 characters and may only contain alphanumeric characters, '.', '-', and '_'.
+     */
+    name?: pulumi.Input<string>;
+    /**
+     * Whether to enable static public IP for the runner. Note there are account limits. To list limits, use the GitHub API: `GET /orgs/{org}/actions/hosted-runners/limits`. Defaults to false.
+     */
+    publicIpEnabled?: pulumi.Input<boolean>;
+    /**
+     * The ID of the runner group to assign this runner to.
+     */
+    runnerGroupId: pulumi.Input<number>;
+    /**
+     * Machine size for the hosted runner (e.g., "4-core", "8-core"). Can be updated to scale the runner. To list available sizes, use the GitHub API: `GET /orgs/{org}/actions/hosted-runners/machine-sizes`.
+     */
+    size: pulumi.Input<string>;
+}

package/actionsHostedRunner.js

@@ -0,0 +1,158 @@
+"use strict";
+// *** WARNING: this file was generated by pulumi-language-nodejs. ***
+// *** Do not edit by hand unless you're certain you know what you are doing! ***
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActionsHostedRunner = void 0;
+const pulumi = require("@pulumi/pulumi");
+const utilities = require("./utilities");
+/**
+ * This resource allows you to create and manage GitHub-hosted runners within your GitHub organization.
+ * You must have admin access to an organization to use this resource.
+ *
+ * GitHub-hosted runners are fully managed virtual machines that run your GitHub Actions workflows. Unlike self-hosted runners, GitHub handles the infrastructure, maintenance, and scaling.
+ *
+ * ## Example Usage
+ *
+ * ### Basic Usage
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as github from "@pulumi/github";
+ *
+ * const example = new github.ActionsRunnerGroup("example", {
+ *     name: "example-runner-group",
+ *     visibility: "all",
+ * });
+ * const exampleActionsHostedRunner = new github.ActionsHostedRunner("example", {
+ *     name: "example-hosted-runner",
+ *     image: {
+ *         id: "2306",
+ *         source: "github",
+ *     },
+ *     size: "4-core",
+ *     runnerGroupId: example.id,
+ * });
+ * ```
+ *
+ * ### Advanced Usage with Optional Parameters
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as github from "@pulumi/github";
+ *
+ * const advanced = new github.ActionsRunnerGroup("advanced", {
+ *     name: "advanced-runner-group",
+ *     visibility: "selected",
+ * });
+ * const advancedActionsHostedRunner = new github.ActionsHostedRunner("advanced", {
+ *     name: "advanced-hosted-runner",
+ *     image: {
+ *         id: "2306",
+ *         source: "github",
+ *     },
+ *     size: "8-core",
+ *     runnerGroupId: advanced.id,
+ *     maximumRunners: 10,
+ *     publicIpEnabled: true,
+ * });
+ * ```
+ *
+ * ## Notes
+ *
+ * * This resource is **organization-only** and cannot be used with individual accounts.
+ * * The `image` field cannot be changed after the runner is created. Changing it will force recreation of the runner.
+ * * The `size` field can be updated to scale the runner up or down as needed.
+ * * Image IDs for GitHub-owned images are numeric strings (e.g., "2306" for Ubuntu Latest 24.04), not names like "ubuntu-latest".
+ * * Deletion of hosted runners is asynchronous. The provider will poll for up to 10 minutes (configurable via timeouts) to confirm deletion.
+ * * Runner creation and updates may take several minutes as GitHub provisions the infrastructure.
+ * * Static public IPs are subject to account limits. Check your organization's limits before enabling.
+ *
+ * ## Getting Available Images and Sizes
+ *
+ * To get a list of available images:
+ *
+ * To get available machine sizes:
+ *
+ * ## Import
+ *
+ * Hosted runners can be imported using the runner ID:
+ *
+ * ```sh
+ * $ pulumi import github:index/actionsHostedRunner:ActionsHostedRunner example 123456
+ * ```
+ */
+class ActionsHostedRunner extends pulumi.CustomResource {
+    /**
+     * Get an existing ActionsHostedRunner resource's state with the given name, ID, and optional extra
+     * properties used to qualify the lookup.
+     *
+     * @param name The _unique_ name of the resulting resource.
+     * @param id The _unique_ provider ID of the resource to lookup.
+     * @param state Any extra arguments used during the lookup.
+     * @param opts Optional settings to control the behavior of the CustomResource.
+     */
+    static get(name, id, state, opts) {
+        return new ActionsHostedRunner(name, state, { ...opts, id: id });
+    }
+    /**
+     * Returns true if the given object is an instance of ActionsHostedRunner.  This is designed to work even
+     * when multiple copies of the Pulumi SDK have been loaded into the same process.
+     */
+    static isInstance(obj) {
+        if (obj === undefined || obj === null) {
+            return false;
+        }
+        return obj['__pulumiType'] === ActionsHostedRunner.__pulumiType;
+    }
+    constructor(name, argsOrState, opts) {
+        let resourceInputs = {};
+        opts = opts || {};
+        if (opts.id) {
+            const state = argsOrState;
+            resourceInputs["image"] = state?.image;
+            resourceInputs["imageGen"] = state?.imageGen;
+            resourceInputs["imageVersion"] = state?.imageVersion;
+            resourceInputs["lastActiveOn"] = state?.lastActiveOn;
+            resourceInputs["machineSizeDetails"] = state?.machineSizeDetails;
+            resourceInputs["maximumRunners"] = state?.maximumRunners;
+            resourceInputs["name"] = state?.name;
+            resourceInputs["platform"] = state?.platform;
+            resourceInputs["publicIpEnabled"] = state?.publicIpEnabled;
+            resourceInputs["publicIps"] = state?.publicIps;
+            resourceInputs["runnerGroupId"] = state?.runnerGroupId;
+            resourceInputs["size"] = state?.size;
+            resourceInputs["status"] = state?.status;
+        }
+        else {
+            const args = argsOrState;
+            if (args?.image === undefined && !opts.urn) {
+                throw new Error("Missing required property 'image'");
+            }
+            if (args?.runnerGroupId === undefined && !opts.urn) {
+                throw new Error("Missing required property 'runnerGroupId'");
+            }
+            if (args?.size === undefined && !opts.urn) {
+                throw new Error("Missing required property 'size'");
+            }
+            resourceInputs["image"] = args?.image;
+            resourceInputs["imageGen"] = args?.imageGen;
+            resourceInputs["imageVersion"] = args?.imageVersion;
+            resourceInputs["maximumRunners"] = args?.maximumRunners;
+            resourceInputs["name"] = args?.name;
+            resourceInputs["publicIpEnabled"] = args?.publicIpEnabled;
+            resourceInputs["runnerGroupId"] = args?.runnerGroupId;
+            resourceInputs["size"] = args?.size;
+            resourceInputs["lastActiveOn"] = undefined /*out*/;
+            resourceInputs["machineSizeDetails"] = undefined /*out*/;
+            resourceInputs["platform"] = undefined /*out*/;
+            resourceInputs["publicIps"] = undefined /*out*/;
+            resourceInputs["status"] = undefined /*out*/;
+        }
+        opts = pulumi.mergeOptions(utilities.resourceOptsDefaults(), opts);
+        super(ActionsHostedRunner.__pulumiType, name, resourceInputs, opts);
+    }
+}
+exports.ActionsHostedRunner = ActionsHostedRunner;
+/** @internal */
+ActionsHostedRunner.__pulumiType = 'github:index/actionsHostedRunner:ActionsHostedRunner';
+//# sourceMappingURL=actionsHostedRunner.js.map

package/actionsHostedRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionsHostedRunner.js","sourceRoot":"","sources":["../actionsHostedRunner.ts"],"names":[],"mappings":"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"}

package/enterpriseActionsWorkflowPermissions.d.ts

@@ -0,0 +1,113 @@
+import * as pulumi from "@pulumi/pulumi";
+/**
+ * This resource allows you to manage GitHub Actions workflow permissions for a GitHub Enterprise 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 enterprise admin access to use this resource.
+ *
+ * ## Example Usage
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as github from "@pulumi/github";
+ *
+ * // Basic workflow permissions configuration
+ * const example = new github.EnterpriseActionsWorkflowPermissions("example", {
+ *     enterpriseSlug: "my-enterprise",
+ *     defaultWorkflowPermissions: "read",
+ *     canApprovePullRequestReviews: false,
+ * });
+ * // Allow write permissions and PR approvals
+ * const permissive = new github.EnterpriseActionsWorkflowPermissions("permissive", {
+ *     enterpriseSlug: "my-enterprise",
+ *     defaultWorkflowPermissions: "write",
+ *     canApprovePullRequestReviews: true,
+ * });
+ * ```
+ *
+ * ## Notes
+ *
+ * > **Note:** This resource requires a GitHub Enterprise account and enterprise admin permissions.
+ *
+ * When this resource is destroyed, the workflow permissions will be reset to safe defaults:
+ * - `defaultWorkflowPermissions` = `read`
+ * - `canApprovePullRequestReviews` = `false`
+ *
+ * ## Import
+ *
+ * Enterprise Actions workflow permissions can be imported using the enterprise slug:
+ *
+ * ```sh
+ * $ pulumi import github:index/enterpriseActionsWorkflowPermissions:EnterpriseActionsWorkflowPermissions example my-enterprise
+ * ```
+ */
+export declare class EnterpriseActionsWorkflowPermissions extends pulumi.CustomResource {
+    /**
+     * Get an existing EnterpriseActionsWorkflowPermissions resource's state with the given name, ID, and optional extra
+     * properties used to qualify the lookup.
+     *
+     * @param name The _unique_ name of the resulting resource.
+     * @param id The _unique_ provider ID of the resource to lookup.
+     * @param state Any extra arguments used during the lookup.
+     * @param opts Optional settings to control the behavior of the CustomResource.
+     */
+    static get(name: string, id: pulumi.Input<pulumi.ID>, state?: EnterpriseActionsWorkflowPermissionsState, opts?: pulumi.CustomResourceOptions): EnterpriseActionsWorkflowPermissions;
+    /**
+     * Returns true if the given object is an instance of EnterpriseActionsWorkflowPermissions.  This is designed to work even
+     * when multiple copies of the Pulumi SDK have been loaded into the same process.
+     */
+    static isInstance(obj: any): obj is EnterpriseActionsWorkflowPermissions;
+    /**
+     * Whether GitHub Actions can approve pull request reviews. Defaults to `false`.
+     */
+    readonly canApprovePullRequestReviews: pulumi.Output<boolean | undefined>;
+    /**
+     * The default workflow permissions granted to the GITHUB_TOKEN when running workflows. Can be `read` or `write`. Defaults to `read`.
+     */
+    readonly defaultWorkflowPermissions: pulumi.Output<string | undefined>;
+    /**
+     * The slug of the enterprise.
+     */
+    readonly enterpriseSlug: pulumi.Output<string>;
+    /**
+     * Create a EnterpriseActionsWorkflowPermissions resource with the given unique name, arguments, and options.
+     *
+     * @param name The _unique_ name of the resource.
+     * @param args The arguments to use to populate this resource's properties.
+     * @param opts A bag of options that control this resource's behavior.
+     */
+    constructor(name: string, args: EnterpriseActionsWorkflowPermissionsArgs, opts?: pulumi.CustomResourceOptions);
+}
+/**
+ * Input properties used for looking up and filtering EnterpriseActionsWorkflowPermissions resources.
+ */
+export interface EnterpriseActionsWorkflowPermissionsState {
+    /**
+     * Whether GitHub Actions can approve pull request reviews. Defaults to `false`.
+     */
+    canApprovePullRequestReviews?: pulumi.Input<boolean>;
+    /**
+     * The default workflow permissions granted to the GITHUB_TOKEN when running workflows. Can be `read` or `write`. Defaults to `read`.
+     */
+    defaultWorkflowPermissions?: pulumi.Input<string>;
+    /**
+     * The slug of the enterprise.
+     */
+    enterpriseSlug?: pulumi.Input<string>;
+}
+/**
+ * The set of arguments for constructing a EnterpriseActionsWorkflowPermissions resource.
+ */
+export interface EnterpriseActionsWorkflowPermissionsArgs {
+    /**
+     * Whether GitHub Actions can approve pull request reviews. Defaults to `false`.
+     */
+    canApprovePullRequestReviews?: pulumi.Input<boolean>;
+    /**
+     * The default workflow permissions granted to the GITHUB_TOKEN when running workflows. Can be `read` or `write`. Defaults to `read`.
+     */
+    defaultWorkflowPermissions?: pulumi.Input<string>;
+    /**
+     * The slug of the enterprise.
+     */
+    enterpriseSlug: pulumi.Input<string>;
+}

package/enterpriseActionsWorkflowPermissions.js

@@ -0,0 +1,97 @@
+"use strict";
+// *** WARNING: this file was generated by pulumi-language-nodejs. ***
+// *** Do not edit by hand unless you're certain you know what you are doing! ***
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnterpriseActionsWorkflowPermissions = void 0;
+const pulumi = require("@pulumi/pulumi");
+const utilities = require("./utilities");
+/**
+ * This resource allows you to manage GitHub Actions workflow permissions for a GitHub Enterprise 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 enterprise admin access to use this resource.
+ *
+ * ## Example Usage
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as github from "@pulumi/github";
+ *
+ * // Basic workflow permissions configuration
+ * const example = new github.EnterpriseActionsWorkflowPermissions("example", {
+ *     enterpriseSlug: "my-enterprise",
+ *     defaultWorkflowPermissions: "read",
+ *     canApprovePullRequestReviews: false,
+ * });
+ * // Allow write permissions and PR approvals
+ * const permissive = new github.EnterpriseActionsWorkflowPermissions("permissive", {
+ *     enterpriseSlug: "my-enterprise",
+ *     defaultWorkflowPermissions: "write",
+ *     canApprovePullRequestReviews: true,
+ * });
+ * ```
+ *
+ * ## Notes
+ *
+ * > **Note:** This resource requires a GitHub Enterprise account and enterprise admin permissions.
+ *
+ * When this resource is destroyed, the workflow permissions will be reset to safe defaults:
+ * - `defaultWorkflowPermissions` = `read`
+ * - `canApprovePullRequestReviews` = `false`
+ *
+ * ## Import
+ *
+ * Enterprise Actions workflow permissions can be imported using the enterprise slug:
+ *
+ * ```sh
+ * $ pulumi import github:index/enterpriseActionsWorkflowPermissions:EnterpriseActionsWorkflowPermissions example my-enterprise
+ * ```
+ */
+class EnterpriseActionsWorkflowPermissions extends pulumi.CustomResource {
+    /**
+     * Get an existing EnterpriseActionsWorkflowPermissions resource's state with the given name, ID, and optional extra
+     * properties used to qualify the lookup.
+     *
+     * @param name The _unique_ name of the resulting resource.
+     * @param id The _unique_ provider ID of the resource to lookup.
+     * @param state Any extra arguments used during the lookup.
+     * @param opts Optional settings to control the behavior of the CustomResource.
+     */
+    static get(name, id, state, opts) {
+        return new EnterpriseActionsWorkflowPermissions(name, state, { ...opts, id: id });
+    }
+    /**
+     * Returns true if the given object is an instance of EnterpriseActionsWorkflowPermissions.  This is designed to work even
+     * when multiple copies of the Pulumi SDK have been loaded into the same process.
+     */
+    static isInstance(obj) {
+        if (obj === undefined || obj === null) {
+            return false;
+        }
+        return obj['__pulumiType'] === EnterpriseActionsWorkflowPermissions.__pulumiType;
+    }
+    constructor(name, argsOrState, opts) {
+        let resourceInputs = {};
+        opts = opts || {};
+        if (opts.id) {
+            const state = argsOrState;
+            resourceInputs["canApprovePullRequestReviews"] = state?.canApprovePullRequestReviews;
+            resourceInputs["defaultWorkflowPermissions"] = state?.defaultWorkflowPermissions;
+            resourceInputs["enterpriseSlug"] = state?.enterpriseSlug;
+        }
+        else {
+            const args = argsOrState;
+            if (args?.enterpriseSlug === undefined && !opts.urn) {
+                throw new Error("Missing required property 'enterpriseSlug'");
+            }
+            resourceInputs["canApprovePullRequestReviews"] = args?.canApprovePullRequestReviews;
+            resourceInputs["defaultWorkflowPermissions"] = args?.defaultWorkflowPermissions;
+            resourceInputs["enterpriseSlug"] = args?.enterpriseSlug;
+        }
+        opts = pulumi.mergeOptions(utilities.resourceOptsDefaults(), opts);
+        super(EnterpriseActionsWorkflowPermissions.__pulumiType, name, resourceInputs, opts);
+    }
+}
+exports.EnterpriseActionsWorkflowPermissions = EnterpriseActionsWorkflowPermissions;
+/** @internal */
+EnterpriseActionsWorkflowPermissions.__pulumiType = 'github:index/enterpriseActionsWorkflowPermissions:EnterpriseActionsWorkflowPermissions';
+//# sourceMappingURL=enterpriseActionsWorkflowPermissions.js.map

package/enterpriseActionsWorkflowPermissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enterpriseActionsWorkflowPermissions.js","sourceRoot":"","sources":["../enterpriseActionsWorkflowPermissions.ts"],"names":[],"mappings":";AAAA,sEAAsE;AACtE,iFAAiF;;;AAEjF,yCAAyC;AACzC,yCAAyC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAa,oCAAqC,SAAQ,MAAM,CAAC,cAAc;IAC3E;;;;;;;;OAQG;IACI,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAA2B,EAAE,KAAiD,EAAE,IAAmC;QAC/I,OAAO,IAAI,oCAAoC,CAAC,IAAI,EAAO,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3F,CAAC;IAKD;;;OAGG;IACI,MAAM,CAAC,UAAU,CAAC,GAAQ;QAC7B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,EAAE;YACnC,OAAO,KAAK,CAAC;SAChB;QACD,OAAO,GAAG,CAAC,cAAc,CAAC,KAAK,oCAAoC,CAAC,YAAY,CAAC;IACrF,CAAC;IAuBD,YAAY,IAAY,EAAE,WAAkG,EAAE,IAAmC;QAC7J,IAAI,cAAc,GAAkB,EAAE,CAAC;QACvC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAClB,IAAI,IAAI,CAAC,EAAE,EAAE;YACT,MAAM,KAAK,GAAG,WAAoE,CAAC;YACnF,cAAc,CAAC,8BAA8B,CAAC,GAAG,KAAK,EAAE,4BAA4B,CAAC;YACrF,cAAc,CAAC,4BAA4B,CAAC,GAAG,KAAK,EAAE,0BAA0B,CAAC;YACjF,cAAc,CAAC,gBAAgB,CAAC,GAAG,KAAK,EAAE,cAAc,CAAC;SAC5D;aAAM;YACH,MAAM,IAAI,GAAG,WAAmE,CAAC;YACjF,IAAI,IAAI,EAAE,cAAc,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;gBACjD,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;aACjE;YACD,cAAc,CAAC,8BAA8B,CAAC,GAAG,IAAI,EAAE,4BAA4B,CAAC;YACpF,cAAc,CAAC,4BAA4B,CAAC,GAAG,IAAI,EAAE,0BAA0B,CAAC;YAChF,cAAc,CAAC,gBAAgB,CAAC,GAAG,IAAI,EAAE,cAAc,CAAC;SAC3D;QACD,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,CAAC,CAAC;QACnE,KAAK,CAAC,oCAAoC,CAAC,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;IACzF,CAAC;;AApEL,oFAqEC;AAvDG,gBAAgB;AACO,iDAAY,GAAG,wFAAwF,CAAC"}