swagger: '2.0'
info:
  version: 2020-08-01-preview
  title: Microsoft Azure AccessControlClient AccessConnector Changes API
schemes:
- https
tags:
- name: Changes
paths:
  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ChangeAnalysis/changes:
    get:
      tags:
      - Changes
      summary: Microsoft Azure List The Changes Of A Resource Group Within The Specified Time Range Customer Data Will Always Be Masked
      operationId: microsoftAzureChangesListchangesbyresourcegroup
      parameters:
      - $ref: ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter
      - $ref: '#/parameters/StartTimeParameter'
      - $ref: '#/parameters/EndTimeParameter'
      - $ref: '#/parameters/SkipTokenParameter'
      - $ref: '#/parameters/FilterParameter'
      responses:
        '200':
          description: The request was successful; the request was well-formed and received properly.
          schema:
            $ref: '#/definitions/ChangeList'
        default:
          description: Error response describing why the operation failed
          schema:
            $ref: ../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse
      x-ms-pageable:
        nextLinkName: nextLink
      x-ms-examples:
        Changes_ListChangesByResourceGroupFiltered:
          $ref: ./examples/ChangesListChangesByResourceGroupFiltered.json
      description: Needs a more full description created.
  /subscriptions/{subscriptionId}/providers/Microsoft.ChangeAnalysis/changes:
    get:
      tags:
      - Changes
      summary: Microsoft Azure List The Changes Of A Subscription Within The Specified Time Range Customer Data Will Always Be Masked
      operationId: microsoftAzureChangesListchangesbysubscription
      parameters:
      - $ref: ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter
      - $ref: '#/parameters/StartTimeParameter'
      - $ref: '#/parameters/EndTimeParameter'
      - $ref: '#/parameters/SkipTokenParameter'
      - $ref: '#/parameters/FilterParameter'
      responses:
        '200':
          description: The request was successful; the request was well-formed and received properly.
          schema:
            $ref: '#/definitions/ChangeList'
        default:
          description: Error response describing why the operation failed
          schema:
            $ref: ../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse
      x-ms-pageable:
        nextLinkName: nextLink
      x-ms-examples:
        Changes_ListChangesBySubscriptionFiltered:
          $ref: ./examples/ChangesListChangesBySubscriptionFiltered.json
      description: Needs a more full description created.
definitions:
  Change:
    description: The detected change.
    type: object
    allOf:
    - $ref: ../../../../../common-types/resource-management/v2/types.json#/definitions/ProxyResource
    properties:
      properties:
        $ref: '#/definitions/ChangeProperties'
  PropertyChange:
    description: Data of a property change.
    type: object
    properties:
      changeType:
        $ref: '#/definitions/ChangeType'
      changeCategory:
        description: The change category.
        enum:
        - User
        - System
        type: string
        x-ms-enum:
          name: ChangeCategory
          modelAsString: false
      jsonPath:
        description: The json path of the changed property.
        type: string
      displayName:
        description: The enhanced display name of the json path. E.g., the json path value[0].properties will be translated to something meaningful like slots["Staging"].properties.
        type: string
      level:
        $ref: '#/definitions/Level'
      description:
        description: The description of the changed property.
        type: string
      oldValue:
        description: The value of the property before the change.
        type: string
      newValue:
        description: The value of the property after the change.
        type: string
      isDataMasked:
        description: The boolean indicating whether the oldValue and newValue are masked. The values are masked if it contains sensitive information that the user doesn't have access to.
        type: boolean
  ChangeProperties:
    description: The properties of a change.
    type: object
    properties:
      resourceId:
        description: The resource id that the change is attached to.
        type: string
      timeStamp:
        format: date-time
        description: The time when the change is detected.
        type: string
      initiatedByList:
        description: "The list of identities who might initiated the change.\r\nThe identity could be user name (email address) or the object ID of the Service Principal."
        type: array
        items:
          type: string
      changeType:
        $ref: '#/definitions/ChangeType'
      propertyChanges:
        description: The list of detailed changes at json property level.
        type: array
        items:
          $ref: '#/definitions/PropertyChange'
  ChangeType:
    description: The type of the change.
    enum:
    - Add
    - Remove
    - Update
    type: string
    x-ms-enum:
      name: ChangeType
      modelAsString: true
  ChangeList:
    description: The list of detected changes.
    type: object
    properties:
      value:
        description: The list of changes.
        type: array
        items:
          $ref: '#/definitions/Change'
      nextLink:
        description: The URI that can be used to request the next page of changes.
        type: string
  Level:
    enum:
    - Noisy
    - Normal
    - Important
    type: string
    x-ms-enum:
      name: Level
      modelAsString: true
parameters:
  SkipTokenParameter:
    in: query
    name: $skipToken
    description: A skip token is used to continue retrieving items after an operation returns a partial result. If a previous response contains a nextLink element, the value of the nextLink element will include a skipToken parameter that specifies a starting point to use for subsequent calls.
    type: string
    x-ms-parameter-location: method
  FilterParameter:
    name: $filter
    in: query
    type: string
    required: false
    description: 'Reduces the set of data collected.<br>This argument is not required. Only accepts ''resourceId'' and ''resourceType'' and only accepts the following patterns. <br>- *List changes for a resource type*: $filter=resourceType eq ''microsoft.web/sites''.<br>- *List changes for multiple resource types:* $filter=resourceType eq ''microsoft.web/sites,microsoft.compute/virtualmachines''.<br> - *List changes for a resource Id*: $filter=resourceId eq ''{resourceId}''.<br>- *List changes for multiple resource Ids:* $filter=resourceId eq ''{resourceId1},{resourceId2}}''.'
    x-ms-parameter-location: method
  StartTimeParameter:
    in: query
    name: $startTime
    description: Specifies the start time of the changes request.
    required: true
    type: string
    format: date-time
    x-ms-parameter-location: method
  EndTimeParameter:
    in: query
    name: $endTime
    description: Specifies the end time of the changes request.
    required: true
    type: string
    format: date-time
    x-ms-parameter-location: method
x-ms-parameterized-host:
  hostTemplate: '{endpoint}'
  useSchemePrefix: false
  parameters:
  - $ref: '#/parameters/Endpoint'