v1beta1

class pulumi_kubernetes.apps.v1beta1.ControllerRevision(resource_name, opts=None, revision=None, data=None, metadata=None, __name__=None, __opts__=None)

DEPRECATED - apps/v1beta1/ControllerRevision is not supported by Kubernetes 1.16+ clusters. Use apps/v1/ControllerRevision instead.

ControllerRevision implements an immutable snapshot of state data. Clients are responsible for serializing and deserializing the objects that contain their internal state. Once a ControllerRevision has been successfully created, it can not be updated. The API Server will fail validation of all requests that attempt to mutate the Data field. ControllerRevisions may, however, be deleted. Note that, due to its use by both the DaemonSet and StatefulSet controllers for update and rollback, this object is beta. However, it may be subject to name and representation changes in future releases, and clients should not depend on its stability. It is primarily for internal use by controllers.

Create a ControllerRevision resource with the given unique name, arguments, and options.

Parameters
apiVersion = None

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/api-conventions.md#resources

kind = None

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/api-conventions.md#types-kinds

data = None

Data is the serialized representation of the state.

metadata = None

Standard object’s metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

revision = None

Revision indicates the revision of the state represented by Data.

static get(resource_name, id, opts=None)

Get the state of an existing ControllerRevision resource, as identified by id. The ID is of the form [namespace]/[name]; if [namespace] is omitted, then (per Kubernetes convention) the ID becomes default/[name].

Pulumi will keep track of this resource using resource_name as the Pulumi ID.

Parameters
  • resource_name (str) – Unique name used to register this resource with Pulumi.

  • id (pulumi.Input[str]) – An ID for the Kubernetes resource to retrieve. Takes the form [namespace]/[name] or [name].

  • opts (Optional[pulumi.ResourceOptions]) – A bag of options that control this resource’s behavior.

translate_output_property(prop: str) → str

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop: str) → str

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

class pulumi_kubernetes.apps.v1beta1.ControllerRevisionList(resource_name, opts=None, items=None, metadata=None, __name__=None, __opts__=None)

ControllerRevisionList is a resource containing a list of ControllerRevision objects.

Create a ControllerRevisionList resource with the given unique name, arguments, and options.

Parameters
apiVersion = None

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/api-conventions.md#resources

kind = None

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/api-conventions.md#types-kinds

items = None

Items is the list of ControllerRevisions

metadata = None

More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

static get(resource_name, id, opts=None)

Get the state of an existing ControllerRevisionList resource, as identified by id. The ID is of the form [namespace]/[name]; if [namespace] is omitted, then (per Kubernetes convention) the ID becomes default/[name].

Pulumi will keep track of this resource using resource_name as the Pulumi ID.

Parameters
  • resource_name (str) – Unique name used to register this resource with Pulumi.

  • id (pulumi.Input[str]) – An ID for the Kubernetes resource to retrieve. Takes the form [namespace]/[name] or [name].

  • opts (Optional[pulumi.ResourceOptions]) – A bag of options that control this resource’s behavior.

translate_output_property(prop: str) → str

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop: str) → str

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

class pulumi_kubernetes.apps.v1beta1.Deployment(resource_name, opts=None, metadata=None, spec=None, __name__=None, __opts__=None)

DEPRECATED - apps/v1beta1/Deployment is not supported by Kubernetes 1.16+ clusters. Use apps/v1/Deployment instead.

Deployment enables declarative updates for Pods and ReplicaSets.

This resource waits until it is ready before registering success for create/update and populating output properties from the current state of the resource. The following conditions are used to determine whether the resource creation has succeeded or failed:

  1. The Deployment has begun to be updated by the Deployment controller. If the current generation of the Deployment is > 1, then this means that the current generation must be different from the generation reported by the last outputs.

  2. There exists a ReplicaSet whose revision is equal to the current revision of the Deployment.

  3. The Deployment’s ‘.status.conditions’ has a status of type ‘Available’ whose ‘status’ member is set to ‘True’.

  4. If the Deployment has generation > 1, then ‘.status.conditions’ has a status of type ‘Progressing’, whose ‘status’ member is set to ‘True’, and whose ‘reason’ is ‘NewReplicaSetAvailable’. For generation <= 1, this status field does not exist, because it doesn’t do a rollout (i.e., it simply creates the Deployment and corresponding ReplicaSet), and therefore there is no rollout to mark as ‘Progressing’.

If the Deployment has not reached a Ready state after 5 minutes, it will time out and mark the resource update as Failed. You can override the default timeout value by setting the ‘customTimeouts’ option on the resource. Note that the timeout value for Delete is not yet supported. See https://github.com/pulumi/pulumi-kubernetes/issues/746 for details.

Create a Deployment resource with the given unique name, arguments, and options.

Parameters
  • resource_name (str) – The unique name of the resource.

  • opts (pulumi.ResourceOptions) – A bag of options that control this resource’s behavior.

  • metadata (pulumi.Input[dict]) – Standard object metadata.

  • spec (pulumi.Input[dict]) – Specification of the desired behavior of the Deployment.

apiVersion = None

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/api-conventions.md#resources

kind = None

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/api-conventions.md#types-kinds

metadata = None

Standard object metadata.

spec = None

Specification of the desired behavior of the Deployment.

status = None

Most recently observed status of the Deployment.

static get(resource_name, id, opts=None)

Get the state of an existing Deployment resource, as identified by id. The ID is of the form [namespace]/[name]; if [namespace] is omitted, then (per Kubernetes convention) the ID becomes default/[name].

Pulumi will keep track of this resource using resource_name as the Pulumi ID.

Parameters
  • resource_name (str) – Unique name used to register this resource with Pulumi.

  • id (pulumi.Input[str]) – An ID for the Kubernetes resource to retrieve. Takes the form [namespace]/[name] or [name].

  • opts (Optional[pulumi.ResourceOptions]) – A bag of options that control this resource’s behavior.

translate_output_property(prop: str) → str

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop: str) → str

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

class pulumi_kubernetes.apps.v1beta1.DeploymentList(resource_name, opts=None, items=None, metadata=None, __name__=None, __opts__=None)

DeploymentList is a list of Deployments.

Create a DeploymentList resource with the given unique name, arguments, and options.

Parameters
  • resource_name (str) – The unique name of the resource.

  • opts (pulumi.ResourceOptions) – A bag of options that control this resource’s behavior.

  • items (pulumi.Input[list]) – Items is the list of Deployments.

  • metadata (pulumi.Input[dict]) – Standard list metadata.

apiVersion = None

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/api-conventions.md#resources

kind = None

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/api-conventions.md#types-kinds

items = None

Items is the list of Deployments.

metadata = None

Standard list metadata.

static get(resource_name, id, opts=None)

Get the state of an existing DeploymentList resource, as identified by id. The ID is of the form [namespace]/[name]; if [namespace] is omitted, then (per Kubernetes convention) the ID becomes default/[name].

Pulumi will keep track of this resource using resource_name as the Pulumi ID.

Parameters
  • resource_name (str) – Unique name used to register this resource with Pulumi.

  • id (pulumi.Input[str]) – An ID for the Kubernetes resource to retrieve. Takes the form [namespace]/[name] or [name].

  • opts (Optional[pulumi.ResourceOptions]) – A bag of options that control this resource’s behavior.

translate_output_property(prop: str) → str

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop: str) → str

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

class pulumi_kubernetes.apps.v1beta1.StatefulSet(resource_name, opts=None, metadata=None, spec=None, __name__=None, __opts__=None)

DEPRECATED - apps/v1beta1/StatefulSet is not supported by Kubernetes 1.16+ clusters. Use apps/v1/StatefulSet instead.

StatefulSet represents a set of pods with consistent identities. Identities are defined as:

  • Network: A single stable DNS and hostname.

  • Storage: As many VolumeClaims as requested. The StatefulSet guarantees that a given network identity will always map to the same storage identity.

This resource waits until it is ready before registering success for create/update and populating output properties from the current state of the resource. The following conditions are used to determine whether the resource creation has succeeded or failed:

  1. The value of ‘spec.replicas’ matches ‘.status.replicas’, ‘.status.currentReplicas’, and ‘.status.readyReplicas’.

  2. The value of ‘.status.updateRevision’ matches ‘.status.currentRevision’.

If the StatefulSet has not reached a Ready state after 5 minutes, it will time out and mark the resource update as Failed. You can override the default timeout value by setting the ‘customTimeouts’ option on the resource. Note that the timeout value for Delete is not yet supported. See https://github.com/pulumi/pulumi-kubernetes/issues/746 for details.

Create a StatefulSet resource with the given unique name, arguments, and options.

Parameters
  • resource_name (str) – The unique name of the resource.

  • opts (pulumi.ResourceOptions) – A bag of options that control this resource’s behavior.

  • metadata (pulumi.Input[dict]) –

  • spec (pulumi.Input[dict]) – Spec defines the desired identities of pods in this set.

apiVersion = None

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/api-conventions.md#resources

kind = None

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/api-conventions.md#types-kinds

spec = None

Spec defines the desired identities of pods in this set.

status = None

Status is the current status of Pods in this StatefulSet. This data may be out of date by some window of time.

static get(resource_name, id, opts=None)

Get the state of an existing StatefulSet resource, as identified by id. The ID is of the form [namespace]/[name]; if [namespace] is omitted, then (per Kubernetes convention) the ID becomes default/[name].

Pulumi will keep track of this resource using resource_name as the Pulumi ID.

Parameters
  • resource_name (str) – Unique name used to register this resource with Pulumi.

  • id (pulumi.Input[str]) – An ID for the Kubernetes resource to retrieve. Takes the form [namespace]/[name] or [name].

  • opts (Optional[pulumi.ResourceOptions]) – A bag of options that control this resource’s behavior.

translate_output_property(prop: str) → str

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop: str) → str

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

class pulumi_kubernetes.apps.v1beta1.StatefulSetList(resource_name, opts=None, items=None, metadata=None, __name__=None, __opts__=None)

StatefulSetList is a collection of StatefulSets.

Create a StatefulSetList resource with the given unique name, arguments, and options.

Parameters
  • resource_name (str) – The unique name of the resource.

  • opts (pulumi.ResourceOptions) – A bag of options that control this resource’s behavior.

  • items (pulumi.Input[list]) –

  • metadata (pulumi.Input[dict]) –

apiVersion = None

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/api-conventions.md#resources

kind = None

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/api-conventions.md#types-kinds

static get(resource_name, id, opts=None)

Get the state of an existing StatefulSetList resource, as identified by id. The ID is of the form [namespace]/[name]; if [namespace] is omitted, then (per Kubernetes convention) the ID becomes default/[name].

Pulumi will keep track of this resource using resource_name as the Pulumi ID.

Parameters
  • resource_name (str) – Unique name used to register this resource with Pulumi.

  • id (pulumi.Input[str]) – An ID for the Kubernetes resource to retrieve. Takes the form [namespace]/[name] or [name].

  • opts (Optional[pulumi.ResourceOptions]) – A bag of options that control this resource’s behavior.

translate_output_property(prop: str) → str

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop: str) → str

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str