swagger: '2.0'
info:
  version: 2020-08-01-preview
  title: Microsoft Azure AccessControlClient AccessConnector ServerCollectorsOperations API
schemes:
- https
tags:
- name: ServerCollectorsOperations
paths:
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/servercollectors
  : get:
      operationId: microsoftAzureServercollectorsoperationsListbyassessmentproject
      tags:
      - ServerCollectorsOperations
      description: List ServerCollector resources by AssessmentProject
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter
      - name: projectName
        in: path
        description: Assessment Project Name
        required: true
        type: string
        pattern: ^[^<>&:\?/#]{1,260}$
      responses:
        '200':
          description: ARM operation completed successfully.
          schema:
            $ref: '#/definitions/ServerCollectorListResult'
        default:
          description: An unexpected error response.
          schema:
            $ref: ../../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse
      x-ms-pageable:
        nextLinkName: nextLink
      x-ms-examples:
        ServerCollectorsOperations_ListByAssessmentProject_MaximumSet_Gen:
          $ref: ./examples/ServerCollectorsOperations_ListByAssessmentProject_MaximumSet_Gen.json
      summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Migrate Assessmentprojects Projectname Servercollectors
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/servercollectors/{serverCollectorName}
  : get:
      operationId: microsoftAzureServercollectorsoperationsGet
      tags:
      - ServerCollectorsOperations
      description: Get a ServerCollector
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter
      - name: projectName
        in: path
        description: Assessment Project Name
        required: true
        type: string
        pattern: ^[^<>&:\?/#]{1,260}$
      - name: serverCollectorName
        in: path
        description: Physical server collector ARM name
        required: true
        type: string
        pattern: ^[^<>&:\?/#]{1,260}$
      responses:
        '200':
          description: ARM operation completed successfully.
          schema:
            $ref: '#/definitions/ServerCollector'
        default:
          description: An unexpected error response.
          schema:
            $ref: ../../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse
      x-ms-examples:
        ServerCollectorsOperations_Get_MaximumSet_Gen:
          $ref: ./examples/ServerCollectorsOperations_Get_MaximumSet_Gen.json
      summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Migrate Assessmentprojects Projectname Servercollectors Servercollectorname
    put:
      operationId: microsoftAzureServercollectorsoperationsCreate
      tags:
      - ServerCollectorsOperations
      description: Create a ServerCollector
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter
      - name: projectName
        in: path
        description: Assessment Project Name
        required: true
        type: string
        pattern: ^[^<>&:\?/#]{1,260}$
      - name: serverCollectorName
        in: path
        description: Physical server collector ARM name
        required: true
        type: string
        pattern: ^[^<>&:\?/#]{1,260}$
      - name: resource
        in: body
        description: Resource create parameters.
        required: true
        schema:
          $ref: '#/definitions/ServerCollector'
      responses:
        '200':
          description: Resource 'ServerCollector' update operation succeeded
          schema:
            $ref: '#/definitions/ServerCollector'
        '201':
          description: Resource 'ServerCollector' create operation succeeded
          schema:
            $ref: '#/definitions/ServerCollector'
          headers:
            Retry-After:
              type: integer
              format: int32
              description: The Retry-After header can indicate how long the client should wait before polling the operation status.
        default:
          description: An unexpected error response.
          schema:
            $ref: ../../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse
      x-ms-long-running-operation-options:
        final-state-via: azure-async-operation
      x-ms-long-running-operation: true
      x-ms-examples:
        ServerCollectorsOperations_Create_MaximumSet_Gen:
          $ref: ./examples/ServerCollectorsOperations_Create_MaximumSet_Gen.json
      summary: Microsoft Azure Put Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Migrate Assessmentprojects Projectname Servercollectors Servercollectorname
    delete:
      operationId: microsoftAzureServercollectorsoperationsDelete
      tags:
      - ServerCollectorsOperations
      description: Delete a ServerCollector
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter
      - name: projectName
        in: path
        description: Assessment Project Name
        required: true
        type: string
        pattern: ^[^<>&:\?/#]{1,260}$
      - name: serverCollectorName
        in: path
        description: Physical server collector ARM name
        required: true
        type: string
        pattern: ^[^<>&:\?/#]{1,260}$
      responses:
        '200':
          description: Resource deleted successfully.
        '204':
          description: Resource deleted successfully.
        default:
          description: An unexpected error response.
          schema:
            $ref: ../../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse
      x-ms-examples:
        ServerCollectorsOperations_Delete_MaximumSet_Gen:
          $ref: ./examples/ServerCollectorsOperations_Delete_MaximumSet_Gen.json
      summary: Microsoft Azure Delete Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Migrate Assessmentprojects Projectname Servercollectors Servercollectorname
definitions:
  CollectorPropertiesBaseWithAgent:
    type: object
    description: Collector properties class.
    properties:
      agentProperties:
        $ref: '#/definitions/CollectorAgentPropertiesBase'
        description: Gets or sets the collector agent properties.
      discoverySiteId:
        type: string
        description: Gets the discovery site id.
      createdTimestamp:
        type: string
        format: date-time
        description: Gets the Timestamp when collector was created.
        readOnly: true
      updatedTimestamp:
        type: string
        format: date-time
        description: Timestamp when collector was last updated.
        readOnly: true
    allOf:
    - $ref: '#/definitions/AzureResourceProperties'
  ServerCollector:
    type: object
    description: Physical server collector resource.
    properties:
      properties:
        $ref: '#/definitions/CollectorPropertiesBaseWithAgent'
        description: The resource-specific properties for this resource.
        x-ms-client-flatten: true
        x-ms-mutability:
        - read
        - create
    allOf:
    - $ref: ../../../../../../common-types/resource-management/v5/types.json#/definitions/ProxyResource
  CollectorAgentPropertiesBase:
    type: object
    description: Collector agent property class.
    properties:
      id:
        type: string
        description: Gets the collector agent id.
      version:
        type: string
        description: Gets the collector agent version.
      lastHeartbeatUtc:
        type: string
        format: date-time
        description: Gets the collector last heartbeat time.
      spnDetails:
        $ref: '#/definitions/CollectorAgentSpnPropertiesBase'
        description: Gets or sets the SPN details.
  AzureResourceProperties:
    type: object
    description: Common properties for all azure tracked and proxy resources.
    properties:
      provisioningState:
        $ref: '#/definitions/ProvisioningState'
        description: The status of the last operation.
  ProvisioningState:
    type: string
    description: The status of the current operation.
    enum:
    - Succeeded
    - Failed
    - Canceled
    - Provisioning
    - Updating
    - Deleting
    - Accepted
    x-ms-enum:
      name: ProvisioningState
      modelAsString: true
      values:
      - name: Succeeded
        value: Succeeded
        description: Resource has been created.
      - name: Failed
        value: Failed
        description: Resource creation failed.
      - name: Canceled
        value: Canceled
        description: Resource creation was canceled.
      - name: Provisioning
        value: Provisioning
        description: Resource is being Provisioned.
      - name: Updating
        value: Updating
        description: Resource is being Updated.
      - name: Deleting
        value: Deleting
        description: Resource is being Deleted.
      - name: Accepted
        value: Accepted
        description: Resource is being Accepted.
  CollectorAgentSpnPropertiesBase:
    type: object
    description: Collector agent SPN details class.
    properties:
      authority:
        type: string
        description: Gets the AAD authority endpoint.
      applicationId:
        type: string
        description: Gets the AAD application id.
      audience:
        type: string
        description: Gets the AAD audience url.
      objectId:
        type: string
        description: Gets the object id of the AAD application.
      tenantId:
        type: string
        description: Gets the tenant id of the AAD application.
  ServerCollectorListResult:
    type: object
    description: The response of a ServerCollector list operation.
    properties:
      value:
        type: array
        description: The ServerCollector items on this page
        items:
          $ref: '#/definitions/ServerCollector'
      nextLink:
        type: string
        format: uri
        description: The link to the next page of items
    required:
    - value
x-ms-parameterized-host:
  hostTemplate: '{endpoint}'
  useSchemePrefix: false
  parameters:
  - $ref: '#/parameters/Endpoint'