swagger: '2.0'
info:
  version: 2020-08-01-preview
  title: Microsoft Azure AccessControlClient AccessConnector DataStoreDefault API
schemes:
- https
tags:
- name: DataStoreDefault
paths:
  ? /datastore/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/default/{name}
  : put:
      tags:
      - DataStoreDefault
      summary: Microsoft Azure Set A Default Datastore
      description: Set a default Datastore in the workspace.
      operationId: microsoftAzureDatastoresSetdefault
      consumes: []
      produces:
      - application/json
      parameters:
      - $ref: '#/parameters/subscriptionIdParameter'
      - $ref: '#/parameters/resourceGroupNameParameter'
      - $ref: '#/parameters/workspaceNameParameter'
      - name: name
        in: path
        description: The Datastore name.
        required: true
        type: string
      responses:
        '200':
          description: The default Datastore is set successfully.
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/ErrorResponse'
  ? /datastore/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/default
  : get:
      tags:
      - DataStoreDefault
      summary: Microsoft Azure Get The Default Datastore
      description: Get the default Datastore in the workspace.
      operationId: microsoftAzureDatastoresGetdefault
      consumes: []
      produces:
      - application/json
      parameters:
      - $ref: '#/parameters/subscriptionIdParameter'
      - $ref: '#/parameters/resourceGroupNameParameter'
      - $ref: '#/parameters/workspaceNameParameter'
      responses:
        '200':
          description: The default Datastore is returned successfully.
          schema:
            $ref: '#/definitions/DataStore'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/ErrorResponse'
definitions:
  ErrorResponse:
    description: The error response.
    type: object
    properties:
      error:
        $ref: '#/definitions/RootError'
        description: The top level error that occurred.
      correlation:
        description: Dictionary containing correlation details for the error.
        type: object
        additionalProperties:
          type: string
      environment:
        description: The hosting environment.
        type: string
      location:
        description: The Azure region.
        type: string
      time:
        format: date-time
        description: The time in UTC.
        type: string
  AzureSqlDatabase:
    type: object
    properties:
      serverName:
        description: The Azure SQL server name
        type: string
      databaseName:
        description: The Azure SQL database name
        type: string
      endpoint:
        description: The server host endpoint
        type: string
      clientId:
        format: uuid
        description: The Client ID/Application ID
        type: string
      tenantId:
        format: uuid
        description: The ID of the tenant the service principal/app belongs to
        type: string
      isCertAuth:
        description: Is it using certificate to authenticate. If false then use client secret
        type: boolean
      certificate:
        description: The content of the certificate used for authentication
        type: string
      thumbprint:
        description: The thumbprint of the certificate above
        type: string
      clientSecret:
        description: The client secret
        type: string
      authorityUrl:
        description: The authority URL used for authentication
        type: string
      resourceUri:
        description: The resource the service principal/app has access to
        type: string
      subscriptionId:
        format: uuid
        description: Subscription Id
        type: string
      resourceGroup:
        description: Resource Group Name
        type: string
  AzureStorage:
    type: object
    properties:
      accountName:
        description: Storage Account Name
        type: string
      containerName:
        description: The storage container name
        type: string
      endpoint:
        description: The host of the container
        type: string
      protocol:
        description: The protocol to use. Defaults to https
        type: string
      credentialType:
        description: The credential type
        enum:
        - None
        - Sas
        - AccountKey
        - ClientCredentials
        type: string
        x-ms-enum:
          name: AzureStorageCredentialTypes
          modelAsString: false
      credential:
        description: The credential
        type: string
      clientCredentials:
        $ref: '#/definitions/ClientCredentials'
        description: Service principal credential when credential type is Microsoft.MachineLearning.DataStore.Contracts.AzureStorageCredentialTypes.ClientCredentials
      blobCacheTimeout:
        format: int32
        description: If this is an Microsoft.MachineLearning.DataStore.Contracts.DataStoreType.AzureBlob, the length of time (in seconds) to cache files locally after they are accessed (downloaded).
        type: integer
      isSas:
        description: Indicate if we are using SAS token or Account Key (Deprecated)
        type: boolean
      accountKey:
        description: Storage Account Key (Deprecated)
        type: string
      sasToken:
        description: SAS Token for the container (Deprecated)
        type: string
      areWorkspaceManagedIdentitiesAllowed:
        description: Indicate if we are using Workspace ManagedIdentities/MSI token
        type: boolean
      subscriptionId:
        format: uuid
        description: Subscription Id
        type: string
      resourceGroup:
        description: Resource Group Name
        type: string
  ErrorDetails:
    description: The error details.
    type: object
    properties:
      code:
        description: The error code.
        type: string
      message:
        description: The error message.
        type: string
      target:
        description: The target of the error (e.g., the name of the property in error).
        type: string
  AzurePostgreSql:
    type: object
    properties:
      serverName:
        description: The Azure PostgreSQL server name
        type: string
      databaseName:
        description: The Azure PostgreSQL database name
        type: string
      userId:
        description: The Azure PostgreSQL user id
        type: string
      userPassword:
        description: The Azure PostgreSQL user password
        type: string
      portNumber:
        description: The Azure PostgreSQL port number
        type: string
      endpoint:
        description: The Azure PostgreSQL server host endpoint
        type: string
      subscriptionId:
        format: uuid
        description: Subscription Id
        type: string
      resourceGroup:
        description: Resource Group Name
        type: string
  GlusterFs:
    type: object
    properties:
      serverAddress:
        description: "The server address of one of the servers that hosts the GlusterFS. Can be either the IP address\r\nor server name."
        type: string
      volumeName:
        description: The name of the created GlusterFS volume.
        type: string
  RootError:
    description: The root error.
    type: object
    properties:
      code:
        description: 'The service-defined error code. Supported error codes: ServiceError, UserError, ValidationError, AzureStorageError, TransientError, RequestThrottled.'
        type: string
      message:
        description: A human-readable representation of the error.
        type: string
      target:
        description: The target of the error (e.g., the name of the property in error).
        type: string
      details:
        description: The related errors that occurred during the request.
        uniqueItems: false
        type: array
        items:
          $ref: '#/definitions/ErrorDetails'
      innerError:
        $ref: '#/definitions/InnerErrorResponse'
        description: A nested list of inner errors. When evaluating errors, clients MUST traverse through all of the nested “innerErrors” and choose the deepest one that they understand.
  InnerErrorResponse:
    description: A nested structure of errors.
    type: object
    properties:
      code:
        description: The error code.
        type: string
      innerError:
        $ref: '#/definitions/InnerErrorResponse'
        description: A nested list of inner errors. When evaluating errors, clients MUST traverse through all of the nested “innerErrors” and choose the deepest one that they understand.
  AzureDataLake:
    type: object
    properties:
      storeName:
        description: The Azure Data Lake store name
        type: string
      clientId:
        format: uuid
        description: The Client ID/Application ID
        type: string
      tenantId:
        format: uuid
        description: The ID of the tenant the service principal/app belongs to
        type: string
      isCertAuth:
        description: Is it using certificate to authenticate. If false then use client secret
        type: boolean
      certificate:
        description: The content of the certificate used for authentication
        type: string
      thumbprint:
        description: The thumbprint of the certificate above
        type: string
      clientSecret:
        description: The client secret
        type: string
      authorityUrl:
        description: The authority URL used for authentication
        type: string
      resourceUri:
        description: The resource the service principal/app has access to
        type: string
      subscriptionId:
        format: uuid
        description: Subscription Id
        type: string
      resourceGroup:
        description: Resource Group Name
        type: string
  DataStore:
    type: object
    properties:
      name:
        description: Name of the datastore
        type: string
      dataStoreType:
        description: The Azure storage service this datastore points to.
        enum:
        - AzureBlob
        - AzureFile
        - AzureDataLake
        - AzureSqlDatabase
        - AzurePostgreSql
        - DBFS
        - AzureDataLakeGen2
        - GlusterFs
        type: string
        x-ms-enum:
          name: DataStoreType
          modelAsString: false
      hasBeenValidated:
        description: A read only property that denotes whether the service datastore has been validated with credentials.
        type: boolean
      tags:
        description: Tags to datastore
        type: object
        additionalProperties:
          type: string
      azureStorageSection:
        $ref: '#/definitions/AzureStorage'
        description: Data specific to azure storage
      azureDataLakeSection:
        $ref: '#/definitions/AzureDataLake'
        description: Data Specific to azure data lake
      azureSqlDatabaseSection:
        $ref: '#/definitions/AzureSqlDatabase'
        description: Data specific to azure SQL database
      azurePostgreSqlSection:
        $ref: '#/definitions/AzurePostgreSql'
        description: Data specific to azure PostgreSQL
      glusterFsSection:
        $ref: '#/definitions/GlusterFs'
        description: Data specific to GlusterFS
  ClientCredentials:
    type: object
    properties:
      clientId:
        format: uuid
        description: The Client ID/Application ID
        type: string
      tenantId:
        format: uuid
        description: The ID of the tenant the service principal/app belongs to
        type: string
      isCertAuth:
        description: Is it using certificate to authenticate. If false then use client secret
        type: boolean
      certificate:
        description: The content of the certificate used for authentication
        type: string
      thumbprint:
        description: The thumbprint of the certificate above
        type: string
      clientSecret:
        description: The client secret
        type: string
      authorityUrl:
        description: The authority URL used for authentication
        type: string
      resourceUri:
        description: The resource the service principal/app has access to
        type: string
      subscriptionId:
        format: uuid
        description: Subscription Id
        type: string
      resourceGroup:
        description: Resource Group Name
        type: string
parameters:
  subscriptionIdParameter:
    name: subscriptionId
    in: path
    description: The Azure Subscription ID.
    required: true
    type: string
    format: uuid
    x-ms-parameter-location: method
  resourceGroupNameParameter:
    name: resourceGroupName
    in: path
    description: The Name of the resource group in which the workspace is located.
    required: true
    type: string
    x-ms-parameter-location: method
  workspaceNameParameter:
    name: workspaceName
    in: path
    description: The name of the workspace.
    required: true
    type: string
    x-ms-parameter-location: method
x-ms-parameterized-host:
  hostTemplate: '{endpoint}'
  useSchemePrefix: false
  parameters:
  - $ref: '#/parameters/Endpoint'