gcore 0.3.0__py3-none-any.whl → 0.4.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of gcore might be problematic. Click here for more details.

Files changed (120) hide show
  1. gcore/__init__.py +2 -1
  2. gcore/_base_client.py +22 -0
  3. gcore/_client.py +9 -0
  4. gcore/_version.py +1 -1
  5. gcore/pagination.py +61 -1
  6. gcore/resources/__init__.py +14 -0
  7. gcore/resources/cloud/baremetal/flavors.py +11 -137
  8. gcore/resources/cloud/baremetal/images.py +10 -12
  9. gcore/resources/cloud/baremetal/servers.py +31 -28
  10. gcore/resources/cloud/billing_reservations.py +2 -2
  11. gcore/resources/cloud/file_shares/file_shares.py +7 -8
  12. gcore/resources/cloud/floating_ips.py +7 -12
  13. gcore/resources/cloud/gpu_baremetal_clusters/gpu_baremetal_clusters.py +31 -20
  14. gcore/resources/cloud/gpu_baremetal_clusters/images.py +9 -10
  15. gcore/resources/cloud/gpu_baremetal_clusters/interfaces.py +2 -2
  16. gcore/resources/cloud/gpu_baremetal_clusters/servers.py +8 -4
  17. gcore/resources/cloud/inference/deployments/deployments.py +10 -2
  18. gcore/resources/cloud/inference/registry_credentials.py +2 -2
  19. gcore/resources/cloud/inference/secrets.py +8 -8
  20. gcore/resources/cloud/instances/flavors.py +9 -233
  21. gcore/resources/cloud/instances/images.py +47 -37
  22. gcore/resources/cloud/instances/instances.py +47 -32
  23. gcore/resources/cloud/instances/interfaces.py +2 -2
  24. gcore/resources/cloud/ip_ranges.py +34 -2
  25. gcore/resources/cloud/load_balancers/l7_policies/l7_policies.py +10 -2
  26. gcore/resources/cloud/load_balancers/listeners.py +17 -8
  27. gcore/resources/cloud/load_balancers/load_balancers.py +73 -21
  28. gcore/resources/cloud/load_balancers/metrics.py +2 -2
  29. gcore/resources/cloud/load_balancers/pools/health_monitors.py +2 -2
  30. gcore/resources/cloud/load_balancers/pools/members.py +6 -2
  31. gcore/resources/cloud/networks/networks.py +81 -17
  32. gcore/resources/cloud/networks/routers.py +18 -18
  33. gcore/resources/cloud/networks/subnets.py +51 -11
  34. gcore/resources/cloud/projects.py +38 -24
  35. gcore/resources/cloud/quotas/quotas.py +6 -6
  36. gcore/resources/cloud/quotas/requests.py +8 -8
  37. gcore/resources/cloud/registries/artifacts.py +4 -4
  38. gcore/resources/cloud/registries/registries.py +14 -16
  39. gcore/resources/cloud/registries/repositories.py +4 -4
  40. gcore/resources/cloud/registries/tags.py +2 -2
  41. gcore/resources/cloud/registries/users.py +21 -22
  42. gcore/resources/cloud/reserved_fixed_ips/reserved_fixed_ips.py +20 -20
  43. gcore/resources/cloud/reserved_fixed_ips/vip.py +10 -10
  44. gcore/resources/cloud/security_groups/rules.py +6 -6
  45. gcore/resources/cloud/security_groups/security_groups.py +70 -31
  46. gcore/resources/cloud/tasks.py +4 -4
  47. gcore/resources/cloud/users/role_assignments.py +12 -14
  48. gcore/resources/cloud/volumes.py +139 -49
  49. gcore/resources/iam/__init__.py +47 -0
  50. gcore/resources/iam/api_tokens.py +521 -0
  51. gcore/resources/iam/iam.py +199 -0
  52. gcore/resources/iam/users.py +642 -0
  53. gcore/resources/waap/__init__.py +0 -14
  54. gcore/resources/waap/waap.py +0 -32
  55. gcore/types/cloud/baremetal/__init__.py +0 -1
  56. gcore/types/cloud/baremetal/image_list_params.py +1 -5
  57. gcore/types/cloud/baremetal/server_create_params.py +4 -8
  58. gcore/types/cloud/baremetal/server_list_params.py +1 -5
  59. gcore/types/cloud/ddos_profile.py +9 -3
  60. gcore/types/cloud/file_share_create_params.py +3 -5
  61. gcore/types/cloud/floating_ip_create_params.py +2 -4
  62. gcore/types/cloud/floating_ip_list_params.py +1 -5
  63. gcore/types/cloud/gpu_baremetal_cluster_create_params.py +2 -3
  64. gcore/types/cloud/gpu_baremetal_clusters/image_upload_params.py +2 -4
  65. gcore/types/cloud/health_monitor.py +6 -1
  66. gcore/types/cloud/instance_create_params.py +7 -8
  67. gcore/types/cloud/instance_list_params.py +1 -5
  68. gcore/types/cloud/instances/__init__.py +0 -2
  69. gcore/types/cloud/instances/image_create_from_volume_params.py +2 -4
  70. gcore/types/cloud/instances/image_list_params.py +1 -5
  71. gcore/types/cloud/instances/image_upload_params.py +2 -4
  72. gcore/types/cloud/load_balancer_create_params.py +8 -4
  73. gcore/types/cloud/load_balancer_list_params.py +1 -5
  74. gcore/types/cloud/load_balancer_update_params.py +24 -0
  75. gcore/types/cloud/load_balancers/pool_create_params.py +6 -1
  76. gcore/types/cloud/load_balancers/pool_update_params.py +6 -1
  77. gcore/types/cloud/load_balancers/pools/member_add_params.py +6 -1
  78. gcore/types/cloud/member.py +6 -1
  79. gcore/types/cloud/network_create_params.py +2 -3
  80. gcore/types/cloud/network_list_params.py +4 -5
  81. gcore/types/cloud/network_update_params.py +28 -2
  82. gcore/types/cloud/networks/router_list_params.py +2 -2
  83. gcore/types/cloud/networks/subnet_create_params.py +2 -3
  84. gcore/types/cloud/networks/subnet_list_params.py +1 -5
  85. gcore/types/cloud/networks/subnet_update_params.py +25 -0
  86. gcore/types/cloud/registries/__init__.py +1 -0
  87. gcore/types/cloud/registries/user_refresh_secret_response.py +31 -0
  88. gcore/types/cloud/reserved_fixed_ip_list_params.py +2 -2
  89. gcore/types/cloud/security_group_list_params.py +3 -7
  90. gcore/types/cloud/security_group_update_params.py +25 -0
  91. gcore/types/cloud/tag_update_map_param.py +2 -2
  92. gcore/types/cloud/volume_list_params.py +1 -5
  93. gcore/types/cloud/volume_update_params.py +29 -3
  94. gcore/types/iam/__init__.py +17 -0
  95. gcore/types/iam/account_overview.py +488 -0
  96. gcore/types/iam/api_token.py +78 -0
  97. gcore/types/iam/api_token_create.py +15 -0
  98. gcore/types/iam/api_token_create_params.py +42 -0
  99. gcore/types/iam/api_token_list.py +81 -0
  100. gcore/types/iam/api_token_list_params.py +41 -0
  101. gcore/types/iam/user.py +86 -0
  102. gcore/types/iam/user_detailed.py +104 -0
  103. gcore/types/iam/user_invite.py +15 -0
  104. gcore/types/iam/user_invite_params.py +37 -0
  105. gcore/types/iam/user_list_params.py +15 -0
  106. gcore/types/iam/user_update.py +104 -0
  107. gcore/types/iam/user_update_params.py +52 -0
  108. gcore/types/waap/__init__.py +0 -1
  109. gcore/types/waap/domains/custom_rule_create_params.py +7 -3
  110. gcore/types/waap/domains/custom_rule_update_params.py +7 -3
  111. gcore/types/waap/waap_custom_rule.py +7 -3
  112. {gcore-0.3.0.dist-info → gcore-0.4.0.dist-info}/METADATA +40 -3
  113. {gcore-0.3.0.dist-info → gcore-0.4.0.dist-info}/RECORD +115 -101
  114. gcore/resources/waap/clients.py +0 -135
  115. gcore/types/cloud/baremetal/flavor_list_suitable_params.py +0 -22
  116. gcore/types/cloud/instances/flavor_list_for_resize_params.py +0 -16
  117. gcore/types/cloud/instances/flavor_list_suitable_params.py +0 -59
  118. gcore/types/waap/client_me_response.py +0 -34
  119. {gcore-0.3.0.dist-info → gcore-0.4.0.dist-info}/WHEEL +0 -0
  120. {gcore-0.3.0.dist-info → gcore-0.4.0.dist-info}/licenses/LICENSE +0 -0
@@ -63,7 +63,7 @@ class QuotasResource(SyncAPIResource):
63
63
  extra_body: Body | None = None,
64
64
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
65
65
  ) -> QuotaGetAllResponse:
66
- """Get combined client quotas, regional and global."""
66
+ """Get combined client quotas, including both regional and global quotas."""
67
67
  return self._get(
68
68
  "/cloud/v2/client_quotas",
69
69
  options=make_request_options(
@@ -85,7 +85,7 @@ class QuotasResource(SyncAPIResource):
85
85
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
86
86
  ) -> QuotaGetByRegionResponse:
87
87
  """
88
- Get a quota by region
88
+ Get quotas for a specific region and client.
89
89
 
90
90
  Args:
91
91
  client_id: Client ID
@@ -122,7 +122,7 @@ class QuotasResource(SyncAPIResource):
122
122
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
123
123
  ) -> QuotaGetGlobalResponse:
124
124
  """
125
- Get global quota
125
+ Get global quotas for a specific client.
126
126
 
127
127
  Args:
128
128
  client_id: Client ID
@@ -178,7 +178,7 @@ class AsyncQuotasResource(AsyncAPIResource):
178
178
  extra_body: Body | None = None,
179
179
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
180
180
  ) -> QuotaGetAllResponse:
181
- """Get combined client quotas, regional and global."""
181
+ """Get combined client quotas, including both regional and global quotas."""
182
182
  return await self._get(
183
183
  "/cloud/v2/client_quotas",
184
184
  options=make_request_options(
@@ -200,7 +200,7 @@ class AsyncQuotasResource(AsyncAPIResource):
200
200
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
201
201
  ) -> QuotaGetByRegionResponse:
202
202
  """
203
- Get a quota by region
203
+ Get quotas for a specific region and client.
204
204
 
205
205
  Args:
206
206
  client_id: Client ID
@@ -237,7 +237,7 @@ class AsyncQuotasResource(AsyncAPIResource):
237
237
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
238
238
  ) -> QuotaGetGlobalResponse:
239
239
  """
240
- Get global quota
240
+ Get global quotas for a specific client.
241
241
 
242
242
  Args:
243
243
  client_id: Client ID
@@ -60,7 +60,7 @@ class RequestsResource(SyncAPIResource):
60
60
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
61
61
  ) -> None:
62
62
  """
63
- Create request to change quotas
63
+ Create a request to change current quotas.
64
64
 
65
65
  Args:
66
66
  description: Describe the reason, in general terms.
@@ -108,7 +108,7 @@ class RequestsResource(SyncAPIResource):
108
108
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
109
109
  ) -> SyncOffsetPage[RequestListResponse]:
110
110
  """
111
- Returns a list of sent requests to change current quotas and their statuses
111
+ Get a list of sent requests to change current quotas and their statuses.
112
112
 
113
113
  Args:
114
114
  limit: Optional. Limit the number of returned items
@@ -158,7 +158,7 @@ class RequestsResource(SyncAPIResource):
158
158
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
159
159
  ) -> None:
160
160
  """
161
- Delete request to change quotas
161
+ Delete a specific quota limit request.
162
162
 
163
163
  Args:
164
164
  request_id: LimitRequest ID
@@ -194,7 +194,7 @@ class RequestsResource(SyncAPIResource):
194
194
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
195
195
  ) -> RequestGetResponse:
196
196
  """
197
- Get request to change quota limits.
197
+ Get detailed information about a specific quota limit request.
198
198
 
199
199
  Args:
200
200
  request_id: LimitRequest ID
@@ -252,7 +252,7 @@ class AsyncRequestsResource(AsyncAPIResource):
252
252
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
253
253
  ) -> None:
254
254
  """
255
- Create request to change quotas
255
+ Create a request to change current quotas.
256
256
 
257
257
  Args:
258
258
  description: Describe the reason, in general terms.
@@ -300,7 +300,7 @@ class AsyncRequestsResource(AsyncAPIResource):
300
300
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
301
301
  ) -> AsyncPaginator[RequestListResponse, AsyncOffsetPage[RequestListResponse]]:
302
302
  """
303
- Returns a list of sent requests to change current quotas and their statuses
303
+ Get a list of sent requests to change current quotas and their statuses.
304
304
 
305
305
  Args:
306
306
  limit: Optional. Limit the number of returned items
@@ -350,7 +350,7 @@ class AsyncRequestsResource(AsyncAPIResource):
350
350
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
351
351
  ) -> None:
352
352
  """
353
- Delete request to change quotas
353
+ Delete a specific quota limit request.
354
354
 
355
355
  Args:
356
356
  request_id: LimitRequest ID
@@ -386,7 +386,7 @@ class AsyncRequestsResource(AsyncAPIResource):
386
386
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
387
387
  ) -> RequestGetResponse:
388
388
  """
389
- Get request to change quota limits.
389
+ Get detailed information about a specific quota limit request.
390
390
 
391
391
  Args:
392
392
  request_id: LimitRequest ID
@@ -54,7 +54,7 @@ class ArtifactsResource(SyncAPIResource):
54
54
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
55
55
  ) -> RegistryArtifactList:
56
56
  """
57
- List artifacts
57
+ List all artifacts in a specific repository.
58
58
 
59
59
  Args:
60
60
  extra_headers: Send extra headers
@@ -95,7 +95,7 @@ class ArtifactsResource(SyncAPIResource):
95
95
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
96
96
  ) -> None:
97
97
  """
98
- Delete an artifact
98
+ Delete a specific artifact from a repository.
99
99
 
100
100
  Args:
101
101
  extra_headers: Send extra headers
@@ -159,7 +159,7 @@ class AsyncArtifactsResource(AsyncAPIResource):
159
159
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
160
160
  ) -> RegistryArtifactList:
161
161
  """
162
- List artifacts
162
+ List all artifacts in a specific repository.
163
163
 
164
164
  Args:
165
165
  extra_headers: Send extra headers
@@ -200,7 +200,7 @@ class AsyncArtifactsResource(AsyncAPIResource):
200
200
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
201
201
  ) -> None:
202
202
  """
203
- Delete an artifact
203
+ Delete a specific artifact from a repository.
204
204
 
205
205
  Args:
206
206
  extra_headers: Send extra headers
@@ -104,12 +104,11 @@ class RegistriesResource(SyncAPIResource):
104
104
  extra_body: Body | None = None,
105
105
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
106
106
  ) -> Registry:
107
- """Create a registry
107
+ """
108
+ Create a new container registry with the specified configuration.
108
109
 
109
110
  Args:
110
- name: A name for the container registry.
111
-
112
- Should be in lowercase, consisting only of
111
+ name: A name for the container registry. Should be in lowercase, consisting only of
113
112
  numbers, letters and -, with maximum length of 24 characters
114
113
 
115
114
  storage_limit: Registry storage limit, GiB
@@ -154,7 +153,7 @@ class RegistriesResource(SyncAPIResource):
154
153
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
155
154
  ) -> RegistryList:
156
155
  """
157
- Get registry list
156
+ List all container registries in the specified project and region.
158
157
 
159
158
  Args:
160
159
  extra_headers: Send extra headers
@@ -191,7 +190,7 @@ class RegistriesResource(SyncAPIResource):
191
190
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
192
191
  ) -> None:
193
192
  """
194
- Delete a registry
193
+ Delete a specific container registry and all its associated resources.
195
194
 
196
195
  Args:
197
196
  extra_headers: Send extra headers
@@ -229,7 +228,7 @@ class RegistriesResource(SyncAPIResource):
229
228
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
230
229
  ) -> Registry:
231
230
  """
232
- Get a registry
231
+ Get detailed information about a specific container registry.
233
232
 
234
233
  Args:
235
234
  extra_headers: Send extra headers
@@ -267,7 +266,7 @@ class RegistriesResource(SyncAPIResource):
267
266
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
268
267
  ) -> Registry:
269
268
  """
270
- Resize a registry
269
+ Update the size of a container registry.
271
270
 
272
271
  Args:
273
272
  storage_limit: Registry storage limit, GiB
@@ -344,12 +343,11 @@ class AsyncRegistriesResource(AsyncAPIResource):
344
343
  extra_body: Body | None = None,
345
344
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
346
345
  ) -> Registry:
347
- """Create a registry
346
+ """
347
+ Create a new container registry with the specified configuration.
348
348
 
349
349
  Args:
350
- name: A name for the container registry.
351
-
352
- Should be in lowercase, consisting only of
350
+ name: A name for the container registry. Should be in lowercase, consisting only of
353
351
  numbers, letters and -, with maximum length of 24 characters
354
352
 
355
353
  storage_limit: Registry storage limit, GiB
@@ -394,7 +392,7 @@ class AsyncRegistriesResource(AsyncAPIResource):
394
392
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
395
393
  ) -> RegistryList:
396
394
  """
397
- Get registry list
395
+ List all container registries in the specified project and region.
398
396
 
399
397
  Args:
400
398
  extra_headers: Send extra headers
@@ -431,7 +429,7 @@ class AsyncRegistriesResource(AsyncAPIResource):
431
429
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
432
430
  ) -> None:
433
431
  """
434
- Delete a registry
432
+ Delete a specific container registry and all its associated resources.
435
433
 
436
434
  Args:
437
435
  extra_headers: Send extra headers
@@ -469,7 +467,7 @@ class AsyncRegistriesResource(AsyncAPIResource):
469
467
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
470
468
  ) -> Registry:
471
469
  """
472
- Get a registry
470
+ Get detailed information about a specific container registry.
473
471
 
474
472
  Args:
475
473
  extra_headers: Send extra headers
@@ -507,7 +505,7 @@ class AsyncRegistriesResource(AsyncAPIResource):
507
505
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
508
506
  ) -> Registry:
509
507
  """
510
- Resize a registry
508
+ Update the size of a container registry.
511
509
 
512
510
  Args:
513
511
  storage_limit: Registry storage limit, GiB
@@ -53,7 +53,7 @@ class RepositoriesResource(SyncAPIResource):
53
53
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
54
54
  ) -> RegistryRepositoryList:
55
55
  """
56
- List repositories
56
+ List all repositories in the container registry.
57
57
 
58
58
  Args:
59
59
  extra_headers: Send extra headers
@@ -91,7 +91,7 @@ class RepositoriesResource(SyncAPIResource):
91
91
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
92
92
  ) -> None:
93
93
  """
94
- Delete a repository
94
+ Delete a specific repository from the container registry.
95
95
 
96
96
  Args:
97
97
  extra_headers: Send extra headers
@@ -152,7 +152,7 @@ class AsyncRepositoriesResource(AsyncAPIResource):
152
152
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
153
153
  ) -> RegistryRepositoryList:
154
154
  """
155
- List repositories
155
+ List all repositories in the container registry.
156
156
 
157
157
  Args:
158
158
  extra_headers: Send extra headers
@@ -190,7 +190,7 @@ class AsyncRepositoriesResource(AsyncAPIResource):
190
190
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
191
191
  ) -> None:
192
192
  """
193
- Delete a repository
193
+ Delete a specific repository from the container registry.
194
194
 
195
195
  Args:
196
196
  extra_headers: Send extra headers
@@ -55,7 +55,7 @@ class TagsResource(SyncAPIResource):
55
55
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
56
56
  ) -> None:
57
57
  """
58
- Delete a tag
58
+ Delete a specific tag from an artifact.
59
59
 
60
60
  Args:
61
61
  extra_headers: Send extra headers
@@ -123,7 +123,7 @@ class AsyncTagsResource(AsyncAPIResource):
123
123
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
124
124
  ) -> None:
125
125
  """
126
- Delete a tag
126
+ Delete a specific tag from an artifact.
127
127
 
128
128
  Args:
129
129
  extra_headers: Send extra headers
@@ -21,6 +21,7 @@ from ....types.cloud.registries import user_create_params, user_update_params, u
21
21
  from ....types.cloud.registries.registry_user import RegistryUser
22
22
  from ....types.cloud.registries.registry_user_list import RegistryUserList
23
23
  from ....types.cloud.registries.registry_user_created import RegistryUserCreated
24
+ from ....types.cloud.registries.user_refresh_secret_response import UserRefreshSecretResponse
24
25
 
25
26
  __all__ = ["UsersResource", "AsyncUsersResource"]
26
27
 
@@ -61,9 +62,9 @@ class UsersResource(SyncAPIResource):
61
62
  extra_query: Query | None = None,
62
63
  extra_body: Body | None = None,
63
64
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
64
- ) -> RegistryUser:
65
+ ) -> RegistryUserCreated:
65
66
  """
66
- Create a user
67
+ Create a new user for accessing the container registry.
67
68
 
68
69
  Args:
69
70
  duration: User account operating time, days
@@ -101,7 +102,7 @@ class UsersResource(SyncAPIResource):
101
102
  options=make_request_options(
102
103
  extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
103
104
  ),
104
- cast_to=RegistryUser,
105
+ cast_to=RegistryUserCreated,
105
106
  )
106
107
 
107
108
  def update(
@@ -121,7 +122,7 @@ class UsersResource(SyncAPIResource):
121
122
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
122
123
  ) -> RegistryUser:
123
124
  """
124
- Update a user
125
+ Update the configuration of a specific registry user.
125
126
 
126
127
  Args:
127
128
  duration: User account operating time, days
@@ -169,7 +170,7 @@ class UsersResource(SyncAPIResource):
169
170
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
170
171
  ) -> RegistryUserList:
171
172
  """
172
- Get user list
173
+ List all users with access to the container registry.
173
174
 
174
175
  Args:
175
176
  extra_headers: Send extra headers
@@ -207,7 +208,7 @@ class UsersResource(SyncAPIResource):
207
208
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
208
209
  ) -> None:
209
210
  """
210
- Delete a user
211
+ Delete a specific user from the container registry.
211
212
 
212
213
  Args:
213
214
  extra_headers: Send extra headers
@@ -246,7 +247,7 @@ class UsersResource(SyncAPIResource):
246
247
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
247
248
  ) -> RegistryUserCreated:
248
249
  """
249
- Batch create users
250
+ Create multiple users for accessing the container registry in a single request.
250
251
 
251
252
  Args:
252
253
  users: Set of users
@@ -285,9 +286,9 @@ class UsersResource(SyncAPIResource):
285
286
  extra_query: Query | None = None,
286
287
  extra_body: Body | None = None,
287
288
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
288
- ) -> None:
289
+ ) -> UserRefreshSecretResponse:
289
290
  """
290
- Refresh a secret
291
+ Generate a new secret for a specific registry user.
291
292
 
292
293
  Args:
293
294
  extra_headers: Send extra headers
@@ -302,13 +303,12 @@ class UsersResource(SyncAPIResource):
302
303
  project_id = self._client._get_cloud_project_id_path_param()
303
304
  if region_id is None:
304
305
  region_id = self._client._get_cloud_region_id_path_param()
305
- extra_headers = {"Accept": "*/*", **(extra_headers or {})}
306
306
  return self._post(
307
307
  f"/cloud/v1/registries/{project_id}/{region_id}/{registry_id}/users/{user_id}/refresh_secret",
308
308
  options=make_request_options(
309
309
  extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
310
310
  ),
311
- cast_to=NoneType,
311
+ cast_to=UserRefreshSecretResponse,
312
312
  )
313
313
 
314
314
 
@@ -348,9 +348,9 @@ class AsyncUsersResource(AsyncAPIResource):
348
348
  extra_query: Query | None = None,
349
349
  extra_body: Body | None = None,
350
350
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
351
- ) -> RegistryUser:
351
+ ) -> RegistryUserCreated:
352
352
  """
353
- Create a user
353
+ Create a new user for accessing the container registry.
354
354
 
355
355
  Args:
356
356
  duration: User account operating time, days
@@ -388,7 +388,7 @@ class AsyncUsersResource(AsyncAPIResource):
388
388
  options=make_request_options(
389
389
  extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
390
390
  ),
391
- cast_to=RegistryUser,
391
+ cast_to=RegistryUserCreated,
392
392
  )
393
393
 
394
394
  async def update(
@@ -408,7 +408,7 @@ class AsyncUsersResource(AsyncAPIResource):
408
408
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
409
409
  ) -> RegistryUser:
410
410
  """
411
- Update a user
411
+ Update the configuration of a specific registry user.
412
412
 
413
413
  Args:
414
414
  duration: User account operating time, days
@@ -456,7 +456,7 @@ class AsyncUsersResource(AsyncAPIResource):
456
456
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
457
457
  ) -> RegistryUserList:
458
458
  """
459
- Get user list
459
+ List all users with access to the container registry.
460
460
 
461
461
  Args:
462
462
  extra_headers: Send extra headers
@@ -494,7 +494,7 @@ class AsyncUsersResource(AsyncAPIResource):
494
494
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
495
495
  ) -> None:
496
496
  """
497
- Delete a user
497
+ Delete a specific user from the container registry.
498
498
 
499
499
  Args:
500
500
  extra_headers: Send extra headers
@@ -533,7 +533,7 @@ class AsyncUsersResource(AsyncAPIResource):
533
533
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
534
534
  ) -> RegistryUserCreated:
535
535
  """
536
- Batch create users
536
+ Create multiple users for accessing the container registry in a single request.
537
537
 
538
538
  Args:
539
539
  users: Set of users
@@ -572,9 +572,9 @@ class AsyncUsersResource(AsyncAPIResource):
572
572
  extra_query: Query | None = None,
573
573
  extra_body: Body | None = None,
574
574
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
575
- ) -> None:
575
+ ) -> UserRefreshSecretResponse:
576
576
  """
577
- Refresh a secret
577
+ Generate a new secret for a specific registry user.
578
578
 
579
579
  Args:
580
580
  extra_headers: Send extra headers
@@ -589,13 +589,12 @@ class AsyncUsersResource(AsyncAPIResource):
589
589
  project_id = self._client._get_cloud_project_id_path_param()
590
590
  if region_id is None:
591
591
  region_id = self._client._get_cloud_region_id_path_param()
592
- extra_headers = {"Accept": "*/*", **(extra_headers or {})}
593
592
  return await self._post(
594
593
  f"/cloud/v1/registries/{project_id}/{region_id}/{registry_id}/users/{user_id}/refresh_secret",
595
594
  options=make_request_options(
596
595
  extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
597
596
  ),
598
- cast_to=NoneType,
597
+ cast_to=UserRefreshSecretResponse,
599
598
  )
600
599
 
601
600
 
@@ -76,7 +76,7 @@ class ReservedFixedIPsResource(SyncAPIResource):
76
76
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
77
77
  ) -> TaskIDList:
78
78
  """
79
- Create reserved fixed IP
79
+ Create a new reserved fixed IP with the specified configuration.
80
80
 
81
81
  Args:
82
82
  type: Must be 'external'
@@ -112,7 +112,7 @@ class ReservedFixedIPsResource(SyncAPIResource):
112
112
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
113
113
  ) -> TaskIDList:
114
114
  """
115
- Create reserved fixed IP
115
+ Create a new reserved fixed IP with the specified configuration.
116
116
 
117
117
  Args:
118
118
  subnet_id: Reserved fixed IP will be allocated in this subnet
@@ -149,7 +149,7 @@ class ReservedFixedIPsResource(SyncAPIResource):
149
149
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
150
150
  ) -> TaskIDList:
151
151
  """
152
- Create reserved fixed IP
152
+ Create a new reserved fixed IP with the specified configuration.
153
153
 
154
154
  Args:
155
155
  network_id: Reserved fixed IP will be allocated in a subnet of this network
@@ -188,7 +188,7 @@ class ReservedFixedIPsResource(SyncAPIResource):
188
188
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
189
189
  ) -> TaskIDList:
190
190
  """
191
- Create reserved fixed IP
191
+ Create a new reserved fixed IP with the specified configuration.
192
192
 
193
193
  Args:
194
194
  ip_address: Reserved fixed IP will be allocated the given IP address
@@ -225,7 +225,7 @@ class ReservedFixedIPsResource(SyncAPIResource):
225
225
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
226
226
  ) -> TaskIDList:
227
227
  """
228
- Create reserved fixed IP
228
+ Create a new reserved fixed IP with the specified configuration.
229
229
 
230
230
  Args:
231
231
  port_id: Port ID to make a reserved fixed IP (for example, `vip_port_id` of the Load
@@ -315,7 +315,7 @@ class ReservedFixedIPsResource(SyncAPIResource):
315
315
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
316
316
  ) -> SyncOffsetPage[ReservedFixedIP]:
317
317
  """
318
- List reserved fixed IPs
318
+ List all reserved fixed IPs in the specified project and region.
319
319
 
320
320
  Args:
321
321
  available_only: Set to true if the response should only list IP addresses that are not attached
@@ -334,8 +334,8 @@ class ReservedFixedIPsResource(SyncAPIResource):
334
334
  offset: Offset value is used to exclude the first set of records from the result
335
335
 
336
336
  order_by: Ordering reserved fixed IP list result by name, status, `updated_at`,
337
- `created_at` or `fixed_ip_address` fields of the reserved fixed IP and
338
- directions (status.asc), default is "`fixed_ip_address`.asc"
337
+ `created_at` or `fixed_ip_address` fields and directions (status.asc), default
338
+ is "`fixed_ip_address`.asc"
339
339
 
340
340
  vip_only: Set to true if the response should only list VIPs
341
341
 
@@ -391,7 +391,7 @@ class ReservedFixedIPsResource(SyncAPIResource):
391
391
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
392
392
  ) -> TaskIDList:
393
393
  """
394
- Delete reserved fixed ip
394
+ Delete a specific reserved fixed IP and all its associated resources.
395
395
 
396
396
  Args:
397
397
  extra_headers: Send extra headers
@@ -430,7 +430,7 @@ class ReservedFixedIPsResource(SyncAPIResource):
430
430
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
431
431
  ) -> ReservedFixedIP:
432
432
  """
433
- Get reserved fixed IP
433
+ Get detailed information about a specific reserved fixed IP.
434
434
 
435
435
  Args:
436
436
  extra_headers: Send extra headers
@@ -497,7 +497,7 @@ class AsyncReservedFixedIPsResource(AsyncAPIResource):
497
497
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
498
498
  ) -> TaskIDList:
499
499
  """
500
- Create reserved fixed IP
500
+ Create a new reserved fixed IP with the specified configuration.
501
501
 
502
502
  Args:
503
503
  type: Must be 'external'
@@ -533,7 +533,7 @@ class AsyncReservedFixedIPsResource(AsyncAPIResource):
533
533
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
534
534
  ) -> TaskIDList:
535
535
  """
536
- Create reserved fixed IP
536
+ Create a new reserved fixed IP with the specified configuration.
537
537
 
538
538
  Args:
539
539
  subnet_id: Reserved fixed IP will be allocated in this subnet
@@ -570,7 +570,7 @@ class AsyncReservedFixedIPsResource(AsyncAPIResource):
570
570
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
571
571
  ) -> TaskIDList:
572
572
  """
573
- Create reserved fixed IP
573
+ Create a new reserved fixed IP with the specified configuration.
574
574
 
575
575
  Args:
576
576
  network_id: Reserved fixed IP will be allocated in a subnet of this network
@@ -609,7 +609,7 @@ class AsyncReservedFixedIPsResource(AsyncAPIResource):
609
609
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
610
610
  ) -> TaskIDList:
611
611
  """
612
- Create reserved fixed IP
612
+ Create a new reserved fixed IP with the specified configuration.
613
613
 
614
614
  Args:
615
615
  ip_address: Reserved fixed IP will be allocated the given IP address
@@ -646,7 +646,7 @@ class AsyncReservedFixedIPsResource(AsyncAPIResource):
646
646
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
647
647
  ) -> TaskIDList:
648
648
  """
649
- Create reserved fixed IP
649
+ Create a new reserved fixed IP with the specified configuration.
650
650
 
651
651
  Args:
652
652
  port_id: Port ID to make a reserved fixed IP (for example, `vip_port_id` of the Load
@@ -736,7 +736,7 @@ class AsyncReservedFixedIPsResource(AsyncAPIResource):
736
736
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
737
737
  ) -> AsyncPaginator[ReservedFixedIP, AsyncOffsetPage[ReservedFixedIP]]:
738
738
  """
739
- List reserved fixed IPs
739
+ List all reserved fixed IPs in the specified project and region.
740
740
 
741
741
  Args:
742
742
  available_only: Set to true if the response should only list IP addresses that are not attached
@@ -755,8 +755,8 @@ class AsyncReservedFixedIPsResource(AsyncAPIResource):
755
755
  offset: Offset value is used to exclude the first set of records from the result
756
756
 
757
757
  order_by: Ordering reserved fixed IP list result by name, status, `updated_at`,
758
- `created_at` or `fixed_ip_address` fields of the reserved fixed IP and
759
- directions (status.asc), default is "`fixed_ip_address`.asc"
758
+ `created_at` or `fixed_ip_address` fields and directions (status.asc), default
759
+ is "`fixed_ip_address`.asc"
760
760
 
761
761
  vip_only: Set to true if the response should only list VIPs
762
762
 
@@ -812,7 +812,7 @@ class AsyncReservedFixedIPsResource(AsyncAPIResource):
812
812
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
813
813
  ) -> TaskIDList:
814
814
  """
815
- Delete reserved fixed ip
815
+ Delete a specific reserved fixed IP and all its associated resources.
816
816
 
817
817
  Args:
818
818
  extra_headers: Send extra headers
@@ -851,7 +851,7 @@ class AsyncReservedFixedIPsResource(AsyncAPIResource):
851
851
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
852
852
  ) -> ReservedFixedIP:
853
853
  """
854
- Get reserved fixed IP
854
+ Get detailed information about a specific reserved fixed IP.
855
855
 
856
856
  Args:
857
857
  extra_headers: Send extra headers