com.pulumi.googlenative.managedidentities.v1alpha1.kotlin.PeeringIamPolicy.kt Maven / Gradle / Ivy

Go to download
@file:Suppress("NAME_SHADOWING", "DEPRECATION")

package com.pulumi.googlenative.managedidentities.v1alpha1.kotlin

import com.pulumi.core.Output
import com.pulumi.googlenative.managedidentities.v1alpha1.kotlin.outputs.BindingResponse
import com.pulumi.googlenative.managedidentities.v1alpha1.kotlin.outputs.BindingResponse.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.Int
import kotlin.String
import kotlin.Suppress
import kotlin.Unit
import kotlin.collections.List

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

    public var args: PeeringIamPolicyArgs = PeeringIamPolicyArgs()

    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 PeeringIamPolicyArgsBuilder.() -> Unit) {
        val builder = PeeringIamPolicyArgsBuilder()
        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(): PeeringIamPolicy {
        val builtJavaResource =
            com.pulumi.googlenative.managedidentities.v1alpha1.PeeringIamPolicy(
                this.name,
                this.args.toJava(),
                this.opts.toJava(),
            )
        return PeeringIamPolicy(builtJavaResource)
    }
}

/**
 * Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
 * Note - this resource's API doesn't support deletion. When deleted, the resource will persist
 * on Google Cloud even though it will be deleted from Pulumi state.
 */
public class PeeringIamPolicy internal constructor(
    override val javaResource: com.pulumi.googlenative.managedidentities.v1alpha1.PeeringIamPolicy,
) : KotlinCustomResource(javaResource, PeeringIamPolicyMapper) {
    /**
     * Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:[email protected]`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`.
     */
    public val bindings: Output>
        get() = javaResource.bindings().applyValue({ args0 ->
            args0.map({ args0 ->
                args0.let({ args0 ->
                    toKotlin(args0)
                })
            })
        })

    /**
     * `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost.
     */
    public val etag: Output
        get() = javaResource.etag().applyValue({ args0 -> args0 })

    public val peeringId: Output
        get() = javaResource.peeringId().applyValue({ args0 -> args0 })

    public val project: Output
        get() = javaResource.project().applyValue({ args0 -> args0 })

    /**
     * Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
     */
    public val version: Output
        get() = javaResource.version().applyValue({ args0 -> args0 })
}

public object PeeringIamPolicyMapper : ResourceMapper {
    override fun supportsMappingOfType(javaResource: Resource): Boolean =
        com.pulumi.googlenative.managedidentities.v1alpha1.PeeringIamPolicy::class == javaResource::class

    override fun map(javaResource: Resource): PeeringIamPolicy = PeeringIamPolicy(
        javaResource as
            com.pulumi.googlenative.managedidentities.v1alpha1.PeeringIamPolicy,
    )
}

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

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