diff --git a/eng/packages/http-client-csharp-mgmt/generator/Azure.Generator.Management/src/Providers/OperationMethodProviders/ResourceOperationMethodProvider.cs b/eng/packages/http-client-csharp-mgmt/generator/Azure.Generator.Management/src/Providers/OperationMethodProviders/ResourceOperationMethodProvider.cs index 17d6da92498d..0e759d16f00e 100644 --- a/eng/packages/http-client-csharp-mgmt/generator/Azure.Generator.Management/src/Providers/OperationMethodProviders/ResourceOperationMethodProvider.cs +++ b/eng/packages/http-client-csharp-mgmt/generator/Azure.Generator.Management/src/Providers/OperationMethodProviders/ResourceOperationMethodProvider.cs @@ -18,6 +18,7 @@ using Microsoft.TypeSpec.Generator.Statements; using System; using System.Collections.Generic; +using System.Linq; using System.Threading.Tasks; using static Microsoft.TypeSpec.Generator.Snippets.Snippet; @@ -95,6 +96,65 @@ public ResourceOperationMethodProvider( _bodyStatements = BuildBodyStatements(); } + /// + /// Builds enhanced XML documentation with structured XmlDocStatement objects for proper XML rendering. + /// + private static void BuildEnhancedXmlDocs(InputServiceMethod serviceMethod, FormattableString? baseDescription, TypeProvider enclosingType, XmlDocProvider? existingXmlDocs) + { + if (existingXmlDocs == null) + { + return; + } + + var operation = serviceMethod.Operation; + + // Build list items for the operation metadata + var listItems = new List(); + + // Request Path item + listItems.Add(new XmlDocStatement("item", [], + new XmlDocStatement("term", [$"Request Path"]), + new XmlDocStatement("description", [$"{operation.Path}"]))); + + // Operation Id item + listItems.Add(new XmlDocStatement("item", [], + new XmlDocStatement("term", [$"Operation Id"]), + new XmlDocStatement("description", [$"{operation.Name}"]))); + + // API Version item (if available) + var apiVersionParam = operation.Parameters.FirstOrDefault(p => p.IsApiVersion); + if (apiVersionParam != null && apiVersionParam.DefaultValue?.Value != null) + { + listItems.Add(new XmlDocStatement("item", [], + new XmlDocStatement("term", [$"Default Api Version"]), + new XmlDocStatement("description", [$"{apiVersionParam.DefaultValue.Value}"]))); + } + + // Resource item (if enclosing type is a ResourceClientProvider) + if (enclosingType is ResourceClientProvider resourceClient) + { + listItems.Add(new XmlDocStatement("item", [], + new XmlDocStatement("term", [$"Resource"]), + new XmlDocStatement("description", [$"{resourceClient.Type:C}"]))); + } + + // Create the list statement + var listStatement = new XmlDocStatement($"", $"", [], innerStatements: listItems.ToArray()); + + // Build the complete summary with base description and metadata list + var summaryContent = new List(); + if (baseDescription != null) + { + summaryContent.Add(baseDescription); + } + + // Create summary statement with the list as inner content + var summaryStatement = new XmlDocSummaryStatement(summaryContent, listStatement); + + // Update the XmlDocs with the new summary + existingXmlDocs.Update(summary: summaryStatement); + } + private static void InitializeLroFlags( in InputServiceMethod serviceMethod, in bool forceLro, @@ -131,10 +191,19 @@ protected virtual CSharpType BuildReturnType() public static implicit operator MethodProvider(ResourceOperationMethodProvider resourceOperationMethodProvider) { - return new MethodProvider( + var methodProvider = new MethodProvider( resourceOperationMethodProvider._signature, resourceOperationMethodProvider._bodyStatements, resourceOperationMethodProvider._enclosingType); + + // Add enhanced XML documentation with structured tags + BuildEnhancedXmlDocs( + resourceOperationMethodProvider._serviceMethod, + resourceOperationMethodProvider._convenienceMethod.Signature.Description, + resourceOperationMethodProvider._enclosingType, + methodProvider.XmlDocs); + + return methodProvider; } protected virtual MethodBodyStatement[] BuildBodyStatements() diff --git a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/BarCollection.cs b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/BarCollection.cs index 7e1061d563fd..dfd297a4aa63 100644 --- a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/BarCollection.cs +++ b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/BarCollection.cs @@ -62,7 +62,23 @@ internal static void ValidateResourceId(ResourceIdentifier id) } } - /// Create a Bar. + /// + /// Create a Bar + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}/bars/{barName}. + /// + /// + /// Operation Id. + /// CreateOrUpdate. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// The name of the Bar. /// Resource create parameters. @@ -104,7 +120,23 @@ public virtual async Task> CreateOrUpdateAsync(WaitUnt } } - /// Create a Bar. + /// + /// Create a Bar + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}/bars/{barName}. + /// + /// + /// Operation Id. + /// CreateOrUpdate. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// The name of the Bar. /// Resource create parameters. @@ -146,7 +178,23 @@ public virtual ArmOperation CreateOrUpdate(WaitUntil waitUntil, str } } - /// Get a Bar. + /// + /// Get a Bar + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}/bars/{barName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the Bar. /// The cancellation token to use. /// is null. @@ -179,7 +227,23 @@ public virtual async Task> GetAsync(string barName, Cancel } } - /// Get a Bar. + /// + /// Get a Bar + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}/bars/{barName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the Bar. /// The cancellation token to use. /// is null. @@ -236,7 +300,23 @@ public virtual Pageable GetAll(CancellationToken cancellationToken return new PageableWrapper(new BarsGetAllCollectionResultOfT(_barsRestClient, Guid.Parse(Id.SubscriptionId), Id.ResourceGroupName, Id.Name, context), data => new BarResource(Client, data)); } - /// Checks to see if the resource exists in azure. + /// + /// Get a Bar + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}/bars/{barName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the Bar. /// The cancellation token to use. /// is null. @@ -277,7 +357,23 @@ public virtual async Task> ExistsAsync(string barName, Cancellati } } - /// Checks to see if the resource exists in azure. + /// + /// Get a Bar + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}/bars/{barName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the Bar. /// The cancellation token to use. /// is null. @@ -318,7 +414,23 @@ public virtual Response Exists(string barName, CancellationToken cancellat } } - /// Tries to get details for this resource from the service. + /// + /// Get a Bar + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}/bars/{barName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the Bar. /// The cancellation token to use. /// is null. @@ -363,7 +475,23 @@ public virtual async Task> GetIfExistsAsync(string } } - /// Tries to get details for this resource from the service. + /// + /// Get a Bar + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}/bars/{barName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the Bar. /// The cancellation token to use. /// is null. diff --git a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/BarQuotaResource.cs b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/BarQuotaResource.cs index bd6d6d4e5f82..d5280b9182a3 100644 --- a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/BarQuotaResource.cs +++ b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/BarQuotaResource.cs @@ -93,7 +93,27 @@ internal static void ValidateResourceId(ResourceIdentifier id) } } - /// Get a BarQuotaResource. + /// + /// Get a BarQuotaResource + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}/bars/{barName}/quotas/{barQuotaResourceName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// The cancellation token to use. public virtual async Task> GetAsync(CancellationToken cancellationToken = default) { @@ -121,7 +141,27 @@ public virtual async Task> GetAsync(CancellationToken } } - /// Get a BarQuotaResource. + /// + /// Get a BarQuotaResource + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}/bars/{barName}/quotas/{barQuotaResourceName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// The cancellation token to use. public virtual Response Get(CancellationToken cancellationToken = default) { @@ -149,7 +189,27 @@ public virtual Response Get(CancellationToken cancellationToke } } - /// Update a BarQuotaResource. + /// + /// Update a BarQuotaResource + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}/bars/{barName}/quotas/{barQuotaResourceName}. + /// + /// + /// Operation Id. + /// Update. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// The resource properties to be updated. /// The cancellation token to use. @@ -188,7 +248,27 @@ public virtual async Task> UpdateAsync(WaitUntil } } - /// Update a BarQuotaResource. + /// + /// Update a BarQuotaResource + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}/bars/{barName}/quotas/{barQuotaResourceName}. + /// + /// + /// Operation Id. + /// Update. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// The resource properties to be updated. /// The cancellation token to use. diff --git a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/BarQuotaResourceCollection.cs b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/BarQuotaResourceCollection.cs index 598894cf9da6..0db7e3184531 100644 --- a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/BarQuotaResourceCollection.cs +++ b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/BarQuotaResourceCollection.cs @@ -53,7 +53,23 @@ internal static void ValidateResourceId(ResourceIdentifier id) } } - /// Get a BarQuotaResource. + /// + /// Get a BarQuotaResource + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}/bars/{barName}/quotas/{barQuotaResourceName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the BarQuotaResource. /// The cancellation token to use. public virtual async Task> GetAsync(QuotaName barQuotaResourceName, CancellationToken cancellationToken = default) @@ -82,7 +98,23 @@ public virtual async Task> GetAsync(QuotaName barQuot } } - /// Get a BarQuotaResource. + /// + /// Get a BarQuotaResource + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}/bars/{barName}/quotas/{barQuotaResourceName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the BarQuotaResource. /// The cancellation token to use. public virtual Response Get(QuotaName barQuotaResourceName, CancellationToken cancellationToken = default) @@ -111,7 +143,23 @@ public virtual Response Get(QuotaName barQuotaResourceName, Ca } } - /// Checks to see if the resource exists in azure. + /// + /// Get a BarQuotaResource + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}/bars/{barName}/quotas/{barQuotaResourceName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the BarQuotaResource. /// The cancellation token to use. public virtual async Task> ExistsAsync(QuotaName barQuotaResourceName, CancellationToken cancellationToken = default) @@ -148,7 +196,23 @@ public virtual async Task> ExistsAsync(QuotaName barQuotaResource } } - /// Checks to see if the resource exists in azure. + /// + /// Get a BarQuotaResource + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}/bars/{barName}/quotas/{barQuotaResourceName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the BarQuotaResource. /// The cancellation token to use. public virtual Response Exists(QuotaName barQuotaResourceName, CancellationToken cancellationToken = default) @@ -185,7 +249,23 @@ public virtual Response Exists(QuotaName barQuotaResourceName, Cancellatio } } - /// Tries to get details for this resource from the service. + /// + /// Get a BarQuotaResource + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}/bars/{barName}/quotas/{barQuotaResourceName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the BarQuotaResource. /// The cancellation token to use. public virtual async Task> GetIfExistsAsync(QuotaName barQuotaResourceName, CancellationToken cancellationToken = default) @@ -226,7 +306,23 @@ public virtual async Task> GetIfExistsAsync(Q } } - /// Tries to get details for this resource from the service. + /// + /// Get a BarQuotaResource + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}/bars/{barName}/quotas/{barQuotaResourceName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the BarQuotaResource. /// The cancellation token to use. public virtual NullableResponse GetIfExists(QuotaName barQuotaResourceName, CancellationToken cancellationToken = default) diff --git a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/BarResource.cs b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/BarResource.cs index b96b0c5459c2..06fa730e5955 100644 --- a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/BarResource.cs +++ b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/BarResource.cs @@ -102,7 +102,27 @@ internal static void ValidateResourceId(ResourceIdentifier id) } } - /// Delete a Bar. + /// + /// Delete a Bar + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}/bars/{barName}. + /// + /// + /// Operation Id. + /// Delete. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// The cancellation token to use. public virtual async Task DeleteAsync(WaitUntil waitUntil, CancellationToken cancellationToken = default) @@ -131,7 +151,27 @@ public virtual async Task DeleteAsync(WaitUntil waitUntil, Cancell } } - /// Delete a Bar. + /// + /// Delete a Bar + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}/bars/{barName}. + /// + /// + /// Operation Id. + /// Delete. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// The cancellation token to use. public virtual ArmOperation Delete(WaitUntil waitUntil, CancellationToken cancellationToken = default) @@ -160,7 +200,27 @@ public virtual ArmOperation Delete(WaitUntil waitUntil, CancellationToken cancel } } - /// Get a Bar. + /// + /// Get a Bar + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}/bars/{barName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// The cancellation token to use. public virtual async Task> GetAsync(CancellationToken cancellationToken = default) { @@ -188,7 +248,27 @@ public virtual async Task> GetAsync(CancellationToken canc } } - /// Get a Bar. + /// + /// Get a Bar + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}/bars/{barName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// The cancellation token to use. public virtual Response Get(CancellationToken cancellationToken = default) { @@ -216,7 +296,27 @@ public virtual Response Get(CancellationToken cancellationToken = d } } - /// Update a Bar. + /// + /// Update a Bar + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}/bars/{barName}. + /// + /// + /// Operation Id. + /// Update. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// The resource properties to be updated. /// The cancellation token to use. /// is null. @@ -248,7 +348,27 @@ public virtual async Task> UpdateAsync(BarData data, Cance } } - /// Update a Bar. + /// + /// Update a Bar + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}/bars/{barName}. + /// + /// + /// Operation Id. + /// Update. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// The resource properties to be updated. /// The cancellation token to use. /// is null. diff --git a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/BarSettingsResource.cs b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/BarSettingsResource.cs index be2b9354f3a3..8ee107ddd26b 100644 --- a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/BarSettingsResource.cs +++ b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/BarSettingsResource.cs @@ -91,7 +91,27 @@ internal static void ValidateResourceId(ResourceIdentifier id) } } - /// Create a BarSettingsResource. + /// + /// Create a BarSettingsResource + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}/bars/{barName}/settings/current. + /// + /// + /// Operation Id. + /// CreateOrUpdate. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// Resource create parameters. /// The cancellation token to use. @@ -130,7 +150,27 @@ public virtual async Task> CreateOrUpdateAsync } } - /// Create a BarSettingsResource. + /// + /// Create a BarSettingsResource + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}/bars/{barName}/settings/current. + /// + /// + /// Operation Id. + /// CreateOrUpdate. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// Resource create parameters. /// The cancellation token to use. @@ -169,7 +209,27 @@ public virtual ArmOperation CreateOrUpdate(WaitUntil waitUn } } - /// Get a BarSettingsResource. + /// + /// Get a BarSettingsResource + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}/bars/{barName}/settings/current. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// The cancellation token to use. public virtual async Task> GetAsync(CancellationToken cancellationToken = default) { @@ -197,7 +257,27 @@ public virtual async Task> GetAsync(CancellationTo } } - /// Get a BarSettingsResource. + /// + /// Get a BarSettingsResource + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}/bars/{barName}/settings/current. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// The cancellation token to use. public virtual Response Get(CancellationToken cancellationToken = default) { diff --git a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/BazCollection.cs b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/BazCollection.cs index 8946acd59d59..92102a58517c 100644 --- a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/BazCollection.cs +++ b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/BazCollection.cs @@ -55,7 +55,23 @@ internal static void ValidateResourceId(ResourceIdentifier id) } } - /// Create a Baz. + /// + /// Create a Baz + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/bazs/{bazName}. + /// + /// + /// Operation Id. + /// CreateOrUpdate. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// The name of the Baz. /// Resource create parameters. @@ -97,7 +113,23 @@ public virtual async Task> CreateOrUpdateAsync(WaitUnt } } - /// Create a Baz. + /// + /// Create a Baz + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/bazs/{bazName}. + /// + /// + /// Operation Id. + /// CreateOrUpdate. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// The name of the Baz. /// Resource create parameters. @@ -139,7 +171,23 @@ public virtual ArmOperation CreateOrUpdate(WaitUntil waitUntil, str } } - /// Get a Baz. + /// + /// Get a Baz + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/bazs/{bazName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the Baz. /// The cancellation token to use. /// is null. @@ -172,7 +220,23 @@ public virtual async Task> GetAsync(string bazName, Cancel } } - /// Get a Baz. + /// + /// Get a Baz + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/bazs/{bazName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the Baz. /// The cancellation token to use. /// is null. @@ -229,7 +293,23 @@ public virtual Pageable GetAll(CancellationToken cancellationToken return new PageableWrapper(new BazsGetAllCollectionResultOfT(_bazsRestClient, Guid.Parse(Id.SubscriptionId), Id.ResourceGroupName, context), data => new BazResource(Client, data)); } - /// Checks to see if the resource exists in azure. + /// + /// Get a Baz + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/bazs/{bazName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the Baz. /// The cancellation token to use. /// is null. @@ -270,7 +350,23 @@ public virtual async Task> ExistsAsync(string bazName, Cancellati } } - /// Checks to see if the resource exists in azure. + /// + /// Get a Baz + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/bazs/{bazName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the Baz. /// The cancellation token to use. /// is null. @@ -311,7 +407,23 @@ public virtual Response Exists(string bazName, CancellationToken cancellat } } - /// Tries to get details for this resource from the service. + /// + /// Get a Baz + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/bazs/{bazName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the Baz. /// The cancellation token to use. /// is null. @@ -356,7 +468,23 @@ public virtual async Task> GetIfExistsAsync(string } } - /// Tries to get details for this resource from the service. + /// + /// Get a Baz + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/bazs/{bazName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the Baz. /// The cancellation token to use. /// is null. diff --git a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/BazResource.cs b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/BazResource.cs index 3fddb111dfa4..de4e5ab3da42 100644 --- a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/BazResource.cs +++ b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/BazResource.cs @@ -92,7 +92,27 @@ internal static void ValidateResourceId(ResourceIdentifier id) } } - /// Get a Baz. + /// + /// Get a Baz + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/bazs/{bazName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// The cancellation token to use. public virtual async Task> GetAsync(CancellationToken cancellationToken = default) { @@ -120,7 +140,27 @@ public virtual async Task> GetAsync(CancellationToken canc } } - /// Get a Baz. + /// + /// Get a Baz + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/bazs/{bazName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// The cancellation token to use. public virtual Response Get(CancellationToken cancellationToken = default) { @@ -148,7 +188,27 @@ public virtual Response Get(CancellationToken cancellationToken = d } } - /// Delete a Baz. + /// + /// Delete a Baz + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/bazs/{bazName}. + /// + /// + /// Operation Id. + /// Delete. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// The cancellation token to use. public virtual async Task DeleteAsync(WaitUntil waitUntil, CancellationToken cancellationToken = default) @@ -177,7 +237,27 @@ public virtual async Task DeleteAsync(WaitUntil waitUntil, Cancell } } - /// Delete a Baz. + /// + /// Delete a Baz + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/bazs/{bazName}. + /// + /// + /// Operation Id. + /// Delete. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// The cancellation token to use. public virtual ArmOperation Delete(WaitUntil waitUntil, CancellationToken cancellationToken = default) @@ -206,7 +286,27 @@ public virtual ArmOperation Delete(WaitUntil waitUntil, CancellationToken cancel } } - /// Update a Baz. + /// + /// Update a Baz + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/bazs/{bazName}. + /// + /// + /// Operation Id. + /// Update. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// The resource properties to be updated. /// The cancellation token to use. @@ -245,7 +345,27 @@ public virtual async Task> UpdateAsync(WaitUntil waitU } } - /// Update a Baz. + /// + /// Update a Baz + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/bazs/{bazName}. + /// + /// + /// Operation Id. + /// Update. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// The resource properties to be updated. /// The cancellation token to use. diff --git a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/EndpointResource.cs b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/EndpointResource.cs index dade3ff4022b..de8f670fec18 100644 --- a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/EndpointResource.cs +++ b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/EndpointResource.cs @@ -89,7 +89,27 @@ internal static void ValidateResourceId(ResourceIdentifier id) } } - /// Gets the endpoint to the resource. + /// + /// Gets the endpoint to the resource. + /// + /// + /// Request Path. + /// /{resourceUri}/providers/MgmtTypeSpec/endpoints/{endpointName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// The cancellation token to use. public virtual async Task> GetAsync(CancellationToken cancellationToken = default) { @@ -117,7 +137,27 @@ public virtual async Task> GetAsync(CancellationToken } } - /// Gets the endpoint to the resource. + /// + /// Gets the endpoint to the resource. + /// + /// + /// Request Path. + /// /{resourceUri}/providers/MgmtTypeSpec/endpoints/{endpointName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// The cancellation token to use. public virtual Response Get(CancellationToken cancellationToken = default) { @@ -145,7 +185,27 @@ public virtual Response Get(CancellationToken cancellationToke } } - /// Update the endpoint to the target resource. + /// + /// Update the endpoint to the target resource. + /// + /// + /// Request Path. + /// /{resourceUri}/providers/MgmtTypeSpec/endpoints/{endpointName}. + /// + /// + /// Operation Id. + /// Update. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// The resource properties to be updated. /// The cancellation token to use. /// is null. @@ -177,7 +237,27 @@ public virtual async Task> UpdateAsync(EndpointResour } } - /// Update the endpoint to the target resource. + /// + /// Update the endpoint to the target resource. + /// + /// + /// Request Path. + /// /{resourceUri}/providers/MgmtTypeSpec/endpoints/{endpointName}. + /// + /// + /// Operation Id. + /// Update. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// The resource properties to be updated. /// The cancellation token to use. /// is null. @@ -209,7 +289,27 @@ public virtual Response Update(EndpointResourceData data, Canc } } - /// Deletes the endpoint access to the target resource. + /// + /// Deletes the endpoint access to the target resource. + /// + /// + /// Request Path. + /// /{resourceUri}/providers/MgmtTypeSpec/endpoints/{endpointName}. + /// + /// + /// Operation Id. + /// Delete. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// The cancellation token to use. public virtual async Task DeleteAsync(WaitUntil waitUntil, CancellationToken cancellationToken = default) @@ -240,7 +340,27 @@ public virtual async Task DeleteAsync(WaitUntil waitUntil, Cancell } } - /// Deletes the endpoint access to the target resource. + /// + /// Deletes the endpoint access to the target resource. + /// + /// + /// Request Path. + /// /{resourceUri}/providers/MgmtTypeSpec/endpoints/{endpointName}. + /// + /// + /// Operation Id. + /// Delete. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// The cancellation token to use. public virtual ArmOperation Delete(WaitUntil waitUntil, CancellationToken cancellationToken = default) diff --git a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/EndpointResourceCollection.cs b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/EndpointResourceCollection.cs index 8f38cd45fe1f..05d83d622d96 100644 --- a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/EndpointResourceCollection.cs +++ b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/EndpointResourceCollection.cs @@ -52,7 +52,23 @@ internal static void ValidateResourceId(ResourceIdentifier id) } } - /// Create or update the endpoint to the target resource. + /// + /// Create or update the endpoint to the target resource. + /// + /// + /// Request Path. + /// /{resourceUri}/providers/MgmtTypeSpec/endpoints/{endpointName}. + /// + /// + /// Operation Id. + /// CreateOrUpdate. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// The name of the EndpointResource. /// Resource create parameters. @@ -91,7 +107,23 @@ public virtual async Task> CreateOrUpdateAsync(Wa } } - /// Create or update the endpoint to the target resource. + /// + /// Create or update the endpoint to the target resource. + /// + /// + /// Request Path. + /// /{resourceUri}/providers/MgmtTypeSpec/endpoints/{endpointName}. + /// + /// + /// Operation Id. + /// CreateOrUpdate. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// The name of the EndpointResource. /// Resource create parameters. @@ -130,7 +162,23 @@ public virtual ArmOperation CreateOrUpdate(WaitUntil waitUntil } } - /// Gets the endpoint to the resource. + /// + /// Gets the endpoint to the resource. + /// + /// + /// Request Path. + /// /{resourceUri}/providers/MgmtTypeSpec/endpoints/{endpointName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the EndpointResource. /// The cancellation token to use. /// is null. @@ -163,7 +211,23 @@ public virtual async Task> GetAsync(string endpointNa } } - /// Gets the endpoint to the resource. + /// + /// Gets the endpoint to the resource. + /// + /// + /// Request Path. + /// /{resourceUri}/providers/MgmtTypeSpec/endpoints/{endpointName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the EndpointResource. /// The cancellation token to use. /// is null. @@ -196,7 +260,23 @@ public virtual Response Get(string endpointName, CancellationT } } - /// Checks to see if the resource exists in azure. + /// + /// Gets the endpoint to the resource. + /// + /// + /// Request Path. + /// /{resourceUri}/providers/MgmtTypeSpec/endpoints/{endpointName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the EndpointResource. /// The cancellation token to use. /// is null. @@ -237,7 +317,23 @@ public virtual async Task> ExistsAsync(string endpointName, Cance } } - /// Checks to see if the resource exists in azure. + /// + /// Gets the endpoint to the resource. + /// + /// + /// Request Path. + /// /{resourceUri}/providers/MgmtTypeSpec/endpoints/{endpointName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the EndpointResource. /// The cancellation token to use. /// is null. @@ -278,7 +374,23 @@ public virtual Response Exists(string endpointName, CancellationToken canc } } - /// Tries to get details for this resource from the service. + /// + /// Gets the endpoint to the resource. + /// + /// + /// Request Path. + /// /{resourceUri}/providers/MgmtTypeSpec/endpoints/{endpointName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the EndpointResource. /// The cancellation token to use. /// is null. @@ -323,7 +435,23 @@ public virtual async Task> GetIfExistsAsync(s } } - /// Tries to get details for this resource from the service. + /// + /// Gets the endpoint to the resource. + /// + /// + /// Request Path. + /// /{resourceUri}/providers/MgmtTypeSpec/endpoints/{endpointName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the EndpointResource. /// The cancellation token to use. /// is null. diff --git a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/Extensions/MockableAzureGeneratorMgmtTypeSpecTestsTenantResource.cs b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/Extensions/MockableAzureGeneratorMgmtTypeSpecTestsTenantResource.cs index e5aa484e824e..72fc2a2fb7f3 100644 --- a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/Extensions/MockableAzureGeneratorMgmtTypeSpecTestsTenantResource.cs +++ b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/Extensions/MockableAzureGeneratorMgmtTypeSpecTestsTenantResource.cs @@ -75,7 +75,19 @@ public virtual Response GetGroupQuo return GetGroupQuotaSubscriptionRequestStatuses(managementGroupId).Get(requestId, cancellationToken); } - /// Starts a failed runtime resource. + /// + /// Starts a failed runtime resource + /// + /// + /// Request Path. + /// /. + /// + /// + /// Operation Id. + /// StartFailedServerlessRuntime. + /// + /// + /// /// The cancellation token to use. public virtual async Task StartFailedServerlessRuntimeAsync(CancellationToken cancellationToken = default) { @@ -98,7 +110,19 @@ public virtual async Task StartFailedServerlessRuntimeAsync(Cancellati } } - /// Starts a failed runtime resource. + /// + /// Starts a failed runtime resource + /// + /// + /// Request Path. + /// /. + /// + /// + /// Operation Id. + /// StartFailedServerlessRuntime. + /// + /// + /// /// The cancellation token to use. public virtual Response StartFailedServerlessRuntime(CancellationToken cancellationToken = default) { diff --git a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/FooCollection.cs b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/FooCollection.cs index 4ef946fcec23..9b2e89cdae97 100644 --- a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/FooCollection.cs +++ b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/FooCollection.cs @@ -55,7 +55,23 @@ internal static void ValidateResourceId(ResourceIdentifier id) } } - /// Create a Foo. + /// + /// Create a Foo + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}. + /// + /// + /// Operation Id. + /// CreateOrUpdate. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// The name of the Foo. /// Resource create parameters. @@ -97,7 +113,23 @@ public virtual async Task> CreateOrUpdateAsync(WaitUnt } } - /// Create a Foo. + /// + /// Create a Foo + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}. + /// + /// + /// Operation Id. + /// CreateOrUpdate. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// The name of the Foo. /// Resource create parameters. @@ -139,7 +171,23 @@ public virtual ArmOperation CreateOrUpdate(WaitUntil waitUntil, str } } - /// Get a Foo. + /// + /// Get a Foo + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the Foo. /// The cancellation token to use. /// is null. @@ -172,7 +220,23 @@ public virtual async Task> GetAsync(string fooName, Cancel } } - /// Get a Foo. + /// + /// Get a Foo + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the Foo. /// The cancellation token to use. /// is null. @@ -229,7 +293,23 @@ public virtual Pageable GetAll(CancellationToken cancellationToken return new PageableWrapper(new FoosGetAllCollectionResultOfT(_foosRestClient, Guid.Parse(Id.SubscriptionId), Id.ResourceGroupName, context), data => new FooResource(Client, data)); } - /// Checks to see if the resource exists in azure. + /// + /// Get a Foo + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the Foo. /// The cancellation token to use. /// is null. @@ -270,7 +350,23 @@ public virtual async Task> ExistsAsync(string fooName, Cancellati } } - /// Checks to see if the resource exists in azure. + /// + /// Get a Foo + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the Foo. /// The cancellation token to use. /// is null. @@ -311,7 +407,23 @@ public virtual Response Exists(string fooName, CancellationToken cancellat } } - /// Tries to get details for this resource from the service. + /// + /// Get a Foo + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the Foo. /// The cancellation token to use. /// is null. @@ -356,7 +468,23 @@ public virtual async Task> GetIfExistsAsync(string } } - /// Tries to get details for this resource from the service. + /// + /// Get a Foo + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the Foo. /// The cancellation token to use. /// is null. diff --git a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/FooResource.cs b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/FooResource.cs index 3c9a56a9ddca..021db90d849b 100644 --- a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/FooResource.cs +++ b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/FooResource.cs @@ -92,7 +92,27 @@ internal static void ValidateResourceId(ResourceIdentifier id) } } - /// Get a Foo. + /// + /// Get a Foo + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// The cancellation token to use. public virtual async Task> GetAsync(CancellationToken cancellationToken = default) { @@ -120,7 +140,27 @@ public virtual async Task> GetAsync(CancellationToken canc } } - /// Get a Foo. + /// + /// Get a Foo + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// The cancellation token to use. public virtual Response Get(CancellationToken cancellationToken = default) { @@ -148,7 +188,27 @@ public virtual Response Get(CancellationToken cancellationToken = d } } - /// Delete a Foo. + /// + /// Delete a Foo + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}. + /// + /// + /// Operation Id. + /// Delete. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// The cancellation token to use. public virtual async Task DeleteAsync(WaitUntil waitUntil, CancellationToken cancellationToken = default) @@ -177,7 +237,27 @@ public virtual async Task DeleteAsync(WaitUntil waitUntil, Cancell } } - /// Delete a Foo. + /// + /// Delete a Foo + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}. + /// + /// + /// Operation Id. + /// Delete. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// The cancellation token to use. public virtual ArmOperation Delete(WaitUntil waitUntil, CancellationToken cancellationToken = default) @@ -206,7 +286,27 @@ public virtual ArmOperation Delete(WaitUntil waitUntil, CancellationToken cancel } } - /// Update a Foo. + /// + /// Create a Foo + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}. + /// + /// + /// Operation Id. + /// CreateOrUpdate. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// Resource create parameters. /// The cancellation token to use. @@ -245,7 +345,27 @@ public virtual async Task> UpdateAsync(WaitUntil waitU } } - /// Update a Foo. + /// + /// Create a Foo + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/foos/{fooName}. + /// + /// + /// Operation Id. + /// CreateOrUpdate. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// Resource create parameters. /// The cancellation token to use. diff --git a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/FooSettingsResource.cs b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/FooSettingsResource.cs index 97e89897db46..2d570fdb32a0 100644 --- a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/FooSettingsResource.cs +++ b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/FooSettingsResource.cs @@ -91,7 +91,27 @@ internal static void ValidateResourceId(ResourceIdentifier id) } } - /// Get a FooSettings. + /// + /// Get a FooSettings + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/FooSettings/default. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// The cancellation token to use. public virtual async Task> GetAsync(CancellationToken cancellationToken = default) { @@ -119,7 +139,27 @@ public virtual async Task> GetAsync(CancellationTo } } - /// Get a FooSettings. + /// + /// Get a FooSettings + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/FooSettings/default. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// The cancellation token to use. public virtual Response Get(CancellationToken cancellationToken = default) { @@ -147,7 +187,27 @@ public virtual Response Get(CancellationToken cancellationT } } - /// Create a FooSettings. + /// + /// Create a FooSettings + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/FooSettings/default. + /// + /// + /// Operation Id. + /// CreateOrUpdate. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// Resource create parameters. /// The cancellation token to use. @@ -183,7 +243,27 @@ public virtual async Task> CreateOrUpdateAsync } } - /// Create a FooSettings. + /// + /// Create a FooSettings + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/FooSettings/default. + /// + /// + /// Operation Id. + /// CreateOrUpdate. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// Resource create parameters. /// The cancellation token to use. @@ -283,7 +363,27 @@ public virtual Response Update(FooSettingsPatch patch, Canc } } - /// Delete a FooSettings. + /// + /// Delete a FooSettings + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/FooSettings/default. + /// + /// + /// Operation Id. + /// Delete. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// The cancellation token to use. public virtual async Task DeleteAsync(WaitUntil waitUntil, CancellationToken cancellationToken = default) @@ -314,7 +414,27 @@ public virtual async Task DeleteAsync(WaitUntil waitUntil, Cancell } } - /// Delete a FooSettings. + /// + /// Delete a FooSettings + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/FooSettings/default. + /// + /// + /// Operation Id. + /// Delete. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// The cancellation token to use. public virtual ArmOperation Delete(WaitUntil waitUntil, CancellationToken cancellationToken = default) diff --git a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/GroupQuotaSubscriptionRequestStatusCollection.cs b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/GroupQuotaSubscriptionRequestStatusCollection.cs index a29d2a5378ba..388e7643a3a6 100644 --- a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/GroupQuotaSubscriptionRequestStatusCollection.cs +++ b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/GroupQuotaSubscriptionRequestStatusCollection.cs @@ -57,7 +57,23 @@ internal static void ValidateResourceId(ResourceIdentifier id) } } - /// Get API to check the status of a subscriptionIds request by requestId. Use the polling API - OperationsStatus URI specified in Azure-AsyncOperation header field, with retry-after duration in seconds to check the intermediate status. This API provides the finals status with the request details and status. + /// + /// Get API to check the status of a subscriptionIds request by requestId. Use the polling API - OperationsStatus URI specified in Azure-AsyncOperation header field, with retry-after duration in seconds to check the intermediate status. This API provides the finals status with the request details and status. + /// + /// + /// Request Path. + /// /providers/Microsoft.Management/managementGroups/{managementGroupId}/providers/MgmtTypeSpec/quotas/{requestId}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the GroupQuotaSubscriptionRequestStatus. /// The cancellation token to use. /// is null. @@ -90,7 +106,23 @@ public virtual async Task> } } - /// Get API to check the status of a subscriptionIds request by requestId. Use the polling API - OperationsStatus URI specified in Azure-AsyncOperation header field, with retry-after duration in seconds to check the intermediate status. This API provides the finals status with the request details and status. + /// + /// Get API to check the status of a subscriptionIds request by requestId. Use the polling API - OperationsStatus URI specified in Azure-AsyncOperation header field, with retry-after duration in seconds to check the intermediate status. This API provides the finals status with the request details and status. + /// + /// + /// Request Path. + /// /providers/Microsoft.Management/managementGroups/{managementGroupId}/providers/MgmtTypeSpec/quotas/{requestId}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the GroupQuotaSubscriptionRequestStatus. /// The cancellation token to use. /// is null. @@ -123,7 +155,23 @@ public virtual Response Get(string } } - /// Checks to see if the resource exists in azure. + /// + /// Get API to check the status of a subscriptionIds request by requestId. Use the polling API - OperationsStatus URI specified in Azure-AsyncOperation header field, with retry-after duration in seconds to check the intermediate status. This API provides the finals status with the request details and status. + /// + /// + /// Request Path. + /// /providers/Microsoft.Management/managementGroups/{managementGroupId}/providers/MgmtTypeSpec/quotas/{requestId}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the GroupQuotaSubscriptionRequestStatus. /// The cancellation token to use. /// is null. @@ -164,7 +212,23 @@ public virtual async Task> ExistsAsync(string requestId, Cancella } } - /// Checks to see if the resource exists in azure. + /// + /// Get API to check the status of a subscriptionIds request by requestId. Use the polling API - OperationsStatus URI specified in Azure-AsyncOperation header field, with retry-after duration in seconds to check the intermediate status. This API provides the finals status with the request details and status. + /// + /// + /// Request Path. + /// /providers/Microsoft.Management/managementGroups/{managementGroupId}/providers/MgmtTypeSpec/quotas/{requestId}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the GroupQuotaSubscriptionRequestStatus. /// The cancellation token to use. /// is null. @@ -205,7 +269,23 @@ public virtual Response Exists(string requestId, CancellationToken cancell } } - /// Tries to get details for this resource from the service. + /// + /// Get API to check the status of a subscriptionIds request by requestId. Use the polling API - OperationsStatus URI specified in Azure-AsyncOperation header field, with retry-after duration in seconds to check the intermediate status. This API provides the finals status with the request details and status. + /// + /// + /// Request Path. + /// /providers/Microsoft.Management/managementGroups/{managementGroupId}/providers/MgmtTypeSpec/quotas/{requestId}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the GroupQuotaSubscriptionRequestStatus. /// The cancellation token to use. /// is null. @@ -250,7 +330,23 @@ public virtual async Task Tries to get details for this resource from the service. + /// + /// Get API to check the status of a subscriptionIds request by requestId. Use the polling API - OperationsStatus URI specified in Azure-AsyncOperation header field, with retry-after duration in seconds to check the intermediate status. This API provides the finals status with the request details and status. + /// + /// + /// Request Path. + /// /providers/Microsoft.Management/managementGroups/{managementGroupId}/providers/MgmtTypeSpec/quotas/{requestId}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the GroupQuotaSubscriptionRequestStatus. /// The cancellation token to use. /// is null. diff --git a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/GroupQuotaSubscriptionRequestStatusResource.cs b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/GroupQuotaSubscriptionRequestStatusResource.cs index 74bd2eedfd04..ed82f605e20c 100644 --- a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/GroupQuotaSubscriptionRequestStatusResource.cs +++ b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/GroupQuotaSubscriptionRequestStatusResource.cs @@ -90,7 +90,27 @@ internal static void ValidateResourceId(ResourceIdentifier id) } } - /// Get API to check the status of a subscriptionIds request by requestId. Use the polling API - OperationsStatus URI specified in Azure-AsyncOperation header field, with retry-after duration in seconds to check the intermediate status. This API provides the finals status with the request details and status. + /// + /// Get API to check the status of a subscriptionIds request by requestId. Use the polling API - OperationsStatus URI specified in Azure-AsyncOperation header field, with retry-after duration in seconds to check the intermediate status. This API provides the finals status with the request details and status. + /// + /// + /// Request Path. + /// /providers/Microsoft.Management/managementGroups/{managementGroupId}/providers/MgmtTypeSpec/quotas/{requestId}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// The cancellation token to use. public virtual async Task> GetAsync(CancellationToken cancellationToken = default) { @@ -118,7 +138,27 @@ public virtual async Task> } } - /// Get API to check the status of a subscriptionIds request by requestId. Use the polling API - OperationsStatus URI specified in Azure-AsyncOperation header field, with retry-after duration in seconds to check the intermediate status. This API provides the finals status with the request details and status. + /// + /// Get API to check the status of a subscriptionIds request by requestId. Use the polling API - OperationsStatus URI specified in Azure-AsyncOperation header field, with retry-after duration in seconds to check the intermediate status. This API provides the finals status with the request details and status. + /// + /// + /// Request Path. + /// /providers/Microsoft.Management/managementGroups/{managementGroupId}/providers/MgmtTypeSpec/quotas/{requestId}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// The cancellation token to use. public virtual Response Get(CancellationToken cancellationToken = default) { diff --git a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/HciVmInstanceResource.cs b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/HciVmInstanceResource.cs index 79711c72993a..3a08da6f6e5b 100644 --- a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/HciVmInstanceResource.cs +++ b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/HciVmInstanceResource.cs @@ -88,7 +88,27 @@ internal static void ValidateResourceId(ResourceIdentifier id) } } - /// Gets a virtual machine instance. + /// + /// Gets a virtual machine instance + /// + /// + /// Request Path. + /// /{resourceUri}/providers/MgmtTypeSpec/virtualMachineInstances/default. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// The cancellation token to use. public virtual async Task> GetAsync(CancellationToken cancellationToken = default) { @@ -116,7 +136,27 @@ public virtual async Task> GetAsync(Cancellation } } - /// Gets a virtual machine instance. + /// + /// Gets a virtual machine instance + /// + /// + /// Request Path. + /// /{resourceUri}/providers/MgmtTypeSpec/virtualMachineInstances/default. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// The cancellation token to use. public virtual Response Get(CancellationToken cancellationToken = default) { diff --git a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/JobResource.cs b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/JobResource.cs index 2c982daffda1..56b4df3ade5a 100644 --- a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/JobResource.cs +++ b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/JobResource.cs @@ -93,7 +93,27 @@ internal static void ValidateResourceId(ResourceIdentifier id) } } - /// Gets information about the specified job. + /// + /// Gets information about the specified job. + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/jobs/{jobName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// $expand is supported on details parameter for job, which provides details on the job stages. /// The cancellation token to use. public virtual async Task> GetAsync(string expand = default, CancellationToken cancellationToken = default) @@ -122,7 +142,27 @@ public virtual async Task> GetAsync(string expand = defaul } } - /// Gets information about the specified job. + /// + /// Gets information about the specified job. + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/jobs/{jobName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// $expand is supported on details parameter for job, which provides details on the job stages. /// The cancellation token to use. public virtual Response Get(string expand = default, CancellationToken cancellationToken = default) diff --git a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/JobResourceCollection.cs b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/JobResourceCollection.cs index 3be6bec9fde2..316de8c42dd4 100644 --- a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/JobResourceCollection.cs +++ b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/JobResourceCollection.cs @@ -53,7 +53,23 @@ internal static void ValidateResourceId(ResourceIdentifier id) } } - /// Gets information about the specified job. + /// + /// Gets information about the specified job. + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/jobs/{jobName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the JobResource. /// $expand is supported on details parameter for job, which provides details on the job stages. /// The cancellation token to use. @@ -87,7 +103,23 @@ public virtual async Task> GetAsync(string jobName, string } } - /// Gets information about the specified job. + /// + /// Gets information about the specified job. + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/jobs/{jobName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the JobResource. /// $expand is supported on details parameter for job, which provides details on the job stages. /// The cancellation token to use. @@ -121,7 +153,23 @@ public virtual Response Get(string jobName, string expand = default } } - /// Checks to see if the resource exists in azure. + /// + /// Gets information about the specified job. + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/jobs/{jobName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the JobResource. /// $expand is supported on details parameter for job, which provides details on the job stages. /// The cancellation token to use. @@ -163,7 +211,23 @@ public virtual async Task> ExistsAsync(string jobName, string exp } } - /// Checks to see if the resource exists in azure. + /// + /// Gets information about the specified job. + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/jobs/{jobName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the JobResource. /// $expand is supported on details parameter for job, which provides details on the job stages. /// The cancellation token to use. @@ -205,7 +269,23 @@ public virtual Response Exists(string jobName, string expand = default, Ca } } - /// Tries to get details for this resource from the service. + /// + /// Gets information about the specified job. + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/jobs/{jobName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the JobResource. /// $expand is supported on details parameter for job, which provides details on the job stages. /// The cancellation token to use. @@ -251,7 +331,23 @@ public virtual async Task> GetIfExistsAsync(string } } - /// Tries to get details for this resource from the service. + /// + /// Gets information about the specified job. + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/jobs/{jobName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the JobResource. /// $expand is supported on details parameter for job, which provides details on the job stages. /// The cancellation token to use. diff --git a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/PlaywrightQuotaCollection.cs b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/PlaywrightQuotaCollection.cs index 522ba4edb3a3..53af513d3209 100644 --- a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/PlaywrightQuotaCollection.cs +++ b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/PlaywrightQuotaCollection.cs @@ -60,7 +60,23 @@ internal static void ValidateResourceId(ResourceIdentifier id) } } - /// Get subscription-level location-based Playwright quota resource by name. + /// + /// Get subscription-level location-based Playwright quota resource by name. + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/providers/MgmtTypeSpec/locations/{location}/playwrightQuotas/{playwrightQuotaName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the PlaywrightQuota. /// The cancellation token to use. public virtual async Task> GetAsync(PlaywrightQuotaName playwrightQuotaName, CancellationToken cancellationToken = default) @@ -89,7 +105,23 @@ public virtual async Task> GetAsync(Playwright } } - /// Get subscription-level location-based Playwright quota resource by name. + /// + /// Get subscription-level location-based Playwright quota resource by name. + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/providers/MgmtTypeSpec/locations/{location}/playwrightQuotas/{playwrightQuotaName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the PlaywrightQuota. /// The cancellation token to use. public virtual Response Get(PlaywrightQuotaName playwrightQuotaName, CancellationToken cancellationToken = default) @@ -142,7 +174,23 @@ public virtual Pageable GetAll(CancellationToken cancel return new PageableWrapper(new PlaywrightQuotasGetBySubscriptionCollectionResultOfT(_playwrightQuotasRestClient, Guid.Parse(Id.SubscriptionId), _location, context), data => new PlaywrightQuotaResource(Client, data)); } - /// Checks to see if the resource exists in azure. + /// + /// Get subscription-level location-based Playwright quota resource by name. + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/providers/MgmtTypeSpec/locations/{location}/playwrightQuotas/{playwrightQuotaName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the PlaywrightQuota. /// The cancellation token to use. public virtual async Task> ExistsAsync(PlaywrightQuotaName playwrightQuotaName, CancellationToken cancellationToken = default) @@ -179,7 +227,23 @@ public virtual async Task> ExistsAsync(PlaywrightQuotaName playwr } } - /// Checks to see if the resource exists in azure. + /// + /// Get subscription-level location-based Playwright quota resource by name. + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/providers/MgmtTypeSpec/locations/{location}/playwrightQuotas/{playwrightQuotaName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the PlaywrightQuota. /// The cancellation token to use. public virtual Response Exists(PlaywrightQuotaName playwrightQuotaName, CancellationToken cancellationToken = default) @@ -216,7 +280,23 @@ public virtual Response Exists(PlaywrightQuotaName playwrightQuotaName, Ca } } - /// Tries to get details for this resource from the service. + /// + /// Get subscription-level location-based Playwright quota resource by name. + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/providers/MgmtTypeSpec/locations/{location}/playwrightQuotas/{playwrightQuotaName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the PlaywrightQuota. /// The cancellation token to use. public virtual async Task> GetIfExistsAsync(PlaywrightQuotaName playwrightQuotaName, CancellationToken cancellationToken = default) @@ -257,7 +337,23 @@ public virtual async Task> GetIfExists } } - /// Tries to get details for this resource from the service. + /// + /// Get subscription-level location-based Playwright quota resource by name. + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/providers/MgmtTypeSpec/locations/{location}/playwrightQuotas/{playwrightQuotaName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the PlaywrightQuota. /// The cancellation token to use. public virtual NullableResponse GetIfExists(PlaywrightQuotaName playwrightQuotaName, CancellationToken cancellationToken = default) diff --git a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/PlaywrightQuotaResource.cs b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/PlaywrightQuotaResource.cs index b2f32f3fc760..c50640fe4ef5 100644 --- a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/PlaywrightQuotaResource.cs +++ b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/PlaywrightQuotaResource.cs @@ -92,7 +92,27 @@ internal static void ValidateResourceId(ResourceIdentifier id) } } - /// Get subscription-level location-based Playwright quota resource by name. + /// + /// Get subscription-level location-based Playwright quota resource by name. + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/providers/MgmtTypeSpec/locations/{location}/playwrightQuotas/{playwrightQuotaName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// The cancellation token to use. public virtual async Task> GetAsync(CancellationToken cancellationToken = default) { @@ -120,7 +140,27 @@ public virtual async Task> GetAsync(Cancellati } } - /// Get subscription-level location-based Playwright quota resource by name. + /// + /// Get subscription-level location-based Playwright quota resource by name. + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/providers/MgmtTypeSpec/locations/{location}/playwrightQuotas/{playwrightQuotaName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// The cancellation token to use. public virtual Response Get(CancellationToken cancellationToken = default) { diff --git a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/SelfHelpResource.cs b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/SelfHelpResource.cs index 4c6102829e09..d477f3614195 100644 --- a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/SelfHelpResource.cs +++ b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/SelfHelpResource.cs @@ -89,7 +89,27 @@ internal static void ValidateResourceId(ResourceIdentifier id) } } - /// Get a SelfHelpResource. + /// + /// Get a SelfHelpResource + /// + /// + /// Request Path. + /// /{scope}/providers/MgmtTypeSpec/selfHelps/{selfHelpName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// The cancellation token to use. public virtual async Task> GetAsync(CancellationToken cancellationToken = default) { @@ -117,7 +137,27 @@ public virtual async Task> GetAsync(CancellationToken } } - /// Get a SelfHelpResource. + /// + /// Get a SelfHelpResource + /// + /// + /// Request Path. + /// /{scope}/providers/MgmtTypeSpec/selfHelps/{selfHelpName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// The cancellation token to use. public virtual Response Get(CancellationToken cancellationToken = default) { diff --git a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/SelfHelpResourceCollection.cs b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/SelfHelpResourceCollection.cs index aa0451117c16..0e2e1026bdb8 100644 --- a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/SelfHelpResourceCollection.cs +++ b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/SelfHelpResourceCollection.cs @@ -52,7 +52,23 @@ internal static void ValidateResourceId(ResourceIdentifier id) } } - /// Get a SelfHelpResource. + /// + /// Get a SelfHelpResource + /// + /// + /// Request Path. + /// /{scope}/providers/MgmtTypeSpec/selfHelps/{selfHelpName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the SelfHelpResource. /// The cancellation token to use. /// is null. @@ -85,7 +101,23 @@ public virtual async Task> GetAsync(string selfHelpNa } } - /// Get a SelfHelpResource. + /// + /// Get a SelfHelpResource + /// + /// + /// Request Path. + /// /{scope}/providers/MgmtTypeSpec/selfHelps/{selfHelpName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the SelfHelpResource. /// The cancellation token to use. /// is null. @@ -118,7 +150,23 @@ public virtual Response Get(string selfHelpName, CancellationT } } - /// Checks to see if the resource exists in azure. + /// + /// Get a SelfHelpResource + /// + /// + /// Request Path. + /// /{scope}/providers/MgmtTypeSpec/selfHelps/{selfHelpName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the SelfHelpResource. /// The cancellation token to use. /// is null. @@ -159,7 +207,23 @@ public virtual async Task> ExistsAsync(string selfHelpName, Cance } } - /// Checks to see if the resource exists in azure. + /// + /// Get a SelfHelpResource + /// + /// + /// Request Path. + /// /{scope}/providers/MgmtTypeSpec/selfHelps/{selfHelpName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the SelfHelpResource. /// The cancellation token to use. /// is null. @@ -200,7 +264,23 @@ public virtual Response Exists(string selfHelpName, CancellationToken canc } } - /// Tries to get details for this resource from the service. + /// + /// Get a SelfHelpResource + /// + /// + /// Request Path. + /// /{scope}/providers/MgmtTypeSpec/selfHelps/{selfHelpName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the SelfHelpResource. /// The cancellation token to use. /// is null. @@ -245,7 +325,23 @@ public virtual async Task> GetIfExistsAsync(s } } - /// Tries to get details for this resource from the service. + /// + /// Get a SelfHelpResource + /// + /// + /// Request Path. + /// /{scope}/providers/MgmtTypeSpec/selfHelps/{selfHelpName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the SelfHelpResource. /// The cancellation token to use. /// is null. diff --git a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/ZooCollection.cs b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/ZooCollection.cs index 990bf53b5cf6..cf74924364d4 100644 --- a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/ZooCollection.cs +++ b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/ZooCollection.cs @@ -59,7 +59,23 @@ internal static void ValidateResourceId(ResourceIdentifier id) } } - /// Create a Zoo. + /// + /// Create a Zoo + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/zoos/{zooName}. + /// + /// + /// Operation Id. + /// CreateOrUpdate. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// The name of the Zoo. /// Resource create parameters. @@ -101,7 +117,23 @@ public virtual async Task> CreateOrUpdateAsync(WaitUnt } } - /// Create a Zoo. + /// + /// Create a Zoo + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/zoos/{zooName}. + /// + /// + /// Operation Id. + /// CreateOrUpdate. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// The name of the Zoo. /// Resource create parameters. @@ -143,7 +175,23 @@ public virtual ArmOperation CreateOrUpdate(WaitUntil waitUntil, str } } - /// Get a Zoo. + /// + /// Get a Zoo + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/zoos/{zooName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the Zoo. /// The cancellation token to use. /// is null. @@ -176,7 +224,23 @@ public virtual async Task> GetAsync(string zooName, Cancel } } - /// Get a Zoo. + /// + /// Get a Zoo + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/zoos/{zooName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the Zoo. /// The cancellation token to use. /// is null. @@ -233,7 +297,23 @@ public virtual Pageable GetAll(CancellationToken cancellationToken return new PageableWrapper(new ZoosGetAllCollectionResultOfT(_zoosRestClient, Guid.Parse(Id.SubscriptionId), Id.ResourceGroupName, context), data => new ZooResource(Client, data)); } - /// Checks to see if the resource exists in azure. + /// + /// Get a Zoo + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/zoos/{zooName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the Zoo. /// The cancellation token to use. /// is null. @@ -274,7 +354,23 @@ public virtual async Task> ExistsAsync(string zooName, Cancellati } } - /// Checks to see if the resource exists in azure. + /// + /// Get a Zoo + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/zoos/{zooName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the Zoo. /// The cancellation token to use. /// is null. @@ -315,7 +411,23 @@ public virtual Response Exists(string zooName, CancellationToken cancellat } } - /// Tries to get details for this resource from the service. + /// + /// Get a Zoo + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/zoos/{zooName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the Zoo. /// The cancellation token to use. /// is null. @@ -360,7 +472,23 @@ public virtual async Task> GetIfExistsAsync(string } } - /// Tries to get details for this resource from the service. + /// + /// Get a Zoo + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/zoos/{zooName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// /// The name of the Zoo. /// The cancellation token to use. /// is null. diff --git a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/ZooResource.cs b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/ZooResource.cs index 44bf3e1fbd7d..a9b9707ddc6c 100644 --- a/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/ZooResource.cs +++ b/eng/packages/http-client-csharp-mgmt/generator/TestProjects/Local/Mgmt-TypeSpec/src/Generated/ZooResource.cs @@ -97,7 +97,27 @@ internal static void ValidateResourceId(ResourceIdentifier id) } } - /// Get a Zoo. + /// + /// Get a Zoo + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/zoos/{zooName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// The cancellation token to use. public virtual async Task> GetAsync(CancellationToken cancellationToken = default) { @@ -125,7 +145,27 @@ public virtual async Task> GetAsync(CancellationToken canc } } - /// Get a Zoo. + /// + /// Get a Zoo + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/zoos/{zooName}. + /// + /// + /// Operation Id. + /// Get. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// The cancellation token to use. public virtual Response Get(CancellationToken cancellationToken = default) { @@ -153,7 +193,27 @@ public virtual Response Get(CancellationToken cancellationToken = d } } - /// Delete a Zoo. + /// + /// Delete a Zoo + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/zoos/{zooName}. + /// + /// + /// Operation Id. + /// Delete. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// The cancellation token to use. public virtual async Task DeleteAsync(WaitUntil waitUntil, CancellationToken cancellationToken = default) @@ -182,7 +242,27 @@ public virtual async Task DeleteAsync(WaitUntil waitUntil, Cancell } } - /// Delete a Zoo. + /// + /// Delete a Zoo + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/zoos/{zooName}. + /// + /// + /// Operation Id. + /// Delete. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// if the method should wait to return until the long-running operation has completed on the service; if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples. /// The cancellation token to use. public virtual ArmOperation Delete(WaitUntil waitUntil, CancellationToken cancellationToken = default) @@ -289,7 +369,27 @@ public virtual ArmOperation Update(WaitUntil waitUntil, ZooPatch pa } } - /// A synchronous resource action. + /// + /// A synchronous resource action. + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/zoos/{zooName}/zooAddressList. + /// + /// + /// Operation Id. + /// ZooAddressList. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// /// The cancellation token to use. public virtual async Task> ZooAddressListAsync(int? maxpagesize = default, CancellationToken cancellationToken = default) @@ -318,7 +418,27 @@ public virtual async Task> ZooAddressListAsyn } } - /// A synchronous resource action. + /// + /// A synchronous resource action. + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/zoos/{zooName}/zooAddressList. + /// + /// + /// Operation Id. + /// ZooAddressList. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// /// The cancellation token to use. public virtual Response ZooAddressList(int? maxpagesize = default, CancellationToken cancellationToken = default) @@ -347,7 +467,27 @@ public virtual Response ZooAddressList(int? maxpagesiz } } - /// A synchronous resource action. + /// + /// A synchronous resource action. + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/zoos/{zooName}/recommend. + /// + /// + /// Operation Id. + /// Recommend. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// The cancellation token to use. public virtual async Task> RecommendAsync(CancellationToken cancellationToken = default) { @@ -375,7 +515,27 @@ public virtual Response ZooAddressList(int? maxpagesiz } } - /// A synchronous resource action. + /// + /// A synchronous resource action. + /// + /// + /// Request Path. + /// /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/MgmtTypeSpec/zoos/{zooName}/recommend. + /// + /// + /// Operation Id. + /// Recommend. + /// + /// + /// Default Api Version. + /// 2024-05-01. + /// + /// + /// Resource. + /// . + /// + /// + /// /// The cancellation token to use. public virtual Response Recommend(CancellationToken cancellationToken = default) {