Freigeben über


Microsoft.MachineLearningServices-Arbeitsbereiche/Connections 2023-08-01-preview

Bicep-Ressourcendefinition

Der Ressourcentyp "Arbeitsbereiche/Verbindungen" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.MachineLearningServices/workspaces/connections-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Bicep hinzu.

resource symbolicname 'Microsoft.MachineLearningServices/workspaces/connections@2023-08-01-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    category: 'string'
    expiryTime: 'string'
    isSharedToAll: bool
    metadata: any(...)
    target: 'string'
    authType: 'string'
    // For remaining properties, see WorkspaceConnectionPropertiesV2 objects
  }
}

WorkspaceConnectionPropertiesV2-Objekte

Legen Sie die authType-Eigenschaft fest, um den Objekttyp anzugeben.

Verwenden Sie für AccessKey-:

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

Verwenden Sie für ApiKey-:

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

Verwenden Sie für CustomKeys-Folgendes:

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

Verwenden Sie für ManagedIdentity-Folgendes:

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

Verwenden Sie für None:

{
  authType: 'None'
}

Verwenden Sie für PAT:

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

Verwenden Sie für SAS-:

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

Verwenden Sie für ServicePrincipal-:

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

Verwenden Sie für UsernamePassword-:

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

Eigenschaftswerte

Microsoft.MachineLearningServices/Arbeitsbereiche/Verbindungen

Name Beschreibung Wert
Name Der Ressourcenname Schnur

Zwänge:
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$ (erforderlich)
Elternteil In Bicep können Sie die übergeordnete Ressource für eine untergeordnete Ressource angeben. Sie müssen diese Eigenschaft nur hinzufügen, wenn die untergeordnete Ressource außerhalb der übergeordneten Ressource deklariert wird.

Weitere Informationen finden Sie unter Untergeordnete Ressource außerhalb der übergeordneten Ressource.
Symbolischer Name für Ressource des Typs: Arbeitsbereiche
Eigenschaften WorkspaceConnectionPropertiesV2 (erforderlich)

AccessKeyAuthTypeWorkspaceConnectionProperties

Name Beschreibung Wert
Authentifizierungstyp Authentifizierungstyp des Verbindungsziels "AccessKey" (erforderlich)
Beglaubigungsschreiben WorkspaceConnectionAccessKey-

ApiKeyAuthWorkspaceConnectionProperties

Name Beschreibung Wert
Authentifizierungstyp Authentifizierungstyp des Verbindungsziels 'ApiKey' (erforderlich)
Beglaubigungsschreiben API-Schlüsselobjekt für Arbeitsbereichsverbindungsanmeldeinformationen. WorkspaceConnectionApiKey-

Benutzerdefinierte Schlüssel

Name Beschreibung Wert
Tasten Wörterbuch der <Zeichenfolge> CustomKeys-

Benutzerdefinierte Schlüssel

Name Beschreibung Wert

CustomKeysWorkspaceConnectionProperties

Name Beschreibung Wert
Authentifizierungstyp Authentifizierungstyp des Verbindungsziels 'CustomKeys' (erforderlich)
Beglaubigungsschreiben Benutzerdefinierte Schlüssel-Anmeldeinformationsobjekt CustomKeys-

ManagedIdentityAuthTypeWorkspaceConnectionProperties

Name Beschreibung Wert
Authentifizierungstyp Authentifizierungstyp des Verbindungsziels "ManagedIdentity" (erforderlich)
Beglaubigungsschreiben WorkspaceConnectionManagedIdentity-

NoneAuthTypeWorkspaceConnectionProperties

Name Beschreibung Wert
Authentifizierungstyp Authentifizierungstyp des Verbindungsziels 'None' (erforderlich)

PATAuthTypeWorkspaceConnectionEigenschaften

Name Beschreibung Wert
Authentifizierungstyp Authentifizierungstyp des Verbindungsziels 'PAT' (erforderlich)
Beglaubigungsschreiben WorkspaceConnectionPersonalAccessToken

SASAuthTypeWorkspaceConnectionProperties

Name Beschreibung Wert
Authentifizierungstyp Authentifizierungstyp des Verbindungsziels "SAS" (erforderlich)
Beglaubigungsschreiben WorkspaceConnectionSharedAccessSignature

ServicePrincipalAuthTypeWorkspaceConnectionProperties

Name Beschreibung Wert
Authentifizierungstyp Authentifizierungstyp des Verbindungsziels 'ServicePrincipal' (erforderlich)
Beglaubigungsschreiben WorkspaceConnectionServicePrincipal-

BenutzernamePasswordAuthTypeWorkspaceConnectionEigenschaften

Name Beschreibung Wert
Authentifizierungstyp Authentifizierungstyp des Verbindungsziels "UsernamePassword" (erforderlich)
Beglaubigungsschreiben WorkspaceConnectionUsernamePassword-

WorkspaceConnectionAccessKey

Name Beschreibung Wert
accessKeyId Schnur
secretAccessKey Schnur

WorkspaceConnectionApiKey

Name Beschreibung Wert
Schlüssel Schnur

WorkspaceConnectionManagedIdentity

Name Beschreibung Wert
clientId (englisch) Schnur
Ressourcen-ID Schnur

WorkspaceConnectionPersonalAccessToken

Name Beschreibung Wert
tätscheln Schnur

WorkspaceConnectionPropertiesV2

Name Beschreibung Wert
Authentifizierungstyp Legen Sie für den Typ AccessKeyAuthTypeWorkspaceConnectionPropertiesauf "AccessKey" fest. Legen Sie für den Typ ApiKeyAuthWorkspaceConnectionPropertiesauf 'ApiKey' fest. Legen Sie für den Typ CustomKeysWorkspaceConnectionPropertiesauf 'CustomKeys' fest. Auf "ManagedIdentity" für den Typ "ManagedIdentityAuthTypeWorkspaceConnectionProperties" festgelegt. Legen Sie für den Typ NoneAuthTypeWorkspaceConnectionPropertiesauf "None" fest. Legen Sie für den Typ PATAuthTypeWorkspaceConnectionPropertiesauf "PAT" fest. Legen Sie für den Typ SASAuthTypeWorkspaceConnectionPropertiesauf "SAS" fest. Legen Sie für den Typ ServicePrincipalAuthTypeWorkspaceConnectionProperties auf "ServicePrincipal" fest. Legen Sie für den Typ UsernamePasswordAuthTypeWorkspaceConnectionPropertiesauf "UsernamePassword" fest. "AccessKey"
'ApiKey'
'Benutzerdefinierte Schlüssel'
"ManagedIdentity"
"Keine"
"PAT"
"SAS"
'ServicePrincipal'
"UsernamePassword" (erforderlich)
Kategorie Kategorie der Verbindung 'ADLSGen2'
'ApiKey'
'AzureMySqlDb'
"AzureOpenAI"
'AzurePostgresDb'
'AzureSqlDb'
"AzureSynapseAnalytics"
"CognitiveSearch"
"CognitiveService"
'Container-Registrierung'
'Benutzerdefinierte Schlüssel'
'Git'
"PythonFeed"
"Redis"
'S3'
'Schneeflake'
AblaufZeit Schnur
isSharedToAll Gibt an, ob diese Verbindung für den gesamten Projektarbeitsbereich unter dem Hub freigegeben wird. Bool
Metadaten Jedes Objekt jegliche
Ziel Schnur

WorkspaceConnectionServicePrincipal

Name Beschreibung Wert
clientId (englisch) Schnur
Kundengeheimnis Schnur
Mandanten-ID Schnur

WorkspaceConnectionSharedAccessSignature

Name Beschreibung Wert
Sas Schnur

WorkspaceConnectionUsernamePassword

Name Beschreibung Wert
Passwort Schnur
Nutzername Schnur

Verwendungsbeispiele

Azure-Schnellstartbeispiele

Die folgenden Azure-Schnellstartvorlagen Bicep-Beispiele für die Bereitstellung dieses Ressourcentyps enthalten.

Bicep-Datei Beschreibung
Grundlegendes Setup von Azure AI Foundry Diese Gruppe von Vorlagen veranschaulicht, wie Sie Azure AI Foundry mit der grundlegenden Einrichtung einrichten, d. h. mit aktiviertem öffentlichen Internetzugang, von Microsoft verwalteten Schlüsseln für die Verschlüsselung und von Microsoft verwalteter Identitätskonfiguration für die KI-Ressource.
Grundlegendes Setup von Azure AI Foundry Diese Gruppe von Vorlagen veranschaulicht, wie Sie Azure AI Foundry mit der grundlegenden Einrichtung einrichten, d. h. mit aktiviertem öffentlichen Internetzugang, von Microsoft verwalteten Schlüsseln für die Verschlüsselung und von Microsoft verwalteter Identitätskonfiguration für die KI-Ressource.
Eingeschränktes Azure AI Foundry-Netzwerk Diese Gruppe von Vorlagen veranschaulicht, wie Sie Azure AI Foundry mit deaktivierter privater Verbindung und deaktiviertem Ausgang einrichten, indem Sie von Microsoft verwaltete Schlüssel für die Verschlüsselung und die von Microsoft verwaltete Identitätskonfiguration für die KI-Ressource verwenden.
Azure AI Foundry mit Microsoft Entra ID-Authentifizierung Diese Gruppe von Vorlagen veranschaulicht, wie Sie Azure AI Foundry mit Microsoft Entra ID-Authentifizierung für abhängige Ressourcen wie Azure AI Services und Azure Storage einrichten.
Azure AI Studio – grundlegende Einrichtung Dieser Satz von Vorlagen veranschaulicht, wie Sie Azure AI Studio mit dem grundlegenden Setup einrichten, was bedeutet, dass der öffentliche Internetzugriff aktiviert ist, von Microsoft verwaltete Schlüssel für verschlüsselung und von Microsoft verwaltete Identitätskonfiguration für die KI-Ressource.
Azure AI Studio-Netzwerk eingeschränkt Dieser Satz von Vorlagen veranschaulicht, wie Sie Azure AI Studio mit deaktiviertem privaten Link und Ausstieg einrichten, wobei microsoftverwaltete Schlüssel für Verschlüsselung und von Microsoft verwaltete Identitätskonfiguration für die KI-Ressource verwendet werden.
API-Schlüssel für die Grundlegende Agent-Einrichtung Dieser Satz von Vorlagen veranschaulicht, wie Azure AI Agent Service mit der grundlegenden Einrichtung mithilfe der API-Schlüsselauthentifizierung für die AI Service/AOAI-Verbindung eingerichtet wird. Agents verwenden mehrinstanzenfähige Such- und Speicherressourcen, die vollständig von Microsoft verwaltet werden. Sie haben keine Sichtbarkeit oder Kontrolle über diese zugrunde liegenden Azure-Ressourcen.
Grundlegende Agent-Setupidentität Dieser Satz von Vorlagen veranschaulicht, wie Azure AI Agent Service mit der grundlegenden Einrichtung mithilfe der verwalteten Identitätsauthentifizierung für die AI Service/AOAI-Verbindung eingerichtet wird. Agents verwenden mehrinstanzenfähige Such- und Speicherressourcen, die vollständig von Microsoft verwaltet werden. Sie haben keine Sichtbarkeit oder Kontrolle über diese zugrunde liegenden Azure-Ressourcen.
Bereitstellen von Secure AI Foundry mit einem verwalteten virtuellen Netzwerk Mit dieser Vorlage wird eine sichere Azure AI Foundry-Umgebung mit robusten Netzwerk- und Identitätssicherheitseinschränkungen erstellt.
vom Netzwerk gesicherter Agent mit vom Benutzer verwalteter Identität Dieser Satz von Vorlagen veranschaulicht, wie Azure AI Agent Service mit virtueller Netzwerkisolation mithilfe der vom Benutzer verwalteten Identitätsauthentifizierung für die AI Service/AOAI-Verbindung und private Netzwerkverbindungen eingerichtet wird, um den Agent mit Ihren sicheren Daten zu verbinden.
Standard-Agent-Setup- Dieser Satz von Vorlagen veranschaulicht, wie Azure AI Agent Service mit dem Standardsetup eingerichtet wird, d. h. mit verwalteter Identitätsauthentifizierung für Projekt-/Hubverbindungen und aktiviertem öffentlichen Internetzugriff. Agents verwenden kundeneigene, einzelmandantenbasierte Such- und Speicherressourcen. Mit diesem Setup haben Sie die volle Kontrolle und Sichtbarkeit über diese Ressourcen, aber Sie verursachen Kosten basierend auf Ihrer Nutzung.

ARM-Vorlagenressourcendefinition

Der Ressourcentyp "Arbeitsbereiche/Verbindungen" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.MachineLearningServices/workspaces/connections-Ressource zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.

{
  "type": "Microsoft.MachineLearningServices/workspaces/connections",
  "apiVersion": "2023-08-01-preview",
  "name": "string",
  "properties": {
    "category": "string",
    "expiryTime": "string",
    "isSharedToAll": "bool",
    "metadata": {},
    "target": "string",
    "authType": "string"
    // For remaining properties, see WorkspaceConnectionPropertiesV2 objects
  }
}

WorkspaceConnectionPropertiesV2-Objekte

Legen Sie die authType-Eigenschaft fest, um den Objekttyp anzugeben.

Verwenden Sie für AccessKey-:

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

Verwenden Sie für ApiKey-:

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

Verwenden Sie für CustomKeys-Folgendes:

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

Verwenden Sie für ManagedIdentity-Folgendes:

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

Verwenden Sie für None:

{
  "authType": "None"
}

Verwenden Sie für PAT:

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

Verwenden Sie für SAS-:

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

Verwenden Sie für ServicePrincipal-:

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

Verwenden Sie für UsernamePassword-:

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

Eigenschaftswerte

Microsoft.MachineLearningServices/Arbeitsbereiche/Verbindungen

Name Beschreibung Wert
apiVersion (Englisch) Die API-Version "2023-08-01-preview"
Name Der Ressourcenname Schnur

Zwänge:
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$ (erforderlich)
Eigenschaften WorkspaceConnectionPropertiesV2 (erforderlich)
Art Der Ressourcentyp "Microsoft.MachineLearningServices/workspaces/connections"

AccessKeyAuthTypeWorkspaceConnectionProperties

Name Beschreibung Wert
Authentifizierungstyp Authentifizierungstyp des Verbindungsziels "AccessKey" (erforderlich)
Beglaubigungsschreiben WorkspaceConnectionAccessKey-

ApiKeyAuthWorkspaceConnectionProperties

Name Beschreibung Wert
Authentifizierungstyp Authentifizierungstyp des Verbindungsziels 'ApiKey' (erforderlich)
Beglaubigungsschreiben API-Schlüsselobjekt für Arbeitsbereichsverbindungsanmeldeinformationen. WorkspaceConnectionApiKey-

Benutzerdefinierte Schlüssel

Name Beschreibung Wert
Tasten Wörterbuch der <Zeichenfolge> CustomKeys-

Benutzerdefinierte Schlüssel

Name Beschreibung Wert

CustomKeysWorkspaceConnectionProperties

Name Beschreibung Wert
Authentifizierungstyp Authentifizierungstyp des Verbindungsziels 'CustomKeys' (erforderlich)
Beglaubigungsschreiben Benutzerdefinierte Schlüssel-Anmeldeinformationsobjekt CustomKeys-

ManagedIdentityAuthTypeWorkspaceConnectionProperties

Name Beschreibung Wert
Authentifizierungstyp Authentifizierungstyp des Verbindungsziels "ManagedIdentity" (erforderlich)
Beglaubigungsschreiben WorkspaceConnectionManagedIdentity-

NoneAuthTypeWorkspaceConnectionProperties

Name Beschreibung Wert
Authentifizierungstyp Authentifizierungstyp des Verbindungsziels 'None' (erforderlich)

PATAuthTypeWorkspaceConnectionEigenschaften

Name Beschreibung Wert
Authentifizierungstyp Authentifizierungstyp des Verbindungsziels 'PAT' (erforderlich)
Beglaubigungsschreiben WorkspaceConnectionPersonalAccessToken

SASAuthTypeWorkspaceConnectionProperties

Name Beschreibung Wert
Authentifizierungstyp Authentifizierungstyp des Verbindungsziels "SAS" (erforderlich)
Beglaubigungsschreiben WorkspaceConnectionSharedAccessSignature

ServicePrincipalAuthTypeWorkspaceConnectionProperties

Name Beschreibung Wert
Authentifizierungstyp Authentifizierungstyp des Verbindungsziels 'ServicePrincipal' (erforderlich)
Beglaubigungsschreiben WorkspaceConnectionServicePrincipal-

BenutzernamePasswordAuthTypeWorkspaceConnectionEigenschaften

Name Beschreibung Wert
Authentifizierungstyp Authentifizierungstyp des Verbindungsziels "UsernamePassword" (erforderlich)
Beglaubigungsschreiben WorkspaceConnectionUsernamePassword-

WorkspaceConnectionAccessKey

Name Beschreibung Wert
accessKeyId Schnur
secretAccessKey Schnur

WorkspaceConnectionApiKey

Name Beschreibung Wert
Schlüssel Schnur

WorkspaceConnectionManagedIdentity

Name Beschreibung Wert
clientId (englisch) Schnur
Ressourcen-ID Schnur

WorkspaceConnectionPersonalAccessToken

Name Beschreibung Wert
tätscheln Schnur

WorkspaceConnectionPropertiesV2

Name Beschreibung Wert
Authentifizierungstyp Legen Sie für den Typ AccessKeyAuthTypeWorkspaceConnectionPropertiesauf "AccessKey" fest. Legen Sie für den Typ ApiKeyAuthWorkspaceConnectionPropertiesauf 'ApiKey' fest. Legen Sie für den Typ CustomKeysWorkspaceConnectionPropertiesauf 'CustomKeys' fest. Auf "ManagedIdentity" für den Typ "ManagedIdentityAuthTypeWorkspaceConnectionProperties" festgelegt. Legen Sie für den Typ NoneAuthTypeWorkspaceConnectionPropertiesauf "None" fest. Legen Sie für den Typ PATAuthTypeWorkspaceConnectionPropertiesauf "PAT" fest. Legen Sie für den Typ SASAuthTypeWorkspaceConnectionPropertiesauf "SAS" fest. Legen Sie für den Typ ServicePrincipalAuthTypeWorkspaceConnectionProperties auf "ServicePrincipal" fest. Legen Sie für den Typ UsernamePasswordAuthTypeWorkspaceConnectionPropertiesauf "UsernamePassword" fest. "AccessKey"
'ApiKey'
'Benutzerdefinierte Schlüssel'
"ManagedIdentity"
"Keine"
"PAT"
"SAS"
'ServicePrincipal'
"UsernamePassword" (erforderlich)
Kategorie Kategorie der Verbindung 'ADLSGen2'
'ApiKey'
'AzureMySqlDb'
"AzureOpenAI"
'AzurePostgresDb'
'AzureSqlDb'
"AzureSynapseAnalytics"
"CognitiveSearch"
"CognitiveService"
'Container-Registrierung'
'Benutzerdefinierte Schlüssel'
'Git'
"PythonFeed"
"Redis"
'S3'
'Schneeflake'
AblaufZeit Schnur
isSharedToAll Gibt an, ob diese Verbindung für den gesamten Projektarbeitsbereich unter dem Hub freigegeben wird. Bool
Metadaten Jedes Objekt jegliche
Ziel Schnur

WorkspaceConnectionServicePrincipal

Name Beschreibung Wert
clientId (englisch) Schnur
Kundengeheimnis Schnur
Mandanten-ID Schnur

WorkspaceConnectionSharedAccessSignature

Name Beschreibung Wert
Sas Schnur

WorkspaceConnectionUsernamePassword

Name Beschreibung Wert
Passwort Schnur
Nutzername Schnur

Verwendungsbeispiele

Azure-Schnellstartvorlagen

Die folgenden Azure-Schnellstartvorlagen diesen Ressourcentyp bereitstellen.

Vorlage Beschreibung
Grundlegendes Setup von Azure AI Foundry

Bereitstellen in Azure
Diese Gruppe von Vorlagen veranschaulicht, wie Sie Azure AI Foundry mit der grundlegenden Einrichtung einrichten, d. h. mit aktiviertem öffentlichen Internetzugang, von Microsoft verwalteten Schlüsseln für die Verschlüsselung und von Microsoft verwalteter Identitätskonfiguration für die KI-Ressource.
Grundlegendes Setup von Azure AI Foundry

Bereitstellen in Azure
Diese Gruppe von Vorlagen veranschaulicht, wie Sie Azure AI Foundry mit der grundlegenden Einrichtung einrichten, d. h. mit aktiviertem öffentlichen Internetzugang, von Microsoft verwalteten Schlüsseln für die Verschlüsselung und von Microsoft verwalteter Identitätskonfiguration für die KI-Ressource.
Eingeschränktes Azure AI Foundry-Netzwerk

Bereitstellen in Azure
Diese Gruppe von Vorlagen veranschaulicht, wie Sie Azure AI Foundry mit deaktivierter privater Verbindung und deaktiviertem Ausgang einrichten, indem Sie von Microsoft verwaltete Schlüssel für die Verschlüsselung und die von Microsoft verwaltete Identitätskonfiguration für die KI-Ressource verwenden.
Azure AI Foundry mit Microsoft Entra ID-Authentifizierung

Bereitstellen in Azure
Diese Gruppe von Vorlagen veranschaulicht, wie Sie Azure AI Foundry mit Microsoft Entra ID-Authentifizierung für abhängige Ressourcen wie Azure AI Services und Azure Storage einrichten.
Azure AI Studio – grundlegende Einrichtung

Bereitstellen in Azure
Dieser Satz von Vorlagen veranschaulicht, wie Sie Azure AI Studio mit dem grundlegenden Setup einrichten, was bedeutet, dass der öffentliche Internetzugriff aktiviert ist, von Microsoft verwaltete Schlüssel für verschlüsselung und von Microsoft verwaltete Identitätskonfiguration für die KI-Ressource.
Azure AI Studio-Netzwerk eingeschränkt

Bereitstellen in Azure
Dieser Satz von Vorlagen veranschaulicht, wie Sie Azure AI Studio mit deaktiviertem privaten Link und Ausstieg einrichten, wobei microsoftverwaltete Schlüssel für Verschlüsselung und von Microsoft verwaltete Identitätskonfiguration für die KI-Ressource verwendet werden.
API-Schlüssel für die Grundlegende Agent-Einrichtung

Bereitstellen in Azure
Dieser Satz von Vorlagen veranschaulicht, wie Azure AI Agent Service mit der grundlegenden Einrichtung mithilfe der API-Schlüsselauthentifizierung für die AI Service/AOAI-Verbindung eingerichtet wird. Agents verwenden mehrinstanzenfähige Such- und Speicherressourcen, die vollständig von Microsoft verwaltet werden. Sie haben keine Sichtbarkeit oder Kontrolle über diese zugrunde liegenden Azure-Ressourcen.
Grundlegende Agent-Setupidentität

Bereitstellen in Azure
Dieser Satz von Vorlagen veranschaulicht, wie Azure AI Agent Service mit der grundlegenden Einrichtung mithilfe der verwalteten Identitätsauthentifizierung für die AI Service/AOAI-Verbindung eingerichtet wird. Agents verwenden mehrinstanzenfähige Such- und Speicherressourcen, die vollständig von Microsoft verwaltet werden. Sie haben keine Sichtbarkeit oder Kontrolle über diese zugrunde liegenden Azure-Ressourcen.
Bereitstellen von Secure AI Foundry mit einem verwalteten virtuellen Netzwerk

Bereitstellen in Azure
Mit dieser Vorlage wird eine sichere Azure AI Foundry-Umgebung mit robusten Netzwerk- und Identitätssicherheitseinschränkungen erstellt.
vom Netzwerk gesicherter Agent mit vom Benutzer verwalteter Identität

Bereitstellen in Azure
Dieser Satz von Vorlagen veranschaulicht, wie Azure AI Agent Service mit virtueller Netzwerkisolation mithilfe der vom Benutzer verwalteten Identitätsauthentifizierung für die AI Service/AOAI-Verbindung und private Netzwerkverbindungen eingerichtet wird, um den Agent mit Ihren sicheren Daten zu verbinden.
Standard-Agent-Setup-

Bereitstellen in Azure
Dieser Satz von Vorlagen veranschaulicht, wie Azure AI Agent Service mit dem Standardsetup eingerichtet wird, d. h. mit verwalteter Identitätsauthentifizierung für Projekt-/Hubverbindungen und aktiviertem öffentlichen Internetzugriff. Agents verwenden kundeneigene, einzelmandantenbasierte Such- und Speicherressourcen. Mit diesem Setup haben Sie die volle Kontrolle und Sichtbarkeit über diese Ressourcen, aber Sie verursachen Kosten basierend auf Ihrer Nutzung.

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der Ressourcentyp "Arbeitsbereiche/Verbindungen" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

  • Ressourcengruppen

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.MachineLearningServices/workspaces/connections-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.MachineLearningServices/workspaces/connections@2023-08-01-preview"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      category = "string"
      expiryTime = "string"
      isSharedToAll = bool
      metadata = ?
      target = "string"
      authType = "string"
      // For remaining properties, see WorkspaceConnectionPropertiesV2 objects
    }
  }
}

WorkspaceConnectionPropertiesV2-Objekte

Legen Sie die authType-Eigenschaft fest, um den Objekttyp anzugeben.

Verwenden Sie für AccessKey-:

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

Verwenden Sie für ApiKey-:

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

Verwenden Sie für CustomKeys-Folgendes:

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

Verwenden Sie für ManagedIdentity-Folgendes:

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

Verwenden Sie für None:

{
  authType = "None"
}

Verwenden Sie für PAT:

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

Verwenden Sie für SAS-:

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

Verwenden Sie für ServicePrincipal-:

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

Verwenden Sie für UsernamePassword-:

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

Eigenschaftswerte

Microsoft.MachineLearningServices/Arbeitsbereiche/Verbindungen

Name Beschreibung Wert
Name Der Ressourcenname Schnur

Zwänge:
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$ (erforderlich)
Eltern-ID Die ID der Ressource, die das übergeordnete Element für diese Ressource ist. ID für Ressource des Typs: Arbeitsbereiche
Eigenschaften WorkspaceConnectionPropertiesV2 (erforderlich)
Art Der Ressourcentyp "Microsoft.MachineLearningServices/workspaces/connections@2023-08-01-preview"

AccessKeyAuthTypeWorkspaceConnectionProperties

Name Beschreibung Wert
Authentifizierungstyp Authentifizierungstyp des Verbindungsziels "AccessKey" (erforderlich)
Beglaubigungsschreiben WorkspaceConnectionAccessKey-

ApiKeyAuthWorkspaceConnectionProperties

Name Beschreibung Wert
Authentifizierungstyp Authentifizierungstyp des Verbindungsziels 'ApiKey' (erforderlich)
Beglaubigungsschreiben API-Schlüsselobjekt für Arbeitsbereichsverbindungsanmeldeinformationen. WorkspaceConnectionApiKey-

Benutzerdefinierte Schlüssel

Name Beschreibung Wert
Tasten Wörterbuch der <Zeichenfolge> CustomKeys-

Benutzerdefinierte Schlüssel

Name Beschreibung Wert

CustomKeysWorkspaceConnectionProperties

Name Beschreibung Wert
Authentifizierungstyp Authentifizierungstyp des Verbindungsziels 'CustomKeys' (erforderlich)
Beglaubigungsschreiben Benutzerdefinierte Schlüssel-Anmeldeinformationsobjekt CustomKeys-

ManagedIdentityAuthTypeWorkspaceConnectionProperties

Name Beschreibung Wert
Authentifizierungstyp Authentifizierungstyp des Verbindungsziels "ManagedIdentity" (erforderlich)
Beglaubigungsschreiben WorkspaceConnectionManagedIdentity-

NoneAuthTypeWorkspaceConnectionProperties

Name Beschreibung Wert
Authentifizierungstyp Authentifizierungstyp des Verbindungsziels 'None' (erforderlich)

PATAuthTypeWorkspaceConnectionEigenschaften

Name Beschreibung Wert
Authentifizierungstyp Authentifizierungstyp des Verbindungsziels 'PAT' (erforderlich)
Beglaubigungsschreiben WorkspaceConnectionPersonalAccessToken

SASAuthTypeWorkspaceConnectionProperties

Name Beschreibung Wert
Authentifizierungstyp Authentifizierungstyp des Verbindungsziels "SAS" (erforderlich)
Beglaubigungsschreiben WorkspaceConnectionSharedAccessSignature

ServicePrincipalAuthTypeWorkspaceConnectionProperties

Name Beschreibung Wert
Authentifizierungstyp Authentifizierungstyp des Verbindungsziels 'ServicePrincipal' (erforderlich)
Beglaubigungsschreiben WorkspaceConnectionServicePrincipal-

BenutzernamePasswordAuthTypeWorkspaceConnectionEigenschaften

Name Beschreibung Wert
Authentifizierungstyp Authentifizierungstyp des Verbindungsziels "UsernamePassword" (erforderlich)
Beglaubigungsschreiben WorkspaceConnectionUsernamePassword-

WorkspaceConnectionAccessKey

Name Beschreibung Wert
accessKeyId Schnur
secretAccessKey Schnur

WorkspaceConnectionApiKey

Name Beschreibung Wert
Schlüssel Schnur

WorkspaceConnectionManagedIdentity

Name Beschreibung Wert
clientId (englisch) Schnur
Ressourcen-ID Schnur

WorkspaceConnectionPersonalAccessToken

Name Beschreibung Wert
tätscheln Schnur

WorkspaceConnectionPropertiesV2

Name Beschreibung Wert
Authentifizierungstyp Legen Sie für den Typ AccessKeyAuthTypeWorkspaceConnectionPropertiesauf "AccessKey" fest. Legen Sie für den Typ ApiKeyAuthWorkspaceConnectionPropertiesauf 'ApiKey' fest. Legen Sie für den Typ CustomKeysWorkspaceConnectionPropertiesauf 'CustomKeys' fest. Auf "ManagedIdentity" für den Typ "ManagedIdentityAuthTypeWorkspaceConnectionProperties" festgelegt. Legen Sie für den Typ NoneAuthTypeWorkspaceConnectionPropertiesauf "None" fest. Legen Sie für den Typ PATAuthTypeWorkspaceConnectionPropertiesauf "PAT" fest. Legen Sie für den Typ SASAuthTypeWorkspaceConnectionPropertiesauf "SAS" fest. Legen Sie für den Typ ServicePrincipalAuthTypeWorkspaceConnectionProperties auf "ServicePrincipal" fest. Legen Sie für den Typ UsernamePasswordAuthTypeWorkspaceConnectionPropertiesauf "UsernamePassword" fest. "AccessKey"
'ApiKey'
'Benutzerdefinierte Schlüssel'
"ManagedIdentity"
"Keine"
"PAT"
"SAS"
'ServicePrincipal'
"UsernamePassword" (erforderlich)
Kategorie Kategorie der Verbindung 'ADLSGen2'
'ApiKey'
'AzureMySqlDb'
"AzureOpenAI"
'AzurePostgresDb'
'AzureSqlDb'
"AzureSynapseAnalytics"
"CognitiveSearch"
"CognitiveService"
'Container-Registrierung'
'Benutzerdefinierte Schlüssel'
'Git'
"PythonFeed"
"Redis"
'S3'
'Schneeflake'
AblaufZeit Schnur
isSharedToAll Gibt an, ob diese Verbindung für den gesamten Projektarbeitsbereich unter dem Hub freigegeben wird. Bool
Metadaten Jedes Objekt jegliche
Ziel Schnur

WorkspaceConnectionServicePrincipal

Name Beschreibung Wert
clientId (englisch) Schnur
Kundengeheimnis Schnur
Mandanten-ID Schnur

WorkspaceConnectionSharedAccessSignature

Name Beschreibung Wert
Sas Schnur

WorkspaceConnectionUsernamePassword

Name Beschreibung Wert
Passwort Schnur
Nutzername Schnur