import "@typespec/http";
import "./back-compatible.tsp";
import "@typespec/openapi";
import "@typespec/rest";
import "@azure-tools/typespec-azure-core";
import "@azure-tools/typespec-azure-resource-manager";

using TypeSpec.Http;
using TypeSpec.OpenAPI;
using TypeSpec.Rest;
using TypeSpec.Versioning;
using Azure.Core;
using Azure.ResourceManager;

@armProviderNamespace
@service(#{ title: "Managed DevOps Infrastructure" })
@versioned(Microsoft.DevOpsInfrastructure.Versions)
namespace Microsoft.DevOpsInfrastructure;

/** Api versions */
enum Versions {
  /** 2025-01-21 version */
  @armCommonTypesVersion(CommonTypes.Versions.v5)
  v2025_01_21: "2025-01-21",

  /** 2025-09-20 version */
  @armCommonTypesVersion(CommonTypes.Versions.v6)
  v2025_09_20: "2025-09-20",

  /** 2026-04-17-preview version */
  @armCommonTypesVersion(CommonTypes.Versions.v6)
  @Azure.Core.previewVersion
  v2026_04_17_preview: "2026-04-17-preview",
}

model Pool is TrackedResource<PoolProperties> {
  @key("poolName")
  @pattern("^[a-zA-Z0-9][a-zA-Z0-9-.]*$")
  @path
  @segment("pools")
  @doc("Name of the pool. It needs to be globally unique.")
  name: string;

  ...ManagedServiceIdentityProperty;
}

@doc("Pool properties")
model PoolProperties {
  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-provisioning-state" "Existing SDK"
  @doc("The status of the current operation.")
  provisioningState?: ProvisioningState;

  @minValue(1)
  @maxValue(10000)
  @doc("Defines how many resources can there be created at any given time.")
  maximumConcurrency: int32;

  @doc("Defines the organization in which the pool will be used.")
  organizationProfile: OrganizationProfile;

  @doc("Defines how the machine will be handled once it executed a job.")
  agentProfile: AgentProfile;

  @doc("Defines the type of fabric the agent will run on.")
  fabricProfile: FabricProfile;

  @doc("The resource id of the DevCenter Project the pool belongs to.")
  devCenterProjectResourceId: string;

  @doc("The runtime configuration of the pool.")
  @added(Microsoft.DevOpsInfrastructure.Versions.v2025_09_20)
  runtimeConfiguration?: RuntimeConfiguration;
}

#suppress "@azure-tools/typespec-azure-core/no-string-discriminator" "Existing"
#suppress "@azure-tools/typespec-azure-resource-manager/no-empty-model" "Existing use case"
@doc("Defines the organization in which the pool will be used.")
@discriminator("kind")
model OrganizationProfile {}

@doc("GitHub organization profile")
model GitHubOrganizationProfile extends OrganizationProfile {
  @doc("GitHub organization profile")
  kind: "GitHub";

  @doc("The list of GitHub organizations/repositories the pool should be present in.")
  @identifiers(#[])
  organizations: GitHubOrganization[];
}
@doc("Defines a GitHub organization")
model GitHubOrganization {
  @doc("The GitHub organization URL in which the pool should be created.")
  url: url;

  @doc("Optional list of repositories in which the pool should be created.")
  repositories?: string[];
}

@doc("Azure DevOps organization profile")
model AzureDevOpsOrganizationProfile extends OrganizationProfile {
  @doc("Azure DevOps organization profile")
  kind: "AzureDevOps";

  @doc("The list of Azure DevOps organizations the pool should be present in.")
  @identifiers(#[])
  organizations: Organization[];

  @doc("The type of permission which determines which accounts are admins on the Azure DevOps pool.")
  permissionProfile?: AzureDevOpsPermissionProfile;

  @doc("An alias to reference the Azure DevOps pool name.")
  @added(Microsoft.DevOpsInfrastructure.Versions.v2025_09_20)
  `alias`?: string;
}

@doc("Defines an Azure DevOps organization.")
model Organization {
  @doc("The Azure DevOps organization URL in which the pool should be created.")
  url: url;

  @doc("Optional list of projects in which the pool should be created.")
  projects?: string[];

  @doc("How many machines can be created at maximum in this organization out of the maximumConcurrency of the pool.")
  parallelism?: int32;

  @doc("Determines if the pool should have open access to all projects in this organization.")
  openAccess?: boolean;

  @doc("An alias to reference the Azure DevOps pool name.")
  @added(Microsoft.DevOpsInfrastructure.Versions.v2025_09_20)
  `alias`?: string;
}
@doc("Defines the type of Azure DevOps pool permission.")
model AzureDevOpsPermissionProfile {
  @doc("Determines who has admin permissions to the Azure DevOps pool.")
  kind: AzureDevOpsPermissionType;

  @doc("User email addresses")
  users?: string[];

  @doc("Group email addresses")
  groups?: string[];
}
@doc("Determines who has admin permissions to the Azure DevOps pool.")
union AzureDevOpsPermissionType {
  string,

  @doc("Pool will inherit permissions from the project or organization.")
  "Inherit",

  @doc("Only the pool creator will be an admin of the pool.")
  "CreatorOnly",

  @doc("Only the specified accounts will be admins of the pool.")
  "SpecificAccounts",
}

#suppress "@azure-tools/typespec-azure-core/no-string-discriminator" "Existing"
#suppress "@azure-tools/typespec-azure-resource-manager/no-empty-model" "Existing use case"
@doc("Defines the type of fabric the agent will run on.")
@discriminator("kind")
model FabricProfile {}

@doc("The agents will run on Virtual Machine Scale Sets.")
model VmssFabricProfile extends FabricProfile {
  @doc("Virtual Machine Scale Sets")
  kind: "Vmss";

  @doc("The Azure SKU of the machines in the pool.")
  sku: DevOpsAzureSku;

  @doc("The VM images of the machines in the pool.")
  @identifiers(#[])
  images: PoolImage[];

  @doc("The OS profile of the machines in the pool.")
  osProfile?: OsProfile;

  @doc("The storage profile of the machines in the pool.")
  storageProfile?: StorageProfile;

  @doc("The network profile of the machines in the pool.")
  networkProfile?: NetworkProfile;
}

@doc("The runtime configuration of the pool.")
@added(Microsoft.DevOpsInfrastructure.Versions.v2025_09_20)
model RuntimeConfiguration {
  @doc("The target work folder of the task agent on the machine.")
  workFolder?: string;
}

@doc("The Azure SKU of the machines in the pool.")
model DevOpsAzureSku {
  @doc("The Azure SKU name of the machines in the pool.")
  name: string;

  @doc("The drive letter for the NVMe striped volume on Windows (e.g., 'N'). Defaults to 'N' when not specified.")
  @added(Microsoft.DevOpsInfrastructure.Versions.v2026_04_17_preview)
  windowsNvmeDrive?: string;

  @doc("The mount path for the NVMe striped volume on Linux (e.g., '/mnt/azure_nvme_temp'). Defaults to '/mnt/azure_nvme_temp' when not specified.")
  @added(Microsoft.DevOpsInfrastructure.Versions.v2026_04_17_preview)
  linuxNvmePath?: string;
}

@doc("The storage profile of the VMSS.")
model StorageProfile {
  @doc("The Azure SKU name of the machines in the pool.")
  osDiskStorageAccountType?: OsDiskStorageAccountType;

  @doc("A list of empty data disks to attach.")
  @identifiers(#[])
  dataDisks?: DataDisk[];
}

@doc("The data disk of the VMSS.")
model DataDisk {
  @doc("The type of caching to be enabled for the data disks. The default value for caching is readwrite. For information about the caching options see: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.")
  caching?: CachingType;

  @doc("The initial disk size in gigabytes.")
  diskSizeGiB?: int32;

  @doc("The storage Account type to be used for the data disk. If omitted, the default is \"standard_lrs\".")
  storageAccountType?: StorageAccountType;

  @doc("The drive letter for the empty data disk. If not specified, it will be the first available letter.")
  driveLetter?: string;
}

@doc("The type of caching in a data disk.")
union CachingType {
  string,

  @doc("Don't use host caching.")
  "None",

  @doc("For workloads that only do read operations.")
  "ReadOnly",

  @doc("For workloads that do a balance of read and write operations.")
  "ReadWrite",
}

@doc("StorageAccountType enums")
union StorageAccountType {
  string,

  @doc("The data disk should use standard locally redundant storage.")
  StandardLRS: "Standard_LRS",

  @doc("The data disk should use premium locally redundant storage.")
  PremiumLRS: "Premium_LRS",

  @doc("The data disk should use standard SSD locally redundant storage.")
  StandardSSDLRS: "StandardSSD_LRS",

  @doc("The data disk should use premium SSD zonal redundant storage.")
  PremiumZRS: "Premium_ZRS",

  @doc("The data disk should use standard SSD zonal redundant storage.")
  StandardSSDZRS: "StandardSSD_ZRS",
}

@doc("The storage account type of the OS disk.")
union OsDiskStorageAccountType {
  string,

  @doc("Standard OS disk type.")
  Standard: "Standard",

  @doc("Premium OS disk type.")
  Premium: "Premium",

  @doc("Standard SSD OS disk type.")
  StandardSSD: "StandardSSD",
}

@doc("The type of Ephemeral option the pool will use on underlying VMs when loading this image.")
union EphemeralType {
  string,

  @doc("Ephemeral is handled by Managed DevOps Pools service.")
  Automatic: "Automatic",

  @doc("CacheDisk ephemeral only, requires that the SKU has a cache that is large enough for the image.")
  CacheDisk: "CacheDisk",

  @doc("ResourceDisk ephemeral only, requires only that the SKU supports it.")
  ResourceDisk: "ResourceDisk",
}

@doc("The VM image of the machines in the pool.")
model PoolImage {
  @doc("The resource id of the image.")
  resourceId?: string;

  @doc("The image to use from a well-known set of images made available to customers.")
  wellKnownImageName?: string;

  @doc("List of aliases to reference the image by.")
  aliases?: string[];

  @doc("The percentage of the buffer to be allocated to this image.")
  buffer?: string = "*";

  @doc("The ephemeral type of the image.")
  ephemeralType?: EphemeralType;

  @doc("Read only. Determines if the image is ephemeral.")
  @visibility(Lifecycle.Read)
  @added(Microsoft.DevOpsInfrastructure.Versions.v2025_09_20)
  isEphemeral?: boolean;
}

@doc("The OS profile of the machines in the pool.")
model OsProfile {
  @doc("The secret management settings of the machines in the pool.")
  secretsManagementSettings?: SecretsManagementSettings;

  @doc("Determines how the service should be run. By default, this will be set to Service.")
  logonType?: LogonType;
}

@doc("The certificate store name type")
union CertificateStoreNameOption {
  string,

  @doc("The X.509 certificate store for personal certificates.")
  "My",

  @doc("The X.509 certificate store for trusted root certificate authorities (CAs).")
  "Root",
}

@doc("The secret management settings of the machines in the pool.")
model SecretsManagementSettings {
  @doc("Where to store certificates on the machine.")
  certificateStoreLocation?: string;

  @doc("Name of the certificate store to use on the machine, currently 'My' and 'Root' are supported.")
  certificateStoreName?: CertificateStoreNameOption;

  @doc("The list of certificates to install on all machines in the pool.")
  observedCertificates: url[];

  @doc("Defines if the key of the certificates should be exportable.")
  keyExportable: boolean;
}

@doc("Determines how the service should be run.")
union LogonType {
  string,

  @doc("Run as a service.")
  "Service",

  @doc("Run in interactive mode.")
  "Interactive",
}

@doc("The network profile of the machines in the pool.")
model NetworkProfile {
  @doc("The subnet id on which to put all machines created in the pool.")
  @madeOptional(Microsoft.DevOpsInfrastructure.Versions.v2025_09_20)
  subnetId?: string;

  @doc("The number of static public IP addresses for outgoing connections assigned to the pool.")
  @added(Microsoft.DevOpsInfrastructure.Versions.v2025_09_20)
  staticIpAddressCount?: int32;

  @doc("Read only. The list of static public IP addresses for outgoing connections assigned to the pool.")
  @added(Microsoft.DevOpsInfrastructure.Versions.v2025_09_20)
  @visibility(Lifecycle.Read)
  ipAddresses?: string[];
}

#suppress "@azure-tools/typespec-azure-core/no-string-discriminator" "Existing"
@doc("The agent profile of the machines in the pool.")
@discriminator("kind")
model AgentProfile {
  @doc("Defines pool buffer/stand-by agents.")
  resourcePredictions?: ResourcePredictions;

  @doc("Defines how the pool buffer/stand-by agents is provided.")
  resourcePredictionsProfile?: ResourcePredictionsProfile;
}
@doc("Stateless profile meaning that the machines will be cleaned up after running a job.")
model StatelessAgentProfile extends AgentProfile {
  @doc("Stateless profile meaning that the machines will be cleaned up after running a job.")
  kind: "Stateless";
}
@doc("Stateful profile meaning that the machines will be returned to the pool after running a job.")
model Stateful extends AgentProfile {
  @doc("Stateful profile meaning that the machines will be returned to the pool after running a job.")
  kind: "Stateful";

  @doc("How long should stateful machines be kept around. The maximum is one week.")
  maxAgentLifetime?: string;

  @doc("How long should the machine be kept around after it ran a workload when there are no stand-by agents. The maximum is one week.")
  gracePeriodTimeSpan?: string;
}
#suppress "@azure-tools/typespec-azure-resource-manager/no-empty-model" "Existing use case"
@doc("Defines pool buffer.")
model ResourcePredictions {}

@doc("Determines how the stand-by scheme should be provided.")
@discriminator("kind")
model ResourcePredictionsProfile {
  @doc("Determines how the stand-by scheme should be provided.")
  kind: ResourcePredictionsProfileType;
}

@doc("Customer provides the stand-by agent scheme.")
model ManualResourcePredictionsProfile extends ResourcePredictionsProfile {
  @doc("Customer provides the stand-by agent scheme.")
  kind: "Manual";
}

@doc("The stand-by agent scheme is determined based on historical demand.")
model AutomaticResourcePredictionsProfile extends ResourcePredictionsProfile {
  @doc("The stand-by agent scheme is determined based on historical demand.")
  kind: "Automatic";

  @doc("Determines the balance between cost and performance.")
  predictionPreference?: PredictionPreference;
}

@doc("Determines how the stand-by scheme should be provided.")
union ResourcePredictionsProfileType {
  string,

  @doc("Customer provides the stand-by agent scheme.")
  "Manual",

  @doc("The stand-by agent scheme is determined based on historical demand.")
  "Automatic",
}

@doc("Determines the balance between cost and performance.")
union PredictionPreference {
  string,

  @doc("Balance between cost and performance.")
  "Balanced",

  @doc("Optimizes for cost over performance.")
  "MostCostEffective",

  @doc("Halfway through cost and balanced.")
  "MoreCostEffective",

  @doc("Halfway through balanced and performance.")
  "MorePerformance",

  @doc("Optimizes for performance over cost.")
  "BestPerformance",
}

@doc("The status of the current operation.")
union ProvisioningState {
  string,

  /** Represents a succeeded operation. */
  Succeeded: "Succeeded",

  /** Represents a failed operation. */
  Failed: "Failed",

  /** Represents a canceled operation. */
  Canceled: "Canceled",

  /** Represents a pending operation. */
  Provisioning: "Provisioning",

  /** Represents a pending operation. */
  Updating: "Updating",

  /** Represents an operation under deletion. */
  Deleting: "Deleting",

  /** Represents an accepted operation. */
  Accepted: "Accepted",
}

interface Operations extends Azure.ResourceManager.Operations {}

@armResourceOperations
interface Pools {
  get is ArmResourceRead<Pool>;
  #suppress "@azure-tools/typespec-azure-core/invalid-final-state" "MUST CHANGE ON NEXT UPDATE"
  @Azure.Core.useFinalStateVia("azure-async-operation")
  createOrUpdate is ArmResourceCreateOrUpdateAsync<
    Pool,
    LroHeaders = Azure.Core.Foundations.RetryAfterHeader
  >;
  @patch(#{ implicitOptionality: false })
  update is ArmCustomPatchAsync<
    Pool,
    Azure.ResourceManager.Foundations.ResourceUpdateModel<Pool, PoolProperties>
  >;
  delete is ArmResourceDeleteWithoutOkAsync<Pool>;
  listByResourceGroup is ArmResourceListByParent<Pool>;
  listBySubscription is ArmListBySubscription<Pool>;

  @doc("Checks that the pool name is valid and is not already in use.")
  checkNameAvailability is checkGlobalNameAvailability<
    CheckNameAvailability,
    CheckNameAvailabilityResult
  >;

  @added(Microsoft.DevOpsInfrastructure.Versions.v2025_09_20)
  @action("resources")
  @post
  deleteResources is ArmResourceActionSync<
    Pool,
    DeleteResourcesDetails,
    ArmDeletedResponse | ErrorResponse
  >;
}

@parentResource(Pool)
@doc("A ResourceDetailsObject")
model ResourceDetailsObject is ProxyResource<ResourceDetailsObjectProperties> {
  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-name-pattern" "existing api"
  @doc("The name of the resource.")
  @key("resourceName")
  @segment("resources")
  @visibility(Lifecycle.Read)
  @path
  name: string;
}

#suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-provisioning-state" "No ProvisioningState"
@doc("Details of the ResourceDetailsObject.")
model ResourceDetailsObjectProperties {
  @doc("The status of the resource.")
  status: ResourceStatus;

  @doc("The image name of the resource.")
  image: string;

  @doc("The version of the image running on the resource.")
  imageVersion: string;
}

@doc("The status of the machine resource.")
union ResourceStatus {
  string,

  /** Represents a machine resource that is ready. */
  Ready: "Ready",

  /** Represents a machine resource that is not ready. */
  NotReady: "NotReady",

  /** Represents a machine resource that is allocated. */
  Allocated: "Allocated",

  /** Represents a machine resource that is pending return. */
  PendingReturn: "PendingReturn",

  /** Represents a machine resource that is returned. */
  Returned: "Returned",

  /** Represents a machine resource that is leased. */
  Leased: "Leased",

  /** Represents a machine resource that is provisioning. */
  Provisioning: "Provisioning",

  /** Represents a machine resource that is updating. */
  Updating: "Updating",

  /** Represents a machine resource that is starting. */
  Starting: "Starting",

  /** Represents a machine resource that is pending reimage. */
  PendingReimage: "PendingReimage",

  /** Represents a machine resource that is reimaging. */
  Reimaging: "Reimaging",
}

@armResourceOperations
interface ResourceDetails {
  listByPool is ArmResourceListByParent<ResourceDetailsObject>;
}

@doc("Request body for deleting many resources by their IDs.")
@added(Microsoft.DevOpsInfrastructure.Versions.v2025_09_20)
model DeleteResourcesDetails {
  @doc("List of resource IDs to delete.")
  resourceIds: string[];
}

/** Represents how SKU capacity scales. */
union ResourceSkuCapacityScaleType {
  string,

  /** Capacity scales automatically. */
  "Automatic",

  /** Capacity scales manually. */
  "Manual",

  /** Capacity does not scale. */
  "None",
}

@doc("Describes scaling information of a SKU.")
model ResourceSkuCapacity {
  @doc("The minimum capacity of the SKU.")
  minimum?: int32;

  @doc("The maximum capacity of the SKU.")
  maximum?: int32;

  @doc("The default capacity of the SKU.")
  default?: int32;

  @doc("The scale type of the SKU.")
  scaleType: ResourceSkuCapacityScaleType;
}

@doc("Describes The SKU capabilities object.")
model ResourceSkuCapabilities {
  @doc("The name of the SKU capability.")
  name: string;

  @doc("The value of the SKU capability.")
  value: string;
}

@doc("The restrictions of the SKU.")
model ResourceSkuRestrictions {
  @doc("the type of restrictions.")
  type?: ResourceSkuRestrictionsType;

  @doc("The value of restrictions. If the restriction type is set to location. This would be different locations where the SKU is restricted.")
  values: string[];

  @doc("The information about the restriction where the SKU cannot be used.")
  restrictionInfo: ResourceSkuRestrictionInfo;

  @doc("the reason for restriction.")
  reasonCode?: ResourceSkuRestrictionsReasonCode;
}

/** Describes the kind of SKU restrictions that can exist */
union ResourceSkuRestrictionsType {
  string,

  /** SKU restricted by location. */
  "Location",

  /** SKU restricted by availability zone. */
  "Zone",
}

@doc("Describes an available Compute SKU Restriction Information.")
model ResourceSkuRestrictionInfo {
  @doc("Locations where the SKU is restricted")
  locations?: azureLocation[];

  @doc("List of availability zones where the SKU is restricted.")
  zones?: string[];
}

/** Describes the reason for SKU restriction. */
union ResourceSkuRestrictionsReasonCode {
  string,

  /** The restriction is due to exceeding a quota limitation. */
  "QuotaId",

  /** The restriction is not available for this subscription. */
  "NotAvailableForSubscription",
}

@doc("Describes an available Compute SKU Location Information.")
model ResourceSkuLocationInfo {
  @doc("Location of the SKU")
  location: azureLocation;

  @doc("List of availability zones where the SKU is supported.")
  zones: string[];

  @doc("Gets details of capabilities available to a SKU in specific zones.")
  @identifiers(#[])
  zoneDetails: ResourceSkuZoneDetails[];
}

@doc("Describes The zonal capabilities of a SKU.")
model ResourceSkuZoneDetails {
  @doc("Gets the set of zones that the SKU is available in with the specified capabilities.")
  name: string[];

  @doc("A list of capabilities that are available for the SKU in the specified list of zones.")
  @identifiers(#[])
  capabilities: ResourceSkuCapabilities[];
}

@doc("A ResourceSku")
@parentResource(Location)
model ResourceSku is ProxyResource<ResourceSkuProperties> {
  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-name-pattern" "existing api"
  @doc("The name of the SKU.")
  @key("skuName")
  @segment("skus")
  @visibility(Lifecycle.Read)
  @path
  name: string;
}

#suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-provisioning-state" "No ProvisioningState"
@doc("Properties of a ResourceSku")
model ResourceSkuProperties {
  @doc("The type of resource the SKU applies to.")
  resourceType: string;

  @doc("The tier of virtual machines in a scale set")
  tier: string;

  @doc("The size of the SKU.")
  size: string;

  @doc("The family of the SKU.")
  family: string;

  @doc("The set of locations that the SKU is available.")
  locations: azureLocation[];

  @doc("A list of locations and availability zones in those locations where the SKU is available")
  @identifiers(#[])
  locationInfo: ResourceSkuLocationInfo[];

  @doc("Name value pairs to describe the capability.")
  @identifiers(#[])
  capabilities: ResourceSkuCapabilities[];

  @doc("The restrictions of the SKU.")
  @identifiers(#[])
  restrictions: ResourceSkuRestrictions[];
}

#suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-provisioning-state" "No ProvisioningState"
#suppress "@azure-tools/typespec-azure-resource-manager/missing-property" "No Identity"
@doc("An Azure location.")
model Location is ProxyResource<LocationProperties> {
  @key("locationName")
  @pattern("^[a-zA-Z0-9][a-zA-Z0-9-.]*$")
  @path
  @segment("locations")
  @doc("Name of the location.")
  name: string;
}

#suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-provisioning-state" "No ProvisioningState"
#suppress "@azure-tools/typespec-azure-resource-manager/no-empty-model" "Existing use case"
@doc("Properties of a location.")
model LocationProperties {}

@armResourceOperations
interface Sku {
  listByLocation is ArmListBySubscription<ResourceSku>;
}

@armResourceOperations
interface SubscriptionUsages {
  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-action-verb" "Actions must be HTTP Post operations."
  @action
  @armProviderNameValue
  @get
  @armResourceList(Location)
  @doc("List Quota resources by subscription ID")
  @list
  usages(
    ...SubscriptionIdParameter,
    ...Azure.ResourceManager.Foundations.DefaultProviderNamespace,
    ...LocationResourceParameter,
    ...ApiVersionParameter,
  ): ArmResponse<Page<Quota>> | ErrorResponse;
}

@doc("Describes Resource Quota")
@parentResource(Location)
model Quota {
  @doc("The name of the quota.")
  @visibility(Lifecycle.Read)
  name?: QuotaName;

  @doc("Fully qualified ARM resource id")
  id: armResourceIdentifier;

  @doc("The unit of usage measurement.")
  unit: string;

  @doc("The current usage of the resource.")
  currentValue: int64;

  @doc("The maximum permitted usage of the resource.")
  limit: int64;
}

@doc("The Quota Names")
model QuotaName {
  @doc("The name of the resource.")
  value?: string;

  @doc("The localized name of the resource.")
  localizedValue?: string;
}

#suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-provisioning-state" "No ProvisioningState"
#suppress "@azure-tools/typespec-azure-resource-manager/missing-property" "No Identity"
@doc("An image resource.")
model Image is ProxyResource<ImageProperties> {
  @key("imageName")
  @pattern("^[a-zA-Z0-9][a-zA-Z0-9-.]*$")
  @path
  @segment("images")
  @doc("Name of the image.")
  @visibility(Lifecycle.Read)
  name: string;
}

@doc("The type of resource.")
union DevOpsInfrastructureResourceType {
  string,

  @doc("DevOpsInfrastructure pool resource.")
  "Microsoft.DevOpsInfrastructure/pools",
}

@doc("The parameters used to check the availability of a resource.")
model CheckNameAvailability {
  @doc("The name of the resource.")
  name: string;

  @doc("The type of resource that is used as the scope of the availability check.")
  type: DevOpsInfrastructureResourceType;
}

#suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-provisioning-state" "No ProvisioningState"
#suppress "@azure-tools/typespec-azure-resource-manager/no-empty-model" "Existing use case"
@doc("Properties of an image.")
model ImageProperties {}

@parentResource(Image)
@doc("An image version object")
model ImageVersion is ProxyResource<ImageVersionProperties> {
  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-name-pattern" "existing api"
  @doc("The name of the image version.")
  @key("imageVersionName")
  @segment("versions")
  @visibility(Lifecycle.Read)
  @path
  name: string;
}

#suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-provisioning-state" "No ProvisioningState"
@doc("Details of the ImageVersionProperties.")
model ImageVersionProperties {
  @doc("Version of the image.")
  version: string;
}

@armResourceOperations
interface ImageVersions {
  listByImage is ArmResourceListByParent<ImageVersion>;
}

@doc("The reason code explaining why the name is unavailable. Will be null if the name is available.")
union CheckNameAvailabilityReason {
  string,

  @doc("The name is invalid.")
  "Invalid",

  @doc("The name already exists.")
  "AlreadyExists",
}

@doc("AvailabilityStatus of a name.")
union AvailabilityStatus {
  string,

  @doc("The name is available.")
  "Available",

  @doc("The name is unavailable")
  "Unavailable",
}

#suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-provisioning-state" "No ProvisioningState"
@doc("The CheckNameAvailability operation response.")
model CheckNameAvailabilityResult {
  @doc("Availability status of the name.")
  available: AvailabilityStatus;

  @doc("A message explaining why the name is unavailable. Will be null if the name is available.")
  message: string;

  @doc("The name whose availability was checked.")
  name: string;

  @doc("The reason code explaining why the name is unavailable. Will be null if the name is available.")
  reason: CheckNameAvailabilityReason;
}