pulumiverse-scaleway 1.16.0a1730122985__py3-none-any.whl → 1.17.0a1730194779__py3-none-any.whl

pulumiverse_scaleway/get_block_snapshot.py

@@ -110,14 +110,16 @@ def get_block_snapshot(name: Optional[str] = None,
                        zone: Optional[str] = None,
                        opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetBlockSnapshotResult:
     """
-    Gets information about a Block Snapshot.
+    The `BlockSnapshot` data source is used to retrieve information about a Block Storage volume snapshot.
 
+    Refer to the Block Storage [product documentation](https://www.scaleway.com/en/docs/storage/block/) and [API documentation](https://www.scaleway.com/en/developers/api/block/) for more information.
 
-    :param str name: The name of the snapshot. Only one of `name` and `snapshot_id` should be specified.
-    :param str project_id: The ID of the project the snapshot is associated with.
-    :param str snapshot_id: The ID of the snapshot. Only one of `name` and `snapshot_id` should be specified.
-    :param str volume_id: The ID of the volume from which the snapshot has been created.
-    :param str zone: `zone`) The zone in which the snapshot exists.
+
+    :param str name: The name of the snapshot. Only one of name or snapshot_id should be specified.
+    :param str project_id: The unique identifier of the Project to which the snapshot is associated.
+    :param str snapshot_id: The unique identifier of the snapshot. Only one of `name` and `snapshot_id` should be specified.
+    :param str volume_id: The unique identifier of the volume from which the snapshot was created.
+    :param str zone: ) The zone in which the snapshot exists.
     """
     __args__ = dict()
     __args__['name'] = name
@@ -143,14 +145,16 @@ def get_block_snapshot_output(name: Optional[pulumi.Input[Optional[str]]] = None
                               zone: Optional[pulumi.Input[Optional[str]]] = None,
                               opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetBlockSnapshotResult]:
     """
-    Gets information about a Block Snapshot.
+    The `BlockSnapshot` data source is used to retrieve information about a Block Storage volume snapshot.
+
+    Refer to the Block Storage [product documentation](https://www.scaleway.com/en/docs/storage/block/) and [API documentation](https://www.scaleway.com/en/developers/api/block/) for more information.
 
 
-    :param str name: The name of the snapshot. Only one of `name` and `snapshot_id` should be specified.
-    :param str project_id: The ID of the project the snapshot is associated with.
-    :param str snapshot_id: The ID of the snapshot. Only one of `name` and `snapshot_id` should be specified.
-    :param str volume_id: The ID of the volume from which the snapshot has been created.
-    :param str zone: `zone`) The zone in which the snapshot exists.
+    :param str name: The name of the snapshot. Only one of name or snapshot_id should be specified.
+    :param str project_id: The unique identifier of the Project to which the snapshot is associated.
+    :param str snapshot_id: The unique identifier of the snapshot. Only one of `name` and `snapshot_id` should be specified.
+    :param str volume_id: The unique identifier of the volume from which the snapshot was created.
+    :param str zone: ) The zone in which the snapshot exists.
     """
     __args__ = dict()
     __args__['name'] = name

pulumiverse_scaleway/get_block_volume.py

@@ -127,13 +127,14 @@ def get_block_volume(name: Optional[str] = None,
                      zone: Optional[str] = None,
                      opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetBlockVolumeResult:
     """
-    Gets information about a Block Volume.
+    The `BlockVolume` data source is used to retrieve information about a Block Storage volume.
+    Refer to the Block Storage [product documentation](https://www.scaleway.com/en/docs/storage/block/) and [API documentation](https://www.scaleway.com/en/developers/api/block/) for more information.
 
 
     :param str name: The name of the volume. Only one of `name` and `volume_id` should be specified.
-    :param str project_id: The ID of the project the volume is associated with.
-    :param str volume_id: The ID of the volume. Only one of `name` and `volume_id` should be specified.
-    :param str zone: `zone`) The zone in which the volume exists.
+    :param str project_id: The unique identifier of the Project to which the volume is associated.
+    :param str volume_id: The unique identifier of the volume. Only one of `name` and `volume_id` should be specified.
+    :param str zone: ). The zone in which the volume exists.
     """
     __args__ = dict()
     __args__['name'] = name
@@ -159,13 +160,14 @@ def get_block_volume_output(name: Optional[pulumi.Input[Optional[str]]] = None,
                             zone: Optional[pulumi.Input[Optional[str]]] = None,
                             opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetBlockVolumeResult]:
     """
-    Gets information about a Block Volume.
+    The `BlockVolume` data source is used to retrieve information about a Block Storage volume.
+    Refer to the Block Storage [product documentation](https://www.scaleway.com/en/docs/storage/block/) and [API documentation](https://www.scaleway.com/en/developers/api/block/) for more information.
 
 
     :param str name: The name of the volume. Only one of `name` and `volume_id` should be specified.
-    :param str project_id: The ID of the project the volume is associated with.
-    :param str volume_id: The ID of the volume. Only one of `name` and `volume_id` should be specified.
-    :param str zone: `zone`) The zone in which the volume exists.
+    :param str project_id: The unique identifier of the Project to which the volume is associated.
+    :param str volume_id: The unique identifier of the volume. Only one of `name` and `volume_id` should be specified.
+    :param str zone: ). The zone in which the volume exists.
     """
     __args__ = dict()
     __args__['name'] = name

pulumiverse_scaleway/get_cockpit.py

@@ -27,13 +27,16 @@ class GetCockpitResult:
     """
     A collection of values returned by getCockpit.
     """
-    def __init__(__self__, endpoints=None, id=None, plan_id=None, project_id=None, push_urls=None):
+    def __init__(__self__, endpoints=None, id=None, plan=None, plan_id=None, project_id=None, push_urls=None):
         if endpoints and not isinstance(endpoints, list):
             raise TypeError("Expected argument 'endpoints' to be a list")
         pulumi.set(__self__, "endpoints", endpoints)
         if id and not isinstance(id, str):
             raise TypeError("Expected argument 'id' to be a str")
         pulumi.set(__self__, "id", id)
+        if plan and not isinstance(plan, str):
+            raise TypeError("Expected argument 'plan' to be a str")
+        pulumi.set(__self__, "plan", plan)
         if plan_id and not isinstance(plan_id, str):
             raise TypeError("Expected argument 'plan_id' to be a str")
         pulumi.set(__self__, "plan_id", plan_id)
@@ -48,7 +51,7 @@ class GetCockpitResult:
     @pulumi.getter
     def endpoints(self) -> Sequence['outputs.GetCockpitEndpointResult']:
         """
-        Endpoints
+        (Deprecated) A list of [endpoints](https://www.scaleway.com/en/docs/observability/cockpit/concepts/#endpoints) related to Cockpit, each with specific URLs:
         """
         return pulumi.get(self, "endpoints")
 
@@ -60,11 +63,16 @@ class GetCockpitResult:
         """
         return pulumi.get(self, "id")
 
+    @property
+    @pulumi.getter
+    def plan(self) -> str:
+        return pulumi.get(self, "plan")
+
     @property
     @pulumi.getter(name="planId")
     def plan_id(self) -> str:
         """
-        The ID of the current plan
+        (Deprecated) ID of the current pricing plan
         """
         return pulumi.get(self, "plan_id")
 
@@ -87,6 +95,7 @@ class AwaitableGetCockpitResult(GetCockpitResult):
         return GetCockpitResult(
             endpoints=self.endpoints,
             id=self.id,
+            plan=self.plan,
             plan_id=self.plan_id,
             project_id=self.project_id,
             push_urls=self.push_urls)
@@ -95,21 +104,28 @@ class AwaitableGetCockpitResult(GetCockpitResult):
 def get_cockpit(project_id: Optional[str] = None,
                 opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetCockpitResult:
     """
+    > **Important:**  The data source `Cockpit` has been deprecated and will no longer be supported. Instead, use resource `Cockpit`.
+
     > **Note:**
-    As of April 2024, Cockpit has introduced regionalization to offer more flexibility and resilience.
-    If you have customized dashboards in Grafana for monitoring Scaleway resources, please update your queries to accommodate the new regionalized data sources.
+    As of April 2024, Cockpit has introduced [regionalization](https://www.scaleway.com/en/docs/observability/cockpit/concepts/#region) to offer more flexibility and resilience.
+    If you have created customized dashboards with data for your Scaleway resources before April 2024, you will need to update your queries in Grafana, with the new regionalized data sources.
+
+    The `Cockpit` data source is used to retrieve information about a Scaleway Cockpit associated with a given Project. This can be the default Project or a specific Project identified by its ID.
 
-    Gets information about the Scaleway Cockpit.
+    Refer to Cockpit's [product documentation](https://www.scaleway.com/en/docs/observability/cockpit/concepts/) and [API documentation](https://www.scaleway.com/en/developers/api/cockpit/regional-api) for more information.
 
-    For more information consult the [documentation](https://www.scaleway.com/en/docs/observability/cockpit/concepts/).
+    ## Retrieve a Cockpit
 
-    ## Example Usage
+    The following commands allow you to:
+
+    - get information on the Cockpit associated with your Scaleway default Project
+    - get information on the Cockpit associated with a specific Scaleway Project
 
     ```python
     import pulumi
     import pulumi_scaleway as scaleway
 
-    # Get default project's cockpit
+    # Get the default Project's Cockpit
     main = scaleway.get_cockpit()
     ```
 
@@ -117,12 +133,12 @@ def get_cockpit(project_id: Optional[str] = None,
     import pulumi
     import pulumi_scaleway as scaleway
 
-    # Get a specific project's cockpit
+    # Get a specific Project's Cockpit
     main = scaleway.get_cockpit(project_id="11111111-1111-1111-1111-111111111111")
     ```
 
 
-    :param str project_id: `project_id`) The ID of the project the cockpit is associated with.
+    :param str project_id: Specifies the ID of the Scaleway Project that the Cockpit is associated with. If not specified, it defaults to the Project ID specified in the provider configuration.
     """
     __args__ = dict()
     __args__['projectId'] = project_id
@@ -132,27 +148,35 @@ def get_cockpit(project_id: Optional[str] = None,
     return AwaitableGetCockpitResult(
         endpoints=pulumi.get(__ret__, 'endpoints'),
         id=pulumi.get(__ret__, 'id'),
+        plan=pulumi.get(__ret__, 'plan'),
         plan_id=pulumi.get(__ret__, 'plan_id'),
         project_id=pulumi.get(__ret__, 'project_id'),
         push_urls=pulumi.get(__ret__, 'push_urls'))
 def get_cockpit_output(project_id: Optional[pulumi.Input[Optional[str]]] = None,
                        opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetCockpitResult]:
     """
+    > **Important:**  The data source `Cockpit` has been deprecated and will no longer be supported. Instead, use resource `Cockpit`.
+
     > **Note:**
-    As of April 2024, Cockpit has introduced regionalization to offer more flexibility and resilience.
-    If you have customized dashboards in Grafana for monitoring Scaleway resources, please update your queries to accommodate the new regionalized data sources.
+    As of April 2024, Cockpit has introduced [regionalization](https://www.scaleway.com/en/docs/observability/cockpit/concepts/#region) to offer more flexibility and resilience.
+    If you have created customized dashboards with data for your Scaleway resources before April 2024, you will need to update your queries in Grafana, with the new regionalized data sources.
+
+    The `Cockpit` data source is used to retrieve information about a Scaleway Cockpit associated with a given Project. This can be the default Project or a specific Project identified by its ID.
+
+    Refer to Cockpit's [product documentation](https://www.scaleway.com/en/docs/observability/cockpit/concepts/) and [API documentation](https://www.scaleway.com/en/developers/api/cockpit/regional-api) for more information.
 
-    Gets information about the Scaleway Cockpit.
+    ## Retrieve a Cockpit
 
-    For more information consult the [documentation](https://www.scaleway.com/en/docs/observability/cockpit/concepts/).
+    The following commands allow you to:
 
-    ## Example Usage
+    - get information on the Cockpit associated with your Scaleway default Project
+    - get information on the Cockpit associated with a specific Scaleway Project
 
     ```python
     import pulumi
     import pulumi_scaleway as scaleway
 
-    # Get default project's cockpit
+    # Get the default Project's Cockpit
     main = scaleway.get_cockpit()
     ```
 
@@ -160,12 +184,12 @@ def get_cockpit_output(project_id: Optional[pulumi.Input[Optional[str]]] = None,
     import pulumi
     import pulumi_scaleway as scaleway
 
-    # Get a specific project's cockpit
+    # Get a specific Project's Cockpit
     main = scaleway.get_cockpit(project_id="11111111-1111-1111-1111-111111111111")
     ```
 
 
-    :param str project_id: `project_id`) The ID of the project the cockpit is associated with.
+    :param str project_id: Specifies the ID of the Scaleway Project that the Cockpit is associated with. If not specified, it defaults to the Project ID specified in the provider configuration.
     """
     __args__ = dict()
     __args__['projectId'] = project_id
@@ -174,6 +198,7 @@ def get_cockpit_output(project_id: Optional[pulumi.Input[Optional[str]]] = None,
     return __ret__.apply(lambda __response__: GetCockpitResult(
         endpoints=pulumi.get(__response__, 'endpoints'),
         id=pulumi.get(__response__, 'id'),
+        plan=pulumi.get(__response__, 'plan'),
         plan_id=pulumi.get(__response__, 'plan_id'),
         project_id=pulumi.get(__response__, 'project_id'),
         push_urls=pulumi.get(__response__, 'push_urls')))

pulumiverse_scaleway/get_cockpit_plan.py

@@ -61,9 +61,15 @@ class AwaitableGetCockpitPlanResult(GetCockpitPlanResult):
 def get_cockpit_plan(name: Optional[str] = None,
                      opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetCockpitPlanResult:
     """
-    Gets information about a Scaleway Cockpit plan.
+    The `get_cockpit_plan` data source is used to fetch details about a specific Scaleway Cockpit pricing plan. This information can then be used to configure resources like `Cockpit`.
 
-    ## Example Usage
+    Find out more about [pricing plans](https://console.scaleway.com/cockpit/plans) in the Scaleway console.
+
+    Refer to Cockpit's [product documentation](https://www.scaleway.com/en/docs/observability/cockpit/concepts/) and [API documentation](https://www.scaleway.com/en/developers/api/cockpit/regional-api) for more information.
+
+    ## Fetch and associate a pricing plan to a Cockpit
+
+    The following command shows how to fetch information about the `premium` pricing plan and how to associate it with the Cockpit of your Scaleway default Project.
 
     ```python
     import pulumi
@@ -75,7 +81,7 @@ def get_cockpit_plan(name: Optional[str] = None,
     ```
 
 
-    :param str name: The name of the plan.
+    :param str name: Name of the pricing plan you want to retrieve information about.
     """
     __args__ = dict()
     __args__['name'] = name
@@ -88,9 +94,15 @@ def get_cockpit_plan(name: Optional[str] = None,
 def get_cockpit_plan_output(name: Optional[pulumi.Input[str]] = None,
                             opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetCockpitPlanResult]:
     """
-    Gets information about a Scaleway Cockpit plan.
+    The `get_cockpit_plan` data source is used to fetch details about a specific Scaleway Cockpit pricing plan. This information can then be used to configure resources like `Cockpit`.
+
+    Find out more about [pricing plans](https://console.scaleway.com/cockpit/plans) in the Scaleway console.
+
+    Refer to Cockpit's [product documentation](https://www.scaleway.com/en/docs/observability/cockpit/concepts/) and [API documentation](https://www.scaleway.com/en/developers/api/cockpit/regional-api) for more information.
+
+    ## Fetch and associate a pricing plan to a Cockpit
 
-    ## Example Usage
+    The following command shows how to fetch information about the `premium` pricing plan and how to associate it with the Cockpit of your Scaleway default Project.
 
     ```python
     import pulumi
@@ -102,7 +114,7 @@ def get_cockpit_plan_output(name: Optional[pulumi.Input[str]] = None,
     ```
 
 
-    :param str name: The name of the plan.
+    :param str name: Name of the pricing plan you want to retrieve information about.
     """
     __args__ = dict()
     __args__['name'] = name

pulumiverse_scaleway/get_domain_record.py

@@ -96,7 +96,7 @@ class GetDomainRecordResult:
     @pulumi.getter(name="geoIps")
     def geo_ips(self) -> Sequence['outputs.GetDomainRecordGeoIpResult']:
         """
-        Dynamic record base on user geolocalisation (More information about dynamic records)
+        Information about dynamic records based on user geolocation. Find out more about dynamic records.
         """
         return pulumi.get(self, "geo_ips")
 
@@ -104,7 +104,7 @@ class GetDomainRecordResult:
     @pulumi.getter(name="httpServices")
     def http_services(self) -> Sequence['outputs.GetDomainRecordHttpServiceResult']:
         """
-        Dynamic record base on URL resolve (More information about dynamic records)
+        Information about dynamic records based on URL resolution. Find out more about dynamic records.
         """
         return pulumi.get(self, "http_services")
 
@@ -130,7 +130,7 @@ class GetDomainRecordResult:
     @pulumi.getter
     def priority(self) -> int:
         """
-        The priority of the record (mostly used with an `MX` record)
+        The priority of the record, mainly used with `MX` records.
         """
         return pulumi.get(self, "priority")
 
@@ -153,7 +153,7 @@ class GetDomainRecordResult:
     @pulumi.getter
     def ttl(self) -> int:
         """
-        Time To Live of the record in seconds.
+        The Time To Live (TTL) of the record in seconds.
         """
         return pulumi.get(self, "ttl")
 
@@ -166,7 +166,7 @@ class GetDomainRecordResult:
     @pulumi.getter
     def views(self) -> Sequence['outputs.GetDomainRecordViewResult']:
         """
-        Dynamic record based on the client’s (resolver) subnet (More information about dynamic records)
+        Information about dynamic records based on the client’s (resolver) subnet. Find out more about dynamic records.
         """
         return pulumi.get(self, "views")
 
@@ -174,7 +174,7 @@ class GetDomainRecordResult:
     @pulumi.getter
     def weighteds(self) -> Sequence['outputs.GetDomainRecordWeightedResult']:
         """
-        Dynamic record base on IP weights (More information about dynamic records)
+        Information about dynamic records based on IP weights. Find out more about dynamic records.
         """
         return pulumi.get(self, "weighteds")
 
@@ -211,35 +211,38 @@ def get_domain_record(data: Optional[str] = None,
                       type: Optional[str] = None,
                       opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetDomainRecordResult:
     """
-    Gets information about a domain record.
+    The `DomainRecord` data source is used to get information about an existing domain record.
 
-    ## Example Usage
+    Refer to the Domains and DNS [product documentation](https://www.scaleway.com/en/docs/network/domains-and-dns/) and [API documentation](https://www.scaleway.com/en/developers/api/domains-and-dns/) for more information.
+
+    ## Query domain records
+
+    The following commands allow you to:
+
+    - query a domain record specified by the DNS zone (`domain.tld`), the record name (`www`), the record type (`A`), and the record content (`1.2.3.4`).
+    - query a domain record specified by the DNS zone (`domain.tld`) and the unique record ID (`11111111-1111-1111-1111-111111111111`).
 
     ```python
     import pulumi
     import pulumi_scaleway as scaleway
 
-    # Get record by name, type and data
+    # Query record by DNS zone, record name, type and content
     by_content = scaleway.get_domain_record(dns_zone="domain.tld",
         name="www",
         type="A",
         data="1.2.3.4")
-    # Get info by ID
+    # Query record by DNS zone and record ID
     by_id = scaleway.get_domain_record(dns_zone="domain.tld",
         record_id="11111111-1111-1111-1111-111111111111")
     ```
 
 
-    :param str data: The content of the record (an IPv4 for an `A`, a string for a `TXT`...).
-           Cannot be used with `record_id`.
-    :param str dns_zone: The IP address.
-    :param str name: The name of the record (can be an empty string for a root record).
-           Cannot be used with `record_id`.
-    :param str project_id: `project_id`) The ID of the project the domain is associated with.
-    :param str record_id: The record ID.
-           Cannot be used with `name`, `type` and `data`.
-    :param str type: The type of the record (`A`, `AAAA`, `MX`, `CNAME`, `DNAME`, `ALIAS`, `NS`, `PTR`, `SRV`, `TXT`, `TLSA`, or `CAA`).
-           Cannot be used with `record_id`.
+    :param str data: The content of the record (e.g., an IPv4 address for an `A` record or a string for a `TXT` record). Cannot be used with `record_id`.
+    :param str dns_zone: The DNS zone (domain) to which the record belongs. This is a required field in both examples above but is optional in the context of defining the data source.
+    :param str name: The name of the record, which can be an empty string for a root record. Cannot be used with `record_id`.
+    :param str project_id: ). The ID of the Project associated with the domain.
+    :param str record_id: The unique identifier of the record. Cannot be used with `name`, `type`, and `data`.
+    :param str type: The type of the record (`A`, `AAAA`, `MX`, `CNAME`, etc.). Cannot be used with `record_id`.
     """
     __args__ = dict()
     __args__['data'] = data
@@ -276,35 +279,38 @@ def get_domain_record_output(data: Optional[pulumi.Input[Optional[str]]] = None,
                              type: Optional[pulumi.Input[Optional[str]]] = None,
                              opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetDomainRecordResult]:
     """
-    Gets information about a domain record.
+    The `DomainRecord` data source is used to get information about an existing domain record.
+
+    Refer to the Domains and DNS [product documentation](https://www.scaleway.com/en/docs/network/domains-and-dns/) and [API documentation](https://www.scaleway.com/en/developers/api/domains-and-dns/) for more information.
+
+    ## Query domain records
+
+    The following commands allow you to:
 
-    ## Example Usage
+    - query a domain record specified by the DNS zone (`domain.tld`), the record name (`www`), the record type (`A`), and the record content (`1.2.3.4`).
+    - query a domain record specified by the DNS zone (`domain.tld`) and the unique record ID (`11111111-1111-1111-1111-111111111111`).
 
     ```python
     import pulumi
     import pulumi_scaleway as scaleway
 
-    # Get record by name, type and data
+    # Query record by DNS zone, record name, type and content
     by_content = scaleway.get_domain_record(dns_zone="domain.tld",
         name="www",
         type="A",
         data="1.2.3.4")
-    # Get info by ID
+    # Query record by DNS zone and record ID
     by_id = scaleway.get_domain_record(dns_zone="domain.tld",
         record_id="11111111-1111-1111-1111-111111111111")
     ```
 
 
-    :param str data: The content of the record (an IPv4 for an `A`, a string for a `TXT`...).
-           Cannot be used with `record_id`.
-    :param str dns_zone: The IP address.
-    :param str name: The name of the record (can be an empty string for a root record).
-           Cannot be used with `record_id`.
-    :param str project_id: `project_id`) The ID of the project the domain is associated with.
-    :param str record_id: The record ID.
-           Cannot be used with `name`, `type` and `data`.
-    :param str type: The type of the record (`A`, `AAAA`, `MX`, `CNAME`, `DNAME`, `ALIAS`, `NS`, `PTR`, `SRV`, `TXT`, `TLSA`, or `CAA`).
-           Cannot be used with `record_id`.
+    :param str data: The content of the record (e.g., an IPv4 address for an `A` record or a string for a `TXT` record). Cannot be used with `record_id`.
+    :param str dns_zone: The DNS zone (domain) to which the record belongs. This is a required field in both examples above but is optional in the context of defining the data source.
+    :param str name: The name of the record, which can be an empty string for a root record. Cannot be used with `record_id`.
+    :param str project_id: ). The ID of the Project associated with the domain.
+    :param str record_id: The unique identifier of the record. Cannot be used with `name`, `type`, and `data`.
+    :param str type: The type of the record (`A`, `AAAA`, `MX`, `CNAME`, etc.). Cannot be used with `record_id`.
     """
     __args__ = dict()
     __args__['data'] = data

pulumiverse_scaleway/get_domain_zone.py

@@ -75,7 +75,7 @@ class GetDomainZoneResult:
     @pulumi.getter
     def message(self) -> str:
         """
-        Message
+        Message associated with the domain zone (typically used for status or error messages).
         """
         return pulumi.get(self, "message")
 
@@ -83,7 +83,7 @@ class GetDomainZoneResult:
     @pulumi.getter
     def ns(self) -> Sequence[str]:
         """
-        NameServer list for zone.
+        The list of name servers for the zone.
         """
         return pulumi.get(self, "ns")
 
@@ -91,7 +91,7 @@ class GetDomainZoneResult:
     @pulumi.getter(name="nsDefaults")
     def ns_defaults(self) -> Sequence[str]:
         """
-        NameServer default list for zone.
+        The default list of name servers for the zone.
         """
         return pulumi.get(self, "ns_defaults")
 
@@ -99,7 +99,7 @@ class GetDomainZoneResult:
     @pulumi.getter(name="nsMasters")
     def ns_masters(self) -> Sequence[str]:
         """
-        NameServer master list for zone.
+        The master list of name servers for the zone.
         """
         return pulumi.get(self, "ns_masters")
 
@@ -112,7 +112,7 @@ class GetDomainZoneResult:
     @pulumi.getter
     def status(self) -> str:
         """
-        The domain zone status.
+        The status of the domain zone.
         """
         return pulumi.get(self, "status")
 
@@ -125,7 +125,7 @@ class GetDomainZoneResult:
     @pulumi.getter(name="updatedAt")
     def updated_at(self) -> str:
         """
-        The date and time of the last update of the DNS zone.
+        The date and time of the last update to the DNS zone.
         """
         return pulumi.get(self, "updated_at")
 
@@ -152,22 +152,10 @@ def get_domain_zone(domain: Optional[str] = None,
                     subdomain: Optional[str] = None,
                     opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetDomainZoneResult:
     """
-    Gets information about a domain zone.
+    Use this data source to access information about an existing resource.
 
-    ## Example Usage
-
-    ```python
-    import pulumi
-    import pulumi_scaleway as scaleway
-
-    # Get zone
-    main = scaleway.get_domain_zone(domain="scaleway-terraform.com",
-        subdomain="test")
-    ```
-
-
-    :param str domain: The domain where the DNS zone will be created.
-    :param str subdomain: The subdomain(zone name) to create in the domain.
+    :param str domain: The primary domain name where the DNS zone is located. This is a mandatory field.
+    :param str subdomain: The subdomain (or zone name) within the primary domain. This is a mandatory field.
     """
     __args__ = dict()
     __args__['domain'] = domain
@@ -190,22 +178,10 @@ def get_domain_zone_output(domain: Optional[pulumi.Input[Optional[str]]] = None,
                            subdomain: Optional[pulumi.Input[Optional[str]]] = None,
                            opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetDomainZoneResult]:
     """
-    Gets information about a domain zone.
-
-    ## Example Usage
-
-    ```python
-    import pulumi
-    import pulumi_scaleway as scaleway
-
-    # Get zone
-    main = scaleway.get_domain_zone(domain="scaleway-terraform.com",
-        subdomain="test")
-    ```
-
+    Use this data source to access information about an existing resource.
 
-    :param str domain: The domain where the DNS zone will be created.
-    :param str subdomain: The subdomain(zone name) to create in the domain.
+    :param str domain: The primary domain name where the DNS zone is located. This is a mandatory field.
+    :param str subdomain: The subdomain (or zone name) within the primary domain. This is a mandatory field.
     """
     __args__ = dict()
     __args__['domain'] = domain