Compartir a través de

Áreas de trabajo de Microsoft.MachineLearningServices/connections 2024-10-01

  • Artículo

Definición de recursos de Bicep

El tipo de recurso workspaces/connections se puede implementar con operaciones que tienen como destino:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.MachineLearningServices/workspaces/connections, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.MachineLearningServices/workspaces/connections@2024-10-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    category: 'string'
    expiryTime: 'string'
    isSharedToAll: bool
    metadata: {
      {customized property}: 'string'
    }
    sharedUserList: [
      'string'
    ]
    target: 'string'
    value: 'string'
    valueFormat: 'string'
    authType: 'string'
    // For remaining properties, see WorkspaceConnectionPropertiesV2 objects
  }
}

Objetos WorkspaceConnectionPropertiesV2

Establezca la propiedad authType para especificar el tipo de objeto.

Para AAD, use:

{
  authType: 'AAD'
}

Para AccessKey, use:

{
  authType: 'AccessKey'
  credentials: {
    accessKeyId: 'string'
    secretAccessKey: 'string'
  }
}

Para AccountKey, use:

{
  authType: 'AccountKey'
  credentials: {
    key: 'string'
  }
}

Para ApiKey, use:

{
  authType: 'ApiKey'
  credentials: {
    key: 'string'
  }
}

Para CustomKeys, use:

{
  authType: 'CustomKeys'
  credentials: {
    keys: {
      {customized property}: 'string'
    }
  }
}

Para managedIdentity, use:

{
  authType: 'ManagedIdentity'
  credentials: {
    clientId: 'string'
    resourceId: 'string'
  }
}

Para None, use:

{
  authType: 'None'
}

Para OAuth2, use:

{
  authType: 'OAuth2'
  credentials: {
    authUrl: 'string'
    clientId: 'string'
    clientSecret: 'string'
    developerToken: 'string'
    password: 'string'
    refreshToken: 'string'
    tenantId: 'string'
    username: 'string'
  }
}

Para pat, use:

{
  authType: 'PAT'
  credentials: {
    pat: 'string'
  }
}

Para SAS, use:

{
  authType: 'SAS'
  credentials: {
    sas: 'string'
  }
}

Para ServicePrincipal, use:

{
  authType: 'ServicePrincipal'
  credentials: {
    clientId: 'string'
    clientSecret: 'string'
    tenantId: 'string'
  }
}

Para UsernamePassword, use:

{
  authType: 'UsernamePassword'
  credentials: {
    password: 'string'
    securityToken: 'string'
    username: 'string'
  }
}

Valores de propiedad

AADAuthTypeWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'AAD' (obligatorio)

AccessKeyAuthTypeWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'AccessKey' (obligatorio)
credenciales WorkspaceConnectionAccessKey

AccountKeyAuthTypeWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'AccountKey' (obligatorio)
credenciales WorkspaceConnectionAccountKey

ApiKeyAuthWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'ApiKey' (obligatorio)
credenciales Objeto de clave de API para la credencial de conexión del área de trabajo. WorkspaceConnectionApiKey

CustomKeys

Nombre Descripción Valor
Llaves Diccionario de <cadena> CustomKeys

CustomKeys

Nombre Descripción Valor

CustomKeysWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'CustomKeys' (obligatorio)
credenciales Objeto de credencial de claves personalizadas CustomKeys

ManagedIdentityAuthTypeWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'ManagedIdentity' (obligatorio)
credenciales WorkspaceConnectionManagedIdentity

Microsoft.MachineLearningServices/workspaces/connections

Nombre Descripción Valor
nombre El nombre del recurso cuerda

Restricciones:
Patrón = ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$ (obligatorio)
padre En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario.

Para obtener más información, consulte recurso secundario fuera del recurso primario.		 Nombre simbólico del recurso de tipo: áreas de trabajo
Propiedades WorkspaceConnectionPropertiesV2 (obligatorio)

NoneAuthTypeWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'None' (obligatorio)

OAuth2AuthTypeWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'OAuth2' (obligatorio)
credenciales Se requieren ClientId y ClientSecret. Otras propiedades son opcionales
dependiendo de la implementación de cada proveedor de OAuth2.		 WorkspaceConnectionOAuth2

PATAuthTypeWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'PAT' (obligatorio)
credenciales WorkspaceConnectionPersonalAccessToken

SASAuthTypeWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'SAS' (obligatorio)
credenciales WorkspaceConnectionSharedAccessSignature

ServicePrincipalAuthTypeWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'ServicePrincipal' (obligatorio)
credenciales WorkspaceConnectionServicePrincipal

UsernamePasswordAuthTypeWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'UsernamePassword' (obligatorio)
credenciales WorkspaceConnectionUsernamePassword

WorkspaceConnectionAccessKey

Nombre Descripción Valor
accessKeyId cuerda
secretAccessKey cuerda

WorkspaceConnectionAccountKey

Nombre Descripción Valor
llave cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.

WorkspaceConnectionApiKey

Nombre Descripción Valor
llave cuerda

WorkspaceConnectionManagedIdentity

Nombre Descripción Valor
clientId cuerda
resourceId cuerda

WorkspaceConnectionOAuth2

Nombre Descripción Valor
authUrl Requerido por la categoría de conexión concur cuerda
clientId Id. de cliente con el formato UUID cuerda

Restricciones:
Longitud mínima = 36
Longitud máxima = 36
Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
clientSecret cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
developerToken Requerido por la categoría de conexión GoogleAdWords cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
contraseña cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
refreshToken Requerido por GoogleBigQuery, GoogleAdWords, Hubspot, QuickBooks, Square, Xero, Zoho
donde el usuario necesita desconectar RefreshToken		 cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
tenantId Requerido por las categorías de conexión QuickBooks y Xero cuerda
nombre de usuario Concur, el tipo de concesión accessToken del servidor de autenticación de ServiceNow es "Contraseña".
que requiere UsernamePassword		 cuerda

WorkspaceConnectionPersonalAccessToken

Nombre Descripción Valor
palmadita cuerda

WorkspaceConnectionPropertiesV2

Nombre Descripción Valor
authType Establezca en "AAD" para el tipo AADAuthTypeWorkspaceConnectionProperties. Establezca en "AccessKey" para el tipo AccessKeyAuthTypeWorkspaceConnectionProperties. Establezca en "AccountKey" para el tipo AccountKeyAuthTypeWorkspaceConnectionProperties. Establezca en "ApiKey" para el tipo ApiKeyAuthWorkspaceConnectionProperties. Establezca en "CustomKeys" para el tipo CustomKeysWorkspaceConnectionProperties. Establezca en "ManagedIdentity" para el tipo ManagedIdentityAuthTypeWorkspaceConnectionProperties. Establezca en "None" para el tipo NoneAuthTypeWorkspaceConnectionProperties. Establezca en "OAuth2" para el tipo OAuth2AuthTypeWorkspaceConnectionProperties. Establezca en "PAT" para el tipo PATAuthTypeWorkspaceConnectionProperties. Establezca en "SAS" para el tipo SASAuthTypeWorkspaceConnectionProperties. Establezca en "ServicePrincipal" para el tipo ServicePrincipalAuthTypeWorkspaceConnectionProperties. Establezca en "UsernamePassword" para el tipo UsernamePasswordAuthTypeWorkspaceConnectionProperties. 'AAD'
'AccessKey'
'AccountKey'
'ApiKey'
'CustomKeys'
'ManagedIdentity'
'Ninguno'
'OAuth2'
'PAT'
"SAS"
"ServicePrincipal"
'UsernamePassword' (obligatorio)
categoría Categoría de la conexión 'ADLSGen2'
"AIServices"
"AmazonMws"
'AmazonRdsForOracle'
'AmazonRdsForSqlServer'
"AmazonRedshift"
'AmazonS3Compatible'
'ApiKey'
"AzureBlob"
"AzureDatabricksDeltaLake"
"AzureDataExplorer"
"AzureMariaDb"
"AzureMySqlDb"
"AzureOneLake"
"AzureOpenAI"
"AzurePostgresDb"
"AzureSqlDb"
"AzureSqlMi"
"AzureSynapseAnalytics"
"AzureTableStorage"
'BingLLMSearch'
'Cassandra'
'CognitiveSearch'
'CognitiveService'
'Concur'
'ContainerRegistry'
'CosmosDb'
'CosmosDbMongoDbApi'
'Couchbase'
'CustomKeys'
'Db2'
'Drill'
'Dynamics'
'DynamicsAx'
'DynamicsCrm'
'Elasticsearch'
'Eloqua'
'FileServer'
'FtpServer'
'GenericContainerRegistry'
'GenericHttp'
'GenericRest'
'Git'
'GoogleAdWords'
'GoogleBigQuery'
'GoogleCloudStorage'
'Greenplum'
'Hbase'
"Hdfs"
'Hive'
'Hubspot'
'Impala'
'Informix'
'Jira'
'Magento'
'ManagedOnlineEndpoint'
'MariaDb'
'Marketo'
"MicrosoftAccess"
'MongoDbAtlas'
'MongoDbV2'
'MySql'
'Netezza'
'ODataRest'
'Odbc'
'Office365'
'OpenAI'
'Oracle'
"OracleCloudStorage"
'OracleServiceCloud'
"PayPal"
'Phoenix'
'Pinecone'
'PostgreSql'
"Presto"
"PythonFeed"
"QuickBooks"
"Redis"
'Responsys'
'S3'
"Salesforce"
"SalesforceMarketingCloud"
"SalesforceServiceCloud"
"SapBw"
"SapCloudForCustomer"
"SapEcc"
"SapHana"
"SapOpenHub"
"SapTable"
'Serp'
"Sin servidor"
"ServiceNow"
'Sftp'
'SharePointOnlineList'
'Shopify'
"Copo de nieve"
"Spark"
'SqlServer'
'Cuadrado'
'Sybase'
'Teradata'
'Vertica'
'WebTable'
'Xero'
'Zoho'
expiryTime cuerda
isSharedToAll Bool
metadatos Almacenar metadatos de usuario para esta conexión WorkspaceConnectionPropertiesV2Metadata
sharedUserList string[]
blanco cuerda
valor Detalles del valor de la conexión del área de trabajo. cuerda
valueFormat formato para el valor de conexión del área de trabajo 'JSON'

WorkspaceConnectionPropertiesV2Metadata

Nombre Descripción Valor

WorkspaceConnectionServicePrincipal

Nombre Descripción Valor
clientId cuerda
clientSecret cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
tenantId cuerda

WorkspaceConnectionSharedAccessSignature

Nombre Descripción Valor
Sas cuerda

WorkspaceConnectionUsernamePassword

Nombre Descripción Valor
contraseña cuerda
securityToken Opcional, requerido por conexiones como SalesForce para mayor seguridad además de UsernamePassword cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
nombre de usuario cuerda

Ejemplos de inicio rápido

En los ejemplos de inicio rápido siguientes se implementa este tipo de recurso.

Archivo de Bicep Descripción
configuración básica de Azure AI Studio Este conjunto de plantillas muestra cómo configurar Azure AI Studio con la configuración básica, lo que significa que con el acceso público a Internet habilitado, las claves administradas por Microsoft para el cifrado y la configuración de identidad administrada por Microsoft para el recurso de IA.
configuración básica de Azure AI Studio Este conjunto de plantillas muestra cómo configurar Azure AI Studio con la configuración básica, lo que significa que con el acceso público a Internet habilitado, las claves administradas por Microsoft para el cifrado y la configuración de identidad administrada por Microsoft para el recurso de IA.
configuración básica de Azure AI Studio Este conjunto de plantillas muestra cómo configurar Azure AI Studio con la configuración básica, lo que significa que con el acceso público a Internet habilitado, las claves administradas por Microsoft para el cifrado y la configuración de identidad administrada por Microsoft para el recurso de IA.
red restringida de Azure AI Studio Network Este conjunto de plantillas muestra cómo configurar Azure AI Studio con vínculo privado y salida deshabilitados, mediante claves administradas por Microsoft para el cifrado y la configuración de identidad administrada por Microsoft para el recurso de IA.
red restringida de Azure AI Studio Network Este conjunto de plantillas muestra cómo configurar Azure AI Studio con vínculo privado y salida deshabilitados, mediante claves administradas por Microsoft para el cifrado y la configuración de identidad administrada por Microsoft para el recurso de IA.
Azure AI Studio con la autenticación de id. de Entra de Microsoft Este conjunto de plantillas muestra cómo configurar Azure AI Studio con la autenticación de id. de Entra de Microsoft para recursos dependientes, como Azure AI Services y Azure Storage.
Implementación segura de Azure AI Studio con una red virtual administrada Esta plantilla crea un entorno seguro de Azure AI Studio con restricciones sólidas de seguridad de red e identidad.

Definición de recursos de plantilla de ARM

El tipo de recurso workspaces/connections se puede implementar con operaciones que tienen como destino:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.MachineLearningServices/workspaces/connections, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.MachineLearningServices/workspaces/connections",
  "apiVersion": "2024-10-01",
  "name": "string",
  "properties": {
    "category": "string",
    "expiryTime": "string",
    "isSharedToAll": "bool",
    "metadata": {
      "{customized property}": "string"
    },
    "sharedUserList": [ "string" ],
    "target": "string",
    "value": "string",
    "valueFormat": "string",
    "authType": "string"
    // For remaining properties, see WorkspaceConnectionPropertiesV2 objects
  }
}

Objetos WorkspaceConnectionPropertiesV2

Establezca la propiedad authType para especificar el tipo de objeto.

Para AAD, use:

{
  "authType": "AAD"
}

Para AccessKey, use:

{
  "authType": "AccessKey",
  "credentials": {
    "accessKeyId": "string",
    "secretAccessKey": "string"
  }
}

Para AccountKey, use:

{
  "authType": "AccountKey",
  "credentials": {
    "key": "string"
  }
}

Para ApiKey, use:

{
  "authType": "ApiKey",
  "credentials": {
    "key": "string"
  }
}

Para CustomKeys, use:

{
  "authType": "CustomKeys",
  "credentials": {
    "keys": {
      "{customized property}": "string"
    }
  }
}

Para managedIdentity, use:

{
  "authType": "ManagedIdentity",
  "credentials": {
    "clientId": "string",
    "resourceId": "string"
  }
}

Para None, use:

{
  "authType": "None"
}

Para OAuth2, use:

{
  "authType": "OAuth2",
  "credentials": {
    "authUrl": "string",
    "clientId": "string",
    "clientSecret": "string",
    "developerToken": "string",
    "password": "string",
    "refreshToken": "string",
    "tenantId": "string",
    "username": "string"
  }
}

Para pat, use:

{
  "authType": "PAT",
  "credentials": {
    "pat": "string"
  }
}

Para SAS, use:

{
  "authType": "SAS",
  "credentials": {
    "sas": "string"
  }
}

Para ServicePrincipal, use:

{
  "authType": "ServicePrincipal",
  "credentials": {
    "clientId": "string",
    "clientSecret": "string",
    "tenantId": "string"
  }
}

Para UsernamePassword, use:

{
  "authType": "UsernamePassword",
  "credentials": {
    "password": "string",
    "securityToken": "string",
    "username": "string"
  }
}

Valores de propiedad

AADAuthTypeWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'AAD' (obligatorio)

AccessKeyAuthTypeWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'AccessKey' (obligatorio)
credenciales WorkspaceConnectionAccessKey

AccountKeyAuthTypeWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'AccountKey' (obligatorio)
credenciales WorkspaceConnectionAccountKey

ApiKeyAuthWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'ApiKey' (obligatorio)
credenciales Objeto de clave de API para la credencial de conexión del área de trabajo. WorkspaceConnectionApiKey

CustomKeys

Nombre Descripción Valor
Llaves Diccionario de <cadena> CustomKeys

CustomKeys

Nombre Descripción Valor

CustomKeysWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'CustomKeys' (obligatorio)
credenciales Objeto de credencial de claves personalizadas CustomKeys

ManagedIdentityAuthTypeWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'ManagedIdentity' (obligatorio)
credenciales WorkspaceConnectionManagedIdentity

Microsoft.MachineLearningServices/workspaces/connections

Nombre Descripción Valor
apiVersion La versión de api '2024-10-01'
nombre El nombre del recurso cuerda

Restricciones:
Patrón = ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$ (obligatorio)
Propiedades WorkspaceConnectionPropertiesV2 (obligatorio)
tipo El tipo de recurso "Microsoft.MachineLearningServices/workspaces/connections"

NoneAuthTypeWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'None' (obligatorio)

OAuth2AuthTypeWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'OAuth2' (obligatorio)
credenciales Se requieren ClientId y ClientSecret. Otras propiedades son opcionales
dependiendo de la implementación de cada proveedor de OAuth2.		 WorkspaceConnectionOAuth2

PATAuthTypeWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'PAT' (obligatorio)
credenciales WorkspaceConnectionPersonalAccessToken

SASAuthTypeWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'SAS' (obligatorio)
credenciales WorkspaceConnectionSharedAccessSignature

ServicePrincipalAuthTypeWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'ServicePrincipal' (obligatorio)
credenciales WorkspaceConnectionServicePrincipal

UsernamePasswordAuthTypeWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'UsernamePassword' (obligatorio)
credenciales WorkspaceConnectionUsernamePassword

WorkspaceConnectionAccessKey

Nombre Descripción Valor
accessKeyId cuerda
secretAccessKey cuerda

WorkspaceConnectionAccountKey

Nombre Descripción Valor
llave cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.

WorkspaceConnectionApiKey

Nombre Descripción Valor
llave cuerda

WorkspaceConnectionManagedIdentity

Nombre Descripción Valor
clientId cuerda
resourceId cuerda

WorkspaceConnectionOAuth2

Nombre Descripción Valor
authUrl Requerido por la categoría de conexión concur cuerda
clientId Id. de cliente con el formato UUID cuerda

Restricciones:
Longitud mínima = 36
Longitud máxima = 36
Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
clientSecret cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
developerToken Requerido por la categoría de conexión GoogleAdWords cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
contraseña cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
refreshToken Requerido por GoogleBigQuery, GoogleAdWords, Hubspot, QuickBooks, Square, Xero, Zoho
donde el usuario necesita desconectar RefreshToken		 cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
tenantId Requerido por las categorías de conexión QuickBooks y Xero cuerda
nombre de usuario Concur, el tipo de concesión accessToken del servidor de autenticación de ServiceNow es "Contraseña".
que requiere UsernamePassword		 cuerda

WorkspaceConnectionPersonalAccessToken

Nombre Descripción Valor
palmadita cuerda

WorkspaceConnectionPropertiesV2

Nombre Descripción Valor
authType Establezca en "AAD" para el tipo AADAuthTypeWorkspaceConnectionProperties. Establezca en "AccessKey" para el tipo AccessKeyAuthTypeWorkspaceConnectionProperties. Establezca en "AccountKey" para el tipo AccountKeyAuthTypeWorkspaceConnectionProperties. Establezca en "ApiKey" para el tipo ApiKeyAuthWorkspaceConnectionProperties. Establezca en "CustomKeys" para el tipo CustomKeysWorkspaceConnectionProperties. Establezca en "ManagedIdentity" para el tipo ManagedIdentityAuthTypeWorkspaceConnectionProperties. Establezca en "None" para el tipo NoneAuthTypeWorkspaceConnectionProperties. Establezca en "OAuth2" para el tipo OAuth2AuthTypeWorkspaceConnectionProperties. Establezca en "PAT" para el tipo PATAuthTypeWorkspaceConnectionProperties. Establezca en "SAS" para el tipo SASAuthTypeWorkspaceConnectionProperties. Establezca en "ServicePrincipal" para el tipo ServicePrincipalAuthTypeWorkspaceConnectionProperties. Establezca en "UsernamePassword" para el tipo UsernamePasswordAuthTypeWorkspaceConnectionProperties. 'AAD'
'AccessKey'
'AccountKey'
'ApiKey'
'CustomKeys'
'ManagedIdentity'
'Ninguno'
'OAuth2'
'PAT'
"SAS"
"ServicePrincipal"
'UsernamePassword' (obligatorio)
categoría Categoría de la conexión 'ADLSGen2'
"AIServices"
"AmazonMws"
'AmazonRdsForOracle'
'AmazonRdsForSqlServer'
"AmazonRedshift"
'AmazonS3Compatible'
'ApiKey'
"AzureBlob"
"AzureDatabricksDeltaLake"
"AzureDataExplorer"
"AzureMariaDb"
"AzureMySqlDb"
"AzureOneLake"
"AzureOpenAI"
"AzurePostgresDb"
"AzureSqlDb"
"AzureSqlMi"
"AzureSynapseAnalytics"
"AzureTableStorage"
'BingLLMSearch'
'Cassandra'
'CognitiveSearch'
'CognitiveService'
'Concur'
'ContainerRegistry'
'CosmosDb'
'CosmosDbMongoDbApi'
'Couchbase'
'CustomKeys'
'Db2'
'Drill'
'Dynamics'
'DynamicsAx'
'DynamicsCrm'
'Elasticsearch'
'Eloqua'
'FileServer'
'FtpServer'
'GenericContainerRegistry'
'GenericHttp'
'GenericRest'
'Git'
'GoogleAdWords'
'GoogleBigQuery'
'GoogleCloudStorage'
'Greenplum'
'Hbase'
"Hdfs"
'Hive'
'Hubspot'
'Impala'
'Informix'
'Jira'
'Magento'
'ManagedOnlineEndpoint'
'MariaDb'
'Marketo'
"MicrosoftAccess"
'MongoDbAtlas'
'MongoDbV2'
'MySql'
'Netezza'
'ODataRest'
'Odbc'
'Office365'
'OpenAI'
'Oracle'
"OracleCloudStorage"
'OracleServiceCloud'
"PayPal"
'Phoenix'
'Pinecone'
'PostgreSql'
"Presto"
"PythonFeed"
"QuickBooks"
"Redis"
'Responsys'
'S3'
"Salesforce"
"SalesforceMarketingCloud"
"SalesforceServiceCloud"
"SapBw"
"SapCloudForCustomer"
"SapEcc"
"SapHana"
"SapOpenHub"
"SapTable"
'Serp'
"Sin servidor"
"ServiceNow"
'Sftp'
'SharePointOnlineList'
'Shopify'
"Copo de nieve"
"Spark"
'SqlServer'
'Cuadrado'
'Sybase'
'Teradata'
'Vertica'
'WebTable'
'Xero'
'Zoho'
expiryTime cuerda
isSharedToAll Bool
metadatos Almacenar metadatos de usuario para esta conexión WorkspaceConnectionPropertiesV2Metadata
sharedUserList string[]
blanco cuerda
valor Detalles del valor de la conexión del área de trabajo. cuerda
valueFormat formato para el valor de conexión del área de trabajo 'JSON'

WorkspaceConnectionPropertiesV2Metadata

Nombre Descripción Valor

WorkspaceConnectionServicePrincipal

Nombre Descripción Valor
clientId cuerda
clientSecret cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
tenantId cuerda

WorkspaceConnectionSharedAccessSignature

Nombre Descripción Valor
Sas cuerda

WorkspaceConnectionUsernamePassword

Nombre Descripción Valor
contraseña cuerda
securityToken Opcional, requerido por conexiones como SalesForce para mayor seguridad además de UsernamePassword cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
nombre de usuario cuerda

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
configuración básica de Azure AI Studio

Implementación en Azure 		Este conjunto de plantillas muestra cómo configurar Azure AI Studio con la configuración básica, lo que significa que con el acceso público a Internet habilitado, las claves administradas por Microsoft para el cifrado y la configuración de identidad administrada por Microsoft para el recurso de IA.
configuración básica de Azure AI Studio

Implementación en Azure 		Este conjunto de plantillas muestra cómo configurar Azure AI Studio con la configuración básica, lo que significa que con el acceso público a Internet habilitado, las claves administradas por Microsoft para el cifrado y la configuración de identidad administrada por Microsoft para el recurso de IA.
configuración básica de Azure AI Studio

Implementación en Azure 		Este conjunto de plantillas muestra cómo configurar Azure AI Studio con la configuración básica, lo que significa que con el acceso público a Internet habilitado, las claves administradas por Microsoft para el cifrado y la configuración de identidad administrada por Microsoft para el recurso de IA.
red restringida de Azure AI Studio Network

Implementación en Azure 		Este conjunto de plantillas muestra cómo configurar Azure AI Studio con vínculo privado y salida deshabilitados, mediante claves administradas por Microsoft para el cifrado y la configuración de identidad administrada por Microsoft para el recurso de IA.
red restringida de Azure AI Studio Network

Implementación en Azure 		Este conjunto de plantillas muestra cómo configurar Azure AI Studio con vínculo privado y salida deshabilitados, mediante claves administradas por Microsoft para el cifrado y la configuración de identidad administrada por Microsoft para el recurso de IA.
Azure AI Studio con la autenticación de id. de Entra de Microsoft

Implementación en Azure 		Este conjunto de plantillas muestra cómo configurar Azure AI Studio con la autenticación de id. de Entra de Microsoft para recursos dependientes, como Azure AI Services y Azure Storage.
Implementación segura de Azure AI Studio con una red virtual administrada

Implementación en Azure 		Esta plantilla crea un entorno seguro de Azure AI Studio con restricciones sólidas de seguridad de red e identidad.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso workspaces/connections se puede implementar con operaciones que tienen como destino:

  • grupos de recursos de

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.MachineLearningServices/workspaces/connections, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.MachineLearningServices/workspaces/connections@2024-10-01"
  name = "string"
  body = jsonencode({
    properties = {
      category = "string"
      expiryTime = "string"
      isSharedToAll = bool
      metadata = {
        {customized property} = "string"
      }
      sharedUserList = [
        "string"
      ]
      target = "string"
      value = "string"
      valueFormat = "string"
      authType = "string"
      // For remaining properties, see WorkspaceConnectionPropertiesV2 objects
    }
  })
}

Objetos WorkspaceConnectionPropertiesV2

Establezca la propiedad authType para especificar el tipo de objeto.

Para AAD, use:

{
  authType = "AAD"
}

Para AccessKey, use:

{
  authType = "AccessKey"
  credentials = {
    accessKeyId = "string"
    secretAccessKey = "string"
  }
}

Para AccountKey, use:

{
  authType = "AccountKey"
  credentials = {
    key = "string"
  }
}

Para ApiKey, use:

{
  authType = "ApiKey"
  credentials = {
    key = "string"
  }
}

Para CustomKeys, use:

{
  authType = "CustomKeys"
  credentials = {
    keys = {
      {customized property} = "string"
    }
  }
}

Para managedIdentity, use:

{
  authType = "ManagedIdentity"
  credentials = {
    clientId = "string"
    resourceId = "string"
  }
}

Para None, use:

{
  authType = "None"
}

Para OAuth2, use:

{
  authType = "OAuth2"
  credentials = {
    authUrl = "string"
    clientId = "string"
    clientSecret = "string"
    developerToken = "string"
    password = "string"
    refreshToken = "string"
    tenantId = "string"
    username = "string"
  }
}

Para pat, use:

{
  authType = "PAT"
  credentials = {
    pat = "string"
  }
}

Para SAS, use:

{
  authType = "SAS"
  credentials = {
    sas = "string"
  }
}

Para ServicePrincipal, use:

{
  authType = "ServicePrincipal"
  credentials = {
    clientId = "string"
    clientSecret = "string"
    tenantId = "string"
  }
}

Para UsernamePassword, use:

{
  authType = "UsernamePassword"
  credentials = {
    password = "string"
    securityToken = "string"
    username = "string"
  }
}

Valores de propiedad

AADAuthTypeWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'AAD' (obligatorio)

AccessKeyAuthTypeWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'AccessKey' (obligatorio)
credenciales WorkspaceConnectionAccessKey

AccountKeyAuthTypeWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'AccountKey' (obligatorio)
credenciales WorkspaceConnectionAccountKey

ApiKeyAuthWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'ApiKey' (obligatorio)
credenciales Objeto de clave de API para la credencial de conexión del área de trabajo. WorkspaceConnectionApiKey

CustomKeys

Nombre Descripción Valor
Llaves Diccionario de <cadena> CustomKeys

CustomKeys

Nombre Descripción Valor

CustomKeysWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'CustomKeys' (obligatorio)
credenciales Objeto de credencial de claves personalizadas CustomKeys

ManagedIdentityAuthTypeWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'ManagedIdentity' (obligatorio)
credenciales WorkspaceConnectionManagedIdentity

Microsoft.MachineLearningServices/workspaces/connections

Nombre Descripción Valor
nombre El nombre del recurso cuerda

Restricciones:
Patrón = ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$ (obligatorio)
parent_id Identificador del recurso que es el elemento primario de este recurso. Identificador del recurso de tipo: áreas de trabajo
Propiedades WorkspaceConnectionPropertiesV2 (obligatorio)
tipo El tipo de recurso "Microsoft.MachineLearningServices/workspaces/connections@2024-10-01"

NoneAuthTypeWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'None' (obligatorio)

OAuth2AuthTypeWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'OAuth2' (obligatorio)
credenciales Se requieren ClientId y ClientSecret. Otras propiedades son opcionales
dependiendo de la implementación de cada proveedor de OAuth2.		 WorkspaceConnectionOAuth2

PATAuthTypeWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'PAT' (obligatorio)
credenciales WorkspaceConnectionPersonalAccessToken

SASAuthTypeWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'SAS' (obligatorio)
credenciales WorkspaceConnectionSharedAccessSignature

ServicePrincipalAuthTypeWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'ServicePrincipal' (obligatorio)
credenciales WorkspaceConnectionServicePrincipal

UsernamePasswordAuthTypeWorkspaceConnectionProperties

Nombre Descripción Valor
authType Tipo de autenticación del destino de conexión 'UsernamePassword' (obligatorio)
credenciales WorkspaceConnectionUsernamePassword

WorkspaceConnectionAccessKey

Nombre Descripción Valor
accessKeyId cuerda
secretAccessKey cuerda

WorkspaceConnectionAccountKey

Nombre Descripción Valor
llave cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.

WorkspaceConnectionApiKey

Nombre Descripción Valor
llave cuerda

WorkspaceConnectionManagedIdentity

Nombre Descripción Valor
clientId cuerda
resourceId cuerda

WorkspaceConnectionOAuth2

Nombre Descripción Valor
authUrl Requerido por la categoría de conexión concur cuerda
clientId Id. de cliente con el formato UUID cuerda

Restricciones:
Longitud mínima = 36
Longitud máxima = 36
Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
clientSecret cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
developerToken Requerido por la categoría de conexión GoogleAdWords cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
contraseña cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
refreshToken Requerido por GoogleBigQuery, GoogleAdWords, Hubspot, QuickBooks, Square, Xero, Zoho
donde el usuario necesita desconectar RefreshToken		 cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
tenantId Requerido por las categorías de conexión QuickBooks y Xero cuerda
nombre de usuario Concur, el tipo de concesión accessToken del servidor de autenticación de ServiceNow es "Contraseña".
que requiere UsernamePassword		 cuerda

WorkspaceConnectionPersonalAccessToken

Nombre Descripción Valor
palmadita cuerda

WorkspaceConnectionPropertiesV2

Nombre Descripción Valor
authType Establezca en "AAD" para el tipo AADAuthTypeWorkspaceConnectionProperties. Establezca en "AccessKey" para el tipo AccessKeyAuthTypeWorkspaceConnectionProperties. Establezca en "AccountKey" para el tipo AccountKeyAuthTypeWorkspaceConnectionProperties. Establezca en "ApiKey" para el tipo ApiKeyAuthWorkspaceConnectionProperties. Establezca en "CustomKeys" para el tipo CustomKeysWorkspaceConnectionProperties. Establezca en "ManagedIdentity" para el tipo ManagedIdentityAuthTypeWorkspaceConnectionProperties. Establezca en "None" para el tipo NoneAuthTypeWorkspaceConnectionProperties. Establezca en "OAuth2" para el tipo OAuth2AuthTypeWorkspaceConnectionProperties. Establezca en "PAT" para el tipo PATAuthTypeWorkspaceConnectionProperties. Establezca en "SAS" para el tipo SASAuthTypeWorkspaceConnectionProperties. Establezca en "ServicePrincipal" para el tipo ServicePrincipalAuthTypeWorkspaceConnectionProperties. Establezca en "UsernamePassword" para el tipo UsernamePasswordAuthTypeWorkspaceConnectionProperties. 'AAD'
'AccessKey'
'AccountKey'
'ApiKey'
'CustomKeys'
'ManagedIdentity'
'Ninguno'
'OAuth2'
'PAT'
"SAS"
"ServicePrincipal"
'UsernamePassword' (obligatorio)
categoría Categoría de la conexión 'ADLSGen2'
"AIServices"
"AmazonMws"
'AmazonRdsForOracle'
'AmazonRdsForSqlServer'
"AmazonRedshift"
'AmazonS3Compatible'
'ApiKey'
"AzureBlob"
"AzureDatabricksDeltaLake"
"AzureDataExplorer"
"AzureMariaDb"
"AzureMySqlDb"
"AzureOneLake"
"AzureOpenAI"
"AzurePostgresDb"
"AzureSqlDb"
"AzureSqlMi"
"AzureSynapseAnalytics"
"AzureTableStorage"
'BingLLMSearch'
'Cassandra'
'CognitiveSearch'
'CognitiveService'
'Concur'
'ContainerRegistry'
'CosmosDb'
'CosmosDbMongoDbApi'
'Couchbase'
'CustomKeys'
'Db2'
'Drill'
'Dynamics'
'DynamicsAx'
'DynamicsCrm'
'Elasticsearch'
'Eloqua'
'FileServer'
'FtpServer'
'GenericContainerRegistry'
'GenericHttp'
'GenericRest'
'Git'
'GoogleAdWords'
'GoogleBigQuery'
'GoogleCloudStorage'
'Greenplum'
'Hbase'
"Hdfs"
'Hive'
'Hubspot'
'Impala'
'Informix'
'Jira'
'Magento'
'ManagedOnlineEndpoint'
'MariaDb'
'Marketo'
"MicrosoftAccess"
'MongoDbAtlas'
'MongoDbV2'
'MySql'
'Netezza'
'ODataRest'
'Odbc'
'Office365'
'OpenAI'
'Oracle'
"OracleCloudStorage"
'OracleServiceCloud'
"PayPal"
'Phoenix'
'Pinecone'
'PostgreSql'
"Presto"
"PythonFeed"
"QuickBooks"
"Redis"
'Responsys'
'S3'
"Salesforce"
"SalesforceMarketingCloud"
"SalesforceServiceCloud"
"SapBw"
"SapCloudForCustomer"
"SapEcc"
"SapHana"
"SapOpenHub"
"SapTable"
'Serp'
"Sin servidor"
"ServiceNow"
'Sftp'
'SharePointOnlineList'
'Shopify'
"Copo de nieve"
"Spark"
'SqlServer'
'Cuadrado'
'Sybase'
'Teradata'
'Vertica'
'WebTable'
'Xero'
'Zoho'
expiryTime cuerda
isSharedToAll Bool
metadatos Almacenar metadatos de usuario para esta conexión WorkspaceConnectionPropertiesV2Metadata
sharedUserList string[]
blanco cuerda
valor Detalles del valor de la conexión del área de trabajo. cuerda
valueFormat formato para el valor de conexión del área de trabajo 'JSON'

WorkspaceConnectionPropertiesV2Metadata

Nombre Descripción Valor

WorkspaceConnectionServicePrincipal

Nombre Descripción Valor
clientId cuerda
clientSecret cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
tenantId cuerda

WorkspaceConnectionSharedAccessSignature

Nombre Descripción Valor
Sas cuerda

WorkspaceConnectionUsernamePassword

Nombre Descripción Valor
contraseña cuerda
securityToken Opcional, requerido por conexiones como SalesForce para mayor seguridad además de UsernamePassword cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
nombre de usuario cuerda