@pulumi/kubernetes
Version:
[](https://github.com/pulumi/pulumi-kubernetes/actions) [](https://slack.pulumi.com) [;
exports.ResourceSlice = void 0;
const pulumi = require("@pulumi/pulumi");
const utilities = require("../../utilities");
/**
* 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.
*/
class ResourceSlice extends pulumi.CustomResource {
/**
* Get an existing ResourceSlice 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, id, opts) {
return new ResourceSlice(name, undefined, { ...opts, id: id });
}
/**
* Returns true if the given object is an instance of ResourceSlice. 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'] === ResourceSlice.__pulumiType;
}
/**
* Create a ResourceSlice 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, args, opts) {
let resourceInputs = {};
opts = opts || {};
if (!opts.id) {
if (args?.spec === undefined && !opts.urn) {
throw new Error("Missing required property 'spec'");
}
resourceInputs["apiVersion"] = "resource.k8s.io/v1beta1";
resourceInputs["kind"] = "ResourceSlice";
resourceInputs["metadata"] = args?.metadata;
resourceInputs["spec"] = args?.spec;
}
else {
resourceInputs["apiVersion"] = undefined /*out*/;
resourceInputs["kind"] = undefined /*out*/;
resourceInputs["metadata"] = undefined /*out*/;
resourceInputs["spec"] = undefined /*out*/;
}
opts = pulumi.mergeOptions(utilities.resourceOptsDefaults(), opts);
const aliasOpts = { aliases: [{ type: "kubernetes:resource.k8s.io/v1alpha2:ResourceSlice" }, { type: "kubernetes:resource.k8s.io/v1alpha3:ResourceSlice" }, { type: "kubernetes:resource.k8s.io/v1beta2:ResourceSlice" }] };
opts = pulumi.mergeOptions(opts, aliasOpts);
super(ResourceSlice.__pulumiType, name, resourceInputs, opts);
}
}
exports.ResourceSlice = ResourceSlice;
/** @internal */
ResourceSlice.__pulumiType = 'kubernetes:resource.k8s.io/v1beta1:ResourceSlice';
//# sourceMappingURL=resourceSlice.js.map