import * as pulumi from "@pulumi/pulumi"; /** * The `vsphere.StorageDrsVmOverride` resource can be used to add a Storage DRS * override to a datastore cluster for a specific virtual machine. With this * resource, one can enable or disable Storage DRS, and control the automation * level and disk affinity for a single virtual machine without affecting the rest * of the datastore cluster. * * For more information on vSphere datastore clusters and Storage DRS, see [this * page][ref-vsphere-datastore-clusters]. * * [ref-vsphere-datastore-clusters]: https://techdocs.broadcom.com/us/en/vmware-cis/vsphere/vsphere/8-0/vsphere-resource-management-8-0/creating-a-datastore-cluster.html * * ## Example Usage * * The example below builds on the [Storage DRS * example][tf-vsphere-vm-storage-drs-example] in the `vsphere.VirtualMachine` * resource. However, rather than use the output of the * [`vsphere.DatastoreCluster` data * source][tf-vsphere-datastore-cluster-data-source] for the location of the * virtual machine, we instead get what is assumed to be a member datastore using * the [`vsphere.getDatastore` data source][tf-vsphere-datastore-data-source] and put * the virtual machine there instead. We then use the * `vsphere.StorageDrsVmOverride` resource to ensure that Storage DRS does not * apply to this virtual machine, and hence the VM will never be migrated off of * the datastore. * * [tf-vsphere-vm-storage-drs-example]: /docs/providers/vsphere/r/virtual_machine.html#using-storage-drs * [tf-vsphere-datastore-cluster-data-source]: /docs/providers/vsphere/d/datastore_cluster.html * [tf-vsphere-datastore-data-source]: /docs/providers/vsphere/d/datastore.html * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as vsphere from "@pulumi/vsphere"; * * const datacenter = vsphere.getDatacenter({ * name: "dc-01", * }); * const datastoreCluster = datacenter.then(datacenter => vsphere.getDatastoreCluster({ * name: "datastore-cluster1", * datacenterId: datacenter.id, * })); * const memberDatastore = datacenter.then(datacenter => vsphere.getDatastore({ * name: "datastore-cluster1-member1", * datacenterId: datacenter.id, * })); * const pool = datacenter.then(datacenter => vsphere.getResourcePool({ * name: "cluster1/Resources", * datacenterId: datacenter.id, * })); * const network = datacenter.then(datacenter => vsphere.getNetwork({ * name: "public", * datacenterId: datacenter.id, * })); * const vm = new vsphere.VirtualMachine("vm", { * name: "pulumi-test", * resourcePoolId: pool.then(pool => pool.id), * datastoreId: memberDatastore.then(memberDatastore => memberDatastore.id), * numCpus: 2, * memory: 1024, * guestId: "otherLinux64Guest", * networkInterfaces: [{ * networkId: network.then(network => network.id), * }], * disks: [{ * label: "disk0", * size: 20, * }], * }); * const drsVmOverride = new vsphere.StorageDrsVmOverride("drs_vm_override", { * datastoreClusterId: datastoreCluster.then(datastoreCluster => datastoreCluster.id), * virtualMachineId: vm.id, * sdrsEnabled: "false", * }); * ``` * * ## Import * * An existing override can be imported into this resource by * supplying both the path to the datastore cluster and the path to the virtual * machine to `pulumi import`. If no override exists, an error will be given. * An example is below: * * [docs-import]: https://developer.hashicorp.com/terraform/cli/import * * ```sh * terraform import vsphere_storage_drs_vm_override.drs_vm_override \ * '{"datastore_cluster_path": "/dc1/datastore/ds-cluster", \ * "virtual_machine_path": "/dc1/vm/srv1"}' * ``` */ export declare class StorageDrsVmOverride extends pulumi.CustomResource { /** * Get an existing StorageDrsVmOverride 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 state Any extra arguments used during the lookup. * @param opts Optional settings to control the behavior of the CustomResource. */ static get(name: string, id: pulumi.Input, state?: StorageDrsVmOverrideState, opts?: pulumi.CustomResourceOptions): StorageDrsVmOverride; /** * Returns true if the given object is an instance of StorageDrsVmOverride. 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 StorageDrsVmOverride; /** * The [managed object reference * ID][docs-about-morefs] of the datastore cluster to put the override in. * Forces a new resource if changed. * * [docs-about-morefs]: /docs/providers/vsphere/index.html#use-of-managed-object-references-by-the-vsphere-provider */ readonly datastoreClusterId: pulumi.Output; /** * Overrides any Storage DRS automation * levels for this virtual machine. Can be one of `automated` or `manual`. When * not specified, the datastore cluster's settings are used according to the * [specific SDRS subsystem][tf-vsphere-datastore-cluster-sdrs-levels]. * * [tf-vsphere-datastore-cluster-sdrs-levels]: /docs/providers/vsphere/r/datastore_cluster.html#storage-drs-automation-options */ readonly sdrsAutomationLevel: pulumi.Output; /** * Overrides the default Storage DRS setting for * this virtual machine. When not specified, the datastore cluster setting is * used. */ readonly sdrsEnabled: pulumi.Output; /** * Overrides the intra-VM affinity setting * for this virtual machine. When `true`, all disks for this virtual machine * will be kept on the same datastore. When `false`, Storage DRS may locate * individual disks on different datastores if it helps satisfy cluster * requirements. When not specified, the datastore cluster's settings are used. */ readonly sdrsIntraVmAffinity: pulumi.Output; /** * The UUID of the virtual machine to create * the override for. Forces a new resource if changed. */ readonly virtualMachineId: pulumi.Output; /** * Create a StorageDrsVmOverride 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: StorageDrsVmOverrideArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering StorageDrsVmOverride resources. */ export interface StorageDrsVmOverrideState { /** * The [managed object reference * ID][docs-about-morefs] of the datastore cluster to put the override in. * Forces a new resource if changed. * * [docs-about-morefs]: /docs/providers/vsphere/index.html#use-of-managed-object-references-by-the-vsphere-provider */ datastoreClusterId?: pulumi.Input; /** * Overrides any Storage DRS automation * levels for this virtual machine. Can be one of `automated` or `manual`. When * not specified, the datastore cluster's settings are used according to the * [specific SDRS subsystem][tf-vsphere-datastore-cluster-sdrs-levels]. * * [tf-vsphere-datastore-cluster-sdrs-levels]: /docs/providers/vsphere/r/datastore_cluster.html#storage-drs-automation-options */ sdrsAutomationLevel?: pulumi.Input; /** * Overrides the default Storage DRS setting for * this virtual machine. When not specified, the datastore cluster setting is * used. */ sdrsEnabled?: pulumi.Input; /** * Overrides the intra-VM affinity setting * for this virtual machine. When `true`, all disks for this virtual machine * will be kept on the same datastore. When `false`, Storage DRS may locate * individual disks on different datastores if it helps satisfy cluster * requirements. When not specified, the datastore cluster's settings are used. */ sdrsIntraVmAffinity?: pulumi.Input; /** * The UUID of the virtual machine to create * the override for. Forces a new resource if changed. */ virtualMachineId?: pulumi.Input; } /** * The set of arguments for constructing a StorageDrsVmOverride resource. */ export interface StorageDrsVmOverrideArgs { /** * The [managed object reference * ID][docs-about-morefs] of the datastore cluster to put the override in. * Forces a new resource if changed. * * [docs-about-morefs]: /docs/providers/vsphere/index.html#use-of-managed-object-references-by-the-vsphere-provider */ datastoreClusterId: pulumi.Input; /** * Overrides any Storage DRS automation * levels for this virtual machine. Can be one of `automated` or `manual`. When * not specified, the datastore cluster's settings are used according to the * [specific SDRS subsystem][tf-vsphere-datastore-cluster-sdrs-levels]. * * [tf-vsphere-datastore-cluster-sdrs-levels]: /docs/providers/vsphere/r/datastore_cluster.html#storage-drs-automation-options */ sdrsAutomationLevel?: pulumi.Input; /** * Overrides the default Storage DRS setting for * this virtual machine. When not specified, the datastore cluster setting is * used. */ sdrsEnabled?: pulumi.Input; /** * Overrides the intra-VM affinity setting * for this virtual machine. When `true`, all disks for this virtual machine * will be kept on the same datastore. When `false`, Storage DRS may locate * individual disks on different datastores if it helps satisfy cluster * requirements. When not specified, the datastore cluster's settings are used. */ sdrsIntraVmAffinity?: pulumi.Input; /** * The UUID of the virtual machine to create * the override for. Forces a new resource if changed. */ virtualMachineId: pulumi.Input; }