Job.tsp

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

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

namespace Microsoft.SecurityInsights;
/**
 * The assignment job
 */
@parentResource(WorkspaceManagerAssignment)
model Job is Azure.ResourceManager.ProxyResource<JobProperties> {
  ...ResourceNameParameter<
    Resource = Job,
    KeyName = "jobName",
    SegmentName = "jobs",
    NamePattern = "^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$"
  >;

  /**
   * Etag of the azure resource
   */
  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
  etag?: string;
}

@armResourceOperations(#{ omitTags: true })
interface Jobs {
  /**
   * Gets a job
   */
  @tag("workspaceManagerAssignments")
  get is Extension.Read<workspaceExternalResource, Job>;

  /**
   * Deletes the specified job from the specified workspace manager assignment
   */
  @tag("workspaceManagerAssignments")
  delete is Extension.DeleteSync<workspaceExternalResource, Job>;

  /**
   * Get all jobs for the specified workspace manager assignment
   */
  @tag("workspaceManagerAssignments")
  list is Extension.ListByTarget<
    workspaceExternalResource,
    Job,
    Parameters = {
      /**
       * Sorts the results. Optional.
       */
      @query("$orderby")
      $orderby?: string;

      /**
       * Returns only the first n results. Optional.
       */
      @query("$top")
      $top?: int32;

      /**
       * Skiptoken is only used if a previous operation returned a partial result. If a previous response contains a nextLink element, the value of the nextLink element will include a skiptoken parameter that specifies a starting point to use for subsequent calls. Optional.
       */
      @query("$skipToken")
      $skipToken?: string;
    },
    Response = ArmResponse<JobList>
  >;
}

@@doc(Job.name, "The job name");
@@doc(Job.properties, "The job object");

@@added(Job, Versions.v2025_10_01_preview);
@@added(Jobs, Versions.v2025_10_01_preview);