Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 10 additions & 15 deletions scaleway-async/scaleway_async/cockpit/v1/api.py
Original file line number Diff line number Diff line change
Expand Up @@ -633,16 +633,13 @@ async def create_data_source(
) -> DataSource:
"""
Create a data source.
You must specify the data source type upon creation. Available data source types include:
- metrics
- logs
- traces
You must specify the data source name and type (metrics, logs, traces) upon creation.
The name of the data source will then be used as reference to name the associated Grafana data source.
:param name: Data source name.
:param region: Region to target. If none is passed will use default region from the config.
:param project_id: ID of the Project the data source belongs to.
:param type_: Data source type.
:param retention_days: Default values are 30 days for metrics, 7 days for logs and traces.
:param retention_days: Default values are 31 days for metrics, 7 days for logs and traces.
:return: :class:`DataSource <DataSource>`

Usage:
Expand Down Expand Up @@ -717,7 +714,7 @@ async def delete_data_source(
) -> None:
"""
Delete a data source.
Delete a given data source, specified by the data source ID. Note that deleting a data source is irreversible, and cannot be undone.
Delete a given data source. Note that this action will permanently delete this data source and any data associated with it.
:param data_source_id: ID of the data source to delete.
:param region: Region to target. If none is passed will use default region from the config.

Expand Down Expand Up @@ -755,14 +752,13 @@ async def list_data_sources(
"""
List data sources.
Retrieve the list of data sources available in the specified region. By default, the data sources returned in the list are ordered by creation date, in ascending order.
You can list data sources by Project, type and origin.
:param region: Region to target. If none is passed will use default region from the config.
:param page: Page number to return, from the paginated results.
:param page_size: Number of data sources to return per page.
:param order_by: Sort order for data sources in the response.
:param project_id: Project ID to filter for, only data sources from this Project will be returned.
:param origin: Origin to filter for, only data sources with matching origin will be returned.
:param types: Types to filter for, only data sources with matching types will be returned.
:param origin: Origin to filter for, only data sources with matching origin will be returned. If omitted, all types will be returned.
:param types: Types to filter for (metrics, logs, traces), only data sources with matching types will be returned. If omitted, all types will be returned.
:return: :class:`ListDataSourcesResponse <ListDataSourcesResponse>`

Usage:
Expand Down Expand Up @@ -805,14 +801,13 @@ async def list_data_sources_all(
"""
List data sources.
Retrieve the list of data sources available in the specified region. By default, the data sources returned in the list are ordered by creation date, in ascending order.
You can list data sources by Project, type and origin.
:param region: Region to target. If none is passed will use default region from the config.
:param page: Page number to return, from the paginated results.
:param page_size: Number of data sources to return per page.
:param order_by: Sort order for data sources in the response.
:param project_id: Project ID to filter for, only data sources from this Project will be returned.
:param origin: Origin to filter for, only data sources with matching origin will be returned.
:param types: Types to filter for, only data sources with matching types will be returned.
:param origin: Origin to filter for, only data sources with matching origin will be returned. If omitted, all types will be returned.
:param types: Types to filter for (metrics, logs, traces), only data sources with matching types will be returned. If omitted, all types will be returned.
:return: :class:`List[DataSource] <List[DataSource]>`

Usage:
Expand Down Expand Up @@ -846,11 +841,11 @@ async def update_data_source(
) -> DataSource:
"""
Update a data source.
Update a given data source name, specified by the data source ID.
Update a given data source attributes (name and/or retention_days).
:param data_source_id: ID of the data source to update.
:param region: Region to target. If none is passed will use default region from the config.
:param name: Updated name of the data source.
:param retention_days: BETA - Duration for which the data will be retained in the data source.
:param retention_days: Duration for which the data will be retained in the data source.
:return: :class:`DataSource <DataSource>`

Usage:
Expand Down Expand Up @@ -892,7 +887,7 @@ async def get_usage_overview(
) -> UsageOverview:
"""
Get data source usage overview.
Retrieve the data source usage overview per type for the specified Project.
Retrieve the volume of data ingested for each of your data sources in the specified project and region.
:param region: Region to target. If none is passed will use default region from the config.
:param project_id:
:param interval:
Expand Down
10 changes: 5 additions & 5 deletions scaleway-async/scaleway_async/cockpit/v1/types.py
Original file line number Diff line number Diff line change
Expand Up @@ -292,7 +292,7 @@ class DataSource:

retention_days: int
"""
BETA - Duration for which the data will be retained in the data source.
Duration for which the data will be retained in the data source.
"""

region: ScwRegion
Expand Down Expand Up @@ -986,7 +986,7 @@ class RegionalApiCreateDataSourceRequest:

retention_days: Optional[int]
"""
Default values are 30 days for metrics, 7 days for logs and traces.
Default values are 31 days for metrics, 7 days for logs and traces.
"""


Expand Down Expand Up @@ -1346,12 +1346,12 @@ class RegionalApiListDataSourcesRequest:

origin: Optional[DataSourceOrigin]
"""
Origin to filter for, only data sources with matching origin will be returned.
Origin to filter for, only data sources with matching origin will be returned. If omitted, all types will be returned.
"""

types: Optional[List[DataSourceType]]
"""
Types to filter for, only data sources with matching types will be returned.
Types to filter for (metrics, logs, traces), only data sources with matching types will be returned. If omitted, all types will be returned.
"""


Expand Down Expand Up @@ -1456,7 +1456,7 @@ class RegionalApiUpdateDataSourceRequest:

retention_days: Optional[int]
"""
BETA - Duration for which the data will be retained in the data source.
Duration for which the data will be retained in the data source.
"""


Expand Down
25 changes: 10 additions & 15 deletions scaleway/scaleway/cockpit/v1/api.py
Original file line number Diff line number Diff line change
Expand Up @@ -633,16 +633,13 @@ def create_data_source(
) -> DataSource:
"""
Create a data source.
You must specify the data source type upon creation. Available data source types include:
- metrics
- logs
- traces
You must specify the data source name and type (metrics, logs, traces) upon creation.
The name of the data source will then be used as reference to name the associated Grafana data source.
:param name: Data source name.
:param region: Region to target. If none is passed will use default region from the config.
:param project_id: ID of the Project the data source belongs to.
:param type_: Data source type.
:param retention_days: Default values are 30 days for metrics, 7 days for logs and traces.
:param retention_days: Default values are 31 days for metrics, 7 days for logs and traces.
:return: :class:`DataSource <DataSource>`

Usage:
Expand Down Expand Up @@ -717,7 +714,7 @@ def delete_data_source(
) -> None:
"""
Delete a data source.
Delete a given data source, specified by the data source ID. Note that deleting a data source is irreversible, and cannot be undone.
Delete a given data source. Note that this action will permanently delete this data source and any data associated with it.
:param data_source_id: ID of the data source to delete.
:param region: Region to target. If none is passed will use default region from the config.

Expand Down Expand Up @@ -755,14 +752,13 @@ def list_data_sources(
"""
List data sources.
Retrieve the list of data sources available in the specified region. By default, the data sources returned in the list are ordered by creation date, in ascending order.
You can list data sources by Project, type and origin.
:param region: Region to target. If none is passed will use default region from the config.
:param page: Page number to return, from the paginated results.
:param page_size: Number of data sources to return per page.
:param order_by: Sort order for data sources in the response.
:param project_id: Project ID to filter for, only data sources from this Project will be returned.
:param origin: Origin to filter for, only data sources with matching origin will be returned.
:param types: Types to filter for, only data sources with matching types will be returned.
:param origin: Origin to filter for, only data sources with matching origin will be returned. If omitted, all types will be returned.
:param types: Types to filter for (metrics, logs, traces), only data sources with matching types will be returned. If omitted, all types will be returned.
:return: :class:`ListDataSourcesResponse <ListDataSourcesResponse>`

Usage:
Expand Down Expand Up @@ -805,14 +801,13 @@ def list_data_sources_all(
"""
List data sources.
Retrieve the list of data sources available in the specified region. By default, the data sources returned in the list are ordered by creation date, in ascending order.
You can list data sources by Project, type and origin.
:param region: Region to target. If none is passed will use default region from the config.
:param page: Page number to return, from the paginated results.
:param page_size: Number of data sources to return per page.
:param order_by: Sort order for data sources in the response.
:param project_id: Project ID to filter for, only data sources from this Project will be returned.
:param origin: Origin to filter for, only data sources with matching origin will be returned.
:param types: Types to filter for, only data sources with matching types will be returned.
:param origin: Origin to filter for, only data sources with matching origin will be returned. If omitted, all types will be returned.
:param types: Types to filter for (metrics, logs, traces), only data sources with matching types will be returned. If omitted, all types will be returned.
:return: :class:`List[DataSource] <List[DataSource]>`

Usage:
Expand Down Expand Up @@ -846,11 +841,11 @@ def update_data_source(
) -> DataSource:
"""
Update a data source.
Update a given data source name, specified by the data source ID.
Update a given data source attributes (name and/or retention_days).
:param data_source_id: ID of the data source to update.
:param region: Region to target. If none is passed will use default region from the config.
:param name: Updated name of the data source.
:param retention_days: BETA - Duration for which the data will be retained in the data source.
:param retention_days: Duration for which the data will be retained in the data source.
:return: :class:`DataSource <DataSource>`

Usage:
Expand Down Expand Up @@ -892,7 +887,7 @@ def get_usage_overview(
) -> UsageOverview:
"""
Get data source usage overview.
Retrieve the data source usage overview per type for the specified Project.
Retrieve the volume of data ingested for each of your data sources in the specified project and region.
:param region: Region to target. If none is passed will use default region from the config.
:param project_id:
:param interval:
Expand Down
10 changes: 5 additions & 5 deletions scaleway/scaleway/cockpit/v1/types.py
Original file line number Diff line number Diff line change
Expand Up @@ -292,7 +292,7 @@ class DataSource:

retention_days: int
"""
BETA - Duration for which the data will be retained in the data source.
Duration for which the data will be retained in the data source.
"""

region: ScwRegion
Expand Down Expand Up @@ -986,7 +986,7 @@ class RegionalApiCreateDataSourceRequest:

retention_days: Optional[int]
"""
Default values are 30 days for metrics, 7 days for logs and traces.
Default values are 31 days for metrics, 7 days for logs and traces.
"""


Expand Down Expand Up @@ -1346,12 +1346,12 @@ class RegionalApiListDataSourcesRequest:

origin: Optional[DataSourceOrigin]
"""
Origin to filter for, only data sources with matching origin will be returned.
Origin to filter for, only data sources with matching origin will be returned. If omitted, all types will be returned.
"""

types: Optional[List[DataSourceType]]
"""
Types to filter for, only data sources with matching types will be returned.
Types to filter for (metrics, logs, traces), only data sources with matching types will be returned. If omitted, all types will be returned.
"""


Expand Down Expand Up @@ -1456,7 +1456,7 @@ class RegionalApiUpdateDataSourceRequest:

retention_days: Optional[int]
"""
BETA - Duration for which the data will be retained in the data source.
Duration for which the data will be retained in the data source.
"""


Expand Down