Releases: G-Core/gcore-python
Release list
v0.51.0
We're excited to announce version 0.51.0!
CDN
-
CDN Resources
- Added
active,is_primary,max_updated,min_updated,name,origin_group_in,suspended, andorigin_protocolfilters toCDNResourceListParams - ⚠ BREAKING CHANGE:
CDNResourcesResource.list()return type changed fromCDNResourceListUniontoSyncOffsetPage[CDNResource]
- Added
-
Logs Uploader
- ⚠ BREAKING CHANGE: logs uploader target config credential fields changed from required
strfields to optional fields across S3 Gcore, S3 OSS, S3 Other, S3 V1, FTP, SFTP, Azure Blob, and SLS params - ⚠ BREAKING CHANGE:
ConfigsResource.list()return type changed fromLogsUploaderConfigListUniontoSyncOffsetPage[LogsUploaderConfig] - ⚠ BREAKING CHANGE:
PoliciesResource.list()return type changed fromLogsUploaderPolicyListUniontoSyncOffsetPage[LogsUploaderPolicy]
- ⚠ BREAKING CHANGE: logs uploader target config credential fields changed from required
-
Metrics
- ⚠ BREAKING CHANGE:
CDNMetricsValue.metricwas removed; metric values are now exposed through extra fields as recursive metric-value mappings
- ⚠ BREAKING CHANGE:
-
Origin Groups
- ⚠ BREAKING CHANGE:
OriginGroupsResource.list()return type changed fromOriginGroupsListUniontoSyncOffsetPage[OriginGroups]
- ⚠ BREAKING CHANGE:
-
Rules
- ⚠ BREAKING CHANGE:
RulesResource.list()return type changed fromCDNResourceRuleListUniontoSyncOffsetPage[CDNResourceRule]
- ⚠ BREAKING CHANGE:
-
Rule Templates
- ⚠ BREAKING CHANGE:
RuleTemplatesResource.list()return type changed fromRuleTemplateListUniontoSyncOffsetPage[RuleTemplate]
- ⚠ BREAKING CHANGE:
-
SSL Certificates
- ⚠ BREAKING CHANGE:
CertificatesResource.list()return type changed fromSslDetailListUniontoSyncOffsetPage[SslDetail]
- ⚠ BREAKING CHANGE:
-
Statistics
- Added
idfield toUsageSeriesStat— identifies paid feature usage records
- Added
-
Trusted CA Certificates
- ⚠ BREAKING CHANGE:
TrustedCaCertificatesResource.list()return type changed fromCaCertificateListUniontoSyncOffsetPage[CaCertificate]
- ⚠ BREAKING CHANGE:
Cloud
-
Bare Metal
- Added
all_reserved_fixed_ipsfield toBaremetalServerDeleteParams— deletes reserved fixed IPs assigned to the server when deleting it
- Added
-
GPU Bare Metal
- ⚠ BREAKING CHANGE:
InterfacesResource.list()return type changed fromNetworkInterfaceListtoGPUBaremetalClusterInterfaceListResponse
- ⚠ BREAKING CHANGE:
-
GPU Virtual
- ⚠ BREAKING CHANGE:
ServersResource.list()return type changed fromGPUVirtualClusterServerListtoSyncOffsetPage[GPUVirtualClusterServer]
- ⚠ BREAKING CHANGE:
-
Images
- Added
architecture,name,os_distro, andos_versionfilters toInstanceImageListParams
- Added
-
Load Balancers
- ⚠ BREAKING CHANGE:
FlavorsResource.list()return type changed fromLoadBalancerFlavorListtoSyncOffsetPage[LoadBalancerFlavorListResultUnion]
- ⚠ BREAKING CHANGE:
-
Quotas
- ⚠ BREAKING CHANGE:
QuotasResource.get_all()return type changed fromQuotaGetAllResponsetoQuota - ⚠ BREAKING CHANGE: quota response types were renamed from
QuotaGetAllResponse*toQuota*, includingQuotaGlobalQuotasandQuotaRegionalQuota
- ⚠ BREAKING CHANGE:
-
Security Groups
- ⚠ BREAKING CHANGE:
SecurityGroupRuleReplaceParams.security_group_idwas removed - Fixed no-op handling in
update_and_poll()methods — update-and-poll helpers now return the refreshed resource when no task is created
- ⚠ BREAKING CHANGE:
DNS
-
Network Mappings
- ⚠ BREAKING CHANGE:
NetworkMappingsResource.list()return type changed fromNetworkMappingListResponsetoSyncOffsetPageDNSNetworkMappings[DNSNetworkMapping]
- ⚠ BREAKING CHANGE:
-
RRsets
- ⚠ BREAKING CHANGE:
RrsetsResource.list()return type changed fromZoneRrsetListResponsetoSyncOffsetPageDNSRrsets[DNSOutputRrset]
- ⚠ BREAKING CHANGE:
-
Zones
- ⚠ BREAKING CHANGE:
ZonesResource.list()return type changed fromZoneListResponsetoSyncOffsetPageDNSZones[ZoneListResponse] - ⚠ BREAKING CHANGE: zone list item types were renamed from
ZoneListResponseZone*toZoneListResponse*
- ⚠ BREAKING CHANGE:
FastEdge
- Edge Storage
- ⚠ BREAKING CHANGE:
KvStoresResource.list()return type changed fromKvStoreListResponsetoSyncOffsetPageFastedgeKvStores[KvStoreShort]
- ⚠ BREAKING CHANGE:
WAAP
- Analytics
- Added
order_byfield toAnalyticsGetEventStatisticsParams— ranks analytics statistics bytotal.descorthreats.desc
- Added
0.51.0 (2026-07-09)
⚠ BREAKING CHANGES
- cloud: refactor instance security groups, interfaces, and flavor/name models
- cdn: recursive metrics response; optional logs-uploader target configs
Features
- cdn: add resource list filters and paginated list response models (cb2476e)
- cdn: default limit=1000 on CDN list endpoints (683c968)
- cdn: recursive metrics response; optional logs-uploader target configs (a1e4e66)
- cloud: refactor instance security groups, interfaces, and flavor/name models (8866342)
- cloud: support gcore_cloud_quota data source (9e1db66)
- enable offset/limit pagination for 7 list endpoints (41c1d73)
- terraform: expose gcore_cdn_origin_shielding (7f8fa85)
- waap: add order_by to analytics stats and length limits to filter suggestions (d6d4221)
Bug Fixes
- cdn: update trusted CA cert examples for paginated list (28d65ac)
- cloud: correct quota model import in cloud examples (bc9a3b2)
- cloud: handle no-op updates in update_and_poll methods (25c05bc)
- cloud: update cloud examples for regenerated types (9092e97)
- cloud: wait for instance image to become active in upload_and_poll (a58f2ba)
Chores
- fastedge: update fastedge OpenAPI spec (2d8737b)
- storage: add admin bucket search response schemas (bb86353)
Refactors
- cloud: isolate custom *_and_poll methods into _custom.py mixins (503ab9c)
v0.50.0
We're excited to announce version 0.50.0!
CDN
-
Logs Uploader
- Added
slsas astorage_typeoption toLogsUploaderTargetand target create, update, and replace params — logs can now be uploaded to Alibaba Cloud SLS. - Added
ConfigSlsConfigand related SLS authentication config types for Logs Uploader targets.
- Added
-
Origin Groups
- ⚠ BREAKING CHANGE: Removed
tagfrom origin source response and params types —NoneAuthSourceHostSourceResponse.tag,NoneAuthSourceS3SourceResponse.tag,NoneAuthSourceFastedgeSourceResponse.tag, and related create, update, and replace params no longer exist.
- ⚠ BREAKING CHANGE: Removed
-
Rules
- Added
on_request_headers_after_cachefield toOptionsFastedgein CDN rule params — FastEdge apps can now run on request headers after cache lookup.
- Added
-
Rule Templates
- Added
on_request_headers_after_cachefield toOptionsFastedgeinRuleTemplateand rule template params — FastEdge apps can now run on request headers after cache lookup.
- Added
Cloud
-
Bare Metal
- ⚠ BREAKING CHANGE:
BaremetalImage.tagschanged fromList[Tag]totags_v2: List[Tag]. - Added
limitandoffsetparams to bare metal flavor and image list methods.
- ⚠ BREAKING CHANGE:
-
Billing Reservations
- Added
time_fromandtime_toparams to billing reservation list methods — request period-matched monthly pricing for a reservation window.
- Added
-
File Shares
- Added
limitandoffsetparams to file share access rule list methods.
- Added
-
GPU Bare Metal
- Added
image_idandservers_settingsparams togpu_baremetal.clusters.update()— update the cluster template for future server rebuilds. - Added
applied_servers_settingsfield toGPUBaremetalClusterServer— compare each server against the current cluster template. - Added
replace()params for GPU bare metal cluster servers, includingkeep_ip_addresses. - Added
limitandoffsetparams to GPU bare metal cluster, flavor, and image list methods. - Added per-interface
security_groupsandport_security_enabledfields to GPU bare metal cluster create params.
- Added
-
GPU Virtual
- Added
servers_settingsparam togpu_virtual.clusters.update()— update the cluster template for future server changes. - Added
applied_servers_settingsfield toGPUVirtualClusterServer— compare each server against the current cluster template. - Added
limitandoffsetparams to GPU virtual cluster, flavor, image, interface, and volume list methods. - Added per-interface
security_groupsandport_security_enabledfields to GPU virtual cluster create params.
- Added
-
Instances
- ⚠ BREAKING CHANGE:
Image.tagschanged fromList[Tag]totags_v2: List[Tag]. - Added
limitandoffsetparams to instance flavor, image, interface, and metrics list methods. - Added nullable
tagssupport toImageUpdateParams— passNoneto clear tags where supported.
- ⚠ BREAKING CHANGE:
-
Load Balancers
- ⚠ BREAKING CHANGE:
redirect_http_codein L7 policy create and update params changed frominttoLiteral[301, 302, 303, 307, 308]. - Added
operating_statusandprovisioning_statusfilters to load balancer list methods.
- ⚠ BREAKING CHANGE:
-
Managed Kubernetes
- Added
limitandoffsetparams to cluster, node, pool, pool node, flavor, create-version, and upgrade-version list methods. - Added
security_group_idsto Managed Kubernetes cluster and pool create/update params. - Added
cni_exclusiveto Managed Kubernetes cluster create/update params andK8SCluster.
- Added
-
Networks
- Added nullable
external_gateway_infosupport to router update params — passNoneto clear router external gateway info.
- Added nullable
-
Placement Groups
- Added
limitandoffsetparams to placement group list methods.
- Added
-
Quotas
- Added
inference_public_model_api_key_count_limitandinference_public_model_api_key_count_usagefields to quota responses and quota request params.
- Added
-
Registries
- Added
limitandoffsetparams to registry, repository, artifact, and user list methods.
- Added
-
Reserved IPs
- ⚠ BREAKING CHANGE:
order_byin reserved fixed IP list params changed fromstrtoLiteral["created_at.asc", "created_at.desc", "fixed_ip_address.asc", "fixed_ip_address.desc", "name.asc", "name.desc", "status.asc", "status.desc", "updated_at.asc", "updated_at.desc"].
- ⚠ BREAKING CHANGE:
-
Security Groups
- ⚠ BREAKING CHANGE:
SecurityGroup.descriptionchanged fromOptional[str]to requiredstr. - ⚠ BREAKING CHANGE:
SecurityGroupUpdateParams.directionchanged from optionalLiteral["egress", "ingress"]to required. - Added nullable
remote_group_id,remote_ip_prefix,port_range_min, andport_range_maxsupport to security group rule params.
- ⚠ BREAKING CHANGE:
-
Tasks
- Added
update_networkandupdate_portastask_typefilter values.
- Added
DNS
-
DNSSEC
- Added
dnssec_statusanddnssec_status_modified_onfields to zone get and list responses. - Added
force_disableparam todnssec.update().
- Added
-
RRsets
- Added
PTR,SVCB,HTTPS,CAA, andDSvalues toDNSOutputRrset.type.
- Added
Streaming
- Streams
- Added
srt_passphrasefield toStream,StreamCreateParams, andStreamUpdateParams— configure encrypted SRT PUSH ingest.
- Added
WAAP
-
Analytics
- ⚠ BREAKING CHANGE:
ja3,exclude_ja3,path,exclude_path,user_agent, andexclude_user_agentanalytics filters changed from single optional values to sequence params for multi-value filtering. - Added
get_filters()method towaap.analytics— retrieve available analytics filter values with counts. - Added
ja4andexclude_ja4analytics filters for JA4 TLS fingerprint filtering. - Added exclusion filters including
exclude_decision,exclude_http_methods,exclude_optional_action,exclude_request_ids, andexclude_status_codes. - Added
detectorandja4fields toWaapRequestDetails.
- ⚠ BREAKING CHANGE:
-
Custom Rules
- Added
ja3andja4condition types to custom rule create/update params andWaapCustomRule.
- Added
0.50.0 (2026-07-01)
⚠ BREAKING CHANGES
- cdn: update cdn OpenAPI spec
- waap: JA4 support, multi-value analytics filters, exclusion filters
- cloud: refresh cloud OpenAPI spec to latest upstream
Features
- cdn: support logs uploader configs in Terraform (6b4295f)
- cdn: support logs uploader policies in Terraform (6139264)
- cdn: update cdn OpenAPI spec (52dee8f)
- cloud: refresh cloud OpenAPI spec to latest upstream(0ebd9bc)
- dns: DNSSEC status fields + PTR/SVCB/HTTPS/CAA/DS rrset types (dc7339a)
- streaming: add srt_passphrase for encrypted SRT PUSH ingest (5eb9740)
- waap: JA4 support, multi-value analytics filters, exclusion filters (afbde20)
Chores
- bootstrap product specs and reformat openapi.yml (3c5ca4e)
v0.49.0
We're excited to announce version 0.49.0!
Other
- SDK Release Infrastructure
- Added initial
stlcbuild integration — updates the SDK generation pipeline
- Added initial
0.49.0 (2026-06-22)
Full Changelog: v0.48.0...v0.49.0
Features
- initial stlc build (8520034)
Reverts
Chores
- change description (3fafcb0)
- change description (4894a5d)
- reseal custom code from G-Core/gcore-go-staging@4cf4626 (aba4924)
v0.48.0
We're excited to announce version 0.48.0!
CDN
- CA Certificates
- Added example demonstrating CRUD operations for trusted CA certificates — covers create, list, get, and delete flows
0.48.0 (2026-05-20)
Full Changelog: v0.47.0...v0.48.0
Features
v0.47.0
We're excited to announce version 0.47.0!
Cloud
- GPU Bare Metal
- Added
replace()method toclient.cloud.gpu_baremetal.clusters.servers— deletes a server from the cluster and provisions a new one in its place, maintaining cluster size and reusing the current cluster configuration (image, SSH key, network settings); returnsTaskIDList - Added
replace_and_poll()method — replaces a GPU bare metal cluster server and polls until the new server is provisioned, returnsGPUBaremetalClusterServer - Added
rebuild_and_poll()method — rebuilds a GPU bare metal cluster server and polls until completion, returnsGPUBaremetalClusterServer
- Added
WAAP
- Domains
- Added
aliasesfield (Optional[List[str]]) toWaapDetailedDomainandWaapSummaryDomain— CNAME aliases pointing at the domain's CDN resource
- Added
Other
- Added
EagerIterabletype — accepts anyIterable[T]input (including generators), consumes it eagerly, and validates all items upfront while preserving the original container type where possible
0.47.0 (2026-05-19)
Full Changelog: v0.46.0...v0.47.0
Features
- api: aggregated API specs update (8c92d60)
- cloud: add example for replacing a GPU baremetal cluster server (0b15bb0)
- cloud: add replace method for GPU baremetal cluster server (302f52d)
- cloud: add replace_and_poll and rebuild_and_poll for GPU baremetal cluster server (119f015)
- internal/types: support eagerly validating pydantic iterators (8aa6320)
- storage: support storage access keys resource in Terraform (0b20d58)
- storage: support TF for buckets (6c7c89f)
- storage: support TF for object storages (2a09961)
v0.46.0
We're excited to announce version 0.46.0!
CDN
-
CDN Service
- Added
client_configservice toCDNResource— useclient.cdn.client_config.get()to retrieve the current account's CDN service configuration
- Added
-
Origin Groups
- Added FastEdge origin support to CDN origin groups — origin group request and response types now support
origin_type="fastedge"with FastEdge source config viaapp_id
- Added FastEdge origin support to CDN origin groups — origin group request and response types now support
Cloud
- Tasks
- ⚠ BREAKING CHANGE: Renamed
cloud_polling_interval_secondstopolling_interval_secondsandcloud_polling_timeout_secondstopolling_timeout_secondsonGcore,AsyncGcore, andcopy()— cloud task polling now uses the new generic client options
- ⚠ BREAKING CHANGE: Renamed
Object Storage
- Buckets
- ⚠ BREAKING CHANGE: Renamed
bucket_nametonameinBucketsResource.get(),BucketsResource.update(), andBucketsResource.delete()— calls usingbucket_name=must switch toname=
- ⚠ BREAKING CHANGE: Renamed
WAAP
- Analytics
- Added
ja3,exclude_ja3,organizations,exclude_organizations,tags,exclude_tags,user_agent,exclude_user_agent,user_agent_clients,exclude_user_agent_clients,user_agent_devices, andexclude_user_agent_devicesfields to WAAP analytics request params — you can now filter analytics by JA3 fingerprint, user agent, organization, tag, client, and device - Added
ja3field toWaapRequestSummaryandWaapRequestDetails— request analytics responses now include the JA3 fingerprint when available
- Added
Other
- Fixed file upload type errors — the async file-type validation message now correctly includes the unexpected input type
0.46.0 (2026-05-11)
Full Changelog: v0.45.0...v0.46.0
Features
- add cross-SDK sync and relax CI breaking-change check for /release skill (227d229)
- api: aggregated API specs update (9d56917)
- api: aggregated API specs update (6722396)
- api: aggregated API specs update (f5efa16)
- api: aggregated API specs update (adc6730)
- cdn: add client_config SDK subresource for /cdn/clients/me (dd6eaa9)
Bug Fixes
- client: add missing f-string prefix in file type error message (dcc262a)
- cloud: use generic polling options in tasks (325b0d3)
- storage: rename bucket path param {bucket_name} -> {name} (65ef255)
Chores
- client: rename cloud_polling_* opts to polling_* (2fbb1d4)
v0.45.0
We're excited to announce version 0.45.0!
Cloud
-
Images
- ⚠ BREAKING CHANGE:
hw_machine_typeinImageUpdateParams,ImageUploadParams, andImageCreateFromVolumeParamschanged fromLiteral[\"pc\", \"q35\"]toLiteral[\"i440\", \"q35\"] - ⚠ BREAKING CHANGE:
is_baremetalinimages.update()andImageUpdateParamschanged frombooltoOptional[bool]
- ⚠ BREAKING CHANGE:
-
Managed PostgreSQL
- ⚠ BREAKING CHANGE:
custom_configurations.validate()now returnsPgConfValidationinstead ofCustomConfigurationValidateResponse - ⚠ BREAKING CHANGE: Renamed
CustomConfigurationValidateResponsetoPgConfValidation
- ⚠ BREAKING CHANGE:
-
Networks
- ⚠ BREAKING CHANGE:
routers.update()migrated from the v1 router endpoint to the v2 endpoint and now returnsTaskIDListinstead ofRouter - Added
update_and_poll()method toRoutersResourceandAsyncRoutersResource— updates a router, waits for the first task to finish, and returnsRouter
- ⚠ BREAKING CHANGE:
-
User Actions
- Added
replaceto audit log action filters - Added
replace_gpu_baremetal_serverto task type filters intasks.list()
- Added
IAM
- API Tokens
- Added V2 API token endpoints to
create(),list(),get(), anddelete()— token operations now use/iam/v2/clients/{client_id}/tokens - ⚠ BREAKING CHANGE: newly created
APITokenCreated.tokenvalues now use_instead of$as the separator between token ID and secret
- Added V2 API token endpoints to
Object Storage
- Added
get()method toaccess_keys— fetches a specific access key by storage ID and access key ID
WAAP
- Analytics
- Added
exclude_countries,exclude_domains,exclude_ips,exclude_reference_ids,exclude_security_rule_names, andexclude_session_idsfilters to analytics request params - Added
bucket_sizetoAnalyticsGetTrafficParamsandAnalyticsGetTrafficFilteredParams— sets explicit aggregation bucket width in seconds
- Added
Other
- Added
GCORE_CUSTOM_HEADERSenvironment variable support — newline-delimitedHeader: Valueentries are applied automatically as default request headers - Fixed multipart file array field serialization — file uploads now respect the configured array format instead of always using
[]
0.45.0 (2026-05-04)
Full Changelog: v0.44.0...v0.45.0
⚠ BREAKING CHANGES
- cloud: switch routers update from v1 to v2
- cloud: correct pg conf validation response model name
Features
- api: aggregated API specs update (ee5d831)
- api: aggregated API specs update (98209fa)
- api: aggregated API specs update (377df41)
- api: aggregated API specs update (8985183)
- api: aggregated API specs update (680e40d)
- cloud: add update_and_poll method for routers (6a3523a)
- cloud: switch routers update from v1 to v2 (a4499c7)
- cloud: use routers update_and_poll in network examples (f3e9aa6)
- iam: migrate api_tokens to v2 endpoints (fad3629)
- storage: add get method for access keys (b7a6c07)
- support setting headers via env (48f6c89)
Bug Fixes
- cloud: correct pg conf validation response model name (c5bc635)
- cloud: match hw_machine_type literal in instances images poll methods (1c3322d)
- use correct field name format for multipart file arrays (5db7792)
Chores
- internal: reformat pyproject.toml (4701fe6)
v0.44.0
We're excited to announce version 0.44.0!
Cloud
-
Load Balancers
- Added
namefilter param toPoolListParams— filter pools by name
- Added
-
Managed PostgreSQL
- Added
namefilter param toClusterListParams— filter clusters by name - ⚠ BREAKING CHANGE: Renamed response type
PgConfValidationtoCustomConfigurationValidateResponse—custom_configurations.validate()return type updated accordingly
- Added
IAM
- Users
UserUpdateParams.emailchanged fromRequired[str]tostr(optional) — all fields onUserUpdateParams(name,phone,email,auth_types,lang) are now optional, restoring true PATCH semantics
Object Storage
-
Buckets
- ⚠ BREAKING CHANGE:
client.storage.object_storages.buckets.create()return type changed fromBucketCreatedtoBucket - ⚠ BREAKING CHANGE: Removed
BucketCreatedtype and its nested types (Cors,Lifecycle,Policy) — the unifiedBuckettype is now returned on creation
- ⚠ BREAKING CHANGE:
-
S3 Storages
- Added
full_namefield toS3StorageandS3StorageCreated— read-only internal full name composed as{client_id}-{name}
- Added
-
SFTP Storages
- Added
full_namefield toSftpStorage— read-only internal full name used as the SFTP login username
- Added
0.44.0 (2026-04-27)
Full Changelog: v0.43.0...v0.44.0
Features
- api: aggregated API specs update (5b07224)
- api: aggregated API specs update (9900f97)
- storage: support TF for ssh keys (b4a70d5)
Chores
- internal: more robust bootstrap script (8915d9b)
v0.43.0
We're excited to announce version 0.43.0!
CDN
-
CDN Resources
- ⚠ BREAKING CHANGE: Removed the
bot_protectionandrequest_limiteroptions fromCDNResource
- ⚠ BREAKING CHANGE: Removed the
-
Rule Templates
- ⚠ BREAKING CHANGE: Removed the
bot_protectionandrequest_limiteroptions fromRuleTemplate
- ⚠ BREAKING CHANGE: Removed the
-
Rules
- ⚠ BREAKING CHANGE: Removed the
bot_protectionandrequest_limiteroptions fromCDNResourceRule
- ⚠ BREAKING CHANGE: Removed the
Cloud
-
GPU Bare Metal
- Added sync and async examples for listing, uploading, retrieving, and deleting cluster images
-
Managed Kubernetes
- Added
create_and_poll(),update_and_poll(),upgrade_and_poll(), anddelete_and_poll()toclient.cloud.k8s.clusters— poll task-backed cluster operations and return the refreshedK8SClusterresult - Added
create_and_poll(),resize_and_poll(), anddelete_and_poll()toclient.cloud.k8s.clusters.pools— poll task-backed pool operations and return the refreshedK8SClusterPoolresult where applicable
- Added
IAM
- API Tokens
- Deprecated
api_tokens.create(),api_tokens.list(),api_tokens.get(), andapi_tokens.delete()
- Deprecated
Other
- Fixed multipart request handling performance — file extraction now avoids copying untouched nested containers in request bodies
0.43.0 (2026-04-22)
Full Changelog: v0.42.0...v0.43.0
Features
- api: aggregated API specs update (7d70fe4)
- api: aggregated API specs update (2e269b6)
- api: aggregated API specs update (96cd4c9)
- api: aggregated API specs update (8b6d277)
- cloud: add examples for GPU baremetal cluster images (7279536)
- cloud: add polling methods for K8s clusters and pools (76bd4c9)
- cloud: add runnable K8s cluster example (030f335)
- storage: support Terraform generation for locations (063f1f4)
Bug Fixes
- add rule to omit doc-only changes from release notes (45bae59)
Performance Improvements
- client: optimize file structure copying in multipart requests (2fd1bcb)
Chores
v0.42.0
We're excited to announce version 0.42.0!
CDN
-
CDN Resources
- ⚠ BREAKING CHANGE:
rules.list()return type changed fromSyncOffsetPage[CDNResourceRule]toCDNResourceRuleList— pagination response structure updated
- ⚠ BREAKING CHANGE:
-
Origin Groups
- Deprecated
auth_typefield — no longer necessary, defaults tonone - Deprecated
pathfield — no longer necessary; omit to use default origin path behavior - Made
auth_typeandpathoptional inorigin_group_replace_params(previouslyRequired) - Deprecated
AwsSignatureV4andAwsSignatureV4Authtypes — to create S3 origins, configure them directly insourceswithorigin_typeandconfiginstead
- Deprecated
-
Origin Shielding
- ⚠ BREAKING CHANGE:
shields.list()return type changed fromSyncOffsetPage[ShieldListResponse]toShieldListResponse— pagination response structure updated
- ⚠ BREAKING CHANGE:
-
Rule Templates
- ⚠ BREAKING CHANGE:
rule_templates.list()return type changed fromSyncOffsetPage[RuleTemplate]toRuleTemplateList— pagination response structure updated
- ⚠ BREAKING CHANGE:
Cloud
-
Bare Metal
- Added
BaremetalImagetype andBaremetalImageListtype — baremetal images now use dedicated types separate from instance images - Updated examples to use
BaremetalImageinstead ofImage
- Added
-
GPU Bare Metal
- Added
create_and_poll()method to clusters — create a cluster and wait for completion - Added
delete_and_poll()method to clusters — delete a cluster and wait for completion - Added new example files for GPU baremetal clusters
- Added
-
GPU Virtual
- Added
create_and_poll()method to clusters — create a cluster and wait for completion - Added
delete_and_poll()method to clusters — delete a cluster and wait for completion - Added new example files for GPU virtual clusters
- Added
-
Instances
- Added
Imagetype,ImageListtype, andImageListParams— instance images now use dedicated types separate from baremetal images - Added
image_create_from_volume_paramsfor creating images from volumes
- Added
-
Load Balancers
- Added
limitandoffsetpagination parameters to flavor listing - Added
limitandoffsetpagination parameters to L7 policies, listeners, and pools listings - Added dedicated list params types:
L7PolicyListParams,rule_list_params,ListenerListParams,PoolListParams
- Added
-
Networks
- Added
namefilter parameter to router listing - Added docstrings for
project_idandregion_idon router create and list params
- Added
-
Security Groups
- ⚠ Removed
"any"from the security-group-ruleprotocolenum inrule_create_params— usenull(omitted) for "all protocols" instead - Made
protocolnullable (Optional) on security-group-rule create
- ⚠ Removed
-
Everywhere Inference
- ⚠ BREAKING CHANGE: Removed
cloud.inference.deployments.get_api_key()method — usecloud.inference.api_keys.get()instead
- ⚠ BREAKING CHANGE: Removed
DNS
- Network Mappings
- Fixed
get_by_name()endpoint path — updated to new API endpoint
- Fixed
WAAP
- Domains
- Added
http_versionfield toWaapRequestSummary - Added
schemefield toWaapRequestSummary - Updated
schemedescription onWaapRequestDetails(clarified as URI scheme)
- Added
Other
- Fixed client to preserve hardcoded query params when merging with user params
- Fixed file data handling to ensure files are only sent as a single parameter
- Aligned polling methods with underlying base method signatures
0.42.0 (2026-04-17)
Full Changelog: v0.41.0...v0.42.0
⚠ BREAKING CHANGES
- cloud: remove deprecated cloud.inference.deployments.get_api_key
Features
- api: aggregated API specs update (284df4c)
- api: aggregated API specs update (0110236)
- api: aggregated API specs update (51ad9c9)
- api: aggregated API specs update (eda0539)
- api: aggregated API specs update (01be2f5)
- api: aggregated API specs update (7beaf49)
- api: aggregated API specs update (2f8fb0a)
- api: fix(cdn): harmonize pagination across CDN list endpoints (c95a0b8)
- cloud: add delete_and_poll and examples for GPU baremetal clusters (adc8f40)
- cloud: add polling methods and examples for GPU virtual clusters (1ed9b85)
Bug Fixes
- client: preserve hardcoded query params when merging with user params (0971eaa)
- cloud: align polling methods with underlying base method (4b99901)
- dns: update network-mappings get_by_name to new endpoint path (de11047)
- ensure file data are only sent as 1 parameter (16f4262)
- examples: update baremetal image examples to use BaremetalImage type (7e924f8)
Chores
- cloud: remove deprecated cloud.inference.deployments.get_api_key (1bf3513)
Documentation
- update examples (fa05d93)
Refactors
- cloud: split instance and baremetal image models (fce124a)