Microsoft Azure ConfigurationsV1Dot1Preview1 API

openapi: 3.2.0
info:
  version: 2020-08-01-preview
  title: Microsoft Azure AccessControlClient AccessConnector Configurations V1 Dot1 Preview1 API
  description: Manages configuration operations.
tags:
- name: ConfigurationsV1Dot1Preview1
  description: Manages configuration operations.
paths:
  /configurations/service:
    get:
      tags:
      - ConfigurationsV1Dot1Preview1
      summary: Microsoft Azure Get Service Configuration
      description: Get the Personalizer service configuration.
      operationId: microsoftAzureServiceconfigurationGet
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceConfiguration'
      x-ms-examples:
        Successful ServiceConfiguration_Get request:
          $ref: ./examples/ServiceConfiguration_Get.json
    put:
      tags:
      - ConfigurationsV1Dot1Preview1
      summary: Microsoft Azure Update Service Configuration
      description: Update the Personalizer service configuration.
      operationId: microsoftAzureServiceconfigurationUpdate
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceConfiguration'
        default:
          description: Updating defaultReward, rewardWaitTime and rewardAggregation when changing learning mode from Online to Apprentice mode and vice versa is not allowed. Make the mode change and then change the additional settings with an additional API call.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-ms-examples:
        Successful ServiceConfiguration_Update request:
          $ref: ./examples/ServiceConfiguration_Update.json
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ServiceConfiguration'
        description: The personalizer service configuration.
        required: true
  /configurations/policy:
    get:
      tags:
      - ConfigurationsV1Dot1Preview1
      summary: Microsoft Azure Get Policy
      description: Get the Learning Settings currently used by the Personalizer service.
      operationId: microsoftAzurePolicyGet
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyContract'
      x-ms-examples:
        Successful Policy_Get request:
          $ref: ./examples/Policy_Get.json
    put:
      tags:
      - ConfigurationsV1Dot1Preview1
      summary: Microsoft Azure Update Policy
      description: Update the Learning Settings that the Personalizer service will use to train models.
      operationId: microsoftAzurePolicyUpdate
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyContract'
        default:
          description: Invalid policy configuration.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-ms-examples:
        Successful Policy_Update request:
          $ref: ./examples/Policy_Update.json
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PolicyContract'
        description: The learning settings.
        required: true
    delete:
      tags:
      - ConfigurationsV1Dot1Preview1
      summary: Microsoft Azure Reset Policy
      description: Resets the learning settings of the Personalizer service to default.
      operationId: microsoftAzurePolicyReset
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyContract'
      x-ms-examples:
        Successful Policy_Reset request:
          $ref: ./examples/Policy_Reset.json
  /configurations/applyFromEvaluation:
    post:
      tags:
      - ConfigurationsV1Dot1Preview1
      summary: Microsoft Azure Apply Learning Settings And Model From A Pre Existing Offline Evaluation, Making Them The Current Online Learning Settings And Model And Replacing The Previous Ones
      operationId: microsoftAzureServiceconfigurationApplyfromevaluation
      responses:
        '204':
          description: Success
        default:
          description: Learning Settings not found in evaluation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-ms-examples:
        Successful ServiceConfiguration_ApplyFromEvaluation request:
          $ref: ./examples/ServiceConfiguration_ApplyFromEvaluation.json
      description: Needs a more full description created.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PolicyReferenceContract'
        description: Reference to the policy within the evaluation.
        required: true
components:
  schemas:
    ErrorResponse:
      description: Used to return an error to the client
      required:
      - error
      type: object
      properties:
        error:
          $ref: '#/components/schemas/PersonalizerError'
    PersonalizerError:
      description: The error object.
      required:
      - code
      - message
      type: object
      properties:
        code:
          description: Error Codes returned by Personalizer
          enum:
          - BadRequest
          - InvalidServiceConfiguration
          - InvalidLearningModeServiceConfiguration
          - InvalidPolicyConfiguration
          - InvalidPolicyContract
          - InvalidEvaluationContract
          - DuplicateCustomPolicyNames
          - NoLogsExistInDateRange
          - LogsSizeExceedAllowedLimit
          - InvalidRewardRequest
          - InvalidEventIdToActivate
          - InvalidRankRequest
          - InvalidExportLogsRequest
          - InvalidRequest
          - InvalidContainer
          - InvalidModelMetadata
          - ApprenticeModeNeverTurnedOn
          - MissingAppId
          - InvalidRewardWaitTime
          - InvalidMultiSlotApiAccess
          - ModelFileAccessDenied
          - ProblemTypeIncompatibleWithAutoOptimization
          - ResourceNotFound
          - FrontEndNotFound
          - EvaluationNotFound
          - LearningSettingsNotFound
          - EvaluationModelNotFound
          - LogsPropertiesNotFound
          - ModelRankingError
          - InternalServerError
          - RankNullResponse
          - UpdateConfigurationFailed
          - ModelResetFailed
          - ModelPublishFailed
          - ModelMetadataUpdateFailed
          - OperationNotAllowed
          type: string
          x-ms-enum:
            name: PersonalizerErrorCode
            modelAsString: true
            values:
            - value: BadRequest
              description: Request could not be understood by the server.
            - value: InvalidServiceConfiguration
              description: Invalid service configuration.
            - value: InvalidLearningModeServiceConfiguration
              description: Updating defaultReward, rewardWaitTime and rewardAggregation when changing learning mode from Online to Apprentice mode and vice versa is not allowed. Make the mode change and then change the additional settings with an additional API call.
            - value: InvalidPolicyConfiguration
              description: Invalid policy configuration.
            - value: InvalidPolicyContract
              description: Invalid policy contract.
            - value: InvalidEvaluationContract
              description: Invalid evaluation contract.
            - value: DuplicateCustomPolicyNames
              description: Custom policy names should be unique.
            - value: NoLogsExistInDateRange
              description: No logs exist in date range.
            - value: LogsSizeExceedAllowedLimit
              description: Total size of logs exceed allowed limit.
            - value: InvalidRewardRequest
              description: Invalid reward request.
            - value: InvalidEventIdToActivate
              description: Invalid activate event request.
            - value: InvalidRankRequest
              description: Invalid request.
            - value: InvalidExportLogsRequest
              description: Invalid request.
            - value: InvalidRequest
              description: Invalid request.
            - value: InvalidContainer
              description: SAS Uri must be the Uri to a container that has write permissions.
            - value: InvalidModelMetadata
              description: Invalid model metadata.
            - value: ApprenticeModeNeverTurnedOn
              description: Apprentice mode never turned on.
            - value: MissingAppId
              description: AppId is missing in the header.
            - value: InvalidRewardWaitTime
              description: Reward wait time should be between 5 seconds and 2 days
            - value: InvalidMultiSlotApiAccess
              description: Multi-slot feature is currently disabled. Please follow multi-slot Personalizer documentation to update your loop settings to enable multi-slot functionality.
            - value: ModelFileAccessDenied
              description: Key vault Key used for customer managed key cannot be accessed.
            - value: ProblemTypeIncompatibleWithAutoOptimization
              description: Auto-optimization is not compatible with multi-slot personalization.
            - value: ResourceNotFound
              description: Requested resource does not exist on the server.
            - value: FrontEndNotFound
              description: Front end not found.
            - value: EvaluationNotFound
              description: Offline Evaluation not found.
            - value: LearningSettingsNotFound
              description: Learning Settings not found in evaluation.
            - value: EvaluationModelNotFound
              description: Model not found in evaluation.
            - value: LogsPropertiesNotFound
              description: Log properties not found.
            - value: ModelRankingError
              description: Error while ranking actions using model. Please verify the learning settings are valid.
            - value: InternalServerError
              description: A generic error has occurred on the server.
            - value: RankNullResponse
              description: Rank call returned null response.
            - value: UpdateConfigurationFailed
              description: Failed to update configuration.
            - value: ModelResetFailed
              description: Model reset failed.
            - value: ModelPublishFailed
              description: Model publish failed.
            - value: ModelMetadataUpdateFailed
              description: Model metadata update failed.
            - value: OperationNotAllowed
              description: This operation is not allowed at this time.
        message:
          description: A message explaining the error reported by the service.
          type: string
        target:
          description: Error source element.
          type: string
        details:
          description: An array of details about specific errors that led to this reported error.
          type: array
          items:
            $ref: '#/components/schemas/PersonalizerError'
        innerError:
          $ref: '#/components/schemas/InternalError'
    InternalError:
      description: An object containing more specific information than the parent object about the error.
      type: object
      properties:
        code:
          description: Detailed error code.
          type: string
        innererror:
          $ref: '#/components/schemas/InternalError'
    PolicyContract:
      description: Learning settings specifying how to train the model.
      required:
      - name
      - arguments
      type: object
      properties:
        name:
          description: Name of the learning settings.
          maxLength: 256
          type: string
        arguments:
          description: Arguments of the learning settings.
          maxLength: 1024
          type: string
    ServiceConfiguration:
      description: The configuration of the service.
      required:
      - rewardWaitTime
      - defaultReward
      - rewardAggregation
      - explorationPercentage
      - modelExportFrequency
      - logRetentionDays
      type: object
      properties:
        rewardWaitTime:
          format: duration
          description: 'The time span waited until a request is marked with the default reward

            and should be between 5 seconds and 2 days.

            For example, PT5M (5 mins). For information about the time format,

            see http://en.wikipedia.org/wiki/ISO_8601#Durations'
          type: string
        defaultReward:
          format: float
          description: The reward given if a reward is not received within the specified wait time.
          maximum: 1
          minimum: -1
          type: number
        rewardAggregation:
          description: The function used to process rewards, if multiple reward scores are received before rewardWaitTime is over.
          maxLength: 256
          type: string
        explorationPercentage:
          format: float
          description: The percentage of rank responses that will use exploration.
          maximum: 1
          minimum: 0
          type: number
        modelExportFrequency:
          format: duration
          description: 'Personalizer will start using the most updated trained model for online ranks automatically every specified time period.

            For example, PT5M (5 mins). For information about the time format,

            see http://en.wikipedia.org/wiki/ISO_8601#Durations'
          type: string
        logMirrorEnabled:
          description: Flag indicates whether log mirroring is enabled.
          type: boolean
        logMirrorSasUri:
          description: Azure storage account container SAS URI for log mirroring.
          type: string
        logRetentionDays:
          format: int32
          description: Number of days historical logs are to be maintained. -1 implies the logs will never be deleted.
          maximum: 2147483647
          minimum: -1
          type: integer
        lastConfigurationEditDate:
          format: date-time
          description: Last time model training configuration was updated
          type: string
        learningMode:
          description: Learning Modes for Personalizer
          enum:
          - Online
          - Apprentice
          - LoggingOnly
          type: string
          x-ms-enum:
            name: LearningMode
            modelAsString: true
        isAutoOptimizationEnabled:
          description: Flag indicating whether Personalizer will automatically optimize Learning Settings by running Offline Evaluations periodically.
          type: boolean
        autoOptimizationFrequency:
          format: duration
          description: 'Frequency of automatic optimization. Only relevant if IsAutoOptimizationEnabled is true.

            For example, PT5M (5 mins). For information about the time format,

            \r\nsee http://en.wikipedia.org/wiki/ISO_8601#Durations'
          type: string
        autoOptimizationStartDate:
          format: date-time
          description: Date when the first automatic optimization evaluation must be performed. Only relevant if IsAutoOptimizationEnabled is true.
          type: string
    PolicyReferenceContract:
      description: Reference to the policy within the evaluation.
      required:
      - evaluationId
      - policyName
      type: object
      properties:
        evaluationId:
          description: Evaluation Id of the evaluation.
          maxLength: 256
          type: string
        policyName:
          description: Name of the learning settings.
          maxLength: 256
          type: string
x-ms-parameterized-host:
  hostTemplate: '{endpoint}'
  useSchemePrefix: false
  parameters:
  - $ref: '#/components/parameters/Endpoint'