swagger: '2.0'
info:
  version: 2020-08-01-preview
  title: Microsoft Azure AccessControlClient AccessConnector sensitivitySettings API
schemes:
- https
tags:
- name: sensitivitySettings
paths:
  /providers/Microsoft.Security/sensitivitySettings/current:
    put:
      tags:
      - sensitivitySettings
      description: Create or update data sensitivity settings for sensitive data discovery
      operationId: microsoftAzureSensitivitysettingsCreateorupdate
      parameters:
      - $ref: ../../../common/v1/types.json#/parameters/ApiVersion
      - in: body
        name: sensitivitySettings
        description: The data sensitivity settings to update
        required: true
        schema:
          $ref: '#/definitions/UpdateSensitivitySettingsRequest'
      responses:
        '200':
          description: Success of the sensitivity settings update
          schema:
            $ref: '#/definitions/GetSensitivitySettingsResponse'
        default:
          description: Error response describing why the operation failed
          schema:
            $ref: ../../../common/v1/types.json#/definitions/CloudError
      x-ms-examples:
        Update sensitivity settings:
          $ref: ./examples/SensitivitySettings/PutSensitivitySettings_example.json
      summary: Microsoft Azure Put Providers Microsoft Security Sensitivitysettings Current
    get:
      tags:
      - sensitivitySettings
      description: Gets data sensitivity settings for sensitive data discovery
      operationId: microsoftAzureSensitivitysettingsGet
      parameters:
      - $ref: ../../../common/v1/types.json#/parameters/ApiVersion
      responses:
        '200':
          description: Success of the sensitivity settings get
          schema:
            $ref: '#/definitions/GetSensitivitySettingsResponse'
        default:
          description: Error response describing why the operation failed
          schema:
            $ref: ../../../common/v1/types.json#/definitions/CloudError
      x-ms-examples:
        Get sensitivity settings:
          $ref: ./examples/SensitivitySettings/GetSensitivitySettings_example.json
      summary: Microsoft Azure Get Providers Microsoft Security Sensitivitysettings Current
definitions:
  GetSensitivitySettingsResponse:
    x-ms-azure-resource: true
    type: object
    description: Data sensitivity settings for sensitive data discovery
    properties:
      id:
        type: string
        description: The ID of the sensitivity settings
        readOnly: true
      type:
        type: string
        description: The type of the sensitivity settings
        readOnly: true
      name:
        type: string
        description: The name of the sensitivity settings
        readOnly: true
      properties:
        type: object
        description: The sensitivity settings properties
        properties:
          sensitiveInfoTypesIds:
            $ref: '#/definitions/SensitiveInfoTypesIds'
          sensitivityThresholdLabelOrder:
            type: number
            description: The order of the sensitivity threshold label. Any label at or above this order will be considered sensitive. If set to -1, sensitivity by labels is turned off
          sensitivityThresholdLabelId:
            type: string
            description: The id of the sensitivity threshold label. Any label at or above this rank will be considered sensitive.
            format: uuid
          mipInformation:
            description: Microsoft information protection built-in and custom information types, labels, and integration status.
            type: object
            properties:
              mipIntegrationStatus:
                $ref: '#/definitions/MipIntegrationStatus'
              labels:
                $ref: '#/definitions/Labels'
              customInfoTypes:
                description: List of custom user-defined information types
                type: array
                items:
                  $ref: '#/definitions/InfoType'
              builtInInfoTypes:
                description: List of pre-configured sensitive information types
                type: array
                items:
                  $ref: '#/definitions/BuiltInInfoType'
  MipIntegrationStatus:
    type: string
    description: Microsoft information protection integration status
    enum:
    - Ok
    - noConsent
    - noAutoLabelingRules
    - noMipLabels
    x-ms-enum:
      name: MipIntegrationStatus
      modelAsString: true
  UpdateSensitivitySettingsRequest:
    description: Request to update data sensitivity settings for sensitive data discovery
    type: object
    properties:
      sensitiveInfoTypesIds:
        $ref: '#/definitions/SensitiveInfoTypesIds'
      sensitivityThresholdLabelOrder:
        type: number
        description: The order of the sensitivity threshold label. Any label at or above this order will be considered sensitive. If set to -1, sensitivity by labels is turned off
      sensitivityThresholdLabelId:
        type: string
        description: The id of the sensitivity threshold label. Any label at or above this rank will be considered sensitive.
        format: uuid
    required:
    - sensitiveInfoTypesIds
  BuiltInInfoType:
    description: Pre-configured sensitive information type
    type: object
    properties:
      name:
        description: Display name of the info type
        type: string
      id:
        description: Id of the info type
        type: string
        format: uuid
      type:
        description: Category of the built-in info type
        type: string
  InfoType:
    type: object
    description: Custom user-defined information type
    properties:
      name:
        description: Display name of the info type
        type: string
      id:
        description: Id of the info type
        type: string
        format: uuid
      description:
        description: Description of the info type
        type: string
  SensitiveInfoTypesIds:
    description: List of selected sensitive info types' IDs.
    type: array
    items:
      type: string
      format: uuid
  Label:
    description: Microsoft information protection sensitivity label
    type: object
    properties:
      name:
        type: string
        description: The display name of the label
      id:
        type: string
        description: The ID of the label
        format: uuid
      order:
        type: number
        description: Labels are ordered by sensitivity level. The higher the order of the label, the more sensitive it is.
  Labels:
    description: List of Microsoft information protection sensitivity labels
    type: array
    items:
      $ref: '#/definitions/Label'
x-ms-parameterized-host:
  hostTemplate: '{endpoint}'
  useSchemePrefix: false
  parameters:
  - $ref: '#/parameters/Endpoint'