pulumiverse-scaleway 1.27.0a1744869119__py3-none-any.whl → 1.39.0a1764841480__py3-none-any.whl

pulumiverse_scaleway/databases/acl.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
@@ -22,26 +22,30 @@ __all__ = ['AclArgs', 'Acl']
 class AclArgs:
     def __init__(__self__, *,
                  acl_rules: pulumi.Input[Sequence[pulumi.Input['AclAclRuleArgs']]],
-                 instance_id: pulumi.Input[str],
-                 region: Optional[pulumi.Input[str]] = None):
+                 instance_id: pulumi.Input[_builtins.str],
+                 region: Optional[pulumi.Input[_builtins.str]] = None):
         """
         The set of arguments for constructing a Acl resource.
         :param pulumi.Input[Sequence[pulumi.Input['AclAclRuleArgs']]] acl_rules: A list of ACLs (structure is described below)
-        :param pulumi.Input[str] instance_id: UUID of the Database Instance.
+               
+               > **Important:** The `databases.Acl` resource replaces **all** ACL rules for the given instance. Multiple `databases.Acl` resources targeting the same `instance_id` will conflict with each other. Use multiple `acl_rules` blocks within a single resource instead.
+        :param pulumi.Input[_builtins.str] instance_id: UUID of the Database Instance.
                
                > **Important:** Updates to `instance_id` will recreate the Database ACL.
-        :param pulumi.Input[str] region: `region`) The region in which the Database Instance should be created.
+        :param pulumi.Input[_builtins.str] region: `region`) The region in which the Database Instance should be created.
         """
         pulumi.set(__self__, "acl_rules", acl_rules)
         pulumi.set(__self__, "instance_id", instance_id)
         if region is not None:
             pulumi.set(__self__, "region", region)
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="aclRules")
     def acl_rules(self) -> pulumi.Input[Sequence[pulumi.Input['AclAclRuleArgs']]]:
         """
         A list of ACLs (structure is described below)
+
+        > **Important:** The `databases.Acl` resource replaces **all** ACL rules for the given instance. Multiple `databases.Acl` resources targeting the same `instance_id` will conflict with each other. Use multiple `acl_rules` blocks within a single resource instead.
         """
         return pulumi.get(self, "acl_rules")
 
@@ -49,9 +53,9 @@ class AclArgs:
     def acl_rules(self, value: pulumi.Input[Sequence[pulumi.Input['AclAclRuleArgs']]]):
         pulumi.set(self, "acl_rules", value)
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="instanceId")
-    def instance_id(self) -> pulumi.Input[str]:
+    def instance_id(self) -> pulumi.Input[_builtins.str]:
         """
         UUID of the Database Instance.
 
@@ -60,19 +64,19 @@ class AclArgs:
         return pulumi.get(self, "instance_id")
 
     @instance_id.setter
-    def instance_id(self, value: pulumi.Input[str]):
+    def instance_id(self, value: pulumi.Input[_builtins.str]):
         pulumi.set(self, "instance_id", value)
 
-    @property
+    @_builtins.property
     @pulumi.getter
-    def region(self) -> Optional[pulumi.Input[str]]:
+    def region(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
         `region`) The region in which the Database Instance should be created.
         """
         return pulumi.get(self, "region")
 
     @region.setter
-    def region(self, value: Optional[pulumi.Input[str]]):
+    def region(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "region", value)
 
 
@@ -80,15 +84,17 @@ class AclArgs:
 class _AclState:
     def __init__(__self__, *,
                  acl_rules: Optional[pulumi.Input[Sequence[pulumi.Input['AclAclRuleArgs']]]] = None,
-                 instance_id: Optional[pulumi.Input[str]] = None,
-                 region: Optional[pulumi.Input[str]] = None):
+                 instance_id: Optional[pulumi.Input[_builtins.str]] = None,
+                 region: Optional[pulumi.Input[_builtins.str]] = None):
         """
         Input properties used for looking up and filtering Acl resources.
         :param pulumi.Input[Sequence[pulumi.Input['AclAclRuleArgs']]] acl_rules: A list of ACLs (structure is described below)
-        :param pulumi.Input[str] instance_id: UUID of the Database Instance.
+               
+               > **Important:** The `databases.Acl` resource replaces **all** ACL rules for the given instance. Multiple `databases.Acl` resources targeting the same `instance_id` will conflict with each other. Use multiple `acl_rules` blocks within a single resource instead.
+        :param pulumi.Input[_builtins.str] instance_id: UUID of the Database Instance.
                
                > **Important:** Updates to `instance_id` will recreate the Database ACL.
-        :param pulumi.Input[str] region: `region`) The region in which the Database Instance should be created.
+        :param pulumi.Input[_builtins.str] region: `region`) The region in which the Database Instance should be created.
         """
         if acl_rules is not None:
             pulumi.set(__self__, "acl_rules", acl_rules)
@@ -97,11 +103,13 @@ class _AclState:
         if region is not None:
             pulumi.set(__self__, "region", region)
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="aclRules")
     def acl_rules(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['AclAclRuleArgs']]]]:
         """
         A list of ACLs (structure is described below)
+
+        > **Important:** The `databases.Acl` resource replaces **all** ACL rules for the given instance. Multiple `databases.Acl` resources targeting the same `instance_id` will conflict with each other. Use multiple `acl_rules` blocks within a single resource instead.
         """
         return pulumi.get(self, "acl_rules")
 
@@ -109,9 +117,9 @@ class _AclState:
     def acl_rules(self, value: Optional[pulumi.Input[Sequence[pulumi.Input['AclAclRuleArgs']]]]):
         pulumi.set(self, "acl_rules", value)
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="instanceId")
-    def instance_id(self) -> Optional[pulumi.Input[str]]:
+    def instance_id(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
         UUID of the Database Instance.
 
@@ -120,30 +128,31 @@ class _AclState:
         return pulumi.get(self, "instance_id")
 
     @instance_id.setter
-    def instance_id(self, value: Optional[pulumi.Input[str]]):
+    def instance_id(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "instance_id", value)
 
-    @property
+    @_builtins.property
     @pulumi.getter
-    def region(self) -> Optional[pulumi.Input[str]]:
+    def region(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
         `region`) The region in which the Database Instance should be created.
         """
         return pulumi.get(self, "region")
 
     @region.setter
-    def region(self, value: Optional[pulumi.Input[str]]):
+    def region(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "region", value)
 
 
+@pulumi.type_token("scaleway:databases/acl:Acl")
 class Acl(pulumi.CustomResource):
     @overload
     def __init__(__self__,
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
                  acl_rules: Optional[pulumi.Input[Sequence[pulumi.Input[Union['AclAclRuleArgs', 'AclAclRuleArgsDict']]]]] = None,
-                 instance_id: Optional[pulumi.Input[str]] = None,
-                 region: Optional[pulumi.Input[str]] = None,
+                 instance_id: Optional[pulumi.Input[_builtins.str]] = None,
+                 region: Optional[pulumi.Input[_builtins.str]] = None,
                  __props__=None):
         """
         Creates and manages Scaleway Database instance authorized IPs.
@@ -173,6 +182,53 @@ class Acl(pulumi.CustomResource):
             }])
         ```
 
+        ### Multiple ACL Rules
+
+        ```python
+        import pulumi
+        import pulumiverse_scaleway as scaleway
+
+        main = scaleway.databases.Acl("main",
+            instance_id=main_scaleway_rdb_instance["id"],
+            acl_rules=[
+                {
+                    "ip": "1.2.3.4/32",
+                    "description": "Office IP",
+                },
+                {
+                    "ip": "5.6.7.8/32",
+                    "description": "Home IP",
+                },
+                {
+                    "ip": "10.0.0.0/24",
+                    "description": "Internal network",
+                },
+            ])
+        ```
+
+        ### Dynamic ACL Rules with Variables
+
+        ```python
+        import pulumi
+        import pulumiverse_scaleway as scaleway
+
+        config = pulumi.Config()
+        # Map of allowed IPs with descriptions
+        allowed_ips = config.get_object("allowedIps")
+        if allowed_ips is None:
+            allowed_ips = {
+                "1.2.3.4/32": "Office IP",
+                "10.0.0.0/24": "Internal network",
+                "5.6.7.8/32": "Home IP",
+            }
+        main = scaleway.databases.Acl("main",
+            acl_rules=[{
+                "ip": entry["key"],
+                "description": entry["value"],
+            } for entry in [{"key": k, "value": v} for k, v in allowed_ips]],
+            instance_id=main_scaleway_rdb_instance["id"])
+        ```
+
         ## Import
 
         Database Instance can be imported using the `{region}/{id}`, e.g.
@@ -186,10 +242,12 @@ class Acl(pulumi.CustomResource):
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[Sequence[pulumi.Input[Union['AclAclRuleArgs', 'AclAclRuleArgsDict']]]] acl_rules: A list of ACLs (structure is described below)
-        :param pulumi.Input[str] instance_id: UUID of the Database Instance.
+               
+               > **Important:** The `databases.Acl` resource replaces **all** ACL rules for the given instance. Multiple `databases.Acl` resources targeting the same `instance_id` will conflict with each other. Use multiple `acl_rules` blocks within a single resource instead.
+        :param pulumi.Input[_builtins.str] instance_id: UUID of the Database Instance.
                
                > **Important:** Updates to `instance_id` will recreate the Database ACL.
-        :param pulumi.Input[str] region: `region`) The region in which the Database Instance should be created.
+        :param pulumi.Input[_builtins.str] region: `region`) The region in which the Database Instance should be created.
         """
         ...
     @overload
@@ -225,6 +283,53 @@ class Acl(pulumi.CustomResource):
             }])
         ```
 
+        ### Multiple ACL Rules
+
+        ```python
+        import pulumi
+        import pulumiverse_scaleway as scaleway
+
+        main = scaleway.databases.Acl("main",
+            instance_id=main_scaleway_rdb_instance["id"],
+            acl_rules=[
+                {
+                    "ip": "1.2.3.4/32",
+                    "description": "Office IP",
+                },
+                {
+                    "ip": "5.6.7.8/32",
+                    "description": "Home IP",
+                },
+                {
+                    "ip": "10.0.0.0/24",
+                    "description": "Internal network",
+                },
+            ])
+        ```
+
+        ### Dynamic ACL Rules with Variables
+
+        ```python
+        import pulumi
+        import pulumiverse_scaleway as scaleway
+
+        config = pulumi.Config()
+        # Map of allowed IPs with descriptions
+        allowed_ips = config.get_object("allowedIps")
+        if allowed_ips is None:
+            allowed_ips = {
+                "1.2.3.4/32": "Office IP",
+                "10.0.0.0/24": "Internal network",
+                "5.6.7.8/32": "Home IP",
+            }
+        main = scaleway.databases.Acl("main",
+            acl_rules=[{
+                "ip": entry["key"],
+                "description": entry["value"],
+            } for entry in [{"key": k, "value": v} for k, v in allowed_ips]],
+            instance_id=main_scaleway_rdb_instance["id"])
+        ```
+
         ## Import
 
         Database Instance can be imported using the `{region}/{id}`, e.g.
@@ -251,8 +356,8 @@ class Acl(pulumi.CustomResource):
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
                  acl_rules: Optional[pulumi.Input[Sequence[pulumi.Input[Union['AclAclRuleArgs', 'AclAclRuleArgsDict']]]]] = None,
-                 instance_id: Optional[pulumi.Input[str]] = None,
-                 region: Optional[pulumi.Input[str]] = None,
+                 instance_id: Optional[pulumi.Input[_builtins.str]] = None,
+                 region: Optional[pulumi.Input[_builtins.str]] = None,
                  __props__=None):
         opts = pulumi.ResourceOptions.merge(_utilities.get_resource_opts_defaults(), opts)
         if not isinstance(opts, pulumi.ResourceOptions):
@@ -282,8 +387,8 @@ class Acl(pulumi.CustomResource):
             id: pulumi.Input[str],
             opts: Optional[pulumi.ResourceOptions] = None,
             acl_rules: Optional[pulumi.Input[Sequence[pulumi.Input[Union['AclAclRuleArgs', 'AclAclRuleArgsDict']]]]] = None,
-            instance_id: Optional[pulumi.Input[str]] = None,
-            region: Optional[pulumi.Input[str]] = None) -> 'Acl':
+            instance_id: Optional[pulumi.Input[_builtins.str]] = None,
+            region: Optional[pulumi.Input[_builtins.str]] = None) -> 'Acl':
         """
         Get an existing Acl resource's state with the given name, id, and optional extra
         properties used to qualify the lookup.
@@ -292,10 +397,12 @@ class Acl(pulumi.CustomResource):
         :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[Sequence[pulumi.Input[Union['AclAclRuleArgs', 'AclAclRuleArgsDict']]]] acl_rules: A list of ACLs (structure is described below)
-        :param pulumi.Input[str] instance_id: UUID of the Database Instance.
+               
+               > **Important:** The `databases.Acl` resource replaces **all** ACL rules for the given instance. Multiple `databases.Acl` resources targeting the same `instance_id` will conflict with each other. Use multiple `acl_rules` blocks within a single resource instead.
+        :param pulumi.Input[_builtins.str] instance_id: UUID of the Database Instance.
                
                > **Important:** Updates to `instance_id` will recreate the Database ACL.
-        :param pulumi.Input[str] region: `region`) The region in which the Database Instance should be created.
+        :param pulumi.Input[_builtins.str] region: `region`) The region in which the Database Instance should be created.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
 
@@ -306,17 +413,19 @@ class Acl(pulumi.CustomResource):
         __props__.__dict__["region"] = region
         return Acl(resource_name, opts=opts, __props__=__props__)
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="aclRules")
     def acl_rules(self) -> pulumi.Output[Sequence['outputs.AclAclRule']]:
         """
         A list of ACLs (structure is described below)
+
+        > **Important:** The `databases.Acl` resource replaces **all** ACL rules for the given instance. Multiple `databases.Acl` resources targeting the same `instance_id` will conflict with each other. Use multiple `acl_rules` blocks within a single resource instead.
         """
         return pulumi.get(self, "acl_rules")
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="instanceId")
-    def instance_id(self) -> pulumi.Output[str]:
+    def instance_id(self) -> pulumi.Output[_builtins.str]:
         """
         UUID of the Database Instance.
 
@@ -324,9 +433,9 @@ class Acl(pulumi.CustomResource):
         """
         return pulumi.get(self, "instance_id")
 
-    @property
+    @_builtins.property
     @pulumi.getter
-    def region(self) -> pulumi.Output[str]:
+    def region(self) -> pulumi.Output[Optional[_builtins.str]]:
         """
         `region`) The region in which the Database Instance should be created.
         """