swagger: '2.0'
info:
  title: Microsoft Azure CommunityGalleryServiceClient
  description: Community Gallery Service Client.
  version: '2021-07-01'
host: management.azure.com
schemes:
  - https
consumes:
  - application/json
produces:
  - application/json
security:
  - azure_auth:
      - user_impersonation
securityDefinitions:
  azure_auth:
    type: oauth2
    authorizationUrl: https://login.microsoftonline.com/common/oauth2/authorize
    flow: implicit
    description: Azure Active Directory OAuth2 Flow
    scopes:
      user_impersonation: impersonate your user account
paths:
  /subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/communityGalleries/{publicGalleryName}:
    get:
      tags:
        - CommunityGalleries
      operationId: microsoftAzureCommunitygalleriesGet
      description: Get a community gallery by gallery public name.
      parameters:
        - $ref: '#/parameters/SubscriptionIdParameter'
        - $ref: '#/parameters/LocationNameParameter'
        - $ref: '#/parameters/PublicGalleryNameParameter'
        - $ref: '#/parameters/ApiVersionParameter'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/CommunityGallery'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/CloudError'
      x-ms-examples:
        Get a gallery.:
          $ref: ./examples/communityGallery/GetACommunityGallery.json
      summary: >-
        Microsoft Azure Get Subscriptions Subscriptionid Providers Microsoft Compute Locations Location Communitygalleries Publicgalleryname
  ? /subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/communityGalleries/{publicGalleryName}/images/{galleryImageName}
  : get:
      tags:
        - CommunityGalleryImages
      operationId: microsoftAzureCommunitygalleryimagesGet
      description: Get a community gallery image.
      parameters:
        - $ref: '#/parameters/SubscriptionIdParameter'
        - $ref: '#/parameters/LocationNameParameter'
        - $ref: '#/parameters/ApiVersionParameter'
        - $ref: '#/parameters/PublicGalleryNameParameter'
        - $ref: '#/parameters/GalleryImageNameParameter'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/CommunityGalleryImage'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/CloudError'
      x-ms-examples:
        Get a gallery.:
          $ref: ./examples/communityGallery/GetACommunityGalleryImage.json
      summary: >-
        Microsoft Azure Get Subscriptions Subscriptionid Providers Microsoft Compute Locations Location Communitygalleries Publicgalleryname Images Galleryimagename
  ? /subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/communityGalleries/{publicGalleryName}/images/{galleryImageName}/versions/{galleryImageVersionName}
  : get:
      tags:
        - CommunityGalleryImageVersions
      operationId: microsoftAzureCommunitygalleryimageversionsGet
      description: Get a community gallery image version.
      parameters:
        - $ref: '#/parameters/SubscriptionIdParameter'
        - $ref: '#/parameters/LocationNameParameter'
        - $ref: '#/parameters/ApiVersionParameter'
        - $ref: '#/parameters/PublicGalleryNameParameter'
        - $ref: '#/parameters/GalleryImageNameParameter'
        - $ref: '#/parameters/GalleryImageVersionNameParameter'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/CommunityGalleryImageVersion'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/CloudError'
      x-ms-examples:
        Get a gallery.:
          $ref: ./examples/communityGallery/GetACommunityGalleryImageVersion.json
      summary: >-
        Microsoft Azure Get Subscriptions Subscriptionid Providers Microsoft Compute Locations Location Communitygalleries Publicgalleryname Images Galleryimagename Versions Galleryimageversionname
definitions:
  PirCommunityGalleryResource:
    properties:
      name:
        readOnly: true
        type: string
        description: Resource name
      location:
        readOnly: true
        type: string
        description: Resource location
      type:
        readOnly: true
        type: string
        description: Resource type
      identifier:
        x-ms-client-flatten: true
        $ref: '#/definitions/CommunityGalleryIdentifier'
    description: Base information about the community gallery resource in pir.
  CommunityGalleryIdentifier:
    properties:
      uniqueId:
        type: string
        description: The unique id of this community gallery.
    description: The identifier information of community gallery.
  CommunityGallery:
    properties: {}
    allOf:
      - $ref: '#/definitions/PirCommunityGalleryResource'
    description: >-
      Specifies information about the Community Gallery that you want to create
      or update.
  CommunityGalleryImage:
    properties:
      properties:
        x-ms-client-flatten: true
        $ref: '#/definitions/CommunityGalleryImageProperties'
    allOf:
      - $ref: '#/definitions/PirCommunityGalleryResource'
    description: >-
      Specifies information about the gallery image definition that you want to
      create or update.
  CommunityGalleryImageProperties:
    properties:
      osType:
        type: string
        description: >-
          This property allows you to specify the type of the OS that is
          included in the disk when creating a VM from a managed image. <br><br>
          Possible values are: <br><br> **Windows** <br><br> **Linux**
        enum:
          - Windows
          - Linux
        x-ms-enum:
          name: OperatingSystemTypes
          modelAsString: false
      osState:
        type: string
        description: >-
          This property allows the user to specify whether the virtual machines
          created under this image are 'Generalized' or 'Specialized'.
        enum:
          - Generalized
          - Specialized
        x-ms-enum:
          name: OperatingSystemStateTypes
          modelAsString: false
      endOfLifeDate:
        type: string
        format: date-time
        description: >-
          The end of life date of the gallery image definition. This property
          can be used for decommissioning purposes. This property is updatable.
      identifier:
        $ref: '#/definitions/GalleryImageIdentifier'
      recommended:
        $ref: '#/definitions/RecommendedMachineConfiguration'
      disallowed:
        $ref: '#/definitions/Disallowed'
      hyperVGeneration:
        type: string
        description: >-
          The hypervisor generation of the Virtual Machine. Applicable to OS
          disks only.
        enum:
          - V1
          - V2
        x-ms-enum:
          name: HyperVGeneration
          modelAsString: true
      features:
        type: array
        items:
          $ref: '#/definitions/GalleryImageFeature'
        x-ms-identifiers:
          - name
        description: A list of gallery image features.
      purchasePlan:
        $ref: '#/definitions/ImagePurchasePlan'
    required:
      - osType
      - osState
      - identifier
    description: Describes the properties of a gallery image definition.
  GalleryImageFeature:
    properties:
      name:
        type: string
        description: The name of the gallery image feature.
      value:
        type: string
        description: The value of the gallery image feature.
    description: A feature for gallery image.
  GalleryImageIdentifier:
    properties:
      publisher:
        type: string
        description: The name of the gallery image definition publisher.
      offer:
        type: string
        description: The name of the gallery image definition offer.
      sku:
        type: string
        description: The name of the gallery image definition SKU.
    required:
      - publisher
      - offer
      - sku
    description: This is the gallery image definition identifier.
  RecommendedMachineConfiguration:
    properties:
      vCPUs:
        $ref: '#/definitions/ResourceRange'
      memory:
        $ref: '#/definitions/ResourceRange'
    description: >-
      The properties describe the recommended machine configuration for this
      Image Definition. These properties are updatable.
  ResourceRange:
    properties:
      min:
        type: integer
        format: int32
        description: The minimum number of the resource.
      max:
        type: integer
        format: int32
        description: The maximum number of the resource.
    description: Describes the resource range.
  Disallowed:
    properties:
      diskTypes:
        type: array
        items:
          type: string
        description: A list of disk types.
    description: Describes the disallowed disk types.
  ImagePurchasePlan:
    properties:
      name:
        type: string
        description: The plan ID.
      publisher:
        type: string
        description: The publisher ID.
      product:
        type: string
        description: The product ID.
    description: >-
      Describes the gallery image definition purchase plan. This is used by
      marketplace images.
  CommunityGalleryImageVersion:
    properties:
      properties:
        x-ms-client-flatten: true
        $ref: '#/definitions/CommunityGalleryImageVersionProperties'
    allOf:
      - $ref: '#/definitions/PirCommunityGalleryResource'
    description: >-
      Specifies information about the gallery image version that you want to
      create or update.
  CommunityGalleryImageVersionProperties:
    properties:
      publishedDate:
        type: string
        format: date-time
        description: >-
          The published date of the gallery image version Definition. This
          property can be used for decommissioning purposes. This property is
          updatable.
      endOfLifeDate:
        type: string
        format: date-time
        description: >-
          The end of life date of the gallery image version Definition. This
          property can be used for decommissioning purposes. This property is
          updatable.
    description: Describes the properties of a gallery image version.
  CloudError:
    x-ms-external: true
    properties:
      error:
        $ref: '#/definitions/ApiError'
    description: An error response from the Compute service.
  ApiError:
    properties:
      details:
        type: array
        items:
          $ref: '#/definitions/ApiErrorBase'
        x-ms-identifiers:
          - message
          - target
        description: The Api error details
      innererror:
        $ref: '#/definitions/InnerError'
        description: The Api inner error
      code:
        type: string
        description: The error code.
      target:
        type: string
        description: The target of the particular error.
      message:
        type: string
        description: The error message.
    description: Api error.
  ApiErrorBase:
    properties:
      code:
        type: string
        description: The error code.
      target:
        type: string
        description: The target of the particular error.
      message:
        type: string
        description: The error message.
    description: Api error base.
  InnerError:
    properties:
      exceptiontype:
        type: string
        description: The exception type.
      errordetail:
        type: string
        description: The internal error message or exception dump.
    description: Inner error details.
parameters:
  SubscriptionIdParameter:
    name: subscriptionId
    in: path
    required: true
    type: string
    description: >-
      Subscription credentials which uniquely identify Microsoft Azure
      subscription. The subscription ID forms part of the URI for every service
      call.
  LocationNameParameter:
    name: location
    in: path
    required: true
    type: string
    x-ms-parameter-location: method
    description: Resource location.
  PublicGalleryNameParameter:
    name: publicGalleryName
    in: path
    required: true
    type: string
    x-ms-parameter-location: method
    description: The public name of the community gallery.
  GalleryImageNameParameter:
    name: galleryImageName
    in: path
    required: true
    type: string
    x-ms-parameter-location: method
    description: The name of the community gallery image definition.
  GalleryImageVersionNameParameter:
    name: galleryImageVersionName
    in: path
    required: true
    type: string
    x-ms-parameter-location: method
    description: >-
      The name of the community gallery image version. Needs to follow semantic
      version name pattern: The allowed characters are digit and period. Digits
      must be within the range of a 32-bit integer. Format:
      <MajorVersion>.<MinorVersion>.<Patch>
  ApiVersionParameter:
    name: api-version
    in: query
    required: true
    type: string
    description: Client Api Version.
tags:
  - name: CommunityGalleries
  - name: CommunityGalleryImages
  - name: CommunityGalleryImageVersions