All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.pulumi.gcp.iam.kotlin.DenyPolicy.kt Maven / Gradle / Ivy

Go to download

Build cloud applications and infrastructure by combining the safety and reliability of infrastructure as code with the power of the Kotlin programming language.

There is a newer version: 8.10.0.0
Show newest version
@file:Suppress("NAME_SHADOWING", "DEPRECATION")

package com.pulumi.gcp.iam.kotlin

import com.pulumi.core.Output
import com.pulumi.gcp.iam.kotlin.outputs.DenyPolicyRule
import com.pulumi.gcp.iam.kotlin.outputs.DenyPolicyRule.Companion.toKotlin
import com.pulumi.kotlin.KotlinCustomResource
import com.pulumi.kotlin.PulumiTagMarker
import com.pulumi.kotlin.ResourceMapper
import com.pulumi.kotlin.options.CustomResourceOptions
import com.pulumi.kotlin.options.CustomResourceOptionsBuilder
import com.pulumi.resources.Resource
import kotlin.Boolean
import kotlin.String
import kotlin.Suppress
import kotlin.Unit
import kotlin.collections.List

/**
 * Builder for [DenyPolicy].
 */
@PulumiTagMarker
public class DenyPolicyResourceBuilder internal constructor() {
    public var name: String? = null

    public var args: DenyPolicyArgs = DenyPolicyArgs()

    public var opts: CustomResourceOptions = CustomResourceOptions()

    /**
     * @param name The _unique_ name of the resulting resource.
     */
    public fun name(`value`: String) {
        this.name = value
    }

    /**
     * @param block The arguments to use to populate this resource's properties.
     */
    public suspend fun args(block: suspend DenyPolicyArgsBuilder.() -> Unit) {
        val builder = DenyPolicyArgsBuilder()
        block(builder)
        this.args = builder.build()
    }

    /**
     * @param block A bag of options that control this resource's behavior.
     */
    public suspend fun opts(block: suspend CustomResourceOptionsBuilder.() -> Unit) {
        this.opts = com.pulumi.kotlin.options.CustomResourceOptions.opts(block)
    }

    internal fun build(): DenyPolicy {
        val builtJavaResource = com.pulumi.gcp.iam.DenyPolicy(
            this.name,
            this.args.toJava(),
            this.opts.toJava(),
        )
        return DenyPolicy(builtJavaResource)
    }
}

/**
 * Represents a collection of denial policies to apply to a given resource.
 * To get more information about DenyPolicy, see:
 * * [API documentation](https://cloud.google.com/iam/docs/reference/rest/v2/policies)
 * * How-to Guides
 *     * [Permissions supported in deny policies](https://cloud.google.com/iam/docs/deny-permissions-support)
 * ## Example Usage
 * ### Iam Deny Policy Basic
 * 
 * ```typescript
 * import * as pulumi from "@pulumi/pulumi";
 * import * as gcp from "@pulumi/gcp";
 * import * as std from "@pulumi/std";
 * const project = new gcp.organizations.Project("project", {
 *     projectId: "my-project",
 *     name: "my-project",
 *     orgId: "123456789",
 *     billingAccount: "000000-0000000-0000000-000000",
 * });
 * const test_account = new gcp.serviceaccount.Account("test-account", {
 *     accountId: "svc-acc",
 *     displayName: "Test Service Account",
 *     project: project.projectId,
 * });
 * const example = new gcp.iam.DenyPolicy("example", {
 *     parent: std.urlencodeOutput({
 *         input: pulumi.interpolate`cloudresourcemanager.googleapis.com/projects/${project.projectId}`,
 *     }).apply(invoke => invoke.result),
 *     name: "my-deny-policy",
 *     displayName: "A deny rule",
 *     rules: [
 *         {
 *             description: "First rule",
 *             denyRule: {
 *                 deniedPrincipals: ["principalSet://goog/public:all"],
 *                 denialCondition: {
 *                     title: "Some expr",
 *                     expression: "!resource.matchTag('12345678/env', 'test')",
 *                 },
 *                 deniedPermissions: ["cloudresourcemanager.googleapis.com/projects.update"],
 *             },
 *         },
 *         {
 *             description: "Second rule",
 *             denyRule: {
 *                 deniedPrincipals: ["principalSet://goog/public:all"],
 *                 denialCondition: {
 *                     title: "Some expr",
 *                     expression: "!resource.matchTag('12345678/env', 'test')",
 *                 },
 *                 deniedPermissions: ["cloudresourcemanager.googleapis.com/projects.update"],
 *                 exceptionPrincipals: [pulumi.interpolate`principal://iam.googleapis.com/projects/-/serviceAccounts/${test_account.email}`],
 *             },
 *         },
 *     ],
 * });
 * ```
 * ```python
 * import pulumi
 * import pulumi_gcp as gcp
 * import pulumi_std as std
 * project = gcp.organizations.Project("project",
 *     project_id="my-project",
 *     name="my-project",
 *     org_id="123456789",
 *     billing_account="000000-0000000-0000000-000000")
 * test_account = gcp.serviceaccount.Account("test-account",
 *     account_id="svc-acc",
 *     display_name="Test Service Account",
 *     project=project.project_id)
 * example = gcp.iam.DenyPolicy("example",
 *     parent=std.urlencode_output(input=project.project_id.apply(lambda project_id: f"cloudresourcemanager.googleapis.com/projects/{project_id}")).apply(lambda invoke: invoke.result),
 *     name="my-deny-policy",
 *     display_name="A deny rule",
 *     rules=[
 *         gcp.iam.DenyPolicyRuleArgs(
 *             description="First rule",
 *             deny_rule=gcp.iam.DenyPolicyRuleDenyRuleArgs(
 *                 denied_principals=["principalSet://goog/public:all"],
 *                 denial_condition=gcp.iam.DenyPolicyRuleDenyRuleDenialConditionArgs(
 *                     title="Some expr",
 *                     expression="!resource.matchTag('12345678/env', 'test')",
 *                 ),
 *                 denied_permissions=["cloudresourcemanager.googleapis.com/projects.update"],
 *             ),
 *         ),
 *         gcp.iam.DenyPolicyRuleArgs(
 *             description="Second rule",
 *             deny_rule=gcp.iam.DenyPolicyRuleDenyRuleArgs(
 *                 denied_principals=["principalSet://goog/public:all"],
 *                 denial_condition=gcp.iam.DenyPolicyRuleDenyRuleDenialConditionArgs(
 *                     title="Some expr",
 *                     expression="!resource.matchTag('12345678/env', 'test')",
 *                 ),
 *                 denied_permissions=["cloudresourcemanager.googleapis.com/projects.update"],
 *                 exception_principals=[test_account.email.apply(lambda email: f"principal://iam.googleapis.com/projects/-/serviceAccounts/{email}")],
 *             ),
 *         ),
 *     ])
 * ```
 * ```csharp
 * using System.Collections.Generic;
 * using System.Linq;
 * using Pulumi;
 * using Gcp = Pulumi.Gcp;
 * using Std = Pulumi.Std;
 * return await Deployment.RunAsync(() =>
 * {
 *     var project = new Gcp.Organizations.Project("project", new()
 *     {
 *         ProjectId = "my-project",
 *         Name = "my-project",
 *         OrgId = "123456789",
 *         BillingAccount = "000000-0000000-0000000-000000",
 *     });
 *     var test_account = new Gcp.ServiceAccount.Account("test-account", new()
 *     {
 *         AccountId = "svc-acc",
 *         DisplayName = "Test Service Account",
 *         Project = project.ProjectId,
 *     });
 *     var example = new Gcp.Iam.DenyPolicy("example", new()
 *     {
 *         Parent = Std.Urlencode.Invoke(new()
 *         {
 *             Input = project.ProjectId.Apply(projectId => $"cloudresourcemanager.googleapis.com/projects/{projectId}"),
 *         }).Apply(invoke => invoke.Result),
 *         Name = "my-deny-policy",
 *         DisplayName = "A deny rule",
 *         Rules = new[]
 *         {
 *             new Gcp.Iam.Inputs.DenyPolicyRuleArgs
 *             {
 *                 Description = "First rule",
 *                 DenyRule = new Gcp.Iam.Inputs.DenyPolicyRuleDenyRuleArgs
 *                 {
 *                     DeniedPrincipals = new[]
 *                     {
 *                         "principalSet://goog/public:all",
 *                     },
 *                     DenialCondition = new Gcp.Iam.Inputs.DenyPolicyRuleDenyRuleDenialConditionArgs
 *                     {
 *                         Title = "Some expr",
 *                         Expression = "!resource.matchTag('12345678/env', 'test')",
 *                     },
 *                     DeniedPermissions = new[]
 *                     {
 *                         "cloudresourcemanager.googleapis.com/projects.update",
 *                     },
 *                 },
 *             },
 *             new Gcp.Iam.Inputs.DenyPolicyRuleArgs
 *             {
 *                 Description = "Second rule",
 *                 DenyRule = new Gcp.Iam.Inputs.DenyPolicyRuleDenyRuleArgs
 *                 {
 *                     DeniedPrincipals = new[]
 *                     {
 *                         "principalSet://goog/public:all",
 *                     },
 *                     DenialCondition = new Gcp.Iam.Inputs.DenyPolicyRuleDenyRuleDenialConditionArgs
 *                     {
 *                         Title = "Some expr",
 *                         Expression = "!resource.matchTag('12345678/env', 'test')",
 *                     },
 *                     DeniedPermissions = new[]
 *                     {
 *                         "cloudresourcemanager.googleapis.com/projects.update",
 *                     },
 *                     ExceptionPrincipals = new[]
 *                     {
 *                         test_account.Email.Apply(email => $"principal://iam.googleapis.com/projects/-/serviceAccounts/{email}"),
 *                     },
 *                 },
 *             },
 *         },
 *     });
 * });
 * ```
 * ```go
 * package main
 * import (
 * 	"fmt"
 * 	"github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/iam"
 * 	"github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/organizations"
 * 	"github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/serviceaccount"
 * 	"github.com/pulumi/pulumi-std/sdk/go/std"
 * 	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
 * )
 * func main() {
 * 	pulumi.Run(func(ctx *pulumi.Context) error {
 * 		project, err := organizations.NewProject(ctx, "project", &organizations.ProjectArgs{
 * 			ProjectId:      pulumi.String("my-project"),
 * 			Name:           pulumi.String("my-project"),
 * 			OrgId:          pulumi.String("123456789"),
 * 			BillingAccount: pulumi.String("000000-0000000-0000000-000000"),
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		_, err = serviceaccount.NewAccount(ctx, "test-account", &serviceaccount.AccountArgs{
 * 			AccountId:   pulumi.String("svc-acc"),
 * 			DisplayName: pulumi.String("Test Service Account"),
 * 			Project:     project.ProjectId,
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		_, err = iam.NewDenyPolicy(ctx, "example", &iam.DenyPolicyArgs{
 * 			Parent: std.UrlencodeOutput(ctx, std.UrlencodeOutputArgs{
 * 				Input: project.ProjectId.ApplyT(func(projectId string) (string, error) {
 * 					return fmt.Sprintf("cloudresourcemanager.googleapis.com/projects/%v", projectId), nil
 * 				}).(pulumi.StringOutput),
 * 			}, nil).ApplyT(func(invoke std.UrlencodeResult) (*string, error) {
 * 				return invoke.Result, nil
 * 			}).(pulumi.StringPtrOutput),
 * 			Name:        pulumi.String("my-deny-policy"),
 * 			DisplayName: pulumi.String("A deny rule"),
 * 			Rules: iam.DenyPolicyRuleArray{
 * 				&iam.DenyPolicyRuleArgs{
 * 					Description: pulumi.String("First rule"),
 * 					DenyRule: &iam.DenyPolicyRuleDenyRuleArgs{
 * 						DeniedPrincipals: pulumi.StringArray{
 * 							pulumi.String("principalSet://goog/public:all"),
 * 						},
 * 						DenialCondition: &iam.DenyPolicyRuleDenyRuleDenialConditionArgs{
 * 							Title:      pulumi.String("Some expr"),
 * 							Expression: pulumi.String("!resource.matchTag('12345678/env', 'test')"),
 * 						},
 * 						DeniedPermissions: pulumi.StringArray{
 * 							pulumi.String("cloudresourcemanager.googleapis.com/projects.update"),
 * 						},
 * 					},
 * 				},
 * 				&iam.DenyPolicyRuleArgs{
 * 					Description: pulumi.String("Second rule"),
 * 					DenyRule: &iam.DenyPolicyRuleDenyRuleArgs{
 * 						DeniedPrincipals: pulumi.StringArray{
 * 							pulumi.String("principalSet://goog/public:all"),
 * 						},
 * 						DenialCondition: &iam.DenyPolicyRuleDenyRuleDenialConditionArgs{
 * 							Title:      pulumi.String("Some expr"),
 * 							Expression: pulumi.String("!resource.matchTag('12345678/env', 'test')"),
 * 						},
 * 						DeniedPermissions: pulumi.StringArray{
 * 							pulumi.String("cloudresourcemanager.googleapis.com/projects.update"),
 * 						},
 * 						ExceptionPrincipals: pulumi.StringArray{
 * 							test_account.Email.ApplyT(func(email string) (string, error) {
 * 								return fmt.Sprintf("principal://iam.googleapis.com/projects/-/serviceAccounts/%v", email), nil
 * 							}).(pulumi.StringOutput),
 * 						},
 * 					},
 * 				},
 * 			},
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		return nil
 * 	})
 * }
 * ```
 * ```java
 * package generated_program;
 * import com.pulumi.Context;
 * import com.pulumi.Pulumi;
 * import com.pulumi.core.Output;
 * import com.pulumi.gcp.organizations.Project;
 * import com.pulumi.gcp.organizations.ProjectArgs;
 * import com.pulumi.gcp.serviceaccount.Account;
 * import com.pulumi.gcp.serviceaccount.AccountArgs;
 * import com.pulumi.gcp.iam.DenyPolicy;
 * import com.pulumi.gcp.iam.DenyPolicyArgs;
 * import com.pulumi.gcp.iam.inputs.DenyPolicyRuleArgs;
 * import com.pulumi.gcp.iam.inputs.DenyPolicyRuleDenyRuleArgs;
 * import com.pulumi.gcp.iam.inputs.DenyPolicyRuleDenyRuleDenialConditionArgs;
 * 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) {
 *         var project = new Project("project", ProjectArgs.builder()
 *             .projectId("my-project")
 *             .name("my-project")
 *             .orgId("123456789")
 *             .billingAccount("000000-0000000-0000000-000000")
 *             .build());
 *         var test_account = new Account("test-account", AccountArgs.builder()
 *             .accountId("svc-acc")
 *             .displayName("Test Service Account")
 *             .project(project.projectId())
 *             .build());
 *         var example = new DenyPolicy("example", DenyPolicyArgs.builder()
 *             .parent(StdFunctions.urlencode().applyValue(invoke -> invoke.result()))
 *             .name("my-deny-policy")
 *             .displayName("A deny rule")
 *             .rules(
 *                 DenyPolicyRuleArgs.builder()
 *                     .description("First rule")
 *                     .denyRule(DenyPolicyRuleDenyRuleArgs.builder()
 *                         .deniedPrincipals("principalSet://goog/public:all")
 *                         .denialCondition(DenyPolicyRuleDenyRuleDenialConditionArgs.builder()
 *                             .title("Some expr")
 *                             .expression("!resource.matchTag('12345678/env', 'test')")
 *                             .build())
 *                         .deniedPermissions("cloudresourcemanager.googleapis.com/projects.update")
 *                         .build())
 *                     .build(),
 *                 DenyPolicyRuleArgs.builder()
 *                     .description("Second rule")
 *                     .denyRule(DenyPolicyRuleDenyRuleArgs.builder()
 *                         .deniedPrincipals("principalSet://goog/public:all")
 *                         .denialCondition(DenyPolicyRuleDenyRuleDenialConditionArgs.builder()
 *                             .title("Some expr")
 *                             .expression("!resource.matchTag('12345678/env', 'test')")
 *                             .build())
 *                         .deniedPermissions("cloudresourcemanager.googleapis.com/projects.update")
 *                         .exceptionPrincipals(test_account.email().applyValue(email -> String.format("principal://iam.googleapis.com/projects/-/serviceAccounts/%s", email)))
 *                         .build())
 *                     .build())
 *             .build());
 *     }
 * }
 * ```
 * ```yaml
 * resources:
 *   project:
 *     type: gcp:organizations:Project
 *     properties:
 *       projectId: my-project
 *       name: my-project
 *       orgId: '123456789'
 *       billingAccount: 000000-0000000-0000000-000000
 *   example:
 *     type: gcp:iam:DenyPolicy
 *     properties:
 *       parent:
 *         fn::invoke:
 *           Function: std:urlencode
 *           Arguments:
 *             input: cloudresourcemanager.googleapis.com/projects/${project.projectId}
 *           Return: result
 *       name: my-deny-policy
 *       displayName: A deny rule
 *       rules:
 *         - description: First rule
 *           denyRule:
 *             deniedPrincipals:
 *               - principalSet://goog/public:all
 *             denialCondition:
 *               title: Some expr
 *               expression: '!resource.matchTag(''12345678/env'', ''test'')'
 *             deniedPermissions:
 *               - cloudresourcemanager.googleapis.com/projects.update
 *         - description: Second rule
 *           denyRule:
 *             deniedPrincipals:
 *               - principalSet://goog/public:all
 *             denialCondition:
 *               title: Some expr
 *               expression: '!resource.matchTag(''12345678/env'', ''test'')'
 *             deniedPermissions:
 *               - cloudresourcemanager.googleapis.com/projects.update
 *             exceptionPrincipals:
 *               - principal://iam.googleapis.com/projects/-/serviceAccounts/${["test-account"].email}
 *   test-account:
 *     type: gcp:serviceaccount:Account
 *     properties:
 *       accountId: svc-acc
 *       displayName: Test Service Account
 *       project: ${project.projectId}
 * ```
 * 
 * ## Import
 * DenyPolicy can be imported using any of these accepted formats:
 * * `{{parent}}/{{name}}`
 * When using the `pulumi import` command, DenyPolicy can be imported using one of the formats above. For example:
 * ```sh
 * $ pulumi import gcp:iam/denyPolicy:DenyPolicy default {{parent}}/{{name}}
 * ```
 */
public class DenyPolicy internal constructor(
    override val javaResource: com.pulumi.gcp.iam.DenyPolicy,
) : KotlinCustomResource(javaResource, DenyPolicyMapper) {
    /**
     * The display name of the rule.
     */
    public val displayName: Output?
        get() = javaResource.displayName().applyValue({ args0 ->
            args0.map({ args0 ->
                args0
            }).orElse(null)
        })

    /**
     * The hash of the resource. Used internally during updates.
     */
    public val etag: Output
        get() = javaResource.etag().applyValue({ args0 -> args0 })

    /**
     * The name of the policy.
     */
    public val name: Output
        get() = javaResource.name().applyValue({ args0 -> args0 })

    /**
     * The attachment point is identified by its URL-encoded full resource name.
     */
    public val parent: Output
        get() = javaResource.parent().applyValue({ args0 -> args0 })

    /**
     * Rules to be applied.
     * Structure is documented below.
     */
    public val rules: Output>
        get() = javaResource.rules().applyValue({ args0 ->
            args0.map({ args0 ->
                args0.let({ args0 ->
                    toKotlin(args0)
                })
            })
        })
}

public object DenyPolicyMapper : ResourceMapper {
    override fun supportsMappingOfType(javaResource: Resource): Boolean =
        com.pulumi.gcp.iam.DenyPolicy::class == javaResource::class

    override fun map(javaResource: Resource): DenyPolicy = DenyPolicy(
        javaResource as
            com.pulumi.gcp.iam.DenyPolicy,
    )
}

/**
 * @see [DenyPolicy].
 * @param name The _unique_ name of the resulting resource.
 * @param block Builder for [DenyPolicy].
 */
public suspend fun denyPolicy(name: String, block: suspend DenyPolicyResourceBuilder.() -> Unit): DenyPolicy {
    val builder = DenyPolicyResourceBuilder()
    builder.name(name)
    block(builder)
    return builder.build()
}

/**
 * @see [DenyPolicy].
 * @param name The _unique_ name of the resulting resource.
 */
public fun denyPolicy(name: String): DenyPolicy {
    val builder = DenyPolicyResourceBuilder()
    builder.name(name)
    return builder.build()
}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy