SqlServerKeyCollection.CreateOrUpdateAsync Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Creates or updates a server key.
- Request Path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/keys/{keyName}
- Operation Id: ServerKeys_CreateOrUpdate
- Default Api Version: 2020-11-01-preview
- Resource: SqlServerKeyResource
public virtual System.Threading.Tasks.Task<Azure.ResourceManager.ArmOperation<Azure.ResourceManager.Sql.SqlServerKeyResource>> CreateOrUpdateAsync (Azure.WaitUntil waitUntil, string keyName, Azure.ResourceManager.Sql.SqlServerKeyData data, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateOrUpdateAsync : Azure.WaitUntil * string * Azure.ResourceManager.Sql.SqlServerKeyData * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.ResourceManager.ArmOperation<Azure.ResourceManager.Sql.SqlServerKeyResource>>
override this.CreateOrUpdateAsync : Azure.WaitUntil * string * Azure.ResourceManager.Sql.SqlServerKeyData * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.ResourceManager.ArmOperation<Azure.ResourceManager.Sql.SqlServerKeyResource>>
Public Overridable Function CreateOrUpdateAsync (waitUntil As WaitUntil, keyName As String, data As SqlServerKeyData, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ArmOperation(Of SqlServerKeyResource))
Parameters
- waitUntil
- WaitUntil
Completed if the method should wait to return until the long-running operation has completed on the service; Started if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples.
- keyName
- String
The name of the server key to be operated on (updated or created). The key name is required to be in the format of 'vault_key_version'. For example, if the keyId is https://YourVaultName.vault.azure.net/keys/YourKeyName/YourKeyVersion, then the server key name should be formatted as: YourVaultName_YourKeyName_YourKeyVersion.
- data
- SqlServerKeyData
The requested server key resource state.
- cancellationToken
- CancellationToken
The cancellation token to use.
Returns
Exceptions
keyName
is an empty string, and was expected to be non-empty.
keyName
or data
is null.