swagger: '2.0'
info:
  version: 2020-08-01-preview
  title: Microsoft Azure AccessControlClient AccessConnector TemplateSpecVersions API
schemes:
- https
tags:
- name: TemplateSpecVersions
paths:
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Resources/templateSpecs/{templateSpecName}/versions/{templateSpecVersion}
  : put:
      tags:
      - TemplateSpecVersions
      operationId: microsoftAzureTemplatespecversionsCreateorupdate
      description: Creates or updates a Template Spec version.
      x-ms-examples:
        TemplateSpecVersionsCreateUpdate:
          $ref: ./examples/TemplateSpecVersionsCreate.json
      parameters:
      - $ref: '#/parameters/SubscriptionIdParameter'
      - $ref: '#/parameters/ResourceGroupNameParameter'
      - $ref: '#/parameters/TemplateSpecNameParameter'
      - $ref: '#/parameters/TemplateSpecVersionParameter'
      - $ref: '#/parameters/ApiVersionParameter'
      - name: templateSpecVersionModel
        in: body
        required: true
        schema:
          $ref: '#/definitions/TemplateSpecVersion'
        description: Template Spec Version supplied to the operation.
      responses:
        '200':
          description: OK - The Template Spec Version has been successfully updated.
          schema:
            $ref: '#/definitions/TemplateSpecVersion'
        '201':
          description: Template Spec Version created.
          schema:
            $ref: '#/definitions/TemplateSpecVersion'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/TemplateSpecsError'
      summary: Microsoft Azure Put Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Resources Templatespecs Templatespecname Versions Templatespecversion
    patch:
      tags:
      - TemplateSpecVersions
      operationId: microsoftAzureTemplatespecversionsUpdate
      description: Updates Template Spec Version tags with specified values.
      x-ms-examples:
        TemplateSpecsPatch:
          $ref: ./examples/TemplateSpecVersionsPatch.json
      parameters:
      - $ref: '#/parameters/SubscriptionIdParameter'
      - $ref: '#/parameters/ResourceGroupNameParameter'
      - $ref: '#/parameters/TemplateSpecNameParameter'
      - $ref: '#/parameters/ApiVersionParameter'
      - $ref: '#/parameters/TemplateSpecVersionParameter'
      - name: templateSpecVersionUpdateModel
        in: body
        schema:
          $ref: '#/definitions/TemplateSpecVersionUpdateModel'
        description: Template Spec Version resource with the tags to be updated.
      responses:
        '200':
          description: OK -- Template Spec Version tags are updated.
          schema:
            $ref: '#/definitions/TemplateSpecVersion'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/TemplateSpecsError'
      summary: Microsoft Azure Patch Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Resources Templatespecs Templatespecname Versions Templatespecversion
    get:
      tags:
      - TemplateSpecVersions
      operationId: microsoftAzureTemplatespecversionsGet
      description: Gets a Template Spec version from a specific Template Spec.
      x-ms-examples:
        TemplateSpecVersionsGet:
          $ref: ./examples/TemplateSpecVersionsGet.json
      parameters:
      - $ref: '#/parameters/SubscriptionIdParameter'
      - $ref: '#/parameters/ResourceGroupNameParameter'
      - $ref: '#/parameters/TemplateSpecNameParameter'
      - $ref: '#/parameters/ApiVersionParameter'
      - $ref: '#/parameters/TemplateSpecVersionParameter'
      responses:
        '200':
          description: OK - Returns information about the Template Spec version.
          schema:
            $ref: '#/definitions/TemplateSpecVersion'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/TemplateSpecsError'
      summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Resources Templatespecs Templatespecname Versions Templatespecversion
    delete:
      tags:
      - TemplateSpecVersions
      operationId: microsoftAzureTemplatespecversionsDelete
      description: Deletes a specific version from a Template Spec. When operation completes, status code 200 returned without content.
      x-ms-examples:
        TemplateSpecVersionsDelete:
          $ref: ./examples/TemplateSpecVersionsDelete.json
      parameters:
      - $ref: '#/parameters/SubscriptionIdParameter'
      - $ref: '#/parameters/ResourceGroupNameParameter'
      - $ref: '#/parameters/TemplateSpecNameParameter'
      - $ref: '#/parameters/ApiVersionParameter'
      - $ref: '#/parameters/TemplateSpecVersionParameter'
      responses:
        '200':
          description: OK - Template Spec Version deleted.
        '204':
          description: Template Spec Version does not exist.
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/TemplateSpecsError'
      summary: Microsoft Azure Delete Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Resources Templatespecs Templatespecname Versions Templatespecversion
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Resources/templateSpecs/{templateSpecName}/versions
  : get:
      tags:
      - TemplateSpecVersions
      operationId: microsoftAzureTemplatespecversionsList
      description: Lists all the Template Spec versions in the specified Template Spec.
      x-ms-examples:
        TemplateSpecVersions_List:
          $ref: ./examples/TemplateSpecVersionsList.json
      parameters:
      - $ref: '#/parameters/SubscriptionIdParameter'
      - $ref: '#/parameters/ResourceGroupNameParameter'
      - $ref: '#/parameters/TemplateSpecNameParameter'
      - $ref: '#/parameters/ApiVersionParameter'
      responses:
        '200':
          description: OK - Returns an array of Template Spec versions.
          schema:
            $ref: '#/definitions/TemplateSpecVersionsListResult'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/TemplateSpecsError'
      x-ms-pageable:
        nextLinkName: nextLink
      summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Resources Templatespecs Templatespecname Versions
definitions:
  TemplateSpecVersion:
    required:
    - properties
    - location
    type: object
    description: Template Spec Version object.
    allOf:
    - $ref: '#/definitions/AzureResourceBase'
    properties:
      location:
        type: string
        x-ms-mutability:
        - read
        - create
        description: The location of the Template Spec Version. It must match the location of the parent Template Spec.
      properties:
        description: Template Spec Version properties.
        x-ms-client-flatten: true
        $ref: '#/definitions/TemplateSpecVersionProperties'
      tags:
        type: object
        description: Resource tags.
        additionalProperties:
          type: string
  TemplateSpecVersionProperties:
    type: object
    description: Template Spec Version properties.
    properties:
      description:
        type: string
        maxLength: 4096
        description: Template Spec version description.
      linkedTemplates:
        type: array
        items:
          $ref: '#/definitions/LinkedTemplateArtifact'
        description: An array of linked template artifacts.
      metadata:
        type: object
        description: The version metadata. Metadata is an open-ended object and is typically a collection of key-value pairs.
      mainTemplate:
        type: object
        description: The main Azure Resource Manager template content.
      uiFormDefinition:
        type: object
        description: The Azure Resource Manager template UI definition content.
  TemplateSpecVersionUpdateModel:
    type: object
    description: Template Spec Version properties to be updated (only tags are currently supported).
    properties:
      tags:
        type: object
        description: Resource tags.
        additionalProperties:
          type: string
    allOf:
    - $ref: '#/definitions/AzureResourceBase'
  TemplateSpecsError:
    properties:
      error:
        $ref: ../../../../../common-types/resource-management/v1/types.json#/definitions/ErrorResponse
    description: Template Specs error response.
  TemplateSpecVersionsListResult:
    description: List of Template Specs versions
    properties:
      value:
        type: array
        items:
          $ref: '#/definitions/TemplateSpecVersion'
        description: An array of Template Spec versions.
      nextLink:
        readOnly: true
        type: string
        description: The URL to use for getting the next set of results.
  LinkedTemplateArtifact:
    type: object
    description: Represents a Template Spec artifact containing an embedded Azure Resource Manager template for use as a linked template.
    properties:
      path:
        type: string
        description: A filesystem safe relative path of the artifact.
      template:
        type: object
        description: The Azure Resource Manager template.
    required:
    - template
    - path
  AzureResourceBase:
    x-ms-azure-resource: true
    type: object
    description: Common properties for all Azure resources.
    properties:
      id:
        readOnly: true
        type: string
        description: String Id used to locate any resource on Azure.
      name:
        readOnly: true
        type: string
        description: Name of this resource.
      type:
        readOnly: true
        type: string
        description: Type of this resource.
      systemData:
        readOnly: true
        type: object
        description: Azure Resource Manager metadata containing createdBy and modifiedBy information.
        $ref: ../../../../../common-types/resource-management/v1/types.json#/definitions/systemData
parameters:
  TemplateSpecVersionParameter:
    name: templateSpecVersion
    in: path
    required: true
    type: string
    pattern: ^[-\w\._\(\)]+$
    description: The version of the Template Spec.
    minLength: 1
    maxLength: 90
    x-ms-parameter-location: method
  ApiVersionParameter:
    name: api-version
    in: query
    required: true
    type: string
    x-ms-parameter-location: client
    description: Client Api version.
  TemplateSpecNameParameter:
    name: templateSpecName
    in: path
    required: true
    type: string
    pattern: ^[-\w\._\(\)]+$
    description: Name of the Template Spec.
    minLength: 1
    maxLength: 90
    x-ms-parameter-location: method
  SubscriptionIdParameter:
    name: subscriptionId
    in: path
    required: true
    type: string
    x-ms-parameter-location: client
    description: Subscription Id which forms part of the URI for every service call.
  ResourceGroupNameParameter:
    name: resourceGroupName
    in: path
    required: true
    type: string
    description: The name of the resource group. The name is case insensitive.
    pattern: ^[-\w\._\(\)]+$
    minLength: 1
    maxLength: 90
    x-ms-parameter-location: method
x-ms-parameterized-host:
  hostTemplate: '{endpoint}'
  useSchemePrefix: false
  parameters:
  - $ref: '#/parameters/Endpoint'