com.pulumi.kubernetes.resource.v1alpha3.ResourceSlice Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of kubernetes Show documentation
Show all versions of kubernetes Show documentation
A Pulumi package for creating and managing Kubernetes resources.
// *** WARNING: this file was generated by pulumi-java-gen. ***
// *** Do not edit by hand unless you're certain you know what you are doing! ***
package com.pulumi.kubernetes.resource.v1alpha3;
import com.pulumi.core.Alias;
import com.pulumi.core.Output;
import com.pulumi.core.annotations.Export;
import com.pulumi.core.annotations.ResourceType;
import com.pulumi.core.internal.Codegen;
import com.pulumi.kubernetes.Utilities;
import com.pulumi.kubernetes.meta.v1.outputs.ObjectMeta;
import com.pulumi.kubernetes.resource.v1alpha3.ResourceSliceArgs;
import com.pulumi.kubernetes.resource.v1alpha3.outputs.ResourceSliceSpec;
import java.lang.String;
import java.util.List;
import javax.annotation.Nullable;
/**
* 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.
*
*/
@ResourceType(type="kubernetes:resource.k8s.io/v1alpha3:ResourceSlice")
public class ResourceSlice extends com.pulumi.resources.CustomResource {
/**
* 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
*
*/
@Export(name="apiVersion", refs={String.class}, tree="[0]")
private Output apiVersion;
/**
* @return 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
*
*/
public Output apiVersion() {
return this.apiVersion;
}
/**
* 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
*
*/
@Export(name="kind", refs={String.class}, tree="[0]")
private Output kind;
/**
* @return 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
*
*/
public Output kind() {
return this.kind;
}
/**
* Standard object metadata
*
*/
@Export(name="metadata", refs={ObjectMeta.class}, tree="[0]")
private Output metadata;
/**
* @return Standard object metadata
*
*/
public Output metadata() {
return this.metadata;
}
/**
* Contains the information published by the driver.
*
* Changing the spec automatically increments the metadata.generation number.
*
*/
@Export(name="spec", refs={ResourceSliceSpec.class}, tree="[0]")
private Output spec;
/**
* @return Contains the information published by the driver.
*
* Changing the spec automatically increments the metadata.generation number.
*
*/
public Output spec() {
return this.spec;
}
/**
*
* @param name The _unique_ name of the resulting resource.
*/
public ResourceSlice(String name) {
this(name, ResourceSliceArgs.Empty);
}
/**
*
* @param name The _unique_ name of the resulting resource.
* @param args The arguments to use to populate this resource's properties.
*/
public ResourceSlice(String name, ResourceSliceArgs args) {
this(name, args, null);
}
/**
*
* @param name The _unique_ name of the resulting resource.
* @param args The arguments to use to populate this resource's properties.
* @param options A bag of options that control this resource's behavior.
*/
public ResourceSlice(String name, ResourceSliceArgs args, @Nullable com.pulumi.resources.CustomResourceOptions options) {
super("kubernetes:resource.k8s.io/v1alpha3:ResourceSlice", name, makeArgs(args, options), makeResourceOptions(options, Codegen.empty()));
}
private ResourceSlice(String name, Output id, @Nullable com.pulumi.resources.CustomResourceOptions options) {
super("kubernetes:resource.k8s.io/v1alpha3:ResourceSlice", name, null, makeResourceOptions(options, id));
}
private static ResourceSliceArgs makeArgs(ResourceSliceArgs args, @Nullable com.pulumi.resources.CustomResourceOptions options) {
if (options != null && options.getUrn().isPresent()) {
return null;
}
var builder = args == null ? ResourceSliceArgs.builder() : ResourceSliceArgs.builder(args);
return builder
.apiVersion("resource.k8s.io/v1alpha3")
.kind("ResourceSlice")
.build();
}
private static com.pulumi.resources.CustomResourceOptions makeResourceOptions(@Nullable com.pulumi.resources.CustomResourceOptions options, @Nullable Output id) {
var defaultOptions = com.pulumi.resources.CustomResourceOptions.builder()
.version(Utilities.getVersion())
.aliases(List.of(
Output.of(Alias.builder().type("kubernetes:resource.k8s.io/v1alpha2:ResourceSlice").build())
))
.build();
return com.pulumi.resources.CustomResourceOptions.merge(defaultOptions, options, id);
}
/**
* Get an existing Host 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 options Optional settings to control the behavior of the CustomResource.
*/
public static ResourceSlice get(String name, Output id, @Nullable com.pulumi.resources.CustomResourceOptions options) {
return new ResourceSlice(name, id, options);
}
}
© 2015 - 2024 Weber Informatics LLC | Privacy Policy