pulumi-digitalocean 4.27.0__py3-none-any.whl → 4.39.0a1736833057__py3-none-any.whl

pulumi_digitalocean/get_floating_ip.py

@@ -4,9 +4,14 @@
 
 import copy
 import warnings
+import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from . import _utilities
 
 __all__ = [
@@ -105,7 +110,6 @@ def get_floating_ip(ip_address: Optional[str] = None,
 
     Get the floating IP:
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_digitalocean as digitalocean
@@ -115,7 +119,6 @@ def get_floating_ip(ip_address: Optional[str] = None,
     example = digitalocean.get_floating_ip(ip_address=public_ip)
     pulumi.export("fipOutput", example.droplet_id)
     ```
-    <!--End PulumiCodeChooser -->
 
 
     :param str ip_address: The allocated IP address of the specific floating IP to retrieve.
@@ -131,11 +134,8 @@ def get_floating_ip(ip_address: Optional[str] = None,
         id=pulumi.get(__ret__, 'id'),
         ip_address=pulumi.get(__ret__, 'ip_address'),
         region=pulumi.get(__ret__, 'region'))
-
-
-@_utilities.lift_output_func(get_floating_ip)
 def get_floating_ip_output(ip_address: Optional[pulumi.Input[str]] = None,
-                           opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetFloatingIpResult]:
+                           opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetFloatingIpResult]:
     """
     > **Deprecated:** DigitalOcean Floating IPs have been renamed reserved IPs. This data source will be removed in a future release. Please use `ReservedIp` instead.
 
@@ -150,7 +150,6 @@ def get_floating_ip_output(ip_address: Optional[pulumi.Input[str]] = None,
 
     Get the floating IP:
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_digitalocean as digitalocean
@@ -160,9 +159,17 @@ def get_floating_ip_output(ip_address: Optional[pulumi.Input[str]] = None,
     example = digitalocean.get_floating_ip(ip_address=public_ip)
     pulumi.export("fipOutput", example.droplet_id)
     ```
-    <!--End PulumiCodeChooser -->
 
 
     :param str ip_address: The allocated IP address of the specific floating IP to retrieve.
     """
-    ...
+    __args__ = dict()
+    __args__['ipAddress'] = ip_address
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('digitalocean:index/getFloatingIp:getFloatingIp', __args__, opts=opts, typ=GetFloatingIpResult)
+    return __ret__.apply(lambda __response__: GetFloatingIpResult(
+        droplet_id=pulumi.get(__response__, 'droplet_id'),
+        floating_ip_urn=pulumi.get(__response__, 'floating_ip_urn'),
+        id=pulumi.get(__response__, 'id'),
+        ip_address=pulumi.get(__response__, 'ip_address'),
+        region=pulumi.get(__response__, 'region')))

pulumi_digitalocean/get_image.py

@@ -4,9 +4,14 @@
 
 import copy
 import warnings
+import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from . import _utilities
 
 __all__ = [
@@ -237,40 +242,35 @@ def get_image(id: Optional[int] = None,
 
     Get the data about a snapshot:
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_digitalocean as digitalocean
 
     example1 = digitalocean.get_image(name="example-1.0.0")
     ```
-    <!--End PulumiCodeChooser -->
 
     Reuse the data about a snapshot to create a Droplet:
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_digitalocean as digitalocean
 
-    example_image = digitalocean.get_image(name="example-1.0.0")
-    example_droplet = digitalocean.Droplet("exampleDroplet",
-        image=example_image.id,
-        region="nyc2",
-        size="s-1vcpu-1gb")
+    example = digitalocean.get_image(name="example-1.0.0")
+    example_droplet = digitalocean.Droplet("example",
+        image=example.id,
+        name="example-1",
+        region=digitalocean.Region.NYC2,
+        size=digitalocean.DropletSlug.DROPLET_S1_VCPU1_GB)
     ```
-    <!--End PulumiCodeChooser -->
 
     Get the data about an official image:
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_digitalocean as digitalocean
 
     example2 = digitalocean.get_image(slug="ubuntu-18-04-x64")
     ```
-    <!--End PulumiCodeChooser -->
 
 
     :param int id: The id of the image
@@ -305,14 +305,11 @@ def get_image(id: Optional[int] = None,
         status=pulumi.get(__ret__, 'status'),
         tags=pulumi.get(__ret__, 'tags'),
         type=pulumi.get(__ret__, 'type'))
-
-
-@_utilities.lift_output_func(get_image)
 def get_image_output(id: Optional[pulumi.Input[Optional[int]]] = None,
                      name: Optional[pulumi.Input[Optional[str]]] = None,
                      slug: Optional[pulumi.Input[Optional[str]]] = None,
                      source: Optional[pulumi.Input[Optional[str]]] = None,
-                     opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetImageResult]:
+                     opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetImageResult]:
     """
     Get information on an image for use in other resources (e.g. creating a Droplet
     based on snapshot). This data source provides all of the image properties as
@@ -325,40 +322,35 @@ def get_image_output(id: Optional[pulumi.Input[Optional[int]]] = None,
 
     Get the data about a snapshot:
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_digitalocean as digitalocean
 
     example1 = digitalocean.get_image(name="example-1.0.0")
     ```
-    <!--End PulumiCodeChooser -->
 
     Reuse the data about a snapshot to create a Droplet:
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_digitalocean as digitalocean
 
-    example_image = digitalocean.get_image(name="example-1.0.0")
-    example_droplet = digitalocean.Droplet("exampleDroplet",
-        image=example_image.id,
-        region="nyc2",
-        size="s-1vcpu-1gb")
+    example = digitalocean.get_image(name="example-1.0.0")
+    example_droplet = digitalocean.Droplet("example",
+        image=example.id,
+        name="example-1",
+        region=digitalocean.Region.NYC2,
+        size=digitalocean.DropletSlug.DROPLET_S1_VCPU1_GB)
     ```
-    <!--End PulumiCodeChooser -->
 
     Get the data about an official image:
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_digitalocean as digitalocean
 
     example2 = digitalocean.get_image(slug="ubuntu-18-04-x64")
     ```
-    <!--End PulumiCodeChooser -->
 
 
     :param int id: The id of the image
@@ -368,4 +360,27 @@ def get_image_output(id: Optional[pulumi.Input[Optional[int]]] = None,
            If `name` is specified, you may also specify:
     :param str source: Restrict the search to one of the following categories of images:
     """
-    ...
+    __args__ = dict()
+    __args__['id'] = id
+    __args__['name'] = name
+    __args__['slug'] = slug
+    __args__['source'] = source
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('digitalocean:index/getImage:getImage', __args__, opts=opts, typ=GetImageResult)
+    return __ret__.apply(lambda __response__: GetImageResult(
+        created=pulumi.get(__response__, 'created'),
+        description=pulumi.get(__response__, 'description'),
+        distribution=pulumi.get(__response__, 'distribution'),
+        error_message=pulumi.get(__response__, 'error_message'),
+        id=pulumi.get(__response__, 'id'),
+        image=pulumi.get(__response__, 'image'),
+        min_disk_size=pulumi.get(__response__, 'min_disk_size'),
+        name=pulumi.get(__response__, 'name'),
+        private=pulumi.get(__response__, 'private'),
+        regions=pulumi.get(__response__, 'regions'),
+        size_gigabytes=pulumi.get(__response__, 'size_gigabytes'),
+        slug=pulumi.get(__response__, 'slug'),
+        source=pulumi.get(__response__, 'source'),
+        status=pulumi.get(__response__, 'status'),
+        tags=pulumi.get(__response__, 'tags'),
+        type=pulumi.get(__response__, 'type')))

pulumi_digitalocean/get_images.py

@@ -4,9 +4,14 @@
 
 import copy
 import warnings
+import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from . import _utilities
 from . import outputs
 from ._inputs import *
@@ -76,8 +81,8 @@ class AwaitableGetImagesResult(GetImagesResult):
             sorts=self.sorts)
 
 
-def get_images(filters: Optional[Sequence[pulumi.InputType['GetImagesFilterArgs']]] = None,
-               sorts: Optional[Sequence[pulumi.InputType['GetImagesSortArgs']]] = None,
+def get_images(filters: Optional[Sequence[Union['GetImagesFilterArgs', 'GetImagesFilterArgsDict']]] = None,
+               sorts: Optional[Sequence[Union['GetImagesSortArgs', 'GetImagesSortArgsDict']]] = None,
                opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetImagesResult:
     """
     Get information on images for use in other resources (e.g. creating a Droplet
@@ -96,46 +101,42 @@ def get_images(filters: Optional[Sequence[pulumi.InputType['GetImagesFilterArgs'
 
     For example to find all Ubuntu images:
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_digitalocean as digitalocean
 
-    ubuntu = digitalocean.get_images(filters=[digitalocean.GetImagesFilterArgs(
-        key="distribution",
-        values=["Ubuntu"],
-    )])
+    ubuntu = digitalocean.get_images(filters=[{
+        "key": "distribution",
+        "values": ["Ubuntu"],
+    }])
     ```
-    <!--End PulumiCodeChooser -->
 
     You can filter on multiple fields and sort the results as well:
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_digitalocean as digitalocean
 
     available = digitalocean.get_images(filters=[
-            digitalocean.GetImagesFilterArgs(
-                key="distribution",
-                values=["Ubuntu"],
-            ),
-            digitalocean.GetImagesFilterArgs(
-                key="regions",
-                values=["nyc3"],
-            ),
+            {
+                "key": "distribution",
+                "values": ["Ubuntu"],
+            },
+            {
+                "key": "regions",
+                "values": ["nyc3"],
+            },
         ],
-        sorts=[digitalocean.GetImagesSortArgs(
-            direction="desc",
-            key="created",
-        )])
+        sorts=[{
+            "key": "created",
+            "direction": "desc",
+        }])
     ```
-    <!--End PulumiCodeChooser -->
 
 
-    :param Sequence[pulumi.InputType['GetImagesFilterArgs']] filters: Filter the results.
+    :param Sequence[Union['GetImagesFilterArgs', 'GetImagesFilterArgsDict']] filters: Filter the results.
            The `filter` block is documented below.
-    :param Sequence[pulumi.InputType['GetImagesSortArgs']] sorts: Sort the results.
+    :param Sequence[Union['GetImagesSortArgs', 'GetImagesSortArgsDict']] sorts: Sort the results.
            The `sort` block is documented below.
     """
     __args__ = dict()
@@ -149,12 +150,9 @@ def get_images(filters: Optional[Sequence[pulumi.InputType['GetImagesFilterArgs'
         id=pulumi.get(__ret__, 'id'),
         images=pulumi.get(__ret__, 'images'),
         sorts=pulumi.get(__ret__, 'sorts'))
-
-
-@_utilities.lift_output_func(get_images)
-def get_images_output(filters: Optional[pulumi.Input[Optional[Sequence[pulumi.InputType['GetImagesFilterArgs']]]]] = None,
-                      sorts: Optional[pulumi.Input[Optional[Sequence[pulumi.InputType['GetImagesSortArgs']]]]] = None,
-                      opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetImagesResult]:
+def get_images_output(filters: Optional[pulumi.Input[Optional[Sequence[Union['GetImagesFilterArgs', 'GetImagesFilterArgsDict']]]]] = None,
+                      sorts: Optional[pulumi.Input[Optional[Sequence[Union['GetImagesSortArgs', 'GetImagesSortArgsDict']]]]] = None,
+                      opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetImagesResult]:
     """
     Get information on images for use in other resources (e.g. creating a Droplet
     based on a snapshot), with the ability to filter and sort the results. If no filters are specified,
@@ -172,46 +170,51 @@ def get_images_output(filters: Optional[pulumi.Input[Optional[Sequence[pulumi.In
 
     For example to find all Ubuntu images:
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_digitalocean as digitalocean
 
-    ubuntu = digitalocean.get_images(filters=[digitalocean.GetImagesFilterArgs(
-        key="distribution",
-        values=["Ubuntu"],
-    )])
+    ubuntu = digitalocean.get_images(filters=[{
+        "key": "distribution",
+        "values": ["Ubuntu"],
+    }])
     ```
-    <!--End PulumiCodeChooser -->
 
     You can filter on multiple fields and sort the results as well:
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_digitalocean as digitalocean
 
     available = digitalocean.get_images(filters=[
-            digitalocean.GetImagesFilterArgs(
-                key="distribution",
-                values=["Ubuntu"],
-            ),
-            digitalocean.GetImagesFilterArgs(
-                key="regions",
-                values=["nyc3"],
-            ),
+            {
+                "key": "distribution",
+                "values": ["Ubuntu"],
+            },
+            {
+                "key": "regions",
+                "values": ["nyc3"],
+            },
         ],
-        sorts=[digitalocean.GetImagesSortArgs(
-            direction="desc",
-            key="created",
-        )])
+        sorts=[{
+            "key": "created",
+            "direction": "desc",
+        }])
     ```
-    <!--End PulumiCodeChooser -->
 
 
-    :param Sequence[pulumi.InputType['GetImagesFilterArgs']] filters: Filter the results.
+    :param Sequence[Union['GetImagesFilterArgs', 'GetImagesFilterArgsDict']] filters: Filter the results.
            The `filter` block is documented below.
-    :param Sequence[pulumi.InputType['GetImagesSortArgs']] sorts: Sort the results.
+    :param Sequence[Union['GetImagesSortArgs', 'GetImagesSortArgsDict']] sorts: Sort the results.
            The `sort` block is documented below.
     """
-    ...
+    __args__ = dict()
+    __args__['filters'] = filters
+    __args__['sorts'] = sorts
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('digitalocean:index/getImages:getImages', __args__, opts=opts, typ=GetImagesResult)
+    return __ret__.apply(lambda __response__: GetImagesResult(
+        filters=pulumi.get(__response__, 'filters'),
+        id=pulumi.get(__response__, 'id'),
+        images=pulumi.get(__response__, 'images'),
+        sorts=pulumi.get(__response__, 'sorts')))

pulumi_digitalocean/get_kubernetes_cluster.py

@@ -4,9 +4,14 @@
 
 import copy
 import warnings
+import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from . import _utilities
 from . import outputs
 
@@ -89,7 +94,6 @@ class GetKubernetesClusterResult:
     def auto_upgrade(self) -> bool:
         """
         A boolean value indicating whether the cluster will be automatically upgraded to new patch releases during its maintenance window.
-        * `kube_config.0` - A representation of the Kubernetes cluster's kubeconfig with the following attributes:
         """
         return pulumi.get(self, "auto_upgrade")
 
@@ -141,6 +145,9 @@ class GetKubernetesClusterResult:
     @property
     @pulumi.getter(name="kubeConfigs")
     def kube_configs(self) -> Sequence['outputs.GetKubernetesClusterKubeConfigResult']:
+        """
+        A representation of the Kubernetes cluster's kubeconfig with the following attributes:
+        """
         return pulumi.get(self, "kube_configs")
 
     @property
@@ -271,6 +278,15 @@ def get_kubernetes_cluster(name: Optional[str] = None,
     """
     Retrieves information about a DigitalOcean Kubernetes cluster for use in other resources. This data source provides all of the cluster's properties as configured on your DigitalOcean account. This is useful if the cluster in question is not managed by the provider.
 
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_digitalocean as digitalocean
+
+    example = digitalocean.get_kubernetes_cluster(name="prod-cluster-01")
+    ```
+
 
     :param str name: The name of Kubernetes cluster.
     :param Sequence[str] tags: A list of tag names applied to the node pool.
@@ -302,17 +318,48 @@ def get_kubernetes_cluster(name: Optional[str] = None,
         urn=pulumi.get(__ret__, 'urn'),
         version=pulumi.get(__ret__, 'version'),
         vpc_uuid=pulumi.get(__ret__, 'vpc_uuid'))
-
-
-@_utilities.lift_output_func(get_kubernetes_cluster)
 def get_kubernetes_cluster_output(name: Optional[pulumi.Input[str]] = None,
                                   tags: Optional[pulumi.Input[Optional[Sequence[str]]]] = None,
-                                  opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetKubernetesClusterResult]:
+                                  opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetKubernetesClusterResult]:
     """
     Retrieves information about a DigitalOcean Kubernetes cluster for use in other resources. This data source provides all of the cluster's properties as configured on your DigitalOcean account. This is useful if the cluster in question is not managed by the provider.
 
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_digitalocean as digitalocean
+
+    example = digitalocean.get_kubernetes_cluster(name="prod-cluster-01")
+    ```
+
 
     :param str name: The name of Kubernetes cluster.
     :param Sequence[str] tags: A list of tag names applied to the node pool.
     """
-    ...
+    __args__ = dict()
+    __args__['name'] = name
+    __args__['tags'] = tags
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('digitalocean:index/getKubernetesCluster:getKubernetesCluster', __args__, opts=opts, typ=GetKubernetesClusterResult)
+    return __ret__.apply(lambda __response__: GetKubernetesClusterResult(
+        auto_upgrade=pulumi.get(__response__, 'auto_upgrade'),
+        cluster_subnet=pulumi.get(__response__, 'cluster_subnet'),
+        created_at=pulumi.get(__response__, 'created_at'),
+        endpoint=pulumi.get(__response__, 'endpoint'),
+        ha=pulumi.get(__response__, 'ha'),
+        id=pulumi.get(__response__, 'id'),
+        ipv4_address=pulumi.get(__response__, 'ipv4_address'),
+        kube_configs=pulumi.get(__response__, 'kube_configs'),
+        maintenance_policies=pulumi.get(__response__, 'maintenance_policies'),
+        name=pulumi.get(__response__, 'name'),
+        node_pools=pulumi.get(__response__, 'node_pools'),
+        region=pulumi.get(__response__, 'region'),
+        service_subnet=pulumi.get(__response__, 'service_subnet'),
+        status=pulumi.get(__response__, 'status'),
+        surge_upgrade=pulumi.get(__response__, 'surge_upgrade'),
+        tags=pulumi.get(__response__, 'tags'),
+        updated_at=pulumi.get(__response__, 'updated_at'),
+        urn=pulumi.get(__response__, 'urn'),
+        version=pulumi.get(__response__, 'version'),
+        vpc_uuid=pulumi.get(__response__, 'vpc_uuid')))