Skip to content

Commit 653b711

Browse files
authored
docs(serverless): containers documentation improvements (#85)
1 parent 8218c69 commit 653b711

File tree

4 files changed

+162
-172
lines changed

4 files changed

+162
-172
lines changed

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

Lines changed: 38 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -99,7 +99,7 @@ async def list_namespaces(
9999
) -> ListNamespacesResponse:
100100
"""
101101
List all your namespaces
102-
:param region: Region to target. If none is passed will use default region from the config
102+
:param region: Region to target. If none is passed will use default region from the config.
103103
:param page:
104104
:param page_size:
105105
:param order_by:
@@ -148,7 +148,7 @@ async def list_namespaces_all(
148148
) -> List[Namespace]:
149149
"""
150150
List all your namespaces
151-
:param region: Region to target. If none is passed will use default region from the config
151+
:param region: Region to target. If none is passed will use default region from the config.
152152
:param page:
153153
:param page_size:
154154
:param order_by:
@@ -186,7 +186,7 @@ async def get_namespace(
186186
) -> Namespace:
187187
"""
188188
Get the namespace associated with the given id.
189-
:param region: Region to target. If none is passed will use default region from the config
189+
:param region: Region to target. If none is passed will use default region from the config.
190190
:param namespace_id:
191191
:return: :class:`Namespace <Namespace>`
192192
@@ -220,7 +220,7 @@ async def wait_for_namespace(
220220
) -> Namespace:
221221
"""
222222
Waits for :class:`Namespace <Namespace>` to be in a final state.
223-
:param region: Region to target. If none is passed will use default region from the config
223+
:param region: Region to target. If none is passed will use default region from the config.
224224
:param namespace_id:
225225
:param options: The options for the waiter
226226
:return: :class:`Namespace <Namespace>`
@@ -258,7 +258,7 @@ async def create_namespace(
258258
) -> Namespace:
259259
"""
260260
Create a new namespace
261-
:param region: Region to target. If none is passed will use default region from the config
261+
:param region: Region to target. If none is passed will use default region from the config.
262262
:param name:
263263
:param environment_variables:
264264
:param project_id:
@@ -306,7 +306,7 @@ async def update_namespace(
306306
) -> Namespace:
307307
"""
308308
Update the space associated with the given id.
309-
:param region: Region to target. If none is passed will use default region from the config
309+
:param region: Region to target. If none is passed will use default region from the config.
310310
:param namespace_id:
311311
:param environment_variables:
312312
:param description:
@@ -350,7 +350,7 @@ async def delete_namespace(
350350
) -> Namespace:
351351
"""
352352
Delete the namespace associated with the given id.
353-
:param region: Region to target. If none is passed will use default region from the config
353+
:param region: Region to target. If none is passed will use default region from the config.
354354
:param namespace_id:
355355
:return: :class:`Namespace <Namespace>`
356356
@@ -387,7 +387,7 @@ async def list_containers(
387387
) -> ListContainersResponse:
388388
"""
389389
List all your containers
390-
:param region: Region to target. If none is passed will use default region from the config
390+
:param region: Region to target. If none is passed will use default region from the config.
391391
:param page:
392392
:param page_size:
393393
:param order_by:
@@ -439,7 +439,7 @@ async def list_containers_all(
439439
) -> List[Container]:
440440
"""
441441
List all your containers
442-
:param region: Region to target. If none is passed will use default region from the config
442+
:param region: Region to target. If none is passed will use default region from the config.
443443
:param page:
444444
:param page_size:
445445
:param order_by:
@@ -479,7 +479,7 @@ async def get_container(
479479
) -> Container:
480480
"""
481481
Get the container associated with the given id.
482-
:param region: Region to target. If none is passed will use default region from the config
482+
:param region: Region to target. If none is passed will use default region from the config.
483483
:param container_id:
484484
:return: :class:`Container <Container>`
485485
@@ -513,7 +513,7 @@ async def wait_for_container(
513513
) -> Container:
514514
"""
515515
Waits for :class:`Container <Container>` to be in a final state.
516-
:param region: Region to target. If none is passed will use default region from the config
516+
:param region: Region to target. If none is passed will use default region from the config.
517517
:param container_id:
518518
:param options: The options for the waiter
519519
:return: :class:`Container <Container>`
@@ -561,7 +561,7 @@ async def create_container(
561561
) -> Container:
562562
"""
563563
Create a new container
564-
:param region: Region to target. If none is passed will use default region from the config
564+
:param region: Region to target. If none is passed will use default region from the config.
565565
:param namespace_id:
566566
:param name:
567567
:param environment_variables:
@@ -576,10 +576,9 @@ async def create_container(
576576
:param protocol:
577577
:param port:
578578
:param secret_environment_variables:
579-
:param http_option: possible values:
579+
:param http_option: Possible values:
580580
- redirected: Responds to HTTP request with a 301 redirect to ask the clients to use HTTPS.
581581
- enabled: Serve both HTTP and HTTPS traffic.
582-
583582
:return: :class:`Container <Container>`
584583
585584
Usage:
@@ -648,7 +647,7 @@ async def update_container(
648647
) -> Container:
649648
"""
650649
Update the container associated with the given id.
651-
:param region: Region to target. If none is passed will use default region from the config
650+
:param region: Region to target. If none is passed will use default region from the config.
652651
:param container_id:
653652
:param environment_variables:
654653
:param min_scale:
@@ -663,10 +662,9 @@ async def update_container(
663662
:param protocol:
664663
:param port:
665664
:param secret_environment_variables:
666-
:param http_option: possible values:
665+
:param http_option: Possible values:
667666
- redirected: Responds to HTTP request with a 301 redirect to ask the clients to use HTTPS.
668667
- enabled: Serve both HTTP and HTTPS traffic.
669-
670668
:return: :class:`Container <Container>`
671669
672670
Usage:
@@ -722,7 +720,7 @@ async def delete_container(
722720
) -> Container:
723721
"""
724722
Delete the container associated with the given id.
725-
:param region: Region to target. If none is passed will use default region from the config
723+
:param region: Region to target. If none is passed will use default region from the config.
726724
:param container_id:
727725
:return: :class:`Container <Container>`
728726
@@ -753,7 +751,7 @@ async def deploy_container(
753751
) -> Container:
754752
"""
755753
Deploy a container associated with the given id.
756-
:param region: Region to target. If none is passed will use default region from the config
754+
:param region: Region to target. If none is passed will use default region from the config.
757755
:param container_id:
758756
:return: :class:`Container <Container>`
759757
@@ -787,7 +785,7 @@ async def list_crons(
787785
) -> ListCronsResponse:
788786
"""
789787
List all your crons
790-
:param region: Region to target. If none is passed will use default region from the config
788+
:param region: Region to target. If none is passed will use default region from the config.
791789
:param page:
792790
:param page_size:
793791
:param order_by:
@@ -829,7 +827,7 @@ async def list_crons_all(
829827
) -> List[Cron]:
830828
"""
831829
List all your crons
832-
:param region: Region to target. If none is passed will use default region from the config
830+
:param region: Region to target. If none is passed will use default region from the config.
833831
:param page:
834832
:param page_size:
835833
:param order_by:
@@ -863,7 +861,7 @@ async def get_cron(
863861
) -> Cron:
864862
"""
865863
Get the cron associated with the given id.
866-
:param region: Region to target. If none is passed will use default region from the config
864+
:param region: Region to target. If none is passed will use default region from the config.
867865
:param cron_id:
868866
:return: :class:`Cron <Cron>`
869867
@@ -895,7 +893,7 @@ async def wait_for_cron(
895893
) -> Cron:
896894
"""
897895
Waits for :class:`Cron <Cron>` to be in a final state.
898-
:param region: Region to target. If none is passed will use default region from the config
896+
:param region: Region to target. If none is passed will use default region from the config.
899897
:param cron_id:
900898
:param options: The options for the waiter
901899
:return: :class:`Cron <Cron>`
@@ -932,7 +930,7 @@ async def create_cron(
932930
) -> Cron:
933931
"""
934932
Create a new cron
935-
:param region: Region to target. If none is passed will use default region from the config
933+
:param region: Region to target. If none is passed will use default region from the config.
936934
:param container_id:
937935
:param schedule:
938936
:param args:
@@ -982,7 +980,7 @@ async def update_cron(
982980
) -> Cron:
983981
"""
984982
Update the cron associated with the given id.
985-
:param region: Region to target. If none is passed will use default region from the config
983+
:param region: Region to target. If none is passed will use default region from the config.
986984
:param cron_id:
987985
:param container_id:
988986
:param schedule:
@@ -1028,7 +1026,7 @@ async def delete_cron(
10281026
) -> Cron:
10291027
"""
10301028
Delete the cron associated with the given id.
1031-
:param region: Region to target. If none is passed will use default region from the config
1029+
:param region: Region to target. If none is passed will use default region from the config.
10321030
:param cron_id:
10331031
:return: :class:`Cron <Cron>`
10341032
@@ -1062,7 +1060,7 @@ async def list_logs(
10621060
) -> ListLogsResponse:
10631061
"""
10641062
List your container logs
1065-
:param region: Region to target. If none is passed will use default region from the config
1063+
:param region: Region to target. If none is passed will use default region from the config.
10661064
:param container_id:
10671065
:param page:
10681066
:param page_size:
@@ -1104,7 +1102,7 @@ async def list_logs_all(
11041102
) -> List[Log]:
11051103
"""
11061104
List your container logs
1107-
:param region: Region to target. If none is passed will use default region from the config
1105+
:param region: Region to target. If none is passed will use default region from the config.
11081106
:param container_id:
11091107
:param page:
11101108
:param page_size:
@@ -1141,7 +1139,7 @@ async def list_domains(
11411139
) -> ListDomainsResponse:
11421140
"""
11431141
List all domain name bindings
1144-
:param region: Region to target. If none is passed will use default region from the config
1142+
:param region: Region to target. If none is passed will use default region from the config.
11451143
:param page:
11461144
:param page_size:
11471145
:param order_by:
@@ -1183,7 +1181,7 @@ async def list_domains_all(
11831181
) -> List[Domain]:
11841182
"""
11851183
List all domain name bindings
1186-
:param region: Region to target. If none is passed will use default region from the config
1184+
:param region: Region to target. If none is passed will use default region from the config.
11871185
:param page:
11881186
:param page_size:
11891187
:param order_by:
@@ -1217,7 +1215,7 @@ async def get_domain(
12171215
) -> Domain:
12181216
"""
12191217
Get a domain name binding
1220-
:param region: Region to target. If none is passed will use default region from the config
1218+
:param region: Region to target. If none is passed will use default region from the config.
12211219
:param domain_id:
12221220
:return: :class:`Domain <Domain>`
12231221
@@ -1249,7 +1247,7 @@ async def wait_for_domain(
12491247
) -> Domain:
12501248
"""
12511249
Waits for :class:`Domain <Domain>` to be in a final state.
1252-
:param region: Region to target. If none is passed will use default region from the config
1250+
:param region: Region to target. If none is passed will use default region from the config.
12531251
:param domain_id:
12541252
:param options: The options for the waiter
12551253
:return: :class:`Domain <Domain>`
@@ -1284,7 +1282,7 @@ async def create_domain(
12841282
) -> Domain:
12851283
"""
12861284
Create a domain name binding
1287-
:param region: Region to target. If none is passed will use default region from the config
1285+
:param region: Region to target. If none is passed will use default region from the config.
12881286
:param hostname:
12891287
:param container_id:
12901288
:return: :class:`Domain <Domain>`
@@ -1326,7 +1324,7 @@ async def delete_domain(
13261324
) -> Domain:
13271325
"""
13281326
Delete a domain name binding
1329-
:param region: Region to target. If none is passed will use default region from the config
1327+
:param region: Region to target. If none is passed will use default region from the config.
13301328
:param domain_id:
13311329
:return: :class:`Domain <Domain>`
13321330
@@ -1398,7 +1396,7 @@ async def create_token(
13981396
) -> Token:
13991397
"""
14001398
Create a new revocable token
1401-
:param region: Region to target. If none is passed will use default region from the config
1399+
:param region: Region to target. If none is passed will use default region from the config.
14021400
:param container_id: One-of ('scope'): at most one of 'container_id', 'namespace_id' could be set.
14031401
:param namespace_id: One-of ('scope'): at most one of 'container_id', 'namespace_id' could be set.
14041402
:param description:
@@ -1441,7 +1439,7 @@ async def get_token(
14411439
) -> Token:
14421440
"""
14431441
Get a token
1444-
:param region: Region to target. If none is passed will use default region from the config
1442+
:param region: Region to target. If none is passed will use default region from the config.
14451443
:param token_id:
14461444
:return: :class:`Token <Token>`
14471445
@@ -1473,7 +1471,7 @@ async def wait_for_token(
14731471
) -> Token:
14741472
"""
14751473
Waits for :class:`Token <Token>` to be in a final state.
1476-
:param region: Region to target. If none is passed will use default region from the config
1474+
:param region: Region to target. If none is passed will use default region from the config.
14771475
:param token_id:
14781476
:param options: The options for the waiter
14791477
:return: :class:`Token <Token>`
@@ -1511,7 +1509,7 @@ async def list_tokens(
15111509
) -> ListTokensResponse:
15121510
"""
15131511
List all tokens
1514-
:param region: Region to target. If none is passed will use default region from the config
1512+
:param region: Region to target. If none is passed will use default region from the config.
15151513
:param page:
15161514
:param page_size:
15171515
:param order_by:
@@ -1556,7 +1554,7 @@ async def list_tokens_all(
15561554
) -> List[Token]:
15571555
"""
15581556
List all tokens
1559-
:param region: Region to target. If none is passed will use default region from the config
1557+
:param region: Region to target. If none is passed will use default region from the config.
15601558
:param page:
15611559
:param page_size:
15621560
:param order_by:
@@ -1592,7 +1590,7 @@ async def delete_token(
15921590
) -> Token:
15931591
"""
15941592
Delete a token
1595-
:param region: Region to target. If none is passed will use default region from the config
1593+
:param region: Region to target. If none is passed will use default region from the config.
15961594
:param token_id:
15971595
:return: :class:`Token <Token>`
15981596

0 commit comments

Comments
 (0)