UNPKG

@pulumi/kubernetes

Version:

[![Actions Status](https://github.com/pulumi/pulumi-kubernetes/workflows/main/badge.svg)](https://github.com/pulumi/pulumi-kubernetes/actions) [![Slack](http://www.pulumi.com/images/docs/badges/slack.svg)](https://slack.pulumi.com) [![NPM version](https:/

88 lines (87 loc) 5.9 kB
import * as pulumi from "@pulumi/pulumi"; import * as inputs from "../../types/input"; import * as outputs from "../../types/output"; /** * 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 <driver name>, <pool name>, <device name>. * * 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. */ export declare class ResourceSlicePatch extends pulumi.CustomResource { /** * Get an existing ResourceSlicePatch 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 opts Optional settings to control the behavior of the CustomResource. */ static get(name: string, id: pulumi.Input<pulumi.ID>, opts?: pulumi.CustomResourceOptions): ResourceSlicePatch; /** * Returns true if the given object is an instance of ResourceSlicePatch. 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 ResourceSlicePatch; /** * 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 */ readonly apiVersion: pulumi.Output<"resource.k8s.io/v1beta1">; /** * 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 */ readonly kind: pulumi.Output<"ResourceSlice">; /** * Standard object metadata */ readonly metadata: pulumi.Output<outputs.meta.v1.ObjectMetaPatch>; /** * Contains the information published by the driver. * * Changing the spec automatically increments the metadata.generation number. */ readonly spec: pulumi.Output<outputs.resource.v1beta1.ResourceSliceSpecPatch>; /** * Create a ResourceSlicePatch 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?: ResourceSlicePatchArgs, opts?: pulumi.CustomResourceOptions); } /** * The set of arguments for constructing a ResourceSlicePatch resource. */ export interface ResourceSlicePatchArgs { /** * 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 */ apiVersion?: pulumi.Input<"resource.k8s.io/v1beta1">; /** * 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 */ kind?: pulumi.Input<"ResourceSlice">; /** * Standard object metadata */ metadata?: pulumi.Input<inputs.meta.v1.ObjectMetaPatch>; /** * Contains the information published by the driver. * * Changing the spec automatically increments the metadata.generation number. */ spec?: pulumi.Input<inputs.resource.v1beta1.ResourceSliceSpecPatch>; }