Method CreateVersionAsync

CreateVersionAsync(ServiceVersionParameters, CancellationToken)

Asynchronously creates a new version in the service based on the default version.

Declaration

public Task<ServiceVersionInfo> CreateVersionAsync(ServiceVersionParameters newVersion, CancellationToken cancellationToken)

Parameters

Type	Name	Description
ServiceVersionParameters	newVersion	The properties of the new version
System.Threading.CancellationToken	cancellationToken	A System.Threading.CancellationToken with which to cancel the operation if required.

Returns

Type	Description
System.Threading.Tasks.Task<ServiceVersionInfo>	A task that represents the creation of new service version. The value of the task result contains the full metadata ServiceVersionInfo for the new version.

Remarks

If the version parameters do not include a name, an error is thrown. Branch versioning requires that the default version always be the ancestor of all other versions. If the service isn't branch versioned, a BranchVersioningNotSupportedByServiceException is thrown.

Exceptions

Type	Condition
System.ArgumentException
BranchVersioningNotSupportedByServiceException

Applies to

Platforms and versions

Target	Versions
.NET Standard 2.0	100.12 - 200.8
.NET	100.13 - 200.8
.NET Windows	100.13 - 200.8
.NET Android	200.2 - 200.8
.NET iOS	200.0 - 200.8
.NET Framework	100.12 - 200.8
Xamarin.Android	100.12 - 100.14
Xamarin.iOS	100.12 - 100.15
UWP	100.12 - 200.8

CreateVersionAsync(ServiceVersionParameters)