pulumiverse-scaleway 1.16.0__py3-none-any.whl

pulumiverse_scaleway/get_vpc_public_gateway_dhcp.py

@@ -0,0 +1,305 @@
+# coding=utf-8
+# *** WARNING: this file was generated by the Pulumi Terraform Bridge (tfgen) Tool. ***
+# *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+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__ = [
+    'GetVpcPublicGatewayDhcpResult',
+    'AwaitableGetVpcPublicGatewayDhcpResult',
+    'get_vpc_public_gateway_dhcp',
+    'get_vpc_public_gateway_dhcp_output',
+]
+
+@pulumi.output_type
+class GetVpcPublicGatewayDhcpResult:
+    """
+    A collection of values returned by getVpcPublicGatewayDhcp.
+    """
+    def __init__(__self__, address=None, created_at=None, dhcp_id=None, dns_local_name=None, dns_searches=None, dns_servers_overrides=None, enable_dynamic=None, id=None, organization_id=None, pool_high=None, pool_low=None, project_id=None, push_default_route=None, push_dns_server=None, rebind_timer=None, renew_timer=None, subnet=None, updated_at=None, valid_lifetime=None, zone=None):
+        if address and not isinstance(address, str):
+            raise TypeError("Expected argument 'address' to be a str")
+        pulumi.set(__self__, "address", address)
+        if created_at and not isinstance(created_at, str):
+            raise TypeError("Expected argument 'created_at' to be a str")
+        pulumi.set(__self__, "created_at", created_at)
+        if dhcp_id and not isinstance(dhcp_id, str):
+            raise TypeError("Expected argument 'dhcp_id' to be a str")
+        pulumi.set(__self__, "dhcp_id", dhcp_id)
+        if dns_local_name and not isinstance(dns_local_name, str):
+            raise TypeError("Expected argument 'dns_local_name' to be a str")
+        pulumi.set(__self__, "dns_local_name", dns_local_name)
+        if dns_searches and not isinstance(dns_searches, list):
+            raise TypeError("Expected argument 'dns_searches' to be a list")
+        pulumi.set(__self__, "dns_searches", dns_searches)
+        if dns_servers_overrides and not isinstance(dns_servers_overrides, list):
+            raise TypeError("Expected argument 'dns_servers_overrides' to be a list")
+        pulumi.set(__self__, "dns_servers_overrides", dns_servers_overrides)
+        if enable_dynamic and not isinstance(enable_dynamic, bool):
+            raise TypeError("Expected argument 'enable_dynamic' to be a bool")
+        pulumi.set(__self__, "enable_dynamic", enable_dynamic)
+        if id and not isinstance(id, str):
+            raise TypeError("Expected argument 'id' to be a str")
+        pulumi.set(__self__, "id", id)
+        if organization_id and not isinstance(organization_id, str):
+            raise TypeError("Expected argument 'organization_id' to be a str")
+        pulumi.set(__self__, "organization_id", organization_id)
+        if pool_high and not isinstance(pool_high, str):
+            raise TypeError("Expected argument 'pool_high' to be a str")
+        pulumi.set(__self__, "pool_high", pool_high)
+        if pool_low and not isinstance(pool_low, str):
+            raise TypeError("Expected argument 'pool_low' to be a str")
+        pulumi.set(__self__, "pool_low", pool_low)
+        if project_id and not isinstance(project_id, str):
+            raise TypeError("Expected argument 'project_id' to be a str")
+        pulumi.set(__self__, "project_id", project_id)
+        if push_default_route and not isinstance(push_default_route, bool):
+            raise TypeError("Expected argument 'push_default_route' to be a bool")
+        pulumi.set(__self__, "push_default_route", push_default_route)
+        if push_dns_server and not isinstance(push_dns_server, bool):
+            raise TypeError("Expected argument 'push_dns_server' to be a bool")
+        pulumi.set(__self__, "push_dns_server", push_dns_server)
+        if rebind_timer and not isinstance(rebind_timer, int):
+            raise TypeError("Expected argument 'rebind_timer' to be a int")
+        pulumi.set(__self__, "rebind_timer", rebind_timer)
+        if renew_timer and not isinstance(renew_timer, int):
+            raise TypeError("Expected argument 'renew_timer' to be a int")
+        pulumi.set(__self__, "renew_timer", renew_timer)
+        if subnet and not isinstance(subnet, str):
+            raise TypeError("Expected argument 'subnet' to be a str")
+        pulumi.set(__self__, "subnet", subnet)
+        if updated_at and not isinstance(updated_at, str):
+            raise TypeError("Expected argument 'updated_at' to be a str")
+        pulumi.set(__self__, "updated_at", updated_at)
+        if valid_lifetime and not isinstance(valid_lifetime, int):
+            raise TypeError("Expected argument 'valid_lifetime' to be a int")
+        pulumi.set(__self__, "valid_lifetime", valid_lifetime)
+        if zone and not isinstance(zone, str):
+            raise TypeError("Expected argument 'zone' to be a str")
+        pulumi.set(__self__, "zone", zone)
+
+    @property
+    @pulumi.getter
+    def address(self) -> str:
+        return pulumi.get(self, "address")
+
+    @property
+    @pulumi.getter(name="createdAt")
+    def created_at(self) -> str:
+        return pulumi.get(self, "created_at")
+
+    @property
+    @pulumi.getter(name="dhcpId")
+    def dhcp_id(self) -> str:
+        return pulumi.get(self, "dhcp_id")
+
+    @property
+    @pulumi.getter(name="dnsLocalName")
+    def dns_local_name(self) -> str:
+        return pulumi.get(self, "dns_local_name")
+
+    @property
+    @pulumi.getter(name="dnsSearches")
+    def dns_searches(self) -> Sequence[str]:
+        return pulumi.get(self, "dns_searches")
+
+    @property
+    @pulumi.getter(name="dnsServersOverrides")
+    def dns_servers_overrides(self) -> Sequence[str]:
+        return pulumi.get(self, "dns_servers_overrides")
+
+    @property
+    @pulumi.getter(name="enableDynamic")
+    def enable_dynamic(self) -> bool:
+        return pulumi.get(self, "enable_dynamic")
+
+    @property
+    @pulumi.getter
+    def id(self) -> str:
+        """
+        The provider-assigned unique ID for this managed resource.
+        """
+        return pulumi.get(self, "id")
+
+    @property
+    @pulumi.getter(name="organizationId")
+    def organization_id(self) -> str:
+        return pulumi.get(self, "organization_id")
+
+    @property
+    @pulumi.getter(name="poolHigh")
+    def pool_high(self) -> str:
+        return pulumi.get(self, "pool_high")
+
+    @property
+    @pulumi.getter(name="poolLow")
+    def pool_low(self) -> str:
+        return pulumi.get(self, "pool_low")
+
+    @property
+    @pulumi.getter(name="projectId")
+    def project_id(self) -> str:
+        return pulumi.get(self, "project_id")
+
+    @property
+    @pulumi.getter(name="pushDefaultRoute")
+    def push_default_route(self) -> bool:
+        return pulumi.get(self, "push_default_route")
+
+    @property
+    @pulumi.getter(name="pushDnsServer")
+    def push_dns_server(self) -> bool:
+        return pulumi.get(self, "push_dns_server")
+
+    @property
+    @pulumi.getter(name="rebindTimer")
+    def rebind_timer(self) -> int:
+        return pulumi.get(self, "rebind_timer")
+
+    @property
+    @pulumi.getter(name="renewTimer")
+    def renew_timer(self) -> int:
+        return pulumi.get(self, "renew_timer")
+
+    @property
+    @pulumi.getter
+    def subnet(self) -> str:
+        return pulumi.get(self, "subnet")
+
+    @property
+    @pulumi.getter(name="updatedAt")
+    def updated_at(self) -> str:
+        return pulumi.get(self, "updated_at")
+
+    @property
+    @pulumi.getter(name="validLifetime")
+    def valid_lifetime(self) -> int:
+        return pulumi.get(self, "valid_lifetime")
+
+    @property
+    @pulumi.getter
+    def zone(self) -> str:
+        return pulumi.get(self, "zone")
+
+
+class AwaitableGetVpcPublicGatewayDhcpResult(GetVpcPublicGatewayDhcpResult):
+    # pylint: disable=using-constant-test
+    def __await__(self):
+        if False:
+            yield self
+        return GetVpcPublicGatewayDhcpResult(
+            address=self.address,
+            created_at=self.created_at,
+            dhcp_id=self.dhcp_id,
+            dns_local_name=self.dns_local_name,
+            dns_searches=self.dns_searches,
+            dns_servers_overrides=self.dns_servers_overrides,
+            enable_dynamic=self.enable_dynamic,
+            id=self.id,
+            organization_id=self.organization_id,
+            pool_high=self.pool_high,
+            pool_low=self.pool_low,
+            project_id=self.project_id,
+            push_default_route=self.push_default_route,
+            push_dns_server=self.push_dns_server,
+            rebind_timer=self.rebind_timer,
+            renew_timer=self.renew_timer,
+            subnet=self.subnet,
+            updated_at=self.updated_at,
+            valid_lifetime=self.valid_lifetime,
+            zone=self.zone)
+
+
+def get_vpc_public_gateway_dhcp(dhcp_id: Optional[str] = None,
+                                opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetVpcPublicGatewayDhcpResult:
+    """
+    Gets information about a Public Gateway DHCP configuration.
+
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_scaleway as scaleway
+    import pulumiverse_scaleway as scaleway
+
+    main = scaleway.VpcPublicGatewayDhcp("main", subnet="192.168.0.0/24")
+    dhcp_by_id = scaleway.get_vpc_public_gateway_dhcp_output(dhcp_id=main.id)
+    ```
+    """
+    __args__ = dict()
+    __args__['dhcpId'] = dhcp_id
+    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke('scaleway:index/getVpcPublicGatewayDhcp:getVpcPublicGatewayDhcp', __args__, opts=opts, typ=GetVpcPublicGatewayDhcpResult).value
+
+    return AwaitableGetVpcPublicGatewayDhcpResult(
+        address=pulumi.get(__ret__, 'address'),
+        created_at=pulumi.get(__ret__, 'created_at'),
+        dhcp_id=pulumi.get(__ret__, 'dhcp_id'),
+        dns_local_name=pulumi.get(__ret__, 'dns_local_name'),
+        dns_searches=pulumi.get(__ret__, 'dns_searches'),
+        dns_servers_overrides=pulumi.get(__ret__, 'dns_servers_overrides'),
+        enable_dynamic=pulumi.get(__ret__, 'enable_dynamic'),
+        id=pulumi.get(__ret__, 'id'),
+        organization_id=pulumi.get(__ret__, 'organization_id'),
+        pool_high=pulumi.get(__ret__, 'pool_high'),
+        pool_low=pulumi.get(__ret__, 'pool_low'),
+        project_id=pulumi.get(__ret__, 'project_id'),
+        push_default_route=pulumi.get(__ret__, 'push_default_route'),
+        push_dns_server=pulumi.get(__ret__, 'push_dns_server'),
+        rebind_timer=pulumi.get(__ret__, 'rebind_timer'),
+        renew_timer=pulumi.get(__ret__, 'renew_timer'),
+        subnet=pulumi.get(__ret__, 'subnet'),
+        updated_at=pulumi.get(__ret__, 'updated_at'),
+        valid_lifetime=pulumi.get(__ret__, 'valid_lifetime'),
+        zone=pulumi.get(__ret__, 'zone'))
+def get_vpc_public_gateway_dhcp_output(dhcp_id: Optional[pulumi.Input[str]] = None,
+                                       opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetVpcPublicGatewayDhcpResult]:
+    """
+    Gets information about a Public Gateway DHCP configuration.
+
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_scaleway as scaleway
+    import pulumiverse_scaleway as scaleway
+
+    main = scaleway.VpcPublicGatewayDhcp("main", subnet="192.168.0.0/24")
+    dhcp_by_id = scaleway.get_vpc_public_gateway_dhcp_output(dhcp_id=main.id)
+    ```
+    """
+    __args__ = dict()
+    __args__['dhcpId'] = dhcp_id
+    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('scaleway:index/getVpcPublicGatewayDhcp:getVpcPublicGatewayDhcp', __args__, opts=opts, typ=GetVpcPublicGatewayDhcpResult)
+    return __ret__.apply(lambda __response__: GetVpcPublicGatewayDhcpResult(
+        address=pulumi.get(__response__, 'address'),
+        created_at=pulumi.get(__response__, 'created_at'),
+        dhcp_id=pulumi.get(__response__, 'dhcp_id'),
+        dns_local_name=pulumi.get(__response__, 'dns_local_name'),
+        dns_searches=pulumi.get(__response__, 'dns_searches'),
+        dns_servers_overrides=pulumi.get(__response__, 'dns_servers_overrides'),
+        enable_dynamic=pulumi.get(__response__, 'enable_dynamic'),
+        id=pulumi.get(__response__, 'id'),
+        organization_id=pulumi.get(__response__, 'organization_id'),
+        pool_high=pulumi.get(__response__, 'pool_high'),
+        pool_low=pulumi.get(__response__, 'pool_low'),
+        project_id=pulumi.get(__response__, 'project_id'),
+        push_default_route=pulumi.get(__response__, 'push_default_route'),
+        push_dns_server=pulumi.get(__response__, 'push_dns_server'),
+        rebind_timer=pulumi.get(__response__, 'rebind_timer'),
+        renew_timer=pulumi.get(__response__, 'renew_timer'),
+        subnet=pulumi.get(__response__, 'subnet'),
+        updated_at=pulumi.get(__response__, 'updated_at'),
+        valid_lifetime=pulumi.get(__response__, 'valid_lifetime'),
+        zone=pulumi.get(__response__, 'zone')))

pulumiverse_scaleway/get_vpc_public_gateway_dhcp_reservation.py

@@ -0,0 +1,382 @@
+# coding=utf-8
+# *** WARNING: this file was generated by the Pulumi Terraform Bridge (tfgen) Tool. ***
+# *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+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__ = [
+    'GetVpcPublicGatewayDhcpReservationResult',
+    'AwaitableGetVpcPublicGatewayDhcpReservationResult',
+    'get_vpc_public_gateway_dhcp_reservation',
+    'get_vpc_public_gateway_dhcp_reservation_output',
+]
+
+@pulumi.output_type
+class GetVpcPublicGatewayDhcpReservationResult:
+    """
+    A collection of values returned by getVpcPublicGatewayDhcpReservation.
+    """
+    def __init__(__self__, created_at=None, gateway_network_id=None, hostname=None, id=None, ip_address=None, mac_address=None, reservation_id=None, type=None, updated_at=None, wait_for_dhcp=None, zone=None):
+        if created_at and not isinstance(created_at, str):
+            raise TypeError("Expected argument 'created_at' to be a str")
+        pulumi.set(__self__, "created_at", created_at)
+        if gateway_network_id and not isinstance(gateway_network_id, str):
+            raise TypeError("Expected argument 'gateway_network_id' to be a str")
+        pulumi.set(__self__, "gateway_network_id", gateway_network_id)
+        if hostname and not isinstance(hostname, str):
+            raise TypeError("Expected argument 'hostname' to be a str")
+        pulumi.set(__self__, "hostname", hostname)
+        if id and not isinstance(id, str):
+            raise TypeError("Expected argument 'id' to be a str")
+        pulumi.set(__self__, "id", id)
+        if ip_address and not isinstance(ip_address, str):
+            raise TypeError("Expected argument 'ip_address' to be a str")
+        pulumi.set(__self__, "ip_address", ip_address)
+        if mac_address and not isinstance(mac_address, str):
+            raise TypeError("Expected argument 'mac_address' to be a str")
+        pulumi.set(__self__, "mac_address", mac_address)
+        if reservation_id and not isinstance(reservation_id, str):
+            raise TypeError("Expected argument 'reservation_id' to be a str")
+        pulumi.set(__self__, "reservation_id", reservation_id)
+        if type and not isinstance(type, str):
+            raise TypeError("Expected argument 'type' to be a str")
+        pulumi.set(__self__, "type", type)
+        if updated_at and not isinstance(updated_at, str):
+            raise TypeError("Expected argument 'updated_at' to be a str")
+        pulumi.set(__self__, "updated_at", updated_at)
+        if wait_for_dhcp and not isinstance(wait_for_dhcp, bool):
+            raise TypeError("Expected argument 'wait_for_dhcp' to be a bool")
+        pulumi.set(__self__, "wait_for_dhcp", wait_for_dhcp)
+        if zone and not isinstance(zone, str):
+            raise TypeError("Expected argument 'zone' to be a str")
+        pulumi.set(__self__, "zone", zone)
+
+    @property
+    @pulumi.getter(name="createdAt")
+    def created_at(self) -> str:
+        return pulumi.get(self, "created_at")
+
+    @property
+    @pulumi.getter(name="gatewayNetworkId")
+    def gateway_network_id(self) -> Optional[str]:
+        return pulumi.get(self, "gateway_network_id")
+
+    @property
+    @pulumi.getter
+    def hostname(self) -> str:
+        return pulumi.get(self, "hostname")
+
+    @property
+    @pulumi.getter
+    def id(self) -> str:
+        """
+        The provider-assigned unique ID for this managed resource.
+        """
+        return pulumi.get(self, "id")
+
+    @property
+    @pulumi.getter(name="ipAddress")
+    def ip_address(self) -> str:
+        return pulumi.get(self, "ip_address")
+
+    @property
+    @pulumi.getter(name="macAddress")
+    def mac_address(self) -> Optional[str]:
+        return pulumi.get(self, "mac_address")
+
+    @property
+    @pulumi.getter(name="reservationId")
+    def reservation_id(self) -> Optional[str]:
+        return pulumi.get(self, "reservation_id")
+
+    @property
+    @pulumi.getter
+    def type(self) -> str:
+        return pulumi.get(self, "type")
+
+    @property
+    @pulumi.getter(name="updatedAt")
+    def updated_at(self) -> str:
+        return pulumi.get(self, "updated_at")
+
+    @property
+    @pulumi.getter(name="waitForDhcp")
+    def wait_for_dhcp(self) -> Optional[bool]:
+        return pulumi.get(self, "wait_for_dhcp")
+
+    @property
+    @pulumi.getter
+    def zone(self) -> Optional[str]:
+        return pulumi.get(self, "zone")
+
+
+class AwaitableGetVpcPublicGatewayDhcpReservationResult(GetVpcPublicGatewayDhcpReservationResult):
+    # pylint: disable=using-constant-test
+    def __await__(self):
+        if False:
+            yield self
+        return GetVpcPublicGatewayDhcpReservationResult(
+            created_at=self.created_at,
+            gateway_network_id=self.gateway_network_id,
+            hostname=self.hostname,
+            id=self.id,
+            ip_address=self.ip_address,
+            mac_address=self.mac_address,
+            reservation_id=self.reservation_id,
+            type=self.type,
+            updated_at=self.updated_at,
+            wait_for_dhcp=self.wait_for_dhcp,
+            zone=self.zone)
+
+
+def get_vpc_public_gateway_dhcp_reservation(gateway_network_id: Optional[str] = None,
+                                            mac_address: Optional[str] = None,
+                                            reservation_id: Optional[str] = None,
+                                            wait_for_dhcp: Optional[bool] = None,
+                                            zone: Optional[str] = None,
+                                            opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetVpcPublicGatewayDhcpReservationResult:
+    """
+    Gets information about a DHCP entry. For further information, please see the
+    API [documentation](https://www.scaleway.com/en/developers/api/public-gateway/#path-dhcp-entries-list-dhcp-entries)/
+
+    ## Example Dynamic
+
+    ```python
+    import pulumi
+    import pulumi_scaleway as scaleway
+    import pulumiverse_scaleway as scaleway
+
+    main = scaleway.VpcPrivateNetwork("main")
+    main_instance_server = scaleway.InstanceServer("main",
+        image="ubuntu_jammy",
+        type="DEV1-S",
+        zone="fr-par-1")
+    main_instance_private_nic = scaleway.InstancePrivateNic("main",
+        server_id=main_instance_server.id,
+        private_network_id=main.id)
+    main_vpc_public_gateway_ip = scaleway.VpcPublicGatewayIp("main")
+    main_vpc_public_gateway_dhcp = scaleway.VpcPublicGatewayDhcp("main", subnet="192.168.1.0/24")
+    main_vpc_public_gateway = scaleway.VpcPublicGateway("main",
+        name="foobar",
+        type="VPC-GW-S",
+        ip_id=main_vpc_public_gateway_ip.id)
+    main_vpc_gateway_network = scaleway.VpcGatewayNetwork("main",
+        gateway_id=main_vpc_public_gateway.id,
+        private_network_id=main.id,
+        dhcp_id=main_vpc_public_gateway_dhcp.id,
+        cleanup_dhcp=True,
+        enable_masquerade=True)
+    ## Retrieve the dynamic entries generated by mac address & gateway network
+    by_mac_address_and_gw_network = scaleway.get_vpc_public_gateway_dhcp_reservation_output(mac_address=main_instance_private_nic.mac_address,
+        gateway_network_id=main_vpc_gateway_network.id)
+    ```
+
+    ## Example Static and PAT Rule
+
+    ```python
+    import pulumi
+    import pulumi_scaleway as scaleway
+    import pulumiverse_scaleway as scaleway
+
+    main = scaleway.VpcPrivateNetwork("main")
+    main_instance_security_group = scaleway.InstanceSecurityGroup("main",
+        inbound_default_policy="drop",
+        outbound_default_policy="accept",
+        inbound_rules=[{
+            "action": "accept",
+            "port": 22,
+        }])
+    main_instance_server = scaleway.InstanceServer("main",
+        image="ubuntu_jammy",
+        type="DEV1-S",
+        zone="fr-par-1",
+        security_group_id=main_instance_security_group.id)
+    main_instance_private_nic = scaleway.InstancePrivateNic("main",
+        server_id=main_instance_server.id,
+        private_network_id=main.id)
+    main_vpc_public_gateway_ip = scaleway.VpcPublicGatewayIp("main")
+    main_vpc_public_gateway_dhcp = scaleway.VpcPublicGatewayDhcp("main", subnet="192.168.1.0/24")
+    main_vpc_public_gateway = scaleway.VpcPublicGateway("main",
+        name="foobar",
+        type="VPC-GW-S",
+        ip_id=main_vpc_public_gateway_ip.id)
+    main_vpc_gateway_network = scaleway.VpcGatewayNetwork("main",
+        gateway_id=main_vpc_public_gateway.id,
+        private_network_id=main.id,
+        dhcp_id=main_vpc_public_gateway_dhcp.id,
+        cleanup_dhcp=True,
+        enable_masquerade=True)
+    main_vpc_public_gateway_dhcp_reservation = scaleway.VpcPublicGatewayDhcpReservation("main",
+        gateway_network_id=main_vpc_gateway_network.id,
+        mac_address=main_instance_private_nic.mac_address,
+        ip_address="192.168.1.4")
+    ### VPC PAT RULE
+    main_vpc_public_gateway_pat_rule = scaleway.VpcPublicGatewayPatRule("main",
+        gateway_id=main_vpc_public_gateway.id,
+        private_ip=main_vpc_public_gateway_dhcp_reservation.ip_address,
+        private_port=22,
+        public_port=2222,
+        protocol="tcp")
+    by_id = scaleway.get_vpc_public_gateway_dhcp_reservation_output(reservation_id=main_vpc_public_gateway_dhcp_reservation.id)
+    ```
+
+
+    :param str gateway_network_id: The ID of the owning GatewayNetwork.
+           
+           > Only one of `reservation_id` or `mac_address` with `gateway_network_id` should be specified.
+    :param str mac_address: The MAC address of the reservation to retrieve.
+    :param str reservation_id: The ID of the reservation (DHCP entry) to retrieve.
+    :param bool wait_for_dhcp: Whether to wait for `mac_address` to exist in DHCP.
+    :param str zone: `zone`). The zone in which the reservation exists.
+    """
+    __args__ = dict()
+    __args__['gatewayNetworkId'] = gateway_network_id
+    __args__['macAddress'] = mac_address
+    __args__['reservationId'] = reservation_id
+    __args__['waitForDhcp'] = wait_for_dhcp
+    __args__['zone'] = zone
+    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke('scaleway:index/getVpcPublicGatewayDhcpReservation:getVpcPublicGatewayDhcpReservation', __args__, opts=opts, typ=GetVpcPublicGatewayDhcpReservationResult).value
+
+    return AwaitableGetVpcPublicGatewayDhcpReservationResult(
+        created_at=pulumi.get(__ret__, 'created_at'),
+        gateway_network_id=pulumi.get(__ret__, 'gateway_network_id'),
+        hostname=pulumi.get(__ret__, 'hostname'),
+        id=pulumi.get(__ret__, 'id'),
+        ip_address=pulumi.get(__ret__, 'ip_address'),
+        mac_address=pulumi.get(__ret__, 'mac_address'),
+        reservation_id=pulumi.get(__ret__, 'reservation_id'),
+        type=pulumi.get(__ret__, 'type'),
+        updated_at=pulumi.get(__ret__, 'updated_at'),
+        wait_for_dhcp=pulumi.get(__ret__, 'wait_for_dhcp'),
+        zone=pulumi.get(__ret__, 'zone'))
+def get_vpc_public_gateway_dhcp_reservation_output(gateway_network_id: Optional[pulumi.Input[Optional[str]]] = None,
+                                                   mac_address: Optional[pulumi.Input[Optional[str]]] = None,
+                                                   reservation_id: Optional[pulumi.Input[Optional[str]]] = None,
+                                                   wait_for_dhcp: Optional[pulumi.Input[Optional[bool]]] = None,
+                                                   zone: Optional[pulumi.Input[Optional[str]]] = None,
+                                                   opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetVpcPublicGatewayDhcpReservationResult]:
+    """
+    Gets information about a DHCP entry. For further information, please see the
+    API [documentation](https://www.scaleway.com/en/developers/api/public-gateway/#path-dhcp-entries-list-dhcp-entries)/
+
+    ## Example Dynamic
+
+    ```python
+    import pulumi
+    import pulumi_scaleway as scaleway
+    import pulumiverse_scaleway as scaleway
+
+    main = scaleway.VpcPrivateNetwork("main")
+    main_instance_server = scaleway.InstanceServer("main",
+        image="ubuntu_jammy",
+        type="DEV1-S",
+        zone="fr-par-1")
+    main_instance_private_nic = scaleway.InstancePrivateNic("main",
+        server_id=main_instance_server.id,
+        private_network_id=main.id)
+    main_vpc_public_gateway_ip = scaleway.VpcPublicGatewayIp("main")
+    main_vpc_public_gateway_dhcp = scaleway.VpcPublicGatewayDhcp("main", subnet="192.168.1.0/24")
+    main_vpc_public_gateway = scaleway.VpcPublicGateway("main",
+        name="foobar",
+        type="VPC-GW-S",
+        ip_id=main_vpc_public_gateway_ip.id)
+    main_vpc_gateway_network = scaleway.VpcGatewayNetwork("main",
+        gateway_id=main_vpc_public_gateway.id,
+        private_network_id=main.id,
+        dhcp_id=main_vpc_public_gateway_dhcp.id,
+        cleanup_dhcp=True,
+        enable_masquerade=True)
+    ## Retrieve the dynamic entries generated by mac address & gateway network
+    by_mac_address_and_gw_network = scaleway.get_vpc_public_gateway_dhcp_reservation_output(mac_address=main_instance_private_nic.mac_address,
+        gateway_network_id=main_vpc_gateway_network.id)
+    ```
+
+    ## Example Static and PAT Rule
+
+    ```python
+    import pulumi
+    import pulumi_scaleway as scaleway
+    import pulumiverse_scaleway as scaleway
+
+    main = scaleway.VpcPrivateNetwork("main")
+    main_instance_security_group = scaleway.InstanceSecurityGroup("main",
+        inbound_default_policy="drop",
+        outbound_default_policy="accept",
+        inbound_rules=[{
+            "action": "accept",
+            "port": 22,
+        }])
+    main_instance_server = scaleway.InstanceServer("main",
+        image="ubuntu_jammy",
+        type="DEV1-S",
+        zone="fr-par-1",
+        security_group_id=main_instance_security_group.id)
+    main_instance_private_nic = scaleway.InstancePrivateNic("main",
+        server_id=main_instance_server.id,
+        private_network_id=main.id)
+    main_vpc_public_gateway_ip = scaleway.VpcPublicGatewayIp("main")
+    main_vpc_public_gateway_dhcp = scaleway.VpcPublicGatewayDhcp("main", subnet="192.168.1.0/24")
+    main_vpc_public_gateway = scaleway.VpcPublicGateway("main",
+        name="foobar",
+        type="VPC-GW-S",
+        ip_id=main_vpc_public_gateway_ip.id)
+    main_vpc_gateway_network = scaleway.VpcGatewayNetwork("main",
+        gateway_id=main_vpc_public_gateway.id,
+        private_network_id=main.id,
+        dhcp_id=main_vpc_public_gateway_dhcp.id,
+        cleanup_dhcp=True,
+        enable_masquerade=True)
+    main_vpc_public_gateway_dhcp_reservation = scaleway.VpcPublicGatewayDhcpReservation("main",
+        gateway_network_id=main_vpc_gateway_network.id,
+        mac_address=main_instance_private_nic.mac_address,
+        ip_address="192.168.1.4")
+    ### VPC PAT RULE
+    main_vpc_public_gateway_pat_rule = scaleway.VpcPublicGatewayPatRule("main",
+        gateway_id=main_vpc_public_gateway.id,
+        private_ip=main_vpc_public_gateway_dhcp_reservation.ip_address,
+        private_port=22,
+        public_port=2222,
+        protocol="tcp")
+    by_id = scaleway.get_vpc_public_gateway_dhcp_reservation_output(reservation_id=main_vpc_public_gateway_dhcp_reservation.id)
+    ```
+
+
+    :param str gateway_network_id: The ID of the owning GatewayNetwork.
+           
+           > Only one of `reservation_id` or `mac_address` with `gateway_network_id` should be specified.
+    :param str mac_address: The MAC address of the reservation to retrieve.
+    :param str reservation_id: The ID of the reservation (DHCP entry) to retrieve.
+    :param bool wait_for_dhcp: Whether to wait for `mac_address` to exist in DHCP.
+    :param str zone: `zone`). The zone in which the reservation exists.
+    """
+    __args__ = dict()
+    __args__['gatewayNetworkId'] = gateway_network_id
+    __args__['macAddress'] = mac_address
+    __args__['reservationId'] = reservation_id
+    __args__['waitForDhcp'] = wait_for_dhcp
+    __args__['zone'] = zone
+    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('scaleway:index/getVpcPublicGatewayDhcpReservation:getVpcPublicGatewayDhcpReservation', __args__, opts=opts, typ=GetVpcPublicGatewayDhcpReservationResult)
+    return __ret__.apply(lambda __response__: GetVpcPublicGatewayDhcpReservationResult(
+        created_at=pulumi.get(__response__, 'created_at'),
+        gateway_network_id=pulumi.get(__response__, 'gateway_network_id'),
+        hostname=pulumi.get(__response__, 'hostname'),
+        id=pulumi.get(__response__, 'id'),
+        ip_address=pulumi.get(__response__, 'ip_address'),
+        mac_address=pulumi.get(__response__, 'mac_address'),
+        reservation_id=pulumi.get(__response__, 'reservation_id'),
+        type=pulumi.get(__response__, 'type'),
+        updated_at=pulumi.get(__response__, 'updated_at'),
+        wait_for_dhcp=pulumi.get(__response__, 'wait_for_dhcp'),
+        zone=pulumi.get(__response__, 'zone')))