mirror of
https://github.com/dotnet/skills.git
synced 2026-09-20 09:49:54 +08:00
Dan Moseley
042a9d2b2c
* Reorganize plugins per agreed structure (#271) Split the dotnet plugin into domain-specific plugins per discussion in #271: - dotnet: narrowed to common everyday C#/.NET coding tasks - dotnet-diag: perf investigations, debugging, incident analysis - dotnet-data: data access and Entity Framework - dotnet-aspnet, dotnet-wpf, dotnet-winforms, dotnet-maui: scaffolded empty to convey intent for future framework-specific skills Moved skills, tests, and CODEOWNERS entries accordingly. No file content was changed; all skill/test moves are pure renames. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Improve dotnet-diag and dotnet-winforms descriptions - dotnet-diag: add '.NET' qualifier to clarify scope - dotnet-winforms: use official 'Windows Forms (WinForms)' name Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Add .NET qualifier to dotnet-data description Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Remove empty plugins; list them in CONTRIBUTING.md as future options Remove the four empty placeholder plugins (dotnet-aspnet, dotnet-wpf, dotnet-winforms, dotnet-maui) that had only plugin.json and no skills. Add a 'Plugin organization' section to CONTRIBUTING.md that describes the domain-specific plugin groupings introduced in this PR and lists the four removed plugin names as reserved candidates for future contributions. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Create dotnet-upgrade plugin with migration/upgrade skills Move migrate-nullable-references, thread-abort-migration, and dotnet-aot-compat from dotnet to the new dotnet-upgrade plugin. Update CODEOWNERS paths (same owners), CONTRIBUTING.md plugin table, and fix the thread-abort-migration SKILL.md link in CONTRIBUTING.md. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
358 lines
20 KiB
C#
358 lines
20 KiB
C#
// Copyright (c) Microsoft Corporation. All rights reserved.
|
|
// Licensed under the MIT License.
|
|
|
|
// <auto-generated/>
|
|
|
|
#nullable disable
|
|
|
|
using System;
|
|
using System.Globalization;
|
|
using System.Threading;
|
|
using System.Threading.Tasks;
|
|
using Azure.Core;
|
|
using Azure.Core.Pipeline;
|
|
|
|
namespace Azure.ResourceManager.ManagementGroups
|
|
{
|
|
/// <summary>
|
|
/// A Class representing a ManagementGroupSubscription along with the instance operations that can be performed on it.
|
|
/// If you have a <see cref="ResourceIdentifier"/> you can construct a <see cref="ManagementGroupSubscriptionResource"/>
|
|
/// from an instance of <see cref="ArmClient"/> using the GetManagementGroupSubscriptionResource method.
|
|
/// Otherwise you can get one from its parent resource <see cref="ManagementGroupResource"/> using the GetManagementGroupSubscription method.
|
|
/// </summary>
|
|
public partial class ManagementGroupSubscriptionResource : ArmResource
|
|
{
|
|
/// <summary> Generate the resource identifier of a <see cref="ManagementGroupSubscriptionResource"/> instance. </summary>
|
|
/// <param name="groupId"> The groupId. </param>
|
|
/// <param name="subscriptionId"> The subscriptionId. </param>
|
|
public static ResourceIdentifier CreateResourceIdentifier(string groupId, string subscriptionId)
|
|
{
|
|
var resourceId = $"/providers/Microsoft.Management/managementGroups/{groupId}/subscriptions/{subscriptionId}";
|
|
return new ResourceIdentifier(resourceId);
|
|
}
|
|
|
|
private readonly ClientDiagnostics _managementGroupSubscriptionClientDiagnostics;
|
|
private readonly ManagementGroupSubscriptionsRestOperations _managementGroupSubscriptionRestClient;
|
|
private readonly ManagementGroupSubscriptionData _data;
|
|
|
|
/// <summary> Gets the resource type for the operations. </summary>
|
|
public static readonly ResourceType ResourceType = "Microsoft.Management/managementGroups/subscriptions";
|
|
|
|
/// <summary> Initializes a new instance of the <see cref="ManagementGroupSubscriptionResource"/> class for mocking. </summary>
|
|
protected ManagementGroupSubscriptionResource()
|
|
{
|
|
}
|
|
|
|
/// <summary> Initializes a new instance of the <see cref="ManagementGroupSubscriptionResource"/> class. </summary>
|
|
/// <param name="client"> The client parameters to use in these operations. </param>
|
|
/// <param name="data"> The resource that is the target of operations. </param>
|
|
internal ManagementGroupSubscriptionResource(ArmClient client, ManagementGroupSubscriptionData data) : this(client, data.Id)
|
|
{
|
|
HasData = true;
|
|
_data = data;
|
|
}
|
|
|
|
/// <summary> Initializes a new instance of the <see cref="ManagementGroupSubscriptionResource"/> class. </summary>
|
|
/// <param name="client"> The client parameters to use in these operations. </param>
|
|
/// <param name="id"> The identifier of the resource that is the target of operations. </param>
|
|
internal ManagementGroupSubscriptionResource(ArmClient client, ResourceIdentifier id) : base(client, id)
|
|
{
|
|
_managementGroupSubscriptionClientDiagnostics = new ClientDiagnostics("Azure.ResourceManager.ManagementGroups", ResourceType.Namespace, Diagnostics);
|
|
TryGetApiVersion(ResourceType, out string managementGroupSubscriptionApiVersion);
|
|
_managementGroupSubscriptionRestClient = new ManagementGroupSubscriptionsRestOperations(Pipeline, Diagnostics.ApplicationId, Endpoint, managementGroupSubscriptionApiVersion);
|
|
#if DEBUG
|
|
ValidateResourceId(Id);
|
|
#endif
|
|
}
|
|
|
|
/// <summary> Gets whether or not the current instance has data. </summary>
|
|
public virtual bool HasData { get; }
|
|
|
|
/// <summary> Gets the data representing this Feature. </summary>
|
|
/// <exception cref="InvalidOperationException"> Throws if there is no data loaded in the current instance. </exception>
|
|
public virtual ManagementGroupSubscriptionData Data
|
|
{
|
|
get
|
|
{
|
|
if (!HasData)
|
|
throw new InvalidOperationException("The current instance does not have data, you must call Get first.");
|
|
return _data;
|
|
}
|
|
}
|
|
|
|
internal static void ValidateResourceId(ResourceIdentifier id)
|
|
{
|
|
if (id.ResourceType != ResourceType)
|
|
throw new ArgumentException(string.Format(CultureInfo.CurrentCulture, "Invalid resource type {0} expected {1}", id.ResourceType, ResourceType), nameof(id));
|
|
}
|
|
|
|
/// <summary>
|
|
/// Retrieves details about given subscription which is associated with the management group.
|
|
///
|
|
/// <list type="bullet">
|
|
/// <item>
|
|
/// <term>Request Path</term>
|
|
/// <description>/providers/Microsoft.Management/managementGroups/{groupId}/subscriptions/{subscriptionId}</description>
|
|
/// </item>
|
|
/// <item>
|
|
/// <term>Operation Id</term>
|
|
/// <description>ManagementGroupSubscriptions_GetSubscription</description>
|
|
/// </item>
|
|
/// <item>
|
|
/// <term>Default Api Version</term>
|
|
/// <description>2021-04-01</description>
|
|
/// </item>
|
|
/// <item>
|
|
/// <term>Resource</term>
|
|
/// <description><see cref="ManagementGroupSubscriptionResource"/></description>
|
|
/// </item>
|
|
/// </list>
|
|
/// </summary>
|
|
/// <param name="cacheControl"> Indicates whether the request should utilize any caches. Populate the header with 'no-cache' value to bypass existing caches. </param>
|
|
/// <param name="cancellationToken"> The cancellation token to use. </param>
|
|
public virtual async Task<Response<ManagementGroupSubscriptionResource>> GetAsync(string cacheControl = null, CancellationToken cancellationToken = default)
|
|
{
|
|
using var scope = _managementGroupSubscriptionClientDiagnostics.CreateScope("ManagementGroupSubscriptionResource.Get");
|
|
scope.Start();
|
|
try
|
|
{
|
|
var response = await _managementGroupSubscriptionRestClient.GetSubscriptionAsync(Id.Parent.Name, Id.Name, cacheControl, cancellationToken).ConfigureAwait(false);
|
|
if (response.Value == null)
|
|
throw new RequestFailedException(response.GetRawResponse());
|
|
return Response.FromValue(new ManagementGroupSubscriptionResource(Client, response.Value), response.GetRawResponse());
|
|
}
|
|
catch (Exception e)
|
|
{
|
|
scope.Failed(e);
|
|
throw;
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Retrieves details about given subscription which is associated with the management group.
|
|
///
|
|
/// <list type="bullet">
|
|
/// <item>
|
|
/// <term>Request Path</term>
|
|
/// <description>/providers/Microsoft.Management/managementGroups/{groupId}/subscriptions/{subscriptionId}</description>
|
|
/// </item>
|
|
/// <item>
|
|
/// <term>Operation Id</term>
|
|
/// <description>ManagementGroupSubscriptions_GetSubscription</description>
|
|
/// </item>
|
|
/// <item>
|
|
/// <term>Default Api Version</term>
|
|
/// <description>2021-04-01</description>
|
|
/// </item>
|
|
/// <item>
|
|
/// <term>Resource</term>
|
|
/// <description><see cref="ManagementGroupSubscriptionResource"/></description>
|
|
/// </item>
|
|
/// </list>
|
|
/// </summary>
|
|
/// <param name="cacheControl"> Indicates whether the request should utilize any caches. Populate the header with 'no-cache' value to bypass existing caches. </param>
|
|
/// <param name="cancellationToken"> The cancellation token to use. </param>
|
|
public virtual Response<ManagementGroupSubscriptionResource> Get(string cacheControl = null, CancellationToken cancellationToken = default)
|
|
{
|
|
using var scope = _managementGroupSubscriptionClientDiagnostics.CreateScope("ManagementGroupSubscriptionResource.Get");
|
|
scope.Start();
|
|
try
|
|
{
|
|
var response = _managementGroupSubscriptionRestClient.GetSubscription(Id.Parent.Name, Id.Name, cacheControl, cancellationToken);
|
|
if (response.Value == null)
|
|
throw new RequestFailedException(response.GetRawResponse());
|
|
return Response.FromValue(new ManagementGroupSubscriptionResource(Client, response.Value), response.GetRawResponse());
|
|
}
|
|
catch (Exception e)
|
|
{
|
|
scope.Failed(e);
|
|
throw;
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// De-associates subscription from the management group.
|
|
///
|
|
/// <list type="bullet">
|
|
/// <item>
|
|
/// <term>Request Path</term>
|
|
/// <description>/providers/Microsoft.Management/managementGroups/{groupId}/subscriptions/{subscriptionId}</description>
|
|
/// </item>
|
|
/// <item>
|
|
/// <term>Operation Id</term>
|
|
/// <description>ManagementGroupSubscriptions_Delete</description>
|
|
/// </item>
|
|
/// <item>
|
|
/// <term>Default Api Version</term>
|
|
/// <description>2021-04-01</description>
|
|
/// </item>
|
|
/// <item>
|
|
/// <term>Resource</term>
|
|
/// <description><see cref="ManagementGroupSubscriptionResource"/></description>
|
|
/// </item>
|
|
/// </list>
|
|
/// </summary>
|
|
/// <param name="waitUntil"> <see cref="WaitUntil.Completed"/> if the method should wait to return until the long-running operation has completed on the service; <see cref="WaitUntil.Started"/> if it should return after starting the operation. For more information on long-running operations, please see <see href="https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/core/Azure.Core/samples/LongRunningOperations.md"> Azure.Core Long-Running Operation samples</see>. </param>
|
|
/// <param name="cacheControl"> Indicates whether the request should utilize any caches. Populate the header with 'no-cache' value to bypass existing caches. </param>
|
|
/// <param name="cancellationToken"> The cancellation token to use. </param>
|
|
public virtual async Task<ArmOperation> DeleteAsync(WaitUntil waitUntil, string cacheControl = null, CancellationToken cancellationToken = default)
|
|
{
|
|
using var scope = _managementGroupSubscriptionClientDiagnostics.CreateScope("ManagementGroupSubscriptionResource.Delete");
|
|
scope.Start();
|
|
try
|
|
{
|
|
var response = await _managementGroupSubscriptionRestClient.DeleteAsync(Id.Parent.Name, Id.Name, cacheControl, cancellationToken).ConfigureAwait(false);
|
|
var uri = _managementGroupSubscriptionRestClient.CreateDeleteRequestUri(Id.Parent.Name, Id.Name, cacheControl);
|
|
var rehydrationToken = NextLinkOperationImplementation.GetRehydrationToken(RequestMethod.Delete, uri.ToUri(), uri.ToString(), "None", null, OperationFinalStateVia.OriginalUri.ToString());
|
|
var operation = new ManagementGroupsArmOperation(response, rehydrationToken);
|
|
if (waitUntil == WaitUntil.Completed)
|
|
await operation.WaitForCompletionResponseAsync(cancellationToken).ConfigureAwait(false);
|
|
return operation;
|
|
}
|
|
catch (Exception e)
|
|
{
|
|
scope.Failed(e);
|
|
throw;
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// De-associates subscription from the management group.
|
|
///
|
|
/// <list type="bullet">
|
|
/// <item>
|
|
/// <term>Request Path</term>
|
|
/// <description>/providers/Microsoft.Management/managementGroups/{groupId}/subscriptions/{subscriptionId}</description>
|
|
/// </item>
|
|
/// <item>
|
|
/// <term>Operation Id</term>
|
|
/// <description>ManagementGroupSubscriptions_Delete</description>
|
|
/// </item>
|
|
/// <item>
|
|
/// <term>Default Api Version</term>
|
|
/// <description>2021-04-01</description>
|
|
/// </item>
|
|
/// <item>
|
|
/// <term>Resource</term>
|
|
/// <description><see cref="ManagementGroupSubscriptionResource"/></description>
|
|
/// </item>
|
|
/// </list>
|
|
/// </summary>
|
|
/// <param name="waitUntil"> <see cref="WaitUntil.Completed"/> if the method should wait to return until the long-running operation has completed on the service; <see cref="WaitUntil.Started"/> if it should return after starting the operation. For more information on long-running operations, please see <see href="https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/core/Azure.Core/samples/LongRunningOperations.md"> Azure.Core Long-Running Operation samples</see>. </param>
|
|
/// <param name="cacheControl"> Indicates whether the request should utilize any caches. Populate the header with 'no-cache' value to bypass existing caches. </param>
|
|
/// <param name="cancellationToken"> The cancellation token to use. </param>
|
|
public virtual ArmOperation Delete(WaitUntil waitUntil, string cacheControl = null, CancellationToken cancellationToken = default)
|
|
{
|
|
using var scope = _managementGroupSubscriptionClientDiagnostics.CreateScope("ManagementGroupSubscriptionResource.Delete");
|
|
scope.Start();
|
|
try
|
|
{
|
|
var response = _managementGroupSubscriptionRestClient.Delete(Id.Parent.Name, Id.Name, cacheControl, cancellationToken);
|
|
var uri = _managementGroupSubscriptionRestClient.CreateDeleteRequestUri(Id.Parent.Name, Id.Name, cacheControl);
|
|
var rehydrationToken = NextLinkOperationImplementation.GetRehydrationToken(RequestMethod.Delete, uri.ToUri(), uri.ToString(), "None", null, OperationFinalStateVia.OriginalUri.ToString());
|
|
var operation = new ManagementGroupsArmOperation(response, rehydrationToken);
|
|
if (waitUntil == WaitUntil.Completed)
|
|
operation.WaitForCompletionResponse(cancellationToken);
|
|
return operation;
|
|
}
|
|
catch (Exception e)
|
|
{
|
|
scope.Failed(e);
|
|
throw;
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Associates existing subscription with the management group.
|
|
///
|
|
/// <list type="bullet">
|
|
/// <item>
|
|
/// <term>Request Path</term>
|
|
/// <description>/providers/Microsoft.Management/managementGroups/{groupId}/subscriptions/{subscriptionId}</description>
|
|
/// </item>
|
|
/// <item>
|
|
/// <term>Operation Id</term>
|
|
/// <description>ManagementGroupSubscriptions_Create</description>
|
|
/// </item>
|
|
/// <item>
|
|
/// <term>Default Api Version</term>
|
|
/// <description>2021-04-01</description>
|
|
/// </item>
|
|
/// <item>
|
|
/// <term>Resource</term>
|
|
/// <description><see cref="ManagementGroupSubscriptionResource"/></description>
|
|
/// </item>
|
|
/// </list>
|
|
/// </summary>
|
|
/// <param name="waitUntil"> <see cref="WaitUntil.Completed"/> if the method should wait to return until the long-running operation has completed on the service; <see cref="WaitUntil.Started"/> if it should return after starting the operation. For more information on long-running operations, please see <see href="https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/core/Azure.Core/samples/LongRunningOperations.md"> Azure.Core Long-Running Operation samples</see>. </param>
|
|
/// <param name="cacheControl"> Indicates whether the request should utilize any caches. Populate the header with 'no-cache' value to bypass existing caches. </param>
|
|
/// <param name="cancellationToken"> The cancellation token to use. </param>
|
|
public virtual async Task<ArmOperation<ManagementGroupSubscriptionResource>> UpdateAsync(WaitUntil waitUntil, string cacheControl = null, CancellationToken cancellationToken = default)
|
|
{
|
|
using var scope = _managementGroupSubscriptionClientDiagnostics.CreateScope("ManagementGroupSubscriptionResource.Update");
|
|
scope.Start();
|
|
try
|
|
{
|
|
var response = await _managementGroupSubscriptionRestClient.CreateAsync(Id.Parent.Name, Id.Name, cacheControl, cancellationToken).ConfigureAwait(false);
|
|
var uri = _managementGroupSubscriptionRestClient.CreateCreateRequestUri(Id.Parent.Name, Id.Name, cacheControl);
|
|
var rehydrationToken = NextLinkOperationImplementation.GetRehydrationToken(RequestMethod.Put, uri.ToUri(), uri.ToString(), "None", null, OperationFinalStateVia.OriginalUri.ToString());
|
|
var operation = new ManagementGroupsArmOperation<ManagementGroupSubscriptionResource>(Response.FromValue(new ManagementGroupSubscriptionResource(Client, response), response.GetRawResponse()), rehydrationToken);
|
|
if (waitUntil == WaitUntil.Completed)
|
|
await operation.WaitForCompletionAsync(cancellationToken).ConfigureAwait(false);
|
|
return operation;
|
|
}
|
|
catch (Exception e)
|
|
{
|
|
scope.Failed(e);
|
|
throw;
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Associates existing subscription with the management group.
|
|
///
|
|
/// <list type="bullet">
|
|
/// <item>
|
|
/// <term>Request Path</term>
|
|
/// <description>/providers/Microsoft.Management/managementGroups/{groupId}/subscriptions/{subscriptionId}</description>
|
|
/// </item>
|
|
/// <item>
|
|
/// <term>Operation Id</term>
|
|
/// <description>ManagementGroupSubscriptions_Create</description>
|
|
/// </item>
|
|
/// <item>
|
|
/// <term>Default Api Version</term>
|
|
/// <description>2021-04-01</description>
|
|
/// </item>
|
|
/// <item>
|
|
/// <term>Resource</term>
|
|
/// <description><see cref="ManagementGroupSubscriptionResource"/></description>
|
|
/// </item>
|
|
/// </list>
|
|
/// </summary>
|
|
/// <param name="waitUntil"> <see cref="WaitUntil.Completed"/> if the method should wait to return until the long-running operation has completed on the service; <see cref="WaitUntil.Started"/> if it should return after starting the operation. For more information on long-running operations, please see <see href="https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/core/Azure.Core/samples/LongRunningOperations.md"> Azure.Core Long-Running Operation samples</see>. </param>
|
|
/// <param name="cacheControl"> Indicates whether the request should utilize any caches. Populate the header with 'no-cache' value to bypass existing caches. </param>
|
|
/// <param name="cancellationToken"> The cancellation token to use. </param>
|
|
public virtual ArmOperation<ManagementGroupSubscriptionResource> Update(WaitUntil waitUntil, string cacheControl = null, CancellationToken cancellationToken = default)
|
|
{
|
|
using var scope = _managementGroupSubscriptionClientDiagnostics.CreateScope("ManagementGroupSubscriptionResource.Update");
|
|
scope.Start();
|
|
try
|
|
{
|
|
var response = _managementGroupSubscriptionRestClient.Create(Id.Parent.Name, Id.Name, cacheControl, cancellationToken);
|
|
var uri = _managementGroupSubscriptionRestClient.CreateCreateRequestUri(Id.Parent.Name, Id.Name, cacheControl);
|
|
var rehydrationToken = NextLinkOperationImplementation.GetRehydrationToken(RequestMethod.Put, uri.ToUri(), uri.ToString(), "None", null, OperationFinalStateVia.OriginalUri.ToString());
|
|
var operation = new ManagementGroupsArmOperation<ManagementGroupSubscriptionResource>(Response.FromValue(new ManagementGroupSubscriptionResource(Client, response), response.GetRawResponse()), rehydrationToken);
|
|
if (waitUntil == WaitUntil.Completed)
|
|
operation.WaitForCompletion(cancellationToken);
|
|
return operation;
|
|
}
|
|
catch (Exception e)
|
|
{
|
|
scope.Failed(e);
|
|
throw;
|
|
}
|
|
}
|
|
}
|
|
}
|