IBlobContainersOperations.CreateOrUpdateImmutabilityPolicyWithHttpMessagesAsync(String, String, String, String, Nullable<Int32>, Nullable<Boolean>, Dictionary<String,List<String>>, CancellationToken) 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 an unlocked immutability policy. ETag in If-Match is honored if given but not required for this operation.
public System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse<Microsoft.Azure.Management.Storage.Models.ImmutabilityPolicy,Microsoft.Azure.Management.Storage.Models.BlobContainersCreateOrUpdateImmutabilityPolicyHeaders>> CreateOrUpdateImmutabilityPolicyWithHttpMessagesAsync (string resourceGroupName, string accountName, string containerName, string ifMatch = default, int? immutabilityPeriodSinceCreationInDays = default, bool? allowProtectedAppendWrites = default, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);abstract member CreateOrUpdateImmutabilityPolicyWithHttpMessagesAsync : string * string * string * string * Nullable<int> * Nullable<bool> * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse<Microsoft.Azure.Management.Storage.Models.ImmutabilityPolicy, Microsoft.Azure.Management.Storage.Models.BlobContainersCreateOrUpdateImmutabilityPolicyHeaders>>Public Function CreateOrUpdateImmutabilityPolicyWithHttpMessagesAsync (resourceGroupName As String, accountName As String, containerName As String, Optional ifMatch As String = Nothing, Optional immutabilityPeriodSinceCreationInDays As Nullable(Of Integer) = Nothing, Optional allowProtectedAppendWrites As Nullable(Of Boolean) = Nothing, Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of AzureOperationResponse(Of ImmutabilityPolicy, BlobContainersCreateOrUpdateImmutabilityPolicyHeaders))Parameters
- resourceGroupName
- System.String
The name of the resource group within the user's subscription. The name is case insensitive.
- accountName
- System.String
The name of the storage account within the specified resource group. Storage account names must be between 3 and 24 characters in length and use numbers and lower-case letters only.
- containerName
- System.String
The name of the blob container within the specified storage account. Blob container names must be between 3 and 63 characters in length and use numbers, lower-case letters and dash (-) only. Every dash (-) character must be immediately preceded and followed by a letter or number.
- ifMatch
- System.String
The entity state (ETag) version of the immutability policy to update. A value of "*" can be used to apply the operation only if the immutability policy already exists. If omitted, this operation will always be applied.
- immutabilityPeriodSinceCreationInDays
- System.Nullable<System.Int32>
The immutability period for the blobs in the container since the policy creation, in days.
- allowProtectedAppendWrites
- System.Nullable<System.Boolean>
This property can only be changed for unlocked time-based retention policies. When enabled, new blocks can be written to an append blob while maintaining immutability protection and compliance. Only new blocks can be added and any existing blocks cannot be modified or deleted. This property cannot be changed with ExtendImmutabilityPolicy API
- customHeaders
- System.Collections.Generic.Dictionary<System.String,System.Collections.Generic.List<System.String>>
The headers that will be added to request.
- cancellationToken
- System.Threading.CancellationToken
The cancellation token.
Returns
- System.Threading.Tasks.Task<AzureOperationResponse<ImmutabilityPolicy,BlobContainersCreateOrUpdateImmutabilityPolicyHeaders>>
Exceptions
Thrown when the operation returned an invalid status code
Thrown when unable to deserialize the response
Thrown when a required parameter is null