docs(billing): add info about resellers (#890)

Author: scaleway-bot

scaleway-async/scaleway_async/billing/v2beta1/api.py

@@ -438,7 +438,10 @@ async def list_discounts(
     ) -> ListDiscountsResponse:
         """
         List discounts.
-        List all discounts for your organization and usable categories, products, offers, references, regions and zones where the discount can be applied.
+        List all discounts for your Organization and usable categories, products, offers, references, regions and zones where the discount can be applied. As a reseller:
+        - If you do not specify an `organization_id` you will list the discounts applied to your own Organization and your customers
+        - If you indicate your `organization_id` you will list only the discounts applied to your Organization
+        - If you indicate `the organization_id` of one of your customers, you will list the discounts applied to their Organization.
         :param order_by: Order discounts in the response by their description.
         :param page: Positive integer to choose the page to return.
         :param page_size: Positive integer lower or equal to 100 to select the number of items to return.
@@ -476,7 +479,10 @@ async def list_discounts_all(
     ) -> List[Discount]:
         """
         List discounts.
-        List all discounts for your organization and usable categories, products, offers, references, regions and zones where the discount can be applied.
+        List all discounts for your Organization and usable categories, products, offers, references, regions and zones where the discount can be applied. As a reseller:
+        - If you do not specify an `organization_id` you will list the discounts applied to your own Organization and your customers
+        - If you indicate your `organization_id` you will list only the discounts applied to your Organization
+        - If you indicate `the organization_id` of one of your customers, you will list the discounts applied to their Organization.
         :param order_by: Order discounts in the response by their description.
         :param page: Positive integer to choose the page to return.
         :param page_size: Positive integer lower or equal to 100 to select the number of items to return.

scaleway-async/scaleway_async/billing/v2beta1/types.py

@@ -211,7 +211,7 @@ class Discount:
 
     organization_id: str
     """
-    The organization ID of the discount.
+    The Organization ID of the discount.
     """
 
     description: str

scaleway/scaleway/billing/v2beta1/api.py

@@ -438,7 +438,10 @@ def list_discounts(
     ) -> ListDiscountsResponse:
         """
         List discounts.
-        List all discounts for your organization and usable categories, products, offers, references, regions and zones where the discount can be applied.
+        List all discounts for your Organization and usable categories, products, offers, references, regions and zones where the discount can be applied. As a reseller:
+        - If you do not specify an `organization_id` you will list the discounts applied to your own Organization and your customers
+        - If you indicate your `organization_id` you will list only the discounts applied to your Organization
+        - If you indicate `the organization_id` of one of your customers, you will list the discounts applied to their Organization.
         :param order_by: Order discounts in the response by their description.
         :param page: Positive integer to choose the page to return.
         :param page_size: Positive integer lower or equal to 100 to select the number of items to return.
@@ -476,7 +479,10 @@ def list_discounts_all(
     ) -> List[Discount]:
         """
         List discounts.
-        List all discounts for your organization and usable categories, products, offers, references, regions and zones where the discount can be applied.
+        List all discounts for your Organization and usable categories, products, offers, references, regions and zones where the discount can be applied. As a reseller:
+        - If you do not specify an `organization_id` you will list the discounts applied to your own Organization and your customers
+        - If you indicate your `organization_id` you will list only the discounts applied to your Organization
+        - If you indicate `the organization_id` of one of your customers, you will list the discounts applied to their Organization.
         :param order_by: Order discounts in the response by their description.
         :param page: Positive integer to choose the page to return.
         :param page_size: Positive integer lower or equal to 100 to select the number of items to return.

scaleway/scaleway/billing/v2beta1/types.py

@@ -211,7 +211,7 @@ class Discount:
 
     organization_id: str
     """
-    The organization ID of the discount.
+    The Organization ID of the discount.
     """
 
     description: str