Skip to content

Commit 7f75fbf

Browse files
authored
docs(cockpit): update documentation (#77)
1 parent 052cb88 commit 7f75fbf

File tree

4 files changed

+68
-68
lines changed

4 files changed

+68
-68
lines changed

scaleway-async/scaleway_async/cockpit/v1beta1/api.py

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -382,8 +382,8 @@ async def create_contact_point(
382382
) -> ContactPoint:
383383
"""
384384
Create an alert contact point for the default receiver.
385-
:param project_id: Project ID
386-
:param contact_point: Contact point to create
385+
:param project_id: Project ID.
386+
:param contact_point: Contact point to create.
387387
:return: :class:`ContactPoint <ContactPoint>`
388388
389389
Usage:
@@ -416,9 +416,9 @@ async def list_contact_points(
416416
) -> ListContactPointsResponse:
417417
"""
418418
List alert contact points associated with the given cockpit ID.
419-
:param page: Page number
420-
:param page_size: Page size
421-
:param project_id: Project ID
419+
:param page: Page number.
420+
:param page_size: Page size.
421+
:param project_id: Project ID.
422422
:return: :class:`ListContactPointsResponse <ListContactPointsResponse>`
423423
424424
Usage:
@@ -449,9 +449,9 @@ async def list_contact_points_all(
449449
) -> List[ContactPoint]:
450450
"""
451451
List alert contact points associated with the given cockpit ID.
452-
:param page: Page number
453-
:param page_size: Page size
454-
:param project_id: Project ID
452+
:param page: Page number.
453+
:param page_size: Page size.
454+
:param project_id: Project ID.
455455
:return: :class:`List[ListContactPointsResponse] <List[ListContactPointsResponse]>`
456456
457457
Usage:
@@ -480,7 +480,7 @@ async def delete_contact_point(
480480
"""
481481
Delete an alert contact point for the default receiver.
482482
:param project_id:
483-
:param contact_point: Contact point to delete
483+
:param contact_point: Contact point to delete.
484484
485485
Usage:
486486
::

scaleway-async/scaleway_async/cockpit/v1beta1/types.py

Lines changed: 25 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -50,44 +50,44 @@ def __str__(self) -> str:
5050
@dataclass
5151
class Cockpit:
5252
"""
53-
Cockpit
53+
Cockpit.
5454
"""
5555

5656
project_id: str
5757
"""
58-
Project ID
58+
Project ID.
5959
"""
6060

6161
created_at: Optional[datetime]
6262
"""
63-
Created at
63+
Created at.
6464
"""
6565

6666
updated_at: Optional[datetime]
6767
"""
68-
Updated at
68+
Updated at.
6969
"""
7070

7171
endpoints: Optional[CockpitEndpoints]
7272
"""
73-
Endpoints
73+
Endpoints.
7474
"""
7575

7676
status: CockpitStatus
7777
"""
78-
Status
78+
Status.
7979
"""
8080

8181
managed_alerts_enabled: bool
8282
"""
83-
Managed alerts enabled
83+
Managed alerts enabled.
8484
"""
8585

8686

8787
@dataclass
8888
class CockpitEndpoints:
8989
"""
90-
Cockpit. endpoints
90+
Cockpit. endpoints.
9191
"""
9292

9393
metrics_url: str
@@ -102,7 +102,7 @@ class CockpitEndpoints:
102102
@dataclass
103103
class ContactPoint:
104104
"""
105-
Alert contact point
105+
Alert contact point.
106106
"""
107107

108108
email: Optional[ContactPointEmail]
@@ -121,7 +121,7 @@ class ContactPointEmail:
121121
@dataclass
122122
class GrafanaUser:
123123
"""
124-
Grafana user
124+
Grafana user.
125125
"""
126126

127127
id: int
@@ -136,34 +136,34 @@ class GrafanaUser:
136136
@dataclass
137137
class ListContactPointsResponse:
138138
"""
139-
List contact points response
139+
List contact points response.
140140
"""
141141

142142
total_count: int
143143
"""
144-
Total count of contact points
144+
Total count of contact points.
145145
"""
146146

147147
contact_points: List[ContactPoint]
148148
"""
149-
Contact points array
149+
Contact points array.
150150
"""
151151

152152
has_additional_receivers: bool
153153
"""
154-
Has receivers other than default
154+
Has receivers other than default.
155155
"""
156156

157157
has_additional_contact_points: bool
158158
"""
159-
Has unmanaged contact points
159+
Has unmanaged contact points.
160160
"""
161161

162162

163163
@dataclass
164164
class ListGrafanaUsersResponse:
165165
"""
166-
List grafana users response
166+
List grafana users response.
167167
"""
168168

169169
total_count: int
@@ -174,7 +174,7 @@ class ListGrafanaUsersResponse:
174174
@dataclass
175175
class ListTokensResponse:
176176
"""
177-
List tokens response
177+
List tokens response.
178178
"""
179179

180180
total_count: int
@@ -185,7 +185,7 @@ class ListTokensResponse:
185185
@dataclass
186186
class Token:
187187
"""
188-
Token
188+
Token.
189189
"""
190190

191191
id: str
@@ -206,7 +206,7 @@ class Token:
206206
@dataclass
207207
class TokenScopes:
208208
"""
209-
Token scopes
209+
Token scopes.
210210
"""
211211

212212
query_metrics: bool
@@ -278,30 +278,30 @@ class DeleteTokenRequest:
278278
class CreateContactPointRequest:
279279
project_id: Optional[str]
280280
"""
281-
Project ID
281+
Project ID.
282282
"""
283283

284284
contact_point: Optional[ContactPoint]
285285
"""
286-
Contact point to create
286+
Contact point to create.
287287
"""
288288

289289

290290
@dataclass
291291
class ListContactPointsRequest:
292292
page: Optional[int]
293293
"""
294-
Page number
294+
Page number.
295295
"""
296296

297297
page_size: Optional[int]
298298
"""
299-
Page size
299+
Page size.
300300
"""
301301

302302
project_id: Optional[str]
303303
"""
304-
Project ID
304+
Project ID.
305305
"""
306306

307307

@@ -311,7 +311,7 @@ class DeleteContactPointRequest:
311311

312312
contact_point: Optional[ContactPoint]
313313
"""
314-
Contact point to delete
314+
Contact point to delete.
315315
"""
316316

317317

scaleway/scaleway/cockpit/v1beta1/api.py

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -382,8 +382,8 @@ def create_contact_point(
382382
) -> ContactPoint:
383383
"""
384384
Create an alert contact point for the default receiver.
385-
:param project_id: Project ID
386-
:param contact_point: Contact point to create
385+
:param project_id: Project ID.
386+
:param contact_point: Contact point to create.
387387
:return: :class:`ContactPoint <ContactPoint>`
388388
389389
Usage:
@@ -416,9 +416,9 @@ def list_contact_points(
416416
) -> ListContactPointsResponse:
417417
"""
418418
List alert contact points associated with the given cockpit ID.
419-
:param page: Page number
420-
:param page_size: Page size
421-
:param project_id: Project ID
419+
:param page: Page number.
420+
:param page_size: Page size.
421+
:param project_id: Project ID.
422422
:return: :class:`ListContactPointsResponse <ListContactPointsResponse>`
423423
424424
Usage:
@@ -449,9 +449,9 @@ def list_contact_points_all(
449449
) -> List[ContactPoint]:
450450
"""
451451
List alert contact points associated with the given cockpit ID.
452-
:param page: Page number
453-
:param page_size: Page size
454-
:param project_id: Project ID
452+
:param page: Page number.
453+
:param page_size: Page size.
454+
:param project_id: Project ID.
455455
:return: :class:`List[ListContactPointsResponse] <List[ListContactPointsResponse]>`
456456
457457
Usage:
@@ -480,7 +480,7 @@ def delete_contact_point(
480480
"""
481481
Delete an alert contact point for the default receiver.
482482
:param project_id:
483-
:param contact_point: Contact point to delete
483+
:param contact_point: Contact point to delete.
484484
485485
Usage:
486486
::

0 commit comments

Comments
 (0)