swagger: '2.0'
info:
  version: 2020-08-01-preview
  title: Microsoft Azure AccessControlClient AccessConnector TemplateSpecs API
schemes:
- https
tags:
- name: TemplateSpecs
paths:
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Resources/templateSpecs/{templateSpecName}
  : put:
      tags:
      - TemplateSpecs
      operationId: microsoftAzureTemplatespecsCreateorupdate
      description: Creates or updates a Template Spec.
      x-ms-examples:
        TemplateSpecsCreateUpdate:
          $ref: ./examples/TemplateSpecsCreate.json
      parameters:
      - $ref: '#/parameters/SubscriptionIdParameter'
      - $ref: '#/parameters/ResourceGroupNameParameter'
      - $ref: '#/parameters/TemplateSpecNameParameter'
      - $ref: '#/parameters/ApiVersionParameter'
      - name: templateSpec
        in: body
        required: true
        schema:
          $ref: '#/definitions/TemplateSpec'
        description: Template Spec supplied to the operation.
      responses:
        '200':
          description: OK - The Template Spec update request has succeeded.
          schema:
            $ref: '#/definitions/TemplateSpec'
        '201':
          description: Template Spec created.
          schema:
            $ref: '#/definitions/TemplateSpec'
        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
    patch:
      tags:
      - TemplateSpecs
      operationId: microsoftAzureTemplatespecsUpdate
      description: Updates Template Spec tags with specified values.
      x-ms-examples:
        TemplateSpecsPatch:
          $ref: ./examples/TemplateSpecsPatch.json
      parameters:
      - $ref: '#/parameters/SubscriptionIdParameter'
      - $ref: '#/parameters/ResourceGroupNameParameter'
      - $ref: '#/parameters/TemplateSpecNameParameter'
      - $ref: '#/parameters/ApiVersionParameter'
      - name: templateSpec
        in: body
        schema:
          $ref: '#/definitions/TemplateSpecUpdateModel'
        description: Template Spec resource with the tags to be updated.
      responses:
        '200':
          description: OK -- Template Spec tags are updated.
          schema:
            $ref: '#/definitions/TemplateSpec'
        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
    get:
      tags:
      - TemplateSpecs
      operationId: microsoftAzureTemplatespecsGet
      description: Gets a Template Spec with a given name.
      x-ms-examples:
        TemplateSpecsGet:
          $ref: ./examples/TemplateSpecsGet.json
      parameters:
      - $ref: '#/parameters/SubscriptionIdParameter'
      - $ref: '#/parameters/ResourceGroupNameParameter'
      - $ref: '#/parameters/TemplateSpecNameParameter'
      - $ref: '#/parameters/TemplateSpecExpandParameter'
      - $ref: '#/parameters/ApiVersionParameter'
      responses:
        '200':
          description: OK - Returns information about the Template Spec.
          schema:
            $ref: '#/definitions/TemplateSpec'
        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
    delete:
      tags:
      - TemplateSpecs
      operationId: microsoftAzureTemplatespecsDelete
      description: Deletes a Template Spec by name. When operation completes, status code 200 returned without content.
      x-ms-examples:
        TemplateSpecsDelete:
          $ref: ./examples/TemplateSpecsDelete.json
      parameters:
      - $ref: '#/parameters/SubscriptionIdParameter'
      - $ref: '#/parameters/ResourceGroupNameParameter'
      - $ref: '#/parameters/TemplateSpecNameParameter'
      - $ref: '#/parameters/ApiVersionParameter'
      responses:
        '200':
          description: OK - Template Spec deleted.
        '204':
          description: Template Spec 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
  /subscriptions/{subscriptionId}/providers/Microsoft.Resources/templateSpecs/:
    get:
      tags:
      - TemplateSpecs
      operationId: microsoftAzureTemplatespecsListbysubscription
      description: Lists all the Template Specs within the specified subscriptions.
      x-ms-examples:
        TemplatesSpecsListBySubscription:
          $ref: ./examples/TemplateSpecsListBySubscription.json
      parameters:
      - $ref: '#/parameters/SubscriptionIdParameter'
      - $ref: '#/parameters/TemplateSpecExpandParameter'
      - $ref: '#/parameters/ApiVersionParameter'
      responses:
        '200':
          description: OK - Returns an array of Template Specs.
          schema:
            $ref: '#/definitions/TemplateSpecsListResult'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/TemplateSpecsError'
      x-ms-pageable:
        nextLinkName: nextLink
      summary: Microsoft Azure Get Subscriptions Subscriptionid Providers Microsoft Resources Templatespecs
  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Resources/templateSpecs/:
    get:
      tags:
      - TemplateSpecs
      operationId: microsoftAzureTemplatespecsListbyresourcegroup
      description: Lists all the Template Specs within the specified resource group.
      x-ms-examples:
        TemplateSpecsListByResourceGroup:
          $ref: ./examples/TemplateSpecsListByResourceGroup.json
      parameters:
      - $ref: '#/parameters/SubscriptionIdParameter'
      - $ref: '#/parameters/ResourceGroupNameParameter'
      - $ref: '#/parameters/TemplateSpecExpandParameter'
      - $ref: '#/parameters/ApiVersionParameter'
      responses:
        '200':
          description: OK - Returns an array of Template Specs.
          schema:
            $ref: '#/definitions/TemplateSpecsListResult'
        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
definitions:
  TemplateSpecUpdateModel:
    type: object
    description: Template Spec properties to be updated (only tags are currently supported).
    properties:
      tags:
        type: object
        description: Resource tags.
        additionalProperties:
          type: string
    allOf:
    - $ref: '#/definitions/AzureResourceBase'
  TemplateSpec:
    required:
    - location
    type: object
    description: Template Spec object.
    allOf:
    - $ref: '#/definitions/AzureResourceBase'
    properties:
      location:
        type: string
        x-ms-mutability:
        - read
        - create
        description: The location of the Template Spec. It cannot be changed after Template Spec creation. It must be one of the supported Azure locations.
      properties:
        description: Template Spec properties.
        x-ms-client-flatten: true
        $ref: '#/definitions/TemplateSpecProperties'
      tags:
        type: object
        description: Resource tags.
        additionalProperties:
          type: string
  TemplateSpecsError:
    properties:
      error:
        $ref: ../../../../../common-types/resource-management/v1/types.json#/definitions/ErrorResponse
    description: Template Specs error response.
  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
  TemplateSpecsListResult:
    description: List of Template Specs.
    properties:
      value:
        type: array
        items:
          $ref: '#/definitions/TemplateSpec'
        description: An array of Template Specs.
      nextLink:
        readOnly: true
        type: string
        description: The URL to use for getting the next set of results.
  TemplateSpecVersionInfo:
    type: object
    description: High-level information about a Template Spec version.
    properties:
      description:
        type: string
        readOnly: true
        description: Template Spec version description.
      timeCreated:
        type: string
        readOnly: true
        format: date-time
        description: The timestamp of when the version was created.
      timeModified:
        type: string
        readOnly: true
        format: date-time
        description: The timestamp of when the version was last modified.
  TemplateSpecProperties:
    type: object
    description: Template Spec properties.
    properties:
      description:
        type: string
        maxLength: 4096
        description: Template Spec description.
      displayName:
        type: string
        maxLength: 64
        description: Template Spec display name.
      metadata:
        type: object
        description: The Template Spec metadata. Metadata is an open-ended object and is typically a collection of key-value pairs.
      versions:
        type: object
        readOnly: true
        description: High-level information about the versions within this Template Spec. The keys are the version names. Only populated if the $expand query parameter is set to 'versions'.
        additionalProperties:
          $ref: '#/definitions/TemplateSpecVersionInfo'
parameters:
  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
  TemplateSpecExpandParameter:
    name: $expand
    in: query
    required: false
    type: string
    description: Allows for expansion of additional Template Spec details in the response. Optional.
    x-ms-parameter-location: method
    enum:
    - versions
    x-ms-enum:
      name: TemplateSpecExpandKind
      modelAsString: true
      values:
      - value: versions
        description: Includes version information with the Template Spec.
  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'