Disk.tsp

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

using TypeSpec.Rest;
using Azure.ResourceManager;
using TypeSpec.Http;
using TypeSpec.OpenAPI;
using Common;

namespace ComputeDisk;
/**
 * Disk resource.
 */
model Disk is Azure.ResourceManager.TrackedResource<DiskProperties> {
  ...ResourceNameParameter<
    Resource = Disk,
    KeyName = "diskName",
    SegmentName = "disks",
    NamePattern = "^[^_\\W][\\w-._]{0,79}(?<![-.])$"
  >;

  /**
   * A relative URI containing the ID of the VM that has the disk attached.
   */
  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property"
  @visibility(Lifecycle.Read)
  managedBy?: string;

  /**
   * List of relative URIs containing the IDs of the VMs that have the disk attached. maxShares should be set to a value greater than one for disks to allow attaching them to multiple VMs.
   */
  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property"
  @visibility(Lifecycle.Read)
  managedByExtended?: string[];

  /**
   * The disks sku name. Can be Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS, or PremiumV2_LRS.
   */
  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property"
  sku?: DiskSku;

  /**
   * The Logical zone list for Disk.
   */
  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property"
  zones?: string[];

  /**
   * The extended location where the disk will be created. Extended location cannot be changed.
   */
  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property"
  extendedLocation?: ExtendedLocation;
}

@armResourceOperations
interface Disks {
  /**
   * Gets information about a disk.
   */
  get is ComputeResourceRead<Disk>;

  /**
   * Creates or updates a disk.
   */
  #suppress "@azure-tools/typespec-azure-resource-manager/arm-put-operation-response-codes" "For backward compatibility"
  #suppress "@azure-tools/typespec-azure-resource-manager/no-response-body" "For backward compatibility"
  createOrUpdate is ComputeResourceCreateOrReplaceAsync<
    Disk,
    Response =
      | ArmResourceUpdatedResponse<Disk>
      | (ArmAcceptedLroResponse<LroHeaders = ArmLroLocationHeader<FinalResult = Disk> &
          Azure.Core.Foundations.RetryAfterHeader> & {
          @bodyRoot _: Disk;
        })
  >;

  /**
   * Updates (patches) a disk.
   */
  #suppress "@azure-tools/typespec-azure-resource-manager/no-response-body" "For backward compatibility"
  @patch(#{ implicitOptionality: false })
  update is ComputeCustomPatchAsync<
    Disk,
    DiskUpdate,
    Response =
      | ArmResponse<Disk>
      | (ArmAcceptedLroResponse<LroHeaders = ArmLroLocationHeader<FinalResult = Disk> &
          Azure.Core.Foundations.RetryAfterHeader> & {
          @bodyRoot _: Disk;
        })
  >;

  /**
   * Deletes a disk.
   */
  #suppress "deprecated" "For backward compatibility"
  #suppress "@azure-tools/typespec-azure-resource-manager/arm-delete-operation-response-codes" "For backward compatibility"
  #suppress "@azure-tools/typespec-azure-core/no-response-body" "For backward compatibility"
  delete is ComputeResourceDeleteAsync<Disk>;

  /**
   * Lists all the disks under a resource group.
   */
  listByResourceGroup is ComputeResourceListByParent<Disk, Response = DiskList>;

  /**
   * Lists all the disks under a subscription.
   */
  list is ComputeListBySubscription<Disk, Response = DiskList>;

  /**
   * Grants access to a disk.
   */
  @action("beginGetAccess")
  grantAccess is ComputeResourceActionAsync<Disk, GrantAccessData, AccessUri>;

  /**
   * Revokes access to a disk.
   */
  @action("endGetAccess")
  revokeAccess is ComputeResourceActionAsync<
    Disk,
    void,
    OkResponse,
    LroHeaders = ArmLroLocationHeader & Azure.Core.Foundations.RetryAfterHeader
  >;
}

@@doc(
  Disk.name,
  "The name of the managed disk that is being created. The name can't be changed after the disk is created. Supported characters for the name are a-z, A-Z, 0-9, underscore (_), hyphen (-), and dot (.). The maximum name length is 80 characters."
);
@@doc(Disk.properties, "Disk resource properties.");
@@doc(
  Disks.createOrUpdate::parameters.resource,
  "Disk object supplied in the body of the Put disk operation."
);
@@doc(
  Disks.update::parameters.properties,
  "Disk object supplied in the body of the Patch disk operation."
);
@@doc(
  Disks.grantAccess::parameters.body,
  "Access data object supplied in the body of the get disk access operation."
);