swagger: '2.0'
info:
  version: 2020-08-01-preview
  title: Microsoft Azure AccessControlClient AccessConnector InsightAttachments API
schemes:
- https
tags:
- name: InsightAttachments
paths:
  /parties/{partyId}/models/{modelId}/resource-types/{resourceType}/resources/{resourceId}/insight-attachments:
    get:
      tags:
      - InsightAttachments
      description: Returns a paginated list of insight resources.
      operationId: microsoftAzureInsightattachmentsListbypartyidmodelidandresource
      produces:
      - application/json
      parameters:
      - in: path
        name: partyId
        description: Id of the associated party.
        required: true
        type: string
      - in: path
        name: modelId
        description: Id of the associated model.
        required: true
        type: string
      - in: path
        name: resourceType
        description: Resource type associated with the record.
        required: true
        type: string
      - in: path
        name: resourceId
        description: Id of the associated resource.
        required: true
        type: string
      - in: query
        name: insightIds
        description: List of insight IDs.
        type: array
        items:
          type: string
        collectionFormat: multi
      - in: query
        name: ids
        description: Ids of the resource.
        type: array
        items:
          type: string
        collectionFormat: multi
      - in: query
        name: names
        description: Names of the resource.
        type: array
        items:
          type: string
        collectionFormat: multi
      - in: query
        name: propertyFilters
        description: "Filters on key-value pairs within the Properties object.\r\neg. \"{testKey} eq {testValue}\"."
        type: array
        items:
          type: string
        collectionFormat: multi
      - in: query
        name: statuses
        description: Statuses of the resource.
        type: array
        items:
          type: string
        collectionFormat: multi
      - in: query
        name: minCreatedDateTime
        description: Minimum creation date of resource (inclusive).
        type: string
        format: date-time
      - in: query
        name: maxCreatedDateTime
        description: Maximum creation date of resource (inclusive).
        type: string
        format: date-time
      - in: query
        name: minLastModifiedDateTime
        description: Minimum last modified date of resource (inclusive).
        type: string
        format: date-time
      - in: query
        name: maxLastModifiedDateTime
        description: Maximum last modified date of resource (inclusive).
        type: string
        format: date-time
      - 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
      - in: query
        name: skipToken
        description: Skip token for getting next set of results.
        type: string
      - in: query
        name: api-version
        description: The requested API version
        required: true
        type: string
      responses:
        '200':
          description: Success
          schema:
            $ref: '#/definitions/InsightAttachmentListResponse'
        default:
          description: Error
          schema:
            $ref: '#/definitions/ErrorResponse'
          headers:
            x-ms-error-code:
              type: string
              x-ms-client-name: ErrorCode
          x-ms-error-response: true
      x-ms-pageable:
        nextLinkName: nextLink
      x-ms-examples:
        InsightAttachments_ListByPartyIdModelIdAndResource:
          $ref: ./examples/InsightAttachments_ListByPartyIdModelIdAndResource.json
      summary: Microsoft Azure Get Parties Partyid Models Modelid Resource Types Resourcetype Resources Resourceid Insight Attachments
  ? /parties/{partyId}/models/{modelId}/resource-types/{resourceType}/resources/{resourceId}/insight-attachments/{insightAttachmentId}
  : patch:
      tags:
      - InsightAttachments
      description: Creates or updates insight entity.
      operationId: microsoftAzureInsightattachmentsCreateorupdate
      consumes:
      - multipart/form-data
      produces:
      - application/json
      parameters:
      - in: path
        name: partyId
        description: Id of the associated party.
        required: true
        type: string
      - in: path
        name: modelId
        description: "Id of the associated model.\r\nIt can be either 'BiomassModelId', 'SensorPlacementModelId', 'SoilMoistureModelId' or any solution id."
        required: true
        type: string
      - in: path
        name: resourceType
        description: Resource type associated with the record.
        required: true
        type: string
      - in: path
        name: resourceId
        description: Id of the associated resource.
        required: true
        type: string
      - in: path
        name: insightAttachmentId
        description: Id of the insight resource.
        required: true
        type: string
      - in: query
        name: api-version
        description: The requested API version
        required: true
        type: string
      - in: formData
        name: file
        type: file
        format: binary
        description: File to be uploaded.
      - in: formData
        name: insightId
        description: InsightID for this InsightAttachment.
        required: true
        type: string
      - in: formData
        name: originalFileName
        description: Original File Name for this attachment.
        type: string
      - in: formData
        name: id
        description: Unique id.
        type: string
      - in: formData
        name: status
        description: Status of the resource.
        type: string
        maxLength: 100
        minLength: 0
      - in: formData
        name: createdDateTime
        description: Date when resource was created.
        type: string
        format: date-time
      - in: formData
        name: modifiedDateTime
        description: Date when resource was last modified.
        type: string
        format: date-time
      - in: formData
        name: source
        description: Source of the resource.
        type: string
        maxLength: 100
        minLength: 2
      - in: formData
        name: name
        description: Name to identify resource.
        type: string
        maxLength: 100
        minLength: 0
      - in: formData
        name: description
        description: Textual description of resource.
        type: string
        maxLength: 500
        minLength: 0
      - in: formData
        name: createdBy
        description: Created by user/tenant id.
        type: string
      - in: formData
        name: modifiedBy
        description: Modified by user/tenant id.
        type: string
      responses:
        '200':
          description: Success
          schema:
            $ref: '#/definitions/InsightAttachment'
        '201':
          description: Created
          schema:
            $ref: '#/definitions/InsightAttachment'
        default:
          description: Error
          schema:
            $ref: '#/definitions/ErrorResponse'
          headers:
            x-ms-error-code:
              type: string
              x-ms-client-name: ErrorCode
          x-ms-error-response: true
      x-ms-examples:
        InsightAttachments_CreateOrUpdate:
          $ref: ./examples/InsightAttachments_CreateOrUpdate.json
      summary: Microsoft Azure Patch Parties Partyid Models Modelid Resource Types Resourcetype Resources Resourceid Insight Attachments Insightattachmentid
    get:
      tags:
      - InsightAttachments
      description: Gets a specified insight resource under a particular party.
      operationId: microsoftAzureInsightattachmentsGet
      produces:
      - application/json
      parameters:
      - in: path
        name: partyId
        description: Id of the associated party.
        required: true
        type: string
      - in: path
        name: modelId
        description: "Id of the associated model.\r\nIt can be either 'BiomassModelId', 'SensorPlacementModelId', 'SoilMoistureModelId' or any solution id."
        required: true
        type: string
      - in: path
        name: resourceType
        description: Resource type associated with the record.
        required: true
        type: string
      - in: path
        name: resourceId
        description: Id of the associated resource.
        required: true
        type: string
      - in: path
        name: insightAttachmentId
        description: Id of the insight attachment resource.
        required: true
        type: string
      - in: query
        name: api-version
        description: The requested API version
        required: true
        type: string
      responses:
        '200':
          description: Success
          schema:
            $ref: '#/definitions/InsightAttachment'
        default:
          description: Error
          schema:
            $ref: '#/definitions/ErrorResponse'
          headers:
            x-ms-error-code:
              type: string
              x-ms-client-name: ErrorCode
          x-ms-error-response: true
      x-ms-examples:
        InsightAttachments_Get:
          $ref: ./examples/InsightAttachments_Get.json
      summary: Microsoft Azure Get Parties Partyid Models Modelid Resource Types Resourcetype Resources Resourceid Insight Attachments Insightattachmentid
    delete:
      tags:
      - InsightAttachments
      description: Deletes a specified insight resource.
      operationId: microsoftAzureInsightattachmentsDelete
      produces:
      - application/json
      parameters:
      - in: path
        name: partyId
        description: Id of the associated party.
        required: true
        type: string
      - in: path
        name: modelId
        description: "Id of the associated model.\r\nIt can be either 'BiomassModelId', 'SensorPlacementModelId', 'SoilMoistureModelId' or any solution id."
        required: true
        type: string
      - in: path
        name: resourceType
        description: Resource type associated with the record.
        required: true
        type: string
      - in: path
        name: resourceId
        description: Id of the associated resource.
        required: true
        type: string
      - in: path
        name: insightAttachmentId
        description: Id of the insight attachment resource.
        required: true
        type: string
      - in: query
        name: api-version
        description: The requested API version
        required: true
        type: string
      responses:
        '204':
          description: No Content
        default:
          description: Error
          schema:
            $ref: '#/definitions/ErrorResponse'
          headers:
            x-ms-error-code:
              type: string
              x-ms-client-name: ErrorCode
          x-ms-error-response: true
      x-ms-examples:
        InsightAttachments_Delete:
          $ref: ./examples/InsightAttachments_Delete.json
      summary: Microsoft Azure Delete Parties Partyid Models Modelid Resource Types Resourcetype Resources Resourceid Insight Attachments Insightattachmentid
  ? /parties/{partyId}/models/{modelId}/resource-types/{resourceType}/resources/{resourceId}/insight-attachments/{insightAttachmentId}/file
  : get:
      tags:
      - InsightAttachments
      description: Downloads and returns insight-attachment as response for the given input filePath.
      operationId: microsoftAzureInsightattachmentsDownload
      produces:
      - application/json
      - application/octet-stream
      parameters:
      - in: path
        name: partyId
        description: Id of the associated party.
        required: true
        type: string
      - in: path
        name: modelId
        description: "Id of the associated model.\r\nIt can be either 'BiomassModelId', 'SensorPlacementModelId', 'SoilMoistureModelId' or any solution id."
        required: true
        type: string
      - in: path
        name: resourceType
        description: Resource type associated with the record.
        required: true
        type: string
      - in: path
        name: resourceId
        description: Id of the associated resource.
        required: true
        type: string
      - in: path
        name: insightAttachmentId
        description: Id of the insight attachment resource.
        required: true
        type: string
      - in: query
        name: api-version
        description: The requested API version
        required: true
        type: string
      responses:
        '200':
          description: Success
          schema:
            format: binary
            type: file
        default:
          description: Error
          schema:
            $ref: '#/definitions/ErrorResponse'
          headers:
            x-ms-error-code:
              type: string
              x-ms-client-name: ErrorCode
          x-ms-error-response: true
      x-ms-examples:
        InsightAttachments_Download:
          $ref: ./examples/InsightAttachments_Download.json
      summary: Microsoft Azure Get Parties Partyid Models Modelid Resource Types Resourcetype Resources Resourceid Insight Attachments Insightattachmentid File
definitions:
  ErrorResponse:
    description: An error response from the Azure AgPlatform service. See https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses for ErrorResponse reference document.
    type: object
    properties:
      error:
        $ref: '#/definitions/Error'
      traceId:
        description: Unique trace Id.
        type: string
  InsightAttachment:
    description: Schema of insight attachment resource.
    required:
    - insightId
    type: object
    properties:
      insightId:
        description: InsightID for this InsightAttachment.
        minLength: 1
        type: string
      modelId:
        description: ModelID for this InsightAttachment.
        type: string
        readOnly: true
      resourceType:
        description: Associated Resource type for this attachment.
        enum:
        - Party
        - Farm
        - Field
        - SeasonalField
        - Boundary
        type: string
        readOnly: true
        x-ms-enum:
          name: FarmHierarchyResourceType
          modelAsString: true
      resourceId:
        description: Associated Resource id for this attachment.
        type: string
        readOnly: true
      originalFileName:
        description: Original File Name for this attachment.
        type: string
        readOnly: true
      partyId:
        description: PartyId id for this attachment.
        type: string
        readOnly: true
      id:
        description: Unique id.
        type: string
        readOnly: true
      status:
        description: Status of the resource.
        maxLength: 100
        minLength: 0
        type: string
      createdDateTime:
        format: date-time
        description: Date when resource was created.
        type: string
        readOnly: true
      modifiedDateTime:
        format: date-time
        description: Date when resource was last modified.
        type: string
        readOnly: true
      source:
        description: Source of the resource.
        maxLength: 100
        minLength: 2
        type: string
      name:
        description: Name to identify resource.
        maxLength: 100
        minLength: 0
        type: string
      description:
        description: Textual description of resource.
        maxLength: 500
        minLength: 0
        type: string
      createdBy:
        description: Created by user/tenant id.
        type: string
        readOnly: true
      modifiedBy:
        description: Modified by user/tenant id.
        type: string
        readOnly: true
      eTag:
        description: The ETag value to implement optimistic concurrency.
        type: string
        readOnly: true
  InsightAttachmentListResponse:
    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/InsightAttachment'
      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
  InnerError:
    description: Inner error containing list of errors.See https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object for InnerError reference document.
    type: object
    properties:
      code:
        description: Specific error code than was provided by the containing error.
        type: string
      innererror:
        $ref: '#/definitions/InnerError'
  Error:
    description: An error from the Azure AgPlatform service.
    required:
    - code
    - message
    type: object
    properties:
      code:
        description: Server-defined set of error codes.
        minLength: 1
        type: string
      message:
        description: Human-readable representation of the error.
        minLength: 1
        type: string
      target:
        description: Target of the error.
        type: string
      details:
        description: Array of details about specific errors that led to this reported error.
        type: array
        items:
          $ref: '#/definitions/Error'
      innererror:
        $ref: '#/definitions/InnerError'
x-ms-parameterized-host:
  hostTemplate: '{endpoint}'
  useSchemePrefix: false
  parameters:
  - $ref: '#/parameters/Endpoint'