pulumi-digitalocean 4.40.0a1739511652__py3-none-any.whl → 4.56.0a1766428645__py3-none-any.whl

pulumi_digitalocean/get_account.py

@@ -1,8 +1,8 @@
 # coding=utf-8
-# *** WARNING: this file was generated by the Pulumi Terraform Bridge (tfgen) Tool. ***
+# *** WARNING: this file was generated by pulumi-language-python. ***
 # *** Do not edit by hand unless you're certain you know what you are doing! ***
 
-import copy
+import builtins as _builtins
 import warnings
 import sys
 import pulumi
@@ -52,65 +52,65 @@ class GetAccountResult:
             raise TypeError("Expected argument 'uuid' to be a str")
         pulumi.set(__self__, "uuid", uuid)
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="dropletLimit")
-    def droplet_limit(self) -> int:
+    def droplet_limit(self) -> _builtins.int:
         """
         The total number of droplets current user or team may have active at one time.
         """
         return pulumi.get(self, "droplet_limit")
 
-    @property
+    @_builtins.property
     @pulumi.getter
-    def email(self) -> str:
+    def email(self) -> _builtins.str:
         """
         The email address used by the current user to register for DigitalOcean.
         """
         return pulumi.get(self, "email")
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="emailVerified")
-    def email_verified(self) -> bool:
+    def email_verified(self) -> _builtins.bool:
         """
         If true, the user has verified their account via email. False otherwise.
         """
         return pulumi.get(self, "email_verified")
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="floatingIpLimit")
-    def floating_ip_limit(self) -> int:
+    def floating_ip_limit(self) -> _builtins.int:
         """
         The total number of floating IPs the current user or team may have.
         """
         return pulumi.get(self, "floating_ip_limit")
 
-    @property
+    @_builtins.property
     @pulumi.getter
-    def id(self) -> str:
+    def id(self) -> _builtins.str:
         """
         The provider-assigned unique ID for this managed resource.
         """
         return pulumi.get(self, "id")
 
-    @property
+    @_builtins.property
     @pulumi.getter
-    def status(self) -> str:
+    def status(self) -> _builtins.str:
         """
         This value is one of "active", "warning" or "locked".
         """
         return pulumi.get(self, "status")
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="statusMessage")
-    def status_message(self) -> str:
+    def status_message(self) -> _builtins.str:
         """
         A human-readable message giving more details about the status of the account.
         """
         return pulumi.get(self, "status_message")
 
-    @property
+    @_builtins.property
     @pulumi.getter
-    def uuid(self) -> str:
+    def uuid(self) -> _builtins.str:
         """
         The unique universal identifier for the current user.
         """

pulumi_digitalocean/get_app.py

@@ -1,8 +1,8 @@
 # coding=utf-8
-# *** WARNING: this file was generated by the Pulumi Terraform Bridge (tfgen) Tool. ***
+# *** WARNING: this file was generated by pulumi-language-python. ***
 # *** Do not edit by hand unless you're certain you know what you are doing! ***
 
-import copy
+import builtins as _builtins
 import warnings
 import sys
 import pulumi
@@ -66,28 +66,28 @@ class GetAppResult:
             raise TypeError("Expected argument 'urn' to be a str")
         pulumi.set(__self__, "urn", urn)
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="activeDeploymentId")
-    def active_deployment_id(self) -> str:
+    def active_deployment_id(self) -> _builtins.str:
         """
         The ID the app's currently active deployment.
         """
         return pulumi.get(self, "active_deployment_id")
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="appId")
-    def app_id(self) -> str:
+    def app_id(self) -> _builtins.str:
         return pulumi.get(self, "app_id")
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="createdAt")
-    def created_at(self) -> str:
+    def created_at(self) -> _builtins.str:
         """
         The date and time of when the app was created.
         """
         return pulumi.get(self, "created_at")
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="dedicatedIps")
     def dedicated_ips(self) -> Sequence['outputs.GetAppDedicatedIpResult']:
         """
@@ -95,47 +95,47 @@ class GetAppResult:
         """
         return pulumi.get(self, "dedicated_ips")
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="defaultIngress")
-    def default_ingress(self) -> str:
+    def default_ingress(self) -> _builtins.str:
         """
         The default URL to access the app.
         """
         return pulumi.get(self, "default_ingress")
 
-    @property
+    @_builtins.property
     @pulumi.getter
-    def id(self) -> str:
+    def id(self) -> _builtins.str:
         """
         The provider-assigned unique ID for this managed resource.
         """
         return pulumi.get(self, "id")
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="liveDomain")
-    def live_domain(self) -> str:
+    def live_domain(self) -> _builtins.str:
         """
         The live domain of the app.
         """
         return pulumi.get(self, "live_domain")
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="liveUrl")
-    def live_url(self) -> str:
+    def live_url(self) -> _builtins.str:
         """
         The live URL of the app.
         """
         return pulumi.get(self, "live_url")
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="projectId")
-    def project_id(self) -> str:
+    def project_id(self) -> _builtins.str:
         """
         The ID of the project that the app is assigned to.
         """
         return pulumi.get(self, "project_id")
 
-    @property
+    @_builtins.property
     @pulumi.getter
     def specs(self) -> Sequence['outputs.GetAppSpecResult']:
         """
@@ -143,17 +143,17 @@ class GetAppResult:
         """
         return pulumi.get(self, "specs")
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="updatedAt")
-    def updated_at(self) -> str:
+    def updated_at(self) -> _builtins.str:
         """
         The date and time of when the app was last updated.
         """
         return pulumi.get(self, "updated_at")
 
-    @property
+    @_builtins.property
     @pulumi.getter
-    def urn(self) -> str:
+    def urn(self) -> _builtins.str:
         """
         The uniform resource identifier for the app.
         """
@@ -180,7 +180,7 @@ class AwaitableGetAppResult(GetAppResult):
             urn=self.urn)
 
 
-def get_app(app_id: Optional[str] = None,
+def get_app(app_id: Optional[_builtins.str] = None,
             dedicated_ips: Optional[Sequence[Union['GetAppDedicatedIpArgs', 'GetAppDedicatedIpArgsDict']]] = None,
             opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetAppResult:
     """
@@ -199,7 +199,7 @@ def get_app(app_id: Optional[str] = None,
     ```
 
 
-    :param str app_id: The ID of the app to retrieve information about.
+    :param _builtins.str app_id: The ID of the app to retrieve information about.
     :param Sequence[Union['GetAppDedicatedIpArgs', 'GetAppDedicatedIpArgsDict']] dedicated_ips: A list of dedicated egress IP addresses associated with the app.
     """
     __args__ = dict()
@@ -221,7 +221,7 @@ def get_app(app_id: Optional[str] = None,
         specs=pulumi.get(__ret__, 'specs'),
         updated_at=pulumi.get(__ret__, 'updated_at'),
         urn=pulumi.get(__ret__, 'urn'))
-def get_app_output(app_id: Optional[pulumi.Input[str]] = None,
+def get_app_output(app_id: Optional[pulumi.Input[_builtins.str]] = None,
                    dedicated_ips: Optional[pulumi.Input[Optional[Sequence[Union['GetAppDedicatedIpArgs', 'GetAppDedicatedIpArgsDict']]]]] = None,
                    opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetAppResult]:
     """
@@ -240,7 +240,7 @@ def get_app_output(app_id: Optional[pulumi.Input[str]] = None,
     ```
 
 
-    :param str app_id: The ID of the app to retrieve information about.
+    :param _builtins.str app_id: The ID of the app to retrieve information about.
     :param Sequence[Union['GetAppDedicatedIpArgs', 'GetAppDedicatedIpArgsDict']] dedicated_ips: A list of dedicated egress IP addresses associated with the app.
     """
     __args__ = dict()

pulumi_digitalocean/get_byoip_prefix.py

@@ -0,0 +1,214 @@
+# coding=utf-8
+# *** WARNING: this file was generated by pulumi-language-python. ***
+# *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+import builtins as _builtins
+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__ = [
+    'GetByoipPrefixResult',
+    'AwaitableGetByoipPrefixResult',
+    'get_byoip_prefix',
+    'get_byoip_prefix_output',
+]
+
+@pulumi.output_type
+class GetByoipPrefixResult:
+    """
+    A collection of values returned by getByoipPrefix.
+    """
+    def __init__(__self__, advertised=None, failure_reason=None, id=None, prefix=None, region=None, status=None, uuid=None):
+        if advertised and not isinstance(advertised, bool):
+            raise TypeError("Expected argument 'advertised' to be a bool")
+        pulumi.set(__self__, "advertised", advertised)
+        if failure_reason and not isinstance(failure_reason, str):
+            raise TypeError("Expected argument 'failure_reason' to be a str")
+        pulumi.set(__self__, "failure_reason", failure_reason)
+        if id and not isinstance(id, str):
+            raise TypeError("Expected argument 'id' to be a str")
+        pulumi.set(__self__, "id", id)
+        if prefix and not isinstance(prefix, str):
+            raise TypeError("Expected argument 'prefix' to be a str")
+        pulumi.set(__self__, "prefix", prefix)
+        if region and not isinstance(region, str):
+            raise TypeError("Expected argument 'region' to be a str")
+        pulumi.set(__self__, "region", region)
+        if status and not isinstance(status, str):
+            raise TypeError("Expected argument 'status' to be a str")
+        pulumi.set(__self__, "status", status)
+        if uuid and not isinstance(uuid, str):
+            raise TypeError("Expected argument 'uuid' to be a str")
+        pulumi.set(__self__, "uuid", uuid)
+
+    @_builtins.property
+    @pulumi.getter
+    def advertised(self) -> _builtins.bool:
+        """
+        A boolean indicating whether the prefix is currently being advertised.
+        """
+        return pulumi.get(self, "advertised")
+
+    @_builtins.property
+    @pulumi.getter(name="failureReason")
+    def failure_reason(self) -> _builtins.str:
+        """
+        The reason for failure if the status is "failed".
+        """
+        return pulumi.get(self, "failure_reason")
+
+    @_builtins.property
+    @pulumi.getter
+    def id(self) -> _builtins.str:
+        """
+        The provider-assigned unique ID for this managed resource.
+        """
+        return pulumi.get(self, "id")
+
+    @_builtins.property
+    @pulumi.getter
+    def prefix(self) -> _builtins.str:
+        """
+        The CIDR notation of the prefix (e.g., "192.0.2.0/24").
+        """
+        return pulumi.get(self, "prefix")
+
+    @_builtins.property
+    @pulumi.getter
+    def region(self) -> _builtins.str:
+        """
+        The DigitalOcean region where the prefix is deployed.
+        """
+        return pulumi.get(self, "region")
+
+    @_builtins.property
+    @pulumi.getter
+    def status(self) -> _builtins.str:
+        """
+        The current status of the BYOIP prefix (e.g., "verified", "pending", "failed").
+        """
+        return pulumi.get(self, "status")
+
+    @_builtins.property
+    @pulumi.getter
+    def uuid(self) -> _builtins.str:
+        """
+        The UUID of the BYOIP prefix.
+        """
+        return pulumi.get(self, "uuid")
+
+
+class AwaitableGetByoipPrefixResult(GetByoipPrefixResult):
+    # pylint: disable=using-constant-test
+    def __await__(self):
+        if False:
+            yield self
+        return GetByoipPrefixResult(
+            advertised=self.advertised,
+            failure_reason=self.failure_reason,
+            id=self.id,
+            prefix=self.prefix,
+            region=self.region,
+            status=self.status,
+            uuid=self.uuid)
+
+
+def get_byoip_prefix(uuid: Optional[_builtins.str] = None,
+                     opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetByoipPrefixResult:
+    """
+    ## Example Usage
+
+    Get the BYOIP prefix:
+
+    ```python
+    import pulumi
+    import pulumi_digitalocean as digitalocean
+
+    example = digitalocean.get_byoip_prefix(uuid="506f78a4-e098-11e5-ad9f-000f53306ae1")
+    ```
+
+    List assigned IP addresses from a BYOIP prefix:
+
+    ```python
+    import pulumi
+    import pulumi_digitalocean as digitalocean
+
+    example = digitalocean.get_byoip_prefix(uuid="506f78a4-e098-11e5-ad9f-000f53306ae1")
+    example_get_byoip_prefix_resources = digitalocean.get_byoip_prefix_resources(byoip_prefix_uuid=example.uuid)
+    pulumi.export("byoipInfo", {
+        "prefix": example.prefix,
+        "region": example.region,
+        "status": example.status,
+        "assignedCount": len(example_get_byoip_prefix_resources.addresses),
+    })
+    ```
+
+
+    :param _builtins.str uuid: The UUID of the BYOIP prefix.
+    """
+    __args__ = dict()
+    __args__['uuid'] = uuid
+    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke('digitalocean:index/getByoipPrefix:getByoipPrefix', __args__, opts=opts, typ=GetByoipPrefixResult).value
+
+    return AwaitableGetByoipPrefixResult(
+        advertised=pulumi.get(__ret__, 'advertised'),
+        failure_reason=pulumi.get(__ret__, 'failure_reason'),
+        id=pulumi.get(__ret__, 'id'),
+        prefix=pulumi.get(__ret__, 'prefix'),
+        region=pulumi.get(__ret__, 'region'),
+        status=pulumi.get(__ret__, 'status'),
+        uuid=pulumi.get(__ret__, 'uuid'))
+def get_byoip_prefix_output(uuid: Optional[pulumi.Input[_builtins.str]] = None,
+                            opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetByoipPrefixResult]:
+    """
+    ## Example Usage
+
+    Get the BYOIP prefix:
+
+    ```python
+    import pulumi
+    import pulumi_digitalocean as digitalocean
+
+    example = digitalocean.get_byoip_prefix(uuid="506f78a4-e098-11e5-ad9f-000f53306ae1")
+    ```
+
+    List assigned IP addresses from a BYOIP prefix:
+
+    ```python
+    import pulumi
+    import pulumi_digitalocean as digitalocean
+
+    example = digitalocean.get_byoip_prefix(uuid="506f78a4-e098-11e5-ad9f-000f53306ae1")
+    example_get_byoip_prefix_resources = digitalocean.get_byoip_prefix_resources(byoip_prefix_uuid=example.uuid)
+    pulumi.export("byoipInfo", {
+        "prefix": example.prefix,
+        "region": example.region,
+        "status": example.status,
+        "assignedCount": len(example_get_byoip_prefix_resources.addresses),
+    })
+    ```
+
+
+    :param _builtins.str uuid: The UUID of the BYOIP prefix.
+    """
+    __args__ = dict()
+    __args__['uuid'] = uuid
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('digitalocean:index/getByoipPrefix:getByoipPrefix', __args__, opts=opts, typ=GetByoipPrefixResult)
+    return __ret__.apply(lambda __response__: GetByoipPrefixResult(
+        advertised=pulumi.get(__response__, 'advertised'),
+        failure_reason=pulumi.get(__response__, 'failure_reason'),
+        id=pulumi.get(__response__, 'id'),
+        prefix=pulumi.get(__response__, 'prefix'),
+        region=pulumi.get(__response__, 'region'),
+        status=pulumi.get(__response__, 'status'),
+        uuid=pulumi.get(__response__, 'uuid')))

pulumi_digitalocean/get_byoip_prefix_resources.py

@@ -0,0 +1,150 @@
+# coding=utf-8
+# *** WARNING: this file was generated by pulumi-language-python. ***
+# *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+import builtins as _builtins
+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
+
+__all__ = [
+    'GetByoipPrefixResourcesResult',
+    'AwaitableGetByoipPrefixResourcesResult',
+    'get_byoip_prefix_resources',
+    'get_byoip_prefix_resources_output',
+]
+
+@pulumi.output_type
+class GetByoipPrefixResourcesResult:
+    """
+    A collection of values returned by getByoipPrefixResources.
+    """
+    def __init__(__self__, addresses=None, byoip_prefix_uuid=None, id=None):
+        if addresses and not isinstance(addresses, list):
+            raise TypeError("Expected argument 'addresses' to be a list")
+        pulumi.set(__self__, "addresses", addresses)
+        if byoip_prefix_uuid and not isinstance(byoip_prefix_uuid, str):
+            raise TypeError("Expected argument 'byoip_prefix_uuid' to be a str")
+        pulumi.set(__self__, "byoip_prefix_uuid", byoip_prefix_uuid)
+        if id and not isinstance(id, str):
+            raise TypeError("Expected argument 'id' to be a str")
+        pulumi.set(__self__, "id", id)
+
+    @_builtins.property
+    @pulumi.getter
+    def addresses(self) -> Sequence['outputs.GetByoipPrefixResourcesAddressResult']:
+        """
+        A list of IP addresses allocated from the BYOIP prefix. Each address has the following attributes:
+        """
+        return pulumi.get(self, "addresses")
+
+    @_builtins.property
+    @pulumi.getter(name="byoipPrefixUuid")
+    def byoip_prefix_uuid(self) -> _builtins.str:
+        return pulumi.get(self, "byoip_prefix_uuid")
+
+    @_builtins.property
+    @pulumi.getter
+    def id(self) -> _builtins.str:
+        """
+        The provider-assigned unique ID for this managed resource.
+        """
+        return pulumi.get(self, "id")
+
+
+class AwaitableGetByoipPrefixResourcesResult(GetByoipPrefixResourcesResult):
+    # pylint: disable=using-constant-test
+    def __await__(self):
+        if False:
+            yield self
+        return GetByoipPrefixResourcesResult(
+            addresses=self.addresses,
+            byoip_prefix_uuid=self.byoip_prefix_uuid,
+            id=self.id)
+
+
+def get_byoip_prefix_resources(byoip_prefix_uuid: Optional[_builtins.str] = None,
+                               opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetByoipPrefixResourcesResult:
+    """
+    Get information about IP addresses that have been **already assigned** from a
+    BYOIP (Bring Your Own IP) prefix. This data source provides a list of all IP addresses
+    that are currently assigned to resources from a specific BYOIP prefix.
+
+    **Note:** This data source only lists IPs that are already assigned to resources (like Droplets).
+    To allocate new IPs from the BYOIP prefix, you need to use `ReservedIpAssignment` resource.
+
+    ## Example Usage
+
+    List all assigned IP addresses from a BYOIP prefix:
+
+    ```python
+    import pulumi
+    import pulumi_digitalocean as digitalocean
+
+    example = digitalocean.get_byoip_prefix(uuid="506f78a4-e098-11e5-ad9f-000f53306ae1")
+    example_get_byoip_prefix_resources = digitalocean.get_byoip_prefix_resources(byoip_prefix_uuid=example.uuid)
+    pulumi.export("assignedByoipIps", [{
+        "ip": addr.ip_address,
+        "region": addr.region,
+        "assigned": addr.assigned_at,
+    } for addr in example_get_byoip_prefix_resources.addresses])
+    ```
+
+
+    :param _builtins.str byoip_prefix_uuid: The UUID of the BYOIP prefix to list addresses from.
+    """
+    __args__ = dict()
+    __args__['byoipPrefixUuid'] = byoip_prefix_uuid
+    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke('digitalocean:index/getByoipPrefixResources:getByoipPrefixResources', __args__, opts=opts, typ=GetByoipPrefixResourcesResult).value
+
+    return AwaitableGetByoipPrefixResourcesResult(
+        addresses=pulumi.get(__ret__, 'addresses'),
+        byoip_prefix_uuid=pulumi.get(__ret__, 'byoip_prefix_uuid'),
+        id=pulumi.get(__ret__, 'id'))
+def get_byoip_prefix_resources_output(byoip_prefix_uuid: Optional[pulumi.Input[_builtins.str]] = None,
+                                      opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetByoipPrefixResourcesResult]:
+    """
+    Get information about IP addresses that have been **already assigned** from a
+    BYOIP (Bring Your Own IP) prefix. This data source provides a list of all IP addresses
+    that are currently assigned to resources from a specific BYOIP prefix.
+
+    **Note:** This data source only lists IPs that are already assigned to resources (like Droplets).
+    To allocate new IPs from the BYOIP prefix, you need to use `ReservedIpAssignment` resource.
+
+    ## Example Usage
+
+    List all assigned IP addresses from a BYOIP prefix:
+
+    ```python
+    import pulumi
+    import pulumi_digitalocean as digitalocean
+
+    example = digitalocean.get_byoip_prefix(uuid="506f78a4-e098-11e5-ad9f-000f53306ae1")
+    example_get_byoip_prefix_resources = digitalocean.get_byoip_prefix_resources(byoip_prefix_uuid=example.uuid)
+    pulumi.export("assignedByoipIps", [{
+        "ip": addr.ip_address,
+        "region": addr.region,
+        "assigned": addr.assigned_at,
+    } for addr in example_get_byoip_prefix_resources.addresses])
+    ```
+
+
+    :param _builtins.str byoip_prefix_uuid: The UUID of the BYOIP prefix to list addresses from.
+    """
+    __args__ = dict()
+    __args__['byoipPrefixUuid'] = byoip_prefix_uuid
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('digitalocean:index/getByoipPrefixResources:getByoipPrefixResources', __args__, opts=opts, typ=GetByoipPrefixResourcesResult)
+    return __ret__.apply(lambda __response__: GetByoipPrefixResourcesResult(
+        addresses=pulumi.get(__response__, 'addresses'),
+        byoip_prefix_uuid=pulumi.get(__response__, 'byoip_prefix_uuid'),
+        id=pulumi.get(__response__, 'id')))