diff --git a/patches/0001-fork.patch b/patches/0001-fork.patch index 7713dab7..bb34036e 100644 --- a/patches/0001-fork.patch +++ b/patches/0001-fork.patch @@ -2262,7 +2262,7 @@ index abf14afa..e73922f1 100644 override on subsequent plan and apply operations after the override has been created. diff --git a/website/docs/r/host.html.markdown b/website/docs/r/host.html.markdown -index 76ed5a66..9e513b7f 100644 +index 5a9422df..367a2d74 100644 --- a/website/docs/r/host.html.markdown +++ b/website/docs/r/host.html.markdown @@ -13,9 +13,9 @@ description: |- @@ -2570,10 +2570,10 @@ index bf6ef2b0..fa073b9e 100644 some other computed attributes may be out of date. * `capacity` - Maximum capacity of the datastore, in megabytes. diff --git a/website/docs/r/resource_pool.html.markdown b/website/docs/r/resource_pool.html.markdown -index dddfa111..352b9f64 100644 +index 084361b2..a0289e4a 100644 --- a/website/docs/r/resource_pool.html.markdown +++ b/website/docs/r/resource_pool.html.markdown -@@ -80,7 +80,7 @@ resource "vsphere_resource_pool" "resource_pool_child" { +@@ -116,7 +116,7 @@ resource "vsphere_resource_pool" "resource_pool" { The following arguments are supported: * `name` - (Required) The name of the resource pool. @@ -2582,7 +2582,7 @@ index dddfa111..352b9f64 100644 of the parent resource pool. This can be the root resource pool for a cluster or standalone host, or a resource pool itself. When moving a resource pool from one parent resource pool to another, both must share a common root -@@ -121,24 +121,18 @@ The following arguments are supported: +@@ -157,24 +157,18 @@ The following arguments are supported: descendants of the resource pool are scaled up or down when the shares of the resource pool are scaled up or down. Can be one of `disabled` or `scaleCpuAndMemoryShares`. Default: `disabled`. @@ -2919,7 +2919,7 @@ index 4f600605..9e875ab3 100644 directories that are a part of the `vmdk_path` parameter if they are missing. Default: `false`. diff --git a/website/docs/r/virtual_machine.html.markdown b/website/docs/r/virtual_machine.html.markdown -index 60e3e080..6b1575bc 100644 +index 7aaaee32..caeeac20 100644 --- a/website/docs/r/virtual_machine.html.markdown +++ b/website/docs/r/virtual_machine.html.markdown @@ -16,7 +16,7 @@ For details on working with virtual machines in VMware vSphere, please refer to diff --git a/provider/cmd/pulumi-resource-vsphere/schema.json b/provider/cmd/pulumi-resource-vsphere/schema.json index 8f55a969..59e0b2fe 100644 --- a/provider/cmd/pulumi-resource-vsphere/schema.json +++ b/provider/cmd/pulumi-resource-vsphere/schema.json @@ -6900,7 +6900,7 @@ } }, "vsphere:index/host:Host": { - "description": "Provides a VMware vSphere host resource. This represents an ESXi host that\ncan be used either as a member of a cluster or as a standalone host.\n\n## Example Usage\n\n### Create a standalone host\n\n\u003c!--Start PulumiCodeChooser --\u003e\n```typescript\nimport * as pulumi from \"@pulumi/pulumi\";\nimport * as vsphere from \"@pulumi/vsphere\";\n\nconst datacenter = vsphere.getDatacenter({\n name: \"dc-01\",\n});\nconst thumbprint = vsphere.getHostThumbprint({\n address: \"esx-01.example.com\",\n insecure: true,\n});\nconst esx_01 = new vsphere.Host(\"esx-01\", {\n hostname: \"esx-01.example.com\",\n username: \"root\",\n password: \"password\",\n license: \"00000-00000-00000-00000-00000\",\n thumbprint: thumbprint.then(thumbprint =\u003e thumbprint.id),\n datacenter: datacenter.then(datacenter =\u003e datacenter.id),\n});\n```\n```python\nimport pulumi\nimport pulumi_vsphere as vsphere\n\ndatacenter = vsphere.get_datacenter(name=\"dc-01\")\nthumbprint = vsphere.get_host_thumbprint(address=\"esx-01.example.com\",\n insecure=True)\nesx_01 = vsphere.Host(\"esx-01\",\n hostname=\"esx-01.example.com\",\n username=\"root\",\n password=\"password\",\n license=\"00000-00000-00000-00000-00000\",\n thumbprint=thumbprint.id,\n datacenter=datacenter.id)\n```\n```csharp\nusing System.Collections.Generic;\nusing System.Linq;\nusing Pulumi;\nusing VSphere = Pulumi.VSphere;\n\nreturn await Deployment.RunAsync(() =\u003e \n{\n var datacenter = VSphere.GetDatacenter.Invoke(new()\n {\n Name = \"dc-01\",\n });\n\n var thumbprint = VSphere.GetHostThumbprint.Invoke(new()\n {\n Address = \"esx-01.example.com\",\n Insecure = true,\n });\n\n var esx_01 = new VSphere.Host(\"esx-01\", new()\n {\n Hostname = \"esx-01.example.com\",\n Username = \"root\",\n Password = \"password\",\n License = \"00000-00000-00000-00000-00000\",\n Thumbprint = thumbprint.Apply(getHostThumbprintResult =\u003e getHostThumbprintResult.Id),\n Datacenter = datacenter.Apply(getDatacenterResult =\u003e getDatacenterResult.Id),\n });\n\n});\n```\n```go\npackage main\n\nimport (\n\t\"github.com/pulumi/pulumi-vsphere/sdk/v4/go/vsphere\"\n\t\"github.com/pulumi/pulumi/sdk/v3/go/pulumi\"\n)\n\nfunc main() {\n\tpulumi.Run(func(ctx *pulumi.Context) error {\n\t\tdatacenter, err := vsphere.LookupDatacenter(ctx, \u0026vsphere.LookupDatacenterArgs{\n\t\t\tName: pulumi.StringRef(\"dc-01\"),\n\t\t}, nil)\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t\tthumbprint, err := vsphere.GetHostThumbprint(ctx, \u0026vsphere.GetHostThumbprintArgs{\n\t\t\tAddress: \"esx-01.example.com\",\n\t\t\tInsecure: pulumi.BoolRef(true),\n\t\t}, nil)\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t\t_, err = vsphere.NewHost(ctx, \"esx-01\", \u0026vsphere.HostArgs{\n\t\t\tHostname: pulumi.String(\"esx-01.example.com\"),\n\t\t\tUsername: pulumi.String(\"root\"),\n\t\t\tPassword: pulumi.String(\"password\"),\n\t\t\tLicense: pulumi.String(\"00000-00000-00000-00000-00000\"),\n\t\t\tThumbprint: pulumi.String(thumbprint.Id),\n\t\t\tDatacenter: pulumi.String(datacenter.Id),\n\t\t})\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t\treturn nil\n\t})\n}\n```\n```java\npackage generated_program;\n\nimport com.pulumi.Context;\nimport com.pulumi.Pulumi;\nimport com.pulumi.core.Output;\nimport com.pulumi.vsphere.VsphereFunctions;\nimport com.pulumi.vsphere.inputs.GetDatacenterArgs;\nimport com.pulumi.vsphere.inputs.GetHostThumbprintArgs;\nimport com.pulumi.vsphere.Host;\nimport com.pulumi.vsphere.HostArgs;\nimport java.util.List;\nimport java.util.ArrayList;\nimport java.util.Map;\nimport java.io.File;\nimport java.nio.file.Files;\nimport java.nio.file.Paths;\n\npublic class App {\n public static void main(String[] args) {\n Pulumi.run(App::stack);\n }\n\n public static void stack(Context ctx) {\n final var datacenter = VsphereFunctions.getDatacenter(GetDatacenterArgs.builder()\n .name(\"dc-01\")\n .build());\n\n final var thumbprint = VsphereFunctions.getHostThumbprint(GetHostThumbprintArgs.builder()\n .address(\"esx-01.example.com\")\n .insecure(true)\n .build());\n\n var esx_01 = new Host(\"esx-01\", HostArgs.builder()\n .hostname(\"esx-01.example.com\")\n .username(\"root\")\n .password(\"password\")\n .license(\"00000-00000-00000-00000-00000\")\n .thumbprint(thumbprint.applyValue(getHostThumbprintResult -\u003e getHostThumbprintResult.id()))\n .datacenter(datacenter.applyValue(getDatacenterResult -\u003e getDatacenterResult.id()))\n .build());\n\n }\n}\n```\n```yaml\nresources:\n esx-01:\n type: vsphere:Host\n properties:\n hostname: esx-01.example.com\n username: root\n password: password\n license: 00000-00000-00000-00000-00000\n thumbprint: ${thumbprint.id}\n datacenter: ${datacenter.id}\nvariables:\n datacenter:\n fn::invoke:\n Function: vsphere:getDatacenter\n Arguments:\n name: dc-01\n thumbprint:\n fn::invoke:\n Function: vsphere:getHostThumbprint\n Arguments:\n address: esx-01.example.com\n insecure: true\n```\n\u003c!--End PulumiCodeChooser --\u003e\n\n## Import\n\nAn existing host can be imported into this resource by supplying\n\nthe host's ID.\n\n[docs-import]: /docs/import/index.html\n\nObtain the host's ID using the data source. For example:\n\nhcl\n\ndata \"vsphere_datacenter\" \"datacenter\" {\n\n name = \"dc-01\"\n\n}\n\ndata \"vsphere_host\" \"host\" {\n\n name = \"esx-01.example.com\"\n\n datacenter_id = data.vsphere_datacenter.datacenter.id\n\n}\n\noutput \"host_id\" {\n\n value = data.vsphere_host.host.id\n\n}\n\nNext, create a resource configuration, For example:\n\nhcl\n\ndata \"vsphere_datacenter\" \"datacenter\" {\n\n name = \"dc-01\"\n\n}\n\ndata \"vsphere_host_thumbprint\" \"thumbprint\" {\n\n address = \"esx-01.example.com\"\n\n insecure = true\n\n}\n\nresource \"vsphere_host\" \"esx-01\" {\n\n hostname = \"esx-01.example.com\"\n\n username = \"root\"\n\n password = \"password\"\n\n thumbprint = data.vsphere_host_thumbprint.thumbprint.id\n\n datacenter = data.vsphere_datacenter.datacenter.id\n\n}\n\nhcl\n\nresource \"vsphere_host\" \"esx-01\" {\n\n hostname = \"esx-01.example.com\"\n\n username = \"root\"\n\n password = \"password\"\n\n license = \"00000-00000-00000-00000-00000\"\n\n thumbprint = data.vsphere_host_thumbprint.thumbprint.id\n\n cluster = data.vsphere_compute_cluster.cluster.id\n\n services {\n\n ntpd {\n\n enabled = true\n\n policy = \"on\"\n\n ntp_servers = [\"pool.ntp.org\"]\n\n }\n\n}\n\nconsole\n\n```sh\n$ pulumi import vsphere:index/host:Host esx-01 host-123\n```\n\nThe above would import the host `esx-01.example.com` with the host ID `host-123`.\n\n", + "description": "Provides a VMware vSphere host resource. This represents an ESXi host that\ncan be used either as a member of a cluster or as a standalone host.\n\n## Example Usage\n\n### Create a standalone host\n\n\u003c!--Start PulumiCodeChooser --\u003e\n```typescript\nimport * as pulumi from \"@pulumi/pulumi\";\nimport * as vsphere from \"@pulumi/vsphere\";\n\nconst datacenter = vsphere.getDatacenter({\n name: \"dc-01\",\n});\nconst thumbprint = vsphere.getHostThumbprint({\n address: \"esxi-01.example.com\",\n insecure: true,\n});\nconst esx_01 = new vsphere.Host(\"esx-01\", {\n hostname: \"esxi-01.example.com\",\n username: \"root\",\n password: \"password\",\n license: \"00000-00000-00000-00000-00000\",\n thumbprint: thumbprint.then(thumbprint =\u003e thumbprint.id),\n datacenter: datacenter.then(datacenter =\u003e datacenter.id),\n});\n```\n```python\nimport pulumi\nimport pulumi_vsphere as vsphere\n\ndatacenter = vsphere.get_datacenter(name=\"dc-01\")\nthumbprint = vsphere.get_host_thumbprint(address=\"esxi-01.example.com\",\n insecure=True)\nesx_01 = vsphere.Host(\"esx-01\",\n hostname=\"esxi-01.example.com\",\n username=\"root\",\n password=\"password\",\n license=\"00000-00000-00000-00000-00000\",\n thumbprint=thumbprint.id,\n datacenter=datacenter.id)\n```\n```csharp\nusing System.Collections.Generic;\nusing System.Linq;\nusing Pulumi;\nusing VSphere = Pulumi.VSphere;\n\nreturn await Deployment.RunAsync(() =\u003e \n{\n var datacenter = VSphere.GetDatacenter.Invoke(new()\n {\n Name = \"dc-01\",\n });\n\n var thumbprint = VSphere.GetHostThumbprint.Invoke(new()\n {\n Address = \"esxi-01.example.com\",\n Insecure = true,\n });\n\n var esx_01 = new VSphere.Host(\"esx-01\", new()\n {\n Hostname = \"esxi-01.example.com\",\n Username = \"root\",\n Password = \"password\",\n License = \"00000-00000-00000-00000-00000\",\n Thumbprint = thumbprint.Apply(getHostThumbprintResult =\u003e getHostThumbprintResult.Id),\n Datacenter = datacenter.Apply(getDatacenterResult =\u003e getDatacenterResult.Id),\n });\n\n});\n```\n```go\npackage main\n\nimport (\n\t\"github.com/pulumi/pulumi-vsphere/sdk/v4/go/vsphere\"\n\t\"github.com/pulumi/pulumi/sdk/v3/go/pulumi\"\n)\n\nfunc main() {\n\tpulumi.Run(func(ctx *pulumi.Context) error {\n\t\tdatacenter, err := vsphere.LookupDatacenter(ctx, \u0026vsphere.LookupDatacenterArgs{\n\t\t\tName: pulumi.StringRef(\"dc-01\"),\n\t\t}, nil)\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t\tthumbprint, err := vsphere.GetHostThumbprint(ctx, \u0026vsphere.GetHostThumbprintArgs{\n\t\t\tAddress: \"esxi-01.example.com\",\n\t\t\tInsecure: pulumi.BoolRef(true),\n\t\t}, nil)\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t\t_, err = vsphere.NewHost(ctx, \"esx-01\", \u0026vsphere.HostArgs{\n\t\t\tHostname: pulumi.String(\"esxi-01.example.com\"),\n\t\t\tUsername: pulumi.String(\"root\"),\n\t\t\tPassword: pulumi.String(\"password\"),\n\t\t\tLicense: pulumi.String(\"00000-00000-00000-00000-00000\"),\n\t\t\tThumbprint: pulumi.String(thumbprint.Id),\n\t\t\tDatacenter: pulumi.String(datacenter.Id),\n\t\t})\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t\treturn nil\n\t})\n}\n```\n```java\npackage generated_program;\n\nimport com.pulumi.Context;\nimport com.pulumi.Pulumi;\nimport com.pulumi.core.Output;\nimport com.pulumi.vsphere.VsphereFunctions;\nimport com.pulumi.vsphere.inputs.GetDatacenterArgs;\nimport com.pulumi.vsphere.inputs.GetHostThumbprintArgs;\nimport com.pulumi.vsphere.Host;\nimport com.pulumi.vsphere.HostArgs;\nimport java.util.List;\nimport java.util.ArrayList;\nimport java.util.Map;\nimport java.io.File;\nimport java.nio.file.Files;\nimport java.nio.file.Paths;\n\npublic class App {\n public static void main(String[] args) {\n Pulumi.run(App::stack);\n }\n\n public static void stack(Context ctx) {\n final var datacenter = VsphereFunctions.getDatacenter(GetDatacenterArgs.builder()\n .name(\"dc-01\")\n .build());\n\n final var thumbprint = VsphereFunctions.getHostThumbprint(GetHostThumbprintArgs.builder()\n .address(\"esxi-01.example.com\")\n .insecure(true)\n .build());\n\n var esx_01 = new Host(\"esx-01\", HostArgs.builder()\n .hostname(\"esxi-01.example.com\")\n .username(\"root\")\n .password(\"password\")\n .license(\"00000-00000-00000-00000-00000\")\n .thumbprint(thumbprint.applyValue(getHostThumbprintResult -\u003e getHostThumbprintResult.id()))\n .datacenter(datacenter.applyValue(getDatacenterResult -\u003e getDatacenterResult.id()))\n .build());\n\n }\n}\n```\n```yaml\nresources:\n esx-01:\n type: vsphere:Host\n properties:\n hostname: esxi-01.example.com\n username: root\n password: password\n license: 00000-00000-00000-00000-00000\n thumbprint: ${thumbprint.id}\n datacenter: ${datacenter.id}\nvariables:\n datacenter:\n fn::invoke:\n Function: vsphere:getDatacenter\n Arguments:\n name: dc-01\n thumbprint:\n fn::invoke:\n Function: vsphere:getHostThumbprint\n Arguments:\n address: esxi-01.example.com\n insecure: true\n```\n\u003c!--End PulumiCodeChooser --\u003e\n\n## Import\n\nAn existing host can be imported into this resource by supplying\n\nthe host's ID.\n\n[docs-import]: /docs/import/index.html\n\nObtain the host's ID using the data source. For example:\n\nhcl\n\ndata \"vsphere_datacenter\" \"datacenter\" {\n\n name = \"dc-01\"\n\n}\n\ndata \"vsphere_host\" \"host\" {\n\n name = \"esxi-01.example.com\"\n\n datacenter_id = data.vsphere_datacenter.datacenter.id\n\n}\n\noutput \"host_id\" {\n\n value = data.vsphere_host.host.id\n\n}\n\nNext, create a resource configuration, For example:\n\nhcl\n\ndata \"vsphere_datacenter\" \"datacenter\" {\n\n name = \"dc-01\"\n\n}\n\ndata \"vsphere_host_thumbprint\" \"thumbprint\" {\n\n address = \"esxi-01.example.com\"\n\n insecure = true\n\n}\n\nresource \"vsphere_host\" \"esx-01\" {\n\n hostname = \"esxi-01.example.com\"\n\n username = \"root\"\n\n password = \"password\"\n\n thumbprint = data.vsphere_host_thumbprint.thumbprint.id\n\n datacenter = data.vsphere_datacenter.datacenter.id\n\n}\n\nhcl\n\nresource \"vsphere_host\" \"esx-01\" {\n\n hostname = \"esxi-01.example.com\"\n\n username = \"root\"\n\n password = \"password\"\n\n license = \"00000-00000-00000-00000-00000\"\n\n thumbprint = data.vsphere_host_thumbprint.thumbprint.id\n\n cluster = data.vsphere_compute_cluster.cluster.id\n\n services {\n\n ntpd {\n\n enabled = true\n\n policy = \"on\"\n\n ntp_servers = [\"pool.ntp.org\"]\n\n }\n\n}\n\nconsole\n\n```sh\n$ pulumi import vsphere:index/host:Host esx-01 host-123\n```\n\nThe above would import the host `esxi-01.example.com` with the host ID `host-123`.\n\n", "properties": { "cluster": { "type": "string", @@ -8141,27 +8141,26 @@ } }, "vsphere:index/resourcePool:ResourcePool": { - "description": "The `vsphere.ResourcePool` resource can be used to create and manage\nresource pools on DRS-enabled vSphere clusters or standalone ESXi hosts.\n\nFor more information on vSphere resource pools, please refer to the\n[product documentation][ref-vsphere-resource_pools].\n\n[ref-vsphere-resource_pools]: https://docs.vmware.com/en/VMware-vSphere/8.0/vsphere-resource-management/GUID-60077B40-66FF-4625-934A-641703ED7601.html\n\n## Example Usage\n\nThe following example sets up a resource pool in an existing compute cluster\nwith the default settings for CPU and memory reservations, shares, and limits.\n\n\u003c!--Start PulumiCodeChooser --\u003e\n```typescript\nimport * as pulumi from \"@pulumi/pulumi\";\nimport * as vsphere from \"@pulumi/vsphere\";\n\nconst datacenter = vsphere.getDatacenter({\n name: \"dc-01\",\n});\nconst computeCluster = datacenter.then(datacenter =\u003e vsphere.getComputeCluster({\n name: \"cluster-01\",\n datacenterId: datacenter.id,\n}));\nconst resourcePool = new vsphere.ResourcePool(\"resource_pool\", {\n name: \"resource-pool-01\",\n parentResourcePoolId: computeCluster.then(computeCluster =\u003e computeCluster.resourcePoolId),\n});\n```\n```python\nimport pulumi\nimport pulumi_vsphere as vsphere\n\ndatacenter = vsphere.get_datacenter(name=\"dc-01\")\ncompute_cluster = vsphere.get_compute_cluster(name=\"cluster-01\",\n datacenter_id=datacenter.id)\nresource_pool = vsphere.ResourcePool(\"resource_pool\",\n name=\"resource-pool-01\",\n parent_resource_pool_id=compute_cluster.resource_pool_id)\n```\n```csharp\nusing System.Collections.Generic;\nusing System.Linq;\nusing Pulumi;\nusing VSphere = Pulumi.VSphere;\n\nreturn await Deployment.RunAsync(() =\u003e \n{\n var datacenter = VSphere.GetDatacenter.Invoke(new()\n {\n Name = \"dc-01\",\n });\n\n var computeCluster = VSphere.GetComputeCluster.Invoke(new()\n {\n Name = \"cluster-01\",\n DatacenterId = datacenter.Apply(getDatacenterResult =\u003e getDatacenterResult.Id),\n });\n\n var resourcePool = new VSphere.ResourcePool(\"resource_pool\", new()\n {\n Name = \"resource-pool-01\",\n ParentResourcePoolId = computeCluster.Apply(getComputeClusterResult =\u003e getComputeClusterResult.ResourcePoolId),\n });\n\n});\n```\n```go\npackage main\n\nimport (\n\t\"github.com/pulumi/pulumi-vsphere/sdk/v4/go/vsphere\"\n\t\"github.com/pulumi/pulumi/sdk/v3/go/pulumi\"\n)\n\nfunc main() {\n\tpulumi.Run(func(ctx *pulumi.Context) error {\n\t\tdatacenter, err := vsphere.LookupDatacenter(ctx, \u0026vsphere.LookupDatacenterArgs{\n\t\t\tName: pulumi.StringRef(\"dc-01\"),\n\t\t}, nil)\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t\tcomputeCluster, err := vsphere.LookupComputeCluster(ctx, \u0026vsphere.LookupComputeClusterArgs{\n\t\t\tName: \"cluster-01\",\n\t\t\tDatacenterId: pulumi.StringRef(datacenter.Id),\n\t\t}, nil)\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t\t_, err = vsphere.NewResourcePool(ctx, \"resource_pool\", \u0026vsphere.ResourcePoolArgs{\n\t\t\tName: pulumi.String(\"resource-pool-01\"),\n\t\t\tParentResourcePoolId: pulumi.String(computeCluster.ResourcePoolId),\n\t\t})\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t\treturn nil\n\t})\n}\n```\n```java\npackage generated_program;\n\nimport com.pulumi.Context;\nimport com.pulumi.Pulumi;\nimport com.pulumi.core.Output;\nimport com.pulumi.vsphere.VsphereFunctions;\nimport com.pulumi.vsphere.inputs.GetDatacenterArgs;\nimport com.pulumi.vsphere.inputs.GetComputeClusterArgs;\nimport com.pulumi.vsphere.ResourcePool;\nimport com.pulumi.vsphere.ResourcePoolArgs;\nimport java.util.List;\nimport java.util.ArrayList;\nimport java.util.Map;\nimport java.io.File;\nimport java.nio.file.Files;\nimport java.nio.file.Paths;\n\npublic class App {\n public static void main(String[] args) {\n Pulumi.run(App::stack);\n }\n\n public static void stack(Context ctx) {\n final var datacenter = VsphereFunctions.getDatacenter(GetDatacenterArgs.builder()\n .name(\"dc-01\")\n .build());\n\n final var computeCluster = VsphereFunctions.getComputeCluster(GetComputeClusterArgs.builder()\n .name(\"cluster-01\")\n .datacenterId(datacenter.applyValue(getDatacenterResult -\u003e getDatacenterResult.id()))\n .build());\n\n var resourcePool = new ResourcePool(\"resourcePool\", ResourcePoolArgs.builder()\n .name(\"resource-pool-01\")\n .parentResourcePoolId(computeCluster.applyValue(getComputeClusterResult -\u003e getComputeClusterResult.resourcePoolId()))\n .build());\n\n }\n}\n```\n```yaml\nresources:\n resourcePool:\n type: vsphere:ResourcePool\n name: resource_pool\n properties:\n name: resource-pool-01\n parentResourcePoolId: ${computeCluster.resourcePoolId}\nvariables:\n datacenter:\n fn::invoke:\n Function: vsphere:getDatacenter\n Arguments:\n name: dc-01\n computeCluster:\n fn::invoke:\n Function: vsphere:getComputeCluster\n Arguments:\n name: cluster-01\n datacenterId: ${datacenter.id}\n```\n\u003c!--End PulumiCodeChooser --\u003e\n\nA virtual machine resource could be targeted to use the default resource pool\nof the cluster using the following:\n\n\u003c!--Start PulumiCodeChooser --\u003e\n```typescript\nimport * as pulumi from \"@pulumi/pulumi\";\nimport * as vsphere from \"@pulumi/vsphere\";\n\nconst vm = new vsphere.VirtualMachine(\"vm\", {resourcePoolId: cluster.resourcePoolId});\n```\n```python\nimport pulumi\nimport pulumi_vsphere as vsphere\n\nvm = vsphere.VirtualMachine(\"vm\", resource_pool_id=cluster[\"resourcePoolId\"])\n```\n```csharp\nusing System.Collections.Generic;\nusing System.Linq;\nusing Pulumi;\nusing VSphere = Pulumi.VSphere;\n\nreturn await Deployment.RunAsync(() =\u003e \n{\n var vm = new VSphere.VirtualMachine(\"vm\", new()\n {\n ResourcePoolId = cluster.ResourcePoolId,\n });\n\n});\n```\n```go\npackage main\n\nimport (\n\t\"github.com/pulumi/pulumi-vsphere/sdk/v4/go/vsphere\"\n\t\"github.com/pulumi/pulumi/sdk/v3/go/pulumi\"\n)\n\nfunc main() {\n\tpulumi.Run(func(ctx *pulumi.Context) error {\n\t\t_, err := vsphere.NewVirtualMachine(ctx, \"vm\", \u0026vsphere.VirtualMachineArgs{\n\t\t\tResourcePoolId: pulumi.Any(cluster.ResourcePoolId),\n\t\t})\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t\treturn nil\n\t})\n}\n```\n```java\npackage generated_program;\n\nimport com.pulumi.Context;\nimport com.pulumi.Pulumi;\nimport com.pulumi.core.Output;\nimport com.pulumi.vsphere.VirtualMachine;\nimport com.pulumi.vsphere.VirtualMachineArgs;\nimport java.util.List;\nimport java.util.ArrayList;\nimport java.util.Map;\nimport java.io.File;\nimport java.nio.file.Files;\nimport java.nio.file.Paths;\n\npublic class App {\n public static void main(String[] args) {\n Pulumi.run(App::stack);\n }\n\n public static void stack(Context ctx) {\n var vm = new VirtualMachine(\"vm\", VirtualMachineArgs.builder()\n .resourcePoolId(cluster.resourcePoolId())\n .build());\n\n }\n}\n```\n```yaml\nresources:\n vm:\n type: vsphere:VirtualMachine\n properties:\n resourcePoolId: ${cluster.resourcePoolId}\n```\n\u003c!--End PulumiCodeChooser --\u003e\n\nThe following example sets up a parent resource pool in an existing compute cluster\nwith a child resource pool nested below. Each resource pool is configured with\nthe default settings for CPU and memory reservations, shares, and limits.\n\n\u003c!--Start PulumiCodeChooser --\u003e\n```typescript\nimport * as pulumi from \"@pulumi/pulumi\";\nimport * as vsphere from \"@pulumi/vsphere\";\n\nconst datacenter = vsphere.getDatacenter({\n name: \"dc-01\",\n});\nconst computeCluster = datacenter.then(datacenter =\u003e vsphere.getComputeCluster({\n name: \"cluster-01\",\n datacenterId: datacenter.id,\n}));\nconst resourcePoolParent = new vsphere.ResourcePool(\"resource_pool_parent\", {\n name: \"parent\",\n parentResourcePoolId: computeCluster.then(computeCluster =\u003e computeCluster.resourcePoolId),\n});\nconst resourcePoolChild = new vsphere.ResourcePool(\"resource_pool_child\", {\n name: \"child\",\n parentResourcePoolId: resourcePoolParent.id,\n});\n```\n```python\nimport pulumi\nimport pulumi_vsphere as vsphere\n\ndatacenter = vsphere.get_datacenter(name=\"dc-01\")\ncompute_cluster = vsphere.get_compute_cluster(name=\"cluster-01\",\n datacenter_id=datacenter.id)\nresource_pool_parent = vsphere.ResourcePool(\"resource_pool_parent\",\n name=\"parent\",\n parent_resource_pool_id=compute_cluster.resource_pool_id)\nresource_pool_child = vsphere.ResourcePool(\"resource_pool_child\",\n name=\"child\",\n parent_resource_pool_id=resource_pool_parent.id)\n```\n```csharp\nusing System.Collections.Generic;\nusing System.Linq;\nusing Pulumi;\nusing VSphere = Pulumi.VSphere;\n\nreturn await Deployment.RunAsync(() =\u003e \n{\n var datacenter = VSphere.GetDatacenter.Invoke(new()\n {\n Name = \"dc-01\",\n });\n\n var computeCluster = VSphere.GetComputeCluster.Invoke(new()\n {\n Name = \"cluster-01\",\n DatacenterId = datacenter.Apply(getDatacenterResult =\u003e getDatacenterResult.Id),\n });\n\n var resourcePoolParent = new VSphere.ResourcePool(\"resource_pool_parent\", new()\n {\n Name = \"parent\",\n ParentResourcePoolId = computeCluster.Apply(getComputeClusterResult =\u003e getComputeClusterResult.ResourcePoolId),\n });\n\n var resourcePoolChild = new VSphere.ResourcePool(\"resource_pool_child\", new()\n {\n Name = \"child\",\n ParentResourcePoolId = resourcePoolParent.Id,\n });\n\n});\n```\n```go\npackage main\n\nimport (\n\t\"github.com/pulumi/pulumi-vsphere/sdk/v4/go/vsphere\"\n\t\"github.com/pulumi/pulumi/sdk/v3/go/pulumi\"\n)\n\nfunc main() {\n\tpulumi.Run(func(ctx *pulumi.Context) error {\n\t\tdatacenter, err := vsphere.LookupDatacenter(ctx, \u0026vsphere.LookupDatacenterArgs{\n\t\t\tName: pulumi.StringRef(\"dc-01\"),\n\t\t}, nil)\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t\tcomputeCluster, err := vsphere.LookupComputeCluster(ctx, \u0026vsphere.LookupComputeClusterArgs{\n\t\t\tName: \"cluster-01\",\n\t\t\tDatacenterId: pulumi.StringRef(datacenter.Id),\n\t\t}, nil)\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t\tresourcePoolParent, err := vsphere.NewResourcePool(ctx, \"resource_pool_parent\", \u0026vsphere.ResourcePoolArgs{\n\t\t\tName: pulumi.String(\"parent\"),\n\t\t\tParentResourcePoolId: pulumi.String(computeCluster.ResourcePoolId),\n\t\t})\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t\t_, err = vsphere.NewResourcePool(ctx, \"resource_pool_child\", \u0026vsphere.ResourcePoolArgs{\n\t\t\tName: pulumi.String(\"child\"),\n\t\t\tParentResourcePoolId: resourcePoolParent.ID(),\n\t\t})\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t\treturn nil\n\t})\n}\n```\n```java\npackage generated_program;\n\nimport com.pulumi.Context;\nimport com.pulumi.Pulumi;\nimport com.pulumi.core.Output;\nimport com.pulumi.vsphere.VsphereFunctions;\nimport com.pulumi.vsphere.inputs.GetDatacenterArgs;\nimport com.pulumi.vsphere.inputs.GetComputeClusterArgs;\nimport com.pulumi.vsphere.ResourcePool;\nimport com.pulumi.vsphere.ResourcePoolArgs;\nimport java.util.List;\nimport java.util.ArrayList;\nimport java.util.Map;\nimport java.io.File;\nimport java.nio.file.Files;\nimport java.nio.file.Paths;\n\npublic class App {\n public static void main(String[] args) {\n Pulumi.run(App::stack);\n }\n\n public static void stack(Context ctx) {\n final var datacenter = VsphereFunctions.getDatacenter(GetDatacenterArgs.builder()\n .name(\"dc-01\")\n .build());\n\n final var computeCluster = VsphereFunctions.getComputeCluster(GetComputeClusterArgs.builder()\n .name(\"cluster-01\")\n .datacenterId(datacenter.applyValue(getDatacenterResult -\u003e getDatacenterResult.id()))\n .build());\n\n var resourcePoolParent = new ResourcePool(\"resourcePoolParent\", ResourcePoolArgs.builder()\n .name(\"parent\")\n .parentResourcePoolId(computeCluster.applyValue(getComputeClusterResult -\u003e getComputeClusterResult.resourcePoolId()))\n .build());\n\n var resourcePoolChild = new ResourcePool(\"resourcePoolChild\", ResourcePoolArgs.builder()\n .name(\"child\")\n .parentResourcePoolId(resourcePoolParent.id())\n .build());\n\n }\n}\n```\n```yaml\nresources:\n resourcePoolParent:\n type: vsphere:ResourcePool\n name: resource_pool_parent\n properties:\n name: parent\n parentResourcePoolId: ${computeCluster.resourcePoolId}\n resourcePoolChild:\n type: vsphere:ResourcePool\n name: resource_pool_child\n properties:\n name: child\n parentResourcePoolId: ${resourcePoolParent.id}\nvariables:\n datacenter:\n fn::invoke:\n Function: vsphere:getDatacenter\n Arguments:\n name: dc-01\n computeCluster:\n fn::invoke:\n Function: vsphere:getComputeCluster\n Arguments:\n name: cluster-01\n datacenterId: ${datacenter.id}\n```\n\u003c!--End PulumiCodeChooser --\u003e\n\n## Import\n\n### Settings that Require vSphere 7.0 or higher\n\nThese settings require vSphere 7.0 or higher:\n\n* [`scale_descendants_shares`](#scale_descendants_shares)\n\n", "properties": { "cpuExpandable": { "type": "boolean", - "description": "Determines if the reservation on a resource\npool can grow beyond the specified value if the parent resource pool has\nunreserved resources. Default: `true`\n" + "description": "Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has\nunreserved resources.\n" }, "cpuLimit": { "type": "integer", - "description": "The CPU utilization of a resource pool will not\nexceed this limit, even if there are available resources. Set to `-1` for\nunlimited. Default: `-1`\n" + "description": "The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for\nunlimited.\n" }, "cpuReservation": { "type": "integer", - "description": "Amount of CPU (MHz) that is guaranteed\navailable to the resource pool. Default: `0`\n" + "description": "Amount of CPU (MHz) that is guaranteed available to the resource pool.\n" }, "cpuShareLevel": { "type": "string", - "description": "The CPU allocation level. The level is a\nsimplified view of shares. Levels map to a pre-determined set of numeric\nvalues for shares. Can be one of `low`, `normal`, `high`, or `custom`. When\n`low`, `normal`, or `high` are specified values in `cpu_shares` will be\nignored. Default: `normal`\n" + "description": "The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for\nshares. Can be one of low, normal, high, or custom.\n" }, "cpuShares": { "type": "integer", - "description": "The number of shares allocated for CPU. Used to\ndetermine resource allocation in case of resource contention. If this is set,\n`cpu_share_level` must be `custom`.\n" + "description": "The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set,\ncpu_share_level must be custom.\n" }, "customAttributes": { "type": "object", @@ -8172,42 +8171,42 @@ }, "memoryExpandable": { "type": "boolean", - "description": "Determines if the reservation on a resource\npool can grow beyond the specified value if the parent resource pool has\nunreserved resources. Default: `true`\n" + "description": "Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has\nunreserved resources.\n" }, "memoryLimit": { "type": "integer", - "description": "The CPU utilization of a resource pool will not\nexceed this limit, even if there are available resources. Set to `-1` for\nunlimited. Default: `-1`\n" + "description": "The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for\nunlimited.\n" }, "memoryReservation": { "type": "integer", - "description": "Amount of CPU (MHz) that is guaranteed\navailable to the resource pool. Default: `0`\n" + "description": "Amount of memory (MB) that is guaranteed available to the resource pool.\n" }, "memoryShareLevel": { "type": "string", - "description": "The CPU allocation level. The level is a\nsimplified view of shares. Levels map to a pre-determined set of numeric\nvalues for shares. Can be one of `low`, `normal`, `high`, or `custom`. When\n`low`, `normal`, or `high` are specified values in `memory_shares` will be\nignored. Default: `normal`\n" + "description": "The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for\nshares. Can be one of low, normal, high, or custom.\n" }, "memoryShares": { "type": "integer", - "description": "The number of shares allocated for CPU. Used to\ndetermine resource allocation in case of resource contention. If this is set,\n`memory_share_level` must be `custom`.\n" + "description": "The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set,\nmemory_share_level must be custom.\n" }, "name": { "type": "string", - "description": "The name of the resource pool.\n" + "description": "Name of resource pool.\n" }, "parentResourcePoolId": { "type": "string", - "description": "The managed object ID\nof the parent resource pool. This can be the root resource pool for a cluster\nor standalone host, or a resource pool itself. When moving a resource pool\nfrom one parent resource pool to another, both must share a common root\nresource pool.\n" + "description": "The ID of the root resource pool of the compute resource the resource pool is in.\n" }, "scaleDescendantsShares": { "type": "string", - "description": "Determines if the shares of all\ndescendants of the resource pool are scaled up or down when the shares\nof the resource pool are scaled up or down. Can be one of `disabled` or\n`scaleCpuAndMemoryShares`. Default: `disabled`.\n" + "description": "Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource\npool are scaled up or down.\n" }, "tags": { "type": "array", "items": { "type": "string" }, - "description": "The IDs of any tags to attach to this resource.\n" + "description": "A list of tag IDs to apply to this object.\n" } }, "required": [ @@ -8219,23 +8218,23 @@ "inputProperties": { "cpuExpandable": { "type": "boolean", - "description": "Determines if the reservation on a resource\npool can grow beyond the specified value if the parent resource pool has\nunreserved resources. Default: `true`\n" + "description": "Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has\nunreserved resources.\n" }, "cpuLimit": { "type": "integer", - "description": "The CPU utilization of a resource pool will not\nexceed this limit, even if there are available resources. Set to `-1` for\nunlimited. Default: `-1`\n" + "description": "The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for\nunlimited.\n" }, "cpuReservation": { "type": "integer", - "description": "Amount of CPU (MHz) that is guaranteed\navailable to the resource pool. Default: `0`\n" + "description": "Amount of CPU (MHz) that is guaranteed available to the resource pool.\n" }, "cpuShareLevel": { "type": "string", - "description": "The CPU allocation level. The level is a\nsimplified view of shares. Levels map to a pre-determined set of numeric\nvalues for shares. Can be one of `low`, `normal`, `high`, or `custom`. When\n`low`, `normal`, or `high` are specified values in `cpu_shares` will be\nignored. Default: `normal`\n" + "description": "The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for\nshares. Can be one of low, normal, high, or custom.\n" }, "cpuShares": { "type": "integer", - "description": "The number of shares allocated for CPU. Used to\ndetermine resource allocation in case of resource contention. If this is set,\n`cpu_share_level` must be `custom`.\n" + "description": "The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set,\ncpu_share_level must be custom.\n" }, "customAttributes": { "type": "object", @@ -8246,42 +8245,42 @@ }, "memoryExpandable": { "type": "boolean", - "description": "Determines if the reservation on a resource\npool can grow beyond the specified value if the parent resource pool has\nunreserved resources. Default: `true`\n" + "description": "Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has\nunreserved resources.\n" }, "memoryLimit": { "type": "integer", - "description": "The CPU utilization of a resource pool will not\nexceed this limit, even if there are available resources. Set to `-1` for\nunlimited. Default: `-1`\n" + "description": "The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for\nunlimited.\n" }, "memoryReservation": { "type": "integer", - "description": "Amount of CPU (MHz) that is guaranteed\navailable to the resource pool. Default: `0`\n" + "description": "Amount of memory (MB) that is guaranteed available to the resource pool.\n" }, "memoryShareLevel": { "type": "string", - "description": "The CPU allocation level. The level is a\nsimplified view of shares. Levels map to a pre-determined set of numeric\nvalues for shares. Can be one of `low`, `normal`, `high`, or `custom`. When\n`low`, `normal`, or `high` are specified values in `memory_shares` will be\nignored. Default: `normal`\n" + "description": "The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for\nshares. Can be one of low, normal, high, or custom.\n" }, "memoryShares": { "type": "integer", - "description": "The number of shares allocated for CPU. Used to\ndetermine resource allocation in case of resource contention. If this is set,\n`memory_share_level` must be `custom`.\n" + "description": "The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set,\nmemory_share_level must be custom.\n" }, "name": { "type": "string", - "description": "The name of the resource pool.\n" + "description": "Name of resource pool.\n" }, "parentResourcePoolId": { "type": "string", - "description": "The managed object ID\nof the parent resource pool. This can be the root resource pool for a cluster\nor standalone host, or a resource pool itself. When moving a resource pool\nfrom one parent resource pool to another, both must share a common root\nresource pool.\n" + "description": "The ID of the root resource pool of the compute resource the resource pool is in.\n" }, "scaleDescendantsShares": { "type": "string", - "description": "Determines if the shares of all\ndescendants of the resource pool are scaled up or down when the shares\nof the resource pool are scaled up or down. Can be one of `disabled` or\n`scaleCpuAndMemoryShares`. Default: `disabled`.\n" + "description": "Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource\npool are scaled up or down.\n" }, "tags": { "type": "array", "items": { "type": "string" }, - "description": "The IDs of any tags to attach to this resource.\n" + "description": "A list of tag IDs to apply to this object.\n" } }, "requiredInputs": [ @@ -8292,23 +8291,23 @@ "properties": { "cpuExpandable": { "type": "boolean", - "description": "Determines if the reservation on a resource\npool can grow beyond the specified value if the parent resource pool has\nunreserved resources. Default: `true`\n" + "description": "Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has\nunreserved resources.\n" }, "cpuLimit": { "type": "integer", - "description": "The CPU utilization of a resource pool will not\nexceed this limit, even if there are available resources. Set to `-1` for\nunlimited. Default: `-1`\n" + "description": "The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for\nunlimited.\n" }, "cpuReservation": { "type": "integer", - "description": "Amount of CPU (MHz) that is guaranteed\navailable to the resource pool. Default: `0`\n" + "description": "Amount of CPU (MHz) that is guaranteed available to the resource pool.\n" }, "cpuShareLevel": { "type": "string", - "description": "The CPU allocation level. The level is a\nsimplified view of shares. Levels map to a pre-determined set of numeric\nvalues for shares. Can be one of `low`, `normal`, `high`, or `custom`. When\n`low`, `normal`, or `high` are specified values in `cpu_shares` will be\nignored. Default: `normal`\n" + "description": "The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for\nshares. Can be one of low, normal, high, or custom.\n" }, "cpuShares": { "type": "integer", - "description": "The number of shares allocated for CPU. Used to\ndetermine resource allocation in case of resource contention. If this is set,\n`cpu_share_level` must be `custom`.\n" + "description": "The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set,\ncpu_share_level must be custom.\n" }, "customAttributes": { "type": "object", @@ -8319,42 +8318,42 @@ }, "memoryExpandable": { "type": "boolean", - "description": "Determines if the reservation on a resource\npool can grow beyond the specified value if the parent resource pool has\nunreserved resources. Default: `true`\n" + "description": "Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has\nunreserved resources.\n" }, "memoryLimit": { "type": "integer", - "description": "The CPU utilization of a resource pool will not\nexceed this limit, even if there are available resources. Set to `-1` for\nunlimited. Default: `-1`\n" + "description": "The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for\nunlimited.\n" }, "memoryReservation": { "type": "integer", - "description": "Amount of CPU (MHz) that is guaranteed\navailable to the resource pool. Default: `0`\n" + "description": "Amount of memory (MB) that is guaranteed available to the resource pool.\n" }, "memoryShareLevel": { "type": "string", - "description": "The CPU allocation level. The level is a\nsimplified view of shares. Levels map to a pre-determined set of numeric\nvalues for shares. Can be one of `low`, `normal`, `high`, or `custom`. When\n`low`, `normal`, or `high` are specified values in `memory_shares` will be\nignored. Default: `normal`\n" + "description": "The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for\nshares. Can be one of low, normal, high, or custom.\n" }, "memoryShares": { "type": "integer", - "description": "The number of shares allocated for CPU. Used to\ndetermine resource allocation in case of resource contention. If this is set,\n`memory_share_level` must be `custom`.\n" + "description": "The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set,\nmemory_share_level must be custom.\n" }, "name": { "type": "string", - "description": "The name of the resource pool.\n" + "description": "Name of resource pool.\n" }, "parentResourcePoolId": { "type": "string", - "description": "The managed object ID\nof the parent resource pool. This can be the root resource pool for a cluster\nor standalone host, or a resource pool itself. When moving a resource pool\nfrom one parent resource pool to another, both must share a common root\nresource pool.\n" + "description": "The ID of the root resource pool of the compute resource the resource pool is in.\n" }, "scaleDescendantsShares": { "type": "string", - "description": "Determines if the shares of all\ndescendants of the resource pool are scaled up or down when the shares\nof the resource pool are scaled up or down. Can be one of `disabled` or\n`scaleCpuAndMemoryShares`. Default: `disabled`.\n" + "description": "Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource\npool are scaled up or down.\n" }, "tags": { "type": "array", "items": { "type": "string" }, - "description": "The IDs of any tags to attach to this resource.\n" + "description": "A list of tag IDs to apply to this object.\n" } }, "type": "object" @@ -8878,8 +8877,7 @@ }, "cardinality": { "type": "string", - "description": "The number of tags that can be assigned from this\ncategory to a single object at once. Can be one of `SINGLE` (object can only\nbe assigned one tag in this category), to `MULTIPLE` (object can be assigned\nmultiple tags in this category). Forces a new resource if changed.\n", - "willReplaceOnChanges": true + "description": "The number of tags that can be assigned from this\ncategory to a single object at once. Can be one of `SINGLE` (object can only\nbe assigned one tag in this category), to `MULTIPLE` (object can be assigned\nmultiple tags in this category). Forces a new resource if changed.\n" }, "description": { "type": "string", @@ -8906,8 +8904,7 @@ }, "cardinality": { "type": "string", - "description": "The number of tags that can be assigned from this\ncategory to a single object at once. Can be one of `SINGLE` (object can only\nbe assigned one tag in this category), to `MULTIPLE` (object can be assigned\nmultiple tags in this category). Forces a new resource if changed.\n", - "willReplaceOnChanges": true + "description": "The number of tags that can be assigned from this\ncategory to a single object at once. Can be one of `SINGLE` (object can only\nbe assigned one tag in this category), to `MULTIPLE` (object can be assigned\nmultiple tags in this category). Forces a new resource if changed.\n" }, "description": { "type": "string", @@ -9427,7 +9424,7 @@ } }, "vsphere:index/virtualMachine:VirtualMachine": { - "description": "\n\n## Import\n\n### Additional Importing Requirements\n\nMany of the requirements for [cloning](#additional-requirements-and-notes-for-cloning) apply to importing. Although importing writes directly to the Terraform state, some rules can not be enforced during import time, so every effort should be made to ensure the correctness of the configuration before the import.\n\nThe following requirements apply to import:\n\n* The disks must have a [`label`](#label) argument assigned in a convention matching `diskN`, starting with disk number 0, based on each virtual disk order on the SCSI bus. As an example, a disk on SCSI controller `0` with a unit number of `0` would be labeled as `disk0`, a disk on the same controller with a unit number of `1` would be `disk1`, but the next disk, which is on SCSI controller `1` with a unit number of `0`, still becomes `disk2`.\n\n* Disks are always imported with [`keep_on_remove`](#keep_on_remove) enabled until the first `pulumi up` run which will remove the setting for known disks. This process safeguards against naming or accounting mistakes in the disk configuration.\n\n* The storage controller count for the resource is set to the number of contiguous storage controllers found, starting with the controller at SCSI bus number `0`. If no storage controllers are discovered, the virtual machine is not eligible for import. For maximum compatibility, ensure that the virtual machine has the exact number of storage controllers needed and set the storage controller count accordingly.\n\nAfter importing, you should run `pulumi preview`. Unless you have changed anything else in the configuration that would cause other attributes to change. The only difference should be configuration-only changes, which are typically comprised of:\n\n* The [`imported`](#imported) flag will transition from `true` to `false`.\n\n* The [`keep_on_remove`](#keep_on_remove) of known disks will transition from `true` to `false`.\n\n* Configuration supplied in the [`clone`](#clone) block, if present, will be persisted to state. This initial persistence operation does not perform any cloning or customization actions, nor does it force a new resource. After the first apply operation, further changes to `clone` will force the creation of a new resource.\n\nThese changes only update Terraform state when applied. Hence, it is safe to run when the virtual machine is running. If more settings are modified, you may need to plan maintenance accordingly for any necessary virtual machine re-configurations.\n\n", + "description": "\n\n## Import\n\n### Additional Importing Requirements\n\nMany of the requirements for [cloning](#additional-requirements-and-notes-for-cloning) apply to importing. Although importing writes directly to the Terraform state, some rules can not be enforced during import time, so every effort should be made to ensure the correctness of the configuration before the import.\n\nThe following requirements apply to import:\n\n* The disks must have a [`label`](#label) argument assigned in a convention matching `Hard Disk`, starting with disk number 0, based on each virtual disk order on the SCSI bus. As an example, a disk on SCSI controller `0` with a unit number of `0` would be labeled as `Hard Disk 0`, a disk on the same controller with a unit number of `1` would be `Hard Disk 1`, but the next disk, which is on SCSI controller `1` with a unit number of `0`, still becomes `Hard Disk 2`.\n\n* Disks are always imported with [`keep_on_remove`](#keep_on_remove) enabled until the first `pulumi up` run which will remove the setting for known disks. This process safeguards against naming or accounting mistakes in the disk configuration.\n\n* The storage controller count for the resource is set to the number of contiguous storage controllers found, starting with the controller at SCSI bus number `0`. If no storage controllers are discovered, the virtual machine is not eligible for import. For maximum compatibility, ensure that the virtual machine has the exact number of storage controllers needed and set the storage controller count accordingly.\n\nAfter importing, you should run `pulumi preview`. Unless you have changed anything else in the configuration that would cause other attributes to change. The only difference should be configuration-only changes, which are typically comprised of:\n\n* The [`imported`](#imported) flag will transition from `true` to `false`.\n\n* The [`keep_on_remove`](#keep_on_remove) of known disks will transition from `true` to `false`.\n\n* Configuration supplied in the [`clone`](#clone) block, if present, will be persisted to state. This initial persistence operation does not perform any cloning or customization actions, nor does it force a new resource. After the first apply operation, further changes to `clone` will force the creation of a new resource.\n\nThese changes only update Terraform state when applied. Hence, it is safe to run when the virtual machine is running. If more settings are modified, you may need to plan maintenance accordingly for any necessary virtual machine re-configurations.\n\n", "properties": { "alternateGuestName": { "type": "string", @@ -11901,7 +11898,7 @@ } }, "vsphere:index/getHostThumbprint:getHostThumbprint": { - "description": "The `vsphere_thumbprint` data source can be used to discover the host thumbprint\nof an ESXi host. This can be used when adding the `vsphere.Host` resource. If\nthe ESXi host is using a certificate chain, the first one returned will be used\nto generate the thumbprint.\n\n## Example Usage\n\n\u003c!--Start PulumiCodeChooser --\u003e\n```typescript\nimport * as pulumi from \"@pulumi/pulumi\";\nimport * as vsphere from \"@pulumi/vsphere\";\n\nconst thumbprint = vsphere.getHostThumbprint({\n address: \"esxi-01.example.com\",\n});\n```\n```python\nimport pulumi\nimport pulumi_vsphere as vsphere\n\nthumbprint = vsphere.get_host_thumbprint(address=\"esxi-01.example.com\")\n```\n```csharp\nusing System.Collections.Generic;\nusing System.Linq;\nusing Pulumi;\nusing VSphere = Pulumi.VSphere;\n\nreturn await Deployment.RunAsync(() =\u003e \n{\n var thumbprint = VSphere.GetHostThumbprint.Invoke(new()\n {\n Address = \"esxi-01.example.com\",\n });\n\n});\n```\n```go\npackage main\n\nimport (\n\t\"github.com/pulumi/pulumi-vsphere/sdk/v4/go/vsphere\"\n\t\"github.com/pulumi/pulumi/sdk/v3/go/pulumi\"\n)\n\nfunc main() {\n\tpulumi.Run(func(ctx *pulumi.Context) error {\n\t\t_, err := vsphere.GetHostThumbprint(ctx, \u0026vsphere.GetHostThumbprintArgs{\n\t\t\tAddress: \"esxi-01.example.com\",\n\t\t}, nil)\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t\treturn nil\n\t})\n}\n```\n```java\npackage generated_program;\n\nimport com.pulumi.Context;\nimport com.pulumi.Pulumi;\nimport com.pulumi.core.Output;\nimport com.pulumi.vsphere.VsphereFunctions;\nimport com.pulumi.vsphere.inputs.GetHostThumbprintArgs;\nimport java.util.List;\nimport java.util.ArrayList;\nimport java.util.Map;\nimport java.io.File;\nimport java.nio.file.Files;\nimport java.nio.file.Paths;\n\npublic class App {\n public static void main(String[] args) {\n Pulumi.run(App::stack);\n }\n\n public static void stack(Context ctx) {\n final var thumbprint = VsphereFunctions.getHostThumbprint(GetHostThumbprintArgs.builder()\n .address(\"esxi-01.example.com\")\n .build());\n\n }\n}\n```\n```yaml\nvariables:\n thumbprint:\n fn::invoke:\n Function: vsphere:getHostThumbprint\n Arguments:\n address: esxi-01.example.com\n```\n\u003c!--End PulumiCodeChooser --\u003e\n", + "description": "The `vsphere_thumbprint` data source can be used to discover the host thumbprint\nof an ESXi host. This can be used when adding the `vsphere.Host` resource to a\ncluster or a vCenter Server instance.\n\n* If the ESXi host is using a certificate chain, the first one returned will be\nused to generate the thumbprint.\n\n* If the ESXi host has a certificate issued by a certificate authority, ensure\nthat the the certificate authority is trusted on the system running the plan.\n\n## Example Usage\n\n\u003c!--Start PulumiCodeChooser --\u003e\n```typescript\nimport * as pulumi from \"@pulumi/pulumi\";\nimport * as vsphere from \"@pulumi/vsphere\";\n\nconst thumbprint = vsphere.getHostThumbprint({\n address: \"esxi-01.example.com\",\n});\n```\n```python\nimport pulumi\nimport pulumi_vsphere as vsphere\n\nthumbprint = vsphere.get_host_thumbprint(address=\"esxi-01.example.com\")\n```\n```csharp\nusing System.Collections.Generic;\nusing System.Linq;\nusing Pulumi;\nusing VSphere = Pulumi.VSphere;\n\nreturn await Deployment.RunAsync(() =\u003e \n{\n var thumbprint = VSphere.GetHostThumbprint.Invoke(new()\n {\n Address = \"esxi-01.example.com\",\n });\n\n});\n```\n```go\npackage main\n\nimport (\n\t\"github.com/pulumi/pulumi-vsphere/sdk/v4/go/vsphere\"\n\t\"github.com/pulumi/pulumi/sdk/v3/go/pulumi\"\n)\n\nfunc main() {\n\tpulumi.Run(func(ctx *pulumi.Context) error {\n\t\t_, err := vsphere.GetHostThumbprint(ctx, \u0026vsphere.GetHostThumbprintArgs{\n\t\t\tAddress: \"esxi-01.example.com\",\n\t\t}, nil)\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t\treturn nil\n\t})\n}\n```\n```java\npackage generated_program;\n\nimport com.pulumi.Context;\nimport com.pulumi.Pulumi;\nimport com.pulumi.core.Output;\nimport com.pulumi.vsphere.VsphereFunctions;\nimport com.pulumi.vsphere.inputs.GetHostThumbprintArgs;\nimport java.util.List;\nimport java.util.ArrayList;\nimport java.util.Map;\nimport java.io.File;\nimport java.nio.file.Files;\nimport java.nio.file.Paths;\n\npublic class App {\n public static void main(String[] args) {\n Pulumi.run(App::stack);\n }\n\n public static void stack(Context ctx) {\n final var thumbprint = VsphereFunctions.getHostThumbprint(GetHostThumbprintArgs.builder()\n .address(\"esxi-01.example.com\")\n .build());\n\n }\n}\n```\n```yaml\nvariables:\n thumbprint:\n fn::invoke:\n Function: vsphere:getHostThumbprint\n Arguments:\n address: esxi-01.example.com\n```\n\u003c!--End PulumiCodeChooser --\u003e\n", "inputs": { "description": "A collection of arguments for invoking getHostThumbprint.\n", "properties": { @@ -11911,7 +11908,7 @@ }, "insecure": { "type": "boolean", - "description": "Disables SSL certificate verification.\nDefault: `false`\n" + "description": "Disables SSL certificate verification. Default: `false`\n" }, "port": { "type": "string", diff --git a/sdk/dotnet/GetHostThumbprint.cs b/sdk/dotnet/GetHostThumbprint.cs index be1f5a2f..d55ff386 100644 --- a/sdk/dotnet/GetHostThumbprint.cs +++ b/sdk/dotnet/GetHostThumbprint.cs @@ -13,9 +13,14 @@ public static class GetHostThumbprint { /// /// The `vsphere_thumbprint` data source can be used to discover the host thumbprint - /// of an ESXi host. This can be used when adding the `vsphere.Host` resource. If - /// the ESXi host is using a certificate chain, the first one returned will be used - /// to generate the thumbprint. + /// of an ESXi host. This can be used when adding the `vsphere.Host` resource to a + /// cluster or a vCenter Server instance. + /// + /// * If the ESXi host is using a certificate chain, the first one returned will be + /// used to generate the thumbprint. + /// + /// * If the ESXi host has a certificate issued by a certificate authority, ensure + /// that the the certificate authority is trusted on the system running the plan. /// /// ## Example Usage /// @@ -40,9 +45,14 @@ public static Task InvokeAsync(GetHostThumbprintArgs ar /// /// The `vsphere_thumbprint` data source can be used to discover the host thumbprint - /// of an ESXi host. This can be used when adding the `vsphere.Host` resource. If - /// the ESXi host is using a certificate chain, the first one returned will be used - /// to generate the thumbprint. + /// of an ESXi host. This can be used when adding the `vsphere.Host` resource to a + /// cluster or a vCenter Server instance. + /// + /// * If the ESXi host is using a certificate chain, the first one returned will be + /// used to generate the thumbprint. + /// + /// * If the ESXi host has a certificate issued by a certificate authority, ensure + /// that the the certificate authority is trusted on the system running the plan. /// /// ## Example Usage /// @@ -77,8 +87,7 @@ public sealed class GetHostThumbprintArgs : global::Pulumi.InvokeArgs public string Address { get; set; } = null!; /// - /// Disables SSL certificate verification. - /// Default: `false` + /// Disables SSL certificate verification. Default: `false` /// [Input("insecure")] public bool? Insecure { get; set; } @@ -105,8 +114,7 @@ public sealed class GetHostThumbprintInvokeArgs : global::Pulumi.InvokeArgs public Input Address { get; set; } = null!; /// - /// Disables SSL certificate verification. - /// Default: `false` + /// Disables SSL certificate verification. Default: `false` /// [Input("insecure")] public Input? Insecure { get; set; } diff --git a/sdk/dotnet/Host.cs b/sdk/dotnet/Host.cs index e7d02883..8f281657 100644 --- a/sdk/dotnet/Host.cs +++ b/sdk/dotnet/Host.cs @@ -32,13 +32,13 @@ namespace Pulumi.VSphere /// /// var thumbprint = VSphere.GetHostThumbprint.Invoke(new() /// { - /// Address = "esx-01.example.com", + /// Address = "esxi-01.example.com", /// Insecure = true, /// }); /// /// var esx_01 = new VSphere.Host("esx-01", new() /// { - /// Hostname = "esx-01.example.com", + /// Hostname = "esxi-01.example.com", /// Username = "root", /// Password = "password", /// License = "00000-00000-00000-00000-00000", @@ -69,7 +69,7 @@ namespace Pulumi.VSphere /// /// data "vsphere_host" "host" { /// - /// name = "esx-01.example.com" + /// name = "esxi-01.example.com" /// /// datacenter_id = data.vsphere_datacenter.datacenter.id /// @@ -93,7 +93,7 @@ namespace Pulumi.VSphere /// /// data "vsphere_host_thumbprint" "thumbprint" { /// - /// address = "esx-01.example.com" + /// address = "esxi-01.example.com" /// /// insecure = true /// @@ -101,7 +101,7 @@ namespace Pulumi.VSphere /// /// resource "vsphere_host" "esx-01" { /// - /// hostname = "esx-01.example.com" + /// hostname = "esxi-01.example.com" /// /// username = "root" /// @@ -117,7 +117,7 @@ namespace Pulumi.VSphere /// /// resource "vsphere_host" "esx-01" { /// - /// hostname = "esx-01.example.com" + /// hostname = "esxi-01.example.com" /// /// username = "root" /// @@ -149,7 +149,7 @@ namespace Pulumi.VSphere /// $ pulumi import vsphere:index/host:Host esx-01 host-123 /// ``` /// - /// The above would import the host `esx-01.example.com` with the host ID `host-123`. + /// The above would import the host `esxi-01.example.com` with the host ID `host-123`. /// [VSphereResourceType("vsphere:index/host:Host")] public partial class Host : global::Pulumi.CustomResource diff --git a/sdk/dotnet/ResourcePool.cs b/sdk/dotnet/ResourcePool.cs index 1f193f54..68b7008e 100644 --- a/sdk/dotnet/ResourcePool.cs +++ b/sdk/dotnet/ResourcePool.cs @@ -9,153 +9,39 @@ namespace Pulumi.VSphere { - /// - /// The `vsphere.ResourcePool` resource can be used to create and manage - /// resource pools on DRS-enabled vSphere clusters or standalone ESXi hosts. - /// - /// For more information on vSphere resource pools, please refer to the - /// [product documentation][ref-vsphere-resource_pools]. - /// - /// [ref-vsphere-resource_pools]: https://docs.vmware.com/en/VMware-vSphere/8.0/vsphere-resource-management/GUID-60077B40-66FF-4625-934A-641703ED7601.html - /// - /// ## Example Usage - /// - /// The following example sets up a resource pool in an existing compute cluster - /// with the default settings for CPU and memory reservations, shares, and limits. - /// - /// ```csharp - /// using System.Collections.Generic; - /// using System.Linq; - /// using Pulumi; - /// using VSphere = Pulumi.VSphere; - /// - /// return await Deployment.RunAsync(() => - /// { - /// var datacenter = VSphere.GetDatacenter.Invoke(new() - /// { - /// Name = "dc-01", - /// }); - /// - /// var computeCluster = VSphere.GetComputeCluster.Invoke(new() - /// { - /// Name = "cluster-01", - /// DatacenterId = datacenter.Apply(getDatacenterResult => getDatacenterResult.Id), - /// }); - /// - /// var resourcePool = new VSphere.ResourcePool("resource_pool", new() - /// { - /// Name = "resource-pool-01", - /// ParentResourcePoolId = computeCluster.Apply(getComputeClusterResult => getComputeClusterResult.ResourcePoolId), - /// }); - /// - /// }); - /// ``` - /// - /// A virtual machine resource could be targeted to use the default resource pool - /// of the cluster using the following: - /// - /// ```csharp - /// using System.Collections.Generic; - /// using System.Linq; - /// using Pulumi; - /// using VSphere = Pulumi.VSphere; - /// - /// return await Deployment.RunAsync(() => - /// { - /// var vm = new VSphere.VirtualMachine("vm", new() - /// { - /// ResourcePoolId = cluster.ResourcePoolId, - /// }); - /// - /// }); - /// ``` - /// - /// The following example sets up a parent resource pool in an existing compute cluster - /// with a child resource pool nested below. Each resource pool is configured with - /// the default settings for CPU and memory reservations, shares, and limits. - /// - /// ```csharp - /// using System.Collections.Generic; - /// using System.Linq; - /// using Pulumi; - /// using VSphere = Pulumi.VSphere; - /// - /// return await Deployment.RunAsync(() => - /// { - /// var datacenter = VSphere.GetDatacenter.Invoke(new() - /// { - /// Name = "dc-01", - /// }); - /// - /// var computeCluster = VSphere.GetComputeCluster.Invoke(new() - /// { - /// Name = "cluster-01", - /// DatacenterId = datacenter.Apply(getDatacenterResult => getDatacenterResult.Id), - /// }); - /// - /// var resourcePoolParent = new VSphere.ResourcePool("resource_pool_parent", new() - /// { - /// Name = "parent", - /// ParentResourcePoolId = computeCluster.Apply(getComputeClusterResult => getComputeClusterResult.ResourcePoolId), - /// }); - /// - /// var resourcePoolChild = new VSphere.ResourcePool("resource_pool_child", new() - /// { - /// Name = "child", - /// ParentResourcePoolId = resourcePoolParent.Id, - /// }); - /// - /// }); - /// ``` - /// - /// ## Import - /// - /// ### Settings that Require vSphere 7.0 or higher - /// - /// These settings require vSphere 7.0 or higher: - /// - /// * [`scale_descendants_shares`](#scale_descendants_shares) - /// [VSphereResourceType("vsphere:index/resourcePool:ResourcePool")] public partial class ResourcePool : global::Pulumi.CustomResource { /// - /// Determines if the reservation on a resource - /// pool can grow beyond the specified value if the parent resource pool has - /// unreserved resources. Default: `true` + /// Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + /// unreserved resources. /// [Output("cpuExpandable")] public Output CpuExpandable { get; private set; } = null!; /// - /// The CPU utilization of a resource pool will not - /// exceed this limit, even if there are available resources. Set to `-1` for - /// unlimited. Default: `-1` + /// The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + /// unlimited. /// [Output("cpuLimit")] public Output CpuLimit { get; private set; } = null!; /// - /// Amount of CPU (MHz) that is guaranteed - /// available to the resource pool. Default: `0` + /// Amount of CPU (MHz) that is guaranteed available to the resource pool. /// [Output("cpuReservation")] public Output CpuReservation { get; private set; } = null!; /// - /// The CPU allocation level. The level is a - /// simplified view of shares. Levels map to a pre-determined set of numeric - /// values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - /// `low`, `normal`, or `high` are specified values in `cpu_shares` will be - /// ignored. Default: `normal` + /// The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + /// shares. Can be one of low, normal, high, or custom. /// [Output("cpuShareLevel")] public Output CpuShareLevel { get; private set; } = null!; /// - /// The number of shares allocated for CPU. Used to - /// determine resource allocation in case of resource contention. If this is set, - /// `cpu_share_level` must be `custom`. + /// The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + /// cpu_share_level must be custom. /// [Output("cpuShares")] public Output CpuShares { get; private set; } = null!; @@ -167,73 +53,60 @@ public partial class ResourcePool : global::Pulumi.CustomResource public Output?> CustomAttributes { get; private set; } = null!; /// - /// Determines if the reservation on a resource - /// pool can grow beyond the specified value if the parent resource pool has - /// unreserved resources. Default: `true` + /// Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + /// unreserved resources. /// [Output("memoryExpandable")] public Output MemoryExpandable { get; private set; } = null!; /// - /// The CPU utilization of a resource pool will not - /// exceed this limit, even if there are available resources. Set to `-1` for - /// unlimited. Default: `-1` + /// The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + /// unlimited. /// [Output("memoryLimit")] public Output MemoryLimit { get; private set; } = null!; /// - /// Amount of CPU (MHz) that is guaranteed - /// available to the resource pool. Default: `0` + /// Amount of memory (MB) that is guaranteed available to the resource pool. /// [Output("memoryReservation")] public Output MemoryReservation { get; private set; } = null!; /// - /// The CPU allocation level. The level is a - /// simplified view of shares. Levels map to a pre-determined set of numeric - /// values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - /// `low`, `normal`, or `high` are specified values in `memory_shares` will be - /// ignored. Default: `normal` + /// The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + /// shares. Can be one of low, normal, high, or custom. /// [Output("memoryShareLevel")] public Output MemoryShareLevel { get; private set; } = null!; /// - /// The number of shares allocated for CPU. Used to - /// determine resource allocation in case of resource contention. If this is set, - /// `memory_share_level` must be `custom`. + /// The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + /// memory_share_level must be custom. /// [Output("memoryShares")] public Output MemoryShares { get; private set; } = null!; /// - /// The name of the resource pool. + /// Name of resource pool. /// [Output("name")] public Output Name { get; private set; } = null!; /// - /// The managed object ID - /// of the parent resource pool. This can be the root resource pool for a cluster - /// or standalone host, or a resource pool itself. When moving a resource pool - /// from one parent resource pool to another, both must share a common root - /// resource pool. + /// The ID of the root resource pool of the compute resource the resource pool is in. /// [Output("parentResourcePoolId")] public Output ParentResourcePoolId { get; private set; } = null!; /// - /// Determines if the shares of all - /// descendants of the resource pool are scaled up or down when the shares - /// of the resource pool are scaled up or down. Can be one of `disabled` or - /// `scaleCpuAndMemoryShares`. Default: `disabled`. + /// Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource + /// pool are scaled up or down. /// [Output("scaleDescendantsShares")] public Output ScaleDescendantsShares { get; private set; } = null!; /// - /// The IDs of any tags to attach to this resource. + /// A list of tag IDs to apply to this object. /// [Output("tags")] public Output> Tags { get; private set; } = null!; @@ -285,42 +158,35 @@ public static ResourcePool Get(string name, Input id, ResourcePoolState? public sealed class ResourcePoolArgs : global::Pulumi.ResourceArgs { /// - /// Determines if the reservation on a resource - /// pool can grow beyond the specified value if the parent resource pool has - /// unreserved resources. Default: `true` + /// Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + /// unreserved resources. /// [Input("cpuExpandable")] public Input? CpuExpandable { get; set; } /// - /// The CPU utilization of a resource pool will not - /// exceed this limit, even if there are available resources. Set to `-1` for - /// unlimited. Default: `-1` + /// The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + /// unlimited. /// [Input("cpuLimit")] public Input? CpuLimit { get; set; } /// - /// Amount of CPU (MHz) that is guaranteed - /// available to the resource pool. Default: `0` + /// Amount of CPU (MHz) that is guaranteed available to the resource pool. /// [Input("cpuReservation")] public Input? CpuReservation { get; set; } /// - /// The CPU allocation level. The level is a - /// simplified view of shares. Levels map to a pre-determined set of numeric - /// values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - /// `low`, `normal`, or `high` are specified values in `cpu_shares` will be - /// ignored. Default: `normal` + /// The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + /// shares. Can be one of low, normal, high, or custom. /// [Input("cpuShareLevel")] public Input? CpuShareLevel { get; set; } /// - /// The number of shares allocated for CPU. Used to - /// determine resource allocation in case of resource contention. If this is set, - /// `cpu_share_level` must be `custom`. + /// The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + /// cpu_share_level must be custom. /// [Input("cpuShares")] public Input? CpuShares { get; set; } @@ -338,67 +204,54 @@ public InputMap CustomAttributes } /// - /// Determines if the reservation on a resource - /// pool can grow beyond the specified value if the parent resource pool has - /// unreserved resources. Default: `true` + /// Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + /// unreserved resources. /// [Input("memoryExpandable")] public Input? MemoryExpandable { get; set; } /// - /// The CPU utilization of a resource pool will not - /// exceed this limit, even if there are available resources. Set to `-1` for - /// unlimited. Default: `-1` + /// The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + /// unlimited. /// [Input("memoryLimit")] public Input? MemoryLimit { get; set; } /// - /// Amount of CPU (MHz) that is guaranteed - /// available to the resource pool. Default: `0` + /// Amount of memory (MB) that is guaranteed available to the resource pool. /// [Input("memoryReservation")] public Input? MemoryReservation { get; set; } /// - /// The CPU allocation level. The level is a - /// simplified view of shares. Levels map to a pre-determined set of numeric - /// values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - /// `low`, `normal`, or `high` are specified values in `memory_shares` will be - /// ignored. Default: `normal` + /// The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + /// shares. Can be one of low, normal, high, or custom. /// [Input("memoryShareLevel")] public Input? MemoryShareLevel { get; set; } /// - /// The number of shares allocated for CPU. Used to - /// determine resource allocation in case of resource contention. If this is set, - /// `memory_share_level` must be `custom`. + /// The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + /// memory_share_level must be custom. /// [Input("memoryShares")] public Input? MemoryShares { get; set; } /// - /// The name of the resource pool. + /// Name of resource pool. /// [Input("name")] public Input? Name { get; set; } /// - /// The managed object ID - /// of the parent resource pool. This can be the root resource pool for a cluster - /// or standalone host, or a resource pool itself. When moving a resource pool - /// from one parent resource pool to another, both must share a common root - /// resource pool. + /// The ID of the root resource pool of the compute resource the resource pool is in. /// [Input("parentResourcePoolId", required: true)] public Input ParentResourcePoolId { get; set; } = null!; /// - /// Determines if the shares of all - /// descendants of the resource pool are scaled up or down when the shares - /// of the resource pool are scaled up or down. Can be one of `disabled` or - /// `scaleCpuAndMemoryShares`. Default: `disabled`. + /// Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource + /// pool are scaled up or down. /// [Input("scaleDescendantsShares")] public Input? ScaleDescendantsShares { get; set; } @@ -407,7 +260,7 @@ public InputMap CustomAttributes private InputList? _tags; /// - /// The IDs of any tags to attach to this resource. + /// A list of tag IDs to apply to this object. /// public InputList Tags { @@ -424,42 +277,35 @@ public ResourcePoolArgs() public sealed class ResourcePoolState : global::Pulumi.ResourceArgs { /// - /// Determines if the reservation on a resource - /// pool can grow beyond the specified value if the parent resource pool has - /// unreserved resources. Default: `true` + /// Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + /// unreserved resources. /// [Input("cpuExpandable")] public Input? CpuExpandable { get; set; } /// - /// The CPU utilization of a resource pool will not - /// exceed this limit, even if there are available resources. Set to `-1` for - /// unlimited. Default: `-1` + /// The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + /// unlimited. /// [Input("cpuLimit")] public Input? CpuLimit { get; set; } /// - /// Amount of CPU (MHz) that is guaranteed - /// available to the resource pool. Default: `0` + /// Amount of CPU (MHz) that is guaranteed available to the resource pool. /// [Input("cpuReservation")] public Input? CpuReservation { get; set; } /// - /// The CPU allocation level. The level is a - /// simplified view of shares. Levels map to a pre-determined set of numeric - /// values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - /// `low`, `normal`, or `high` are specified values in `cpu_shares` will be - /// ignored. Default: `normal` + /// The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + /// shares. Can be one of low, normal, high, or custom. /// [Input("cpuShareLevel")] public Input? CpuShareLevel { get; set; } /// - /// The number of shares allocated for CPU. Used to - /// determine resource allocation in case of resource contention. If this is set, - /// `cpu_share_level` must be `custom`. + /// The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + /// cpu_share_level must be custom. /// [Input("cpuShares")] public Input? CpuShares { get; set; } @@ -477,67 +323,54 @@ public InputMap CustomAttributes } /// - /// Determines if the reservation on a resource - /// pool can grow beyond the specified value if the parent resource pool has - /// unreserved resources. Default: `true` + /// Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + /// unreserved resources. /// [Input("memoryExpandable")] public Input? MemoryExpandable { get; set; } /// - /// The CPU utilization of a resource pool will not - /// exceed this limit, even if there are available resources. Set to `-1` for - /// unlimited. Default: `-1` + /// The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + /// unlimited. /// [Input("memoryLimit")] public Input? MemoryLimit { get; set; } /// - /// Amount of CPU (MHz) that is guaranteed - /// available to the resource pool. Default: `0` + /// Amount of memory (MB) that is guaranteed available to the resource pool. /// [Input("memoryReservation")] public Input? MemoryReservation { get; set; } /// - /// The CPU allocation level. The level is a - /// simplified view of shares. Levels map to a pre-determined set of numeric - /// values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - /// `low`, `normal`, or `high` are specified values in `memory_shares` will be - /// ignored. Default: `normal` + /// The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + /// shares. Can be one of low, normal, high, or custom. /// [Input("memoryShareLevel")] public Input? MemoryShareLevel { get; set; } /// - /// The number of shares allocated for CPU. Used to - /// determine resource allocation in case of resource contention. If this is set, - /// `memory_share_level` must be `custom`. + /// The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + /// memory_share_level must be custom. /// [Input("memoryShares")] public Input? MemoryShares { get; set; } /// - /// The name of the resource pool. + /// Name of resource pool. /// [Input("name")] public Input? Name { get; set; } /// - /// The managed object ID - /// of the parent resource pool. This can be the root resource pool for a cluster - /// or standalone host, or a resource pool itself. When moving a resource pool - /// from one parent resource pool to another, both must share a common root - /// resource pool. + /// The ID of the root resource pool of the compute resource the resource pool is in. /// [Input("parentResourcePoolId")] public Input? ParentResourcePoolId { get; set; } /// - /// Determines if the shares of all - /// descendants of the resource pool are scaled up or down when the shares - /// of the resource pool are scaled up or down. Can be one of `disabled` or - /// `scaleCpuAndMemoryShares`. Default: `disabled`. + /// Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource + /// pool are scaled up or down. /// [Input("scaleDescendantsShares")] public Input? ScaleDescendantsShares { get; set; } @@ -546,7 +379,7 @@ public InputMap CustomAttributes private InputList? _tags; /// - /// The IDs of any tags to attach to this resource. + /// A list of tag IDs to apply to this object. /// public InputList Tags { diff --git a/sdk/dotnet/VirtualMachine.cs b/sdk/dotnet/VirtualMachine.cs index 42604409..b1a4550d 100644 --- a/sdk/dotnet/VirtualMachine.cs +++ b/sdk/dotnet/VirtualMachine.cs @@ -18,7 +18,7 @@ namespace Pulumi.VSphere /// /// The following requirements apply to import: /// - /// * The disks must have a [`label`](#label) argument assigned in a convention matching `diskN`, starting with disk number 0, based on each virtual disk order on the SCSI bus. As an example, a disk on SCSI controller `0` with a unit number of `0` would be labeled as `disk0`, a disk on the same controller with a unit number of `1` would be `disk1`, but the next disk, which is on SCSI controller `1` with a unit number of `0`, still becomes `disk2`. + /// * The disks must have a [`label`](#label) argument assigned in a convention matching `Hard Disk`, starting with disk number 0, based on each virtual disk order on the SCSI bus. As an example, a disk on SCSI controller `0` with a unit number of `0` would be labeled as `Hard Disk 0`, a disk on the same controller with a unit number of `1` would be `Hard Disk 1`, but the next disk, which is on SCSI controller `1` with a unit number of `0`, still becomes `Hard Disk 2`. /// /// * Disks are always imported with [`keep_on_remove`](#keep_on_remove) enabled until the first `pulumi up` run which will remove the setting for known disks. This process safeguards against naming or accounting mistakes in the disk configuration. /// diff --git a/sdk/go/vsphere/getHostThumbprint.go b/sdk/go/vsphere/getHostThumbprint.go index 494bfec7..c4a5c36a 100644 --- a/sdk/go/vsphere/getHostThumbprint.go +++ b/sdk/go/vsphere/getHostThumbprint.go @@ -12,9 +12,14 @@ import ( ) // The `vsphereThumbprint` data source can be used to discover the host thumbprint -// of an ESXi host. This can be used when adding the `Host` resource. If -// the ESXi host is using a certificate chain, the first one returned will be used -// to generate the thumbprint. +// of an ESXi host. This can be used when adding the `Host` resource to a +// cluster or a vCenter Server instance. +// +// * If the ESXi host is using a certificate chain, the first one returned will be +// used to generate the thumbprint. +// +// * If the ESXi host has a certificate issued by a certificate authority, ensure +// that the the certificate authority is trusted on the system running the plan. // // ## Example Usage // @@ -56,8 +61,7 @@ type GetHostThumbprintArgs struct { // The address of the ESXi host to retrieve the thumbprint // from. Address string `pulumi:"address"` - // Disables SSL certificate verification. - // Default: `false` + // Disables SSL certificate verification. Default: `false` Insecure *bool `pulumi:"insecure"` // The port to use connecting to the ESXi host. Default: 443 Port *string `pulumi:"port"` @@ -96,8 +100,7 @@ type GetHostThumbprintOutputArgs struct { // The address of the ESXi host to retrieve the thumbprint // from. Address pulumi.StringInput `pulumi:"address"` - // Disables SSL certificate verification. - // Default: `false` + // Disables SSL certificate verification. Default: `false` Insecure pulumi.BoolPtrInput `pulumi:"insecure"` // The port to use connecting to the ESXi host. Default: 443 Port pulumi.StringPtrInput `pulumi:"port"` diff --git a/sdk/go/vsphere/host.go b/sdk/go/vsphere/host.go index aa3c03aa..8e5c9f64 100644 --- a/sdk/go/vsphere/host.go +++ b/sdk/go/vsphere/host.go @@ -38,14 +38,14 @@ import ( // return err // } // thumbprint, err := vsphere.GetHostThumbprint(ctx, &vsphere.GetHostThumbprintArgs{ -// Address: "esx-01.example.com", +// Address: "esxi-01.example.com", // Insecure: pulumi.BoolRef(true), // }, nil) // if err != nil { // return err // } // _, err = vsphere.NewHost(ctx, "esx-01", &vsphere.HostArgs{ -// Hostname: pulumi.String("esx-01.example.com"), +// Hostname: pulumi.String("esxi-01.example.com"), // Username: pulumi.String("root"), // Password: pulumi.String("password"), // License: pulumi.String("00000-00000-00000-00000-00000"), @@ -81,7 +81,7 @@ import ( // // data "vsphere_host" "host" { // -// name = "esx-01.example.com" +// name = "esxi-01.example.com" // // datacenter_id = data.vsphere_datacenter.datacenter.id // @@ -105,7 +105,7 @@ import ( // // data "vsphere_host_thumbprint" "thumbprint" { // -// address = "esx-01.example.com" +// address = "esxi-01.example.com" // // insecure = true // @@ -113,7 +113,7 @@ import ( // // resource "vsphere_host" "esx-01" { // -// hostname = "esx-01.example.com" +// hostname = "esxi-01.example.com" // // username = "root" // @@ -129,7 +129,7 @@ import ( // // resource "vsphere_host" "esx-01" { // -// hostname = "esx-01.example.com" +// hostname = "esxi-01.example.com" // // username = "root" // @@ -161,7 +161,7 @@ import ( // $ pulumi import vsphere:index/host:Host esx-01 host-123 // ``` // -// The above would import the host `esx-01.example.com` with the host ID `host-123`. +// The above would import the host `esxi-01.example.com` with the host ID `host-123`. type Host struct { pulumi.CustomResourceState diff --git a/sdk/go/vsphere/resourcePool.go b/sdk/go/vsphere/resourcePool.go index 2a160445..8f23a321 100644 --- a/sdk/go/vsphere/resourcePool.go +++ b/sdk/go/vsphere/resourcePool.go @@ -12,201 +12,47 @@ import ( "github.com/pulumi/pulumi/sdk/v3/go/pulumi" ) -// The `ResourcePool` resource can be used to create and manage -// resource pools on DRS-enabled vSphere clusters or standalone ESXi hosts. -// -// For more information on vSphere resource pools, please refer to the -// [product documentation][ref-vsphere-resource_pools]. -// -// ## Example Usage -// -// The following example sets up a resource pool in an existing compute cluster -// with the default settings for CPU and memory reservations, shares, and limits. -// -// ```go -// package main -// -// import ( -// -// "github.com/pulumi/pulumi-vsphere/sdk/v4/go/vsphere" -// "github.com/pulumi/pulumi/sdk/v3/go/pulumi" -// -// ) -// -// func main() { -// pulumi.Run(func(ctx *pulumi.Context) error { -// datacenter, err := vsphere.LookupDatacenter(ctx, &vsphere.LookupDatacenterArgs{ -// Name: pulumi.StringRef("dc-01"), -// }, nil) -// if err != nil { -// return err -// } -// computeCluster, err := vsphere.LookupComputeCluster(ctx, &vsphere.LookupComputeClusterArgs{ -// Name: "cluster-01", -// DatacenterId: pulumi.StringRef(datacenter.Id), -// }, nil) -// if err != nil { -// return err -// } -// _, err = vsphere.NewResourcePool(ctx, "resource_pool", &vsphere.ResourcePoolArgs{ -// Name: pulumi.String("resource-pool-01"), -// ParentResourcePoolId: pulumi.String(computeCluster.ResourcePoolId), -// }) -// if err != nil { -// return err -// } -// return nil -// }) -// } -// -// ``` -// -// A virtual machine resource could be targeted to use the default resource pool -// of the cluster using the following: -// -// ```go -// package main -// -// import ( -// -// "github.com/pulumi/pulumi-vsphere/sdk/v4/go/vsphere" -// "github.com/pulumi/pulumi/sdk/v3/go/pulumi" -// -// ) -// -// func main() { -// pulumi.Run(func(ctx *pulumi.Context) error { -// _, err := vsphere.NewVirtualMachine(ctx, "vm", &vsphere.VirtualMachineArgs{ -// ResourcePoolId: pulumi.Any(cluster.ResourcePoolId), -// }) -// if err != nil { -// return err -// } -// return nil -// }) -// } -// -// ``` -// -// The following example sets up a parent resource pool in an existing compute cluster -// with a child resource pool nested below. Each resource pool is configured with -// the default settings for CPU and memory reservations, shares, and limits. -// -// ```go -// package main -// -// import ( -// -// "github.com/pulumi/pulumi-vsphere/sdk/v4/go/vsphere" -// "github.com/pulumi/pulumi/sdk/v3/go/pulumi" -// -// ) -// -// func main() { -// pulumi.Run(func(ctx *pulumi.Context) error { -// datacenter, err := vsphere.LookupDatacenter(ctx, &vsphere.LookupDatacenterArgs{ -// Name: pulumi.StringRef("dc-01"), -// }, nil) -// if err != nil { -// return err -// } -// computeCluster, err := vsphere.LookupComputeCluster(ctx, &vsphere.LookupComputeClusterArgs{ -// Name: "cluster-01", -// DatacenterId: pulumi.StringRef(datacenter.Id), -// }, nil) -// if err != nil { -// return err -// } -// resourcePoolParent, err := vsphere.NewResourcePool(ctx, "resource_pool_parent", &vsphere.ResourcePoolArgs{ -// Name: pulumi.String("parent"), -// ParentResourcePoolId: pulumi.String(computeCluster.ResourcePoolId), -// }) -// if err != nil { -// return err -// } -// _, err = vsphere.NewResourcePool(ctx, "resource_pool_child", &vsphere.ResourcePoolArgs{ -// Name: pulumi.String("child"), -// ParentResourcePoolId: resourcePoolParent.ID(), -// }) -// if err != nil { -// return err -// } -// return nil -// }) -// } -// -// ``` -// -// ## Import -// -// ### Settings that Require vSphere 7.0 or higher -// -// These settings require vSphere 7.0 or higher: -// -// * [`scale_descendants_shares`](#scale_descendants_shares) -// -// [ref-vsphere-resource_pools]: https://docs.vmware.com/en/VMware-vSphere/8.0/vsphere-resource-management/GUID-60077B40-66FF-4625-934A-641703ED7601.html type ResourcePool struct { pulumi.CustomResourceState - // Determines if the reservation on a resource - // pool can grow beyond the specified value if the parent resource pool has - // unreserved resources. Default: `true` + // Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + // unreserved resources. CpuExpandable pulumi.BoolPtrOutput `pulumi:"cpuExpandable"` - // The CPU utilization of a resource pool will not - // exceed this limit, even if there are available resources. Set to `-1` for - // unlimited. Default: `-1` + // The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + // unlimited. CpuLimit pulumi.IntPtrOutput `pulumi:"cpuLimit"` - // Amount of CPU (MHz) that is guaranteed - // available to the resource pool. Default: `0` + // Amount of CPU (MHz) that is guaranteed available to the resource pool. CpuReservation pulumi.IntPtrOutput `pulumi:"cpuReservation"` - // The CPU allocation level. The level is a - // simplified view of shares. Levels map to a pre-determined set of numeric - // values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - // `low`, `normal`, or `high` are specified values in `cpuShares` will be - // ignored. Default: `normal` + // The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + // shares. Can be one of low, normal, high, or custom. CpuShareLevel pulumi.StringPtrOutput `pulumi:"cpuShareLevel"` - // The number of shares allocated for CPU. Used to - // determine resource allocation in case of resource contention. If this is set, - // `cpuShareLevel` must be `custom`. + // The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + // cpuShareLevel must be custom. CpuShares pulumi.IntOutput `pulumi:"cpuShares"` // A list of custom attributes to set on this resource. CustomAttributes pulumi.StringMapOutput `pulumi:"customAttributes"` - // Determines if the reservation on a resource - // pool can grow beyond the specified value if the parent resource pool has - // unreserved resources. Default: `true` + // Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + // unreserved resources. MemoryExpandable pulumi.BoolPtrOutput `pulumi:"memoryExpandable"` - // The CPU utilization of a resource pool will not - // exceed this limit, even if there are available resources. Set to `-1` for - // unlimited. Default: `-1` + // The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + // unlimited. MemoryLimit pulumi.IntPtrOutput `pulumi:"memoryLimit"` - // Amount of CPU (MHz) that is guaranteed - // available to the resource pool. Default: `0` + // Amount of memory (MB) that is guaranteed available to the resource pool. MemoryReservation pulumi.IntPtrOutput `pulumi:"memoryReservation"` - // The CPU allocation level. The level is a - // simplified view of shares. Levels map to a pre-determined set of numeric - // values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - // `low`, `normal`, or `high` are specified values in `memoryShares` will be - // ignored. Default: `normal` + // The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + // shares. Can be one of low, normal, high, or custom. MemoryShareLevel pulumi.StringPtrOutput `pulumi:"memoryShareLevel"` - // The number of shares allocated for CPU. Used to - // determine resource allocation in case of resource contention. If this is set, - // `memoryShareLevel` must be `custom`. + // The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + // memoryShareLevel must be custom. MemoryShares pulumi.IntOutput `pulumi:"memoryShares"` - // The name of the resource pool. + // Name of resource pool. Name pulumi.StringOutput `pulumi:"name"` - // The managed object ID - // of the parent resource pool. This can be the root resource pool for a cluster - // or standalone host, or a resource pool itself. When moving a resource pool - // from one parent resource pool to another, both must share a common root - // resource pool. + // The ID of the root resource pool of the compute resource the resource pool is in. ParentResourcePoolId pulumi.StringOutput `pulumi:"parentResourcePoolId"` - // Determines if the shares of all - // descendants of the resource pool are scaled up or down when the shares - // of the resource pool are scaled up or down. Can be one of `disabled` or - // `scaleCpuAndMemoryShares`. Default: `disabled`. + // Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource + // pool are scaled up or down. ScaleDescendantsShares pulumi.StringPtrOutput `pulumi:"scaleDescendantsShares"` - // The IDs of any tags to attach to this resource. + // A list of tag IDs to apply to this object. Tags pulumi.StringArrayOutput `pulumi:"tags"` } @@ -243,126 +89,86 @@ func GetResourcePool(ctx *pulumi.Context, // Input properties used for looking up and filtering ResourcePool resources. type resourcePoolState struct { - // Determines if the reservation on a resource - // pool can grow beyond the specified value if the parent resource pool has - // unreserved resources. Default: `true` + // Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + // unreserved resources. CpuExpandable *bool `pulumi:"cpuExpandable"` - // The CPU utilization of a resource pool will not - // exceed this limit, even if there are available resources. Set to `-1` for - // unlimited. Default: `-1` + // The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + // unlimited. CpuLimit *int `pulumi:"cpuLimit"` - // Amount of CPU (MHz) that is guaranteed - // available to the resource pool. Default: `0` + // Amount of CPU (MHz) that is guaranteed available to the resource pool. CpuReservation *int `pulumi:"cpuReservation"` - // The CPU allocation level. The level is a - // simplified view of shares. Levels map to a pre-determined set of numeric - // values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - // `low`, `normal`, or `high` are specified values in `cpuShares` will be - // ignored. Default: `normal` + // The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + // shares. Can be one of low, normal, high, or custom. CpuShareLevel *string `pulumi:"cpuShareLevel"` - // The number of shares allocated for CPU. Used to - // determine resource allocation in case of resource contention. If this is set, - // `cpuShareLevel` must be `custom`. + // The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + // cpuShareLevel must be custom. CpuShares *int `pulumi:"cpuShares"` // A list of custom attributes to set on this resource. CustomAttributes map[string]string `pulumi:"customAttributes"` - // Determines if the reservation on a resource - // pool can grow beyond the specified value if the parent resource pool has - // unreserved resources. Default: `true` + // Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + // unreserved resources. MemoryExpandable *bool `pulumi:"memoryExpandable"` - // The CPU utilization of a resource pool will not - // exceed this limit, even if there are available resources. Set to `-1` for - // unlimited. Default: `-1` + // The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + // unlimited. MemoryLimit *int `pulumi:"memoryLimit"` - // Amount of CPU (MHz) that is guaranteed - // available to the resource pool. Default: `0` + // Amount of memory (MB) that is guaranteed available to the resource pool. MemoryReservation *int `pulumi:"memoryReservation"` - // The CPU allocation level. The level is a - // simplified view of shares. Levels map to a pre-determined set of numeric - // values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - // `low`, `normal`, or `high` are specified values in `memoryShares` will be - // ignored. Default: `normal` + // The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + // shares. Can be one of low, normal, high, or custom. MemoryShareLevel *string `pulumi:"memoryShareLevel"` - // The number of shares allocated for CPU. Used to - // determine resource allocation in case of resource contention. If this is set, - // `memoryShareLevel` must be `custom`. + // The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + // memoryShareLevel must be custom. MemoryShares *int `pulumi:"memoryShares"` - // The name of the resource pool. + // Name of resource pool. Name *string `pulumi:"name"` - // The managed object ID - // of the parent resource pool. This can be the root resource pool for a cluster - // or standalone host, or a resource pool itself. When moving a resource pool - // from one parent resource pool to another, both must share a common root - // resource pool. + // The ID of the root resource pool of the compute resource the resource pool is in. ParentResourcePoolId *string `pulumi:"parentResourcePoolId"` - // Determines if the shares of all - // descendants of the resource pool are scaled up or down when the shares - // of the resource pool are scaled up or down. Can be one of `disabled` or - // `scaleCpuAndMemoryShares`. Default: `disabled`. + // Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource + // pool are scaled up or down. ScaleDescendantsShares *string `pulumi:"scaleDescendantsShares"` - // The IDs of any tags to attach to this resource. + // A list of tag IDs to apply to this object. Tags []string `pulumi:"tags"` } type ResourcePoolState struct { - // Determines if the reservation on a resource - // pool can grow beyond the specified value if the parent resource pool has - // unreserved resources. Default: `true` + // Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + // unreserved resources. CpuExpandable pulumi.BoolPtrInput - // The CPU utilization of a resource pool will not - // exceed this limit, even if there are available resources. Set to `-1` for - // unlimited. Default: `-1` + // The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + // unlimited. CpuLimit pulumi.IntPtrInput - // Amount of CPU (MHz) that is guaranteed - // available to the resource pool. Default: `0` + // Amount of CPU (MHz) that is guaranteed available to the resource pool. CpuReservation pulumi.IntPtrInput - // The CPU allocation level. The level is a - // simplified view of shares. Levels map to a pre-determined set of numeric - // values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - // `low`, `normal`, or `high` are specified values in `cpuShares` will be - // ignored. Default: `normal` + // The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + // shares. Can be one of low, normal, high, or custom. CpuShareLevel pulumi.StringPtrInput - // The number of shares allocated for CPU. Used to - // determine resource allocation in case of resource contention. If this is set, - // `cpuShareLevel` must be `custom`. + // The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + // cpuShareLevel must be custom. CpuShares pulumi.IntPtrInput // A list of custom attributes to set on this resource. CustomAttributes pulumi.StringMapInput - // Determines if the reservation on a resource - // pool can grow beyond the specified value if the parent resource pool has - // unreserved resources. Default: `true` + // Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + // unreserved resources. MemoryExpandable pulumi.BoolPtrInput - // The CPU utilization of a resource pool will not - // exceed this limit, even if there are available resources. Set to `-1` for - // unlimited. Default: `-1` + // The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + // unlimited. MemoryLimit pulumi.IntPtrInput - // Amount of CPU (MHz) that is guaranteed - // available to the resource pool. Default: `0` + // Amount of memory (MB) that is guaranteed available to the resource pool. MemoryReservation pulumi.IntPtrInput - // The CPU allocation level. The level is a - // simplified view of shares. Levels map to a pre-determined set of numeric - // values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - // `low`, `normal`, or `high` are specified values in `memoryShares` will be - // ignored. Default: `normal` + // The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + // shares. Can be one of low, normal, high, or custom. MemoryShareLevel pulumi.StringPtrInput - // The number of shares allocated for CPU. Used to - // determine resource allocation in case of resource contention. If this is set, - // `memoryShareLevel` must be `custom`. + // The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + // memoryShareLevel must be custom. MemoryShares pulumi.IntPtrInput - // The name of the resource pool. + // Name of resource pool. Name pulumi.StringPtrInput - // The managed object ID - // of the parent resource pool. This can be the root resource pool for a cluster - // or standalone host, or a resource pool itself. When moving a resource pool - // from one parent resource pool to another, both must share a common root - // resource pool. + // The ID of the root resource pool of the compute resource the resource pool is in. ParentResourcePoolId pulumi.StringPtrInput - // Determines if the shares of all - // descendants of the resource pool are scaled up or down when the shares - // of the resource pool are scaled up or down. Can be one of `disabled` or - // `scaleCpuAndMemoryShares`. Default: `disabled`. + // Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource + // pool are scaled up or down. ScaleDescendantsShares pulumi.StringPtrInput - // The IDs of any tags to attach to this resource. + // A list of tag IDs to apply to this object. Tags pulumi.StringArrayInput } @@ -371,127 +177,87 @@ func (ResourcePoolState) ElementType() reflect.Type { } type resourcePoolArgs struct { - // Determines if the reservation on a resource - // pool can grow beyond the specified value if the parent resource pool has - // unreserved resources. Default: `true` + // Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + // unreserved resources. CpuExpandable *bool `pulumi:"cpuExpandable"` - // The CPU utilization of a resource pool will not - // exceed this limit, even if there are available resources. Set to `-1` for - // unlimited. Default: `-1` + // The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + // unlimited. CpuLimit *int `pulumi:"cpuLimit"` - // Amount of CPU (MHz) that is guaranteed - // available to the resource pool. Default: `0` + // Amount of CPU (MHz) that is guaranteed available to the resource pool. CpuReservation *int `pulumi:"cpuReservation"` - // The CPU allocation level. The level is a - // simplified view of shares. Levels map to a pre-determined set of numeric - // values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - // `low`, `normal`, or `high` are specified values in `cpuShares` will be - // ignored. Default: `normal` + // The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + // shares. Can be one of low, normal, high, or custom. CpuShareLevel *string `pulumi:"cpuShareLevel"` - // The number of shares allocated for CPU. Used to - // determine resource allocation in case of resource contention. If this is set, - // `cpuShareLevel` must be `custom`. + // The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + // cpuShareLevel must be custom. CpuShares *int `pulumi:"cpuShares"` // A list of custom attributes to set on this resource. CustomAttributes map[string]string `pulumi:"customAttributes"` - // Determines if the reservation on a resource - // pool can grow beyond the specified value if the parent resource pool has - // unreserved resources. Default: `true` + // Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + // unreserved resources. MemoryExpandable *bool `pulumi:"memoryExpandable"` - // The CPU utilization of a resource pool will not - // exceed this limit, even if there are available resources. Set to `-1` for - // unlimited. Default: `-1` + // The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + // unlimited. MemoryLimit *int `pulumi:"memoryLimit"` - // Amount of CPU (MHz) that is guaranteed - // available to the resource pool. Default: `0` + // Amount of memory (MB) that is guaranteed available to the resource pool. MemoryReservation *int `pulumi:"memoryReservation"` - // The CPU allocation level. The level is a - // simplified view of shares. Levels map to a pre-determined set of numeric - // values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - // `low`, `normal`, or `high` are specified values in `memoryShares` will be - // ignored. Default: `normal` + // The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + // shares. Can be one of low, normal, high, or custom. MemoryShareLevel *string `pulumi:"memoryShareLevel"` - // The number of shares allocated for CPU. Used to - // determine resource allocation in case of resource contention. If this is set, - // `memoryShareLevel` must be `custom`. + // The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + // memoryShareLevel must be custom. MemoryShares *int `pulumi:"memoryShares"` - // The name of the resource pool. + // Name of resource pool. Name *string `pulumi:"name"` - // The managed object ID - // of the parent resource pool. This can be the root resource pool for a cluster - // or standalone host, or a resource pool itself. When moving a resource pool - // from one parent resource pool to another, both must share a common root - // resource pool. + // The ID of the root resource pool of the compute resource the resource pool is in. ParentResourcePoolId string `pulumi:"parentResourcePoolId"` - // Determines if the shares of all - // descendants of the resource pool are scaled up or down when the shares - // of the resource pool are scaled up or down. Can be one of `disabled` or - // `scaleCpuAndMemoryShares`. Default: `disabled`. + // Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource + // pool are scaled up or down. ScaleDescendantsShares *string `pulumi:"scaleDescendantsShares"` - // The IDs of any tags to attach to this resource. + // A list of tag IDs to apply to this object. Tags []string `pulumi:"tags"` } // The set of arguments for constructing a ResourcePool resource. type ResourcePoolArgs struct { - // Determines if the reservation on a resource - // pool can grow beyond the specified value if the parent resource pool has - // unreserved resources. Default: `true` + // Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + // unreserved resources. CpuExpandable pulumi.BoolPtrInput - // The CPU utilization of a resource pool will not - // exceed this limit, even if there are available resources. Set to `-1` for - // unlimited. Default: `-1` + // The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + // unlimited. CpuLimit pulumi.IntPtrInput - // Amount of CPU (MHz) that is guaranteed - // available to the resource pool. Default: `0` + // Amount of CPU (MHz) that is guaranteed available to the resource pool. CpuReservation pulumi.IntPtrInput - // The CPU allocation level. The level is a - // simplified view of shares. Levels map to a pre-determined set of numeric - // values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - // `low`, `normal`, or `high` are specified values in `cpuShares` will be - // ignored. Default: `normal` + // The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + // shares. Can be one of low, normal, high, or custom. CpuShareLevel pulumi.StringPtrInput - // The number of shares allocated for CPU. Used to - // determine resource allocation in case of resource contention. If this is set, - // `cpuShareLevel` must be `custom`. + // The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + // cpuShareLevel must be custom. CpuShares pulumi.IntPtrInput // A list of custom attributes to set on this resource. CustomAttributes pulumi.StringMapInput - // Determines if the reservation on a resource - // pool can grow beyond the specified value if the parent resource pool has - // unreserved resources. Default: `true` + // Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + // unreserved resources. MemoryExpandable pulumi.BoolPtrInput - // The CPU utilization of a resource pool will not - // exceed this limit, even if there are available resources. Set to `-1` for - // unlimited. Default: `-1` + // The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + // unlimited. MemoryLimit pulumi.IntPtrInput - // Amount of CPU (MHz) that is guaranteed - // available to the resource pool. Default: `0` + // Amount of memory (MB) that is guaranteed available to the resource pool. MemoryReservation pulumi.IntPtrInput - // The CPU allocation level. The level is a - // simplified view of shares. Levels map to a pre-determined set of numeric - // values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - // `low`, `normal`, or `high` are specified values in `memoryShares` will be - // ignored. Default: `normal` + // The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + // shares. Can be one of low, normal, high, or custom. MemoryShareLevel pulumi.StringPtrInput - // The number of shares allocated for CPU. Used to - // determine resource allocation in case of resource contention. If this is set, - // `memoryShareLevel` must be `custom`. + // The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + // memoryShareLevel must be custom. MemoryShares pulumi.IntPtrInput - // The name of the resource pool. + // Name of resource pool. Name pulumi.StringPtrInput - // The managed object ID - // of the parent resource pool. This can be the root resource pool for a cluster - // or standalone host, or a resource pool itself. When moving a resource pool - // from one parent resource pool to another, both must share a common root - // resource pool. + // The ID of the root resource pool of the compute resource the resource pool is in. ParentResourcePoolId pulumi.StringInput - // Determines if the shares of all - // descendants of the resource pool are scaled up or down when the shares - // of the resource pool are scaled up or down. Can be one of `disabled` or - // `scaleCpuAndMemoryShares`. Default: `disabled`. + // Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource + // pool are scaled up or down. ScaleDescendantsShares pulumi.StringPtrInput - // The IDs of any tags to attach to this resource. + // A list of tag IDs to apply to this object. Tags pulumi.StringArrayInput } @@ -582,38 +348,31 @@ func (o ResourcePoolOutput) ToResourcePoolOutputWithContext(ctx context.Context) return o } -// Determines if the reservation on a resource -// pool can grow beyond the specified value if the parent resource pool has -// unreserved resources. Default: `true` +// Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has +// unreserved resources. func (o ResourcePoolOutput) CpuExpandable() pulumi.BoolPtrOutput { return o.ApplyT(func(v *ResourcePool) pulumi.BoolPtrOutput { return v.CpuExpandable }).(pulumi.BoolPtrOutput) } -// The CPU utilization of a resource pool will not -// exceed this limit, even if there are available resources. Set to `-1` for -// unlimited. Default: `-1` +// The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for +// unlimited. func (o ResourcePoolOutput) CpuLimit() pulumi.IntPtrOutput { return o.ApplyT(func(v *ResourcePool) pulumi.IntPtrOutput { return v.CpuLimit }).(pulumi.IntPtrOutput) } -// Amount of CPU (MHz) that is guaranteed -// available to the resource pool. Default: `0` +// Amount of CPU (MHz) that is guaranteed available to the resource pool. func (o ResourcePoolOutput) CpuReservation() pulumi.IntPtrOutput { return o.ApplyT(func(v *ResourcePool) pulumi.IntPtrOutput { return v.CpuReservation }).(pulumi.IntPtrOutput) } -// The CPU allocation level. The level is a -// simplified view of shares. Levels map to a pre-determined set of numeric -// values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When -// `low`, `normal`, or `high` are specified values in `cpuShares` will be -// ignored. Default: `normal` +// The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for +// shares. Can be one of low, normal, high, or custom. func (o ResourcePoolOutput) CpuShareLevel() pulumi.StringPtrOutput { return o.ApplyT(func(v *ResourcePool) pulumi.StringPtrOutput { return v.CpuShareLevel }).(pulumi.StringPtrOutput) } -// The number of shares allocated for CPU. Used to -// determine resource allocation in case of resource contention. If this is set, -// `cpuShareLevel` must be `custom`. +// The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, +// cpuShareLevel must be custom. func (o ResourcePoolOutput) CpuShares() pulumi.IntOutput { return o.ApplyT(func(v *ResourcePool) pulumi.IntOutput { return v.CpuShares }).(pulumi.IntOutput) } @@ -623,65 +382,52 @@ func (o ResourcePoolOutput) CustomAttributes() pulumi.StringMapOutput { return o.ApplyT(func(v *ResourcePool) pulumi.StringMapOutput { return v.CustomAttributes }).(pulumi.StringMapOutput) } -// Determines if the reservation on a resource -// pool can grow beyond the specified value if the parent resource pool has -// unreserved resources. Default: `true` +// Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has +// unreserved resources. func (o ResourcePoolOutput) MemoryExpandable() pulumi.BoolPtrOutput { return o.ApplyT(func(v *ResourcePool) pulumi.BoolPtrOutput { return v.MemoryExpandable }).(pulumi.BoolPtrOutput) } -// The CPU utilization of a resource pool will not -// exceed this limit, even if there are available resources. Set to `-1` for -// unlimited. Default: `-1` +// The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for +// unlimited. func (o ResourcePoolOutput) MemoryLimit() pulumi.IntPtrOutput { return o.ApplyT(func(v *ResourcePool) pulumi.IntPtrOutput { return v.MemoryLimit }).(pulumi.IntPtrOutput) } -// Amount of CPU (MHz) that is guaranteed -// available to the resource pool. Default: `0` +// Amount of memory (MB) that is guaranteed available to the resource pool. func (o ResourcePoolOutput) MemoryReservation() pulumi.IntPtrOutput { return o.ApplyT(func(v *ResourcePool) pulumi.IntPtrOutput { return v.MemoryReservation }).(pulumi.IntPtrOutput) } -// The CPU allocation level. The level is a -// simplified view of shares. Levels map to a pre-determined set of numeric -// values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When -// `low`, `normal`, or `high` are specified values in `memoryShares` will be -// ignored. Default: `normal` +// The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for +// shares. Can be one of low, normal, high, or custom. func (o ResourcePoolOutput) MemoryShareLevel() pulumi.StringPtrOutput { return o.ApplyT(func(v *ResourcePool) pulumi.StringPtrOutput { return v.MemoryShareLevel }).(pulumi.StringPtrOutput) } -// The number of shares allocated for CPU. Used to -// determine resource allocation in case of resource contention. If this is set, -// `memoryShareLevel` must be `custom`. +// The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, +// memoryShareLevel must be custom. func (o ResourcePoolOutput) MemoryShares() pulumi.IntOutput { return o.ApplyT(func(v *ResourcePool) pulumi.IntOutput { return v.MemoryShares }).(pulumi.IntOutput) } -// The name of the resource pool. +// Name of resource pool. func (o ResourcePoolOutput) Name() pulumi.StringOutput { return o.ApplyT(func(v *ResourcePool) pulumi.StringOutput { return v.Name }).(pulumi.StringOutput) } -// The managed object ID -// of the parent resource pool. This can be the root resource pool for a cluster -// or standalone host, or a resource pool itself. When moving a resource pool -// from one parent resource pool to another, both must share a common root -// resource pool. +// The ID of the root resource pool of the compute resource the resource pool is in. func (o ResourcePoolOutput) ParentResourcePoolId() pulumi.StringOutput { return o.ApplyT(func(v *ResourcePool) pulumi.StringOutput { return v.ParentResourcePoolId }).(pulumi.StringOutput) } -// Determines if the shares of all -// descendants of the resource pool are scaled up or down when the shares -// of the resource pool are scaled up or down. Can be one of `disabled` or -// `scaleCpuAndMemoryShares`. Default: `disabled`. +// Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource +// pool are scaled up or down. func (o ResourcePoolOutput) ScaleDescendantsShares() pulumi.StringPtrOutput { return o.ApplyT(func(v *ResourcePool) pulumi.StringPtrOutput { return v.ScaleDescendantsShares }).(pulumi.StringPtrOutput) } -// The IDs of any tags to attach to this resource. +// A list of tag IDs to apply to this object. func (o ResourcePoolOutput) Tags() pulumi.StringArrayOutput { return o.ApplyT(func(v *ResourcePool) pulumi.StringArrayOutput { return v.Tags }).(pulumi.StringArrayOutput) } diff --git a/sdk/go/vsphere/virtualMachine.go b/sdk/go/vsphere/virtualMachine.go index 48dcc6f3..15ca0a9e 100644 --- a/sdk/go/vsphere/virtualMachine.go +++ b/sdk/go/vsphere/virtualMachine.go @@ -20,7 +20,7 @@ import ( // // The following requirements apply to import: // -// * The disks must have a [`label`](#label) argument assigned in a convention matching `diskN`, starting with disk number 0, based on each virtual disk order on the SCSI bus. As an example, a disk on SCSI controller `0` with a unit number of `0` would be labeled as `disk0`, a disk on the same controller with a unit number of `1` would be `disk1`, but the next disk, which is on SCSI controller `1` with a unit number of `0`, still becomes `disk2`. +// * The disks must have a [`label`](#label) argument assigned in a convention matching `Hard Disk`, starting with disk number 0, based on each virtual disk order on the SCSI bus. As an example, a disk on SCSI controller `0` with a unit number of `0` would be labeled as `Hard Disk 0`, a disk on the same controller with a unit number of `1` would be `Hard Disk 1`, but the next disk, which is on SCSI controller `1` with a unit number of `0`, still becomes `Hard Disk 2`. // // * Disks are always imported with [`keep_on_remove`](#keep_on_remove) enabled until the first `pulumi up` run which will remove the setting for known disks. This process safeguards against naming or accounting mistakes in the disk configuration. // diff --git a/sdk/java/src/main/java/com/pulumi/vsphere/Host.java b/sdk/java/src/main/java/com/pulumi/vsphere/Host.java index 78eac26c..3e98b572 100644 --- a/sdk/java/src/main/java/com/pulumi/vsphere/Host.java +++ b/sdk/java/src/main/java/com/pulumi/vsphere/Host.java @@ -57,12 +57,12 @@ * .build()); * * final var thumbprint = VsphereFunctions.getHostThumbprint(GetHostThumbprintArgs.builder() - * .address("esx-01.example.com") + * .address("esxi-01.example.com") * .insecure(true) * .build()); * * var esx_01 = new Host("esx-01", HostArgs.builder() - * .hostname("esx-01.example.com") + * .hostname("esxi-01.example.com") * .username("root") * .password("password") * .license("00000-00000-00000-00000-00000") @@ -96,7 +96,7 @@ * * data "vsphere_host" "host" { * - * name = "esx-01.example.com" + * name = "esxi-01.example.com" * * datacenter_id = data.vsphere_datacenter.datacenter.id * @@ -120,7 +120,7 @@ * * data "vsphere_host_thumbprint" "thumbprint" { * - * address = "esx-01.example.com" + * address = "esxi-01.example.com" * * insecure = true * @@ -128,7 +128,7 @@ * * resource "vsphere_host" "esx-01" { * - * hostname = "esx-01.example.com" + * hostname = "esxi-01.example.com" * * username = "root" * @@ -144,7 +144,7 @@ * * resource "vsphere_host" "esx-01" { * - * hostname = "esx-01.example.com" + * hostname = "esxi-01.example.com" * * username = "root" * @@ -176,7 +176,7 @@ * $ pulumi import vsphere:index/host:Host esx-01 host-123 * ``` * - * The above would import the host `esx-01.example.com` with the host ID `host-123`. + * The above would import the host `esxi-01.example.com` with the host ID `host-123`. * */ @ResourceType(type="vsphere:index/host:Host") diff --git a/sdk/java/src/main/java/com/pulumi/vsphere/ResourcePool.java b/sdk/java/src/main/java/com/pulumi/vsphere/ResourcePool.java index e60e4197..0d26bf4f 100644 --- a/sdk/java/src/main/java/com/pulumi/vsphere/ResourcePool.java +++ b/sdk/java/src/main/java/com/pulumi/vsphere/ResourcePool.java @@ -18,255 +18,81 @@ import java.util.Optional; import javax.annotation.Nullable; -/** - * The `vsphere.ResourcePool` resource can be used to create and manage - * resource pools on DRS-enabled vSphere clusters or standalone ESXi hosts. - * - * For more information on vSphere resource pools, please refer to the - * [product documentation][ref-vsphere-resource_pools]. - * - * [ref-vsphere-resource_pools]: https://docs.vmware.com/en/VMware-vSphere/8.0/vsphere-resource-management/GUID-60077B40-66FF-4625-934A-641703ED7601.html - * - * ## Example Usage - * - * The following example sets up a resource pool in an existing compute cluster - * with the default settings for CPU and memory reservations, shares, and limits. - * - * <!--Start PulumiCodeChooser --> - * 
- * {@code
- * package generated_program;
- * 
- * import com.pulumi.Context;
- * import com.pulumi.Pulumi;
- * import com.pulumi.core.Output;
- * import com.pulumi.vsphere.VsphereFunctions;
- * import com.pulumi.vsphere.inputs.GetDatacenterArgs;
- * import com.pulumi.vsphere.inputs.GetComputeClusterArgs;
- * import com.pulumi.vsphere.ResourcePool;
- * import com.pulumi.vsphere.ResourcePoolArgs;
- * import java.util.List;
- * import java.util.ArrayList;
- * import java.util.Map;
- * import java.io.File;
- * import java.nio.file.Files;
- * import java.nio.file.Paths;
- * 
- * public class App {
- *     public static void main(String[] args) {
- *         Pulumi.run(App::stack);
- *     }
- * 
- *     public static void stack(Context ctx) {
- *         final var datacenter = VsphereFunctions.getDatacenter(GetDatacenterArgs.builder()
- *             .name("dc-01")
- *             .build());
- * 
- *         final var computeCluster = VsphereFunctions.getComputeCluster(GetComputeClusterArgs.builder()
- *             .name("cluster-01")
- *             .datacenterId(datacenter.applyValue(getDatacenterResult -> getDatacenterResult.id()))
- *             .build());
- * 
- *         var resourcePool = new ResourcePool("resourcePool", ResourcePoolArgs.builder()
- *             .name("resource-pool-01")
- *             .parentResourcePoolId(computeCluster.applyValue(getComputeClusterResult -> getComputeClusterResult.resourcePoolId()))
- *             .build());
- * 
- *     }
- * }
- * }
- *
- * <!--End PulumiCodeChooser --> - * - * A virtual machine resource could be targeted to use the default resource pool - * of the cluster using the following: - * - * <!--Start PulumiCodeChooser --> - * 
- * {@code
- * package generated_program;
- * 
- * import com.pulumi.Context;
- * import com.pulumi.Pulumi;
- * import com.pulumi.core.Output;
- * import com.pulumi.vsphere.VirtualMachine;
- * import com.pulumi.vsphere.VirtualMachineArgs;
- * import java.util.List;
- * import java.util.ArrayList;
- * import java.util.Map;
- * import java.io.File;
- * import java.nio.file.Files;
- * import java.nio.file.Paths;
- * 
- * public class App {
- *     public static void main(String[] args) {
- *         Pulumi.run(App::stack);
- *     }
- * 
- *     public static void stack(Context ctx) {
- *         var vm = new VirtualMachine("vm", VirtualMachineArgs.builder()
- *             .resourcePoolId(cluster.resourcePoolId())
- *             .build());
- * 
- *     }
- * }
- * }
- *
- * <!--End PulumiCodeChooser --> - * - * The following example sets up a parent resource pool in an existing compute cluster - * with a child resource pool nested below. Each resource pool is configured with - * the default settings for CPU and memory reservations, shares, and limits. - * - * <!--Start PulumiCodeChooser --> - * 
- * {@code
- * package generated_program;
- * 
- * import com.pulumi.Context;
- * import com.pulumi.Pulumi;
- * import com.pulumi.core.Output;
- * import com.pulumi.vsphere.VsphereFunctions;
- * import com.pulumi.vsphere.inputs.GetDatacenterArgs;
- * import com.pulumi.vsphere.inputs.GetComputeClusterArgs;
- * import com.pulumi.vsphere.ResourcePool;
- * import com.pulumi.vsphere.ResourcePoolArgs;
- * import java.util.List;
- * import java.util.ArrayList;
- * import java.util.Map;
- * import java.io.File;
- * import java.nio.file.Files;
- * import java.nio.file.Paths;
- * 
- * public class App {
- *     public static void main(String[] args) {
- *         Pulumi.run(App::stack);
- *     }
- * 
- *     public static void stack(Context ctx) {
- *         final var datacenter = VsphereFunctions.getDatacenter(GetDatacenterArgs.builder()
- *             .name("dc-01")
- *             .build());
- * 
- *         final var computeCluster = VsphereFunctions.getComputeCluster(GetComputeClusterArgs.builder()
- *             .name("cluster-01")
- *             .datacenterId(datacenter.applyValue(getDatacenterResult -> getDatacenterResult.id()))
- *             .build());
- * 
- *         var resourcePoolParent = new ResourcePool("resourcePoolParent", ResourcePoolArgs.builder()
- *             .name("parent")
- *             .parentResourcePoolId(computeCluster.applyValue(getComputeClusterResult -> getComputeClusterResult.resourcePoolId()))
- *             .build());
- * 
- *         var resourcePoolChild = new ResourcePool("resourcePoolChild", ResourcePoolArgs.builder()
- *             .name("child")
- *             .parentResourcePoolId(resourcePoolParent.id())
- *             .build());
- * 
- *     }
- * }
- * }
- *
- * <!--End PulumiCodeChooser --> - * - * ## Import - * - * ### Settings that Require vSphere 7.0 or higher - * - * These settings require vSphere 7.0 or higher: - * - * * [`scale_descendants_shares`](#scale_descendants_shares) - * - */ @ResourceType(type="vsphere:index/resourcePool:ResourcePool") public class ResourcePool extends com.pulumi.resources.CustomResource { /** - * Determines if the reservation on a resource - * pool can grow beyond the specified value if the parent resource pool has - * unreserved resources. Default: `true` + * Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + * unreserved resources. * */ @Export(name="cpuExpandable", refs={Boolean.class}, tree="[0]") private Output cpuExpandable; /** - * @return Determines if the reservation on a resource - * pool can grow beyond the specified value if the parent resource pool has - * unreserved resources. Default: `true` + * @return Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + * unreserved resources. * */ public Output> cpuExpandable() { return Codegen.optional(this.cpuExpandable); } /** - * The CPU utilization of a resource pool will not - * exceed this limit, even if there are available resources. Set to `-1` for - * unlimited. Default: `-1` + * The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + * unlimited. * */ @Export(name="cpuLimit", refs={Integer.class}, tree="[0]") private Output cpuLimit; /** - * @return The CPU utilization of a resource pool will not - * exceed this limit, even if there are available resources. Set to `-1` for - * unlimited. Default: `-1` + * @return The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + * unlimited. * */ public Output> cpuLimit() { return Codegen.optional(this.cpuLimit); } /** - * Amount of CPU (MHz) that is guaranteed - * available to the resource pool. Default: `0` + * Amount of CPU (MHz) that is guaranteed available to the resource pool. * */ @Export(name="cpuReservation", refs={Integer.class}, tree="[0]") private Output cpuReservation; /** - * @return Amount of CPU (MHz) that is guaranteed - * available to the resource pool. Default: `0` + * @return Amount of CPU (MHz) that is guaranteed available to the resource pool. * */ public Output> cpuReservation() { return Codegen.optional(this.cpuReservation); } /** - * The CPU allocation level. The level is a - * simplified view of shares. Levels map to a pre-determined set of numeric - * values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - * `low`, `normal`, or `high` are specified values in `cpu_shares` will be - * ignored. Default: `normal` + * The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + * shares. Can be one of low, normal, high, or custom. * */ @Export(name="cpuShareLevel", refs={String.class}, tree="[0]") private Output cpuShareLevel; /** - * @return The CPU allocation level. The level is a - * simplified view of shares. Levels map to a pre-determined set of numeric - * values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - * `low`, `normal`, or `high` are specified values in `cpu_shares` will be - * ignored. Default: `normal` + * @return The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + * shares. Can be one of low, normal, high, or custom. * */ public Output> cpuShareLevel() { return Codegen.optional(this.cpuShareLevel); } /** - * The number of shares allocated for CPU. Used to - * determine resource allocation in case of resource contention. If this is set, - * `cpu_share_level` must be `custom`. + * The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + * cpu_share_level must be custom. * */ @Export(name="cpuShares", refs={Integer.class}, tree="[0]") private Output cpuShares; /** - * @return The number of shares allocated for CPU. Used to - * determine resource allocation in case of resource contention. If this is set, - * `cpu_share_level` must be `custom`. + * @return The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + * cpu_share_level must be custom. * */ public Output cpuShares() { @@ -287,162 +113,136 @@ public Output>> customAttributes() { return Codegen.optional(this.customAttributes); } /** - * Determines if the reservation on a resource - * pool can grow beyond the specified value if the parent resource pool has - * unreserved resources. Default: `true` + * Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + * unreserved resources. * */ @Export(name="memoryExpandable", refs={Boolean.class}, tree="[0]") private Output memoryExpandable; /** - * @return Determines if the reservation on a resource - * pool can grow beyond the specified value if the parent resource pool has - * unreserved resources. Default: `true` + * @return Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + * unreserved resources. * */ public Output> memoryExpandable() { return Codegen.optional(this.memoryExpandable); } /** - * The CPU utilization of a resource pool will not - * exceed this limit, even if there are available resources. Set to `-1` for - * unlimited. Default: `-1` + * The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + * unlimited. * */ @Export(name="memoryLimit", refs={Integer.class}, tree="[0]") private Output memoryLimit; /** - * @return The CPU utilization of a resource pool will not - * exceed this limit, even if there are available resources. Set to `-1` for - * unlimited. Default: `-1` + * @return The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + * unlimited. * */ public Output> memoryLimit() { return Codegen.optional(this.memoryLimit); } /** - * Amount of CPU (MHz) that is guaranteed - * available to the resource pool. Default: `0` + * Amount of memory (MB) that is guaranteed available to the resource pool. * */ @Export(name="memoryReservation", refs={Integer.class}, tree="[0]") private Output memoryReservation; /** - * @return Amount of CPU (MHz) that is guaranteed - * available to the resource pool. Default: `0` + * @return Amount of memory (MB) that is guaranteed available to the resource pool. * */ public Output> memoryReservation() { return Codegen.optional(this.memoryReservation); } /** - * The CPU allocation level. The level is a - * simplified view of shares. Levels map to a pre-determined set of numeric - * values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - * `low`, `normal`, or `high` are specified values in `memory_shares` will be - * ignored. Default: `normal` + * The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + * shares. Can be one of low, normal, high, or custom. * */ @Export(name="memoryShareLevel", refs={String.class}, tree="[0]") private Output memoryShareLevel; /** - * @return The CPU allocation level. The level is a - * simplified view of shares. Levels map to a pre-determined set of numeric - * values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - * `low`, `normal`, or `high` are specified values in `memory_shares` will be - * ignored. Default: `normal` + * @return The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + * shares. Can be one of low, normal, high, or custom. * */ public Output> memoryShareLevel() { return Codegen.optional(this.memoryShareLevel); } /** - * The number of shares allocated for CPU. Used to - * determine resource allocation in case of resource contention. If this is set, - * `memory_share_level` must be `custom`. + * The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + * memory_share_level must be custom. * */ @Export(name="memoryShares", refs={Integer.class}, tree="[0]") private Output memoryShares; /** - * @return The number of shares allocated for CPU. Used to - * determine resource allocation in case of resource contention. If this is set, - * `memory_share_level` must be `custom`. + * @return The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + * memory_share_level must be custom. * */ public Output memoryShares() { return this.memoryShares; } /** - * The name of the resource pool. + * Name of resource pool. * */ @Export(name="name", refs={String.class}, tree="[0]") private Output name; /** - * @return The name of the resource pool. + * @return Name of resource pool. * */ public Output name() { return this.name; } /** - * The managed object ID - * of the parent resource pool. This can be the root resource pool for a cluster - * or standalone host, or a resource pool itself. When moving a resource pool - * from one parent resource pool to another, both must share a common root - * resource pool. + * The ID of the root resource pool of the compute resource the resource pool is in. * */ @Export(name="parentResourcePoolId", refs={String.class}, tree="[0]") private Output parentResourcePoolId; /** - * @return The managed object ID - * of the parent resource pool. This can be the root resource pool for a cluster - * or standalone host, or a resource pool itself. When moving a resource pool - * from one parent resource pool to another, both must share a common root - * resource pool. + * @return The ID of the root resource pool of the compute resource the resource pool is in. * */ public Output parentResourcePoolId() { return this.parentResourcePoolId; } /** - * Determines if the shares of all - * descendants of the resource pool are scaled up or down when the shares - * of the resource pool are scaled up or down. Can be one of `disabled` or - * `scaleCpuAndMemoryShares`. Default: `disabled`. + * Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource + * pool are scaled up or down. * */ @Export(name="scaleDescendantsShares", refs={String.class}, tree="[0]") private Output scaleDescendantsShares; /** - * @return Determines if the shares of all - * descendants of the resource pool are scaled up or down when the shares - * of the resource pool are scaled up or down. Can be one of `disabled` or - * `scaleCpuAndMemoryShares`. Default: `disabled`. + * @return Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource + * pool are scaled up or down. * */ public Output> scaleDescendantsShares() { return Codegen.optional(this.scaleDescendantsShares); } /** - * The IDs of any tags to attach to this resource. + * A list of tag IDs to apply to this object. * */ @Export(name="tags", refs={List.class,String.class}, tree="[0,1]") private Output> tags; /** - * @return The IDs of any tags to attach to this resource. + * @return A list of tag IDs to apply to this object. * */ public Output>> tags() { diff --git a/sdk/java/src/main/java/com/pulumi/vsphere/ResourcePoolArgs.java b/sdk/java/src/main/java/com/pulumi/vsphere/ResourcePoolArgs.java index 44968e0b..377d180e 100644 --- a/sdk/java/src/main/java/com/pulumi/vsphere/ResourcePoolArgs.java +++ b/sdk/java/src/main/java/com/pulumi/vsphere/ResourcePoolArgs.java @@ -21,18 +21,16 @@ public final class ResourcePoolArgs extends com.pulumi.resources.ResourceArgs { public static final ResourcePoolArgs Empty = new ResourcePoolArgs(); /** - * Determines if the reservation on a resource - * pool can grow beyond the specified value if the parent resource pool has - * unreserved resources. Default: `true` + * Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + * unreserved resources. * */ @Import(name="cpuExpandable") private @Nullable Output cpuExpandable; /** - * @return Determines if the reservation on a resource - * pool can grow beyond the specified value if the parent resource pool has - * unreserved resources. Default: `true` + * @return Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + * unreserved resources. * */ public Optional> cpuExpandable() { @@ -40,18 +38,16 @@ public Optional> cpuExpandable() { } /** - * The CPU utilization of a resource pool will not - * exceed this limit, even if there are available resources. Set to `-1` for - * unlimited. Default: `-1` + * The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + * unlimited. * */ @Import(name="cpuLimit") private @Nullable Output cpuLimit; /** - * @return The CPU utilization of a resource pool will not - * exceed this limit, even if there are available resources. Set to `-1` for - * unlimited. Default: `-1` + * @return The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + * unlimited. * */ public Optional> cpuLimit() { @@ -59,16 +55,14 @@ public Optional> cpuLimit() { } /** - * Amount of CPU (MHz) that is guaranteed - * available to the resource pool. Default: `0` + * Amount of CPU (MHz) that is guaranteed available to the resource pool. * */ @Import(name="cpuReservation") private @Nullable Output cpuReservation; /** - * @return Amount of CPU (MHz) that is guaranteed - * available to the resource pool. Default: `0` + * @return Amount of CPU (MHz) that is guaranteed available to the resource pool. * */ public Optional> cpuReservation() { @@ -76,22 +70,16 @@ public Optional> cpuReservation() { } /** - * The CPU allocation level. The level is a - * simplified view of shares. Levels map to a pre-determined set of numeric - * values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - * `low`, `normal`, or `high` are specified values in `cpu_shares` will be - * ignored. Default: `normal` + * The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + * shares. Can be one of low, normal, high, or custom. * */ @Import(name="cpuShareLevel") private @Nullable Output cpuShareLevel; /** - * @return The CPU allocation level. The level is a - * simplified view of shares. Levels map to a pre-determined set of numeric - * values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - * `low`, `normal`, or `high` are specified values in `cpu_shares` will be - * ignored. Default: `normal` + * @return The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + * shares. Can be one of low, normal, high, or custom. * */ public Optional> cpuShareLevel() { @@ -99,18 +87,16 @@ public Optional> cpuShareLevel() { } /** - * The number of shares allocated for CPU. Used to - * determine resource allocation in case of resource contention. If this is set, - * `cpu_share_level` must be `custom`. + * The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + * cpu_share_level must be custom. * */ @Import(name="cpuShares") private @Nullable Output cpuShares; /** - * @return The number of shares allocated for CPU. Used to - * determine resource allocation in case of resource contention. If this is set, - * `cpu_share_level` must be `custom`. + * @return The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + * cpu_share_level must be custom. * */ public Optional> cpuShares() { @@ -133,18 +119,16 @@ public Optional>> customAttributes() { } /** - * Determines if the reservation on a resource - * pool can grow beyond the specified value if the parent resource pool has - * unreserved resources. Default: `true` + * Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + * unreserved resources. * */ @Import(name="memoryExpandable") private @Nullable Output memoryExpandable; /** - * @return Determines if the reservation on a resource - * pool can grow beyond the specified value if the parent resource pool has - * unreserved resources. Default: `true` + * @return Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + * unreserved resources. * */ public Optional> memoryExpandable() { @@ -152,18 +136,16 @@ public Optional> memoryExpandable() { } /** - * The CPU utilization of a resource pool will not - * exceed this limit, even if there are available resources. Set to `-1` for - * unlimited. Default: `-1` + * The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + * unlimited. * */ @Import(name="memoryLimit") private @Nullable Output memoryLimit; /** - * @return The CPU utilization of a resource pool will not - * exceed this limit, even if there are available resources. Set to `-1` for - * unlimited. Default: `-1` + * @return The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + * unlimited. * */ public Optional> memoryLimit() { @@ -171,16 +153,14 @@ public Optional> memoryLimit() { } /** - * Amount of CPU (MHz) that is guaranteed - * available to the resource pool. Default: `0` + * Amount of memory (MB) that is guaranteed available to the resource pool. * */ @Import(name="memoryReservation") private @Nullable Output memoryReservation; /** - * @return Amount of CPU (MHz) that is guaranteed - * available to the resource pool. Default: `0` + * @return Amount of memory (MB) that is guaranteed available to the resource pool. * */ public Optional> memoryReservation() { @@ -188,22 +168,16 @@ public Optional> memoryReservation() { } /** - * The CPU allocation level. The level is a - * simplified view of shares. Levels map to a pre-determined set of numeric - * values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - * `low`, `normal`, or `high` are specified values in `memory_shares` will be - * ignored. Default: `normal` + * The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + * shares. Can be one of low, normal, high, or custom. * */ @Import(name="memoryShareLevel") private @Nullable Output memoryShareLevel; /** - * @return The CPU allocation level. The level is a - * simplified view of shares. Levels map to a pre-determined set of numeric - * values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - * `low`, `normal`, or `high` are specified values in `memory_shares` will be - * ignored. Default: `normal` + * @return The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + * shares. Can be one of low, normal, high, or custom. * */ public Optional> memoryShareLevel() { @@ -211,18 +185,16 @@ public Optional> memoryShareLevel() { } /** - * The number of shares allocated for CPU. Used to - * determine resource allocation in case of resource contention. If this is set, - * `memory_share_level` must be `custom`. + * The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + * memory_share_level must be custom. * */ @Import(name="memoryShares") private @Nullable Output memoryShares; /** - * @return The number of shares allocated for CPU. Used to - * determine resource allocation in case of resource contention. If this is set, - * `memory_share_level` must be `custom`. + * @return The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + * memory_share_level must be custom. * */ public Optional> memoryShares() { @@ -230,14 +202,14 @@ public Optional> memoryShares() { } /** - * The name of the resource pool. + * Name of resource pool. * */ @Import(name="name") private @Nullable Output name; /** - * @return The name of the resource pool. + * @return Name of resource pool. * */ public Optional> name() { @@ -245,22 +217,14 @@ public Optional> name() { } /** - * The managed object ID - * of the parent resource pool. This can be the root resource pool for a cluster - * or standalone host, or a resource pool itself. When moving a resource pool - * from one parent resource pool to another, both must share a common root - * resource pool. + * The ID of the root resource pool of the compute resource the resource pool is in. * */ @Import(name="parentResourcePoolId", required=true) private Output parentResourcePoolId; /** - * @return The managed object ID - * of the parent resource pool. This can be the root resource pool for a cluster - * or standalone host, or a resource pool itself. When moving a resource pool - * from one parent resource pool to another, both must share a common root - * resource pool. + * @return The ID of the root resource pool of the compute resource the resource pool is in. * */ public Output parentResourcePoolId() { @@ -268,20 +232,16 @@ public Output parentResourcePoolId() { } /** - * Determines if the shares of all - * descendants of the resource pool are scaled up or down when the shares - * of the resource pool are scaled up or down. Can be one of `disabled` or - * `scaleCpuAndMemoryShares`. Default: `disabled`. + * Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource + * pool are scaled up or down. * */ @Import(name="scaleDescendantsShares") private @Nullable Output scaleDescendantsShares; /** - * @return Determines if the shares of all - * descendants of the resource pool are scaled up or down when the shares - * of the resource pool are scaled up or down. Can be one of `disabled` or - * `scaleCpuAndMemoryShares`. Default: `disabled`. + * @return Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource + * pool are scaled up or down. * */ public Optional> scaleDescendantsShares() { @@ -289,14 +249,14 @@ public Optional> scaleDescendantsShares() { } /** - * The IDs of any tags to attach to this resource. + * A list of tag IDs to apply to this object. * */ @Import(name="tags") private @Nullable Output> tags; /** - * @return The IDs of any tags to attach to this resource. + * @return A list of tag IDs to apply to this object. * */ public Optional>> tags() { @@ -342,9 +302,8 @@ public Builder(ResourcePoolArgs defaults) { } /** - * @param cpuExpandable Determines if the reservation on a resource - * pool can grow beyond the specified value if the parent resource pool has - * unreserved resources. Default: `true` + * @param cpuExpandable Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + * unreserved resources. * * @return builder * @@ -355,9 +314,8 @@ public Builder cpuExpandable(@Nullable Output cpuExpandable) { } /** - * @param cpuExpandable Determines if the reservation on a resource - * pool can grow beyond the specified value if the parent resource pool has - * unreserved resources. Default: `true` + * @param cpuExpandable Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + * unreserved resources. * * @return builder * @@ -367,9 +325,8 @@ public Builder cpuExpandable(Boolean cpuExpandable) { } /** - * @param cpuLimit The CPU utilization of a resource pool will not - * exceed this limit, even if there are available resources. Set to `-1` for - * unlimited. Default: `-1` + * @param cpuLimit The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + * unlimited. * * @return builder * @@ -380,9 +337,8 @@ public Builder cpuLimit(@Nullable Output cpuLimit) { } /** - * @param cpuLimit The CPU utilization of a resource pool will not - * exceed this limit, even if there are available resources. Set to `-1` for - * unlimited. Default: `-1` + * @param cpuLimit The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + * unlimited. * * @return builder * @@ -392,8 +348,7 @@ public Builder cpuLimit(Integer cpuLimit) { } /** - * @param cpuReservation Amount of CPU (MHz) that is guaranteed - * available to the resource pool. Default: `0` + * @param cpuReservation Amount of CPU (MHz) that is guaranteed available to the resource pool. * * @return builder * @@ -404,8 +359,7 @@ public Builder cpuReservation(@Nullable Output cpuReservation) { } /** - * @param cpuReservation Amount of CPU (MHz) that is guaranteed - * available to the resource pool. Default: `0` + * @param cpuReservation Amount of CPU (MHz) that is guaranteed available to the resource pool. * * @return builder * @@ -415,11 +369,8 @@ public Builder cpuReservation(Integer cpuReservation) { } /** - * @param cpuShareLevel The CPU allocation level. The level is a - * simplified view of shares. Levels map to a pre-determined set of numeric - * values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - * `low`, `normal`, or `high` are specified values in `cpu_shares` will be - * ignored. Default: `normal` + * @param cpuShareLevel The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + * shares. Can be one of low, normal, high, or custom. * * @return builder * @@ -430,11 +381,8 @@ public Builder cpuShareLevel(@Nullable Output cpuShareLevel) { } /** - * @param cpuShareLevel The CPU allocation level. The level is a - * simplified view of shares. Levels map to a pre-determined set of numeric - * values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - * `low`, `normal`, or `high` are specified values in `cpu_shares` will be - * ignored. Default: `normal` + * @param cpuShareLevel The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + * shares. Can be one of low, normal, high, or custom. * * @return builder * @@ -444,9 +392,8 @@ public Builder cpuShareLevel(String cpuShareLevel) { } /** - * @param cpuShares The number of shares allocated for CPU. Used to - * determine resource allocation in case of resource contention. If this is set, - * `cpu_share_level` must be `custom`. + * @param cpuShares The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + * cpu_share_level must be custom. * * @return builder * @@ -457,9 +404,8 @@ public Builder cpuShares(@Nullable Output cpuShares) { } /** - * @param cpuShares The number of shares allocated for CPU. Used to - * determine resource allocation in case of resource contention. If this is set, - * `cpu_share_level` must be `custom`. + * @param cpuShares The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + * cpu_share_level must be custom. * * @return builder * @@ -490,9 +436,8 @@ public Builder customAttributes(Map customAttributes) { } /** - * @param memoryExpandable Determines if the reservation on a resource - * pool can grow beyond the specified value if the parent resource pool has - * unreserved resources. Default: `true` + * @param memoryExpandable Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + * unreserved resources. * * @return builder * @@ -503,9 +448,8 @@ public Builder memoryExpandable(@Nullable Output memoryExpandable) { } /** - * @param memoryExpandable Determines if the reservation on a resource - * pool can grow beyond the specified value if the parent resource pool has - * unreserved resources. Default: `true` + * @param memoryExpandable Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + * unreserved resources. * * @return builder * @@ -515,9 +459,8 @@ public Builder memoryExpandable(Boolean memoryExpandable) { } /** - * @param memoryLimit The CPU utilization of a resource pool will not - * exceed this limit, even if there are available resources. Set to `-1` for - * unlimited. Default: `-1` + * @param memoryLimit The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + * unlimited. * * @return builder * @@ -528,9 +471,8 @@ public Builder memoryLimit(@Nullable Output memoryLimit) { } /** - * @param memoryLimit The CPU utilization of a resource pool will not - * exceed this limit, even if there are available resources. Set to `-1` for - * unlimited. Default: `-1` + * @param memoryLimit The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + * unlimited. * * @return builder * @@ -540,8 +482,7 @@ public Builder memoryLimit(Integer memoryLimit) { } /** - * @param memoryReservation Amount of CPU (MHz) that is guaranteed - * available to the resource pool. Default: `0` + * @param memoryReservation Amount of memory (MB) that is guaranteed available to the resource pool. * * @return builder * @@ -552,8 +493,7 @@ public Builder memoryReservation(@Nullable Output memoryReservation) { } /** - * @param memoryReservation Amount of CPU (MHz) that is guaranteed - * available to the resource pool. Default: `0` + * @param memoryReservation Amount of memory (MB) that is guaranteed available to the resource pool. * * @return builder * @@ -563,11 +503,8 @@ public Builder memoryReservation(Integer memoryReservation) { } /** - * @param memoryShareLevel The CPU allocation level. The level is a - * simplified view of shares. Levels map to a pre-determined set of numeric - * values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - * `low`, `normal`, or `high` are specified values in `memory_shares` will be - * ignored. Default: `normal` + * @param memoryShareLevel The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + * shares. Can be one of low, normal, high, or custom. * * @return builder * @@ -578,11 +515,8 @@ public Builder memoryShareLevel(@Nullable Output memoryShareLevel) { } /** - * @param memoryShareLevel The CPU allocation level. The level is a - * simplified view of shares. Levels map to a pre-determined set of numeric - * values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - * `low`, `normal`, or `high` are specified values in `memory_shares` will be - * ignored. Default: `normal` + * @param memoryShareLevel The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + * shares. Can be one of low, normal, high, or custom. * * @return builder * @@ -592,9 +526,8 @@ public Builder memoryShareLevel(String memoryShareLevel) { } /** - * @param memoryShares The number of shares allocated for CPU. Used to - * determine resource allocation in case of resource contention. If this is set, - * `memory_share_level` must be `custom`. + * @param memoryShares The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + * memory_share_level must be custom. * * @return builder * @@ -605,9 +538,8 @@ public Builder memoryShares(@Nullable Output memoryShares) { } /** - * @param memoryShares The number of shares allocated for CPU. Used to - * determine resource allocation in case of resource contention. If this is set, - * `memory_share_level` must be `custom`. + * @param memoryShares The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + * memory_share_level must be custom. * * @return builder * @@ -617,7 +549,7 @@ public Builder memoryShares(Integer memoryShares) { } /** - * @param name The name of the resource pool. + * @param name Name of resource pool. * * @return builder * @@ -628,7 +560,7 @@ public Builder name(@Nullable Output name) { } /** - * @param name The name of the resource pool. + * @param name Name of resource pool. * * @return builder * @@ -638,11 +570,7 @@ public Builder name(String name) { } /** - * @param parentResourcePoolId The managed object ID - * of the parent resource pool. This can be the root resource pool for a cluster - * or standalone host, or a resource pool itself. When moving a resource pool - * from one parent resource pool to another, both must share a common root - * resource pool. + * @param parentResourcePoolId The ID of the root resource pool of the compute resource the resource pool is in. * * @return builder * @@ -653,11 +581,7 @@ public Builder parentResourcePoolId(Output parentResourcePoolId) { } /** - * @param parentResourcePoolId The managed object ID - * of the parent resource pool. This can be the root resource pool for a cluster - * or standalone host, or a resource pool itself. When moving a resource pool - * from one parent resource pool to another, both must share a common root - * resource pool. + * @param parentResourcePoolId The ID of the root resource pool of the compute resource the resource pool is in. * * @return builder * @@ -667,10 +591,8 @@ public Builder parentResourcePoolId(String parentResourcePoolId) { } /** - * @param scaleDescendantsShares Determines if the shares of all - * descendants of the resource pool are scaled up or down when the shares - * of the resource pool are scaled up or down. Can be one of `disabled` or - * `scaleCpuAndMemoryShares`. Default: `disabled`. + * @param scaleDescendantsShares Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource + * pool are scaled up or down. * * @return builder * @@ -681,10 +603,8 @@ public Builder scaleDescendantsShares(@Nullable Output scaleDescendantsS } /** - * @param scaleDescendantsShares Determines if the shares of all - * descendants of the resource pool are scaled up or down when the shares - * of the resource pool are scaled up or down. Can be one of `disabled` or - * `scaleCpuAndMemoryShares`. Default: `disabled`. + * @param scaleDescendantsShares Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource + * pool are scaled up or down. * * @return builder * @@ -694,7 +614,7 @@ public Builder scaleDescendantsShares(String scaleDescendantsShares) { } /** - * @param tags The IDs of any tags to attach to this resource. + * @param tags A list of tag IDs to apply to this object. * * @return builder * @@ -705,7 +625,7 @@ public Builder tags(@Nullable Output> tags) { } /** - * @param tags The IDs of any tags to attach to this resource. + * @param tags A list of tag IDs to apply to this object. * * @return builder * @@ -715,7 +635,7 @@ public Builder tags(List tags) { } /** - * @param tags The IDs of any tags to attach to this resource. + * @param tags A list of tag IDs to apply to this object. * * @return builder * diff --git a/sdk/java/src/main/java/com/pulumi/vsphere/VirtualMachine.java b/sdk/java/src/main/java/com/pulumi/vsphere/VirtualMachine.java index 498d6269..32a04bc2 100644 --- a/sdk/java/src/main/java/com/pulumi/vsphere/VirtualMachine.java +++ b/sdk/java/src/main/java/com/pulumi/vsphere/VirtualMachine.java @@ -33,7 +33,7 @@ * * The following requirements apply to import: * - * * The disks must have a [`label`](#label) argument assigned in a convention matching `diskN`, starting with disk number 0, based on each virtual disk order on the SCSI bus. As an example, a disk on SCSI controller `0` with a unit number of `0` would be labeled as `disk0`, a disk on the same controller with a unit number of `1` would be `disk1`, but the next disk, which is on SCSI controller `1` with a unit number of `0`, still becomes `disk2`. + * * The disks must have a [`label`](#label) argument assigned in a convention matching `Hard Disk`, starting with disk number 0, based on each virtual disk order on the SCSI bus. As an example, a disk on SCSI controller `0` with a unit number of `0` would be labeled as `Hard Disk 0`, a disk on the same controller with a unit number of `1` would be `Hard Disk 1`, but the next disk, which is on SCSI controller `1` with a unit number of `0`, still becomes `Hard Disk 2`. * * * Disks are always imported with [`keep_on_remove`](#keep_on_remove) enabled until the first `pulumi up` run which will remove the setting for known disks. This process safeguards against naming or accounting mistakes in the disk configuration. * diff --git a/sdk/java/src/main/java/com/pulumi/vsphere/VsphereFunctions.java b/sdk/java/src/main/java/com/pulumi/vsphere/VsphereFunctions.java index 89d0374f..7a5cdcb6 100644 --- a/sdk/java/src/main/java/com/pulumi/vsphere/VsphereFunctions.java +++ b/sdk/java/src/main/java/com/pulumi/vsphere/VsphereFunctions.java @@ -3677,9 +3677,14 @@ public static CompletableFuture getHostPciDevicePlain(Ge } /** * The `vsphere_thumbprint` data source can be used to discover the host thumbprint - * of an ESXi host. This can be used when adding the `vsphere.Host` resource. If - * the ESXi host is using a certificate chain, the first one returned will be used - * to generate the thumbprint. + * of an ESXi host. This can be used when adding the `vsphere.Host` resource to a + * cluster or a vCenter Server instance. + * + * * If the ESXi host is using a certificate chain, the first one returned will be + * used to generate the thumbprint. + * + * * If the ESXi host has a certificate issued by a certificate authority, ensure + * that the the certificate authority is trusted on the system running the plan. * * ## Example Usage * @@ -3722,9 +3727,14 @@ public static Output getHostThumbprint(GetHostThumbprin } /** * The `vsphere_thumbprint` data source can be used to discover the host thumbprint - * of an ESXi host. This can be used when adding the `vsphere.Host` resource. If - * the ESXi host is using a certificate chain, the first one returned will be used - * to generate the thumbprint. + * of an ESXi host. This can be used when adding the `vsphere.Host` resource to a + * cluster or a vCenter Server instance. + * + * * If the ESXi host is using a certificate chain, the first one returned will be + * used to generate the thumbprint. + * + * * If the ESXi host has a certificate issued by a certificate authority, ensure + * that the the certificate authority is trusted on the system running the plan. * * ## Example Usage * @@ -3767,9 +3777,14 @@ public static CompletableFuture getHostThumbprintPlain( } /** * The `vsphere_thumbprint` data source can be used to discover the host thumbprint - * of an ESXi host. This can be used when adding the `vsphere.Host` resource. If - * the ESXi host is using a certificate chain, the first one returned will be used - * to generate the thumbprint. + * of an ESXi host. This can be used when adding the `vsphere.Host` resource to a + * cluster or a vCenter Server instance. + * + * * If the ESXi host is using a certificate chain, the first one returned will be + * used to generate the thumbprint. + * + * * If the ESXi host has a certificate issued by a certificate authority, ensure + * that the the certificate authority is trusted on the system running the plan. * * ## Example Usage * @@ -3812,9 +3827,14 @@ public static Output getHostThumbprint(GetHostThumbprin } /** * The `vsphere_thumbprint` data source can be used to discover the host thumbprint - * of an ESXi host. This can be used when adding the `vsphere.Host` resource. If - * the ESXi host is using a certificate chain, the first one returned will be used - * to generate the thumbprint. + * of an ESXi host. This can be used when adding the `vsphere.Host` resource to a + * cluster or a vCenter Server instance. + * + * * If the ESXi host is using a certificate chain, the first one returned will be + * used to generate the thumbprint. + * + * * If the ESXi host has a certificate issued by a certificate authority, ensure + * that the the certificate authority is trusted on the system running the plan. * * ## Example Usage * diff --git a/sdk/java/src/main/java/com/pulumi/vsphere/inputs/GetHostThumbprintArgs.java b/sdk/java/src/main/java/com/pulumi/vsphere/inputs/GetHostThumbprintArgs.java index c7148f1d..3eb46616 100644 --- a/sdk/java/src/main/java/com/pulumi/vsphere/inputs/GetHostThumbprintArgs.java +++ b/sdk/java/src/main/java/com/pulumi/vsphere/inputs/GetHostThumbprintArgs.java @@ -35,16 +35,14 @@ public Output address() { } /** - * Disables SSL certificate verification. - * Default: `false` + * Disables SSL certificate verification. Default: `false` * */ @Import(name="insecure") private @Nullable Output insecure; /** - * @return Disables SSL certificate verification. - * Default: `false` + * @return Disables SSL certificate verification. Default: `false` * */ public Optional> insecure() { @@ -116,8 +114,7 @@ public Builder address(String address) { } /** - * @param insecure Disables SSL certificate verification. - * Default: `false` + * @param insecure Disables SSL certificate verification. Default: `false` * * @return builder * @@ -128,8 +125,7 @@ public Builder insecure(@Nullable Output insecure) { } /** - * @param insecure Disables SSL certificate verification. - * Default: `false` + * @param insecure Disables SSL certificate verification. Default: `false` * * @return builder * diff --git a/sdk/java/src/main/java/com/pulumi/vsphere/inputs/GetHostThumbprintPlainArgs.java b/sdk/java/src/main/java/com/pulumi/vsphere/inputs/GetHostThumbprintPlainArgs.java index cc92f23d..6f9d92e3 100644 --- a/sdk/java/src/main/java/com/pulumi/vsphere/inputs/GetHostThumbprintPlainArgs.java +++ b/sdk/java/src/main/java/com/pulumi/vsphere/inputs/GetHostThumbprintPlainArgs.java @@ -34,16 +34,14 @@ public String address() { } /** - * Disables SSL certificate verification. - * Default: `false` + * Disables SSL certificate verification. Default: `false` * */ @Import(name="insecure") private @Nullable Boolean insecure; /** - * @return Disables SSL certificate verification. - * Default: `false` + * @return Disables SSL certificate verification. Default: `false` * */ public Optional insecure() { @@ -104,8 +102,7 @@ public Builder address(String address) { } /** - * @param insecure Disables SSL certificate verification. - * Default: `false` + * @param insecure Disables SSL certificate verification. Default: `false` * * @return builder * diff --git a/sdk/java/src/main/java/com/pulumi/vsphere/inputs/ResourcePoolState.java b/sdk/java/src/main/java/com/pulumi/vsphere/inputs/ResourcePoolState.java index 6755d0a5..5560a9ff 100644 --- a/sdk/java/src/main/java/com/pulumi/vsphere/inputs/ResourcePoolState.java +++ b/sdk/java/src/main/java/com/pulumi/vsphere/inputs/ResourcePoolState.java @@ -20,18 +20,16 @@ public final class ResourcePoolState extends com.pulumi.resources.ResourceArgs { public static final ResourcePoolState Empty = new ResourcePoolState(); /** - * Determines if the reservation on a resource - * pool can grow beyond the specified value if the parent resource pool has - * unreserved resources. Default: `true` + * Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + * unreserved resources. * */ @Import(name="cpuExpandable") private @Nullable Output cpuExpandable; /** - * @return Determines if the reservation on a resource - * pool can grow beyond the specified value if the parent resource pool has - * unreserved resources. Default: `true` + * @return Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + * unreserved resources. * */ public Optional> cpuExpandable() { @@ -39,18 +37,16 @@ public Optional> cpuExpandable() { } /** - * The CPU utilization of a resource pool will not - * exceed this limit, even if there are available resources. Set to `-1` for - * unlimited. Default: `-1` + * The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + * unlimited. * */ @Import(name="cpuLimit") private @Nullable Output cpuLimit; /** - * @return The CPU utilization of a resource pool will not - * exceed this limit, even if there are available resources. Set to `-1` for - * unlimited. Default: `-1` + * @return The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + * unlimited. * */ public Optional> cpuLimit() { @@ -58,16 +54,14 @@ public Optional> cpuLimit() { } /** - * Amount of CPU (MHz) that is guaranteed - * available to the resource pool. Default: `0` + * Amount of CPU (MHz) that is guaranteed available to the resource pool. * */ @Import(name="cpuReservation") private @Nullable Output cpuReservation; /** - * @return Amount of CPU (MHz) that is guaranteed - * available to the resource pool. Default: `0` + * @return Amount of CPU (MHz) that is guaranteed available to the resource pool. * */ public Optional> cpuReservation() { @@ -75,22 +69,16 @@ public Optional> cpuReservation() { } /** - * The CPU allocation level. The level is a - * simplified view of shares. Levels map to a pre-determined set of numeric - * values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - * `low`, `normal`, or `high` are specified values in `cpu_shares` will be - * ignored. Default: `normal` + * The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + * shares. Can be one of low, normal, high, or custom. * */ @Import(name="cpuShareLevel") private @Nullable Output cpuShareLevel; /** - * @return The CPU allocation level. The level is a - * simplified view of shares. Levels map to a pre-determined set of numeric - * values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - * `low`, `normal`, or `high` are specified values in `cpu_shares` will be - * ignored. Default: `normal` + * @return The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + * shares. Can be one of low, normal, high, or custom. * */ public Optional> cpuShareLevel() { @@ -98,18 +86,16 @@ public Optional> cpuShareLevel() { } /** - * The number of shares allocated for CPU. Used to - * determine resource allocation in case of resource contention. If this is set, - * `cpu_share_level` must be `custom`. + * The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + * cpu_share_level must be custom. * */ @Import(name="cpuShares") private @Nullable Output cpuShares; /** - * @return The number of shares allocated for CPU. Used to - * determine resource allocation in case of resource contention. If this is set, - * `cpu_share_level` must be `custom`. + * @return The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + * cpu_share_level must be custom. * */ public Optional> cpuShares() { @@ -132,18 +118,16 @@ public Optional>> customAttributes() { } /** - * Determines if the reservation on a resource - * pool can grow beyond the specified value if the parent resource pool has - * unreserved resources. Default: `true` + * Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + * unreserved resources. * */ @Import(name="memoryExpandable") private @Nullable Output memoryExpandable; /** - * @return Determines if the reservation on a resource - * pool can grow beyond the specified value if the parent resource pool has - * unreserved resources. Default: `true` + * @return Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + * unreserved resources. * */ public Optional> memoryExpandable() { @@ -151,18 +135,16 @@ public Optional> memoryExpandable() { } /** - * The CPU utilization of a resource pool will not - * exceed this limit, even if there are available resources. Set to `-1` for - * unlimited. Default: `-1` + * The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + * unlimited. * */ @Import(name="memoryLimit") private @Nullable Output memoryLimit; /** - * @return The CPU utilization of a resource pool will not - * exceed this limit, even if there are available resources. Set to `-1` for - * unlimited. Default: `-1` + * @return The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + * unlimited. * */ public Optional> memoryLimit() { @@ -170,16 +152,14 @@ public Optional> memoryLimit() { } /** - * Amount of CPU (MHz) that is guaranteed - * available to the resource pool. Default: `0` + * Amount of memory (MB) that is guaranteed available to the resource pool. * */ @Import(name="memoryReservation") private @Nullable Output memoryReservation; /** - * @return Amount of CPU (MHz) that is guaranteed - * available to the resource pool. Default: `0` + * @return Amount of memory (MB) that is guaranteed available to the resource pool. * */ public Optional> memoryReservation() { @@ -187,22 +167,16 @@ public Optional> memoryReservation() { } /** - * The CPU allocation level. The level is a - * simplified view of shares. Levels map to a pre-determined set of numeric - * values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - * `low`, `normal`, or `high` are specified values in `memory_shares` will be - * ignored. Default: `normal` + * The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + * shares. Can be one of low, normal, high, or custom. * */ @Import(name="memoryShareLevel") private @Nullable Output memoryShareLevel; /** - * @return The CPU allocation level. The level is a - * simplified view of shares. Levels map to a pre-determined set of numeric - * values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - * `low`, `normal`, or `high` are specified values in `memory_shares` will be - * ignored. Default: `normal` + * @return The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + * shares. Can be one of low, normal, high, or custom. * */ public Optional> memoryShareLevel() { @@ -210,18 +184,16 @@ public Optional> memoryShareLevel() { } /** - * The number of shares allocated for CPU. Used to - * determine resource allocation in case of resource contention. If this is set, - * `memory_share_level` must be `custom`. + * The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + * memory_share_level must be custom. * */ @Import(name="memoryShares") private @Nullable Output memoryShares; /** - * @return The number of shares allocated for CPU. Used to - * determine resource allocation in case of resource contention. If this is set, - * `memory_share_level` must be `custom`. + * @return The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + * memory_share_level must be custom. * */ public Optional> memoryShares() { @@ -229,14 +201,14 @@ public Optional> memoryShares() { } /** - * The name of the resource pool. + * Name of resource pool. * */ @Import(name="name") private @Nullable Output name; /** - * @return The name of the resource pool. + * @return Name of resource pool. * */ public Optional> name() { @@ -244,22 +216,14 @@ public Optional> name() { } /** - * The managed object ID - * of the parent resource pool. This can be the root resource pool for a cluster - * or standalone host, or a resource pool itself. When moving a resource pool - * from one parent resource pool to another, both must share a common root - * resource pool. + * The ID of the root resource pool of the compute resource the resource pool is in. * */ @Import(name="parentResourcePoolId") private @Nullable Output parentResourcePoolId; /** - * @return The managed object ID - * of the parent resource pool. This can be the root resource pool for a cluster - * or standalone host, or a resource pool itself. When moving a resource pool - * from one parent resource pool to another, both must share a common root - * resource pool. + * @return The ID of the root resource pool of the compute resource the resource pool is in. * */ public Optional> parentResourcePoolId() { @@ -267,20 +231,16 @@ public Optional> parentResourcePoolId() { } /** - * Determines if the shares of all - * descendants of the resource pool are scaled up or down when the shares - * of the resource pool are scaled up or down. Can be one of `disabled` or - * `scaleCpuAndMemoryShares`. Default: `disabled`. + * Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource + * pool are scaled up or down. * */ @Import(name="scaleDescendantsShares") private @Nullable Output scaleDescendantsShares; /** - * @return Determines if the shares of all - * descendants of the resource pool are scaled up or down when the shares - * of the resource pool are scaled up or down. Can be one of `disabled` or - * `scaleCpuAndMemoryShares`. Default: `disabled`. + * @return Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource + * pool are scaled up or down. * */ public Optional> scaleDescendantsShares() { @@ -288,14 +248,14 @@ public Optional> scaleDescendantsShares() { } /** - * The IDs of any tags to attach to this resource. + * A list of tag IDs to apply to this object. * */ @Import(name="tags") private @Nullable Output> tags; /** - * @return The IDs of any tags to attach to this resource. + * @return A list of tag IDs to apply to this object. * */ public Optional>> tags() { @@ -341,9 +301,8 @@ public Builder(ResourcePoolState defaults) { } /** - * @param cpuExpandable Determines if the reservation on a resource - * pool can grow beyond the specified value if the parent resource pool has - * unreserved resources. Default: `true` + * @param cpuExpandable Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + * unreserved resources. * * @return builder * @@ -354,9 +313,8 @@ public Builder cpuExpandable(@Nullable Output cpuExpandable) { } /** - * @param cpuExpandable Determines if the reservation on a resource - * pool can grow beyond the specified value if the parent resource pool has - * unreserved resources. Default: `true` + * @param cpuExpandable Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + * unreserved resources. * * @return builder * @@ -366,9 +324,8 @@ public Builder cpuExpandable(Boolean cpuExpandable) { } /** - * @param cpuLimit The CPU utilization of a resource pool will not - * exceed this limit, even if there are available resources. Set to `-1` for - * unlimited. Default: `-1` + * @param cpuLimit The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + * unlimited. * * @return builder * @@ -379,9 +336,8 @@ public Builder cpuLimit(@Nullable Output cpuLimit) { } /** - * @param cpuLimit The CPU utilization of a resource pool will not - * exceed this limit, even if there are available resources. Set to `-1` for - * unlimited. Default: `-1` + * @param cpuLimit The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + * unlimited. * * @return builder * @@ -391,8 +347,7 @@ public Builder cpuLimit(Integer cpuLimit) { } /** - * @param cpuReservation Amount of CPU (MHz) that is guaranteed - * available to the resource pool. Default: `0` + * @param cpuReservation Amount of CPU (MHz) that is guaranteed available to the resource pool. * * @return builder * @@ -403,8 +358,7 @@ public Builder cpuReservation(@Nullable Output cpuReservation) { } /** - * @param cpuReservation Amount of CPU (MHz) that is guaranteed - * available to the resource pool. Default: `0` + * @param cpuReservation Amount of CPU (MHz) that is guaranteed available to the resource pool. * * @return builder * @@ -414,11 +368,8 @@ public Builder cpuReservation(Integer cpuReservation) { } /** - * @param cpuShareLevel The CPU allocation level. The level is a - * simplified view of shares. Levels map to a pre-determined set of numeric - * values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - * `low`, `normal`, or `high` are specified values in `cpu_shares` will be - * ignored. Default: `normal` + * @param cpuShareLevel The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + * shares. Can be one of low, normal, high, or custom. * * @return builder * @@ -429,11 +380,8 @@ public Builder cpuShareLevel(@Nullable Output cpuShareLevel) { } /** - * @param cpuShareLevel The CPU allocation level. The level is a - * simplified view of shares. Levels map to a pre-determined set of numeric - * values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - * `low`, `normal`, or `high` are specified values in `cpu_shares` will be - * ignored. Default: `normal` + * @param cpuShareLevel The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + * shares. Can be one of low, normal, high, or custom. * * @return builder * @@ -443,9 +391,8 @@ public Builder cpuShareLevel(String cpuShareLevel) { } /** - * @param cpuShares The number of shares allocated for CPU. Used to - * determine resource allocation in case of resource contention. If this is set, - * `cpu_share_level` must be `custom`. + * @param cpuShares The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + * cpu_share_level must be custom. * * @return builder * @@ -456,9 +403,8 @@ public Builder cpuShares(@Nullable Output cpuShares) { } /** - * @param cpuShares The number of shares allocated for CPU. Used to - * determine resource allocation in case of resource contention. If this is set, - * `cpu_share_level` must be `custom`. + * @param cpuShares The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + * cpu_share_level must be custom. * * @return builder * @@ -489,9 +435,8 @@ public Builder customAttributes(Map customAttributes) { } /** - * @param memoryExpandable Determines if the reservation on a resource - * pool can grow beyond the specified value if the parent resource pool has - * unreserved resources. Default: `true` + * @param memoryExpandable Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + * unreserved resources. * * @return builder * @@ -502,9 +447,8 @@ public Builder memoryExpandable(@Nullable Output memoryExpandable) { } /** - * @param memoryExpandable Determines if the reservation on a resource - * pool can grow beyond the specified value if the parent resource pool has - * unreserved resources. Default: `true` + * @param memoryExpandable Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + * unreserved resources. * * @return builder * @@ -514,9 +458,8 @@ public Builder memoryExpandable(Boolean memoryExpandable) { } /** - * @param memoryLimit The CPU utilization of a resource pool will not - * exceed this limit, even if there are available resources. Set to `-1` for - * unlimited. Default: `-1` + * @param memoryLimit The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + * unlimited. * * @return builder * @@ -527,9 +470,8 @@ public Builder memoryLimit(@Nullable Output memoryLimit) { } /** - * @param memoryLimit The CPU utilization of a resource pool will not - * exceed this limit, even if there are available resources. Set to `-1` for - * unlimited. Default: `-1` + * @param memoryLimit The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + * unlimited. * * @return builder * @@ -539,8 +481,7 @@ public Builder memoryLimit(Integer memoryLimit) { } /** - * @param memoryReservation Amount of CPU (MHz) that is guaranteed - * available to the resource pool. Default: `0` + * @param memoryReservation Amount of memory (MB) that is guaranteed available to the resource pool. * * @return builder * @@ -551,8 +492,7 @@ public Builder memoryReservation(@Nullable Output memoryReservation) { } /** - * @param memoryReservation Amount of CPU (MHz) that is guaranteed - * available to the resource pool. Default: `0` + * @param memoryReservation Amount of memory (MB) that is guaranteed available to the resource pool. * * @return builder * @@ -562,11 +502,8 @@ public Builder memoryReservation(Integer memoryReservation) { } /** - * @param memoryShareLevel The CPU allocation level. The level is a - * simplified view of shares. Levels map to a pre-determined set of numeric - * values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - * `low`, `normal`, or `high` are specified values in `memory_shares` will be - * ignored. Default: `normal` + * @param memoryShareLevel The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + * shares. Can be one of low, normal, high, or custom. * * @return builder * @@ -577,11 +514,8 @@ public Builder memoryShareLevel(@Nullable Output memoryShareLevel) { } /** - * @param memoryShareLevel The CPU allocation level. The level is a - * simplified view of shares. Levels map to a pre-determined set of numeric - * values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - * `low`, `normal`, or `high` are specified values in `memory_shares` will be - * ignored. Default: `normal` + * @param memoryShareLevel The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + * shares. Can be one of low, normal, high, or custom. * * @return builder * @@ -591,9 +525,8 @@ public Builder memoryShareLevel(String memoryShareLevel) { } /** - * @param memoryShares The number of shares allocated for CPU. Used to - * determine resource allocation in case of resource contention. If this is set, - * `memory_share_level` must be `custom`. + * @param memoryShares The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + * memory_share_level must be custom. * * @return builder * @@ -604,9 +537,8 @@ public Builder memoryShares(@Nullable Output memoryShares) { } /** - * @param memoryShares The number of shares allocated for CPU. Used to - * determine resource allocation in case of resource contention. If this is set, - * `memory_share_level` must be `custom`. + * @param memoryShares The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + * memory_share_level must be custom. * * @return builder * @@ -616,7 +548,7 @@ public Builder memoryShares(Integer memoryShares) { } /** - * @param name The name of the resource pool. + * @param name Name of resource pool. * * @return builder * @@ -627,7 +559,7 @@ public Builder name(@Nullable Output name) { } /** - * @param name The name of the resource pool. + * @param name Name of resource pool. * * @return builder * @@ -637,11 +569,7 @@ public Builder name(String name) { } /** - * @param parentResourcePoolId The managed object ID - * of the parent resource pool. This can be the root resource pool for a cluster - * or standalone host, or a resource pool itself. When moving a resource pool - * from one parent resource pool to another, both must share a common root - * resource pool. + * @param parentResourcePoolId The ID of the root resource pool of the compute resource the resource pool is in. * * @return builder * @@ -652,11 +580,7 @@ public Builder parentResourcePoolId(@Nullable Output parentResourcePoolI } /** - * @param parentResourcePoolId The managed object ID - * of the parent resource pool. This can be the root resource pool for a cluster - * or standalone host, or a resource pool itself. When moving a resource pool - * from one parent resource pool to another, both must share a common root - * resource pool. + * @param parentResourcePoolId The ID of the root resource pool of the compute resource the resource pool is in. * * @return builder * @@ -666,10 +590,8 @@ public Builder parentResourcePoolId(String parentResourcePoolId) { } /** - * @param scaleDescendantsShares Determines if the shares of all - * descendants of the resource pool are scaled up or down when the shares - * of the resource pool are scaled up or down. Can be one of `disabled` or - * `scaleCpuAndMemoryShares`. Default: `disabled`. + * @param scaleDescendantsShares Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource + * pool are scaled up or down. * * @return builder * @@ -680,10 +602,8 @@ public Builder scaleDescendantsShares(@Nullable Output scaleDescendantsS } /** - * @param scaleDescendantsShares Determines if the shares of all - * descendants of the resource pool are scaled up or down when the shares - * of the resource pool are scaled up or down. Can be one of `disabled` or - * `scaleCpuAndMemoryShares`. Default: `disabled`. + * @param scaleDescendantsShares Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource + * pool are scaled up or down. * * @return builder * @@ -693,7 +613,7 @@ public Builder scaleDescendantsShares(String scaleDescendantsShares) { } /** - * @param tags The IDs of any tags to attach to this resource. + * @param tags A list of tag IDs to apply to this object. * * @return builder * @@ -704,7 +624,7 @@ public Builder tags(@Nullable Output> tags) { } /** - * @param tags The IDs of any tags to attach to this resource. + * @param tags A list of tag IDs to apply to this object. * * @return builder * @@ -714,7 +634,7 @@ public Builder tags(List tags) { } /** - * @param tags The IDs of any tags to attach to this resource. + * @param tags A list of tag IDs to apply to this object. * * @return builder * diff --git a/sdk/nodejs/getHostThumbprint.ts b/sdk/nodejs/getHostThumbprint.ts index a9ea263d..b16af7a6 100644 --- a/sdk/nodejs/getHostThumbprint.ts +++ b/sdk/nodejs/getHostThumbprint.ts @@ -6,9 +6,14 @@ import * as utilities from "./utilities"; /** * The `vsphereThumbprint` data source can be used to discover the host thumbprint - * of an ESXi host. This can be used when adding the `vsphere.Host` resource. If - * the ESXi host is using a certificate chain, the first one returned will be used - * to generate the thumbprint. + * of an ESXi host. This can be used when adding the `vsphere.Host` resource to a + * cluster or a vCenter Server instance. + * + * * If the ESXi host is using a certificate chain, the first one returned will be + * used to generate the thumbprint. + * + * * If the ESXi host has a certificate issued by a certificate authority, ensure + * that the the certificate authority is trusted on the system running the plan. * * ## Example Usage * @@ -40,8 +45,7 @@ export interface GetHostThumbprintArgs { */ address: string; /** - * Disables SSL certificate verification. - * Default: `false` + * Disables SSL certificate verification. Default: `false` */ insecure?: boolean; /** @@ -64,9 +68,14 @@ export interface GetHostThumbprintResult { } /** * The `vsphereThumbprint` data source can be used to discover the host thumbprint - * of an ESXi host. This can be used when adding the `vsphere.Host` resource. If - * the ESXi host is using a certificate chain, the first one returned will be used - * to generate the thumbprint. + * of an ESXi host. This can be used when adding the `vsphere.Host` resource to a + * cluster or a vCenter Server instance. + * + * * If the ESXi host is using a certificate chain, the first one returned will be + * used to generate the thumbprint. + * + * * If the ESXi host has a certificate issued by a certificate authority, ensure + * that the the certificate authority is trusted on the system running the plan. * * ## Example Usage * @@ -98,8 +107,7 @@ export interface GetHostThumbprintOutputArgs { */ address: pulumi.Input; /** - * Disables SSL certificate verification. - * Default: `false` + * Disables SSL certificate verification. Default: `false` */ insecure?: pulumi.Input; /** diff --git a/sdk/nodejs/host.ts b/sdk/nodejs/host.ts index c2a8964a..7e69e2c2 100644 --- a/sdk/nodejs/host.ts +++ b/sdk/nodejs/host.ts @@ -22,11 +22,11 @@ import * as utilities from "./utilities"; * name: "dc-01", * }); * const thumbprint = vsphere.getHostThumbprint({ - * address: "esx-01.example.com", + * address: "esxi-01.example.com", * insecure: true, * }); * const esx_01 = new vsphere.Host("esx-01", { - * hostname: "esx-01.example.com", + * hostname: "esxi-01.example.com", * username: "root", * password: "password", * license: "00000-00000-00000-00000-00000", @@ -55,7 +55,7 @@ import * as utilities from "./utilities"; * * data "vsphere_host" "host" { * - * name = "esx-01.example.com" + * name = "esxi-01.example.com" * * datacenter_id = data.vsphere_datacenter.datacenter.id * @@ -79,7 +79,7 @@ import * as utilities from "./utilities"; * * data "vsphere_host_thumbprint" "thumbprint" { * - * address = "esx-01.example.com" + * address = "esxi-01.example.com" * * insecure = true * @@ -87,7 +87,7 @@ import * as utilities from "./utilities"; * * resource "vsphere_host" "esx-01" { * - * hostname = "esx-01.example.com" + * hostname = "esxi-01.example.com" * * username = "root" * @@ -103,7 +103,7 @@ import * as utilities from "./utilities"; * * resource "vsphere_host" "esx-01" { * - * hostname = "esx-01.example.com" + * hostname = "esxi-01.example.com" * * username = "root" * @@ -135,7 +135,7 @@ import * as utilities from "./utilities"; * $ pulumi import vsphere:index/host:Host esx-01 host-123 * ``` * - * The above would import the host `esx-01.example.com` with the host ID `host-123`. + * The above would import the host `esxi-01.example.com` with the host ID `host-123`. */ export class Host extends pulumi.CustomResource { /** diff --git a/sdk/nodejs/resourcePool.ts b/sdk/nodejs/resourcePool.ts index 51740a5e..4b2f0f3d 100644 --- a/sdk/nodejs/resourcePool.ts +++ b/sdk/nodejs/resourcePool.ts @@ -4,80 +4,6 @@ import * as pulumi from "@pulumi/pulumi"; import * as utilities from "./utilities"; -/** - * The `vsphere.ResourcePool` resource can be used to create and manage - * resource pools on DRS-enabled vSphere clusters or standalone ESXi hosts. - * - * For more information on vSphere resource pools, please refer to the - * [product documentation][ref-vsphere-resource_pools]. - * - * [ref-vsphere-resource_pools]: https://docs.vmware.com/en/VMware-vSphere/8.0/vsphere-resource-management/GUID-60077B40-66FF-4625-934A-641703ED7601.html - * - * ## Example Usage - * - * The following example sets up a resource pool in an existing compute cluster - * with the default settings for CPU and memory reservations, shares, and limits. - * - * ```typescript - * import * as pulumi from "@pulumi/pulumi"; - * import * as vsphere from "@pulumi/vsphere"; - * - * const datacenter = vsphere.getDatacenter({ - * name: "dc-01", - * }); - * const computeCluster = datacenter.then(datacenter => vsphere.getComputeCluster({ - * name: "cluster-01", - * datacenterId: datacenter.id, - * })); - * const resourcePool = new vsphere.ResourcePool("resource_pool", { - * name: "resource-pool-01", - * parentResourcePoolId: computeCluster.then(computeCluster => computeCluster.resourcePoolId), - * }); - * ``` - * - * A virtual machine resource could be targeted to use the default resource pool - * of the cluster using the following: - * - * ```typescript - * import * as pulumi from "@pulumi/pulumi"; - * import * as vsphere from "@pulumi/vsphere"; - * - * const vm = new vsphere.VirtualMachine("vm", {resourcePoolId: cluster.resourcePoolId}); - * ``` - * - * The following example sets up a parent resource pool in an existing compute cluster - * with a child resource pool nested below. Each resource pool is configured with - * the default settings for CPU and memory reservations, shares, and limits. - * - * ```typescript - * import * as pulumi from "@pulumi/pulumi"; - * import * as vsphere from "@pulumi/vsphere"; - * - * const datacenter = vsphere.getDatacenter({ - * name: "dc-01", - * }); - * const computeCluster = datacenter.then(datacenter => vsphere.getComputeCluster({ - * name: "cluster-01", - * datacenterId: datacenter.id, - * })); - * const resourcePoolParent = new vsphere.ResourcePool("resource_pool_parent", { - * name: "parent", - * parentResourcePoolId: computeCluster.then(computeCluster => computeCluster.resourcePoolId), - * }); - * const resourcePoolChild = new vsphere.ResourcePool("resource_pool_child", { - * name: "child", - * parentResourcePoolId: resourcePoolParent.id, - * }); - * ``` - * - * ## Import - * - * ### Settings that Require vSphere 7.0 or higher - * - * These settings require vSphere 7.0 or higher: - * - * * [`scale_descendants_shares`](#scale_descendants_shares) - */ export class ResourcePool extends pulumi.CustomResource { /** * Get an existing ResourcePool resource's state with the given name, ID, and optional extra @@ -107,34 +33,27 @@ export class ResourcePool extends pulumi.CustomResource { } /** - * Determines if the reservation on a resource - * pool can grow beyond the specified value if the parent resource pool has - * unreserved resources. Default: `true` + * Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + * unreserved resources. */ public readonly cpuExpandable!: pulumi.Output; /** - * The CPU utilization of a resource pool will not - * exceed this limit, even if there are available resources. Set to `-1` for - * unlimited. Default: `-1` + * The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + * unlimited. */ public readonly cpuLimit!: pulumi.Output; /** - * Amount of CPU (MHz) that is guaranteed - * available to the resource pool. Default: `0` + * Amount of CPU (MHz) that is guaranteed available to the resource pool. */ public readonly cpuReservation!: pulumi.Output; /** - * The CPU allocation level. The level is a - * simplified view of shares. Levels map to a pre-determined set of numeric - * values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - * `low`, `normal`, or `high` are specified values in `cpuShares` will be - * ignored. Default: `normal` + * The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + * shares. Can be one of low, normal, high, or custom. */ public readonly cpuShareLevel!: pulumi.Output; /** - * The number of shares allocated for CPU. Used to - * determine resource allocation in case of resource contention. If this is set, - * `cpuShareLevel` must be `custom`. + * The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + * cpuShareLevel must be custom. */ public readonly cpuShares!: pulumi.Output; /** @@ -142,57 +61,44 @@ export class ResourcePool extends pulumi.CustomResource { */ public readonly customAttributes!: pulumi.Output<{[key: string]: string} | undefined>; /** - * Determines if the reservation on a resource - * pool can grow beyond the specified value if the parent resource pool has - * unreserved resources. Default: `true` + * Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + * unreserved resources. */ public readonly memoryExpandable!: pulumi.Output; /** - * The CPU utilization of a resource pool will not - * exceed this limit, even if there are available resources. Set to `-1` for - * unlimited. Default: `-1` + * The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + * unlimited. */ public readonly memoryLimit!: pulumi.Output; /** - * Amount of CPU (MHz) that is guaranteed - * available to the resource pool. Default: `0` + * Amount of memory (MB) that is guaranteed available to the resource pool. */ public readonly memoryReservation!: pulumi.Output; /** - * The CPU allocation level. The level is a - * simplified view of shares. Levels map to a pre-determined set of numeric - * values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - * `low`, `normal`, or `high` are specified values in `memoryShares` will be - * ignored. Default: `normal` + * The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + * shares. Can be one of low, normal, high, or custom. */ public readonly memoryShareLevel!: pulumi.Output; /** - * The number of shares allocated for CPU. Used to - * determine resource allocation in case of resource contention. If this is set, - * `memoryShareLevel` must be `custom`. + * The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + * memoryShareLevel must be custom. */ public readonly memoryShares!: pulumi.Output; /** - * The name of the resource pool. + * Name of resource pool. */ public readonly name!: pulumi.Output; /** - * The managed object ID - * of the parent resource pool. This can be the root resource pool for a cluster - * or standalone host, or a resource pool itself. When moving a resource pool - * from one parent resource pool to another, both must share a common root - * resource pool. + * The ID of the root resource pool of the compute resource the resource pool is in. */ public readonly parentResourcePoolId!: pulumi.Output; /** - * Determines if the shares of all - * descendants of the resource pool are scaled up or down when the shares - * of the resource pool are scaled up or down. Can be one of `disabled` or - * `scaleCpuAndMemoryShares`. Default: `disabled`. + * Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource + * pool are scaled up or down. */ public readonly scaleDescendantsShares!: pulumi.Output; /** - * The IDs of any tags to attach to this resource. + * A list of tag IDs to apply to this object. */ public readonly tags!: pulumi.Output; @@ -255,34 +161,27 @@ export class ResourcePool extends pulumi.CustomResource { */ export interface ResourcePoolState { /** - * Determines if the reservation on a resource - * pool can grow beyond the specified value if the parent resource pool has - * unreserved resources. Default: `true` + * Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + * unreserved resources. */ cpuExpandable?: pulumi.Input; /** - * The CPU utilization of a resource pool will not - * exceed this limit, even if there are available resources. Set to `-1` for - * unlimited. Default: `-1` + * The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + * unlimited. */ cpuLimit?: pulumi.Input; /** - * Amount of CPU (MHz) that is guaranteed - * available to the resource pool. Default: `0` + * Amount of CPU (MHz) that is guaranteed available to the resource pool. */ cpuReservation?: pulumi.Input; /** - * The CPU allocation level. The level is a - * simplified view of shares. Levels map to a pre-determined set of numeric - * values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - * `low`, `normal`, or `high` are specified values in `cpuShares` will be - * ignored. Default: `normal` + * The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + * shares. Can be one of low, normal, high, or custom. */ cpuShareLevel?: pulumi.Input; /** - * The number of shares allocated for CPU. Used to - * determine resource allocation in case of resource contention. If this is set, - * `cpuShareLevel` must be `custom`. + * The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + * cpuShareLevel must be custom. */ cpuShares?: pulumi.Input; /** @@ -290,57 +189,44 @@ export interface ResourcePoolState { */ customAttributes?: pulumi.Input<{[key: string]: pulumi.Input}>; /** - * Determines if the reservation on a resource - * pool can grow beyond the specified value if the parent resource pool has - * unreserved resources. Default: `true` + * Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + * unreserved resources. */ memoryExpandable?: pulumi.Input; /** - * The CPU utilization of a resource pool will not - * exceed this limit, even if there are available resources. Set to `-1` for - * unlimited. Default: `-1` + * The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + * unlimited. */ memoryLimit?: pulumi.Input; /** - * Amount of CPU (MHz) that is guaranteed - * available to the resource pool. Default: `0` + * Amount of memory (MB) that is guaranteed available to the resource pool. */ memoryReservation?: pulumi.Input; /** - * The CPU allocation level. The level is a - * simplified view of shares. Levels map to a pre-determined set of numeric - * values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - * `low`, `normal`, or `high` are specified values in `memoryShares` will be - * ignored. Default: `normal` + * The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + * shares. Can be one of low, normal, high, or custom. */ memoryShareLevel?: pulumi.Input; /** - * The number of shares allocated for CPU. Used to - * determine resource allocation in case of resource contention. If this is set, - * `memoryShareLevel` must be `custom`. + * The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + * memoryShareLevel must be custom. */ memoryShares?: pulumi.Input; /** - * The name of the resource pool. + * Name of resource pool. */ name?: pulumi.Input; /** - * The managed object ID - * of the parent resource pool. This can be the root resource pool for a cluster - * or standalone host, or a resource pool itself. When moving a resource pool - * from one parent resource pool to another, both must share a common root - * resource pool. + * The ID of the root resource pool of the compute resource the resource pool is in. */ parentResourcePoolId?: pulumi.Input; /** - * Determines if the shares of all - * descendants of the resource pool are scaled up or down when the shares - * of the resource pool are scaled up or down. Can be one of `disabled` or - * `scaleCpuAndMemoryShares`. Default: `disabled`. + * Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource + * pool are scaled up or down. */ scaleDescendantsShares?: pulumi.Input; /** - * The IDs of any tags to attach to this resource. + * A list of tag IDs to apply to this object. */ tags?: pulumi.Input[]>; } @@ -350,34 +236,27 @@ export interface ResourcePoolState { */ export interface ResourcePoolArgs { /** - * Determines if the reservation on a resource - * pool can grow beyond the specified value if the parent resource pool has - * unreserved resources. Default: `true` + * Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + * unreserved resources. */ cpuExpandable?: pulumi.Input; /** - * The CPU utilization of a resource pool will not - * exceed this limit, even if there are available resources. Set to `-1` for - * unlimited. Default: `-1` + * The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + * unlimited. */ cpuLimit?: pulumi.Input; /** - * Amount of CPU (MHz) that is guaranteed - * available to the resource pool. Default: `0` + * Amount of CPU (MHz) that is guaranteed available to the resource pool. */ cpuReservation?: pulumi.Input; /** - * The CPU allocation level. The level is a - * simplified view of shares. Levels map to a pre-determined set of numeric - * values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - * `low`, `normal`, or `high` are specified values in `cpuShares` will be - * ignored. Default: `normal` + * The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + * shares. Can be one of low, normal, high, or custom. */ cpuShareLevel?: pulumi.Input; /** - * The number of shares allocated for CPU. Used to - * determine resource allocation in case of resource contention. If this is set, - * `cpuShareLevel` must be `custom`. + * The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + * cpuShareLevel must be custom. */ cpuShares?: pulumi.Input; /** @@ -385,57 +264,44 @@ export interface ResourcePoolArgs { */ customAttributes?: pulumi.Input<{[key: string]: pulumi.Input}>; /** - * Determines if the reservation on a resource - * pool can grow beyond the specified value if the parent resource pool has - * unreserved resources. Default: `true` + * Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + * unreserved resources. */ memoryExpandable?: pulumi.Input; /** - * The CPU utilization of a resource pool will not - * exceed this limit, even if there are available resources. Set to `-1` for - * unlimited. Default: `-1` + * The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + * unlimited. */ memoryLimit?: pulumi.Input; /** - * Amount of CPU (MHz) that is guaranteed - * available to the resource pool. Default: `0` + * Amount of memory (MB) that is guaranteed available to the resource pool. */ memoryReservation?: pulumi.Input; /** - * The CPU allocation level. The level is a - * simplified view of shares. Levels map to a pre-determined set of numeric - * values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - * `low`, `normal`, or `high` are specified values in `memoryShares` will be - * ignored. Default: `normal` + * The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + * shares. Can be one of low, normal, high, or custom. */ memoryShareLevel?: pulumi.Input; /** - * The number of shares allocated for CPU. Used to - * determine resource allocation in case of resource contention. If this is set, - * `memoryShareLevel` must be `custom`. + * The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + * memoryShareLevel must be custom. */ memoryShares?: pulumi.Input; /** - * The name of the resource pool. + * Name of resource pool. */ name?: pulumi.Input; /** - * The managed object ID - * of the parent resource pool. This can be the root resource pool for a cluster - * or standalone host, or a resource pool itself. When moving a resource pool - * from one parent resource pool to another, both must share a common root - * resource pool. + * The ID of the root resource pool of the compute resource the resource pool is in. */ parentResourcePoolId: pulumi.Input; /** - * Determines if the shares of all - * descendants of the resource pool are scaled up or down when the shares - * of the resource pool are scaled up or down. Can be one of `disabled` or - * `scaleCpuAndMemoryShares`. Default: `disabled`. + * Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource + * pool are scaled up or down. */ scaleDescendantsShares?: pulumi.Input; /** - * The IDs of any tags to attach to this resource. + * A list of tag IDs to apply to this object. */ tags?: pulumi.Input[]>; } diff --git a/sdk/nodejs/virtualMachine.ts b/sdk/nodejs/virtualMachine.ts index ac22379d..211bc30e 100644 --- a/sdk/nodejs/virtualMachine.ts +++ b/sdk/nodejs/virtualMachine.ts @@ -15,7 +15,7 @@ import * as utilities from "./utilities"; * * The following requirements apply to import: * - * * The disks must have a [`label`](#label) argument assigned in a convention matching `diskN`, starting with disk number 0, based on each virtual disk order on the SCSI bus. As an example, a disk on SCSI controller `0` with a unit number of `0` would be labeled as `disk0`, a disk on the same controller with a unit number of `1` would be `disk1`, but the next disk, which is on SCSI controller `1` with a unit number of `0`, still becomes `disk2`. + * * The disks must have a [`label`](#label) argument assigned in a convention matching `Hard Disk`, starting with disk number 0, based on each virtual disk order on the SCSI bus. As an example, a disk on SCSI controller `0` with a unit number of `0` would be labeled as `Hard Disk 0`, a disk on the same controller with a unit number of `1` would be `Hard Disk 1`, but the next disk, which is on SCSI controller `1` with a unit number of `0`, still becomes `Hard Disk 2`. * * * Disks are always imported with [`keep_on_remove`](#keep_on_remove) enabled until the first `pulumi up` run which will remove the setting for known disks. This process safeguards against naming or accounting mistakes in the disk configuration. * diff --git a/sdk/python/pulumi_vsphere/get_host_thumbprint.py b/sdk/python/pulumi_vsphere/get_host_thumbprint.py index 12f6fac1..34da3b6a 100644 --- a/sdk/python/pulumi_vsphere/get_host_thumbprint.py +++ b/sdk/python/pulumi_vsphere/get_host_thumbprint.py @@ -77,9 +77,14 @@ def get_host_thumbprint(address: Optional[str] = None, opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetHostThumbprintResult: """ The `vsphere_thumbprint` data source can be used to discover the host thumbprint - of an ESXi host. This can be used when adding the `Host` resource. If - the ESXi host is using a certificate chain, the first one returned will be used - to generate the thumbprint. + of an ESXi host. This can be used when adding the `Host` resource to a + cluster or a vCenter Server instance. + + * If the ESXi host is using a certificate chain, the first one returned will be + used to generate the thumbprint. + + * If the ESXi host has a certificate issued by a certificate authority, ensure + that the the certificate authority is trusted on the system running the plan. ## Example Usage @@ -93,8 +98,7 @@ def get_host_thumbprint(address: Optional[str] = None, :param str address: The address of the ESXi host to retrieve the thumbprint from. - :param bool insecure: Disables SSL certificate verification. - Default: `false` + :param bool insecure: Disables SSL certificate verification. Default: `false` :param str port: The port to use connecting to the ESXi host. Default: 443 """ __args__ = dict() @@ -118,9 +122,14 @@ def get_host_thumbprint_output(address: Optional[pulumi.Input[str]] = None, opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetHostThumbprintResult]: """ The `vsphere_thumbprint` data source can be used to discover the host thumbprint - of an ESXi host. This can be used when adding the `Host` resource. If - the ESXi host is using a certificate chain, the first one returned will be used - to generate the thumbprint. + of an ESXi host. This can be used when adding the `Host` resource to a + cluster or a vCenter Server instance. + + * If the ESXi host is using a certificate chain, the first one returned will be + used to generate the thumbprint. + + * If the ESXi host has a certificate issued by a certificate authority, ensure + that the the certificate authority is trusted on the system running the plan. ## Example Usage @@ -134,8 +143,7 @@ def get_host_thumbprint_output(address: Optional[pulumi.Input[str]] = None, :param str address: The address of the ESXi host to retrieve the thumbprint from. - :param bool insecure: Disables SSL certificate verification. - Default: `false` + :param bool insecure: Disables SSL certificate verification. Default: `false` :param str port: The port to use connecting to the ESXi host. Default: 443 """ ... diff --git a/sdk/python/pulumi_vsphere/host.py b/sdk/python/pulumi_vsphere/host.py index 34af730e..3044457c 100644 --- a/sdk/python/pulumi_vsphere/host.py +++ b/sdk/python/pulumi_vsphere/host.py @@ -656,10 +656,10 @@ def __init__(__self__, import pulumi_vsphere as vsphere datacenter = vsphere.get_datacenter(name="dc-01") - thumbprint = vsphere.get_host_thumbprint(address="esx-01.example.com", + thumbprint = vsphere.get_host_thumbprint(address="esxi-01.example.com", insecure=True) esx_01 = vsphere.Host("esx-01", - hostname="esx-01.example.com", + hostname="esxi-01.example.com", username="root", password="password", license="00000-00000-00000-00000-00000", @@ -687,7 +687,7 @@ def __init__(__self__, data "vsphere_host" "host" { - name = "esx-01.example.com" + name = "esxi-01.example.com" datacenter_id = data.vsphere_datacenter.datacenter.id @@ -711,7 +711,7 @@ def __init__(__self__, data "vsphere_host_thumbprint" "thumbprint" { - address = "esx-01.example.com" + address = "esxi-01.example.com" insecure = true @@ -719,7 +719,7 @@ def __init__(__self__, resource "vsphere_host" "esx-01" { - hostname = "esx-01.example.com" + hostname = "esxi-01.example.com" username = "root" @@ -735,7 +735,7 @@ def __init__(__self__, resource "vsphere_host" "esx-01" { - hostname = "esx-01.example.com" + hostname = "esxi-01.example.com" username = "root" @@ -767,7 +767,7 @@ def __init__(__self__, $ pulumi import vsphere:index/host:Host esx-01 host-123 ``` - The above would import the host `esx-01.example.com` with the host ID `host-123`. + The above would import the host `esxi-01.example.com` with the host ID `host-123`. :param str resource_name: The name of the resource. :param pulumi.ResourceOptions opts: Options for the resource. @@ -835,10 +835,10 @@ def __init__(__self__, import pulumi_vsphere as vsphere datacenter = vsphere.get_datacenter(name="dc-01") - thumbprint = vsphere.get_host_thumbprint(address="esx-01.example.com", + thumbprint = vsphere.get_host_thumbprint(address="esxi-01.example.com", insecure=True) esx_01 = vsphere.Host("esx-01", - hostname="esx-01.example.com", + hostname="esxi-01.example.com", username="root", password="password", license="00000-00000-00000-00000-00000", @@ -866,7 +866,7 @@ def __init__(__self__, data "vsphere_host" "host" { - name = "esx-01.example.com" + name = "esxi-01.example.com" datacenter_id = data.vsphere_datacenter.datacenter.id @@ -890,7 +890,7 @@ def __init__(__self__, data "vsphere_host_thumbprint" "thumbprint" { - address = "esx-01.example.com" + address = "esxi-01.example.com" insecure = true @@ -898,7 +898,7 @@ def __init__(__self__, resource "vsphere_host" "esx-01" { - hostname = "esx-01.example.com" + hostname = "esxi-01.example.com" username = "root" @@ -914,7 +914,7 @@ def __init__(__self__, resource "vsphere_host" "esx-01" { - hostname = "esx-01.example.com" + hostname = "esxi-01.example.com" username = "root" @@ -946,7 +946,7 @@ def __init__(__self__, $ pulumi import vsphere:index/host:Host esx-01 host-123 ``` - The above would import the host `esx-01.example.com` with the host ID `host-123`. + The above would import the host `esxi-01.example.com` with the host ID `host-123`. :param str resource_name: The name of the resource. :param HostArgs args: The arguments to use to populate this resource's properties. diff --git a/sdk/python/pulumi_vsphere/resource_pool.py b/sdk/python/pulumi_vsphere/resource_pool.py index 7d661adf..847329fe 100644 --- a/sdk/python/pulumi_vsphere/resource_pool.py +++ b/sdk/python/pulumi_vsphere/resource_pool.py @@ -31,50 +31,30 @@ def __init__(__self__, *, tags: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None): """ The set of arguments for constructing a ResourcePool resource. - :param pulumi.Input[str] parent_resource_pool_id: The managed object ID - of the parent resource pool. This can be the root resource pool for a cluster - or standalone host, or a resource pool itself. When moving a resource pool - from one parent resource pool to another, both must share a common root - resource pool. - :param pulumi.Input[bool] cpu_expandable: Determines if the reservation on a resource - pool can grow beyond the specified value if the parent resource pool has - unreserved resources. Default: `true` - :param pulumi.Input[int] cpu_limit: The CPU utilization of a resource pool will not - exceed this limit, even if there are available resources. Set to `-1` for - unlimited. Default: `-1` - :param pulumi.Input[int] cpu_reservation: Amount of CPU (MHz) that is guaranteed - available to the resource pool. Default: `0` - :param pulumi.Input[str] cpu_share_level: The CPU allocation level. The level is a - simplified view of shares. Levels map to a pre-determined set of numeric - values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - `low`, `normal`, or `high` are specified values in `cpu_shares` will be - ignored. Default: `normal` - :param pulumi.Input[int] cpu_shares: The number of shares allocated for CPU. Used to - determine resource allocation in case of resource contention. If this is set, - `cpu_share_level` must be `custom`. + :param pulumi.Input[str] parent_resource_pool_id: The ID of the root resource pool of the compute resource the resource pool is in. + :param pulumi.Input[bool] cpu_expandable: Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + unreserved resources. + :param pulumi.Input[int] cpu_limit: The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + unlimited. + :param pulumi.Input[int] cpu_reservation: Amount of CPU (MHz) that is guaranteed available to the resource pool. + :param pulumi.Input[str] cpu_share_level: The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + shares. Can be one of low, normal, high, or custom. + :param pulumi.Input[int] cpu_shares: The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + cpu_share_level must be custom. :param pulumi.Input[Mapping[str, pulumi.Input[str]]] custom_attributes: A list of custom attributes to set on this resource. - :param pulumi.Input[bool] memory_expandable: Determines if the reservation on a resource - pool can grow beyond the specified value if the parent resource pool has - unreserved resources. Default: `true` - :param pulumi.Input[int] memory_limit: The CPU utilization of a resource pool will not - exceed this limit, even if there are available resources. Set to `-1` for - unlimited. Default: `-1` - :param pulumi.Input[int] memory_reservation: Amount of CPU (MHz) that is guaranteed - available to the resource pool. Default: `0` - :param pulumi.Input[str] memory_share_level: The CPU allocation level. The level is a - simplified view of shares. Levels map to a pre-determined set of numeric - values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - `low`, `normal`, or `high` are specified values in `memory_shares` will be - ignored. Default: `normal` - :param pulumi.Input[int] memory_shares: The number of shares allocated for CPU. Used to - determine resource allocation in case of resource contention. If this is set, - `memory_share_level` must be `custom`. - :param pulumi.Input[str] name: The name of the resource pool. - :param pulumi.Input[str] scale_descendants_shares: Determines if the shares of all - descendants of the resource pool are scaled up or down when the shares - of the resource pool are scaled up or down. Can be one of `disabled` or - `scaleCpuAndMemoryShares`. Default: `disabled`. - :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource. + :param pulumi.Input[bool] memory_expandable: Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + unreserved resources. + :param pulumi.Input[int] memory_limit: The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + unlimited. + :param pulumi.Input[int] memory_reservation: Amount of memory (MB) that is guaranteed available to the resource pool. + :param pulumi.Input[str] memory_share_level: The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + shares. Can be one of low, normal, high, or custom. + :param pulumi.Input[int] memory_shares: The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + memory_share_level must be custom. + :param pulumi.Input[str] name: Name of resource pool. + :param pulumi.Input[str] scale_descendants_shares: Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource + pool are scaled up or down. + :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: A list of tag IDs to apply to this object. """ pulumi.set(__self__, "parent_resource_pool_id", parent_resource_pool_id) if cpu_expandable is not None: @@ -110,11 +90,7 @@ def __init__(__self__, *, @pulumi.getter(name="parentResourcePoolId") def parent_resource_pool_id(self) -> pulumi.Input[str]: """ - The managed object ID - of the parent resource pool. This can be the root resource pool for a cluster - or standalone host, or a resource pool itself. When moving a resource pool - from one parent resource pool to another, both must share a common root - resource pool. + The ID of the root resource pool of the compute resource the resource pool is in. """ return pulumi.get(self, "parent_resource_pool_id") @@ -126,9 +102,8 @@ def parent_resource_pool_id(self, value: pulumi.Input[str]): @pulumi.getter(name="cpuExpandable") def cpu_expandable(self) -> Optional[pulumi.Input[bool]]: """ - Determines if the reservation on a resource - pool can grow beyond the specified value if the parent resource pool has - unreserved resources. Default: `true` + Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + unreserved resources. """ return pulumi.get(self, "cpu_expandable") @@ -140,9 +115,8 @@ def cpu_expandable(self, value: Optional[pulumi.Input[bool]]): @pulumi.getter(name="cpuLimit") def cpu_limit(self) -> Optional[pulumi.Input[int]]: """ - The CPU utilization of a resource pool will not - exceed this limit, even if there are available resources. Set to `-1` for - unlimited. Default: `-1` + The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + unlimited. """ return pulumi.get(self, "cpu_limit") @@ -154,8 +128,7 @@ def cpu_limit(self, value: Optional[pulumi.Input[int]]): @pulumi.getter(name="cpuReservation") def cpu_reservation(self) -> Optional[pulumi.Input[int]]: """ - Amount of CPU (MHz) that is guaranteed - available to the resource pool. Default: `0` + Amount of CPU (MHz) that is guaranteed available to the resource pool. """ return pulumi.get(self, "cpu_reservation") @@ -167,11 +140,8 @@ def cpu_reservation(self, value: Optional[pulumi.Input[int]]): @pulumi.getter(name="cpuShareLevel") def cpu_share_level(self) -> Optional[pulumi.Input[str]]: """ - The CPU allocation level. The level is a - simplified view of shares. Levels map to a pre-determined set of numeric - values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - `low`, `normal`, or `high` are specified values in `cpu_shares` will be - ignored. Default: `normal` + The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + shares. Can be one of low, normal, high, or custom. """ return pulumi.get(self, "cpu_share_level") @@ -183,9 +153,8 @@ def cpu_share_level(self, value: Optional[pulumi.Input[str]]): @pulumi.getter(name="cpuShares") def cpu_shares(self) -> Optional[pulumi.Input[int]]: """ - The number of shares allocated for CPU. Used to - determine resource allocation in case of resource contention. If this is set, - `cpu_share_level` must be `custom`. + The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + cpu_share_level must be custom. """ return pulumi.get(self, "cpu_shares") @@ -209,9 +178,8 @@ def custom_attributes(self, value: Optional[pulumi.Input[Mapping[str, pulumi.Inp @pulumi.getter(name="memoryExpandable") def memory_expandable(self) -> Optional[pulumi.Input[bool]]: """ - Determines if the reservation on a resource - pool can grow beyond the specified value if the parent resource pool has - unreserved resources. Default: `true` + Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + unreserved resources. """ return pulumi.get(self, "memory_expandable") @@ -223,9 +191,8 @@ def memory_expandable(self, value: Optional[pulumi.Input[bool]]): @pulumi.getter(name="memoryLimit") def memory_limit(self) -> Optional[pulumi.Input[int]]: """ - The CPU utilization of a resource pool will not - exceed this limit, even if there are available resources. Set to `-1` for - unlimited. Default: `-1` + The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + unlimited. """ return pulumi.get(self, "memory_limit") @@ -237,8 +204,7 @@ def memory_limit(self, value: Optional[pulumi.Input[int]]): @pulumi.getter(name="memoryReservation") def memory_reservation(self) -> Optional[pulumi.Input[int]]: """ - Amount of CPU (MHz) that is guaranteed - available to the resource pool. Default: `0` + Amount of memory (MB) that is guaranteed available to the resource pool. """ return pulumi.get(self, "memory_reservation") @@ -250,11 +216,8 @@ def memory_reservation(self, value: Optional[pulumi.Input[int]]): @pulumi.getter(name="memoryShareLevel") def memory_share_level(self) -> Optional[pulumi.Input[str]]: """ - The CPU allocation level. The level is a - simplified view of shares. Levels map to a pre-determined set of numeric - values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - `low`, `normal`, or `high` are specified values in `memory_shares` will be - ignored. Default: `normal` + The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + shares. Can be one of low, normal, high, or custom. """ return pulumi.get(self, "memory_share_level") @@ -266,9 +229,8 @@ def memory_share_level(self, value: Optional[pulumi.Input[str]]): @pulumi.getter(name="memoryShares") def memory_shares(self) -> Optional[pulumi.Input[int]]: """ - The number of shares allocated for CPU. Used to - determine resource allocation in case of resource contention. If this is set, - `memory_share_level` must be `custom`. + The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + memory_share_level must be custom. """ return pulumi.get(self, "memory_shares") @@ -280,7 +242,7 @@ def memory_shares(self, value: Optional[pulumi.Input[int]]): @pulumi.getter def name(self) -> Optional[pulumi.Input[str]]: """ - The name of the resource pool. + Name of resource pool. """ return pulumi.get(self, "name") @@ -292,10 +254,8 @@ def name(self, value: Optional[pulumi.Input[str]]): @pulumi.getter(name="scaleDescendantsShares") def scale_descendants_shares(self) -> Optional[pulumi.Input[str]]: """ - Determines if the shares of all - descendants of the resource pool are scaled up or down when the shares - of the resource pool are scaled up or down. Can be one of `disabled` or - `scaleCpuAndMemoryShares`. Default: `disabled`. + Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource + pool are scaled up or down. """ return pulumi.get(self, "scale_descendants_shares") @@ -307,7 +267,7 @@ def scale_descendants_shares(self, value: Optional[pulumi.Input[str]]): @pulumi.getter def tags(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]: """ - The IDs of any tags to attach to this resource. + A list of tag IDs to apply to this object. """ return pulumi.get(self, "tags") @@ -336,50 +296,30 @@ def __init__(__self__, *, tags: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None): """ Input properties used for looking up and filtering ResourcePool resources. - :param pulumi.Input[bool] cpu_expandable: Determines if the reservation on a resource - pool can grow beyond the specified value if the parent resource pool has - unreserved resources. Default: `true` - :param pulumi.Input[int] cpu_limit: The CPU utilization of a resource pool will not - exceed this limit, even if there are available resources. Set to `-1` for - unlimited. Default: `-1` - :param pulumi.Input[int] cpu_reservation: Amount of CPU (MHz) that is guaranteed - available to the resource pool. Default: `0` - :param pulumi.Input[str] cpu_share_level: The CPU allocation level. The level is a - simplified view of shares. Levels map to a pre-determined set of numeric - values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - `low`, `normal`, or `high` are specified values in `cpu_shares` will be - ignored. Default: `normal` - :param pulumi.Input[int] cpu_shares: The number of shares allocated for CPU. Used to - determine resource allocation in case of resource contention. If this is set, - `cpu_share_level` must be `custom`. + :param pulumi.Input[bool] cpu_expandable: Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + unreserved resources. + :param pulumi.Input[int] cpu_limit: The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + unlimited. + :param pulumi.Input[int] cpu_reservation: Amount of CPU (MHz) that is guaranteed available to the resource pool. + :param pulumi.Input[str] cpu_share_level: The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + shares. Can be one of low, normal, high, or custom. + :param pulumi.Input[int] cpu_shares: The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + cpu_share_level must be custom. :param pulumi.Input[Mapping[str, pulumi.Input[str]]] custom_attributes: A list of custom attributes to set on this resource. - :param pulumi.Input[bool] memory_expandable: Determines if the reservation on a resource - pool can grow beyond the specified value if the parent resource pool has - unreserved resources. Default: `true` - :param pulumi.Input[int] memory_limit: The CPU utilization of a resource pool will not - exceed this limit, even if there are available resources. Set to `-1` for - unlimited. Default: `-1` - :param pulumi.Input[int] memory_reservation: Amount of CPU (MHz) that is guaranteed - available to the resource pool. Default: `0` - :param pulumi.Input[str] memory_share_level: The CPU allocation level. The level is a - simplified view of shares. Levels map to a pre-determined set of numeric - values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - `low`, `normal`, or `high` are specified values in `memory_shares` will be - ignored. Default: `normal` - :param pulumi.Input[int] memory_shares: The number of shares allocated for CPU. Used to - determine resource allocation in case of resource contention. If this is set, - `memory_share_level` must be `custom`. - :param pulumi.Input[str] name: The name of the resource pool. - :param pulumi.Input[str] parent_resource_pool_id: The managed object ID - of the parent resource pool. This can be the root resource pool for a cluster - or standalone host, or a resource pool itself. When moving a resource pool - from one parent resource pool to another, both must share a common root - resource pool. - :param pulumi.Input[str] scale_descendants_shares: Determines if the shares of all - descendants of the resource pool are scaled up or down when the shares - of the resource pool are scaled up or down. Can be one of `disabled` or - `scaleCpuAndMemoryShares`. Default: `disabled`. - :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource. + :param pulumi.Input[bool] memory_expandable: Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + unreserved resources. + :param pulumi.Input[int] memory_limit: The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + unlimited. + :param pulumi.Input[int] memory_reservation: Amount of memory (MB) that is guaranteed available to the resource pool. + :param pulumi.Input[str] memory_share_level: The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + shares. Can be one of low, normal, high, or custom. + :param pulumi.Input[int] memory_shares: The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + memory_share_level must be custom. + :param pulumi.Input[str] name: Name of resource pool. + :param pulumi.Input[str] parent_resource_pool_id: The ID of the root resource pool of the compute resource the resource pool is in. + :param pulumi.Input[str] scale_descendants_shares: Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource + pool are scaled up or down. + :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: A list of tag IDs to apply to this object. """ if cpu_expandable is not None: pulumi.set(__self__, "cpu_expandable", cpu_expandable) @@ -416,9 +356,8 @@ def __init__(__self__, *, @pulumi.getter(name="cpuExpandable") def cpu_expandable(self) -> Optional[pulumi.Input[bool]]: """ - Determines if the reservation on a resource - pool can grow beyond the specified value if the parent resource pool has - unreserved resources. Default: `true` + Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + unreserved resources. """ return pulumi.get(self, "cpu_expandable") @@ -430,9 +369,8 @@ def cpu_expandable(self, value: Optional[pulumi.Input[bool]]): @pulumi.getter(name="cpuLimit") def cpu_limit(self) -> Optional[pulumi.Input[int]]: """ - The CPU utilization of a resource pool will not - exceed this limit, even if there are available resources. Set to `-1` for - unlimited. Default: `-1` + The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + unlimited. """ return pulumi.get(self, "cpu_limit") @@ -444,8 +382,7 @@ def cpu_limit(self, value: Optional[pulumi.Input[int]]): @pulumi.getter(name="cpuReservation") def cpu_reservation(self) -> Optional[pulumi.Input[int]]: """ - Amount of CPU (MHz) that is guaranteed - available to the resource pool. Default: `0` + Amount of CPU (MHz) that is guaranteed available to the resource pool. """ return pulumi.get(self, "cpu_reservation") @@ -457,11 +394,8 @@ def cpu_reservation(self, value: Optional[pulumi.Input[int]]): @pulumi.getter(name="cpuShareLevel") def cpu_share_level(self) -> Optional[pulumi.Input[str]]: """ - The CPU allocation level. The level is a - simplified view of shares. Levels map to a pre-determined set of numeric - values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - `low`, `normal`, or `high` are specified values in `cpu_shares` will be - ignored. Default: `normal` + The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + shares. Can be one of low, normal, high, or custom. """ return pulumi.get(self, "cpu_share_level") @@ -473,9 +407,8 @@ def cpu_share_level(self, value: Optional[pulumi.Input[str]]): @pulumi.getter(name="cpuShares") def cpu_shares(self) -> Optional[pulumi.Input[int]]: """ - The number of shares allocated for CPU. Used to - determine resource allocation in case of resource contention. If this is set, - `cpu_share_level` must be `custom`. + The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + cpu_share_level must be custom. """ return pulumi.get(self, "cpu_shares") @@ -499,9 +432,8 @@ def custom_attributes(self, value: Optional[pulumi.Input[Mapping[str, pulumi.Inp @pulumi.getter(name="memoryExpandable") def memory_expandable(self) -> Optional[pulumi.Input[bool]]: """ - Determines if the reservation on a resource - pool can grow beyond the specified value if the parent resource pool has - unreserved resources. Default: `true` + Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + unreserved resources. """ return pulumi.get(self, "memory_expandable") @@ -513,9 +445,8 @@ def memory_expandable(self, value: Optional[pulumi.Input[bool]]): @pulumi.getter(name="memoryLimit") def memory_limit(self) -> Optional[pulumi.Input[int]]: """ - The CPU utilization of a resource pool will not - exceed this limit, even if there are available resources. Set to `-1` for - unlimited. Default: `-1` + The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + unlimited. """ return pulumi.get(self, "memory_limit") @@ -527,8 +458,7 @@ def memory_limit(self, value: Optional[pulumi.Input[int]]): @pulumi.getter(name="memoryReservation") def memory_reservation(self) -> Optional[pulumi.Input[int]]: """ - Amount of CPU (MHz) that is guaranteed - available to the resource pool. Default: `0` + Amount of memory (MB) that is guaranteed available to the resource pool. """ return pulumi.get(self, "memory_reservation") @@ -540,11 +470,8 @@ def memory_reservation(self, value: Optional[pulumi.Input[int]]): @pulumi.getter(name="memoryShareLevel") def memory_share_level(self) -> Optional[pulumi.Input[str]]: """ - The CPU allocation level. The level is a - simplified view of shares. Levels map to a pre-determined set of numeric - values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - `low`, `normal`, or `high` are specified values in `memory_shares` will be - ignored. Default: `normal` + The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + shares. Can be one of low, normal, high, or custom. """ return pulumi.get(self, "memory_share_level") @@ -556,9 +483,8 @@ def memory_share_level(self, value: Optional[pulumi.Input[str]]): @pulumi.getter(name="memoryShares") def memory_shares(self) -> Optional[pulumi.Input[int]]: """ - The number of shares allocated for CPU. Used to - determine resource allocation in case of resource contention. If this is set, - `memory_share_level` must be `custom`. + The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + memory_share_level must be custom. """ return pulumi.get(self, "memory_shares") @@ -570,7 +496,7 @@ def memory_shares(self, value: Optional[pulumi.Input[int]]): @pulumi.getter def name(self) -> Optional[pulumi.Input[str]]: """ - The name of the resource pool. + Name of resource pool. """ return pulumi.get(self, "name") @@ -582,11 +508,7 @@ def name(self, value: Optional[pulumi.Input[str]]): @pulumi.getter(name="parentResourcePoolId") def parent_resource_pool_id(self) -> Optional[pulumi.Input[str]]: """ - The managed object ID - of the parent resource pool. This can be the root resource pool for a cluster - or standalone host, or a resource pool itself. When moving a resource pool - from one parent resource pool to another, both must share a common root - resource pool. + The ID of the root resource pool of the compute resource the resource pool is in. """ return pulumi.get(self, "parent_resource_pool_id") @@ -598,10 +520,8 @@ def parent_resource_pool_id(self, value: Optional[pulumi.Input[str]]): @pulumi.getter(name="scaleDescendantsShares") def scale_descendants_shares(self) -> Optional[pulumi.Input[str]]: """ - Determines if the shares of all - descendants of the resource pool are scaled up or down when the shares - of the resource pool are scaled up or down. Can be one of `disabled` or - `scaleCpuAndMemoryShares`. Default: `disabled`. + Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource + pool are scaled up or down. """ return pulumi.get(self, "scale_descendants_shares") @@ -613,7 +533,7 @@ def scale_descendants_shares(self, value: Optional[pulumi.Input[str]]): @pulumi.getter def tags(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]: """ - The IDs of any tags to attach to this resource. + A list of tag IDs to apply to this object. """ return pulumi.get(self, "tags") @@ -644,114 +564,33 @@ def __init__(__self__, tags: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None, __props__=None): """ - The `ResourcePool` resource can be used to create and manage - resource pools on DRS-enabled vSphere clusters or standalone ESXi hosts. - - For more information on vSphere resource pools, please refer to the - [product documentation][ref-vsphere-resource_pools]. - - [ref-vsphere-resource_pools]: https://docs.vmware.com/en/VMware-vSphere/8.0/vsphere-resource-management/GUID-60077B40-66FF-4625-934A-641703ED7601.html - - ## Example Usage - - The following example sets up a resource pool in an existing compute cluster - with the default settings for CPU and memory reservations, shares, and limits. - - ```python - import pulumi - import pulumi_vsphere as vsphere - - datacenter = vsphere.get_datacenter(name="dc-01") - compute_cluster = vsphere.get_compute_cluster(name="cluster-01", - datacenter_id=datacenter.id) - resource_pool = vsphere.ResourcePool("resource_pool", - name="resource-pool-01", - parent_resource_pool_id=compute_cluster.resource_pool_id) - ``` - - A virtual machine resource could be targeted to use the default resource pool - of the cluster using the following: - - ```python - import pulumi - import pulumi_vsphere as vsphere - - vm = vsphere.VirtualMachine("vm", resource_pool_id=cluster["resourcePoolId"]) - ``` - - The following example sets up a parent resource pool in an existing compute cluster - with a child resource pool nested below. Each resource pool is configured with - the default settings for CPU and memory reservations, shares, and limits. - - ```python - import pulumi - import pulumi_vsphere as vsphere - - datacenter = vsphere.get_datacenter(name="dc-01") - compute_cluster = vsphere.get_compute_cluster(name="cluster-01", - datacenter_id=datacenter.id) - resource_pool_parent = vsphere.ResourcePool("resource_pool_parent", - name="parent", - parent_resource_pool_id=compute_cluster.resource_pool_id) - resource_pool_child = vsphere.ResourcePool("resource_pool_child", - name="child", - parent_resource_pool_id=resource_pool_parent.id) - ``` - - ## Import - - ### Settings that Require vSphere 7.0 or higher - - These settings require vSphere 7.0 or higher: - - * [`scale_descendants_shares`](#scale_descendants_shares) - + Create a ResourcePool resource with the given unique name, props, and options. :param str resource_name: The name of the resource. :param pulumi.ResourceOptions opts: Options for the resource. - :param pulumi.Input[bool] cpu_expandable: Determines if the reservation on a resource - pool can grow beyond the specified value if the parent resource pool has - unreserved resources. Default: `true` - :param pulumi.Input[int] cpu_limit: The CPU utilization of a resource pool will not - exceed this limit, even if there are available resources. Set to `-1` for - unlimited. Default: `-1` - :param pulumi.Input[int] cpu_reservation: Amount of CPU (MHz) that is guaranteed - available to the resource pool. Default: `0` - :param pulumi.Input[str] cpu_share_level: The CPU allocation level. The level is a - simplified view of shares. Levels map to a pre-determined set of numeric - values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - `low`, `normal`, or `high` are specified values in `cpu_shares` will be - ignored. Default: `normal` - :param pulumi.Input[int] cpu_shares: The number of shares allocated for CPU. Used to - determine resource allocation in case of resource contention. If this is set, - `cpu_share_level` must be `custom`. + :param pulumi.Input[bool] cpu_expandable: Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + unreserved resources. + :param pulumi.Input[int] cpu_limit: The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + unlimited. + :param pulumi.Input[int] cpu_reservation: Amount of CPU (MHz) that is guaranteed available to the resource pool. + :param pulumi.Input[str] cpu_share_level: The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + shares. Can be one of low, normal, high, or custom. + :param pulumi.Input[int] cpu_shares: The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + cpu_share_level must be custom. :param pulumi.Input[Mapping[str, pulumi.Input[str]]] custom_attributes: A list of custom attributes to set on this resource. - :param pulumi.Input[bool] memory_expandable: Determines if the reservation on a resource - pool can grow beyond the specified value if the parent resource pool has - unreserved resources. Default: `true` - :param pulumi.Input[int] memory_limit: The CPU utilization of a resource pool will not - exceed this limit, even if there are available resources. Set to `-1` for - unlimited. Default: `-1` - :param pulumi.Input[int] memory_reservation: Amount of CPU (MHz) that is guaranteed - available to the resource pool. Default: `0` - :param pulumi.Input[str] memory_share_level: The CPU allocation level. The level is a - simplified view of shares. Levels map to a pre-determined set of numeric - values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - `low`, `normal`, or `high` are specified values in `memory_shares` will be - ignored. Default: `normal` - :param pulumi.Input[int] memory_shares: The number of shares allocated for CPU. Used to - determine resource allocation in case of resource contention. If this is set, - `memory_share_level` must be `custom`. - :param pulumi.Input[str] name: The name of the resource pool. - :param pulumi.Input[str] parent_resource_pool_id: The managed object ID - of the parent resource pool. This can be the root resource pool for a cluster - or standalone host, or a resource pool itself. When moving a resource pool - from one parent resource pool to another, both must share a common root - resource pool. - :param pulumi.Input[str] scale_descendants_shares: Determines if the shares of all - descendants of the resource pool are scaled up or down when the shares - of the resource pool are scaled up or down. Can be one of `disabled` or - `scaleCpuAndMemoryShares`. Default: `disabled`. - :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource. + :param pulumi.Input[bool] memory_expandable: Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + unreserved resources. + :param pulumi.Input[int] memory_limit: The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + unlimited. + :param pulumi.Input[int] memory_reservation: Amount of memory (MB) that is guaranteed available to the resource pool. + :param pulumi.Input[str] memory_share_level: The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + shares. Can be one of low, normal, high, or custom. + :param pulumi.Input[int] memory_shares: The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + memory_share_level must be custom. + :param pulumi.Input[str] name: Name of resource pool. + :param pulumi.Input[str] parent_resource_pool_id: The ID of the root resource pool of the compute resource the resource pool is in. + :param pulumi.Input[str] scale_descendants_shares: Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource + pool are scaled up or down. + :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: A list of tag IDs to apply to this object. """ ... @overload @@ -760,68 +599,7 @@ def __init__(__self__, args: ResourcePoolArgs, opts: Optional[pulumi.ResourceOptions] = None): """ - The `ResourcePool` resource can be used to create and manage - resource pools on DRS-enabled vSphere clusters or standalone ESXi hosts. - - For more information on vSphere resource pools, please refer to the - [product documentation][ref-vsphere-resource_pools]. - - [ref-vsphere-resource_pools]: https://docs.vmware.com/en/VMware-vSphere/8.0/vsphere-resource-management/GUID-60077B40-66FF-4625-934A-641703ED7601.html - - ## Example Usage - - The following example sets up a resource pool in an existing compute cluster - with the default settings for CPU and memory reservations, shares, and limits. - - ```python - import pulumi - import pulumi_vsphere as vsphere - - datacenter = vsphere.get_datacenter(name="dc-01") - compute_cluster = vsphere.get_compute_cluster(name="cluster-01", - datacenter_id=datacenter.id) - resource_pool = vsphere.ResourcePool("resource_pool", - name="resource-pool-01", - parent_resource_pool_id=compute_cluster.resource_pool_id) - ``` - - A virtual machine resource could be targeted to use the default resource pool - of the cluster using the following: - - ```python - import pulumi - import pulumi_vsphere as vsphere - - vm = vsphere.VirtualMachine("vm", resource_pool_id=cluster["resourcePoolId"]) - ``` - - The following example sets up a parent resource pool in an existing compute cluster - with a child resource pool nested below. Each resource pool is configured with - the default settings for CPU and memory reservations, shares, and limits. - - ```python - import pulumi - import pulumi_vsphere as vsphere - - datacenter = vsphere.get_datacenter(name="dc-01") - compute_cluster = vsphere.get_compute_cluster(name="cluster-01", - datacenter_id=datacenter.id) - resource_pool_parent = vsphere.ResourcePool("resource_pool_parent", - name="parent", - parent_resource_pool_id=compute_cluster.resource_pool_id) - resource_pool_child = vsphere.ResourcePool("resource_pool_child", - name="child", - parent_resource_pool_id=resource_pool_parent.id) - ``` - - ## Import - - ### Settings that Require vSphere 7.0 or higher - - These settings require vSphere 7.0 or higher: - - * [`scale_descendants_shares`](#scale_descendants_shares) - + Create a ResourcePool resource with the given unique name, props, and options. :param str resource_name: The name of the resource. :param ResourcePoolArgs args: The arguments to use to populate this resource's properties. :param pulumi.ResourceOptions opts: Options for the resource. @@ -910,50 +688,30 @@ def get(resource_name: str, :param str resource_name: The unique name of the resulting resource. :param pulumi.Input[str] id: The unique provider ID of the resource to lookup. :param pulumi.ResourceOptions opts: Options for the resource. - :param pulumi.Input[bool] cpu_expandable: Determines if the reservation on a resource - pool can grow beyond the specified value if the parent resource pool has - unreserved resources. Default: `true` - :param pulumi.Input[int] cpu_limit: The CPU utilization of a resource pool will not - exceed this limit, even if there are available resources. Set to `-1` for - unlimited. Default: `-1` - :param pulumi.Input[int] cpu_reservation: Amount of CPU (MHz) that is guaranteed - available to the resource pool. Default: `0` - :param pulumi.Input[str] cpu_share_level: The CPU allocation level. The level is a - simplified view of shares. Levels map to a pre-determined set of numeric - values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - `low`, `normal`, or `high` are specified values in `cpu_shares` will be - ignored. Default: `normal` - :param pulumi.Input[int] cpu_shares: The number of shares allocated for CPU. Used to - determine resource allocation in case of resource contention. If this is set, - `cpu_share_level` must be `custom`. + :param pulumi.Input[bool] cpu_expandable: Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + unreserved resources. + :param pulumi.Input[int] cpu_limit: The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + unlimited. + :param pulumi.Input[int] cpu_reservation: Amount of CPU (MHz) that is guaranteed available to the resource pool. + :param pulumi.Input[str] cpu_share_level: The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + shares. Can be one of low, normal, high, or custom. + :param pulumi.Input[int] cpu_shares: The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + cpu_share_level must be custom. :param pulumi.Input[Mapping[str, pulumi.Input[str]]] custom_attributes: A list of custom attributes to set on this resource. - :param pulumi.Input[bool] memory_expandable: Determines if the reservation on a resource - pool can grow beyond the specified value if the parent resource pool has - unreserved resources. Default: `true` - :param pulumi.Input[int] memory_limit: The CPU utilization of a resource pool will not - exceed this limit, even if there are available resources. Set to `-1` for - unlimited. Default: `-1` - :param pulumi.Input[int] memory_reservation: Amount of CPU (MHz) that is guaranteed - available to the resource pool. Default: `0` - :param pulumi.Input[str] memory_share_level: The CPU allocation level. The level is a - simplified view of shares. Levels map to a pre-determined set of numeric - values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - `low`, `normal`, or `high` are specified values in `memory_shares` will be - ignored. Default: `normal` - :param pulumi.Input[int] memory_shares: The number of shares allocated for CPU. Used to - determine resource allocation in case of resource contention. If this is set, - `memory_share_level` must be `custom`. - :param pulumi.Input[str] name: The name of the resource pool. - :param pulumi.Input[str] parent_resource_pool_id: The managed object ID - of the parent resource pool. This can be the root resource pool for a cluster - or standalone host, or a resource pool itself. When moving a resource pool - from one parent resource pool to another, both must share a common root - resource pool. - :param pulumi.Input[str] scale_descendants_shares: Determines if the shares of all - descendants of the resource pool are scaled up or down when the shares - of the resource pool are scaled up or down. Can be one of `disabled` or - `scaleCpuAndMemoryShares`. Default: `disabled`. - :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource. + :param pulumi.Input[bool] memory_expandable: Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + unreserved resources. + :param pulumi.Input[int] memory_limit: The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + unlimited. + :param pulumi.Input[int] memory_reservation: Amount of memory (MB) that is guaranteed available to the resource pool. + :param pulumi.Input[str] memory_share_level: The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + shares. Can be one of low, normal, high, or custom. + :param pulumi.Input[int] memory_shares: The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + memory_share_level must be custom. + :param pulumi.Input[str] name: Name of resource pool. + :param pulumi.Input[str] parent_resource_pool_id: The ID of the root resource pool of the compute resource the resource pool is in. + :param pulumi.Input[str] scale_descendants_shares: Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource + pool are scaled up or down. + :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: A list of tag IDs to apply to this object. """ opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id)) @@ -980,9 +738,8 @@ def get(resource_name: str, @pulumi.getter(name="cpuExpandable") def cpu_expandable(self) -> pulumi.Output[Optional[bool]]: """ - Determines if the reservation on a resource - pool can grow beyond the specified value if the parent resource pool has - unreserved resources. Default: `true` + Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + unreserved resources. """ return pulumi.get(self, "cpu_expandable") @@ -990,9 +747,8 @@ def cpu_expandable(self) -> pulumi.Output[Optional[bool]]: @pulumi.getter(name="cpuLimit") def cpu_limit(self) -> pulumi.Output[Optional[int]]: """ - The CPU utilization of a resource pool will not - exceed this limit, even if there are available resources. Set to `-1` for - unlimited. Default: `-1` + The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + unlimited. """ return pulumi.get(self, "cpu_limit") @@ -1000,8 +756,7 @@ def cpu_limit(self) -> pulumi.Output[Optional[int]]: @pulumi.getter(name="cpuReservation") def cpu_reservation(self) -> pulumi.Output[Optional[int]]: """ - Amount of CPU (MHz) that is guaranteed - available to the resource pool. Default: `0` + Amount of CPU (MHz) that is guaranteed available to the resource pool. """ return pulumi.get(self, "cpu_reservation") @@ -1009,11 +764,8 @@ def cpu_reservation(self) -> pulumi.Output[Optional[int]]: @pulumi.getter(name="cpuShareLevel") def cpu_share_level(self) -> pulumi.Output[Optional[str]]: """ - The CPU allocation level. The level is a - simplified view of shares. Levels map to a pre-determined set of numeric - values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - `low`, `normal`, or `high` are specified values in `cpu_shares` will be - ignored. Default: `normal` + The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + shares. Can be one of low, normal, high, or custom. """ return pulumi.get(self, "cpu_share_level") @@ -1021,9 +773,8 @@ def cpu_share_level(self) -> pulumi.Output[Optional[str]]: @pulumi.getter(name="cpuShares") def cpu_shares(self) -> pulumi.Output[int]: """ - The number of shares allocated for CPU. Used to - determine resource allocation in case of resource contention. If this is set, - `cpu_share_level` must be `custom`. + The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + cpu_share_level must be custom. """ return pulumi.get(self, "cpu_shares") @@ -1039,9 +790,8 @@ def custom_attributes(self) -> pulumi.Output[Optional[Mapping[str, str]]]: @pulumi.getter(name="memoryExpandable") def memory_expandable(self) -> pulumi.Output[Optional[bool]]: """ - Determines if the reservation on a resource - pool can grow beyond the specified value if the parent resource pool has - unreserved resources. Default: `true` + Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has + unreserved resources. """ return pulumi.get(self, "memory_expandable") @@ -1049,9 +799,8 @@ def memory_expandable(self) -> pulumi.Output[Optional[bool]]: @pulumi.getter(name="memoryLimit") def memory_limit(self) -> pulumi.Output[Optional[int]]: """ - The CPU utilization of a resource pool will not - exceed this limit, even if there are available resources. Set to `-1` for - unlimited. Default: `-1` + The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for + unlimited. """ return pulumi.get(self, "memory_limit") @@ -1059,8 +808,7 @@ def memory_limit(self) -> pulumi.Output[Optional[int]]: @pulumi.getter(name="memoryReservation") def memory_reservation(self) -> pulumi.Output[Optional[int]]: """ - Amount of CPU (MHz) that is guaranteed - available to the resource pool. Default: `0` + Amount of memory (MB) that is guaranteed available to the resource pool. """ return pulumi.get(self, "memory_reservation") @@ -1068,11 +816,8 @@ def memory_reservation(self) -> pulumi.Output[Optional[int]]: @pulumi.getter(name="memoryShareLevel") def memory_share_level(self) -> pulumi.Output[Optional[str]]: """ - The CPU allocation level. The level is a - simplified view of shares. Levels map to a pre-determined set of numeric - values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When - `low`, `normal`, or `high` are specified values in `memory_shares` will be - ignored. Default: `normal` + The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for + shares. Can be one of low, normal, high, or custom. """ return pulumi.get(self, "memory_share_level") @@ -1080,9 +825,8 @@ def memory_share_level(self) -> pulumi.Output[Optional[str]]: @pulumi.getter(name="memoryShares") def memory_shares(self) -> pulumi.Output[int]: """ - The number of shares allocated for CPU. Used to - determine resource allocation in case of resource contention. If this is set, - `memory_share_level` must be `custom`. + The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set, + memory_share_level must be custom. """ return pulumi.get(self, "memory_shares") @@ -1090,7 +834,7 @@ def memory_shares(self) -> pulumi.Output[int]: @pulumi.getter def name(self) -> pulumi.Output[str]: """ - The name of the resource pool. + Name of resource pool. """ return pulumi.get(self, "name") @@ -1098,11 +842,7 @@ def name(self) -> pulumi.Output[str]: @pulumi.getter(name="parentResourcePoolId") def parent_resource_pool_id(self) -> pulumi.Output[str]: """ - The managed object ID - of the parent resource pool. This can be the root resource pool for a cluster - or standalone host, or a resource pool itself. When moving a resource pool - from one parent resource pool to another, both must share a common root - resource pool. + The ID of the root resource pool of the compute resource the resource pool is in. """ return pulumi.get(self, "parent_resource_pool_id") @@ -1110,10 +850,8 @@ def parent_resource_pool_id(self) -> pulumi.Output[str]: @pulumi.getter(name="scaleDescendantsShares") def scale_descendants_shares(self) -> pulumi.Output[Optional[str]]: """ - Determines if the shares of all - descendants of the resource pool are scaled up or down when the shares - of the resource pool are scaled up or down. Can be one of `disabled` or - `scaleCpuAndMemoryShares`. Default: `disabled`. + Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource + pool are scaled up or down. """ return pulumi.get(self, "scale_descendants_shares") @@ -1121,7 +859,7 @@ def scale_descendants_shares(self) -> pulumi.Output[Optional[str]]: @pulumi.getter def tags(self) -> pulumi.Output[Optional[Sequence[str]]]: """ - The IDs of any tags to attach to this resource. + A list of tag IDs to apply to this object. """ return pulumi.get(self, "tags") diff --git a/sdk/python/pulumi_vsphere/virtual_machine.py b/sdk/python/pulumi_vsphere/virtual_machine.py index 0592798c..ec2098b6 100644 --- a/sdk/python/pulumi_vsphere/virtual_machine.py +++ b/sdk/python/pulumi_vsphere/virtual_machine.py @@ -2726,7 +2726,7 @@ def __init__(__self__, The following requirements apply to import: - * The disks must have a [`label`](#label) argument assigned in a convention matching `diskN`, starting with disk number 0, based on each virtual disk order on the SCSI bus. As an example, a disk on SCSI controller `0` with a unit number of `0` would be labeled as `disk0`, a disk on the same controller with a unit number of `1` would be `disk1`, but the next disk, which is on SCSI controller `1` with a unit number of `0`, still becomes `disk2`. + * The disks must have a [`label`](#label) argument assigned in a convention matching `Hard Disk`, starting with disk number 0, based on each virtual disk order on the SCSI bus. As an example, a disk on SCSI controller `0` with a unit number of `0` would be labeled as `Hard Disk 0`, a disk on the same controller with a unit number of `1` would be `Hard Disk 1`, but the next disk, which is on SCSI controller `1` with a unit number of `0`, still becomes `Hard Disk 2`. * Disks are always imported with [`keep_on_remove`](#keep_on_remove) enabled until the first `pulumi up` run which will remove the setting for known disks. This process safeguards against naming or accounting mistakes in the disk configuration. @@ -2847,7 +2847,7 @@ def __init__(__self__, The following requirements apply to import: - * The disks must have a [`label`](#label) argument assigned in a convention matching `diskN`, starting with disk number 0, based on each virtual disk order on the SCSI bus. As an example, a disk on SCSI controller `0` with a unit number of `0` would be labeled as `disk0`, a disk on the same controller with a unit number of `1` would be `disk1`, but the next disk, which is on SCSI controller `1` with a unit number of `0`, still becomes `disk2`. + * The disks must have a [`label`](#label) argument assigned in a convention matching `Hard Disk`, starting with disk number 0, based on each virtual disk order on the SCSI bus. As an example, a disk on SCSI controller `0` with a unit number of `0` would be labeled as `Hard Disk 0`, a disk on the same controller with a unit number of `1` would be `Hard Disk 1`, but the next disk, which is on SCSI controller `1` with a unit number of `0`, still becomes `Hard Disk 2`. * Disks are always imported with [`keep_on_remove`](#keep_on_remove) enabled until the first `pulumi up` run which will remove the setting for known disks. This process safeguards against naming or accounting mistakes in the disk configuration. diff --git a/upstream b/upstream index 23dcfba4..adf67147 160000 --- a/upstream +++ b/upstream @@ -1 +1 @@ -Subproject commit 23dcfba408a5f7899d1b7cdb29d3845bafa2c247 +Subproject commit adf6714755bbdce45f9c947966d89549de52aeff