pulumi-vsphere 4.12.0a1727221820__py3-none-any.whl → 4.12.0a1727889180__py3-none-any.whl

pulumi_vsphere/compute_cluster_vm_group.py

@@ -188,7 +188,85 @@ class ComputeClusterVmGroup(pulumi.CustomResource):
                  virtual_machine_ids: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                  __props__=None):
         """
-        Create a ComputeClusterVmGroup resource with the given unique name, props, and options.
+        The `ComputeClusterVmGroup` resource can be used to manage groups of
+        virtual machines in a cluster, either created by the
+        [`ComputeCluster`][tf-vsphere-cluster-resource] resource or looked up
+        by the [`ComputeCluster`][tf-vsphere-cluster-data-source] data source.
+
+        [tf-vsphere-cluster-resource]: /docs/providers/vsphere/r/compute_cluster.html
+        [tf-vsphere-cluster-data-source]: /docs/providers/vsphere/d/compute_cluster.html
+
+        This resource mainly serves as an input to the
+        [`ComputeClusterVmDependencyRule`][tf-vsphere-cluster-vm-dependency-rule-resource]
+        and
+        [`ComputeClusterVmHostRule`][tf-vsphere-cluster-vm-host-rule-resource]
+        resources. See the individual resource documentation pages for more information.
+
+        [tf-vsphere-cluster-vm-dependency-rule-resource]: /docs/providers/vsphere/r/compute_cluster_vm_dependency_rule.html
+        [tf-vsphere-cluster-vm-host-rule-resource]: /docs/providers/vsphere/r/compute_cluster_vm_host_rule.html
+
+        > **NOTE:** This resource requires vCenter and is not available on direct ESXi
+        connections.
+
+        ## Example Usage
+
+        The example below creates two virtual machines in a cluster using the
+        `VirtualMachine` resource, creating the
+        virtual machine in the cluster looked up by the
+        `ComputeCluster` data source. It
+        then creates a group from these two virtual machines.
+
+        ```python
+        import pulumi
+        import pulumi_vsphere as vsphere
+
+        datacenter = vsphere.get_datacenter(name="dc-01")
+        datastore = vsphere.get_datastore(name="datastore1",
+            datacenter_id=datacenter.id)
+        cluster = vsphere.get_compute_cluster(name="cluster-01",
+            datacenter_id=datacenter.id)
+        network = vsphere.get_network(name="network1",
+            datacenter_id=datacenter.id)
+        vm = []
+        for range in [{"value": i} for i in range(0, 2)]:
+            vm.append(vsphere.VirtualMachine(f"vm-{range['value']}",
+                name=f"test-{range['value']}",
+                resource_pool_id=cluster.resource_pool_id,
+                datastore_id=datastore.id,
+                num_cpus=2,
+                memory=2048,
+                guest_id="otherLinux64Guest",
+                network_interfaces=[{
+                    "network_id": network.id,
+                }],
+                disks=[{
+                    "label": "disk0",
+                    "size": 20,
+                }]))
+        cluster_vm_group = vsphere.ComputeClusterVmGroup("cluster_vm_group",
+            name="test-cluster-vm-group",
+            compute_cluster_id=cluster.id,
+            virtual_machine_ids=[[__item.id for __item in vm]])
+        ```
+
+        ## Import
+
+        An existing group can be imported into this resource by
+
+        supplying both the path to the cluster, and the name of the VM group. If the
+
+        name or cluster is not found, or if the group is of a different type, an error
+
+        will be returned. An example is below:
+
+        ```sh
+        $ pulumi import vsphere:index/computeClusterVmGroup:ComputeClusterVmGroup cluster_vm_group \\
+        ```
+
+          '{"compute_cluster_path": "/dc1/host/cluster1", \\
+
+          "name": "pulumi-test-cluster-vm-group"}'
+
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[str] compute_cluster_id: The managed object reference
@@ -216,7 +294,85 @@ class ComputeClusterVmGroup(pulumi.CustomResource):
                  args: ComputeClusterVmGroupArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        Create a ComputeClusterVmGroup resource with the given unique name, props, and options.
+        The `ComputeClusterVmGroup` resource can be used to manage groups of
+        virtual machines in a cluster, either created by the
+        [`ComputeCluster`][tf-vsphere-cluster-resource] resource or looked up
+        by the [`ComputeCluster`][tf-vsphere-cluster-data-source] data source.
+
+        [tf-vsphere-cluster-resource]: /docs/providers/vsphere/r/compute_cluster.html
+        [tf-vsphere-cluster-data-source]: /docs/providers/vsphere/d/compute_cluster.html
+
+        This resource mainly serves as an input to the
+        [`ComputeClusterVmDependencyRule`][tf-vsphere-cluster-vm-dependency-rule-resource]
+        and
+        [`ComputeClusterVmHostRule`][tf-vsphere-cluster-vm-host-rule-resource]
+        resources. See the individual resource documentation pages for more information.
+
+        [tf-vsphere-cluster-vm-dependency-rule-resource]: /docs/providers/vsphere/r/compute_cluster_vm_dependency_rule.html
+        [tf-vsphere-cluster-vm-host-rule-resource]: /docs/providers/vsphere/r/compute_cluster_vm_host_rule.html
+
+        > **NOTE:** This resource requires vCenter and is not available on direct ESXi
+        connections.
+
+        ## Example Usage
+
+        The example below creates two virtual machines in a cluster using the
+        `VirtualMachine` resource, creating the
+        virtual machine in the cluster looked up by the
+        `ComputeCluster` data source. It
+        then creates a group from these two virtual machines.
+
+        ```python
+        import pulumi
+        import pulumi_vsphere as vsphere
+
+        datacenter = vsphere.get_datacenter(name="dc-01")
+        datastore = vsphere.get_datastore(name="datastore1",
+            datacenter_id=datacenter.id)
+        cluster = vsphere.get_compute_cluster(name="cluster-01",
+            datacenter_id=datacenter.id)
+        network = vsphere.get_network(name="network1",
+            datacenter_id=datacenter.id)
+        vm = []
+        for range in [{"value": i} for i in range(0, 2)]:
+            vm.append(vsphere.VirtualMachine(f"vm-{range['value']}",
+                name=f"test-{range['value']}",
+                resource_pool_id=cluster.resource_pool_id,
+                datastore_id=datastore.id,
+                num_cpus=2,
+                memory=2048,
+                guest_id="otherLinux64Guest",
+                network_interfaces=[{
+                    "network_id": network.id,
+                }],
+                disks=[{
+                    "label": "disk0",
+                    "size": 20,
+                }]))
+        cluster_vm_group = vsphere.ComputeClusterVmGroup("cluster_vm_group",
+            name="test-cluster-vm-group",
+            compute_cluster_id=cluster.id,
+            virtual_machine_ids=[[__item.id for __item in vm]])
+        ```
+
+        ## Import
+
+        An existing group can be imported into this resource by
+
+        supplying both the path to the cluster, and the name of the VM group. If the
+
+        name or cluster is not found, or if the group is of a different type, an error
+
+        will be returned. An example is below:
+
+        ```sh
+        $ pulumi import vsphere:index/computeClusterVmGroup:ComputeClusterVmGroup cluster_vm_group \\
+        ```
+
+          '{"compute_cluster_path": "/dc1/host/cluster1", \\
+
+          "name": "pulumi-test-cluster-vm-group"}'
+
         :param str resource_name: The name of the resource.
         :param ComputeClusterVmGroupArgs args: The arguments to use to populate this resource's properties.
         :param pulumi.ResourceOptions opts: Options for the resource.

pulumi_vsphere/compute_cluster_vm_host_rule.py

@@ -331,7 +331,40 @@ class ComputeClusterVmHostRule(pulumi.CustomResource):
                  vm_group_name: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
-        Create a ComputeClusterVmHostRule resource with the given unique name, props, and options.
+        The `ComputeClusterVmHostRule` resource can be used to manage
+        VM-to-host rules in a cluster, either created by the
+        `ComputeCluster` resource or looked up
+        by the `ComputeCluster` data source.
+
+        This resource can create both _affinity rules_, where virtual machines run on
+        specified hosts, or _anti-affinity_ rules, where virtual machines run on hosts
+        outside of the ones specified in the rule. Virtual machines and hosts are
+        supplied via groups, which can be managed via the
+        `ComputeClusterVmGroup` and
+        `ComputeClusterHostGroup`
+        resources.
+
+        > **NOTE:** This resource requires vCenter and is not available on direct ESXi
+        connections.
+
+        ## Import
+
+        An existing rule can be imported into this resource by supplying
+
+        both the path to the cluster, and the name the rule. If the name or cluster is
+
+        not found, or if the rule is of a different type, an error will be returned. An
+
+        example is below:
+
+        ```sh
+        $ pulumi import vsphere:index/computeClusterVmHostRule:ComputeClusterVmHostRule cluster_vm_host_rule \\
+        ```
+
+          '{"compute_cluster_path": "/dc1/host/cluster1", \\
+
+          "name": "pulumi-test-cluster-vm-host-rule"}'
+
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[str] affinity_host_group_name: When this field is used, the virtual
@@ -366,7 +399,40 @@ class ComputeClusterVmHostRule(pulumi.CustomResource):
                  args: ComputeClusterVmHostRuleArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        Create a ComputeClusterVmHostRule resource with the given unique name, props, and options.
+        The `ComputeClusterVmHostRule` resource can be used to manage
+        VM-to-host rules in a cluster, either created by the
+        `ComputeCluster` resource or looked up
+        by the `ComputeCluster` data source.
+
+        This resource can create both _affinity rules_, where virtual machines run on
+        specified hosts, or _anti-affinity_ rules, where virtual machines run on hosts
+        outside of the ones specified in the rule. Virtual machines and hosts are
+        supplied via groups, which can be managed via the
+        `ComputeClusterVmGroup` and
+        `ComputeClusterHostGroup`
+        resources.
+
+        > **NOTE:** This resource requires vCenter and is not available on direct ESXi
+        connections.
+
+        ## Import
+
+        An existing rule can be imported into this resource by supplying
+
+        both the path to the cluster, and the name the rule. If the name or cluster is
+
+        not found, or if the rule is of a different type, an error will be returned. An
+
+        example is below:
+
+        ```sh
+        $ pulumi import vsphere:index/computeClusterVmHostRule:ComputeClusterVmHostRule cluster_vm_host_rule \\
+        ```
+
+          '{"compute_cluster_path": "/dc1/host/cluster1", \\
+
+          "name": "pulumi-test-cluster-vm-host-rule"}'
+
         :param str resource_name: The name of the resource.
         :param ComputeClusterVmHostRuleArgs args: The arguments to use to populate this resource's properties.
         :param pulumi.ResourceOptions opts: Options for the resource.

pulumi_vsphere/content_library.py

@@ -200,7 +200,55 @@ class ContentLibrary(pulumi.CustomResource):
                  subscription: Optional[pulumi.Input[Union['ContentLibrarySubscriptionArgs', 'ContentLibrarySubscriptionArgsDict']]] = None,
                  __props__=None):
         """
-        Create a ContentLibrary resource with the given unique name, props, and options.
+        The `ContentLibrary` resource can be used to manage content libraries.
+
+        > **NOTE:** This resource requires a vCenter Server instance and is not available on direct ESXi host connections.
+
+        ## Example Usage
+
+        The following example creates a publishing content library using the datastore named `publisher-datastore` as the storage backing.
+
+        ```python
+        import pulumi
+        import pulumi_vsphere as vsphere
+
+        datacenter_a = vsphere.get_datacenter(name="dc-01-a")
+        publisher_datastore = vsphere.get_datastore(name="publisher-datastore",
+            datacenter_id=datacenter_a.id)
+        publisher_content_library = vsphere.ContentLibrary("publisher_content_library",
+            name="Publisher Content Library",
+            description="A publishing content library.",
+            storage_backings=[publisher_datastore.id])
+        ```
+
+        The next example creates a subscribed content library using the URL of the publisher content library as the source and the datastore named `subscriber-datastore` as the storage backing.
+
+        ```python
+        import pulumi
+        import pulumi_vsphere as vsphere
+
+        datacenter_b = vsphere.get_datacenter(name="dc-01-b")
+        subscriber_datastore = vsphere.get_datastore(name="subscriber-datastore",
+            datacenter_id=datacenter_b.id)
+        subscriber_content_library = vsphere.ContentLibrary("subscriber_content_library",
+            name="Subscriber Content Library",
+            description="A subscribing content library.",
+            storage_backings=[subscriber_datastore.id],
+            subscription={
+                "subscription_url": "https://vc-01-a.example.com:443/cls/vcsp/lib/f42a4b25-844a-44ec-9063-a3a5e9cc88c7/lib.json",
+                "automatic_sync": True,
+                "on_demand": False,
+            })
+        ```
+
+        ## Import
+
+        An existing content library can be imported into this resource by supplying the content library ID. For example:
+
+        ```sh
+        $ pulumi import vsphere:index/contentLibrary:ContentLibrary vsphere_content_library publisher_content_library f42a4b25-844a-44ec-9063-a3a5e9cc88c7
+        ```
+
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[str] description: A description for the content library.
@@ -216,7 +264,55 @@ class ContentLibrary(pulumi.CustomResource):
                  args: ContentLibraryArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        Create a ContentLibrary resource with the given unique name, props, and options.
+        The `ContentLibrary` resource can be used to manage content libraries.
+
+        > **NOTE:** This resource requires a vCenter Server instance and is not available on direct ESXi host connections.
+
+        ## Example Usage
+
+        The following example creates a publishing content library using the datastore named `publisher-datastore` as the storage backing.
+
+        ```python
+        import pulumi
+        import pulumi_vsphere as vsphere
+
+        datacenter_a = vsphere.get_datacenter(name="dc-01-a")
+        publisher_datastore = vsphere.get_datastore(name="publisher-datastore",
+            datacenter_id=datacenter_a.id)
+        publisher_content_library = vsphere.ContentLibrary("publisher_content_library",
+            name="Publisher Content Library",
+            description="A publishing content library.",
+            storage_backings=[publisher_datastore.id])
+        ```
+
+        The next example creates a subscribed content library using the URL of the publisher content library as the source and the datastore named `subscriber-datastore` as the storage backing.
+
+        ```python
+        import pulumi
+        import pulumi_vsphere as vsphere
+
+        datacenter_b = vsphere.get_datacenter(name="dc-01-b")
+        subscriber_datastore = vsphere.get_datastore(name="subscriber-datastore",
+            datacenter_id=datacenter_b.id)
+        subscriber_content_library = vsphere.ContentLibrary("subscriber_content_library",
+            name="Subscriber Content Library",
+            description="A subscribing content library.",
+            storage_backings=[subscriber_datastore.id],
+            subscription={
+                "subscription_url": "https://vc-01-a.example.com:443/cls/vcsp/lib/f42a4b25-844a-44ec-9063-a3a5e9cc88c7/lib.json",
+                "automatic_sync": True,
+                "on_demand": False,
+            })
+        ```
+
+        ## Import
+
+        An existing content library can be imported into this resource by supplying the content library ID. For example:
+
+        ```sh
+        $ pulumi import vsphere:index/contentLibrary:ContentLibrary vsphere_content_library publisher_content_library f42a4b25-844a-44ec-9063-a3a5e9cc88c7
+        ```
+
         :param str resource_name: The name of the resource.
         :param ContentLibraryArgs args: The arguments to use to populate this resource's properties.
         :param pulumi.ResourceOptions opts: Options for the resource.

pulumi_vsphere/content_library_item.py

@@ -235,7 +235,75 @@ class ContentLibraryItem(pulumi.CustomResource):
                  type: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
-        Create a ContentLibraryItem resource with the given unique name, props, and options.
+        The `ContentLibraryItem` resource can be used to create items in a
+        vSphere content library. The `file_url` must be accessible from the vSphere
+        environment as it will be downloaded from the specified location and stored
+        on the content library's storage backing.
+
+        ## Example Usage
+
+        The first example below imports an OVF Template to a content
+        library.
+
+        ```python
+        import pulumi
+        import pulumi_vsphere as vsphere
+
+        datacenter = vsphere.get_datacenter(name="dc-01")
+        content_library = vsphere.get_content_library(name="clb-01")
+        content_library_item = vsphere.ContentLibraryItem("content_library_item",
+            name="ovf-linux-ubuntu-server-lts",
+            description="Ubuntu Server LTS OVF Template",
+            file_url="https://releases.example.com/ubuntu/ubuntu/ubuntu-live-server-amd64.ovf",
+            library_id=content_library.id)
+        ```
+
+        The next example imports an .iso image to a content library.
+
+        [tf-vsphere-vm-resource]: /docs/providers/vsphere/r/virtual_machine.html
+
+        ```python
+        import pulumi
+        import pulumi_vsphere as vsphere
+
+        datacenter = vsphere.get_datacenter(name="dc-01")
+        content_library = vsphere.get_content_library(name="clb-01")
+        content_library_item = vsphere.ContentLibraryItem("content_library_item",
+            name="iso-linux-ubuntu-server-lts",
+            description="Ubuntu Server LTS .iso",
+            type="iso",
+            file_url="https://releases.example.com/ubuntu/ubuntu-live-server-amd64.iso",
+            library_id=content_library.id)
+        ```
+
+        The last example imports a virtual machine image to a content library from an
+        existing virtual machine.
+
+        [tf-vsphere-vm-resource]: /docs/providers/vsphere/r/virtual_machine.html
+
+        ```python
+        import pulumi
+        import pulumi_vsphere as vsphere
+
+        datacenter = vsphere.get_datacenter(name="dc-01")
+        content_library = vsphere.get_content_library(name="clb-01")
+        content_library_item = vsphere.ContentLibraryItem("content_library_item",
+            name="tpl-linux-ubuntu-server-lts",
+            description="Ubuntu Server LTS",
+            source_uuid="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
+            library_id=content_library.id)
+        ```
+
+        ## Import
+
+        An existing content library item can be imported into this resource by
+
+        supplying the content library ID. An example is below:
+
+        ```sh
+        $ pulumi import vsphere:index/contentLibraryItem:ContentLibraryItem vsphere_content_library_item iso-linux-ubuntu-server-lts xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+        ```
+
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[str] description: A description for the content library item.
@@ -253,7 +321,75 @@ class ContentLibraryItem(pulumi.CustomResource):
                  args: ContentLibraryItemArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        Create a ContentLibraryItem resource with the given unique name, props, and options.
+        The `ContentLibraryItem` resource can be used to create items in a
+        vSphere content library. The `file_url` must be accessible from the vSphere
+        environment as it will be downloaded from the specified location and stored
+        on the content library's storage backing.
+
+        ## Example Usage
+
+        The first example below imports an OVF Template to a content
+        library.
+
+        ```python
+        import pulumi
+        import pulumi_vsphere as vsphere
+
+        datacenter = vsphere.get_datacenter(name="dc-01")
+        content_library = vsphere.get_content_library(name="clb-01")
+        content_library_item = vsphere.ContentLibraryItem("content_library_item",
+            name="ovf-linux-ubuntu-server-lts",
+            description="Ubuntu Server LTS OVF Template",
+            file_url="https://releases.example.com/ubuntu/ubuntu/ubuntu-live-server-amd64.ovf",
+            library_id=content_library.id)
+        ```
+
+        The next example imports an .iso image to a content library.
+
+        [tf-vsphere-vm-resource]: /docs/providers/vsphere/r/virtual_machine.html
+
+        ```python
+        import pulumi
+        import pulumi_vsphere as vsphere
+
+        datacenter = vsphere.get_datacenter(name="dc-01")
+        content_library = vsphere.get_content_library(name="clb-01")
+        content_library_item = vsphere.ContentLibraryItem("content_library_item",
+            name="iso-linux-ubuntu-server-lts",
+            description="Ubuntu Server LTS .iso",
+            type="iso",
+            file_url="https://releases.example.com/ubuntu/ubuntu-live-server-amd64.iso",
+            library_id=content_library.id)
+        ```
+
+        The last example imports a virtual machine image to a content library from an
+        existing virtual machine.
+
+        [tf-vsphere-vm-resource]: /docs/providers/vsphere/r/virtual_machine.html
+
+        ```python
+        import pulumi
+        import pulumi_vsphere as vsphere
+
+        datacenter = vsphere.get_datacenter(name="dc-01")
+        content_library = vsphere.get_content_library(name="clb-01")
+        content_library_item = vsphere.ContentLibraryItem("content_library_item",
+            name="tpl-linux-ubuntu-server-lts",
+            description="Ubuntu Server LTS",
+            source_uuid="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
+            library_id=content_library.id)
+        ```
+
+        ## Import
+
+        An existing content library item can be imported into this resource by
+
+        supplying the content library ID. An example is below:
+
+        ```sh
+        $ pulumi import vsphere:index/contentLibraryItem:ContentLibraryItem vsphere_content_library_item iso-linux-ubuntu-server-lts xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+        ```
+
         :param str resource_name: The name of the resource.
         :param ContentLibraryItemArgs args: The arguments to use to populate this resource's properties.
         :param pulumi.ResourceOptions opts: Options for the resource.

pulumi_vsphere/custom_attribute.py

@@ -108,7 +108,42 @@ class CustomAttribute(pulumi.CustomResource):
                  name: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
-        Create a CustomAttribute resource with the given unique name, props, and options.
+        The `CustomAttribute` resource can be used to create and manage custom
+        attributes, which allow users to associate user-specific meta-information with
+        vSphere managed objects. Custom attribute values must be strings and are stored
+        on the vCenter Server and not the managed object.
+
+        For more information about custom attributes, click [here][ext-custom-attributes].
+
+        [ext-custom-attributes]: https://docs.vmware.com/en/VMware-vSphere/8.0/vsphere-vcenter-esxi-management/GUID-73606C4C-763C-4E27-A1DA-032E4C46219D.html
+
+        > **NOTE:** Custom attributes are unsupported on direct ESXi host connections
+        and require vCenter Server.
+
+        ## Example Usage
+
+        This example creates a custom attribute named `test-attribute`. The
+        resulting custom attribute can be assigned to VMs only.
+
+        ```python
+        import pulumi
+        import pulumi_vsphere as vsphere
+
+        attribute = vsphere.CustomAttribute("attribute",
+            name="test-attribute",
+            managed_object_type="VirtualMachine")
+        ```
+
+        ## Import
+
+        An existing custom attribute can be imported into this resource
+
+        via its name, using the following command:
+
+        ```sh
+        $ pulumi import vsphere:index/customAttribute:CustomAttribute attribute terraform-test-attribute
+        ```
+
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[str] managed_object_type: The object type that this attribute may be
@@ -123,7 +158,42 @@ class CustomAttribute(pulumi.CustomResource):
                  args: Optional[CustomAttributeArgs] = None,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        Create a CustomAttribute resource with the given unique name, props, and options.
+        The `CustomAttribute` resource can be used to create and manage custom
+        attributes, which allow users to associate user-specific meta-information with
+        vSphere managed objects. Custom attribute values must be strings and are stored
+        on the vCenter Server and not the managed object.
+
+        For more information about custom attributes, click [here][ext-custom-attributes].
+
+        [ext-custom-attributes]: https://docs.vmware.com/en/VMware-vSphere/8.0/vsphere-vcenter-esxi-management/GUID-73606C4C-763C-4E27-A1DA-032E4C46219D.html
+
+        > **NOTE:** Custom attributes are unsupported on direct ESXi host connections
+        and require vCenter Server.
+
+        ## Example Usage
+
+        This example creates a custom attribute named `test-attribute`. The
+        resulting custom attribute can be assigned to VMs only.
+
+        ```python
+        import pulumi
+        import pulumi_vsphere as vsphere
+
+        attribute = vsphere.CustomAttribute("attribute",
+            name="test-attribute",
+            managed_object_type="VirtualMachine")
+        ```
+
+        ## Import
+
+        An existing custom attribute can be imported into this resource
+
+        via its name, using the following command:
+
+        ```sh
+        $ pulumi import vsphere:index/customAttribute:CustomAttribute attribute terraform-test-attribute
+        ```
+
         :param str resource_name: The name of the resource.
         :param CustomAttributeArgs args: The arguments to use to populate this resource's properties.
         :param pulumi.ResourceOptions opts: Options for the resource.

pulumi_vsphere/datacenter.py

@@ -247,13 +247,18 @@ class Datacenter(pulumi.CustomResource):
             folder="/research/")
         ```
 
-        ## Importing
+        ## Import
+
+        An existing datacenter can be imported into this resource
 
-        An existing datacenter can be [imported][docs-import] into this resource
         via supplying the full path to the datacenter. An example is below:
 
         [docs-import]: /docs/import/index.html
 
+        ```sh
+        $ pulumi import vsphere:index/datacenter:Datacenter dc /dc1
+        ```
+
         The above would import the datacenter named `dc1`.
 
         :param str resource_name: The name of the resource.
@@ -305,13 +310,18 @@ class Datacenter(pulumi.CustomResource):
             folder="/research/")
         ```
 
-        ## Importing
+        ## Import
+
+        An existing datacenter can be imported into this resource
 
-        An existing datacenter can be [imported][docs-import] into this resource
         via supplying the full path to the datacenter. An example is below:
 
         [docs-import]: /docs/import/index.html
 
+        ```sh
+        $ pulumi import vsphere:index/datacenter:Datacenter dc /dc1
+        ```
+
         The above would import the datacenter named `dc1`.
 
         :param str resource_name: The name of the resource.