swagger: '2.0'
info:
  version: 2020-08-01-preview
  title: Microsoft Azure AccessControlClient AccessConnector DataManagerForAgricultureExtensions API
schemes:
- https
tags:
- name: DataManagerForAgricultureExtensions
paths:
  /providers/Microsoft.AgFoodPlatform/farmBeatsExtensionDefinitions:
    get:
      tags:
      - DataManagerForAgricultureExtensions
      description: Get list of Data Manager For Agriculture extension.
      operationId: microsoftAzureDatamanagerforagricultureextensionsList
      produces:
      - application/json
      parameters:
      - in: query
        name: farmBeatsExtensionIds
        description: DataManagerForAgricultureExtension ids.
        type: array
        items:
          type: string
        collectionFormat: multi
      - in: query
        name: farmBeatsExtensionNames
        description: DataManagerForAgriculture extension names.
        type: array
        items:
          type: string
        collectionFormat: multi
      - in: query
        name: extensionCategories
        description: Extension categories.
        type: array
        items:
          type: string
        collectionFormat: multi
      - in: query
        name: publisherIds
        description: Publisher ids.
        type: array
        items:
          type: string
        collectionFormat: multi
      - in: query
        name: $maxPageSize
        description: "Maximum number of items needed (inclusive).\r\nMinimum = 10, Maximum = 1000, Default value = 50."
        type: integer
        format: int32
        default: 50
        maximum: 1000
        minimum: 10
      - $ref: ../../../../../common-types/resource-management/v4/types.json#/parameters/ApiVersionParameter
      responses:
        '200':
          description: Success
          schema:
            $ref: '#/definitions/DataManagerForAgricultureExtensionListResponse'
        default:
          description: Error
          schema:
            $ref: ../../../../../common-types/resource-management/v4/types.json#/definitions/ErrorResponse
      x-ms-pageable:
        nextLinkName: nextLink
      x-ms-examples:
        DataManagerForAgricultureExtensions_List:
          $ref: ./examples/DataManagerForAgricultureExtensions_List.json
      summary: Microsoft Azure Get Providers Microsoft Agfoodplatform Farmbeatsextensiondefinitions
  /providers/Microsoft.AgFoodPlatform/farmBeatsExtensionDefinitions/{dataManagerForAgricultureExtensionId}:
    get:
      tags:
      - DataManagerForAgricultureExtensions
      description: Get Data Manager For Agriculture extension.
      operationId: microsoftAzureDatamanagerforagricultureextensionsGet
      produces:
      - application/json
      parameters:
      - in: path
        name: dataManagerForAgricultureExtensionId
        description: dataManagerForAgricultureExtensionId to be queried.
        required: true
        type: string
        pattern: ^[a-zA-Z]{3,50}[.][a-zA-Z]{3,100}$
      - $ref: ../../../../../common-types/resource-management/v4/types.json#/parameters/ApiVersionParameter
      responses:
        '200':
          description: Success
          schema:
            $ref: '#/definitions/DataManagerForAgricultureExtension'
        default:
          description: Error
          schema:
            $ref: ../../../../../common-types/resource-management/v4/types.json#/definitions/ErrorResponse
      x-ms-examples:
        DataManagerForAgricultureExtensions_Get:
          $ref: ./examples/DataManagerForAgricultureExtensions_Get.json
      summary: Microsoft Azure Get Providers Microsoft Agfoodplatform Farmbeatsextensiondefinitions Datamanagerforagricultureextensionid
definitions:
  DataManagerForAgricultureExtension:
    description: DataManagerForAgriculture extension resource.
    type: object
    allOf:
    - $ref: ../../../../../common-types/resource-management/v4/types.json#/definitions/ProxyResource
    properties:
      systemData:
        $ref: ../../../../../common-types/resource-management/v4/types.json#/definitions/systemData
      properties:
        $ref: '#/definitions/DataManagerForAgricultureExtensionProperties'
    x-ms-azure-resource: true
  UnitSystemsInfo:
    description: Unit systems info for the data provider.
    required:
    - key
    - values
    type: object
    properties:
      key:
        description: UnitSystem key sent as part of ProviderInput.
        maxLength: 100
        minLength: 1
        type: string
      values:
        description: List of unit systems supported by this data provider.
        type: array
        items:
          type: string
  DetailedInformation:
    description: Model to capture detailed information for Data Manager For AgricultureExtensions.
    type: object
    properties:
      apiName:
        description: ApiName available for the Data Manager For Agriculture Extension.
        type: string
        example: dailyforecast, dailyhistorical.
      apiDocsLink:
        description: Extension provider's API documentation link.
        type: string
      apiType:
        description: Type of Api in Extension.
        type: string
        example: passthrough,load.
      customParameters:
        description: List of customParameters.
        type: array
        items:
          type: string
      platformParameters:
        description: List of platformParameters.
        type: array
        items:
          type: string
      apiDefaultInputParameters:
        description: List of defaultParameters.
        type: array
        items:
          type: string
      unitsSupported:
        $ref: '#/definitions/UnitSystemsInfo'
      apiInputParameters:
        description: List of apiInputParameters.
        type: array
        items:
          type: string
  DataManagerForAgricultureExtensionProperties:
    description: DataManagerForAgricultureExtension properties.
    type: object
    properties:
      targetResourceType:
        description: Target ResourceType of the Data Manager For Agriculture Extension.
        type: string
        readOnly: true
      farmBeatsExtensionId:
        description: Data Manager For Agriculture Extension ID.
        maxLength: 100
        minLength: 2
        pattern: ^[a-zA-Z]{3,50}[.][a-zA-Z]{3,100}$
        type: string
        readOnly: true
      farmBeatsExtensionName:
        description: Data Manager For Agriculture Extension name.
        maxLength: 100
        minLength: 2
        type: string
        readOnly: true
      farmBeatsExtensionVersion:
        description: Data Manager For Agriculture Extension version.
        maxLength: 100
        minLength: 2
        pattern: ^([1-9]|10).\d$
        type: string
        readOnly: true
      publisherId:
        description: Publisher ID.
        maxLength: 100
        minLength: 2
        type: string
        readOnly: true
      description:
        description: Textual description.
        maxLength: 500
        minLength: 2
        type: string
        readOnly: true
      extensionCategory:
        description: Category of the extension. e.g. weather/sensor/satellite.
        maxLength: 100
        minLength: 2
        type: string
        readOnly: true
      extensionAuthLink:
        description: Data Manager For Agriculture Extension auth link.
        type: string
        readOnly: true
      extensionApiDocsLink:
        description: Data Manager For Agriculture Extension api docs link.
        type: string
        readOnly: true
      detailedInformation:
        description: "Detailed information which shows summary of requested data.\r\nUsed in descriptive get extension metadata call.\r\nInformation for weather category per api included are apisSupported,\r\ncustomParameters, PlatformParameters and Units supported."
        type: array
        items:
          $ref: '#/definitions/DetailedInformation'
        x-ms-identifiers: []
        readOnly: true
  DataManagerForAgricultureExtensionListResponse:
    description: Paged response contains list of requested objects and a URL link to get the next set of results.
    required:
    - value
    type: object
    properties:
      value:
        description: List of requested objects.
        type: array
        items:
          $ref: '#/definitions/DataManagerForAgricultureExtension'
      $skipToken:
        description: Token used in retrieving the next page. If null, there are no additional pages.
        type: string
      nextLink:
        description: Continuation link (absolute URI) to the next page of results in the list.
        type: string
x-ms-parameterized-host:
  hostTemplate: '{endpoint}'
  useSchemePrefix: false
  parameters:
  - $ref: '#/parameters/Endpoint'