pulumi-hcloud 1.18.0a1710156455__py3-none-any.whl → 1.22.0a1736849475__py3-none-any.whl

pulumi_hcloud/get_server_types.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
 
@@ -41,42 +46,33 @@ class GetServerTypesResult:
 
     @property
     @pulumi.getter
+    @_utilities.deprecated("""Use server_types list instead""")
     def descriptions(self) -> Sequence[str]:
-        warnings.warn("""Use server_types list instead""", DeprecationWarning)
-        pulumi.log.warn("""descriptions is deprecated: Use server_types list instead""")
-
         return pulumi.get(self, "descriptions")
 
     @property
     @pulumi.getter
     def id(self) -> str:
         """
-        The provider-assigned unique ID for this managed resource.
+        The ID of this resource.
         """
         return pulumi.get(self, "id")
 
     @property
     @pulumi.getter
+    @_utilities.deprecated("""Use server_types list instead""")
     def names(self) -> Sequence[str]:
-        warnings.warn("""Use server_types list instead""", DeprecationWarning)
-        pulumi.log.warn("""names is deprecated: Use server_types list instead""")
-
         return pulumi.get(self, "names")
 
     @property
     @pulumi.getter(name="serverTypeIds")
-    def server_type_ids(self) -> Optional[Sequence[str]]:
-        warnings.warn("""Use server_types list instead""", DeprecationWarning)
-        pulumi.log.warn("""server_type_ids is deprecated: Use server_types list instead""")
-
+    @_utilities.deprecated("""Use server_types list instead""")
+    def server_type_ids(self) -> Sequence[str]:
         return pulumi.get(self, "server_type_ids")
 
     @property
     @pulumi.getter(name="serverTypes")
     def server_types(self) -> Sequence['outputs.GetServerTypesServerTypeResult']:
-        """
-        (list) List of all server types. See `data.hcloud_type` for schema.
-        """
         return pulumi.get(self, "server_types")
 
 
@@ -93,13 +89,20 @@ class AwaitableGetServerTypesResult(GetServerTypesResult):
             server_types=self.server_types)
 
 
-def get_server_types(server_type_ids: Optional[Sequence[str]] = None,
-                     opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetServerTypesResult:
+def get_server_types(opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetServerTypesResult:
     """
     Provides a list of available Hetzner Cloud Server Types.
+
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_hcloud as hcloud
+
+    all = hcloud.get_server_types()
+    ```
     """
     __args__ = dict()
-    __args__['serverTypeIds'] = server_type_ids
     opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
     __ret__ = pulumi.runtime.invoke('hcloud:index/getServerTypes:getServerTypes', __args__, opts=opts, typ=GetServerTypesResult).value
 
@@ -109,12 +112,25 @@ def get_server_types(server_type_ids: Optional[Sequence[str]] = None,
         names=pulumi.get(__ret__, 'names'),
         server_type_ids=pulumi.get(__ret__, 'server_type_ids'),
         server_types=pulumi.get(__ret__, 'server_types'))
-
-
-@_utilities.lift_output_func(get_server_types)
-def get_server_types_output(server_type_ids: Optional[pulumi.Input[Optional[Sequence[str]]]] = None,
-                            opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetServerTypesResult]:
+def get_server_types_output(opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetServerTypesResult]:
     """
     Provides a list of available Hetzner Cloud Server Types.
+
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_hcloud as hcloud
+
+    all = hcloud.get_server_types()
+    ```
     """
-    ...
+    __args__ = dict()
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('hcloud:index/getServerTypes:getServerTypes', __args__, opts=opts, typ=GetServerTypesResult)
+    return __ret__.apply(lambda __response__: GetServerTypesResult(
+        descriptions=pulumi.get(__response__, 'descriptions'),
+        id=pulumi.get(__response__, 'id'),
+        names=pulumi.get(__response__, 'names'),
+        server_type_ids=pulumi.get(__response__, 'server_type_ids'),
+        server_types=pulumi.get(__response__, 'server_types')))

pulumi_hcloud/get_servers.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
 
@@ -81,14 +86,12 @@ def get_servers(with_selector: Optional[str] = None,
     """
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_hcloud as hcloud
 
     s3 = hcloud.get_servers(with_selector="key=value")
     ```
-    <!--End PulumiCodeChooser -->
 
 
     :param str with_selector: Label Selector. For more information about possible values, visit the [Hetzner Cloud Documentation](https://docs.hetzner.cloud/#overview-label-selector).
@@ -105,26 +108,30 @@ def get_servers(with_selector: Optional[str] = None,
         servers=pulumi.get(__ret__, 'servers'),
         with_selector=pulumi.get(__ret__, 'with_selector'),
         with_statuses=pulumi.get(__ret__, 'with_statuses'))
-
-
-@_utilities.lift_output_func(get_servers)
 def get_servers_output(with_selector: Optional[pulumi.Input[Optional[str]]] = None,
                        with_statuses: Optional[pulumi.Input[Optional[Sequence[str]]]] = None,
-                       opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetServersResult]:
+                       opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetServersResult]:
     """
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_hcloud as hcloud
 
     s3 = hcloud.get_servers(with_selector="key=value")
     ```
-    <!--End PulumiCodeChooser -->
 
 
     :param str with_selector: Label Selector. For more information about possible values, visit the [Hetzner Cloud Documentation](https://docs.hetzner.cloud/#overview-label-selector).
     :param Sequence[str] with_statuses: List only servers with the specified status, could contain `initializing`, `starting`, `running`, `stopping`, `off`, `deleting`, `rebuilding`, `migrating`, `unknown`.
     """
-    ...
+    __args__ = dict()
+    __args__['withSelector'] = with_selector
+    __args__['withStatuses'] = with_statuses
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('hcloud:index/getServers:getServers', __args__, opts=opts, typ=GetServersResult)
+    return __ret__.apply(lambda __response__: GetServersResult(
+        id=pulumi.get(__response__, 'id'),
+        servers=pulumi.get(__response__, 'servers'),
+        with_selector=pulumi.get(__response__, 'with_selector'),
+        with_statuses=pulumi.get(__response__, 'with_statuses')))

pulumi_hcloud/get_ssh_key.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__ = [
@@ -46,30 +51,33 @@ class GetSshKeyResult:
 
     @property
     @pulumi.getter
-    def fingerprint(self) -> str:
+    def fingerprint(self) -> Optional[str]:
         """
-        (string) Fingerprint of the SSH Key.
+        Fingerprint of the SSH Key.
         """
         return pulumi.get(self, "fingerprint")
 
     @property
     @pulumi.getter
-    def id(self) -> int:
+    def id(self) -> Optional[int]:
         """
-        (int) Unique ID of the SSH Key.
+        ID of the SSH Key.
         """
         return pulumi.get(self, "id")
 
     @property
     @pulumi.getter
-    def labels(self) -> Mapping[str, Any]:
+    def labels(self) -> Mapping[str, str]:
+        """
+        User-defined [labels](https://docs.hetzner.cloud/#labels) (key-value pairs) for the resource.
+        """
         return pulumi.get(self, "labels")
 
     @property
     @pulumi.getter
-    def name(self) -> str:
+    def name(self) -> Optional[str]:
         """
-        (string) Name of the SSH Key.
+        Name of the SSH Key.
         """
         return pulumi.get(self, "name")
 
@@ -77,21 +85,25 @@ class GetSshKeyResult:
     @pulumi.getter(name="publicKey")
     def public_key(self) -> str:
         """
-        (string) Public Key of the SSH Key.
+        Public key of the SSH Key pair.
         """
         return pulumi.get(self, "public_key")
 
     @property
     @pulumi.getter
+    @_utilities.deprecated("""Please use the with_selector property instead.""")
     def selector(self) -> Optional[str]:
-        warnings.warn("""Please use the with_selector property instead.""", DeprecationWarning)
-        pulumi.log.warn("""selector is deprecated: Please use the with_selector property instead.""")
-
+        """
+        Filter results using a [Label Selector](https://docs.hetzner.cloud/#label-selector).
+        """
         return pulumi.get(self, "selector")
 
     @property
     @pulumi.getter(name="withSelector")
     def with_selector(self) -> Optional[str]:
+        """
+        Filter results using a [Label Selector](https://docs.hetzner.cloud/#label-selector).
+        """
         return pulumi.get(self, "with_selector")
 
 
@@ -119,28 +131,27 @@ def get_ssh_key(fingerprint: Optional[str] = None,
     """
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_hcloud as hcloud
 
-    ssh_key1 = hcloud.get_ssh_key(id=1234)
-    ssh_key2 = hcloud.get_ssh_key(name="my-ssh-key")
-    ssh_key3 = hcloud.get_ssh_key(fingerprint="43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8")
-    ssh_key4 = hcloud.get_ssh_key(with_selector="key=value")
+    by_id = hcloud.get_ssh_key(id=24332897)
+    by_name = hcloud.get_ssh_key(name="my-ssh-key")
+    by_fingerprint = hcloud.get_ssh_key(fingerprint="55:58:dc:bd:61:6e:7d:24:07:a7:7d:9b:be:99:83:a8")
+    by_label = hcloud.get_ssh_key(with_selector="key=value")
     main = hcloud.Server("main", ssh_keys=[
-        ssh_key1.id,
-        ssh_key2.id,
-        ssh_key3.id,
+        by_id.id,
+        by_name.id,
+        by_fingerprint.id,
     ])
     ```
-    <!--End PulumiCodeChooser -->
 
 
     :param str fingerprint: Fingerprint of the SSH Key.
     :param int id: ID of the SSH Key.
     :param str name: Name of the SSH Key.
-    :param str with_selector: [Label selector](https://docs.hetzner.cloud/#overview-label-selector)
+    :param str selector: Filter results using a [Label Selector](https://docs.hetzner.cloud/#label-selector).
+    :param str with_selector: Filter results using a [Label Selector](https://docs.hetzner.cloud/#label-selector).
     """
     __args__ = dict()
     __args__['fingerprint'] = fingerprint
@@ -159,39 +170,50 @@ def get_ssh_key(fingerprint: Optional[str] = None,
         public_key=pulumi.get(__ret__, 'public_key'),
         selector=pulumi.get(__ret__, 'selector'),
         with_selector=pulumi.get(__ret__, 'with_selector'))
-
-
-@_utilities.lift_output_func(get_ssh_key)
 def get_ssh_key_output(fingerprint: Optional[pulumi.Input[Optional[str]]] = None,
                        id: Optional[pulumi.Input[Optional[int]]] = None,
                        name: Optional[pulumi.Input[Optional[str]]] = None,
                        selector: Optional[pulumi.Input[Optional[str]]] = None,
                        with_selector: Optional[pulumi.Input[Optional[str]]] = None,
-                       opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetSshKeyResult]:
+                       opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetSshKeyResult]:
     """
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_hcloud as hcloud
 
-    ssh_key1 = hcloud.get_ssh_key(id=1234)
-    ssh_key2 = hcloud.get_ssh_key(name="my-ssh-key")
-    ssh_key3 = hcloud.get_ssh_key(fingerprint="43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8")
-    ssh_key4 = hcloud.get_ssh_key(with_selector="key=value")
+    by_id = hcloud.get_ssh_key(id=24332897)
+    by_name = hcloud.get_ssh_key(name="my-ssh-key")
+    by_fingerprint = hcloud.get_ssh_key(fingerprint="55:58:dc:bd:61:6e:7d:24:07:a7:7d:9b:be:99:83:a8")
+    by_label = hcloud.get_ssh_key(with_selector="key=value")
     main = hcloud.Server("main", ssh_keys=[
-        ssh_key1.id,
-        ssh_key2.id,
-        ssh_key3.id,
+        by_id.id,
+        by_name.id,
+        by_fingerprint.id,
     ])
     ```
-    <!--End PulumiCodeChooser -->
 
 
     :param str fingerprint: Fingerprint of the SSH Key.
     :param int id: ID of the SSH Key.
     :param str name: Name of the SSH Key.
-    :param str with_selector: [Label selector](https://docs.hetzner.cloud/#overview-label-selector)
+    :param str selector: Filter results using a [Label Selector](https://docs.hetzner.cloud/#label-selector).
+    :param str with_selector: Filter results using a [Label Selector](https://docs.hetzner.cloud/#label-selector).
     """
-    ...
+    __args__ = dict()
+    __args__['fingerprint'] = fingerprint
+    __args__['id'] = id
+    __args__['name'] = name
+    __args__['selector'] = selector
+    __args__['withSelector'] = with_selector
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('hcloud:index/getSshKey:getSshKey', __args__, opts=opts, typ=GetSshKeyResult)
+    return __ret__.apply(lambda __response__: GetSshKeyResult(
+        fingerprint=pulumi.get(__response__, 'fingerprint'),
+        id=pulumi.get(__response__, 'id'),
+        labels=pulumi.get(__response__, 'labels'),
+        name=pulumi.get(__response__, 'name'),
+        public_key=pulumi.get(__response__, 'public_key'),
+        selector=pulumi.get(__response__, 'selector'),
+        with_selector=pulumi.get(__response__, 'with_selector')))

pulumi_hcloud/get_ssh_keys.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
 
@@ -35,23 +40,23 @@ class GetSshKeysResult:
 
     @property
     @pulumi.getter
-    def id(self) -> str:
+    def id(self) -> Optional[str]:
         """
-        The provider-assigned unique ID for this managed resource.
+        The ID of this resource.
         """
         return pulumi.get(self, "id")
 
     @property
     @pulumi.getter(name="sshKeys")
     def ssh_keys(self) -> Sequence['outputs.GetSshKeysSshKeyResult']:
-        """
-        (list) List of all matches SSH keys. See `data.hcloud_ssh_key` for schema.
-        """
         return pulumi.get(self, "ssh_keys")
 
     @property
     @pulumi.getter(name="withSelector")
     def with_selector(self) -> Optional[str]:
+        """
+        Filter results using a [Label Selector](https://docs.hetzner.cloud/#label-selector)
+        """
         return pulumi.get(self, "with_selector")
 
 
@@ -66,26 +71,27 @@ class AwaitableGetSshKeysResult(GetSshKeysResult):
             with_selector=self.with_selector)
 
 
-def get_ssh_keys(with_selector: Optional[str] = None,
+def get_ssh_keys(id: Optional[str] = None,
+                 with_selector: Optional[str] = None,
                  opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetSshKeysResult:
     """
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_hcloud as hcloud
 
-    all_keys = hcloud.get_ssh_keys()
-    keys_by_selector = hcloud.get_ssh_keys(with_selector="foo=bar")
-    main = hcloud.Server("main", ssh_keys=[__item.name for __item in all_keys.ssh_keys])
+    all = hcloud.get_ssh_keys()
+    by_label = hcloud.get_ssh_keys(with_selector="foo=bar")
+    main = hcloud.Server("main", ssh_keys=[__item.name for __item in all.ssh_keys])
     ```
-    <!--End PulumiCodeChooser -->
 
 
-    :param str with_selector: [Label selector](https://docs.hetzner.cloud/#overview-label-selector)
+    :param str id: The ID of this resource.
+    :param str with_selector: Filter results using a [Label Selector](https://docs.hetzner.cloud/#label-selector)
     """
     __args__ = dict()
+    __args__['id'] = id
     __args__['withSelector'] = with_selector
     opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
     __ret__ = pulumi.runtime.invoke('hcloud:index/getSshKeys:getSshKeys', __args__, opts=opts, typ=GetSshKeysResult).value
@@ -94,26 +100,31 @@ def get_ssh_keys(with_selector: Optional[str] = None,
         id=pulumi.get(__ret__, 'id'),
         ssh_keys=pulumi.get(__ret__, 'ssh_keys'),
         with_selector=pulumi.get(__ret__, 'with_selector'))
-
-
-@_utilities.lift_output_func(get_ssh_keys)
-def get_ssh_keys_output(with_selector: Optional[pulumi.Input[Optional[str]]] = None,
-                        opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetSshKeysResult]:
+def get_ssh_keys_output(id: Optional[pulumi.Input[Optional[str]]] = None,
+                        with_selector: Optional[pulumi.Input[Optional[str]]] = None,
+                        opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetSshKeysResult]:
     """
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_hcloud as hcloud
 
-    all_keys = hcloud.get_ssh_keys()
-    keys_by_selector = hcloud.get_ssh_keys(with_selector="foo=bar")
-    main = hcloud.Server("main", ssh_keys=[__item.name for __item in all_keys.ssh_keys])
+    all = hcloud.get_ssh_keys()
+    by_label = hcloud.get_ssh_keys(with_selector="foo=bar")
+    main = hcloud.Server("main", ssh_keys=[__item.name for __item in all.ssh_keys])
     ```
-    <!--End PulumiCodeChooser -->
 
 
-    :param str with_selector: [Label selector](https://docs.hetzner.cloud/#overview-label-selector)
+    :param str id: The ID of this resource.
+    :param str with_selector: Filter results using a [Label Selector](https://docs.hetzner.cloud/#label-selector)
     """
-    ...
+    __args__ = dict()
+    __args__['id'] = id
+    __args__['withSelector'] = with_selector
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('hcloud:index/getSshKeys:getSshKeys', __args__, opts=opts, typ=GetSshKeysResult)
+    return __ret__.apply(lambda __response__: GetSshKeysResult(
+        id=pulumi.get(__response__, 'id'),
+        ssh_keys=pulumi.get(__response__, 'ssh_keys'),
+        with_selector=pulumi.get(__response__, 'with_selector')))

pulumi_hcloud/get_volume.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__ = [
@@ -74,7 +79,7 @@ class GetVolumeResult:
 
     @property
     @pulumi.getter
-    def labels(self) -> Mapping[str, Any]:
+    def labels(self) -> Mapping[str, str]:
         """
         (map) User-defined labels (key-value pairs).
         """
@@ -92,7 +97,7 @@ class GetVolumeResult:
     @pulumi.getter
     def location(self) -> Optional[str]:
         """
-        (string) The location name.
+        (string) The location name. See the [Hetzner Docs](https://docs.hetzner.com/cloud/general/locations/#what-locations-are-there) for more details about locations.
         """
         return pulumi.get(self, "location")
 
@@ -106,10 +111,8 @@ class GetVolumeResult:
 
     @property
     @pulumi.getter
+    @_utilities.deprecated("""Please use the with_selector property instead.""")
     def selector(self) -> Optional[str]:
-        warnings.warn("""Please use the with_selector property instead.""", DeprecationWarning)
-        pulumi.log.warn("""selector is deprecated: Please use the with_selector property instead.""")
-
         return pulumi.get(self, "selector")
 
     @property
@@ -169,7 +172,6 @@ def get_volume(id: Optional[int] = None,
     """
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_hcloud as hcloud
@@ -178,11 +180,10 @@ def get_volume(id: Optional[int] = None,
     volume2 = hcloud.get_volume(name="my-volume")
     volume3 = hcloud.get_volume(with_selector="key=value")
     ```
-    <!--End PulumiCodeChooser -->
 
 
     :param int id: ID of the volume.
-    :param str location: (string) The location name.
+    :param str location: (string) The location name. See the [Hetzner Docs](https://docs.hetzner.com/cloud/general/locations/#what-locations-are-there) for more details about locations.
     :param str name: Name of the volume.
     :param int server_id: (Optional, int) Server ID the volume is attached to
     :param str with_selector: Label Selector. For more information about possible values, visit the [Hetzner Cloud Documentation](https://docs.hetzner.cloud/#overview-label-selector).
@@ -211,9 +212,6 @@ def get_volume(id: Optional[int] = None,
         size=pulumi.get(__ret__, 'size'),
         with_selector=pulumi.get(__ret__, 'with_selector'),
         with_statuses=pulumi.get(__ret__, 'with_statuses'))
-
-
-@_utilities.lift_output_func(get_volume)
 def get_volume_output(id: Optional[pulumi.Input[Optional[int]]] = None,
                       location: Optional[pulumi.Input[Optional[str]]] = None,
                       name: Optional[pulumi.Input[Optional[str]]] = None,
@@ -221,11 +219,10 @@ def get_volume_output(id: Optional[pulumi.Input[Optional[int]]] = None,
                       server_id: Optional[pulumi.Input[Optional[int]]] = None,
                       with_selector: Optional[pulumi.Input[Optional[str]]] = None,
                       with_statuses: Optional[pulumi.Input[Optional[Sequence[str]]]] = None,
-                      opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetVolumeResult]:
+                      opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetVolumeResult]:
     """
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_hcloud as hcloud
@@ -234,14 +231,34 @@ def get_volume_output(id: Optional[pulumi.Input[Optional[int]]] = None,
     volume2 = hcloud.get_volume(name="my-volume")
     volume3 = hcloud.get_volume(with_selector="key=value")
     ```
-    <!--End PulumiCodeChooser -->
 
 
     :param int id: ID of the volume.
-    :param str location: (string) The location name.
+    :param str location: (string) The location name. See the [Hetzner Docs](https://docs.hetzner.com/cloud/general/locations/#what-locations-are-there) for more details about locations.
     :param str name: Name of the volume.
     :param int server_id: (Optional, int) Server ID the volume is attached to
     :param str with_selector: Label Selector. For more information about possible values, visit the [Hetzner Cloud Documentation](https://docs.hetzner.cloud/#overview-label-selector).
     :param Sequence[str] with_statuses: List only volumes with the specified status, could contain `creating` or `available`.
     """
-    ...
+    __args__ = dict()
+    __args__['id'] = id
+    __args__['location'] = location
+    __args__['name'] = name
+    __args__['selector'] = selector
+    __args__['serverId'] = server_id
+    __args__['withSelector'] = with_selector
+    __args__['withStatuses'] = with_statuses
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('hcloud:index/getVolume:getVolume', __args__, opts=opts, typ=GetVolumeResult)
+    return __ret__.apply(lambda __response__: GetVolumeResult(
+        delete_protection=pulumi.get(__response__, 'delete_protection'),
+        id=pulumi.get(__response__, 'id'),
+        labels=pulumi.get(__response__, 'labels'),
+        linux_device=pulumi.get(__response__, 'linux_device'),
+        location=pulumi.get(__response__, 'location'),
+        name=pulumi.get(__response__, 'name'),
+        selector=pulumi.get(__response__, 'selector'),
+        server_id=pulumi.get(__response__, 'server_id'),
+        size=pulumi.get(__response__, 'size'),
+        with_selector=pulumi.get(__response__, 'with_selector'),
+        with_statuses=pulumi.get(__response__, 'with_statuses')))