Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Release] sdk/resourcemanager/netapp/armnetapp/4.0.0 #20361

Merged
merged 8 commits into from
Mar 24, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 36 additions & 0 deletions sdk/resourcemanager/netapp/armnetapp/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,41 @@
# Release History

## 4.0.0 (2023-03-24)
### Breaking Changes

- Type of `Account.Identity` has been changed from `*Identity` to `*ManagedServiceIdentity`
- Type alias `IdentityType` has been removed
- Function `NewVaultsClient` has been removed
- Function `*VaultsClient.NewListPager` has been removed
- Struct `Identity` has been removed
- Struct `Vault` has been removed
- Struct `VaultList` has been removed
- Struct `VaultProperties` has been removed
- Struct `VaultsClient` has been removed
- Field `VaultID` of struct `VolumeBackupProperties` has been removed

### Features Added

- New struct `ClientFactory` which is a client factory used to create any client in this module
- New enum type `FileAccessLogs` with values `FileAccessLogsDisabled`, `FileAccessLogsEnabled`
- New enum type `ManagedServiceIdentityType` with values `ManagedServiceIdentityTypeNone`, `ManagedServiceIdentityTypeSystemAssigned`, `ManagedServiceIdentityTypeSystemAssignedUserAssigned`, `ManagedServiceIdentityTypeUserAssigned`
- New function `*BackupsClient.BeginRestoreFiles(context.Context, string, string, string, string, string, BackupRestoreFiles, *BackupsClientBeginRestoreFilesOptions) (*runtime.Poller[BackupsClientRestoreFilesResponse], error)`
- New function `*VolumesClient.BeginBreakFileLocks(context.Context, string, string, string, string, *VolumesClientBeginBreakFileLocksOptions) (*runtime.Poller[VolumesClientBreakFileLocksResponse], error)`
- New struct `BackupRestoreFiles`
- New struct `BreakFileLocksRequest`
- New struct `ManagedServiceIdentity`
- New struct `VolumeRelocationProperties`
- New field `PreferredServersForLdapClient` in struct `ActiveDirectory`
- New field `SystemData` in struct `Backup`
- New field `SystemData` in struct `Snapshot`
- New field `DataStoreResourceID` in struct `VolumeProperties`
- New field `FileAccessLogs` in struct `VolumeProperties`
- New field `IsLargeVolume` in struct `VolumeProperties`
- New field `ProvisionedAvailabilityZone` in struct `VolumeProperties`
- New field `VolumeRelocation` in struct `VolumePropertiesDataProtection`
- New field `Tags` in struct `VolumeQuotaRulePatch`


## 3.0.0 (2022-09-16)
### Breaking Changes

Expand Down
17 changes: 13 additions & 4 deletions sdk/resourcemanager/netapp/armnetapp/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,12 +33,12 @@ cred, err := azidentity.NewDefaultAzureCredential(nil)

For more information on authentication, please see the documentation for `azidentity` at [pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/azidentity](https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/azidentity).

## Clients
## Client Factory

Azure NetApp Files modules consist of one or more clients. A client groups a set of related APIs, providing access to its functionality within the specified subscription. Create one or more clients to access the APIs you require using your credential.
Azure NetApp Files module consists of one or more clients. We provide a client factory which could be used to create any client in this module.

```go
client, err := armnetapp.NewBackupsClient(<subscription ID>, cred, nil)
clientFactory, err := armnetapp.NewClientFactory(<subscription ID>, cred, nil)
```

You can use `ClientOptions` in package `github.com/Azure/azure-sdk-for-go/sdk/azcore/arm` to set endpoint to connect with public and sovereign clouds as well as Azure Stack. For more information, please see the documentation for `azcore` at [pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/azcore](https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/azcore).
Expand All @@ -49,9 +49,18 @@ options := arm.ClientOptions {
Cloud: cloud.AzureChina,
},
}
client, err := armnetapp.NewBackupsClient(<subscription ID>, cred, &options)
clientFactory, err := armnetapp.NewClientFactory(<subscription ID>, cred, &options)
```

## Clients

A client groups a set of related APIs, providing access to its functionality. Create one or more clients to access the APIs you require using client factory.

```go
client := clientFactory.NewBackupsClient()
```


## Major Version Upgrade

Go uses [semantic import versioning](https://github.com/golang/go/wiki/Modules#semantic-import-versioning) to ensure a good backward compatibility for modules. For Azure Go management SDK, we usually upgrade module version according to cooresponding service's API version. Regarding it could be a complicated experience for major version upgrade, we will try our best to keep the SDK API stable and release new version in backward compatible way. However, if any unavoidable breaking changes and a new major version releases for SDK modules, you could use these commands under your module folder to upgrade:
Expand Down
82 changes: 37 additions & 45 deletions sdk/resourcemanager/netapp/armnetapp/accountbackups_client.go

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading