swagger: '2.0'
info:
  version: 2020-08-01-preview
  title: Microsoft Azure AccessControlClient AccessConnector IscsiServers API
schemes:
- https
tags:
- name: IscsiServers
paths:
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/iscsiservers
  : get:
      tags:
      - IscsiServers
      description: Retrieves all the iSCSI in a device.
      operationId: microsoftAzureIscsiserversListbydevice
      consumes:
      - application/json
      produces:
      - application/json
      parameters:
      - name: deviceName
        in: path
        description: The device name.
        required: true
        type: string
      - $ref: '#/parameters/subscriptionIdParameter'
      - $ref: '#/parameters/resourceGroupNameParameter'
      - $ref: '#/parameters/managerNameParameter'
      - $ref: '#/parameters/apiVersionParameter'
      responses:
        '200':
          description: The collection of iSCSI servers.
          schema:
            $ref: '#/definitions/ISCSIServerList'
        default:
          description: Default Response. It will be deserialized as per the Error definition specified in the schema. Exception will be thrown.
          schema:
            $ref: '#/definitions/Error'
      deprecated: false
      x-ms-pageable:
        nextLinkName: null
      x-ms-examples:
        IscsiServersListByDevice:
          $ref: ./examples/IscsiServersListByDevice.json
      summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Storsimple Managers Managername Devices Devicename Iscsiservers
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/iscsiservers/{iscsiServerName}
  : get:
      tags:
      - IscsiServers
      description: Returns the properties of the specified iSCSI server name.
      operationId: microsoftAzureIscsiserversGet
      consumes:
      - application/json
      produces:
      - application/json
      parameters:
      - name: deviceName
        in: path
        description: The device name.
        required: true
        type: string
      - name: iscsiServerName
        in: path
        description: The iSCSI server name.
        required: true
        type: string
      - $ref: '#/parameters/subscriptionIdParameter'
      - $ref: '#/parameters/resourceGroupNameParameter'
      - $ref: '#/parameters/managerNameParameter'
      - $ref: '#/parameters/apiVersionParameter'
      responses:
        '200':
          description: The iSCSI server.
          schema:
            $ref: '#/definitions/ISCSIServer'
        default:
          description: Default Response. It will be deserialized as per the Error definition specified in the schema. Exception will be thrown.
          schema:
            $ref: '#/definitions/Error'
      deprecated: false
      x-ms-examples:
        IscsiServersGet:
          $ref: ./examples/IscsiServersGet.json
      summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Storsimple Managers Managername Devices Devicename Iscsiservers Iscsiservername
    put:
      tags:
      - IscsiServers
      description: Creates or updates the iSCSI server.
      operationId: microsoftAzureIscsiserversCreateorupdate
      consumes:
      - application/json
      produces:
      - application/json
      parameters:
      - name: deviceName
        in: path
        description: The device name.
        required: true
        type: string
      - name: iscsiServerName
        in: path
        description: The iSCSI server name.
        required: true
        type: string
      - name: iscsiServer
        in: body
        description: The iSCSI server.
        required: true
        schema:
          $ref: '#/definitions/ISCSIServer'
      - $ref: '#/parameters/subscriptionIdParameter'
      - $ref: '#/parameters/resourceGroupNameParameter'
      - $ref: '#/parameters/managerNameParameter'
      - $ref: '#/parameters/apiVersionParameter'
      responses:
        '200':
          description: Successfully created or updated the iSCSI server.
          schema:
            $ref: '#/definitions/ISCSIServer'
        '202':
          description: Accepted the request to create or update the iSCSI server.
        default:
          description: Default Response. It will be deserialized as per the Error definition specified in the schema. Exception will be thrown.
          schema:
            $ref: '#/definitions/Error'
      deprecated: false
      x-ms-long-running-operation: true
      x-ms-examples:
        IscsiServersCreateOrUpdate:
          $ref: ./examples/IscsiServersCreateOrUpdate.json
      summary: Microsoft Azure Put Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Storsimple Managers Managername Devices Devicename Iscsiservers Iscsiservername
    delete:
      tags:
      - IscsiServers
      description: Deletes the iSCSI server.
      operationId: microsoftAzureIscsiserversDelete
      consumes:
      - application/json
      produces:
      - application/json
      parameters:
      - name: deviceName
        in: path
        description: The device name.
        required: true
        type: string
      - name: iscsiServerName
        in: path
        description: The iSCSI server name.
        required: true
        type: string
      - $ref: '#/parameters/subscriptionIdParameter'
      - $ref: '#/parameters/resourceGroupNameParameter'
      - $ref: '#/parameters/managerNameParameter'
      - $ref: '#/parameters/apiVersionParameter'
      responses:
        '202':
          description: Accepted the request to delete the iSCSI server.
        '204':
          description: Successfully deleted the iSCSI server.
        default:
          description: Default Response. It will be deserialized as per the Error definition specified in the schema. Exception will be thrown.
          schema:
            $ref: '#/definitions/Error'
      deprecated: false
      x-ms-long-running-operation: true
      x-ms-examples:
        IscsiServersDelete:
          $ref: ./examples/IscsiServersDelete.json
      summary: Microsoft Azure Delete Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Storsimple Managers Managername Devices Devicename Iscsiservers Iscsiservername
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/iscsiservers/{iscsiServerName}/backup
  : post:
      tags:
      - IscsiServers
      description: Backup the iSCSI server now.
      operationId: microsoftAzureIscsiserversBackupnow
      consumes:
      - application/json
      produces:
      - application/json
      parameters:
      - name: deviceName
        in: path
        description: The device name.
        required: true
        type: string
      - name: iscsiServerName
        in: path
        description: The iSCSI server name.
        required: true
        type: string
      - $ref: '#/parameters/subscriptionIdParameter'
      - $ref: '#/parameters/resourceGroupNameParameter'
      - $ref: '#/parameters/managerNameParameter'
      - $ref: '#/parameters/apiVersionParameter'
      responses:
        '202':
          description: Accepted the request to backup the iSCSI server.
        '204':
          description: Successfully completed backup of the iSCSI server.
        default:
          description: Default Response. It will be deserialized as per the Error definition specified in the schema. Exception will be thrown.
          schema:
            $ref: '#/definitions/Error'
      deprecated: false
      x-ms-long-running-operation: true
      x-ms-examples:
        IscsiServersBackupNow:
          $ref: ./examples/IscsiServersBackupNow.json
      summary: Microsoft Azure Post Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Storsimple Managers Managername Devices Devicename Iscsiservers Iscsiservername Backup
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/iscsiservers/{iscsiServerName}/metrics
  : get:
      tags:
      - IscsiServers
      description: Gets the iSCSI server metrics
      operationId: microsoftAzureIscsiserversListmetrics
      consumes:
      - application/json
      produces:
      - application/json
      parameters:
      - name: deviceName
        in: path
        description: The device name.
        required: true
        type: string
      - name: iscsiServerName
        in: path
        description: The iSCSI server name.
        required: true
        type: string
      - $ref: '#/parameters/subscriptionIdParameter'
      - $ref: '#/parameters/resourceGroupNameParameter'
      - $ref: '#/parameters/managerNameParameter'
      - $ref: '#/parameters/apiVersionParameter'
      - name: $filter
        in: query
        description: OData Filter options
        required: false
        type: string
      responses:
        '200':
          description: The collection of metrics.
          schema:
            $ref: '#/definitions/MetricList'
        default:
          description: Default Response. It will be deserialized as per the Error definition specified in the schema. Exception will be thrown.
          schema:
            $ref: '#/definitions/Error'
      deprecated: false
      x-ms-odata: '#/definitions/MetricFilter'
      x-ms-pageable:
        nextLinkName: null
      x-ms-examples:
        IscsiServersListMetrics:
          $ref: ./examples/IscsiServersListMetrics.json
      summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Storsimple Managers Managername Devices Devicename Iscsiservers Iscsiservername Metrics
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/iscsiservers/{iscsiServerName}/metricsDefinitions
  : get:
      tags:
      - IscsiServers
      description: Retrieves metric definitions for all metrics aggregated at iSCSI server.
      operationId: microsoftAzureIscsiserversListmetricdefinition
      consumes:
      - application/json
      produces:
      - application/json
      parameters:
      - name: deviceName
        in: path
        description: The device name.
        required: true
        type: string
      - name: iscsiServerName
        in: path
        description: The iSCSI server name.
        required: true
        type: string
      - $ref: '#/parameters/subscriptionIdParameter'
      - $ref: '#/parameters/resourceGroupNameParameter'
      - $ref: '#/parameters/managerNameParameter'
      - $ref: '#/parameters/apiVersionParameter'
      responses:
        '200':
          description: The collection of metric definitions.
          schema:
            $ref: '#/definitions/MetricDefinitionList'
        default:
          description: Default Response. It will be deserialized as per the Error definition specified in the schema. Exception will be thrown.
          schema:
            $ref: '#/definitions/Error'
      deprecated: false
      x-ms-pageable:
        nextLinkName: null
      x-ms-examples:
        IscsiServersListMetricDefinition:
          $ref: ./examples/IscsiServersListMetricDefinition.json
      summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Storsimple Managers Managername Devices Devicename Iscsiservers Iscsiservername Metricsdefinitions
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/iscsiservers
  : get:
      tags:
      - IscsiServers
      description: Retrieves all the iSCSI servers in a manager.
      operationId: microsoftAzureIscsiserversListbymanager
      consumes:
      - application/json
      produces:
      - application/json
      parameters:
      - $ref: '#/parameters/subscriptionIdParameter'
      - $ref: '#/parameters/resourceGroupNameParameter'
      - $ref: '#/parameters/managerNameParameter'
      - $ref: '#/parameters/apiVersionParameter'
      responses:
        '200':
          description: The collection of iSCSI servers.
          schema:
            $ref: '#/definitions/ISCSIServerList'
        default:
          description: Default Response. It will be deserialized as per the Error definition specified in the schema. Exception will be thrown.
          schema:
            $ref: '#/definitions/Error'
      deprecated: false
      x-ms-pageable:
        nextLinkName: null
      x-ms-examples:
        IscsiServersListByManager:
          $ref: ./examples/IscsiServersListByManager.json
      summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Storsimple Managers Managername Iscsiservers
definitions:
  MetricDefinition:
    description: Monitoring metric definition represents the metadata of the metrics.
    required:
    - name
    - unit
    - primaryAggregationType
    - resourceId
    - metricAvailabilities
    - dimensions
    - type
    type: object
    properties:
      name:
        $ref: '#/definitions/MetricName'
        description: The metric name
      unit:
        description: The metric unit
        enum:
        - Bytes
        - BytesPerSecond
        - Count
        - CountPerSecond
        - Percent
        - Seconds
        type: string
        x-ms-enum:
          name: MetricUnit
          modelAsString: false
      primaryAggregationType:
        description: The metric aggregation type
        enum:
        - Average
        - Last
        - Maximum
        - Minimum
        - None
        - Total
        type: string
        x-ms-enum:
          name: MetricAggregationType
          modelAsString: false
      resourceId:
        description: The metric source id
        type: string
      metricAvailabilities:
        description: The available metric granularities
        type: array
        items:
          $ref: '#/definitions/MetricAvailablity'
        x-ms-identifiers:
        - timeGrain
      dimensions:
        description: The supported dimensions
        type: array
        items:
          $ref: '#/definitions/MetricDimension'
        x-ms-identifiers:
        - name
      type:
        description: The metric definition type
        type: string
  MetricDefinitionList:
    description: List of metric definition
    required:
    - value
    type: object
    properties:
      value:
        description: The list of metric definition
        type: array
        items:
          $ref: '#/definitions/MetricDefinition'
        x-ms-identifiers:
        - name
  ISCSIServerProperties:
    description: The iSCSI server properties.
    required:
    - storageDomainId
    - backupScheduleGroupId
    type: object
    properties:
      storageDomainId:
        description: The storage domain id.
        type: string
      backupScheduleGroupId:
        description: The backup policy id.
        type: string
      description:
        description: The description.
        type: string
      chapId:
        description: The chap id.
        type: string
      reverseChapId:
        description: The reverse chap id.
        type: string
  MetricDimension:
    description: Metric dimension
    required:
    - name
    - value
    type: object
    properties:
      name:
        description: Metric dimension name
        type: string
      value:
        description: Metric dimension values
        type: string
  BaseModel:
    description: Base class for models
    type: object
    properties:
      id:
        description: The identifier.
        type: string
        readOnly: true
      name:
        description: The name.
        type: string
        readOnly: true
      type:
        description: The type.
        type: string
        readOnly: true
  Item:
    required:
    - key
    - value
    type: object
    properties:
      key:
        type: string
      value:
        type: string
  MetricData:
    description: The metric data.
    required:
    - timeStamp
    - sum
    - count
    - average
    - minimum
    - maximum
    type: object
    properties:
      timeStamp:
        format: date-time
        description: The time when the metric data is fetched
        type: string
      sum:
        format: double
        description: The sum of all the samples available in the given instance of time for the specific metric data
        type: number
      count:
        format: int32
        description: The count of samples of the metric data available for the given instance
        type: integer
      average:
        format: double
        description: The average of all sample for the given instance
        type: number
      minimum:
        format: double
        description: The minimum of all samples available
        type: number
      maximum:
        format: double
        description: The maximum of all samples available
        type: number
  Metrics:
    description: Monitoring metric
    required:
    - resourceId
    - startTime
    - endTime
    - timeGrain
    - primaryAggregation
    - name
    - dimensions
    - unit
    - type
    - values
    type: object
    properties:
      resourceId:
        description: The id of metric source
        type: string
      startTime:
        format: date-time
        description: The metric start time
        type: string
      endTime:
        format: date-time
        description: The metric end time
        type: string
      timeGrain:
        description: The time grain, time grain indicates frequency of the metric data
        type: string
      primaryAggregation:
        description: The metric aggregation type
        enum:
        - Average
        - Last
        - Maximum
        - Minimum
        - None
        - Total
        type: string
        x-ms-enum:
          name: MetricAggregationType
          modelAsString: false
      name:
        $ref: '#/definitions/MetricName'
        description: The name of the metrics
      dimensions:
        description: The Metric dimension which indicates the source of the metric
        type: array
        items:
          $ref: '#/definitions/MetricDimension'
        x-ms-identifiers:
        - name
      unit:
        description: The unit of the metric data
        enum:
        - Bytes
        - BytesPerSecond
        - Count
        - CountPerSecond
        - Percent
        - Seconds
        type: string
        x-ms-enum:
          name: MetricUnit
          modelAsString: false
      type:
        description: The Type of the metric data
        type: string
      values:
        description: The metric data
        type: array
        items:
          $ref: '#/definitions/MetricData'
        x-ms-identifiers:
        - timeStamp
  Message:
    type: object
    properties:
      language:
        type: string
      value:
        type: string
  MetricAvailablity:
    description: Metric availability specifies the time grain (aggregation interval or frequency) and the retention period for that time grain
    required:
    - timeGrain
    - retention
    type: object
    properties:
      timeGrain:
        description: The time grain, specifies the aggregation interval for the metric.
        type: string
      retention:
        description: The retention period for the metric at the specified timegrain
        type: string
  MetricList:
    description: Collection of metrics
    required:
    - value
    type: object
    properties:
      value:
        description: The value.
        type: array
        items:
          $ref: '#/definitions/Metrics'
        x-ms-identifiers: []
  Error:
    required:
    - errorCode
    - message
    type: object
    properties:
      errorCode:
        type: string
      message:
        $ref: '#/definitions/Message'
      values:
        type: array
        items:
          $ref: '#/definitions/Item'
        x-ms-identifiers:
        - key
  MetricName:
    description: The name of the metric
    required:
    - value
    - localizedValue
    type: object
    properties:
      value:
        description: Name of the metric
        type: string
      localizedValue:
        description: Localized name of the metric
        type: string
  ISCSIServerList:
    description: Collection of Iscsi servers
    required:
    - value
    type: object
    properties:
      value:
        description: The value.
        type: array
        items:
          $ref: '#/definitions/ISCSIServer'
  ISCSIServer:
    description: The iSCSI server.
    required:
    - properties
    type: object
    allOf:
    - $ref: '#/definitions/BaseModel'
    properties:
      properties:
        $ref: '#/definitions/ISCSIServerProperties'
        description: The properties.
        x-ms-client-flatten: true
parameters:
  resourceGroupNameParameter:
    name: resourceGroupName
    in: path
    description: The resource group name
    required: true
    type: string
    x-ms-parameter-location: method
  managerNameParameter:
    name: managerName
    in: path
    description: The manager name
    required: true
    type: string
    maxLength: 50
    minLength: 2
    x-ms-parameter-location: method
  apiVersionParameter:
    name: api-version
    in: query
    description: The api version
    required: true
    type: string
  subscriptionIdParameter:
    name: subscriptionId
    in: path
    description: The subscription id
    required: true
    type: string
x-ms-parameterized-host:
  hostTemplate: '{endpoint}'
  useSchemePrefix: false
  parameters:
  - $ref: '#/parameters/Endpoint'