diff --git a/specification/applink/AppLink.Management/applink.tsp b/specification/applink/AppLink.Management/applink.tsp new file mode 100644 index 000000000000..45cf5014300b --- /dev/null +++ b/specification/applink/AppLink.Management/applink.tsp @@ -0,0 +1,45 @@ +import "@typespec/rest"; +import "@typespec/http"; +import "@azure-tools/typespec-azure-core"; +import "@azure-tools/typespec-azure-resource-manager"; +import "./commontypes.tsp"; + +using Azure.ResourceManager; + +namespace Microsoft.AppLink; + +@doc("AppLink resource") +model AppLink is TrackedResource { + ...ResourceNameParameter; + ...ManagedServiceIdentityProperty; +} + +@doc("AppLink properties") +model AppLinkProperties { + @doc("Provisioning state") + @visibility(Lifecycle.Read) + provisioningState?: ProvisioningState; +} + +@armResourceOperations +interface AppLinks { + @doc("Get an AppLink.") + get is ArmResourceRead; + @doc("Create an AppLink.") + createOrUpdate is ArmResourceCreateOrReplaceAsync; + @doc("Update an AppLink.") + @Azure.Core.useFinalStateVia("azure-async-operation") + update is ArmResourcePatchAsync< + AppLink, + AppLinkProperties, + LroHeaders = ArmAsyncOperationHeader & + ArmLroLocationHeader & + Azure.Core.Foundations.RetryAfterHeader + >; + @doc("Delete an AppLink.") + delete is ArmResourceDeleteWithoutOkAsync; + @doc("List AppLink resources by resource group.") + listByResourceGroup is ArmResourceListByParent; + @doc("List AppLink resources by subscription.") + listBySubscription is ArmListBySubscription; +} diff --git a/specification/applink/AppLink.Management/applinkavailableversion.tsp b/specification/applink/AppLink.Management/applinkavailableversion.tsp new file mode 100644 index 000000000000..f042f22c295f --- /dev/null +++ b/specification/applink/AppLink.Management/applinkavailableversion.tsp @@ -0,0 +1,78 @@ +import "@typespec/rest"; +import "@typespec/http"; +import "@azure-tools/typespec-azure-core"; +import "@azure-tools/typespec-azure-resource-manager"; +import "@typespec/openapi"; + +using TypeSpec.Rest; +using TypeSpec.Http; +using Azure.ResourceManager; + +namespace Microsoft.AppLink; + +@doc("AppLink available version resource") +@parentResource(ArmLocationResource<"Subscription">) +model AvailableVersion is ProxyResource { + ...ResourceNameParameter; +} + +@doc("AppLink available version properties") +model AvailableVersionProperties { + @doc("Kubernetes version") + kubernetesVersion: string; + + @doc("Fully managed versions") + fullyManagedVersions: FullyManagedVersions; + + @doc("Self managed versions") + selfManagedVersions: SelfManagedVersions; + + @doc("Provisioning state") + @visibility(Lifecycle.Read) + provisioningState?: ProvisioningState; +} + +@doc("Fully managed versions") +model FullyManagedVersions { + @doc("Release channels") + @identifiers(#["releaseChannel", "version"]) + releaseChannels: ReleaseChannelInfo[]; +} + +@doc("Self managed versions") +model SelfManagedVersions { + @doc("Istio versions") + @identifiers(#["version", "upgrades"]) + versions: VersionInfo[]; +} + +@doc("Release channel information") +model ReleaseChannelInfo { + @doc("Release channel") + releaseChannel: string; + + @doc("Istio version behind release channel") + version: string; +} + +@doc("Version information") +model VersionInfo { + @doc("Istio version") + version: string; + + @doc("Available upgrades") + upgrades: string[]; +} + +@armResourceOperations +interface AvailableVersions { + @doc("List AvailableVersion resources by location.") + listByLocation is ArmResourceListByParent< + Resource = AvailableVersion, + Parameters = { + @doc("Kubernetes version to filter profiles") + @query("kubernetesVersion") + kubernetesVersion?: string; + } + >; +} diff --git a/specification/applink/AppLink.Management/applinkmember.tsp b/specification/applink/AppLink.Management/applinkmember.tsp new file mode 100644 index 000000000000..95e92dc4d233 --- /dev/null +++ b/specification/applink/AppLink.Management/applinkmember.tsp @@ -0,0 +1,169 @@ +import "@typespec/rest"; +import "@typespec/http"; +import "@typespec/openapi"; +import "@azure-tools/typespec-azure-core"; +import "@azure-tools/typespec-azure-resource-manager"; +import "./applink.tsp"; + +using TypeSpec.Rest; +using Azure.Core; +using Azure.ResourceManager; + +namespace Microsoft.AppLink; + +@doc("AppLink Member resource") +@parentResource(AppLink) +model AppLinkMember is TrackedResource { + ...ResourceNameParameter; +} + +@doc("AppLink Member properties") +model AppLinkMemberProperties { + @doc("Cluster type") + @visibility(Lifecycle.Create, Lifecycle.Read) + clusterType?: ClusterType; + + @doc("AppLink Member Metadata") + metadata: Metadata; + + @doc("Upgrade profile.") + upgradeProfile?: UpgradeProfile; + + @doc("Observability profile") + observabilityProfile?: ObservabilityProfile; + + @doc("Connectivity profile.") + connectivityProfile?: ConnectivityProfile; + + @doc("Provisioning state") + @visibility(Lifecycle.Read) + provisioningState?: ProvisioningState; +} + +@doc("AppLinkMember cluster type") +union ClusterType { + string, + + @doc("Azure Kubernetes Service") + AKS: "AKS", +} + +@doc("AppLinkMember metadata") +model Metadata { + @doc("Resource ID") + @visibility(Lifecycle.Create, Lifecycle.Read) + resourceId: Azure.Core.armResourceIdentifier; +} + +@doc("AppLinkMember upgrade profile.") +model UpgradeProfile { + @doc("Upgrade mode.") + mode: UpgradeMode; + + @doc("Fully managed upgrade profile.") + fullyManagedUpgradeProfile?: FullyManagedUpgradeProfile; + + @doc("Self managed upgrade profile.") + selfManagedUpgradeProfile?: SelfManagedUpgradeProfile; +} + +@doc("AppLinkMember upgrade release channel") +union UpgradeReleaseChannel { + string, + + @doc("Rapid release channel") + Rapid: "Rapid", + + @doc("Stable release channel") + Stable: "Stable", +} + +@doc("AppLinkMember upgrade mode") +union UpgradeMode { + string, + + @doc("Fully managed upgrade mode") + FullyManaged: "FullyManaged", + + @doc("Self managed upgrade mode") + SelfManaged: "SelfManaged", +} + +@doc("AppLinkMember fully managed upgrade profile") +model FullyManagedUpgradeProfile { + @doc("Release channel") + releaseChannel: UpgradeReleaseChannel; +} + +@doc("AppLinkMember self managed upgrade profile") +model SelfManagedUpgradeProfile { + @doc("Istio version") + version: string; +} + +@doc("AppLinkMember observability profile") +model ObservabilityProfile { + @doc("Metrics configuration") + metrics?: MetricsProfile; +} + +@doc("AppLinkMember connectivity profile.") +model ConnectivityProfile { + @doc("East-West gateway profile.") + eastWestGateway?: EastWestGatewayProfile; + + @doc("Private connect profile.") + privateConnect?: PrivateConnectProfile; +} + +@doc("AppLinkMember private connect profile.") +model PrivateConnectProfile { + @doc("Delegated Subnet to AppLink.") + @visibility(Lifecycle.Read, Lifecycle.Create) + subnetResourceId: armResourceIdentifier; +} + +@doc("AppLinkMember metrics profile") +model MetricsProfile { + @doc("Metrics endpoint URL") + @visibility(Lifecycle.Read) + metricsEndpoint?: string; +} + +@doc("AppLinkMember east-west gateway profile.") +model EastWestGatewayProfile { + @doc("East-West gateway visibility.") + visibility: EastWestGatewayVisibility; +} + +@doc("East-West gateway visibility.") +union EastWestGatewayVisibility { + string, + + @doc("Use an internal load balancer for the east-west gateway.") + Internal: "Internal", + + @doc("Use an external load balancer for the east-west gateway.") + External: "External", +} + +@armResourceOperations +interface AppLinkMembers { + @doc("Get an AppLinkMember.") + get is ArmResourceRead; + @doc("Create an AppLinkMember.") + createOrUpdate is ArmResourceCreateOrReplaceAsync; + @doc("Update an AppLinkMember.") + @Azure.Core.useFinalStateVia("azure-async-operation") + update is ArmResourcePatchAsync< + AppLinkMember, + AppLinkMemberProperties, + LroHeaders = ArmAsyncOperationHeader & + ArmLroLocationHeader & + Azure.Core.Foundations.RetryAfterHeader + >; + @doc("Delete an AppLinkMember.") + delete is ArmResourceDeleteWithoutOkAsync; + @doc("List AppLinkMember resources by AppLink.") + listByAppLink is ArmResourceListByParent; +} diff --git a/specification/applink/AppLink.Management/applinkmemberupgradehistory.tsp b/specification/applink/AppLink.Management/applinkmemberupgradehistory.tsp new file mode 100644 index 000000000000..4b67ecbac60b --- /dev/null +++ b/specification/applink/AppLink.Management/applinkmemberupgradehistory.tsp @@ -0,0 +1,44 @@ +import "@typespec/rest"; +import "@typespec/http"; +import "@azure-tools/typespec-azure-core"; +import "@azure-tools/typespec-azure-resource-manager"; +import "./applinkmember.tsp"; + +using TypeSpec.Rest; +using Azure.ResourceManager; + +namespace Microsoft.AppLink; + +@doc("AppLinkMember upgrade history") +@parentResource(AppLinkMember) +model UpgradeHistory is ProxyResource { + ...ResourceNameParameter; +} + +@doc("AppLinkMember upgrade history properties") +model UpgradeHistoryProperties { + @doc("Start timestamp") + startTimestamp: utcDateTime; + + @doc("End timestamp") + endTimestamp?: utcDateTime; + + @doc("Upgrade initiator") + initiatedBy: string; + + @doc("Version upgraded from") + fromVersion: string; + + @doc("Version upgraded to") + toVersion: string; + + @doc("Provisioning state") + @visibility(Lifecycle.Read) + provisioningState?: ProvisioningState; +} + +@armResourceOperations +interface UpgradeHistories { + @doc("List UpgradeHistory resources by AppLinkMember.") + listByAppLinkMember is ArmResourceListByParent; +} diff --git a/specification/applink/AppLink.Management/commontypes.tsp b/specification/applink/AppLink.Management/commontypes.tsp new file mode 100644 index 000000000000..65cef2a827b2 --- /dev/null +++ b/specification/applink/AppLink.Management/commontypes.tsp @@ -0,0 +1,22 @@ +import "@azure-tools/typespec-azure-resource-manager"; + +using Azure.ResourceManager; + +namespace Microsoft.AppLink; + +@doc("Provisioning state of the resource") +union ProvisioningState { + ResourceProvisioningState, + + @doc("Resource is getting provisioned.") + Provisioning: "Provisioning", + + @doc("Resource is Updating.") + Updating: "Updating", + + @doc("Resource is Deleting.") + Deleting: "Deleting", + + @doc("Resource has been Accepted.") + Accepted: "Accepted", +} diff --git a/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinkMembers_CreateOrUpdate.json b/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinkMembers_CreateOrUpdate.json new file mode 100644 index 000000000000..42b20699a9cb --- /dev/null +++ b/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinkMembers_CreateOrUpdate.json @@ -0,0 +1,133 @@ +{ + "title": "AppLinkMembers_CreateOrUpdate", + "operationId": "AppLinkMembers_CreateOrUpdate", + "parameters": { + "api-version": "2025-08-01-preview", + "subscriptionId": "11809CA1-E126-4017-945E-AA795CD5C5A9", + "resourceGroupName": "test_rg", + "appLinkName": "applink-test-01", + "appLinkMemberName": "member-01", + "resource": { + "properties": { + "clusterType": "AKS", + "metadata": { + "resourceId": "/subscriptions/bc7e0da9-5e4c-4a91-9252-9658837006cf/resourcegroups/applink-rg/providers/Microsoft.ContainerService/managedClusters/applink-member1" + }, + "upgradeProfile": { + "mode": "FullyManaged", + "fullyManagedUpgradeProfile": { + "releaseChannel": "Stable" + } + }, + "connectivityProfile": { + "privateConnect": { + "subnetResourceId": "/subscriptions/bc7e0da9-5e4c-4a91-9252-9658837006cf/resourceGroups/applink-vnet-rg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1" + }, + "eastWestGateway": { + "visibility": "Internal" + } + } + }, + "tags": { + "key2913": "test_tag" + }, + "location": "westus2" + } + }, + "responses": { + "200": { + "body": { + "properties": { + "clusterType": "AKS", + "metadata": { + "resourceId": "/subscriptions/bc7e0da9-5e4c-4a91-9252-9658837006cf/resourcegroups/applink-rg/providers/Microsoft.ContainerService/managedClusters/applink-member1" + }, + "upgradeProfile": { + "mode": "FullyManaged", + "fullyManagedUpgradeProfile": { + "releaseChannel": "Stable" + } + }, + "observabilityProfile": { + "metrics": { + "metricsEndpoint": "https://mcp-fqdn" + } + }, + "connectivityProfile": { + "privateConnect": { + "subnetResourceId": "/subscriptions/bc7e0da9-5e4c-4a91-9252-9658837006cf/resourceGroups/applink-vnet-rg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1" + }, + "eastWestGateway": { + "visibility": "Internal" + } + }, + "provisioningState": "Succeeded" + }, + "tags": { + "key2913": "test_tag" + }, + "location": "westus2", + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-01/appLinkMembers/member-01", + "name": "member-01", + "type": "Microsoft.AppLink/appLinks/appLinkMembers", + "systemData": { + "createdBy": "user01", + "createdByType": "User", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "user02", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + } + }, + "201": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/providers/Microsoft.AppLink/locations/westus2/operationStatuses/12345678-1234-1234-1234-123456789abc", + "Retry-After": "10" + }, + "body": { + "properties": { + "clusterType": "AKS", + "metadata": { + "resourceId": "/subscriptions/bc7e0da9-5e4c-4a91-9252-9658837006cf/resourcegroups/applink-rg/providers/Microsoft.ContainerService/managedClusters/applink-member1" + }, + "upgradeProfile": { + "mode": "FullyManaged", + "fullyManagedUpgradeProfile": { + "releaseChannel": "Stable" + } + }, + "observabilityProfile": { + "metrics": { + "metricsEndpoint": "https://mcp-fqdn" + } + }, + "connectivityProfile": { + "privateConnect": { + "subnetResourceId": "/subscriptions/bc7e0da9-5e4c-4a91-9252-9658837006cf/resourceGroups/applink-vnet-rg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1" + }, + "eastWestGateway": { + "visibility": "Internal" + } + }, + "provisioningState": "Provisioning" + }, + "tags": { + "key2913": "test_tag" + }, + "location": "westus2", + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-01/appLinkMembers/member-01", + "name": "member-01", + "type": "Microsoft.AppLink/appLinks/appLinkMembers", + "systemData": { + "createdBy": "user01", + "createdByType": "User", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "user02", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + } + } + } +} diff --git a/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinkMembers_Delete.json b/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinkMembers_Delete.json new file mode 100644 index 000000000000..4d2265f14823 --- /dev/null +++ b/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinkMembers_Delete.json @@ -0,0 +1,20 @@ +{ + "title": "AppLinkMembers_Delete", + "operationId": "AppLinkMembers_Delete", + "parameters": { + "api-version": "2025-08-01-preview", + "subscriptionId": "11809CA1-E126-4017-945E-AA795CD5C5A9", + "resourceGroupName": "test_rg", + "appLinkName": "applink-test-01", + "appLinkMemberName": "member-01" + }, + "responses": { + "202": { + "headers": { + "Location": "https://management.azure.com/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/providers/Microsoft.AppLink/locations/westus2/operationStatuses/12345678-1234-1234-1234-123456789abc", + "Retry-After": "30" + } + }, + "204": {} + } +} diff --git a/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinkMembers_Get.json b/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinkMembers_Get.json new file mode 100644 index 000000000000..df2def397460 --- /dev/null +++ b/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinkMembers_Get.json @@ -0,0 +1,58 @@ +{ + "title": "AppLinkMembers_Get", + "operationId": "AppLinkMembers_Get", + "parameters": { + "api-version": "2025-08-01-preview", + "subscriptionId": "11809CA1-E126-4017-945E-AA795CD5C5A9", + "resourceGroupName": "test_rg", + "appLinkName": "applink-test-01", + "appLinkMemberName": "member-01" + }, + "responses": { + "200": { + "body": { + "properties": { + "clusterType": "AKS", + "metadata": { + "resourceId": "/subscriptions/bc7e0da9-5e4c-4a91-9252-9658837006cf/resourcegroups/applink-rg/providers/Microsoft.ContainerService/managedClusters/applink-member1" + }, + "upgradeProfile": { + "mode": "FullyManaged", + "fullyManagedUpgradeProfile": { + "releaseChannel": "Stable" + } + }, + "observabilityProfile": { + "metrics": { + "metricsEndpoint": "https://mcp-fqdn" + } + }, + "connectivityProfile": { + "privateConnect": { + "subnetResourceId": "/subscriptions/bc7e0da9-5e4c-4a91-9252-9658837006cf/resourceGroups/applink-vnet-rg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1" + }, + "eastWestGateway": { + "visibility": "Internal" + } + }, + "provisioningState": "Succeeded" + }, + "tags": { + "key2913": "test_tag" + }, + "location": "westus2", + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-01/appLinkMembers/member-01", + "name": "member-01", + "type": "Microsoft.AppLink/appLinks/appLinkMembers", + "systemData": { + "createdBy": "user01", + "createdByType": "User", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "user02", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + } + } + } +} diff --git a/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinkMembers_ListByAppLink.json b/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinkMembers_ListByAppLink.json new file mode 100644 index 000000000000..ea139ff8b50b --- /dev/null +++ b/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinkMembers_ListByAppLink.json @@ -0,0 +1,102 @@ +{ + "title": "AppLinkMembers_ListByAppLink", + "operationId": "AppLinkMembers_ListByAppLink", + "parameters": { + "api-version": "2025-08-01-preview", + "subscriptionId": "11809CA1-E126-4017-945E-AA795CD5C5A9", + "resourceGroupName": "test_rg", + "appLinkName": "applink-test-01" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "properties": { + "clusterType": "AKS", + "metadata": { + "resourceId": "/subscriptions/bc7e0da9-5e4c-4a91-9252-9658837006cf/resourcegroups/applink-rg/providers/Microsoft.ContainerService/managedClusters/applink-member1" + }, + "upgradeProfile": { + "mode": "FullyManaged", + "fullyManagedUpgradeProfile": { + "releaseChannel": "Stable" + } + }, + "observabilityProfile": { + "metrics": { + "metricsEndpoint": "https://mcp-fqdn" + } + }, + "connectivityProfile": { + "privateConnect": { + "subnetResourceId": "/subscriptions/bc7e0da9-5e4c-4a91-9252-9658837006cf/resourceGroups/applink-vnet-rg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1" + }, + "eastWestGateway": { + "visibility": "Internal" + } + }, + "provisioningState": "Succeeded" + }, + "tags": { + "key2913": "test_tag" + }, + "location": "westus2", + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-01/appLinkMembers/member-01", + "name": "member-01", + "type": "Microsoft.AppLink/appLinks/appLinkMembers", + "systemData": { + "createdBy": "user01", + "createdByType": "User", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "user02", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + }, + { + "properties": { + "clusterType": "AKS", + "metadata": { + "resourceId": "/subscriptions/bc7e0da9-5e4c-4a91-9252-9658837006cf/resourcegroups/applink-rg/providers/Microsoft.ContainerService/managedClusters/applink-member2" + }, + "upgradeProfile": { + "mode": "SelfManaged", + "selfManagedUpgradeProfile": { + "version": "1.27" + } + }, + "observabilityProfile": { + "metrics": { + "metricsEndpoint": "https://mcp-fqdn" + } + }, + "connectivityProfile": { + "eastWestGateway": { + "visibility": "External" + } + }, + "provisioningState": "Succeeded" + }, + "tags": { + "env": "production" + }, + "location": "westus2", + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-01/appLinkMembers/member-02", + "name": "member-02", + "type": "Microsoft.AppLink/appLinks/appLinkMembers", + "systemData": { + "createdBy": "user01", + "createdByType": "User", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "user02", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + } + ], + "nextLink": "https://management.azure.com/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-01/appLinkMembers?api-version=2025-08-01-preview&$skiptoken=eyJjb250aW51YXRpb24iOiAibWVtYmVyLTAzIn0%3D" + } + } + } +} diff --git a/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinkMembers_Update.json b/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinkMembers_Update.json new file mode 100644 index 000000000000..2127ec7d0101 --- /dev/null +++ b/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinkMembers_Update.json @@ -0,0 +1,83 @@ +{ + "title": "AppLinkMembers_Update", + "operationId": "AppLinkMembers_Update", + "parameters": { + "api-version": "2025-08-01-preview", + "subscriptionId": "11809CA1-E126-4017-945E-AA795CD5C5A9", + "resourceGroupName": "test_rg", + "appLinkName": "applink-test-01", + "appLinkMemberName": "member-01", + "properties": { + "tags": { + "key7952": "updated_tag_value" + }, + "properties": { + "upgradeProfile": { + "mode": "SelfManaged", + "selfManagedUpgradeProfile": { + "version": "1.26" + } + }, + "connectivityProfile": { + "eastWestGateway": { + "visibility": "Internal" + } + } + } + } + }, + "responses": { + "200": { + "body": { + "properties": { + "clusterType": "AKS", + "metadata": { + "resourceId": "/subscriptions/bc7e0da9-5e4c-4a91-9252-9658837006cf/resourcegroups/applink-rg/providers/Microsoft.ContainerService/managedClusters/applink-member1" + }, + "upgradeProfile": { + "mode": "SelfManaged", + "selfManagedUpgradeProfile": { + "version": "1.26" + } + }, + "observabilityProfile": { + "metrics": { + "metricsEndpoint": "https://mcp-fqdn" + } + }, + "connectivityProfile": { + "privateConnect": { + "subnetResourceId": "/subscriptions/bc7e0da9-5e4c-4a91-9252-9658837006cf/resourceGroups/applink-vnet-rg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1" + }, + "eastWestGateway": { + "visibility": "Internal" + } + }, + "provisioningState": "Succeeded" + }, + "tags": { + "key7952": "updated_tag_value" + }, + "location": "westus2", + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-01/appLinkMembers/member-01", + "name": "member-01", + "type": "Microsoft.AppLink/appLinks/appLinkMembers", + "systemData": { + "createdBy": "user01", + "createdByType": "User", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "user02", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/providers/Microsoft.AppLink/locations/westus2/operationStatuses/12345678-1234-1234-1234-123456789abc", + "Location": "https://management.azure.com/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/providers/Microsoft.AppLink/locations/westus2/operationStatuses/12345678-1234-1234-1234-123456789abc", + "Retry-After": "30" + } + } + } +} diff --git a/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinks_CreateOrUpdate.json b/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinks_CreateOrUpdate.json new file mode 100644 index 000000000000..e0b8a5ebdc20 --- /dev/null +++ b/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinks_CreateOrUpdate.json @@ -0,0 +1,80 @@ +{ + "title": "AppLinks_CreateOrUpdate", + "operationId": "AppLinks_CreateOrUpdate", + "parameters": { + "api-version": "2025-08-01-preview", + "subscriptionId": "11809CA1-E126-4017-945E-AA795CD5C5A9", + "resourceGroupName": "test_rg", + "appLinkName": "applink-test-01", + "resource": { + "properties": {}, + "identity": { + "type": "SystemAssigned" + }, + "tags": { + "key2913": "test_tag" + }, + "location": "westus2" + } + }, + "responses": { + "200": { + "body": { + "properties": { + "provisioningState": "Succeeded" + }, + "identity": { + "type": "SystemAssigned", + "principalId": "00000000-1111-2222-3333-444444444444", + "tenantId": "00000000-1111-2222-3333-444444444444" + }, + "tags": { + "key2913": "test_tag" + }, + "location": "westus2", + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-01", + "name": "applink-test-01", + "type": "Microsoft.AppLink/appLinks", + "systemData": { + "createdBy": "user01", + "createdByType": "User", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "user02", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + } + }, + "201": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/providers/Microsoft.AppLink/locations/westus2/operationStatuses/12345678-1234-1234-1234-123456789abc", + "Retry-After": "10" + }, + "body": { + "properties": { + "provisioningState": "Provisioning" + }, + "identity": { + "type": "SystemAssigned", + "principalId": "00000000-1111-2222-3333-444444444444", + "tenantId": "00000000-1111-2222-3333-444444444444" + }, + "tags": { + "key2913": "test_tag" + }, + "location": "westus2", + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-01", + "name": "applink-test-01", + "type": "Microsoft.AppLink/appLinks", + "systemData": { + "createdBy": "user01", + "createdByType": "User", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "user02", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + } + } + } +} diff --git a/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinks_Delete.json b/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinks_Delete.json new file mode 100644 index 000000000000..459b0e062d36 --- /dev/null +++ b/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinks_Delete.json @@ -0,0 +1,19 @@ +{ + "title": "AppLinks_Delete", + "operationId": "AppLinks_Delete", + "parameters": { + "api-version": "2025-08-01-preview", + "subscriptionId": "11809CA1-E126-4017-945E-AA795CD5C5A9", + "resourceGroupName": "test_rg", + "appLinkName": "applink-test-01" + }, + "responses": { + "202": { + "headers": { + "Location": "https://management.azure.com/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/providers/Microsoft.AppLink/locations/westus2/operationStatuses/12345678-1234-1234-1234-123456789abc", + "Retry-After": "30" + } + }, + "204": {} + } +} diff --git a/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinks_Get.json b/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinks_Get.json new file mode 100644 index 000000000000..102b6b91e84a --- /dev/null +++ b/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinks_Get.json @@ -0,0 +1,39 @@ +{ + "title": "AppLinks_Get", + "operationId": "AppLinks_Get", + "parameters": { + "api-version": "2025-08-01-preview", + "subscriptionId": "11809CA1-E126-4017-945E-AA795CD5C5A9", + "resourceGroupName": "test_rg", + "appLinkName": "applink-test-01" + }, + "responses": { + "200": { + "body": { + "properties": { + "provisioningState": "Succeeded" + }, + "identity": { + "type": "SystemAssigned", + "principalId": "00000000-1111-2222-3333-444444444444", + "tenantId": "00000000-1111-2222-3333-444444444444" + }, + "tags": { + "key2913": "test_tag" + }, + "location": "westus2", + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-01", + "name": "applink-test-01", + "type": "Microsoft.AppLink/appLinks", + "systemData": { + "createdBy": "user01", + "createdByType": "User", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "user02", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + } + } + } +} diff --git a/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinks_ListByResourceGroup.json b/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinks_ListByResourceGroup.json new file mode 100644 index 000000000000..5780d50046a7 --- /dev/null +++ b/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinks_ListByResourceGroup.json @@ -0,0 +1,72 @@ +{ + "title": "AppLinks_ListByResourceGroup", + "operationId": "AppLinks_ListByResourceGroup", + "parameters": { + "api-version": "2025-08-01-preview", + "subscriptionId": "11809CA1-E126-4017-945E-AA795CD5C5A9", + "resourceGroupName": "test_rg" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "properties": { + "provisioningState": "Succeeded" + }, + "identity": { + "type": "SystemAssigned", + "principalId": "00000000-1111-2222-3333-444444444444", + "tenantId": "00000000-1111-2222-3333-444444444444" + }, + "tags": { + "key2913": "test_tag" + }, + "location": "westus2", + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-01", + "name": "applink-test-01", + "type": "Microsoft.AppLink/appLinks", + "systemData": { + "createdBy": "user01", + "createdByType": "User", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "user02", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + }, + { + "properties": { + "provisioningState": "Succeeded" + }, + "identity": { + "type": "UserAssigned", + "userAssignedIdentities": { + "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/test-identity": { + "principalId": "11111111-2222-3333-4444-555555555555", + "clientId": "66666666-7777-8888-9999-aaaaaaaaaaaa" + } + } + }, + "tags": { + "environment": "production" + }, + "location": "westus2", + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-02", + "name": "applink-test-02", + "type": "Microsoft.AppLink/appLinks", + "systemData": { + "createdBy": "user01", + "createdByType": "User", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "user02", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + } + ], + "nextLink": "https://management.azure.com/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks?api-version=2025-08-01-preview&$skiptoken=eyJjb250aW51YXRpb24iOiAiYXBwbGluay10ZXN0LTAzIn0%3D" + } + } + } +} diff --git a/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinks_ListBySubscription.json b/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinks_ListBySubscription.json new file mode 100644 index 000000000000..69b551935a0e --- /dev/null +++ b/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinks_ListBySubscription.json @@ -0,0 +1,98 @@ +{ + "title": "AppLinks_ListBySubscription", + "operationId": "AppLinks_ListBySubscription", + "parameters": { + "api-version": "2025-08-01-preview", + "subscriptionId": "11809CA1-E126-4017-945E-AA795CD5C5A9" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "properties": { + "provisioningState": "Succeeded" + }, + "identity": { + "type": "SystemAssigned", + "principalId": "00000000-1111-2222-3333-444444444444", + "tenantId": "00000000-1111-2222-3333-444444444444" + }, + "tags": { + "environment": "production", + "team": "platform" + }, + "location": "westus2", + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/rg1/providers/Microsoft.AppLink/appLinks/applink-prod-01", + "name": "applink-prod-01", + "type": "Microsoft.AppLink/appLinks", + "systemData": { + "createdBy": "user01", + "createdByType": "User", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "user02", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + }, + { + "properties": { + "provisioningState": "Succeeded" + }, + "identity": { + "type": "UserAssigned", + "userAssignedIdentities": { + "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/rg2/providers/Microsoft.ManagedIdentity/userAssignedIdentities/applink-identity": { + "principalId": "22222222-3333-4444-5555-666666666666", + "clientId": "77777777-8888-9999-aaaa-bbbbbbbbbbbb" + } + } + }, + "tags": { + "environment": "development", + "cost-center": "engineering" + }, + "location": "eastus", + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/rg2/providers/Microsoft.AppLink/appLinks/applink-dev-01", + "name": "applink-dev-01", + "type": "Microsoft.AppLink/appLinks", + "systemData": { + "createdBy": "dev-user", + "createdByType": "User", + "createdAt": "2023-06-10T14:22:30.000Z", + "lastModifiedBy": "dev-user", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-06-15T09:15:45.000Z" + } + }, + { + "properties": { + "provisioningState": "Provisioning" + }, + "identity": { + "type": "SystemAssigned", + "principalId": "33333333-4444-5555-6666-777777777777", + "tenantId": "00000000-1111-2222-3333-444444444444" + }, + "tags": { + "environment": "staging" + }, + "location": "northeurope", + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/rg3/providers/Microsoft.AppLink/appLinks/applink-staging-01", + "name": "applink-staging-01", + "type": "Microsoft.AppLink/appLinks", + "systemData": { + "createdBy": "staging-user", + "createdByType": "User", + "createdAt": "2023-07-01T08:30:00.000Z", + "lastModifiedBy": "staging-user", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-07-01T08:30:00.000Z" + } + } + ], + "nextLink": "https://management.azure.com/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/providers/Microsoft.AppLink/appLinks?api-version=2025-08-01-preview&$skiptoken=eyJjb250aW51YXRpb24iOiAiYXBwbGluay1zdGFnaW5nLTAyIn0%3D" + } + } + } +} diff --git a/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinks_Update.json b/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinks_Update.json new file mode 100644 index 000000000000..8b85151eb8cb --- /dev/null +++ b/specification/applink/AppLink.Management/examples/2025-08-01-preview/AppLinks_Update.json @@ -0,0 +1,63 @@ +{ + "title": "AppLinks_Update", + "operationId": "AppLinks_Update", + "parameters": { + "api-version": "2025-08-01-preview", + "subscriptionId": "11809CA1-E126-4017-945E-AA795CD5C5A9", + "resourceGroupName": "test_rg", + "appLinkName": "applink-test-01", + "properties": { + "tags": { + "environment": "production", + "cost-center": "platform" + }, + "properties": {}, + "identity": { + "type": "UserAssigned", + "userAssignedIdentities": { + "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/applink-identity": {} + } + } + } + }, + "responses": { + "200": { + "body": { + "properties": { + "provisioningState": "Succeeded" + }, + "identity": { + "type": "UserAssigned", + "userAssignedIdentities": { + "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/applink-identity": { + "principalId": "44444444-5555-6666-7777-888888888888", + "clientId": "99999999-aaaa-bbbb-cccc-dddddddddddd" + } + } + }, + "tags": { + "environment": "production", + "cost-center": "platform" + }, + "location": "westus2", + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-01", + "name": "applink-test-01", + "type": "Microsoft.AppLink/appLinks", + "systemData": { + "createdBy": "user01", + "createdByType": "User", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "user02", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + } + }, + "202": { + "headers": { + "Location": "https://management.azure.com/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/providers/Microsoft.AppLink/locations/westus2/operationStatuses/12345678-1234-1234-1234-123456789abc", + "Retry-After": "30" + } + } + } +} diff --git a/specification/applink/AppLink.Management/examples/2025-08-01-preview/AvailableVersions_ListByLocation.json b/specification/applink/AppLink.Management/examples/2025-08-01-preview/AvailableVersions_ListByLocation.json new file mode 100644 index 000000000000..a0bbad13c2a0 --- /dev/null +++ b/specification/applink/AppLink.Management/examples/2025-08-01-preview/AvailableVersions_ListByLocation.json @@ -0,0 +1,110 @@ +{ + "title": "AvailableVersions_ListByLocation", + "operationId": "AvailableVersions_ListByLocation", + "parameters": { + "api-version": "2025-08-01-preview", + "subscriptionId": "11809CA1-E126-4017-945E-AA795CD5C5A9", + "location": "westus2" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "properties": { + "kubernetesVersion": "1.31", + "fullyManagedVersions": { + "releaseChannels": [ + { + "releaseChannel": "stable", + "version": "1.18.2" + }, + { + "releaseChannel": "rapid", + "version": "1.19.1" + } + ] + }, + "selfManagedVersions": { + "versions": [ + { + "version": "1.17.8", + "upgrades": [ + "1.18.2", + "1.18.5" + ] + }, + { + "version": "1.18.2", + "upgrades": [ + "1.18.5", + "1.19.1" + ] + } + ] + }, + "provisioningState": "Succeeded" + }, + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/providers/Microsoft.AppLink/locations/westus2/availableVersions/kubernetes-1.31", + "name": "kubernetes-1.31", + "type": "Microsoft.AppLink/locations/availableVersions", + "systemData": { + "createdBy": "system", + "createdByType": "Application", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "system", + "lastModifiedByType": "Application", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + }, + { + "properties": { + "kubernetesVersion": "1.30", + "fullyManagedVersions": { + "releaseChannels": [ + { + "releaseChannel": "stable", + "version": "1.17.5" + }, + { + "releaseChannel": "rapid", + "version": "1.18.2" + } + ] + }, + "selfManagedVersions": { + "versions": [ + { + "version": "1.16.8", + "upgrades": [ + "1.17.5", + "1.18.2" + ] + }, + { + "version": "1.17.5", + "upgrades": [ + "1.18.2" + ] + } + ] + }, + "provisioningState": "Succeeded" + }, + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/providers/Microsoft.AppLink/locations/westus2/availableVersions/kubernetes-1.30", + "name": "kubernetes-1.30", + "type": "Microsoft.AppLink/locations/availableVersions", + "systemData": { + "createdBy": "system", + "createdByType": "Application", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "system", + "lastModifiedByType": "Application", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + } + ] + } + } + } +} diff --git a/specification/applink/AppLink.Management/examples/2025-08-01-preview/AvailableVersions_ListByLocationWithFilter.json b/specification/applink/AppLink.Management/examples/2025-08-01-preview/AvailableVersions_ListByLocationWithFilter.json new file mode 100644 index 000000000000..8c7a57b33e70 --- /dev/null +++ b/specification/applink/AppLink.Management/examples/2025-08-01-preview/AvailableVersions_ListByLocationWithFilter.json @@ -0,0 +1,58 @@ +{ + "title": "AvailableVersions_ListByLocationWithFilter", + "operationId": "AvailableVersions_ListByLocation", + "parameters": { + "api-version": "2025-08-01-preview", + "subscriptionId": "11809CA1-E126-4017-945E-AA795CD5C5A9", + "location": "westus2", + "kubernetesVersion": "1.28" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "properties": { + "kubernetesVersion": "1.28", + "fullyManagedVersions": { + "releaseChannels": [ + { + "releaseChannel": "stable", + "version": "1.18.2" + }, + { + "releaseChannel": "rapid", + "version": "1.19.1" + } + ] + }, + "selfManagedVersions": { + "versions": [ + { + "version": "1.18.2", + "upgrades": [ + "1.18.5", + "1.19.1" + ] + } + ] + }, + "provisioningState": "Succeeded" + }, + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/providers/Microsoft.AppLink/locations/westus2/availableVersions/kubernetes-1.28", + "name": "kubernetes-1.28", + "type": "Microsoft.AppLink/locations/availableVersions", + "systemData": { + "createdBy": "system", + "createdByType": "Application", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "system", + "lastModifiedByType": "Application", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + } + ] + } + } + } +} diff --git a/specification/applink/AppLink.Management/examples/2025-08-01-preview/Operations_List.json b/specification/applink/AppLink.Management/examples/2025-08-01-preview/Operations_List.json new file mode 100644 index 000000000000..2261c1347aa6 --- /dev/null +++ b/specification/applink/AppLink.Management/examples/2025-08-01-preview/Operations_List.json @@ -0,0 +1,136 @@ +{ + "title": "Operations_List", + "operationId": "Operations_List", + "parameters": { + "api-version": "2025-08-01-preview" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "Microsoft.AppLink/register/action", + "isDataAction": false, + "display": { + "provider": "Microsoft AppLink", + "resource": "Microsoft.AppLink", + "operation": "Register the subscription for Microsoft.AppLink", + "description": "Register the subscription for Microsoft.AppLink" + }, + "origin": "user,system" + }, + { + "name": "Microsoft.AppLink/unregister/action", + "isDataAction": false, + "display": { + "provider": "Microsoft AppLink", + "resource": "Microsoft.AppLink", + "operation": "Unregister the subscription for Microsoft.AppLink", + "description": "Unregister the subscription for Microsoft.AppLink" + }, + "origin": "user,system" + }, + { + "name": "Microsoft.AppLink/operations/read", + "isDataAction": false, + "display": { + "provider": "Microsoft AppLink", + "resource": "Operations", + "operation": "List available operations", + "description": "List the available operations for the Microsoft.AppLink resource provider" + }, + "origin": "user,system" + }, + { + "name": "Microsoft.AppLink/appLinks/read", + "isDataAction": false, + "display": { + "provider": "Microsoft AppLink", + "resource": "AppLinks", + "operation": "Get AppLink", + "description": "Get an AppLink or list AppLinks" + }, + "origin": "user,system" + }, + { + "name": "Microsoft.AppLink/appLinks/write", + "isDataAction": false, + "display": { + "provider": "Microsoft AppLink", + "resource": "AppLinks", + "operation": "Create or Update AppLink", + "description": "Create or update an AppLink" + }, + "origin": "user" + }, + { + "name": "Microsoft.AppLink/appLinks/delete", + "isDataAction": false, + "display": { + "provider": "Microsoft AppLink", + "resource": "AppLinks", + "operation": "Delete AppLink", + "description": "Delete an AppLink" + }, + "origin": "user" + }, + { + "name": "Microsoft.AppLink/appLinks/appLinkMembers/read", + "isDataAction": false, + "display": { + "provider": "Microsoft AppLink", + "resource": "AppLink Members", + "operation": "Get AppLink Member", + "description": "Get an AppLink Member or list AppLink Members" + }, + "origin": "user,system" + }, + { + "name": "Microsoft.AppLink/appLinks/appLinkMembers/write", + "isDataAction": false, + "display": { + "provider": "Microsoft AppLink", + "resource": "AppLink Members", + "operation": "Create or Update AppLink Member", + "description": "Create or update an AppLink Member" + }, + "origin": "user" + }, + { + "name": "Microsoft.AppLink/appLinks/appLinkMembers/delete", + "isDataAction": false, + "display": { + "provider": "Microsoft AppLink", + "resource": "AppLink Members", + "operation": "Delete AppLink Member", + "description": "Delete an AppLink Member" + }, + "origin": "user" + }, + { + "name": "Microsoft.AppLink/appLinks/appLinkMembers/upgradeHistories/read", + "isDataAction": false, + "display": { + "provider": "Microsoft AppLink", + "resource": "Upgrade Histories", + "operation": "List Upgrade Histories", + "description": "List upgrade histories for an AppLink Member" + }, + "origin": "user,system" + }, + { + "name": "Microsoft.AppLink/locations/availableVersions/read", + "isDataAction": false, + "display": { + "provider": "Microsoft AppLink", + "resource": "Available Versions", + "operation": "List Available Versions", + "description": "List available versions for a location" + }, + "origin": "user,system" + } + ] + } + } + } +} diff --git a/specification/applink/AppLink.Management/examples/2025-08-01-preview/UpgradeHistories_ListByAppLinkMember.json b/specification/applink/AppLink.Management/examples/2025-08-01-preview/UpgradeHistories_ListByAppLinkMember.json new file mode 100644 index 000000000000..091da9a45e17 --- /dev/null +++ b/specification/applink/AppLink.Management/examples/2025-08-01-preview/UpgradeHistories_ListByAppLinkMember.json @@ -0,0 +1,62 @@ +{ + "title": "UpgradeHistories_ListByAppLinkMember", + "operationId": "UpgradeHistories_ListByAppLinkMember", + "parameters": { + "api-version": "2025-08-01-preview", + "subscriptionId": "11809CA1-E126-4017-945E-AA795CD5C5A9", + "resourceGroupName": "test_rg", + "appLinkName": "applink-test-01", + "appLinkMemberName": "member-01" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-01/appLinkMembers/member-01/upgradeHistories/upgrade-20231201", + "name": "upgrade-20231201", + "type": "Microsoft.AppLink/appLinks/appLinkMembers/upgradeHistories", + "properties": { + "startTimestamp": "2023-12-01T10:00:00.000Z", + "endTimestamp": "2023-12-01T10:15:00.000Z", + "initiatedBy": "user@example.com", + "fromVersion": "1.18", + "toVersion": "1.19", + "provisioningState": "Succeeded" + }, + "systemData": { + "createdBy": "system", + "createdByType": "Application", + "createdAt": "2023-12-01T10:00:00.000Z", + "lastModifiedBy": "system", + "lastModifiedByType": "Application", + "lastModifiedAt": "2023-12-01T10:15:00.000Z" + } + }, + { + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-01/appLinkMembers/member-01/upgradeHistories/upgrade-20231115", + "name": "upgrade-20231115", + "type": "Microsoft.AppLink/appLinks/appLinkMembers/upgradeHistories", + "properties": { + "startTimestamp": "2023-11-15T14:30:00.000Z", + "endTimestamp": "2023-11-15T14:45:00.000Z", + "initiatedBy": "Azure Portal", + "fromVersion": "1.17", + "toVersion": "1.18", + "provisioningState": "Succeeded" + }, + "systemData": { + "createdBy": "system", + "createdByType": "Application", + "createdAt": "2023-11-15T14:30:00.000Z", + "lastModifiedBy": "system", + "lastModifiedByType": "Application", + "lastModifiedAt": "2023-11-15T14:45:00.000Z" + } + } + ], + "nextLink": "https://management.azure.com/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-01/appLinkMembers/member-01/upgradeHistories?api-version=2025-08-01-preview&$skiptoken=eyJjb250aW51YXRpb24iOiAiMjAyMzEwMDEifQ%3D%3D" + } + } + } +} diff --git a/specification/applink/AppLink.Management/main.tsp b/specification/applink/AppLink.Management/main.tsp new file mode 100644 index 000000000000..8c15986a1bb8 --- /dev/null +++ b/specification/applink/AppLink.Management/main.tsp @@ -0,0 +1,27 @@ +import "@typespec/http"; +import "@typespec/rest"; +import "@typespec/versioning"; +import "@azure-tools/typespec-azure-core"; +import "@azure-tools/typespec-azure-resource-manager"; +import "./applink.tsp"; +import "./applinkmember.tsp"; +import "./applinkmemberupgradehistory.tsp"; +import "./applinkavailableversion.tsp"; + +using Versioning; +using Azure.ResourceManager; + +/** Microsoft.AppLink Resource Provider management API. */ +@armProviderNamespace +@service(#{ title: "Microsoft.AppLink management service" }) +@versioned(Microsoft.AppLink.Versions) +namespace Microsoft.AppLink; + +/** The available API versions. */ +enum Versions { + /** 2025-08-01-preview version */ + @armCommonTypesVersion(Azure.ResourceManager.CommonTypes.Versions.v5) + v2025_08_01_preview: "2025-08-01-preview", +} + +interface Operations extends Azure.ResourceManager.Operations {} diff --git a/specification/applink/AppLink.Management/tspconfig.yaml b/specification/applink/AppLink.Management/tspconfig.yaml new file mode 100644 index 000000000000..e10a5d9fb629 --- /dev/null +++ b/specification/applink/AppLink.Management/tspconfig.yaml @@ -0,0 +1,40 @@ +emit: + - "@azure-tools/typespec-autorest" +options: + "@azure-tools/typespec-autorest": + use-read-only-status-schema: true + emitter-output-dir: "{project-root}/.." + azure-resource-provider-folder: "resource-manager" + output-file: "{azure-resource-provider-folder}/{service-name}/{version-status}/{version}/openapi.json" + "@azure-tools/typespec-python": + flavor: azure + emitter-output-dir: "{output-dir}/{service-dir}/azure-mgmt-applink" + namespace: "azure.mgmt.applink" + generate-test: true + generate-sample: true + "@azure-tools/typespec-java": + emitter-output-dir: "{output-dir}/{service-dir}/azure-resourcemanager-applink" + flavor: azure + namespace: "com.azure.resourcemanager.applink" + service-name: "applink" + "@azure-tools/typespec-ts": + emitter-output-dir: "{output-dir}/{service-dir}/arm-applink" + experimental-extensible-enums: true + flavor: azure + package-details: + name: "@azure/arm-applink" + "@azure-tools/typespec-go": + service-dir: "sdk/resourcemanager/applink" + emitter-output-dir: "{output-dir}/{service-dir}/armapplink" + module: "github.com/Azure/azure-sdk-for-go/{service-dir}/armapplink" + fix-const-stuttering: true + generate-samples: true + generate-fakes: true + head-as-boolean: true + inject-spans: true +linter: + extends: + - "@azure-tools/typespec-azure-rulesets/resource-manager" +parameters: + service-dir: + default: sdk/applink diff --git a/specification/applink/cspell.yaml b/specification/applink/cspell.yaml new file mode 100644 index 000000000000..8a544c961024 --- /dev/null +++ b/specification/applink/cspell.yaml @@ -0,0 +1,10 @@ +# This file configures spell checking. Items in "words" were initially populated +# with words that might be spelling errors. Review these words and take +# appropriate action. For more information, see: https://aka.ms/ci-fix#spell-check + +# Spell checking is not case sensitive +# Keep word lists in alphabetical order so the file is easier to manage +import: + - ../../cspell.yaml +words: + - Istio diff --git a/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinkMembers_CreateOrUpdate.json b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinkMembers_CreateOrUpdate.json new file mode 100644 index 000000000000..42b20699a9cb --- /dev/null +++ b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinkMembers_CreateOrUpdate.json @@ -0,0 +1,133 @@ +{ + "title": "AppLinkMembers_CreateOrUpdate", + "operationId": "AppLinkMembers_CreateOrUpdate", + "parameters": { + "api-version": "2025-08-01-preview", + "subscriptionId": "11809CA1-E126-4017-945E-AA795CD5C5A9", + "resourceGroupName": "test_rg", + "appLinkName": "applink-test-01", + "appLinkMemberName": "member-01", + "resource": { + "properties": { + "clusterType": "AKS", + "metadata": { + "resourceId": "/subscriptions/bc7e0da9-5e4c-4a91-9252-9658837006cf/resourcegroups/applink-rg/providers/Microsoft.ContainerService/managedClusters/applink-member1" + }, + "upgradeProfile": { + "mode": "FullyManaged", + "fullyManagedUpgradeProfile": { + "releaseChannel": "Stable" + } + }, + "connectivityProfile": { + "privateConnect": { + "subnetResourceId": "/subscriptions/bc7e0da9-5e4c-4a91-9252-9658837006cf/resourceGroups/applink-vnet-rg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1" + }, + "eastWestGateway": { + "visibility": "Internal" + } + } + }, + "tags": { + "key2913": "test_tag" + }, + "location": "westus2" + } + }, + "responses": { + "200": { + "body": { + "properties": { + "clusterType": "AKS", + "metadata": { + "resourceId": "/subscriptions/bc7e0da9-5e4c-4a91-9252-9658837006cf/resourcegroups/applink-rg/providers/Microsoft.ContainerService/managedClusters/applink-member1" + }, + "upgradeProfile": { + "mode": "FullyManaged", + "fullyManagedUpgradeProfile": { + "releaseChannel": "Stable" + } + }, + "observabilityProfile": { + "metrics": { + "metricsEndpoint": "https://mcp-fqdn" + } + }, + "connectivityProfile": { + "privateConnect": { + "subnetResourceId": "/subscriptions/bc7e0da9-5e4c-4a91-9252-9658837006cf/resourceGroups/applink-vnet-rg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1" + }, + "eastWestGateway": { + "visibility": "Internal" + } + }, + "provisioningState": "Succeeded" + }, + "tags": { + "key2913": "test_tag" + }, + "location": "westus2", + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-01/appLinkMembers/member-01", + "name": "member-01", + "type": "Microsoft.AppLink/appLinks/appLinkMembers", + "systemData": { + "createdBy": "user01", + "createdByType": "User", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "user02", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + } + }, + "201": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/providers/Microsoft.AppLink/locations/westus2/operationStatuses/12345678-1234-1234-1234-123456789abc", + "Retry-After": "10" + }, + "body": { + "properties": { + "clusterType": "AKS", + "metadata": { + "resourceId": "/subscriptions/bc7e0da9-5e4c-4a91-9252-9658837006cf/resourcegroups/applink-rg/providers/Microsoft.ContainerService/managedClusters/applink-member1" + }, + "upgradeProfile": { + "mode": "FullyManaged", + "fullyManagedUpgradeProfile": { + "releaseChannel": "Stable" + } + }, + "observabilityProfile": { + "metrics": { + "metricsEndpoint": "https://mcp-fqdn" + } + }, + "connectivityProfile": { + "privateConnect": { + "subnetResourceId": "/subscriptions/bc7e0da9-5e4c-4a91-9252-9658837006cf/resourceGroups/applink-vnet-rg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1" + }, + "eastWestGateway": { + "visibility": "Internal" + } + }, + "provisioningState": "Provisioning" + }, + "tags": { + "key2913": "test_tag" + }, + "location": "westus2", + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-01/appLinkMembers/member-01", + "name": "member-01", + "type": "Microsoft.AppLink/appLinks/appLinkMembers", + "systemData": { + "createdBy": "user01", + "createdByType": "User", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "user02", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + } + } + } +} diff --git a/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinkMembers_Delete.json b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinkMembers_Delete.json new file mode 100644 index 000000000000..4d2265f14823 --- /dev/null +++ b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinkMembers_Delete.json @@ -0,0 +1,20 @@ +{ + "title": "AppLinkMembers_Delete", + "operationId": "AppLinkMembers_Delete", + "parameters": { + "api-version": "2025-08-01-preview", + "subscriptionId": "11809CA1-E126-4017-945E-AA795CD5C5A9", + "resourceGroupName": "test_rg", + "appLinkName": "applink-test-01", + "appLinkMemberName": "member-01" + }, + "responses": { + "202": { + "headers": { + "Location": "https://management.azure.com/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/providers/Microsoft.AppLink/locations/westus2/operationStatuses/12345678-1234-1234-1234-123456789abc", + "Retry-After": "30" + } + }, + "204": {} + } +} diff --git a/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinkMembers_Get.json b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinkMembers_Get.json new file mode 100644 index 000000000000..df2def397460 --- /dev/null +++ b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinkMembers_Get.json @@ -0,0 +1,58 @@ +{ + "title": "AppLinkMembers_Get", + "operationId": "AppLinkMembers_Get", + "parameters": { + "api-version": "2025-08-01-preview", + "subscriptionId": "11809CA1-E126-4017-945E-AA795CD5C5A9", + "resourceGroupName": "test_rg", + "appLinkName": "applink-test-01", + "appLinkMemberName": "member-01" + }, + "responses": { + "200": { + "body": { + "properties": { + "clusterType": "AKS", + "metadata": { + "resourceId": "/subscriptions/bc7e0da9-5e4c-4a91-9252-9658837006cf/resourcegroups/applink-rg/providers/Microsoft.ContainerService/managedClusters/applink-member1" + }, + "upgradeProfile": { + "mode": "FullyManaged", + "fullyManagedUpgradeProfile": { + "releaseChannel": "Stable" + } + }, + "observabilityProfile": { + "metrics": { + "metricsEndpoint": "https://mcp-fqdn" + } + }, + "connectivityProfile": { + "privateConnect": { + "subnetResourceId": "/subscriptions/bc7e0da9-5e4c-4a91-9252-9658837006cf/resourceGroups/applink-vnet-rg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1" + }, + "eastWestGateway": { + "visibility": "Internal" + } + }, + "provisioningState": "Succeeded" + }, + "tags": { + "key2913": "test_tag" + }, + "location": "westus2", + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-01/appLinkMembers/member-01", + "name": "member-01", + "type": "Microsoft.AppLink/appLinks/appLinkMembers", + "systemData": { + "createdBy": "user01", + "createdByType": "User", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "user02", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + } + } + } +} diff --git a/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinkMembers_ListByAppLink.json b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinkMembers_ListByAppLink.json new file mode 100644 index 000000000000..ea139ff8b50b --- /dev/null +++ b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinkMembers_ListByAppLink.json @@ -0,0 +1,102 @@ +{ + "title": "AppLinkMembers_ListByAppLink", + "operationId": "AppLinkMembers_ListByAppLink", + "parameters": { + "api-version": "2025-08-01-preview", + "subscriptionId": "11809CA1-E126-4017-945E-AA795CD5C5A9", + "resourceGroupName": "test_rg", + "appLinkName": "applink-test-01" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "properties": { + "clusterType": "AKS", + "metadata": { + "resourceId": "/subscriptions/bc7e0da9-5e4c-4a91-9252-9658837006cf/resourcegroups/applink-rg/providers/Microsoft.ContainerService/managedClusters/applink-member1" + }, + "upgradeProfile": { + "mode": "FullyManaged", + "fullyManagedUpgradeProfile": { + "releaseChannel": "Stable" + } + }, + "observabilityProfile": { + "metrics": { + "metricsEndpoint": "https://mcp-fqdn" + } + }, + "connectivityProfile": { + "privateConnect": { + "subnetResourceId": "/subscriptions/bc7e0da9-5e4c-4a91-9252-9658837006cf/resourceGroups/applink-vnet-rg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1" + }, + "eastWestGateway": { + "visibility": "Internal" + } + }, + "provisioningState": "Succeeded" + }, + "tags": { + "key2913": "test_tag" + }, + "location": "westus2", + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-01/appLinkMembers/member-01", + "name": "member-01", + "type": "Microsoft.AppLink/appLinks/appLinkMembers", + "systemData": { + "createdBy": "user01", + "createdByType": "User", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "user02", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + }, + { + "properties": { + "clusterType": "AKS", + "metadata": { + "resourceId": "/subscriptions/bc7e0da9-5e4c-4a91-9252-9658837006cf/resourcegroups/applink-rg/providers/Microsoft.ContainerService/managedClusters/applink-member2" + }, + "upgradeProfile": { + "mode": "SelfManaged", + "selfManagedUpgradeProfile": { + "version": "1.27" + } + }, + "observabilityProfile": { + "metrics": { + "metricsEndpoint": "https://mcp-fqdn" + } + }, + "connectivityProfile": { + "eastWestGateway": { + "visibility": "External" + } + }, + "provisioningState": "Succeeded" + }, + "tags": { + "env": "production" + }, + "location": "westus2", + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-01/appLinkMembers/member-02", + "name": "member-02", + "type": "Microsoft.AppLink/appLinks/appLinkMembers", + "systemData": { + "createdBy": "user01", + "createdByType": "User", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "user02", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + } + ], + "nextLink": "https://management.azure.com/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-01/appLinkMembers?api-version=2025-08-01-preview&$skiptoken=eyJjb250aW51YXRpb24iOiAibWVtYmVyLTAzIn0%3D" + } + } + } +} diff --git a/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinkMembers_Update.json b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinkMembers_Update.json new file mode 100644 index 000000000000..2127ec7d0101 --- /dev/null +++ b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinkMembers_Update.json @@ -0,0 +1,83 @@ +{ + "title": "AppLinkMembers_Update", + "operationId": "AppLinkMembers_Update", + "parameters": { + "api-version": "2025-08-01-preview", + "subscriptionId": "11809CA1-E126-4017-945E-AA795CD5C5A9", + "resourceGroupName": "test_rg", + "appLinkName": "applink-test-01", + "appLinkMemberName": "member-01", + "properties": { + "tags": { + "key7952": "updated_tag_value" + }, + "properties": { + "upgradeProfile": { + "mode": "SelfManaged", + "selfManagedUpgradeProfile": { + "version": "1.26" + } + }, + "connectivityProfile": { + "eastWestGateway": { + "visibility": "Internal" + } + } + } + } + }, + "responses": { + "200": { + "body": { + "properties": { + "clusterType": "AKS", + "metadata": { + "resourceId": "/subscriptions/bc7e0da9-5e4c-4a91-9252-9658837006cf/resourcegroups/applink-rg/providers/Microsoft.ContainerService/managedClusters/applink-member1" + }, + "upgradeProfile": { + "mode": "SelfManaged", + "selfManagedUpgradeProfile": { + "version": "1.26" + } + }, + "observabilityProfile": { + "metrics": { + "metricsEndpoint": "https://mcp-fqdn" + } + }, + "connectivityProfile": { + "privateConnect": { + "subnetResourceId": "/subscriptions/bc7e0da9-5e4c-4a91-9252-9658837006cf/resourceGroups/applink-vnet-rg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1" + }, + "eastWestGateway": { + "visibility": "Internal" + } + }, + "provisioningState": "Succeeded" + }, + "tags": { + "key7952": "updated_tag_value" + }, + "location": "westus2", + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-01/appLinkMembers/member-01", + "name": "member-01", + "type": "Microsoft.AppLink/appLinks/appLinkMembers", + "systemData": { + "createdBy": "user01", + "createdByType": "User", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "user02", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/providers/Microsoft.AppLink/locations/westus2/operationStatuses/12345678-1234-1234-1234-123456789abc", + "Location": "https://management.azure.com/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/providers/Microsoft.AppLink/locations/westus2/operationStatuses/12345678-1234-1234-1234-123456789abc", + "Retry-After": "30" + } + } + } +} diff --git a/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinks_CreateOrUpdate.json b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinks_CreateOrUpdate.json new file mode 100644 index 000000000000..e0b8a5ebdc20 --- /dev/null +++ b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinks_CreateOrUpdate.json @@ -0,0 +1,80 @@ +{ + "title": "AppLinks_CreateOrUpdate", + "operationId": "AppLinks_CreateOrUpdate", + "parameters": { + "api-version": "2025-08-01-preview", + "subscriptionId": "11809CA1-E126-4017-945E-AA795CD5C5A9", + "resourceGroupName": "test_rg", + "appLinkName": "applink-test-01", + "resource": { + "properties": {}, + "identity": { + "type": "SystemAssigned" + }, + "tags": { + "key2913": "test_tag" + }, + "location": "westus2" + } + }, + "responses": { + "200": { + "body": { + "properties": { + "provisioningState": "Succeeded" + }, + "identity": { + "type": "SystemAssigned", + "principalId": "00000000-1111-2222-3333-444444444444", + "tenantId": "00000000-1111-2222-3333-444444444444" + }, + "tags": { + "key2913": "test_tag" + }, + "location": "westus2", + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-01", + "name": "applink-test-01", + "type": "Microsoft.AppLink/appLinks", + "systemData": { + "createdBy": "user01", + "createdByType": "User", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "user02", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + } + }, + "201": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/providers/Microsoft.AppLink/locations/westus2/operationStatuses/12345678-1234-1234-1234-123456789abc", + "Retry-After": "10" + }, + "body": { + "properties": { + "provisioningState": "Provisioning" + }, + "identity": { + "type": "SystemAssigned", + "principalId": "00000000-1111-2222-3333-444444444444", + "tenantId": "00000000-1111-2222-3333-444444444444" + }, + "tags": { + "key2913": "test_tag" + }, + "location": "westus2", + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-01", + "name": "applink-test-01", + "type": "Microsoft.AppLink/appLinks", + "systemData": { + "createdBy": "user01", + "createdByType": "User", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "user02", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + } + } + } +} diff --git a/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinks_Delete.json b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinks_Delete.json new file mode 100644 index 000000000000..459b0e062d36 --- /dev/null +++ b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinks_Delete.json @@ -0,0 +1,19 @@ +{ + "title": "AppLinks_Delete", + "operationId": "AppLinks_Delete", + "parameters": { + "api-version": "2025-08-01-preview", + "subscriptionId": "11809CA1-E126-4017-945E-AA795CD5C5A9", + "resourceGroupName": "test_rg", + "appLinkName": "applink-test-01" + }, + "responses": { + "202": { + "headers": { + "Location": "https://management.azure.com/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/providers/Microsoft.AppLink/locations/westus2/operationStatuses/12345678-1234-1234-1234-123456789abc", + "Retry-After": "30" + } + }, + "204": {} + } +} diff --git a/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinks_Get.json b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinks_Get.json new file mode 100644 index 000000000000..102b6b91e84a --- /dev/null +++ b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinks_Get.json @@ -0,0 +1,39 @@ +{ + "title": "AppLinks_Get", + "operationId": "AppLinks_Get", + "parameters": { + "api-version": "2025-08-01-preview", + "subscriptionId": "11809CA1-E126-4017-945E-AA795CD5C5A9", + "resourceGroupName": "test_rg", + "appLinkName": "applink-test-01" + }, + "responses": { + "200": { + "body": { + "properties": { + "provisioningState": "Succeeded" + }, + "identity": { + "type": "SystemAssigned", + "principalId": "00000000-1111-2222-3333-444444444444", + "tenantId": "00000000-1111-2222-3333-444444444444" + }, + "tags": { + "key2913": "test_tag" + }, + "location": "westus2", + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-01", + "name": "applink-test-01", + "type": "Microsoft.AppLink/appLinks", + "systemData": { + "createdBy": "user01", + "createdByType": "User", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "user02", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + } + } + } +} diff --git a/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinks_ListByResourceGroup.json b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinks_ListByResourceGroup.json new file mode 100644 index 000000000000..5780d50046a7 --- /dev/null +++ b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinks_ListByResourceGroup.json @@ -0,0 +1,72 @@ +{ + "title": "AppLinks_ListByResourceGroup", + "operationId": "AppLinks_ListByResourceGroup", + "parameters": { + "api-version": "2025-08-01-preview", + "subscriptionId": "11809CA1-E126-4017-945E-AA795CD5C5A9", + "resourceGroupName": "test_rg" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "properties": { + "provisioningState": "Succeeded" + }, + "identity": { + "type": "SystemAssigned", + "principalId": "00000000-1111-2222-3333-444444444444", + "tenantId": "00000000-1111-2222-3333-444444444444" + }, + "tags": { + "key2913": "test_tag" + }, + "location": "westus2", + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-01", + "name": "applink-test-01", + "type": "Microsoft.AppLink/appLinks", + "systemData": { + "createdBy": "user01", + "createdByType": "User", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "user02", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + }, + { + "properties": { + "provisioningState": "Succeeded" + }, + "identity": { + "type": "UserAssigned", + "userAssignedIdentities": { + "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/test-identity": { + "principalId": "11111111-2222-3333-4444-555555555555", + "clientId": "66666666-7777-8888-9999-aaaaaaaaaaaa" + } + } + }, + "tags": { + "environment": "production" + }, + "location": "westus2", + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-02", + "name": "applink-test-02", + "type": "Microsoft.AppLink/appLinks", + "systemData": { + "createdBy": "user01", + "createdByType": "User", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "user02", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + } + ], + "nextLink": "https://management.azure.com/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks?api-version=2025-08-01-preview&$skiptoken=eyJjb250aW51YXRpb24iOiAiYXBwbGluay10ZXN0LTAzIn0%3D" + } + } + } +} diff --git a/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinks_ListBySubscription.json b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinks_ListBySubscription.json new file mode 100644 index 000000000000..69b551935a0e --- /dev/null +++ b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinks_ListBySubscription.json @@ -0,0 +1,98 @@ +{ + "title": "AppLinks_ListBySubscription", + "operationId": "AppLinks_ListBySubscription", + "parameters": { + "api-version": "2025-08-01-preview", + "subscriptionId": "11809CA1-E126-4017-945E-AA795CD5C5A9" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "properties": { + "provisioningState": "Succeeded" + }, + "identity": { + "type": "SystemAssigned", + "principalId": "00000000-1111-2222-3333-444444444444", + "tenantId": "00000000-1111-2222-3333-444444444444" + }, + "tags": { + "environment": "production", + "team": "platform" + }, + "location": "westus2", + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/rg1/providers/Microsoft.AppLink/appLinks/applink-prod-01", + "name": "applink-prod-01", + "type": "Microsoft.AppLink/appLinks", + "systemData": { + "createdBy": "user01", + "createdByType": "User", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "user02", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + }, + { + "properties": { + "provisioningState": "Succeeded" + }, + "identity": { + "type": "UserAssigned", + "userAssignedIdentities": { + "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/rg2/providers/Microsoft.ManagedIdentity/userAssignedIdentities/applink-identity": { + "principalId": "22222222-3333-4444-5555-666666666666", + "clientId": "77777777-8888-9999-aaaa-bbbbbbbbbbbb" + } + } + }, + "tags": { + "environment": "development", + "cost-center": "engineering" + }, + "location": "eastus", + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/rg2/providers/Microsoft.AppLink/appLinks/applink-dev-01", + "name": "applink-dev-01", + "type": "Microsoft.AppLink/appLinks", + "systemData": { + "createdBy": "dev-user", + "createdByType": "User", + "createdAt": "2023-06-10T14:22:30.000Z", + "lastModifiedBy": "dev-user", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-06-15T09:15:45.000Z" + } + }, + { + "properties": { + "provisioningState": "Provisioning" + }, + "identity": { + "type": "SystemAssigned", + "principalId": "33333333-4444-5555-6666-777777777777", + "tenantId": "00000000-1111-2222-3333-444444444444" + }, + "tags": { + "environment": "staging" + }, + "location": "northeurope", + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/rg3/providers/Microsoft.AppLink/appLinks/applink-staging-01", + "name": "applink-staging-01", + "type": "Microsoft.AppLink/appLinks", + "systemData": { + "createdBy": "staging-user", + "createdByType": "User", + "createdAt": "2023-07-01T08:30:00.000Z", + "lastModifiedBy": "staging-user", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-07-01T08:30:00.000Z" + } + } + ], + "nextLink": "https://management.azure.com/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/providers/Microsoft.AppLink/appLinks?api-version=2025-08-01-preview&$skiptoken=eyJjb250aW51YXRpb24iOiAiYXBwbGluay1zdGFnaW5nLTAyIn0%3D" + } + } + } +} diff --git a/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinks_Update.json b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinks_Update.json new file mode 100644 index 000000000000..8b85151eb8cb --- /dev/null +++ b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AppLinks_Update.json @@ -0,0 +1,63 @@ +{ + "title": "AppLinks_Update", + "operationId": "AppLinks_Update", + "parameters": { + "api-version": "2025-08-01-preview", + "subscriptionId": "11809CA1-E126-4017-945E-AA795CD5C5A9", + "resourceGroupName": "test_rg", + "appLinkName": "applink-test-01", + "properties": { + "tags": { + "environment": "production", + "cost-center": "platform" + }, + "properties": {}, + "identity": { + "type": "UserAssigned", + "userAssignedIdentities": { + "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/applink-identity": {} + } + } + } + }, + "responses": { + "200": { + "body": { + "properties": { + "provisioningState": "Succeeded" + }, + "identity": { + "type": "UserAssigned", + "userAssignedIdentities": { + "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/applink-identity": { + "principalId": "44444444-5555-6666-7777-888888888888", + "clientId": "99999999-aaaa-bbbb-cccc-dddddddddddd" + } + } + }, + "tags": { + "environment": "production", + "cost-center": "platform" + }, + "location": "westus2", + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-01", + "name": "applink-test-01", + "type": "Microsoft.AppLink/appLinks", + "systemData": { + "createdBy": "user01", + "createdByType": "User", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "user02", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + } + }, + "202": { + "headers": { + "Location": "https://management.azure.com/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/providers/Microsoft.AppLink/locations/westus2/operationStatuses/12345678-1234-1234-1234-123456789abc", + "Retry-After": "30" + } + } + } +} diff --git a/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AvailableVersions_ListByLocation.json b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AvailableVersions_ListByLocation.json new file mode 100644 index 000000000000..a0bbad13c2a0 --- /dev/null +++ b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AvailableVersions_ListByLocation.json @@ -0,0 +1,110 @@ +{ + "title": "AvailableVersions_ListByLocation", + "operationId": "AvailableVersions_ListByLocation", + "parameters": { + "api-version": "2025-08-01-preview", + "subscriptionId": "11809CA1-E126-4017-945E-AA795CD5C5A9", + "location": "westus2" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "properties": { + "kubernetesVersion": "1.31", + "fullyManagedVersions": { + "releaseChannels": [ + { + "releaseChannel": "stable", + "version": "1.18.2" + }, + { + "releaseChannel": "rapid", + "version": "1.19.1" + } + ] + }, + "selfManagedVersions": { + "versions": [ + { + "version": "1.17.8", + "upgrades": [ + "1.18.2", + "1.18.5" + ] + }, + { + "version": "1.18.2", + "upgrades": [ + "1.18.5", + "1.19.1" + ] + } + ] + }, + "provisioningState": "Succeeded" + }, + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/providers/Microsoft.AppLink/locations/westus2/availableVersions/kubernetes-1.31", + "name": "kubernetes-1.31", + "type": "Microsoft.AppLink/locations/availableVersions", + "systemData": { + "createdBy": "system", + "createdByType": "Application", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "system", + "lastModifiedByType": "Application", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + }, + { + "properties": { + "kubernetesVersion": "1.30", + "fullyManagedVersions": { + "releaseChannels": [ + { + "releaseChannel": "stable", + "version": "1.17.5" + }, + { + "releaseChannel": "rapid", + "version": "1.18.2" + } + ] + }, + "selfManagedVersions": { + "versions": [ + { + "version": "1.16.8", + "upgrades": [ + "1.17.5", + "1.18.2" + ] + }, + { + "version": "1.17.5", + "upgrades": [ + "1.18.2" + ] + } + ] + }, + "provisioningState": "Succeeded" + }, + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/providers/Microsoft.AppLink/locations/westus2/availableVersions/kubernetes-1.30", + "name": "kubernetes-1.30", + "type": "Microsoft.AppLink/locations/availableVersions", + "systemData": { + "createdBy": "system", + "createdByType": "Application", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "system", + "lastModifiedByType": "Application", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + } + ] + } + } + } +} diff --git a/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AvailableVersions_ListByLocationWithFilter.json b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AvailableVersions_ListByLocationWithFilter.json new file mode 100644 index 000000000000..8c7a57b33e70 --- /dev/null +++ b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/AvailableVersions_ListByLocationWithFilter.json @@ -0,0 +1,58 @@ +{ + "title": "AvailableVersions_ListByLocationWithFilter", + "operationId": "AvailableVersions_ListByLocation", + "parameters": { + "api-version": "2025-08-01-preview", + "subscriptionId": "11809CA1-E126-4017-945E-AA795CD5C5A9", + "location": "westus2", + "kubernetesVersion": "1.28" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "properties": { + "kubernetesVersion": "1.28", + "fullyManagedVersions": { + "releaseChannels": [ + { + "releaseChannel": "stable", + "version": "1.18.2" + }, + { + "releaseChannel": "rapid", + "version": "1.19.1" + } + ] + }, + "selfManagedVersions": { + "versions": [ + { + "version": "1.18.2", + "upgrades": [ + "1.18.5", + "1.19.1" + ] + } + ] + }, + "provisioningState": "Succeeded" + }, + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/providers/Microsoft.AppLink/locations/westus2/availableVersions/kubernetes-1.28", + "name": "kubernetes-1.28", + "type": "Microsoft.AppLink/locations/availableVersions", + "systemData": { + "createdBy": "system", + "createdByType": "Application", + "createdAt": "2023-05-19T00:28:48.610Z", + "lastModifiedBy": "system", + "lastModifiedByType": "Application", + "lastModifiedAt": "2023-05-19T00:28:48.610Z" + } + } + ] + } + } + } +} diff --git a/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/Operations_List.json b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/Operations_List.json new file mode 100644 index 000000000000..2261c1347aa6 --- /dev/null +++ b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/Operations_List.json @@ -0,0 +1,136 @@ +{ + "title": "Operations_List", + "operationId": "Operations_List", + "parameters": { + "api-version": "2025-08-01-preview" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "Microsoft.AppLink/register/action", + "isDataAction": false, + "display": { + "provider": "Microsoft AppLink", + "resource": "Microsoft.AppLink", + "operation": "Register the subscription for Microsoft.AppLink", + "description": "Register the subscription for Microsoft.AppLink" + }, + "origin": "user,system" + }, + { + "name": "Microsoft.AppLink/unregister/action", + "isDataAction": false, + "display": { + "provider": "Microsoft AppLink", + "resource": "Microsoft.AppLink", + "operation": "Unregister the subscription for Microsoft.AppLink", + "description": "Unregister the subscription for Microsoft.AppLink" + }, + "origin": "user,system" + }, + { + "name": "Microsoft.AppLink/operations/read", + "isDataAction": false, + "display": { + "provider": "Microsoft AppLink", + "resource": "Operations", + "operation": "List available operations", + "description": "List the available operations for the Microsoft.AppLink resource provider" + }, + "origin": "user,system" + }, + { + "name": "Microsoft.AppLink/appLinks/read", + "isDataAction": false, + "display": { + "provider": "Microsoft AppLink", + "resource": "AppLinks", + "operation": "Get AppLink", + "description": "Get an AppLink or list AppLinks" + }, + "origin": "user,system" + }, + { + "name": "Microsoft.AppLink/appLinks/write", + "isDataAction": false, + "display": { + "provider": "Microsoft AppLink", + "resource": "AppLinks", + "operation": "Create or Update AppLink", + "description": "Create or update an AppLink" + }, + "origin": "user" + }, + { + "name": "Microsoft.AppLink/appLinks/delete", + "isDataAction": false, + "display": { + "provider": "Microsoft AppLink", + "resource": "AppLinks", + "operation": "Delete AppLink", + "description": "Delete an AppLink" + }, + "origin": "user" + }, + { + "name": "Microsoft.AppLink/appLinks/appLinkMembers/read", + "isDataAction": false, + "display": { + "provider": "Microsoft AppLink", + "resource": "AppLink Members", + "operation": "Get AppLink Member", + "description": "Get an AppLink Member or list AppLink Members" + }, + "origin": "user,system" + }, + { + "name": "Microsoft.AppLink/appLinks/appLinkMembers/write", + "isDataAction": false, + "display": { + "provider": "Microsoft AppLink", + "resource": "AppLink Members", + "operation": "Create or Update AppLink Member", + "description": "Create or update an AppLink Member" + }, + "origin": "user" + }, + { + "name": "Microsoft.AppLink/appLinks/appLinkMembers/delete", + "isDataAction": false, + "display": { + "provider": "Microsoft AppLink", + "resource": "AppLink Members", + "operation": "Delete AppLink Member", + "description": "Delete an AppLink Member" + }, + "origin": "user" + }, + { + "name": "Microsoft.AppLink/appLinks/appLinkMembers/upgradeHistories/read", + "isDataAction": false, + "display": { + "provider": "Microsoft AppLink", + "resource": "Upgrade Histories", + "operation": "List Upgrade Histories", + "description": "List upgrade histories for an AppLink Member" + }, + "origin": "user,system" + }, + { + "name": "Microsoft.AppLink/locations/availableVersions/read", + "isDataAction": false, + "display": { + "provider": "Microsoft AppLink", + "resource": "Available Versions", + "operation": "List Available Versions", + "description": "List available versions for a location" + }, + "origin": "user,system" + } + ] + } + } + } +} diff --git a/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/UpgradeHistories_ListByAppLinkMember.json b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/UpgradeHistories_ListByAppLinkMember.json new file mode 100644 index 000000000000..091da9a45e17 --- /dev/null +++ b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/examples/UpgradeHistories_ListByAppLinkMember.json @@ -0,0 +1,62 @@ +{ + "title": "UpgradeHistories_ListByAppLinkMember", + "operationId": "UpgradeHistories_ListByAppLinkMember", + "parameters": { + "api-version": "2025-08-01-preview", + "subscriptionId": "11809CA1-E126-4017-945E-AA795CD5C5A9", + "resourceGroupName": "test_rg", + "appLinkName": "applink-test-01", + "appLinkMemberName": "member-01" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-01/appLinkMembers/member-01/upgradeHistories/upgrade-20231201", + "name": "upgrade-20231201", + "type": "Microsoft.AppLink/appLinks/appLinkMembers/upgradeHistories", + "properties": { + "startTimestamp": "2023-12-01T10:00:00.000Z", + "endTimestamp": "2023-12-01T10:15:00.000Z", + "initiatedBy": "user@example.com", + "fromVersion": "1.18", + "toVersion": "1.19", + "provisioningState": "Succeeded" + }, + "systemData": { + "createdBy": "system", + "createdByType": "Application", + "createdAt": "2023-12-01T10:00:00.000Z", + "lastModifiedBy": "system", + "lastModifiedByType": "Application", + "lastModifiedAt": "2023-12-01T10:15:00.000Z" + } + }, + { + "id": "/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-01/appLinkMembers/member-01/upgradeHistories/upgrade-20231115", + "name": "upgrade-20231115", + "type": "Microsoft.AppLink/appLinks/appLinkMembers/upgradeHistories", + "properties": { + "startTimestamp": "2023-11-15T14:30:00.000Z", + "endTimestamp": "2023-11-15T14:45:00.000Z", + "initiatedBy": "Azure Portal", + "fromVersion": "1.17", + "toVersion": "1.18", + "provisioningState": "Succeeded" + }, + "systemData": { + "createdBy": "system", + "createdByType": "Application", + "createdAt": "2023-11-15T14:30:00.000Z", + "lastModifiedBy": "system", + "lastModifiedByType": "Application", + "lastModifiedAt": "2023-11-15T14:45:00.000Z" + } + } + ], + "nextLink": "https://management.azure.com/subscriptions/11809CA1-E126-4017-945E-AA795CD5C5A9/resourceGroups/test_rg/providers/Microsoft.AppLink/appLinks/applink-test-01/appLinkMembers/member-01/upgradeHistories?api-version=2025-08-01-preview&$skiptoken=eyJjb250aW51YXRpb24iOiAiMjAyMzEwMDEifQ%3D%3D" + } + } + } +} diff --git a/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/openapi.json b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/openapi.json new file mode 100644 index 000000000000..e0300d2fec47 --- /dev/null +++ b/specification/applink/resource-manager/Microsoft.AppLink/preview/2025-08-01-preview/openapi.json @@ -0,0 +1,1670 @@ +{ + "swagger": "2.0", + "info": { + "title": "Microsoft.AppLink management service", + "version": "2025-08-01-preview", + "description": "Microsoft.AppLink Resource Provider management API.", + "x-typespec-generated": [ + { + "emitter": "@azure-tools/typespec-autorest" + } + ] + }, + "schemes": [ + "https" + ], + "host": "management.azure.com", + "produces": [ + "application/json" + ], + "consumes": [ + "application/json" + ], + "security": [ + { + "azure_auth": [ + "user_impersonation" + ] + } + ], + "securityDefinitions": { + "azure_auth": { + "type": "oauth2", + "description": "Azure Active Directory OAuth2 Flow.", + "flow": "implicit", + "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize", + "scopes": { + "user_impersonation": "impersonate your user account" + } + } + }, + "tags": [ + { + "name": "Operations" + }, + { + "name": "AppLinks" + }, + { + "name": "AppLinkMembers" + }, + { + "name": "UpgradeHistories" + }, + { + "name": "AvailableVersions" + } + ], + "paths": { + "/providers/Microsoft.AppLink/operations": { + "get": { + "operationId": "Operations_List", + "tags": [ + "Operations" + ], + "description": "List the operations for the provider", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/definitions/OperationListResult" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "Operations_List": { + "$ref": "./examples/Operations_List.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/subscriptions/{subscriptionId}/providers/Microsoft.AppLink/appLinks": { + "get": { + "operationId": "AppLinks_ListBySubscription", + "tags": [ + "AppLinks" + ], + "description": "List AppLink resources by subscription.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/AppLinkListResult" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "AppLinks_ListBySubscription": { + "$ref": "./examples/AppLinks_ListBySubscription.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/subscriptions/{subscriptionId}/providers/Microsoft.AppLink/locations/{location}/availableVersions": { + "get": { + "operationId": "AvailableVersions_ListByLocation", + "tags": [ + "AvailableVersions" + ], + "description": "List AvailableVersion resources by location.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/LocationParameter" + }, + { + "name": "kubernetesVersion", + "in": "query", + "description": "Kubernetes version to filter profiles", + "required": false, + "type": "string" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/AvailableVersionListResult" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "AvailableVersions_ListByLocation": { + "$ref": "./examples/AvailableVersions_ListByLocation.json" + }, + "AvailableVersions_ListByLocationWithFilter": { + "$ref": "./examples/AvailableVersions_ListByLocationWithFilter.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppLink/appLinks": { + "get": { + "operationId": "AppLinks_ListByResourceGroup", + "tags": [ + "AppLinks" + ], + "description": "List AppLink resources by resource group.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/AppLinkListResult" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "AppLinks_ListByResourceGroup": { + "$ref": "./examples/AppLinks_ListByResourceGroup.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppLink/appLinks/{appLinkName}": { + "get": { + "operationId": "AppLinks_Get", + "tags": [ + "AppLinks" + ], + "description": "Get an AppLink.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "appLinkName", + "in": "path", + "description": "The name of the AppLink", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9-]{3,24}$" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/AppLink" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "AppLinks_Get": { + "$ref": "./examples/AppLinks_Get.json" + } + } + }, + "put": { + "operationId": "AppLinks_CreateOrUpdate", + "tags": [ + "AppLinks" + ], + "description": "Create an AppLink.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "appLinkName", + "in": "path", + "description": "The name of the AppLink", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9-]{3,24}$" + }, + { + "name": "resource", + "in": "body", + "description": "Resource create parameters.", + "required": true, + "schema": { + "$ref": "#/definitions/AppLink" + } + } + ], + "responses": { + "200": { + "description": "Resource 'AppLink' update operation succeeded", + "schema": { + "$ref": "#/definitions/AppLink" + } + }, + "201": { + "description": "Resource 'AppLink' create operation succeeded", + "schema": { + "$ref": "#/definitions/AppLink" + }, + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "description": "A link to the status monitor" + }, + "Retry-After": { + "type": "integer", + "format": "int32", + "description": "The Retry-After header can indicate how long the client should wait before polling the operation status." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "AppLinks_CreateOrUpdate": { + "$ref": "./examples/AppLinks_CreateOrUpdate.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "azure-async-operation" + }, + "x-ms-long-running-operation": true + }, + "patch": { + "operationId": "AppLinks_Update", + "tags": [ + "AppLinks" + ], + "description": "Update an AppLink.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "appLinkName", + "in": "path", + "description": "The name of the AppLink", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9-]{3,24}$" + }, + { + "name": "properties", + "in": "body", + "description": "The resource properties to be updated.", + "required": true, + "schema": { + "$ref": "#/definitions/AppLinkUpdate" + } + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/AppLink" + } + }, + "202": { + "description": "Resource update request accepted.", + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "description": "A link to the status monitor" + }, + "Location": { + "type": "string", + "description": "The Location header contains the URL where the status of the long running operation can be checked." + }, + "Retry-After": { + "type": "integer", + "format": "int32", + "description": "The Retry-After header can indicate how long the client should wait before polling the operation status." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "AppLinks_Update": { + "$ref": "./examples/AppLinks_Update.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "azure-async-operation" + }, + "x-ms-long-running-operation": true + }, + "delete": { + "operationId": "AppLinks_Delete", + "tags": [ + "AppLinks" + ], + "description": "Delete an AppLink.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "appLinkName", + "in": "path", + "description": "The name of the AppLink", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9-]{3,24}$" + } + ], + "responses": { + "202": { + "description": "Resource deletion accepted.", + "headers": { + "Location": { + "type": "string", + "description": "The Location header contains the URL where the status of the long running operation can be checked." + }, + "Retry-After": { + "type": "integer", + "format": "int32", + "description": "The Retry-After header can indicate how long the client should wait before polling the operation status." + } + } + }, + "204": { + "description": "Resource does not exist." + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "AppLinks_Delete": { + "$ref": "./examples/AppLinks_Delete.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "location" + }, + "x-ms-long-running-operation": true + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppLink/appLinks/{appLinkName}/appLinkMembers": { + "get": { + "operationId": "AppLinkMembers_ListByAppLink", + "tags": [ + "AppLinkMembers" + ], + "description": "List AppLinkMember resources by AppLink.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "appLinkName", + "in": "path", + "description": "The name of the AppLink", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9-]{3,24}$" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/AppLinkMemberListResult" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "AppLinkMembers_ListByAppLink": { + "$ref": "./examples/AppLinkMembers_ListByAppLink.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppLink/appLinks/{appLinkName}/appLinkMembers/{appLinkMemberName}": { + "get": { + "operationId": "AppLinkMembers_Get", + "tags": [ + "AppLinkMembers" + ], + "description": "Get an AppLinkMember.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "appLinkName", + "in": "path", + "description": "The name of the AppLink", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9-]{3,24}$" + }, + { + "name": "appLinkMemberName", + "in": "path", + "description": "The name of the AppLinkMember", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9-]{3,24}$" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/AppLinkMember" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "AppLinkMembers_Get": { + "$ref": "./examples/AppLinkMembers_Get.json" + } + } + }, + "put": { + "operationId": "AppLinkMembers_CreateOrUpdate", + "tags": [ + "AppLinkMembers" + ], + "description": "Create an AppLinkMember.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "appLinkName", + "in": "path", + "description": "The name of the AppLink", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9-]{3,24}$" + }, + { + "name": "appLinkMemberName", + "in": "path", + "description": "The name of the AppLinkMember", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9-]{3,24}$" + }, + { + "name": "resource", + "in": "body", + "description": "Resource create parameters.", + "required": true, + "schema": { + "$ref": "#/definitions/AppLinkMember" + } + } + ], + "responses": { + "200": { + "description": "Resource 'AppLinkMember' update operation succeeded", + "schema": { + "$ref": "#/definitions/AppLinkMember" + } + }, + "201": { + "description": "Resource 'AppLinkMember' create operation succeeded", + "schema": { + "$ref": "#/definitions/AppLinkMember" + }, + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "description": "A link to the status monitor" + }, + "Retry-After": { + "type": "integer", + "format": "int32", + "description": "The Retry-After header can indicate how long the client should wait before polling the operation status." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "AppLinkMembers_CreateOrUpdate": { + "$ref": "./examples/AppLinkMembers_CreateOrUpdate.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "azure-async-operation" + }, + "x-ms-long-running-operation": true + }, + "patch": { + "operationId": "AppLinkMembers_Update", + "tags": [ + "AppLinkMembers" + ], + "description": "Update an AppLinkMember.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "appLinkName", + "in": "path", + "description": "The name of the AppLink", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9-]{3,24}$" + }, + { + "name": "appLinkMemberName", + "in": "path", + "description": "The name of the AppLinkMember", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9-]{3,24}$" + }, + { + "name": "properties", + "in": "body", + "description": "The resource properties to be updated.", + "required": true, + "schema": { + "$ref": "#/definitions/AppLinkMemberUpdate" + } + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/AppLinkMember" + } + }, + "202": { + "description": "Resource update request accepted.", + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "description": "A link to the status monitor" + }, + "Location": { + "type": "string", + "description": "The Location header contains the URL where the status of the long running operation can be checked." + }, + "Retry-After": { + "type": "integer", + "format": "int32", + "description": "The Retry-After header can indicate how long the client should wait before polling the operation status." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "AppLinkMembers_Update": { + "$ref": "./examples/AppLinkMembers_Update.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "azure-async-operation" + }, + "x-ms-long-running-operation": true + }, + "delete": { + "operationId": "AppLinkMembers_Delete", + "tags": [ + "AppLinkMembers" + ], + "description": "Delete an AppLinkMember.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "appLinkName", + "in": "path", + "description": "The name of the AppLink", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9-]{3,24}$" + }, + { + "name": "appLinkMemberName", + "in": "path", + "description": "The name of the AppLinkMember", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9-]{3,24}$" + } + ], + "responses": { + "202": { + "description": "Resource deletion accepted.", + "headers": { + "Location": { + "type": "string", + "description": "The Location header contains the URL where the status of the long running operation can be checked." + }, + "Retry-After": { + "type": "integer", + "format": "int32", + "description": "The Retry-After header can indicate how long the client should wait before polling the operation status." + } + } + }, + "204": { + "description": "Resource does not exist." + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "AppLinkMembers_Delete": { + "$ref": "./examples/AppLinkMembers_Delete.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "location" + }, + "x-ms-long-running-operation": true + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppLink/appLinks/{appLinkName}/appLinkMembers/{appLinkMemberName}/upgradeHistories": { + "get": { + "operationId": "UpgradeHistories_ListByAppLinkMember", + "tags": [ + "UpgradeHistories" + ], + "description": "List UpgradeHistory resources by AppLinkMember.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "appLinkName", + "in": "path", + "description": "The name of the AppLink", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9-]{3,24}$" + }, + { + "name": "appLinkMemberName", + "in": "path", + "description": "The name of the AppLinkMember", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9-]{3,24}$" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/UpgradeHistoryListResult" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "UpgradeHistories_ListByAppLinkMember": { + "$ref": "./examples/UpgradeHistories_ListByAppLinkMember.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + } + }, + "definitions": { + "AppLink": { + "type": "object", + "description": "AppLink resource", + "properties": { + "properties": { + "$ref": "#/definitions/AppLinkProperties", + "description": "The resource-specific properties for this resource." + }, + "identity": { + "$ref": "../../../../../common-types/resource-management/v5/managedidentity.json#/definitions/ManagedServiceIdentity", + "description": "The managed service identities assigned to this resource." + } + }, + "allOf": [ + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/definitions/TrackedResource" + } + ] + }, + "AppLinkListResult": { + "type": "object", + "description": "The response of a AppLink list operation.", + "properties": { + "value": { + "type": "array", + "description": "The AppLink items on this page", + "items": { + "$ref": "#/definitions/AppLink" + } + }, + "nextLink": { + "type": "string", + "format": "uri", + "description": "The link to the next page of items" + } + }, + "required": [ + "value" + ] + }, + "AppLinkMember": { + "type": "object", + "description": "AppLink Member resource", + "properties": { + "properties": { + "$ref": "#/definitions/AppLinkMemberProperties", + "description": "The resource-specific properties for this resource." + } + }, + "allOf": [ + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/definitions/TrackedResource" + } + ] + }, + "AppLinkMemberListResult": { + "type": "object", + "description": "The response of a AppLinkMember list operation.", + "properties": { + "value": { + "type": "array", + "description": "The AppLinkMember items on this page", + "items": { + "$ref": "#/definitions/AppLinkMember" + } + }, + "nextLink": { + "type": "string", + "format": "uri", + "description": "The link to the next page of items" + } + }, + "required": [ + "value" + ] + }, + "AppLinkMemberProperties": { + "type": "object", + "description": "AppLink Member properties", + "properties": { + "clusterType": { + "$ref": "#/definitions/ClusterType", + "description": "Cluster type", + "x-ms-mutability": [ + "read", + "create" + ] + }, + "metadata": { + "$ref": "#/definitions/Metadata", + "description": "AppLink Member Metadata" + }, + "upgradeProfile": { + "$ref": "#/definitions/UpgradeProfile", + "description": "Upgrade profile." + }, + "observabilityProfile": { + "$ref": "#/definitions/ObservabilityProfile", + "description": "Observability profile" + }, + "connectivityProfile": { + "$ref": "#/definitions/ConnectivityProfile", + "description": "Connectivity profile." + }, + "provisioningState": { + "$ref": "#/definitions/ProvisioningState", + "description": "Provisioning state", + "readOnly": true + } + }, + "required": [ + "metadata" + ] + }, + "AppLinkMemberPropertiesUpdate": { + "type": "object", + "description": "AppLink Member properties", + "properties": { + "metadata": { + "$ref": "#/definitions/MetadataUpdate", + "description": "AppLink Member Metadata" + }, + "upgradeProfile": { + "$ref": "#/definitions/UpgradeProfileUpdate", + "description": "Upgrade profile." + }, + "observabilityProfile": { + "$ref": "#/definitions/ObservabilityProfile", + "description": "Observability profile" + }, + "connectivityProfile": { + "$ref": "#/definitions/ConnectivityProfileUpdate", + "description": "Connectivity profile." + } + } + }, + "AppLinkMemberUpdate": { + "type": "object", + "description": "AppLink Member resource", + "properties": { + "properties": { + "$ref": "#/definitions/AppLinkMemberPropertiesUpdate", + "description": "The resource-specific properties for this resource." + } + }, + "allOf": [ + { + "$ref": "#/definitions/Azure.ResourceManager.CommonTypes.TrackedResourceUpdate" + } + ] + }, + "AppLinkProperties": { + "type": "object", + "description": "AppLink properties", + "properties": { + "provisioningState": { + "$ref": "#/definitions/ProvisioningState", + "description": "Provisioning state", + "readOnly": true + } + } + }, + "AppLinkUpdate": { + "type": "object", + "description": "AppLink resource", + "properties": { + "properties": { + "$ref": "#/definitions/AppLinkProperties", + "description": "The resource-specific properties for this resource." + }, + "identity": { + "$ref": "#/definitions/Azure.ResourceManager.CommonTypes.ManagedServiceIdentityUpdate", + "description": "The managed service identities assigned to this resource." + } + }, + "allOf": [ + { + "$ref": "#/definitions/Azure.ResourceManager.CommonTypes.TrackedResourceUpdate" + } + ] + }, + "AvailableVersion": { + "type": "object", + "description": "AppLink available version resource", + "properties": { + "properties": { + "$ref": "#/definitions/AvailableVersionProperties", + "description": "The resource-specific properties for this resource." + } + }, + "allOf": [ + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/definitions/ProxyResource" + } + ] + }, + "AvailableVersionListResult": { + "type": "object", + "description": "The response of a AvailableVersion list operation.", + "properties": { + "value": { + "type": "array", + "description": "The AvailableVersion items on this page", + "items": { + "$ref": "#/definitions/AvailableVersion" + } + }, + "nextLink": { + "type": "string", + "format": "uri", + "description": "The link to the next page of items" + } + }, + "required": [ + "value" + ] + }, + "AvailableVersionProperties": { + "type": "object", + "description": "AppLink available version properties", + "properties": { + "kubernetesVersion": { + "type": "string", + "description": "Kubernetes version" + }, + "fullyManagedVersions": { + "$ref": "#/definitions/FullyManagedVersions", + "description": "Fully managed versions" + }, + "selfManagedVersions": { + "$ref": "#/definitions/SelfManagedVersions", + "description": "Self managed versions" + }, + "provisioningState": { + "$ref": "#/definitions/ProvisioningState", + "description": "Provisioning state", + "readOnly": true + } + }, + "required": [ + "kubernetesVersion", + "fullyManagedVersions", + "selfManagedVersions" + ] + }, + "Azure.ResourceManager.CommonTypes.ManagedServiceIdentityUpdate": { + "type": "object", + "description": "Managed service identity (system assigned and/or user assigned identities)", + "properties": { + "type": { + "$ref": "../../../../../common-types/resource-management/v5/managedidentity.json#/definitions/ManagedServiceIdentityType", + "description": "The type of managed identity assigned to this resource." + }, + "userAssignedIdentities": { + "type": "object", + "description": "The identities assigned to this resource by the user.", + "additionalProperties": { + "$ref": "../../../../../common-types/resource-management/v5/managedidentity.json#/definitions/UserAssignedIdentity", + "x-nullable": true + } + } + } + }, + "Azure.ResourceManager.CommonTypes.TrackedResourceUpdate": { + "type": "object", + "title": "Tracked Resource", + "description": "The resource model definition for an Azure Resource Manager tracked top level resource which has 'tags' and a 'location'", + "properties": { + "tags": { + "type": "object", + "description": "Resource tags.", + "additionalProperties": { + "type": "string" + } + } + }, + "allOf": [ + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/definitions/Resource" + } + ] + }, + "ClusterType": { + "type": "string", + "description": "AppLinkMember cluster type", + "enum": [ + "AKS" + ], + "x-ms-enum": { + "name": "ClusterType", + "modelAsString": true, + "values": [ + { + "name": "AKS", + "value": "AKS", + "description": "Azure Kubernetes Service" + } + ] + } + }, + "ConnectivityProfile": { + "type": "object", + "description": "AppLinkMember connectivity profile.", + "properties": { + "eastWestGateway": { + "$ref": "#/definitions/EastWestGatewayProfile", + "description": "East-West gateway profile." + }, + "privateConnect": { + "$ref": "#/definitions/PrivateConnectProfile", + "description": "Private connect profile." + } + } + }, + "ConnectivityProfileUpdate": { + "type": "object", + "description": "AppLinkMember connectivity profile.", + "properties": { + "eastWestGateway": { + "$ref": "#/definitions/EastWestGatewayProfileUpdate", + "description": "East-West gateway profile." + }, + "privateConnect": { + "$ref": "#/definitions/PrivateConnectProfileUpdate", + "description": "Private connect profile." + } + } + }, + "EastWestGatewayProfile": { + "type": "object", + "description": "AppLinkMember east-west gateway profile.", + "properties": { + "visibility": { + "$ref": "#/definitions/EastWestGatewayVisibility", + "description": "East-West gateway visibility." + } + }, + "required": [ + "visibility" + ] + }, + "EastWestGatewayProfileUpdate": { + "type": "object", + "description": "AppLinkMember east-west gateway profile.", + "properties": { + "visibility": { + "$ref": "#/definitions/EastWestGatewayVisibility", + "description": "East-West gateway visibility." + } + } + }, + "EastWestGatewayVisibility": { + "type": "string", + "description": "East-West gateway visibility.", + "enum": [ + "Internal", + "External" + ], + "x-ms-enum": { + "name": "EastWestGatewayVisibility", + "modelAsString": true, + "values": [ + { + "name": "Internal", + "value": "Internal", + "description": "Use an internal load balancer for the east-west gateway." + }, + { + "name": "External", + "value": "External", + "description": "Use an external load balancer for the east-west gateway." + } + ] + } + }, + "FullyManagedUpgradeProfile": { + "type": "object", + "description": "AppLinkMember fully managed upgrade profile", + "properties": { + "releaseChannel": { + "$ref": "#/definitions/UpgradeReleaseChannel", + "description": "Release channel" + } + }, + "required": [ + "releaseChannel" + ] + }, + "FullyManagedUpgradeProfileUpdate": { + "type": "object", + "description": "AppLinkMember fully managed upgrade profile", + "properties": { + "releaseChannel": { + "$ref": "#/definitions/UpgradeReleaseChannel", + "description": "Release channel" + } + } + }, + "FullyManagedVersions": { + "type": "object", + "description": "Fully managed versions", + "properties": { + "releaseChannels": { + "type": "array", + "description": "Release channels", + "items": { + "$ref": "#/definitions/ReleaseChannelInfo" + }, + "x-ms-identifiers": [ + "releaseChannel", + "version" + ] + } + }, + "required": [ + "releaseChannels" + ] + }, + "Metadata": { + "type": "object", + "description": "AppLinkMember metadata", + "properties": { + "resourceId": { + "type": "string", + "format": "arm-id", + "description": "Resource ID", + "x-ms-mutability": [ + "read", + "create" + ] + } + }, + "required": [ + "resourceId" + ] + }, + "MetadataUpdate": { + "type": "object", + "description": "AppLinkMember metadata" + }, + "MetricsProfile": { + "type": "object", + "description": "AppLinkMember metrics profile", + "properties": { + "metricsEndpoint": { + "type": "string", + "description": "Metrics endpoint URL", + "readOnly": true + } + } + }, + "ObservabilityProfile": { + "type": "object", + "description": "AppLinkMember observability profile", + "properties": { + "metrics": { + "$ref": "#/definitions/MetricsProfile", + "description": "Metrics configuration" + } + } + }, + "PrivateConnectProfile": { + "type": "object", + "description": "AppLinkMember private connect profile.", + "properties": { + "subnetResourceId": { + "type": "string", + "format": "arm-id", + "description": "Delegated Subnet to AppLink.", + "x-ms-mutability": [ + "read", + "create" + ] + } + }, + "required": [ + "subnetResourceId" + ] + }, + "PrivateConnectProfileUpdate": { + "type": "object", + "description": "AppLinkMember private connect profile." + }, + "ProvisioningState": { + "type": "string", + "description": "Provisioning state of the resource", + "enum": [ + "Succeeded", + "Failed", + "Canceled", + "Provisioning", + "Updating", + "Deleting", + "Accepted" + ], + "x-ms-enum": { + "name": "ProvisioningState", + "modelAsString": true, + "values": [ + { + "name": "Succeeded", + "value": "Succeeded", + "description": "Resource has been created." + }, + { + "name": "Failed", + "value": "Failed", + "description": "Resource creation failed." + }, + { + "name": "Canceled", + "value": "Canceled", + "description": "Resource creation was canceled." + }, + { + "name": "Provisioning", + "value": "Provisioning", + "description": "Resource is getting provisioned." + }, + { + "name": "Updating", + "value": "Updating", + "description": "Resource is Updating." + }, + { + "name": "Deleting", + "value": "Deleting", + "description": "Resource is Deleting." + }, + { + "name": "Accepted", + "value": "Accepted", + "description": "Resource has been Accepted." + } + ] + }, + "readOnly": true + }, + "ReleaseChannelInfo": { + "type": "object", + "description": "Release channel information", + "properties": { + "releaseChannel": { + "type": "string", + "description": "Release channel" + }, + "version": { + "type": "string", + "description": "Istio version behind release channel" + } + }, + "required": [ + "releaseChannel", + "version" + ] + }, + "SelfManagedUpgradeProfile": { + "type": "object", + "description": "AppLinkMember self managed upgrade profile", + "properties": { + "version": { + "type": "string", + "description": "Istio version" + } + }, + "required": [ + "version" + ] + }, + "SelfManagedUpgradeProfileUpdate": { + "type": "object", + "description": "AppLinkMember self managed upgrade profile", + "properties": { + "version": { + "type": "string", + "description": "Istio version" + } + } + }, + "SelfManagedVersions": { + "type": "object", + "description": "Self managed versions", + "properties": { + "versions": { + "type": "array", + "description": "Istio versions", + "items": { + "$ref": "#/definitions/VersionInfo" + }, + "x-ms-identifiers": [ + "version", + "upgrades" + ] + } + }, + "required": [ + "versions" + ] + }, + "UpgradeHistory": { + "type": "object", + "description": "AppLinkMember upgrade history", + "properties": { + "properties": { + "$ref": "#/definitions/UpgradeHistoryProperties", + "description": "The resource-specific properties for this resource." + } + }, + "allOf": [ + { + "$ref": "../../../../../common-types/resource-management/v5/types.json#/definitions/ProxyResource" + } + ] + }, + "UpgradeHistoryListResult": { + "type": "object", + "description": "The response of a UpgradeHistory list operation.", + "properties": { + "value": { + "type": "array", + "description": "The UpgradeHistory items on this page", + "items": { + "$ref": "#/definitions/UpgradeHistory" + } + }, + "nextLink": { + "type": "string", + "format": "uri", + "description": "The link to the next page of items" + } + }, + "required": [ + "value" + ] + }, + "UpgradeHistoryProperties": { + "type": "object", + "description": "AppLinkMember upgrade history properties", + "properties": { + "startTimestamp": { + "type": "string", + "format": "date-time", + "description": "Start timestamp" + }, + "endTimestamp": { + "type": "string", + "format": "date-time", + "description": "End timestamp" + }, + "initiatedBy": { + "type": "string", + "description": "Upgrade initiator" + }, + "fromVersion": { + "type": "string", + "description": "Version upgraded from" + }, + "toVersion": { + "type": "string", + "description": "Version upgraded to" + }, + "provisioningState": { + "$ref": "#/definitions/ProvisioningState", + "description": "Provisioning state", + "readOnly": true + } + }, + "required": [ + "startTimestamp", + "initiatedBy", + "fromVersion", + "toVersion" + ] + }, + "UpgradeMode": { + "type": "string", + "description": "AppLinkMember upgrade mode", + "enum": [ + "FullyManaged", + "SelfManaged" + ], + "x-ms-enum": { + "name": "UpgradeMode", + "modelAsString": true, + "values": [ + { + "name": "FullyManaged", + "value": "FullyManaged", + "description": "Fully managed upgrade mode" + }, + { + "name": "SelfManaged", + "value": "SelfManaged", + "description": "Self managed upgrade mode" + } + ] + } + }, + "UpgradeProfile": { + "type": "object", + "description": "AppLinkMember upgrade profile.", + "properties": { + "mode": { + "$ref": "#/definitions/UpgradeMode", + "description": "Upgrade mode." + }, + "fullyManagedUpgradeProfile": { + "$ref": "#/definitions/FullyManagedUpgradeProfile", + "description": "Fully managed upgrade profile." + }, + "selfManagedUpgradeProfile": { + "$ref": "#/definitions/SelfManagedUpgradeProfile", + "description": "Self managed upgrade profile." + } + }, + "required": [ + "mode" + ] + }, + "UpgradeProfileUpdate": { + "type": "object", + "description": "AppLinkMember upgrade profile.", + "properties": { + "mode": { + "$ref": "#/definitions/UpgradeMode", + "description": "Upgrade mode." + }, + "fullyManagedUpgradeProfile": { + "$ref": "#/definitions/FullyManagedUpgradeProfileUpdate", + "description": "Fully managed upgrade profile." + }, + "selfManagedUpgradeProfile": { + "$ref": "#/definitions/SelfManagedUpgradeProfileUpdate", + "description": "Self managed upgrade profile." + } + } + }, + "UpgradeReleaseChannel": { + "type": "string", + "description": "AppLinkMember upgrade release channel", + "enum": [ + "Rapid", + "Stable" + ], + "x-ms-enum": { + "name": "UpgradeReleaseChannel", + "modelAsString": true, + "values": [ + { + "name": "Rapid", + "value": "Rapid", + "description": "Rapid release channel" + }, + { + "name": "Stable", + "value": "Stable", + "description": "Stable release channel" + } + ] + } + }, + "VersionInfo": { + "type": "object", + "description": "Version information", + "properties": { + "version": { + "type": "string", + "description": "Istio version" + }, + "upgrades": { + "type": "array", + "description": "Available upgrades", + "items": { + "type": "string" + } + } + }, + "required": [ + "version", + "upgrades" + ] + } + }, + "parameters": {} +} diff --git a/specification/applink/resource-manager/readme.az.md b/specification/applink/resource-manager/readme.az.md new file mode 100644 index 000000000000..3b72a3d25cd2 --- /dev/null +++ b/specification/applink/resource-manager/readme.az.md @@ -0,0 +1,28 @@ +## AZ + +These settings apply only when `--az` is specified on the command line. + +For new Resource Provider. It is highly recommended to onboard Azure CLI extensions. There are no differences in terms of customer usage. + +``` yaml $(az) && $(target-mode) != 'core' +az: + extensions: applink + namespace: azure.mgmt.applink + package-name: azure-mgmt-applink +az-output-folder: $(azure-cli-extension-folder)/src/applink +python-sdk-output-folder: "$(az-output-folder)/azext_applink/vendored_sdks/applink" +# add additional configuration here specific for Azure CLI +# refer to the faq.md for more details +``` + + + +This is for command modules that already in azure cli main repo. +``` yaml $(az) && $(target-mode) == 'core' +az: + extensions: applink + namespace: azure.mgmt.applink + package-name: azure-mgmt-applink +az-output-folder: $(azure-cli-folder)/src/azure-cli/azure/cli/command_modules/applink +python-sdk-output-folder: "$(az-output-folder)/vendored_sdks/applink" +``` \ No newline at end of file diff --git a/specification/applink/resource-manager/readme.csharp.md b/specification/applink/resource-manager/readme.csharp.md new file mode 100644 index 000000000000..8d1a91ea150a --- /dev/null +++ b/specification/applink/resource-manager/readme.csharp.md @@ -0,0 +1,15 @@ +## C# + +These settings apply only when `--csharp` is specified on the command line. +Please also specify `--csharp-sdks-folder=`. + +```yaml $(csharp) +csharp: + azure-arm: true + license-header: MICROSOFT_MIT_NO_VERSION + payload-flattening-threshold: 1 + clear-output-folder: true + client-side-validation: false + namespace: Microsoft.AppLink + output-folder: $(csharp-sdks-folder)/applink/management/Microsoft.AppLink/GeneratedProtocol +``` \ No newline at end of file diff --git a/specification/applink/resource-manager/readme.go.md b/specification/applink/resource-manager/readme.go.md new file mode 100644 index 000000000000..e37b6f0914f1 --- /dev/null +++ b/specification/applink/resource-manager/readme.go.md @@ -0,0 +1,11 @@ +## Go + +These settings apply only when `--go` is specified on the command line. + +```yaml $(go) && $(track2) +azure-arm: true +license-header: MICROSOFT_MIT_NO_VERSION +module-name: sdk/resourcemanager/applink/armapplink +module: github.com/Azure/azure-sdk-for-go/$(module-name) +output-folder: $(go-sdk-folder)/$(module-name) +``` \ No newline at end of file diff --git a/specification/applink/resource-manager/readme.java.md b/specification/applink/resource-manager/readme.java.md new file mode 100644 index 000000000000..6e8b3d9f0e41 --- /dev/null +++ b/specification/applink/resource-manager/readme.java.md @@ -0,0 +1,9 @@ +## Java + +These settings apply only when `--java` is specified on the command line. + +``` yaml $(java) +client-flattened-annotation-target: disabled +namespace: com.azure.resourcemanager.applink +skip-formatting: true +``` \ No newline at end of file diff --git a/specification/applink/resource-manager/readme.md b/specification/applink/resource-manager/readme.md new file mode 100644 index 000000000000..d300f7e363ac --- /dev/null +++ b/specification/applink/resource-manager/readme.md @@ -0,0 +1,83 @@ +# AppLink + +> see https://aka.ms/autorest + +This is the AutoRest configuration file for AppLink. + +## Getting Started + +To build the SDKs for AppLink, simply install AutoRest via `npm` (`npm install -g autorest`) and then run: + +> `autorest readme.md` + +To see additional help and options, run: + +> `autorest --help` + +For other options on installation see [Installing AutoRest](https://aka.ms/autorest/install) on the AutoRest github page. + +--- + +## Configuration + +### Basic Information + +These are the global settings for the AppLink. + +```yaml +openapi-type: arm +openapi-subtype: rpaas +tag: package-2025-08-01-preview +``` + +### Tag: package-2025-08-01-preview + +These settings apply only when `--tag=package-2025-08-01-preview` is specified on the command line. + +```yaml $(tag) == 'package-2025-08-01-preview' +input-file: + - Microsoft.AppLink/preview/2025-08-01-preview/openapi.json +``` + +--- + +# Code Generation + +## Swagger to SDK + +This section describes what SDK should be generated by the automatic system. +This is not used by Autorest itself. + +```yaml $(swagger-to-sdk) +swagger-to-sdk: + - repo: azure-sdk-for-python + - repo: azure-sdk-for-java + - repo: azure-sdk-for-go + - repo: azure-sdk-for-js + - repo: azure-resource-manager-schemas + - repo: azure-cli-extensions + - repo: azure-powershell +``` +## Az + +See configuration in [readme.az.md](./readme.az.md) + +## Go + +See configuration in [readme.go.md](./readme.go.md) + +## Python + +See configuration in [readme.python.md](./readme.python.md) + +## TypeScript + +See configuration in [readme.typescript.md](./readme.typescript.md) + +## CSharp + +See configuration in [readme.csharp.md](./readme.csharp.md) + +## Java + +See configuration in [readme.java.md](./readme.java.md) \ No newline at end of file diff --git a/specification/applink/resource-manager/readme.python.md b/specification/applink/resource-manager/readme.python.md new file mode 100644 index 000000000000..185743868f6d --- /dev/null +++ b/specification/applink/resource-manager/readme.python.md @@ -0,0 +1,23 @@ +## Python + +These settings apply only when `--python` is specified on the command line. +Please also specify `--python-sdks-folder=`. + +``` yaml $(python) +azure-arm: true +license-header: MICROSOFT_MIT_NO_VERSION +package-name: azure-mgmt-applink +namespace: azure.mgmt.applink +package-version: 1.0.0b1 +clear-output-folder: true +``` + +``` yaml $(python) +no-namespace-folders: true +output-folder: $(python-sdks-folder)/applink/azure-mgmt-applink/azure/mgmt/applink +``` + +``` yaml $(python) +modelerfour: + flatten-models: false +``` \ No newline at end of file diff --git a/specification/applink/resource-manager/readme.typescript.md b/specification/applink/resource-manager/readme.typescript.md new file mode 100644 index 000000000000..c6402df5a3a3 --- /dev/null +++ b/specification/applink/resource-manager/readme.typescript.md @@ -0,0 +1,14 @@ +## TypeScript + +These settings apply only when `--typescript` is specified on the command line. +Please also specify `--typescript-sdks-folder=`. + +``` yaml $(typescript) +typescript: + azure-arm: true + package-name: "@azure/arm-applink" + output-folder: "$(typescript-sdks-folder)/sdk/applink/arm-applink" + payload-flattening-threshold: 1 + clear-output-folder: true + generate-metadata: true +``` \ No newline at end of file