[Az.RecoveryServices.Backup] Fixed bugs, added documentation and examples

src/RecoveryServices/RecoveryServices.Backup.CrossRegionRestore.Management.Sdk/Generated/IRecoveryPointsCrrOperations.cs

@@ -63,6 +63,45 @@ public partial interface IRecoveryPointsCrrOperations
  /// </exception>
  Task<AzureOperationResponse<IPage<RecoveryPointResource>>> ListWithHttpMessagesAsync(string vaultName, string resourceGroupName, string fabricName, string containerName, string protectedItemName, ODataQuery<BMSRPQueryObject> odataQuery = default(ODataQuery<BMSRPQueryObject>), Dictionary<string, List<string>> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken));
  /// <summary>
+ /// Provides the information of the backed up data identified using
+ /// RecoveryPointID.
+ /// </summary>
+ /// <param name='vaultName'>
+ /// The name of the recovery services vault.
+ /// </param>
+ /// <param name='resourceGroupName'>
+ /// The name of the resource group where the recovery services vault is
+ /// present.
+ /// </param>
+ /// <param name='fabricName'>
+ /// Fabric name associated with backed up item.
+ /// </param>
+ /// <param name='containerName'>
+ /// Container name associated with backed up item.
+ /// </param>
+ /// <param name='protectedItemName'>
+ /// Backed up item name whose backup data needs to be fetched.
+ /// </param>
+ /// <param name='recoveryPointId'>
+ /// RecoveryPointID represents the backed up data to be fetched.
+ /// </param>
+ /// <param name='customHeaders'>
+ /// The headers that will be added to request.
+ /// </param>
+ /// <param name='cancellationToken'>
+ /// The cancellation token.
+ /// </param>
+ /// <exception cref="NewErrorResponseException">
+ /// Thrown when the operation returned an invalid status code
+ /// </exception>
+ /// <exception cref="Microsoft.Rest.SerializationException">
+ /// Thrown when unable to deserialize the response
+ /// </exception>
+ /// <exception cref="Microsoft.Rest.ValidationException">
+ /// Thrown when a required parameter is null
+ /// </exception>
+ Task<AzureOperationResponse<RecoveryPointResource>> GetWithHttpMessagesAsync(string vaultName, string resourceGroupName, string fabricName, string containerName, string protectedItemName, string recoveryPointId, Dictionary<string, List<string>> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken));
+ /// <summary>
  /// Lists the backup copies for the backed up item.
  /// </summary>
  /// <param name='nextPageLink'>

src/RecoveryServices/RecoveryServices.Backup.CrossRegionRestore.Management.Sdk/Generated/RecoveryPointsCrrOperations.cs

@@ -282,6 +282,235 @@ internal RecoveryPointsCrrOperations(RecoveryServicesBackupClient client)
  return _result;
  }
 
+ /// <summary>
+ /// Provides the information of the backed up data identified using
+ /// RecoveryPointID.
+ /// </summary>
+ /// <param name='vaultName'>
+ /// The name of the recovery services vault.
+ /// </param>
+ /// <param name='resourceGroupName'>
+ /// The name of the resource group where the recovery services vault is
+ /// present.
+ /// </param>
+ /// <param name='fabricName'>
+ /// Fabric name associated with backed up item.
+ /// </param>
+ /// <param name='containerName'>
+ /// Container name associated with backed up item.
+ /// </param>
+ /// <param name='protectedItemName'>
+ /// Backed up item name whose backup data needs to be fetched.
+ /// </param>
+ /// <param name='recoveryPointId'>
+ /// RecoveryPointID represents the backed up data to be fetched.
+ /// </param>
+ /// <param name='customHeaders'>
+ /// Headers that will be added to request.
+ /// </param>
+ /// <param name='cancellationToken'>
+ /// The cancellation token.
+ /// </param>
+ /// <exception cref="NewErrorResponseException">
+ /// Thrown when the operation returned an invalid status code
+ /// </exception>
+ /// <exception cref="SerializationException">
+ /// Thrown when unable to deserialize the response
+ /// </exception>
+ /// <exception cref="ValidationException">
+ /// Thrown when a required parameter is null
+ /// </exception>
+ /// <exception cref="System.ArgumentNullException">
+ /// Thrown when a required parameter is null
+ /// </exception>
+ /// <return>
+ /// A response object containing the response body and response headers.
+ /// </return>
+ public async Task<AzureOperationResponse<RecoveryPointResource>> GetWithHttpMessagesAsync(string vaultName, string resourceGroupName, string fabricName, string containerName, string protectedItemName, string recoveryPointId, Dictionary<string, List<string>> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken))
+ {
+ if (Client.ApiVersion == null)
+ {
+ throw new ValidationException(ValidationRules.CannotBeNull, "this.Client.ApiVersion");
+ }
+ if (vaultName == null)
+ {
+ throw new ValidationException(ValidationRules.CannotBeNull, "vaultName");
+ }
+ if (resourceGroupName == null)
+ {
+ throw new ValidationException(ValidationRules.CannotBeNull, "resourceGroupName");
+ }
+ if (Client.SubscriptionId == null)
+ {
+ throw new ValidationException(ValidationRules.CannotBeNull, "this.Client.SubscriptionId");
+ }
+ if (fabricName == null)
+ {
+ throw new ValidationException(ValidationRules.CannotBeNull, "fabricName");
+ }
+ if (containerName == null)
+ {
+ throw new ValidationException(ValidationRules.CannotBeNull, "containerName");
+ }
+ if (protectedItemName == null)
+ {
+ throw new ValidationException(ValidationRules.CannotBeNull, "protectedItemName");
+ }
+ if (recoveryPointId == null)
+ {
+ throw new ValidationException(ValidationRules.CannotBeNull, "recoveryPointId");
+ }
+ // Tracing
+ bool _shouldTrace = ServiceClientTracing.IsEnabled;
+ string _invocationId = null;
+ if (_shouldTrace)
+ {
+ _invocationId = ServiceClientTracing.NextInvocationId.ToString();
+ Dictionary<string, object> tracingParameters = new Dictionary<string, object>();
+ tracingParameters.Add("vaultName", vaultName);
+ tracingParameters.Add("resourceGroupName", resourceGroupName);
+ tracingParameters.Add("fabricName", fabricName);
+ tracingParameters.Add("containerName", containerName);
+ tracingParameters.Add("protectedItemName", protectedItemName);
+ tracingParameters.Add("recoveryPointId", recoveryPointId);
+ tracingParameters.Add("cancellationToken", cancellationToken);
+ ServiceClientTracing.Enter(_invocationId, this, "Get", tracingParameters);
+ }
+ // Construct URL
+ var _baseUrl = Client.BaseUri.AbsoluteUri;
+ var _url = new System.Uri(new System.Uri(_baseUrl + (_baseUrl.EndsWith("/") ? "" : "/")), "subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}/recoveryPoints/{recoveryPointId}").ToString();
+ _url = _url.Replace("{vaultName}", System.Uri.EscapeDataString(vaultName));
+ _url = _url.Replace("{resourceGroupName}", System.Uri.EscapeDataString(resourceGroupName));
+ _url = _url.Replace("{subscriptionId}", System.Uri.EscapeDataString(Client.SubscriptionId));
+ _url = _url.Replace("{fabricName}", System.Uri.EscapeDataString(fabricName));
+ _url = _url.Replace("{containerName}", System.Uri.EscapeDataString(containerName));
+ _url = _url.Replace("{protectedItemName}", System.Uri.EscapeDataString(protectedItemName));
+ _url = _url.Replace("{recoveryPointId}", System.Uri.EscapeDataString(recoveryPointId));
+ List<string> _queryParameters = new List<string>();
+ if (Client.ApiVersion != null)
+ {
+ _queryParameters.Add(string.Format("api-version={0}", System.Uri.EscapeDataString(Client.ApiVersion)));
+ }
+ if (_queryParameters.Count > 0)
+ {
+ _url += (_url.Contains("?") ? "&" : "?") + string.Join("&", _queryParameters);
+ }
+ // Create HTTP transport objects
+ var _httpRequest = new HttpRequestMessage();
+ HttpResponseMessage _httpResponse = null;
+ _httpRequest.Method = new HttpMethod("GET");
+ _httpRequest.RequestUri = new System.Uri(_url);
+ // Set Headers
+ if (Client.GenerateClientRequestId != null && Client.GenerateClientRequestId.Value)
+ {
+ _httpRequest.Headers.TryAddWithoutValidation("x-ms-client-request-id", System.Guid.NewGuid().ToString());
+ }
+ if (Client.AcceptLanguage != null)
+ {
+ if (_httpRequest.Headers.Contains("accept-language"))
+ {
+ _httpRequest.Headers.Remove("accept-language");
+ }
+ _httpRequest.Headers.TryAddWithoutValidation("accept-language", Client.AcceptLanguage);
+ }
+
+
+ if (customHeaders != null)
+ {
+ foreach(var _header in customHeaders)
+ {
+ if (_httpRequest.Headers.Contains(_header.Key))
+ {
+ _httpRequest.Headers.Remove(_header.Key);
+ }
+ _httpRequest.Headers.TryAddWithoutValidation(_header.Key, _header.Value);
+ }
+ }
+
+ // Serialize Request
+ string _requestContent = null;
+ // Set Credentials
+ if (Client.Credentials != null)
+ {
+ cancellationToken.ThrowIfCancellationRequested();
+ await Client.Credentials.ProcessHttpRequestAsync(_httpRequest, cancellationToken).ConfigureAwait(false);
+ }
+ // Send Request
+ if (_shouldTrace)
+ {
+ ServiceClientTracing.SendRequest(_invocationId, _httpRequest);
+ }
+ cancellationToken.ThrowIfCancellationRequested();
+ _httpResponse = await Client.HttpClient.SendAsync(_httpRequest, cancellationToken).ConfigureAwait(false);
+ if (_shouldTrace)
+ {
+ ServiceClientTracing.ReceiveResponse(_invocationId, _httpResponse);
+ }
+ HttpStatusCode _statusCode = _httpResponse.StatusCode;
+ cancellationToken.ThrowIfCancellationRequested();
+ string _responseContent = null;
+ if ((int)_statusCode != 200)
+ {
+ var ex = new NewErrorResponseException(string.Format("Operation returned an invalid status code '{0}'", _statusCode));
+ try
+ {
+ _responseContent = await _httpResponse.Content.ReadAsStringAsync().ConfigureAwait(false);
+ NewErrorResponse _errorBody = Rest.Serialization.SafeJsonConvert.DeserializeObject<NewErrorResponse>(_responseContent, Client.DeserializationSettings);
+ if (_errorBody != null)
+ {
+ ex.Body = _errorBody;
+ }
+ }
+ catch (JsonException)
+ {
+ // Ignore the exception
+ }
+ ex.Request = new HttpRequestMessageWrapper(_httpRequest, _requestContent);
+ ex.Response = new HttpResponseMessageWrapper(_httpResponse, _responseContent);
+ if (_shouldTrace)
+ {
+ ServiceClientTracing.Error(_invocationId, ex);
+ }
+ _httpRequest.Dispose();
+ if (_httpResponse != null)
+ {
+ _httpResponse.Dispose();
+ }
+ throw ex;
+ }
+ // Create Result
+ var _result = new AzureOperationResponse<RecoveryPointResource>();
+ _result.Request = _httpRequest;
+ _result.Response = _httpResponse;
+ if (_httpResponse.Headers.Contains("x-ms-request-id"))
+ {
+ _result.RequestId = _httpResponse.Headers.GetValues("x-ms-request-id").FirstOrDefault();
+ }
+ // Deserialize Response
+ if ((int)_statusCode == 200)
+ {
+ _responseContent = await _httpResponse.Content.ReadAsStringAsync().ConfigureAwait(false);
+ try
+ {
+ _result.Body = Rest.Serialization.SafeJsonConvert.DeserializeObject<RecoveryPointResource>(_responseContent, Client.DeserializationSettings);
+ }
+ catch (JsonException ex)
+ {
+ _httpRequest.Dispose();
+ if (_httpResponse != null)
+ {
+ _httpResponse.Dispose();
+ }
+ throw new SerializationException("Unable to deserialize the response.", _responseContent, ex);
+ }
+ }
+ if (_shouldTrace)
+ {
+ ServiceClientTracing.Exit(_invocationId, _result);
+ }
+ return _result;
+ }
+
  /// <summary>
  /// Lists the backup copies for the backed up item.
  /// </summary>

src/RecoveryServices/RecoveryServices.Backup.CrossRegionRestore.Management.Sdk/Generated/RecoveryPointsCrrOperationsExtensions.cs

@@ -88,6 +88,74 @@ public static partial class RecoveryPointsCrrOperationsExtensions
  }
  }
 
+ /// <summary>
+ /// Provides the information of the backed up data identified using
+ /// RecoveryPointID.
+ /// </summary>
+ /// <param name='operations'>
+ /// The operations group for this extension method.
+ /// </param>
+ /// <param name='vaultName'>
+ /// The name of the recovery services vault.
+ /// </param>
+ /// <param name='resourceGroupName'>
+ /// The name of the resource group where the recovery services vault is
+ /// present.
+ /// </param>
+ /// <param name='fabricName'>
+ /// Fabric name associated with backed up item.
+ /// </param>
+ /// <param name='containerName'>
+ /// Container name associated with backed up item.
+ /// </param>
+ /// <param name='protectedItemName'>
+ /// Backed up item name whose backup data needs to be fetched.
+ /// </param>
+ /// <param name='recoveryPointId'>
+ /// RecoveryPointID represents the backed up data to be fetched.
+ /// </param>
+ public static RecoveryPointResource Get(this IRecoveryPointsCrrOperations operations, string vaultName, string resourceGroupName, string fabricName, string containerName, string protectedItemName, string recoveryPointId)
+ {
+ return operations.GetAsync(vaultName, resourceGroupName, fabricName, containerName, protectedItemName, recoveryPointId).GetAwaiter().GetResult();
+ }
+
+ /// <summary>
+ /// Provides the information of the backed up data identified using
+ /// RecoveryPointID.
+ /// </summary>
+ /// <param name='operations'>
+ /// The operations group for this extension method.
+ /// </param>
+ /// <param name='vaultName'>
+ /// The name of the recovery services vault.
+ /// </param>
+ /// <param name='resourceGroupName'>
+ /// The name of the resource group where the recovery services vault is
+ /// present.
+ /// </param>
+ /// <param name='fabricName'>
+ /// Fabric name associated with backed up item.
+ /// </param>
+ /// <param name='containerName'>
+ /// Container name associated with backed up item.
+ /// </param>
+ /// <param name='protectedItemName'>
+ /// Backed up item name whose backup data needs to be fetched.
+ /// </param>
+ /// <param name='recoveryPointId'>
+ /// RecoveryPointID represents the backed up data to be fetched.
+ /// </param>
+ /// <param name='cancellationToken'>
+ /// The cancellation token.
+ /// </param>
+ public static async Task<RecoveryPointResource> GetAsync(this IRecoveryPointsCrrOperations operations, string vaultName, string resourceGroupName, string fabricName, string containerName, string protectedItemName, string recoveryPointId, CancellationToken cancellationToken = default(CancellationToken))
+ {
+ using (var _result = await operations.GetWithHttpMessagesAsync(vaultName, resourceGroupName, fabricName, containerName, protectedItemName, recoveryPointId, null, cancellationToken).ConfigureAwait(false))
+ {
+ return _result.Body;
+ }
+ }
+
  /// <summary>
  /// Lists the backup copies for the backed up item.
  /// </summary>

src/RecoveryServices/RecoveryServices.Backup.CrossRegionRestore.Management.Sdk/README.md

@@ -24,7 +24,7 @@ payload-flattening-threshold: 2
 
 ###
 ``` yaml
-commit: 0e20dd2e4e2a40e83840c30cce2efc4847fd9cb9
+commit: 1f9b94d9f01369d1438a80aaf6a658e27209c594
 input-file:
  - https:/Azure/azure-rest-api-specs/blob/$(commit)/specification/recoveryservicesbackup/resource-manager/Microsoft.RecoveryServices/stable/2021-11-15/bms.json