com.pulumi.kubernetes.resource.v1alpha3.kotlin.ResourceSlicePatchArgs.kt Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of pulumi-kubernetes-kotlin Show documentation
Build cloud applications and infrastructure by combining the safety and reliability of infrastructure as code with the power of the Kotlin programming language.
The newest version!
@file:Suppress("NAME_SHADOWING", "DEPRECATION")

package com.pulumi.kubernetes.resource.v1alpha3.kotlin

import com.pulumi.core.Output
import com.pulumi.core.Output.of
import com.pulumi.kotlin.ConvertibleToJava
import com.pulumi.kotlin.PulumiTagMarker
import com.pulumi.kotlin.applySuspend
import com.pulumi.kubernetes.meta.v1.kotlin.inputs.ObjectMetaPatchArgs
import com.pulumi.kubernetes.meta.v1.kotlin.inputs.ObjectMetaPatchArgsBuilder
import com.pulumi.kubernetes.resource.v1alpha3.ResourceSlicePatchArgs.builder
import com.pulumi.kubernetes.resource.v1alpha3.kotlin.inputs.ResourceSliceSpecPatchArgs
import com.pulumi.kubernetes.resource.v1alpha3.kotlin.inputs.ResourceSliceSpecPatchArgsBuilder
import kotlin.String
import kotlin.Suppress
import kotlin.Unit
import kotlin.jvm.JvmName

/**
 * Patch resources are used to modify existing Kubernetes resources by using
 * Server-Side Apply updates. The name of the resource must be specified, but all other properties are optional. More than
 * one patch may be applied to the same resource, and a random FieldManager name will be used for each Patch resource.
 * Conflicts will result in an error by default, but can be forced using the "pulumi.com/patchForce" annotation. See the
 * [Server-Side Apply Docs](https://www.pulumi.com/registry/packages/kubernetes/how-to-guides/managing-resources-with-server-side-apply/) for
 * additional information about using Server-Side Apply to manage Kubernetes resources with Pulumi.
 * ResourceSlice represents one or more resources in a pool of similar resources, managed by a common driver. A pool may span more than one ResourceSlice, and exactly how many ResourceSlices comprise a pool is determined by the driver.
 * At the moment, the only supported resources are devices with attributes and capacities. Each device in a given pool, regardless of how many ResourceSlices, must have a unique name. The ResourceSlice in which a device gets published may change over time. The unique identifier for a device is the tuple , , .
 * Whenever a driver needs to update a pool, it increments the pool.Spec.Pool.Generation number and updates all ResourceSlices with that new number and new resource definitions. A consumer must only use ResourceSlices with the highest generation number and ignore all others.
 * When allocating all resources in a pool matching certain criteria or when looking for the best solution among several different alternatives, a consumer should check the number of ResourceSlices in a pool (included in each ResourceSlice) to determine whether its view of a pool is complete and if not, should wait until the driver has completed updating the pool.
 * For resources that are not local to a node, the node name is not set. Instead, the driver may use a node selector to specify where the devices are available.
 * This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.
 * @property apiVersion APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
 * @property kind Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
 * @property metadata Standard object metadata
 * @property spec Contains the information published by the driver.
 * Changing the spec automatically increments the metadata.generation number.
 */
public data class ResourceSlicePatchArgs(
    public val apiVersion: Output? = null,
    public val kind: Output? = null,
    public val metadata: Output? = null,
    public val spec: Output? = null,
) : ConvertibleToJava {
    override fun toJava(): com.pulumi.kubernetes.resource.v1alpha3.ResourceSlicePatchArgs =
        com.pulumi.kubernetes.resource.v1alpha3.ResourceSlicePatchArgs.builder()
            .apiVersion(apiVersion?.applyValue({ args0 -> args0 }))
            .kind(kind?.applyValue({ args0 -> args0 }))
            .metadata(metadata?.applyValue({ args0 -> args0.let({ args0 -> args0.toJava() }) }))
            .spec(spec?.applyValue({ args0 -> args0.let({ args0 -> args0.toJava() }) })).build()
}

/**
 * Builder for [ResourceSlicePatchArgs].
 */
@PulumiTagMarker
public class ResourceSlicePatchArgsBuilder internal constructor() {
    private var apiVersion: Output? = null

    private var kind: Output? = null

    private var metadata: Output? = null

    private var spec: Output? = null

    /**
     * @param value APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
     */
    @JvmName("uarldaknauolhsoq")
    public suspend fun apiVersion(`value`: Output) {
        this.apiVersion = value
    }

    /**
     * @param value Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
     */
    @JvmName("yohwclnjcddddpys")
    public suspend fun kind(`value`: Output) {
        this.kind = value
    }

    /**
     * @param value Standard object metadata
     */
    @JvmName("vvibmmbbvvsddkws")
    public suspend fun metadata(`value`: Output) {
        this.metadata = value
    }

    /**
     * @param value Contains the information published by the driver.
     * Changing the spec automatically increments the metadata.generation number.
     */
    @JvmName("ucsgwfhiuspuhxkm")
    public suspend fun spec(`value`: Output) {
        this.spec = value
    }

    /**
     * @param value APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
     */
    @JvmName("hpmpyairpiwmheqn")
    public suspend fun apiVersion(`value`: String?) {
        val toBeMapped = value
        val mapped = toBeMapped?.let({ args0 -> of(args0) })
        this.apiVersion = mapped
    }

    /**
     * @param value Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
     */
    @JvmName("sedvtthjpjsugoyn")
    public suspend fun kind(`value`: String?) {
        val toBeMapped = value
        val mapped = toBeMapped?.let({ args0 -> of(args0) })
        this.kind = mapped
    }

    /**
     * @param value Standard object metadata
     */
    @JvmName("nlcxfkehrbfaoncj")
    public suspend fun metadata(`value`: ObjectMetaPatchArgs?) {
        val toBeMapped = value
        val mapped = toBeMapped?.let({ args0 -> of(args0) })
        this.metadata = mapped
    }

    /**
     * @param argument Standard object metadata
     */
    @JvmName("ekfoxttylbriyfni")
    public suspend fun metadata(argument: suspend ObjectMetaPatchArgsBuilder.() -> Unit) {
        val toBeMapped = ObjectMetaPatchArgsBuilder().applySuspend { argument() }.build()
        val mapped = of(toBeMapped)
        this.metadata = mapped
    }

    /**
     * @param value Contains the information published by the driver.
     * Changing the spec automatically increments the metadata.generation number.
     */
    @JvmName("iykecpdmfvthyfdx")
    public suspend fun spec(`value`: ResourceSliceSpecPatchArgs?) {
        val toBeMapped = value
        val mapped = toBeMapped?.let({ args0 -> of(args0) })
        this.spec = mapped
    }

    /**
     * @param argument Contains the information published by the driver.
     * Changing the spec automatically increments the metadata.generation number.
     */
    @JvmName("ilikdtybogkhcubb")
    public suspend fun spec(argument: suspend ResourceSliceSpecPatchArgsBuilder.() -> Unit) {
        val toBeMapped = ResourceSliceSpecPatchArgsBuilder().applySuspend { argument() }.build()
        val mapped = of(toBeMapped)
        this.spec = mapped
    }

    internal fun build(): ResourceSlicePatchArgs = ResourceSlicePatchArgs(
        apiVersion = apiVersion,
        kind = kind,
        metadata = metadata,
        spec = spec,
    )
}