Skip to content

Commit 2fe54f1

Browse files
Update to latest spec and tag for 7.0.0
This update is technically a breaking change because the SetClusterVersionDeferral endpoint now accepts a new request type, ClusterVersionDeferralUpdate. Changes include: - new CockroachCloudServicePrincipals field in the Organization model - new Aws, Azure, Gcp, and CockroachCloudServicePrincipal models - new organization user roles - new audit log actions: - new audit log source - updated dedicated hardware disk_iops documentation - SetClusterVersionDeferral now accepts ClusterVersionDeferralUpdate instead of ClusterVersionDeferral
1 parent bb4c21f commit 2fe54f1

50 files changed

Lines changed: 1168 additions & 175 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

CHANGELOG.md

Lines changed: 18 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,13 +7,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
77

88
## [Unreleased]
99

10+
## [7.0.0] - 2026-04-08
11+
1012
### Added
1113

14+
- Added `CockroachCloudServicePrincipals` field to `Organization` model, containing
15+
cloud provider service principal information (AWS, Azure, GCP).
16+
- Added new models: `Aws`, `Azure`, `Gcp`, `CockroachCloudServicePrincipals`.
17+
- Added `StartTime` and `EndTime` optional filters to `ListInvoicesOptions`.
18+
- Added `PaginationSortBy` option to `ListClustersOptions`, supporting sorting by
19+
`NAME`, `CREATED_AT`, or `DELETED_AT`.
20+
- Added new organization user roles: `METRICS_VIEWER`, `CLUSTER_MONITOR`, `BILLING_VIEWER`.
21+
- Added new audit log actions: `UPDATE_CLUSTER_DISRUPTION`, `SET_CLUSTER_SETTING`,
22+
`EVICT_BYOC_CLUSTER`, `MCP_OAUTH_CONSENT`.
23+
- Added new audit log source: `MCP`.
1224
- Added release workflow that auto-tags from CHANGELOG and dispatches
1325
sdk-release events to ccloud-private. Requires a `CCLOUD_PRIVATE_DISPATCH_PAT`
1426
repository secret (fine-grained PAT with contents:write on
1527
cockroachdb/ccloud-private) and a corresponding `repository_dispatch`
16-
workflow in ccloud-private to handle the `sdk-release` event
28+
workflow in ccloud-private to handle the `sdk-release` event.
29+
30+
### Changed
31+
32+
- Breaking Change: `SetClusterVersionDeferral` now accepts a `ClusterVersionDeferralUpdate`
33+
request body instead of `ClusterVersionDeferral`.
1734

1835
## [6.10.0] - 2025-11-19
1936

README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
This API client was generated by the [OpenAPI Generator](https://openapi-generator.tech) project. By using the [OpenAPI-spec](https://www.openapis.org/) from a remote server, you can easily generate an API client.
55

66
- API version: 2024-09-16
7-
- Package version: 6.9.0
7+
- Package version: 7.0.0
88
- Build package: org.openapitools.codegen.languages.GoClientCodegen
99
For more information, please visit [https://support.cockroachlabs.com](https://support.cockroachlabs.com)
1010

@@ -13,13 +13,13 @@ For more information, please visit [https://support.cockroachlabs.com](https://s
1313
Install the package:
1414

1515
```shell
16-
go get github.com/cockroachdb/cockroach-cloud-sdk-go/v6
16+
go get github.com/cockroachdb/cockroach-cloud-sdk-go/v7
1717
```
1818

1919
Import the package:
2020

2121
```golang
22-
import "github.com/cockroachdb/cockroach-cloud-sdk-go/v6/pkg/client"
22+
import "github.com/cockroachdb/cockroach-cloud-sdk-go/v7/pkg/client"
2323
```
2424

2525
## Example Client Usage

docs/AuditLogAction.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -190,6 +190,14 @@
190190

191191
* `END_FAULT_TOLERANCE_DEMO` (value: `"AUDIT_LOG_ACTION_END_FAULT_TOLERANCE_DEMO"`)
192192

193+
* `UPDATE_CLUSTER_DISRUPTION` (value: `"AUDIT_LOG_ACTION_UPDATE_CLUSTER_DISRUPTION"`)
194+
195+
* `SET_CLUSTER_SETTING` (value: `"AUDIT_LOG_ACTION_SET_CLUSTER_SETTING"`)
196+
197+
* `EVICT_BYOC_CLUSTER` (value: `"AUDIT_LOG_ACTION_EVICT_BYOC_CLUSTER"`)
198+
199+
* `MCP_OAUTH_CONSENT` (value: `"AUDIT_LOG_ACTION_MCP_OAUTH_CONSENT"`)
200+
193201

194202
[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
195203

docs/AuditLogSource.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,8 @@
1010

1111
* `INTERNAL` (value: `"AUDIT_LOG_SOURCE_INTERNAL"`)
1212

13+
* `MCP` (value: `"AUDIT_LOG_SOURCE_MCP"`)
14+
1315

1416
[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
1517

docs/Aws.md

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
# Aws
2+
3+
## Properties
4+
5+
Name | Type | Description | Notes
6+
------------ | ------------- | ------------- | -------------
7+
**UserArn** | Pointer to **string** | | [optional]
8+
9+
## Methods
10+
11+
### NewAws
12+
13+
`func NewAws() *Aws`
14+
15+
NewAws instantiates a new Aws object.
16+
This constructor will assign default values to properties that have it defined,
17+
and makes sure properties required by API are set, but the set of arguments
18+
will change when the set of required properties is changed.
19+
20+
### GetUserArn
21+
22+
`func (o *Aws) GetUserArn() string`
23+
24+
GetUserArn returns the UserArn field if non-nil, zero value otherwise.
25+
26+
### SetUserArn
27+
28+
`func (o *Aws) SetUserArn(v string)`
29+
30+
SetUserArn sets UserArn field to given value.
31+
32+
33+
[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
34+
35+

docs/Azure.md

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
# Azure
2+
3+
## Properties
4+
5+
Name | Type | Description | Notes
6+
------------ | ------------- | ------------- | -------------
7+
**AppRegistrationClientId** | Pointer to **string** | | [optional]
8+
**AppRegistrationName** | Pointer to **string** | | [optional]
9+
10+
## Methods
11+
12+
### NewAzure
13+
14+
`func NewAzure() *Azure`
15+
16+
NewAzure instantiates a new Azure object.
17+
This constructor will assign default values to properties that have it defined,
18+
and makes sure properties required by API are set, but the set of arguments
19+
will change when the set of required properties is changed.
20+
21+
### GetAppRegistrationClientId
22+
23+
`func (o *Azure) GetAppRegistrationClientId() string`
24+
25+
GetAppRegistrationClientId returns the AppRegistrationClientId field if non-nil, zero value otherwise.
26+
27+
### SetAppRegistrationClientId
28+
29+
`func (o *Azure) SetAppRegistrationClientId(v string)`
30+
31+
SetAppRegistrationClientId sets AppRegistrationClientId field to given value.
32+
33+
### GetAppRegistrationName
34+
35+
`func (o *Azure) GetAppRegistrationName() string`
36+
37+
GetAppRegistrationName returns the AppRegistrationName field if non-nil, zero value otherwise.
38+
39+
### SetAppRegistrationName
40+
41+
`func (o *Azure) SetAppRegistrationName(v string)`
42+
43+
SetAppRegistrationName sets AppRegistrationName field to given value.
44+
45+
46+
[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
47+
48+

docs/BackupConfiguration.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
Name | Type | Description | Notes
66
------------ | ------------- | ------------- | -------------
77
**Enabled** | **bool** | Indicates whether backups are enabled. |
8-
**FrequencyMinutes** | **int32** | How frequently in minutes that backups are taken, which will determine the [RPO](https://www.cockroachlabs.com/docs/stable/disaster-recovery-overview#resilience-strategy) of the cluster. |
8+
**FrequencyMinutes** | **int32** | How frequently in minutes that backups are taken, which will determine the [RPO](https://www.cockroachlabs.com/docs/stable/disaster-recovery-overview) of the cluster. |
99
**RetentionDays** | **int32** | The number of days backups are retained for. |
1010

1111
## Methods

docs/BillingApi.md

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -80,7 +80,7 @@ Name | Type | Description | Notes
8080

8181
## ListInvoices
8282

83-
> ListInvoicesResponse ListInvoices(ctx).Status(status).Execute()
83+
> ListInvoicesResponse ListInvoices(ctx).Status(status).StartTime(startTime).EndTime(endTime).Execute()
8484
8585
List invoices for a given organization
8686

@@ -100,15 +100,18 @@ import (
100100
"context"
101101
"fmt"
102102
"os"
103+
"time"
103104
openapiclient "./openapi"
104105
)
105106

106107
func main() {
107108
status := "status_example" // string | Filters the response to only include invoices with the specified status. This will be sent as a query parameter on the GET request. If not specified, both Finalized and Draft invoices will be included. (optional)
109+
startTime := time.Now() // time.Time | start_time filters the response to invoices whose billing period started at or after this time (inclusive). Defaults to organization creation time if omitted. (optional)
110+
endTime := time.Now() // time.Time | end_time filters the response to invoices whose billing period ended at or before this time (exclusive). Defaults to current time if omitted. (optional)
108111

109112
configuration := openapiclient.NewConfiguration()
110113
api_client := openapiclient.NewClient(configuration)
111-
resp, r, err := api_client.BillingApi.ListInvoices(context.Background()).Status(status).Execute()
114+
resp, r, err := api_client.BillingApi.ListInvoices(context.Background()).Status(status).StartTime(startTime).EndTime(endTime).Execute()
112115
if err != nil {
113116
fmt.Fprintf(os.Stderr, "Error when calling `BillingApi.ListInvoices``: %v\n", err)
114117
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
@@ -131,6 +134,8 @@ Optional parameters can be passed through a pointer to the ListInvoicesOptions s
131134
Name | Type | Description | Notes
132135
------------- | ------------- | ------------- | -------------
133136
**status** | **string** | Filters the response to only include invoices with the specified status. This will be sent as a query parameter on the GET request. If not specified, both Finalized and Draft invoices will be included. |
137+
**startTime** | **time.Time** | start_time filters the response to invoices whose billing period started at or after this time (inclusive). Defaults to organization creation time if omitted. |
138+
**endTime** | **time.Time** | end_time filters the response to invoices whose billing period ended at or before this time (exclusive). Defaults to current time if omitted. |
134139

135140
### Return type
136141

docs/ClusterVersionDeferralPolicyType.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
# ClusterVersionDeferralPolicyType
22

33
## Enum
4+
> - NOT_DEFERRED: automatic patch version upgrades are applied immediately after release. - DEFERRAL_60_DAYS: automatic patch version upgrades are applied in a maintenance window at least 60 days after the patch version release date. - FIXED_DEFERRAL: Deprecated: FIXED_DEFERRAL is equivalent to DEFERRAL_60_DAYS. It will be removed in a future version. - DEFERRAL_30_DAYS: automatic patch version upgrades are applied in a maintenance window at least 30 days after the patch version release date. - DEFERRAL_90_DAYS: automatic patch version upgrades are applied in a maintenance window at least 90 days after the patch version release date.
45
56
* `NOT_DEFERRED` (value: `"NOT_DEFERRED"`)
67

Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
# ClusterVersionDeferralUpdate
2+
3+
## Properties
4+
5+
Name | Type | Description | Notes
6+
------------ | ------------- | ------------- | -------------
7+
**DeferralPolicy** | [**ClusterVersionDeferralPolicyType**](ClusterVersionDeferralPolicyType.md) | |
8+
**DeferredUntil** | Pointer to **time.Time** | Deprecated: This field is ignored and will be removed in a future version. | [optional]
9+
10+
## Methods
11+
12+
### NewClusterVersionDeferralUpdate
13+
14+
`func NewClusterVersionDeferralUpdate(deferralPolicy ClusterVersionDeferralPolicyType, ) *ClusterVersionDeferralUpdate`
15+
16+
NewClusterVersionDeferralUpdate instantiates a new ClusterVersionDeferralUpdate object.
17+
This constructor will assign default values to properties that have it defined,
18+
and makes sure properties required by API are set, but the set of arguments
19+
will change when the set of required properties is changed.
20+
21+
### NewClusterVersionDeferralUpdateWithDefaults
22+
23+
`func NewClusterVersionDeferralUpdateWithDefaults() *ClusterVersionDeferralUpdate`
24+
25+
NewClusterVersionDeferralUpdateWithDefaults instantiates a new ClusterVersionDeferralUpdate object.
26+
This constructor will only assign default values to properties that have it defined,
27+
but it doesn't guarantee that properties required by API are set.
28+
29+
### GetDeferralPolicy
30+
31+
`func (o *ClusterVersionDeferralUpdate) GetDeferralPolicy() ClusterVersionDeferralPolicyType`
32+
33+
GetDeferralPolicy returns the DeferralPolicy field if non-nil, zero value otherwise.
34+
35+
### SetDeferralPolicy
36+
37+
`func (o *ClusterVersionDeferralUpdate) SetDeferralPolicy(v ClusterVersionDeferralPolicyType)`
38+
39+
SetDeferralPolicy sets DeferralPolicy field to given value.
40+
41+
### GetDeferredUntil
42+
43+
`func (o *ClusterVersionDeferralUpdate) GetDeferredUntil() time.Time`
44+
45+
GetDeferredUntil returns the DeferredUntil field if non-nil, zero value otherwise.
46+
47+
### SetDeferredUntil
48+
49+
`func (o *ClusterVersionDeferralUpdate) SetDeferredUntil(v time.Time)`
50+
51+
SetDeferredUntil sets DeferredUntil field to given value.
52+
53+
54+
[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
55+
56+

0 commit comments

Comments
 (0)