Microsoft.CognitiveServices-Konten 2022-10-01
Bicep-Ressourcendefinition
Der Ressourcentyp "Konten" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
- Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.CognitiveServices/Accounts-Ressource zu erstellen, fügen Sie Ihrer Vorlage den folgenden Bicep hinzu.
resource symbolicname 'Microsoft.CognitiveServices/accounts@2022-10-01' = {
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
kind: 'string'
location: 'string'
name: 'string'
properties: {
allowedFqdnList: [
'string'
]
apiProperties: {
aadClientId: 'string'
aadTenantId: 'string'
eventHubConnectionString: 'string'
qnaAzureSearchEndpointId: 'string'
qnaAzureSearchEndpointKey: 'string'
qnaRuntimeEndpoint: 'string'
statisticsEnabled: bool
storageAccountConnectionString: 'string'
superUser: 'string'
websiteName: 'string'
}
customSubDomainName: 'string'
disableLocalAuth: bool
dynamicThrottlingEnabled: bool
encryption: {
keySource: 'string'
keyVaultProperties: {
identityClientId: 'string'
keyName: 'string'
keyVaultUri: 'string'
keyVersion: 'string'
}
}
migrationToken: 'string'
networkAcls: {
defaultAction: 'string'
ipRules: [
{
value: 'string'
}
]
virtualNetworkRules: [
{
id: 'string'
ignoreMissingVnetServiceEndpoint: bool
state: 'string'
}
]
}
publicNetworkAccess: 'string'
restore: bool
restrictOutboundNetworkAccess: bool
userOwnedStorage: [
{
identityClientId: 'string'
resourceId: 'string'
}
]
}
sku: {
capacity: int
family: 'string'
name: 'string'
size: 'string'
tier: 'string'
}
tags: {
{customized property}: 'string'
}
}
Eigenschaftswerte
AccountProperties
| Name | Beschreibung | Wert |
|---|---|---|
| allowedFqdnList | string[] | |
| apiProperties | Die API-Eigenschaften für spezielle APIs. | ApiProperties- |
| customSubDomainName | Optionaler Unterdomänenname, der für die tokenbasierte Authentifizierung verwendet wird. | Schnur |
| disableLocalAuth | Bool | |
| dynamicThrottlingEnabled | Die Kennzeichnung zum Aktivieren der dynamischen Drosselung. | Bool |
| Verschlüsselung | Die Verschlüsselungseigenschaften für diese Ressource. | Verschlüsselungs- |
| migrationToken | Ressourcenmigrationstoken. | Schnur |
| networkAcls | Eine Sammlung von Regeln für die Barrierefreiheit von bestimmten Netzwerkstandorten. | NetworkRuleSet- |
| publicNetworkAccess | Gibt an, ob der Zugriff auf öffentliche Endpunkte für dieses Konto zulässig ist. | "Deaktiviert" "Aktiviert" |
| wiederherstellen | Bool | |
| restrictOutboundNetworkAccess | Bool | |
| userOwnedStorage | Die Speicherkonten für diese Ressource. | UserOwnedStorage[] |
AccountTags
| Name | Beschreibung | Wert |
|---|
ApiProperties
| Name | Beschreibung | Wert |
|---|---|---|
| aadClientId | (Nur Metrikenratgeber) Die Azure AD-Client-ID (Anwendungs-ID). | Schnur Zwänge: Max. Länge = 500 |
| aadTenantId | (Nur Metrikenratgeber) Die Azure AD-Mandanten-ID. | Schnur Zwänge: Max. Länge = 500 |
| eventHubConnectionString | (Nur Personalisierung) Das Kennzeichen zum Aktivieren von Statistiken von Bing Search. | Schnur Zwänge: Maximale Länge = 1000 Pattern = ^( *)Endpoint=sb://(.*);( *)SharedAccessKeyName=(.*);( *)SharedAccessKey=(.*)$ |
| qnaAzureSearchEndpointId | (Nur QnAMaker) Die Azure Search-Endpunkt-ID von QnAMaker. | Schnur |
| qnaAzureSearchEndpointKey | (Nur QnAMaker) Der Azure Search-Endpunktschlüssel von QnAMaker. | Schnur |
| qnaRuntimeEndpoint | (Nur QnAMaker) Der Laufzeitendpunkt von QnAMaker. | Schnur |
| statisticsEnabled | (Nur Bing-Suche) Das Kennzeichen zum Aktivieren von Statistiken von Bing Search. | Bool |
| storageAccountConnectionString | (Nur Personalisierung) Die Verbindungszeichenfolge des Speicherkontos. | Schnur Zwänge: Maximale Länge = 1000 Pattern = ^(( *)DefaultEndpointsProtocol=(http|https)( *);( *))?AccountName=(.*)AccountKey=(.*)EndpointSuffix=(.*)$ |
| Superuser | (Nur Metrikenratgeber) Der Superbenutzer von Metrics Advisor. | Schnur Zwänge: Max. Länge = 500 |
| websiteName | (Nur Metrikenratgeber) Der Websitename von Metrics Advisor. | Schnur Zwänge: Max. Länge = 500 |
Verschlüsselung
| Name | Beschreibung | Wert |
|---|---|---|
| keySource | Listet den möglichen Wert von keySource für Verschlüsselung auf. | "Microsoft.CognitiveServices" "Microsoft.KeyVault" |
| keyVaultProperties | Eigenschaften von KeyVault | KeyVaultProperties |
Identität
| Name | Beschreibung | Wert |
|---|---|---|
| Art | Der Identitätstyp. | 'None' 'SystemAssigned' "SystemAssigned, UserAssigned" "UserAssigned" |
| userAssignedIdentities | Die Liste der benutzer zugewiesenen Identitäten, die der Ressource zugeordnet sind. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} | IdentityUserAssignedIdentities |
IdentityUserAssignedIdentities
| Name | Beschreibung | Wert |
|---|
IpRule
| Name | Beschreibung | Wert |
|---|---|---|
| Wert | Ein IPv4-Adressbereich in CIDR-Notation, z. B. "124.56.78.91" (einfache IP-Adresse) oder "124.56.78.0/24" (alle Adressen, die mit 124.56.78 beginnen). | Zeichenfolge (erforderlich) |
KeyVaultProperties
| Name | Beschreibung | Wert |
|---|---|---|
| identityClientId | Schnur | |
| keyName | Name des Schlüssels von KeyVault | Schnur |
| keyVaultUri | URI von KeyVault | Schnur |
| keyVersion | Version des Schlüssels von KeyVault | Schnur |
Microsoft.CognitiveServices/Konten
| Name | Beschreibung | Wert |
|---|---|---|
| Identität | Identität für die Ressource. | Identity |
| Art | Die Art der Ressource. | Schnur |
| Ort | Der geografische Standort, an dem sich die Ressource befindet | Schnur |
| Name | Der Ressourcenname | Schnur Zwänge: Min. Länge = 2 Max. Länge = 64 Pattern = ^[a-zA-Z0-9][a-zA-Z0-9_.-]*$ (erforderlich) |
| Eigenschaften | Eigenschaften des Cognitive Services-Kontos. | AccountProperties- |
| Sku | Die Definition des Ressourcenmodells, die SKU darstellt | Sku- |
| Schilder | Ressourcentags | Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen |
NetworkRuleSet
| Name | Beschreibung | Wert |
|---|---|---|
| defaultAction | Die Standardaktion, wenn keine Regel von "ipRules" und "virtualNetworkRules" übereinstimmen. Dies wird nur verwendet, nachdem die Umgehungseigenschaft ausgewertet wurde. | "Zulassen" "Ablehnen" |
| ipRules | Die Liste der IP-Adressregeln. | IpRule-[] |
| virtualNetworkRules | Die Liste der Regeln für virtuelle Netzwerke. | VirtualNetworkRule[] |
Sku
| Name | Beschreibung | Wert |
|---|---|---|
| Fassungsvermögen | Wenn die SKU skalierungs-/in unterstützt, sollte die Ganze Kapazität eingeschlossen werden. Wenn eine Skalierung für die Ressource nicht möglich ist, wird dies möglicherweise weggelassen. | Int |
| Familie | Wenn der Dienst über unterschiedliche Hardwaregenerationen verfügt, kann dies für dieselbe SKU hier erfasst werden. | Schnur |
| Name | Der Name der SKU. Ex - P3. Es handelt sich in der Regel um einen Buchstaben+Zahlencode. | Zeichenfolge (erforderlich) |
| Größe | Die SKU-Größe. Wenn das Namensfeld die Kombination aus Ebene und einem anderen Wert ist, wäre dies der eigenständige Code. | Schnur |
| Rang | Dieses Feld muss vom Ressourcenanbieter implementiert werden, wenn der Dienst mehr als eine Ebene aufweist, für einen PUT jedoch nicht erforderlich ist. | "Einfach" "Enterprise" "Kostenlos" "Premium" "Standard" |
UserAssignedIdentity
| Name | Beschreibung | Wert |
|---|
UserOwnedStorage
| Name | Beschreibung | Wert |
|---|---|---|
| identityClientId | Schnur | |
| resourceId | Vollständige Ressourcen-ID einer Microsoft.Storage-Ressource. | Schnur |
VirtualNetworkRule
| Name | Beschreibung | Wert |
|---|---|---|
| id | Vollständige Ressourcen-ID eines vnet-Subnetzes, z. B. "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1". | Zeichenfolge (erforderlich) |
| ignoreMissingVnetServiceEndpoint | Fehlender vnet-Dienstendpunkt ignorieren oder nicht. | Bool |
| Zustand | Ruft den Status der virtuellen Netzwerkregel ab. | Schnur |
Verwendungsbeispiele
Von Azure verifizierte Module
Die folgenden Azure Verified Modules können verwendet werden, um diesen Ressourcentyp bereitzustellen.
| Modul | Beschreibung |
|---|---|
| Azure AI Services (Cognitive Services) | AVM-Ressourcenmodul für Azure AI Services (Cognitive Services) |
Azure-Schnellstartbeispiele
Die folgenden Azure-Schnellstartvorlagen Bicep-Beispiele für die Bereitstellung dieses Ressourcentyps enthalten.
| Bicep-Datei | Beschreibung |
|---|---|
| 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 – 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 – 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 Network Restricted | 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. |
| Azure AI Studio Network Restricted | 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. |
| Azure AI Studio mit Microsoft Entra ID-Authentifizierung | Dieser Satz von Vorlagen veranschaulicht, wie Sie Azure AI Studio mit der Microsoft Entra ID-Authentifizierung für abhängige Ressourcen einrichten, z. B. Azure AI Services und Azure Storage. |
| 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. |
| Basic Agent Setup Identity | 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 einer Azure AI Services-Multi-Service-Ressource | Diese Vorlage stellt eine Azure AI-Dienstressource bereit, um KI in Reichweite jedes Entwicklers zu bringen, ohne dass maschinelles Lernen erforderlich ist. Alles, was es erfordert, ist ein API-Aufruf, um die Möglichkeit einzubetten, zu sehen, zu hören, zu sprechen, zu suchen, zu verstehen und die Entscheidungsfindung in Ihre Apps zu beschleunigen. |
| Bereitstellen einer Azure AI Translator-Ressource | Diese Vorlage stellt eine Azure AI Translator-Ressource bereit, um KI in Reichweite jedes Entwicklers zu bringen, ohne dass maschinelles Lernen erforderlich ist. |
| Bereitstellen einer Azure AI Vision-Ressource | Diese Vorlage stellt eine Azure AI Vision-Ressource bereit, um KI in Reichweite jedes Entwicklers zu bringen, ohne dass maschinelles Lernen erforderlich ist. |
| Bereitstellen von secure Azure AI Studio mit einem verwalteten virtuellen Netzwerk | Diese Vorlage erstellt eine sichere Azure AI Studio-Umgebung mit robusten Netzwerk- und Identitätssicherheitseinschränkungen. |
| 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 "Konten" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
- Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.CognitiveServices/Accounts-Ressource zu erstellen, fügen Sie Ihrer Vorlage den folgenden JSON-Code hinzu.
{
"type": "Microsoft.CognitiveServices/accounts",
"apiVersion": "2022-10-01",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"kind": "string",
"location": "string",
"properties": {
"allowedFqdnList": [ "string" ],
"apiProperties": {
"aadClientId": "string",
"aadTenantId": "string",
"eventHubConnectionString": "string",
"qnaAzureSearchEndpointId": "string",
"qnaAzureSearchEndpointKey": "string",
"qnaRuntimeEndpoint": "string",
"statisticsEnabled": "bool",
"storageAccountConnectionString": "string",
"superUser": "string",
"websiteName": "string"
},
"customSubDomainName": "string",
"disableLocalAuth": "bool",
"dynamicThrottlingEnabled": "bool",
"encryption": {
"keySource": "string",
"keyVaultProperties": {
"identityClientId": "string",
"keyName": "string",
"keyVaultUri": "string",
"keyVersion": "string"
}
},
"migrationToken": "string",
"networkAcls": {
"defaultAction": "string",
"ipRules": [
{
"value": "string"
}
],
"virtualNetworkRules": [
{
"id": "string",
"ignoreMissingVnetServiceEndpoint": "bool",
"state": "string"
}
]
},
"publicNetworkAccess": "string",
"restore": "bool",
"restrictOutboundNetworkAccess": "bool",
"userOwnedStorage": [
{
"identityClientId": "string",
"resourceId": "string"
}
]
},
"sku": {
"capacity": "int",
"family": "string",
"name": "string",
"size": "string",
"tier": "string"
},
"tags": {
"{customized property}": "string"
}
}
Eigenschaftswerte
AccountProperties
| Name | Beschreibung | Wert |
|---|---|---|
| allowedFqdnList | string[] | |
| apiProperties | Die API-Eigenschaften für spezielle APIs. | ApiProperties- |
| customSubDomainName | Optionaler Unterdomänenname, der für die tokenbasierte Authentifizierung verwendet wird. | Schnur |
| disableLocalAuth | Bool | |
| dynamicThrottlingEnabled | Die Kennzeichnung zum Aktivieren der dynamischen Drosselung. | Bool |
| Verschlüsselung | Die Verschlüsselungseigenschaften für diese Ressource. | Verschlüsselungs- |
| migrationToken | Ressourcenmigrationstoken. | Schnur |
| networkAcls | Eine Sammlung von Regeln für die Barrierefreiheit von bestimmten Netzwerkstandorten. | NetworkRuleSet- |
| publicNetworkAccess | Gibt an, ob der Zugriff auf öffentliche Endpunkte für dieses Konto zulässig ist. | "Deaktiviert" "Aktiviert" |
| wiederherstellen | Bool | |
| restrictOutboundNetworkAccess | Bool | |
| userOwnedStorage | Die Speicherkonten für diese Ressource. | UserOwnedStorage[] |
AccountTags
| Name | Beschreibung | Wert |
|---|
ApiProperties
| Name | Beschreibung | Wert |
|---|---|---|
| aadClientId | (Nur Metrikenratgeber) Die Azure AD-Client-ID (Anwendungs-ID). | Schnur Zwänge: Max. Länge = 500 |
| aadTenantId | (Nur Metrikenratgeber) Die Azure AD-Mandanten-ID. | Schnur Zwänge: Max. Länge = 500 |
| eventHubConnectionString | (Nur Personalisierung) Das Kennzeichen zum Aktivieren von Statistiken von Bing Search. | Schnur Zwänge: Maximale Länge = 1000 Pattern = ^( *)Endpoint=sb://(.*);( *)SharedAccessKeyName=(.*);( *)SharedAccessKey=(.*)$ |
| qnaAzureSearchEndpointId | (Nur QnAMaker) Die Azure Search-Endpunkt-ID von QnAMaker. | Schnur |
| qnaAzureSearchEndpointKey | (Nur QnAMaker) Der Azure Search-Endpunktschlüssel von QnAMaker. | Schnur |
| qnaRuntimeEndpoint | (Nur QnAMaker) Der Laufzeitendpunkt von QnAMaker. | Schnur |
| statisticsEnabled | (Nur Bing-Suche) Das Kennzeichen zum Aktivieren von Statistiken von Bing Search. | Bool |
| storageAccountConnectionString | (Nur Personalisierung) Die Verbindungszeichenfolge des Speicherkontos. | Schnur Zwänge: Maximale Länge = 1000 Pattern = ^(( *)DefaultEndpointsProtocol=(http|https)( *);( *))?AccountName=(.*)AccountKey=(.*)EndpointSuffix=(.*)$ |
| Superuser | (Nur Metrikenratgeber) Der Superbenutzer von Metrics Advisor. | Schnur Zwänge: Max. Länge = 500 |
| websiteName | (Nur Metrikenratgeber) Der Websitename von Metrics Advisor. | Schnur Zwänge: Max. Länge = 500 |
Verschlüsselung
| Name | Beschreibung | Wert |
|---|---|---|
| keySource | Listet den möglichen Wert von keySource für Verschlüsselung auf. | "Microsoft.CognitiveServices" "Microsoft.KeyVault" |
| keyVaultProperties | Eigenschaften von KeyVault | KeyVaultProperties |
Identität
| Name | Beschreibung | Wert |
|---|---|---|
| Art | Der Identitätstyp. | 'None' 'SystemAssigned' "SystemAssigned, UserAssigned" "UserAssigned" |
| userAssignedIdentities | Die Liste der benutzer zugewiesenen Identitäten, die der Ressource zugeordnet sind. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} | IdentityUserAssignedIdentities |
IdentityUserAssignedIdentities
| Name | Beschreibung | Wert |
|---|
IpRule
| Name | Beschreibung | Wert |
|---|---|---|
| Wert | Ein IPv4-Adressbereich in CIDR-Notation, z. B. "124.56.78.91" (einfache IP-Adresse) oder "124.56.78.0/24" (alle Adressen, die mit 124.56.78 beginnen). | Zeichenfolge (erforderlich) |
KeyVaultProperties
| Name | Beschreibung | Wert |
|---|---|---|
| identityClientId | Schnur | |
| keyName | Name des Schlüssels von KeyVault | Schnur |
| keyVaultUri | URI von KeyVault | Schnur |
| keyVersion | Version des Schlüssels von KeyVault | Schnur |
Microsoft.CognitiveServices/Konten
| Name | Beschreibung | Wert |
|---|---|---|
| apiVersion | Die API-Version | '2022-10-01' |
| Identität | Identität für die Ressource. | Identity |
| Art | Die Art der Ressource. | Schnur |
| Ort | Der geografische Standort, an dem sich die Ressource befindet | Schnur |
| Name | Der Ressourcenname | Schnur Zwänge: Min. Länge = 2 Max. Länge = 64 Pattern = ^[a-zA-Z0-9][a-zA-Z0-9_.-]*$ (erforderlich) |
| Eigenschaften | Eigenschaften des Cognitive Services-Kontos. | AccountProperties- |
| Sku | Die Definition des Ressourcenmodells, die SKU darstellt | Sku- |
| Schilder | Ressourcentags | Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen |
| Art | Der Ressourcentyp | "Microsoft.CognitiveServices/accounts" |
NetworkRuleSet
| Name | Beschreibung | Wert |
|---|---|---|
| defaultAction | Die Standardaktion, wenn keine Regel von "ipRules" und "virtualNetworkRules" übereinstimmen. Dies wird nur verwendet, nachdem die Umgehungseigenschaft ausgewertet wurde. | "Zulassen" "Ablehnen" |
| ipRules | Die Liste der IP-Adressregeln. | IpRule-[] |
| virtualNetworkRules | Die Liste der Regeln für virtuelle Netzwerke. | VirtualNetworkRule[] |
Sku
| Name | Beschreibung | Wert |
|---|---|---|
| Fassungsvermögen | Wenn die SKU skalierungs-/in unterstützt, sollte die Ganze Kapazität eingeschlossen werden. Wenn eine Skalierung für die Ressource nicht möglich ist, wird dies möglicherweise weggelassen. | Int |
| Familie | Wenn der Dienst über unterschiedliche Hardwaregenerationen verfügt, kann dies für dieselbe SKU hier erfasst werden. | Schnur |
| Name | Der Name der SKU. Ex - P3. Es handelt sich in der Regel um einen Buchstaben+Zahlencode. | Zeichenfolge (erforderlich) |
| Größe | Die SKU-Größe. Wenn das Namensfeld die Kombination aus Ebene und einem anderen Wert ist, wäre dies der eigenständige Code. | Schnur |
| Rang | Dieses Feld muss vom Ressourcenanbieter implementiert werden, wenn der Dienst mehr als eine Ebene aufweist, für einen PUT jedoch nicht erforderlich ist. | "Einfach" "Enterprise" "Kostenlos" "Premium" "Standard" |
UserAssignedIdentity
| Name | Beschreibung | Wert |
|---|
UserOwnedStorage
| Name | Beschreibung | Wert |
|---|---|---|
| identityClientId | Schnur | |
| resourceId | Vollständige Ressourcen-ID einer Microsoft.Storage-Ressource. | Schnur |
VirtualNetworkRule
| Name | Beschreibung | Wert |
|---|---|---|
| id | Vollständige Ressourcen-ID eines vnet-Subnetzes, z. B. "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1". | Zeichenfolge (erforderlich) |
| ignoreMissingVnetServiceEndpoint | Fehlender vnet-Dienstendpunkt ignorieren oder nicht. | Bool |
| Zustand | Ruft den Status der virtuellen Netzwerkregel ab. | Schnur |
Verwendungsbeispiele
Azure-Schnellstartvorlagen
Die folgenden Azure-Schnellstartvorlagen diesen Ressourcentyp bereitstellen.
| Schablone | Beschreibung |
|---|---|
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 – 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 – 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 Network Restricted
|
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. |
|
Azure AI Studio Network Restricted
|
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. |
|
Azure AI Studio mit Microsoft Entra ID-Authentifizierung
|
Dieser Satz von Vorlagen veranschaulicht, wie Sie Azure AI Studio mit der Microsoft Entra ID-Authentifizierung für abhängige Ressourcen einrichten, z. B. Azure AI Services und Azure Storage. |
|
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. |
|
Basic Agent Setup Identity
|
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 einer Azure AI Services-Multi-Service-Ressource
|
Diese Vorlage stellt eine Azure AI-Dienstressource bereit, um KI in Reichweite jedes Entwicklers zu bringen, ohne dass maschinelles Lernen erforderlich ist. Alles, was es erfordert, ist ein API-Aufruf, um die Möglichkeit einzubetten, zu sehen, zu hören, zu sprechen, zu suchen, zu verstehen und die Entscheidungsfindung in Ihre Apps zu beschleunigen. |
|
Bereitstellen einer Azure AI Translator-Ressource
|
Diese Vorlage stellt eine Azure AI Translator-Ressource bereit, um KI in Reichweite jedes Entwicklers zu bringen, ohne dass maschinelles Lernen erforderlich ist. |
|
Bereitstellen einer Azure AI Vision-Ressource
|
Diese Vorlage stellt eine Azure AI Vision-Ressource bereit, um KI in Reichweite jedes Entwicklers zu bringen, ohne dass maschinelles Lernen erforderlich ist. |
|
Bereitstellen von secure Azure AI Studio mit einem verwalteten virtuellen Netzwerk
|
Diese Vorlage erstellt eine sichere Azure AI Studio-Umgebung mit robusten Netzwerk- und Identitätssicherheitseinschränkungen. |
|
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. |
Terraform -Ressourcendefinition (AzAPI-Anbieter)
Der Ressourcentyp "Konten" 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.CognitiveServices/Accounts-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.CognitiveServices/accounts@2022-10-01"
name = "string"
identity = {
type = "string"
userAssignedIdentities = {
{customized property} = {
}
}
}
kind = "string"
location = "string"
sku = {
capacity = int
family = "string"
name = "string"
size = "string"
tier = "string"
}
tags = {
{customized property} = "string"
}
body = jsonencode({
properties = {
allowedFqdnList = [
"string"
]
apiProperties = {
aadClientId = "string"
aadTenantId = "string"
eventHubConnectionString = "string"
qnaAzureSearchEndpointId = "string"
qnaAzureSearchEndpointKey = "string"
qnaRuntimeEndpoint = "string"
statisticsEnabled = bool
storageAccountConnectionString = "string"
superUser = "string"
websiteName = "string"
}
customSubDomainName = "string"
disableLocalAuth = bool
dynamicThrottlingEnabled = bool
encryption = {
keySource = "string"
keyVaultProperties = {
identityClientId = "string"
keyName = "string"
keyVaultUri = "string"
keyVersion = "string"
}
}
migrationToken = "string"
networkAcls = {
defaultAction = "string"
ipRules = [
{
value = "string"
}
]
virtualNetworkRules = [
{
id = "string"
ignoreMissingVnetServiceEndpoint = bool
state = "string"
}
]
}
publicNetworkAccess = "string"
restore = bool
restrictOutboundNetworkAccess = bool
userOwnedStorage = [
{
identityClientId = "string"
resourceId = "string"
}
]
}
})
}
Eigenschaftswerte
AccountProperties
| Name | Beschreibung | Wert |
|---|---|---|
| allowedFqdnList | string[] | |
| apiProperties | Die API-Eigenschaften für spezielle APIs. | ApiProperties- |
| customSubDomainName | Optionaler Unterdomänenname, der für die tokenbasierte Authentifizierung verwendet wird. | Schnur |
| disableLocalAuth | Bool | |
| dynamicThrottlingEnabled | Die Kennzeichnung zum Aktivieren der dynamischen Drosselung. | Bool |
| Verschlüsselung | Die Verschlüsselungseigenschaften für diese Ressource. | Verschlüsselungs- |
| migrationToken | Ressourcenmigrationstoken. | Schnur |
| networkAcls | Eine Sammlung von Regeln für die Barrierefreiheit von bestimmten Netzwerkstandorten. | NetworkRuleSet- |
| publicNetworkAccess | Gibt an, ob der Zugriff auf öffentliche Endpunkte für dieses Konto zulässig ist. | "Deaktiviert" "Aktiviert" |
| wiederherstellen | Bool | |
| restrictOutboundNetworkAccess | Bool | |
| userOwnedStorage | Die Speicherkonten für diese Ressource. | UserOwnedStorage[] |
AccountTags
| Name | Beschreibung | Wert |
|---|
ApiProperties
| Name | Beschreibung | Wert |
|---|---|---|
| aadClientId | (Nur Metrikenratgeber) Die Azure AD-Client-ID (Anwendungs-ID). | Schnur Zwänge: Max. Länge = 500 |
| aadTenantId | (Nur Metrikenratgeber) Die Azure AD-Mandanten-ID. | Schnur Zwänge: Max. Länge = 500 |
| eventHubConnectionString | (Nur Personalisierung) Das Kennzeichen zum Aktivieren von Statistiken von Bing Search. | Schnur Zwänge: Maximale Länge = 1000 Pattern = ^( *)Endpoint=sb://(.*);( *)SharedAccessKeyName=(.*);( *)SharedAccessKey=(.*)$ |
| qnaAzureSearchEndpointId | (Nur QnAMaker) Die Azure Search-Endpunkt-ID von QnAMaker. | Schnur |
| qnaAzureSearchEndpointKey | (Nur QnAMaker) Der Azure Search-Endpunktschlüssel von QnAMaker. | Schnur |
| qnaRuntimeEndpoint | (Nur QnAMaker) Der Laufzeitendpunkt von QnAMaker. | Schnur |
| statisticsEnabled | (Nur Bing-Suche) Das Kennzeichen zum Aktivieren von Statistiken von Bing Search. | Bool |
| storageAccountConnectionString | (Nur Personalisierung) Die Verbindungszeichenfolge des Speicherkontos. | Schnur Zwänge: Maximale Länge = 1000 Pattern = ^(( *)DefaultEndpointsProtocol=(http|https)( *);( *))?AccountName=(.*)AccountKey=(.*)EndpointSuffix=(.*)$ |
| Superuser | (Nur Metrikenratgeber) Der Superbenutzer von Metrics Advisor. | Schnur Zwänge: Max. Länge = 500 |
| websiteName | (Nur Metrikenratgeber) Der Websitename von Metrics Advisor. | Schnur Zwänge: Max. Länge = 500 |
Verschlüsselung
| Name | Beschreibung | Wert |
|---|---|---|
| keySource | Listet den möglichen Wert von keySource für Verschlüsselung auf. | "Microsoft.CognitiveServices" "Microsoft.KeyVault" |
| keyVaultProperties | Eigenschaften von KeyVault | KeyVaultProperties |
Identität
| Name | Beschreibung | Wert |
|---|---|---|
| Art | Der Identitätstyp. | 'None' 'SystemAssigned' "SystemAssigned, UserAssigned" "UserAssigned" |
| userAssignedIdentities | Die Liste der benutzer zugewiesenen Identitäten, die der Ressource zugeordnet sind. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} | IdentityUserAssignedIdentities |
IdentityUserAssignedIdentities
| Name | Beschreibung | Wert |
|---|
IpRule
| Name | Beschreibung | Wert |
|---|---|---|
| Wert | Ein IPv4-Adressbereich in CIDR-Notation, z. B. "124.56.78.91" (einfache IP-Adresse) oder "124.56.78.0/24" (alle Adressen, die mit 124.56.78 beginnen). | Zeichenfolge (erforderlich) |
KeyVaultProperties
| Name | Beschreibung | Wert |
|---|---|---|
| identityClientId | Schnur | |
| keyName | Name des Schlüssels von KeyVault | Schnur |
| keyVaultUri | URI von KeyVault | Schnur |
| keyVersion | Version des Schlüssels von KeyVault | Schnur |
Microsoft.CognitiveServices/Konten
| Name | Beschreibung | Wert |
|---|---|---|
| Identität | Identität für die Ressource. | Identity |
| Art | Die Art der Ressource. | Schnur |
| Ort | Der geografische Standort, an dem sich die Ressource befindet | Schnur |
| Name | Der Ressourcenname | Schnur Zwänge: Min. Länge = 2 Max. Länge = 64 Pattern = ^[a-zA-Z0-9][a-zA-Z0-9_.-]*$ (erforderlich) |
| Eigenschaften | Eigenschaften des Cognitive Services-Kontos. | AccountProperties- |
| Sku | Die Definition des Ressourcenmodells, die SKU darstellt | Sku- |
| Schilder | Ressourcentags | Wörterbuch der Tagnamen und -werte. |
| Art | Der Ressourcentyp | "Microsoft.CognitiveServices/accounts@2022-10-01" |
NetworkRuleSet
| Name | Beschreibung | Wert |
|---|---|---|
| defaultAction | Die Standardaktion, wenn keine Regel von "ipRules" und "virtualNetworkRules" übereinstimmen. Dies wird nur verwendet, nachdem die Umgehungseigenschaft ausgewertet wurde. | "Zulassen" "Ablehnen" |
| ipRules | Die Liste der IP-Adressregeln. | IpRule-[] |
| virtualNetworkRules | Die Liste der Regeln für virtuelle Netzwerke. | VirtualNetworkRule[] |
Sku
| Name | Beschreibung | Wert |
|---|---|---|
| Fassungsvermögen | Wenn die SKU skalierungs-/in unterstützt, sollte die Ganze Kapazität eingeschlossen werden. Wenn eine Skalierung für die Ressource nicht möglich ist, wird dies möglicherweise weggelassen. | Int |
| Familie | Wenn der Dienst über unterschiedliche Hardwaregenerationen verfügt, kann dies für dieselbe SKU hier erfasst werden. | Schnur |
| Name | Der Name der SKU. Ex - P3. Es handelt sich in der Regel um einen Buchstaben+Zahlencode. | Zeichenfolge (erforderlich) |
| Größe | Die SKU-Größe. Wenn das Namensfeld die Kombination aus Ebene und einem anderen Wert ist, wäre dies der eigenständige Code. | Schnur |
| Rang | Dieses Feld muss vom Ressourcenanbieter implementiert werden, wenn der Dienst mehr als eine Ebene aufweist, für einen PUT jedoch nicht erforderlich ist. | "Einfach" "Enterprise" "Kostenlos" "Premium" "Standard" |
UserAssignedIdentity
| Name | Beschreibung | Wert |
|---|
UserOwnedStorage
| Name | Beschreibung | Wert |
|---|---|---|
| identityClientId | Schnur | |
| resourceId | Vollständige Ressourcen-ID einer Microsoft.Storage-Ressource. | Schnur |
VirtualNetworkRule
| Name | Beschreibung | Wert |
|---|---|---|
| id | Vollständige Ressourcen-ID eines vnet-Subnetzes, z. B. "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1". | Zeichenfolge (erforderlich) |
| ignoreMissingVnetServiceEndpoint | Fehlender vnet-Dienstendpunkt ignorieren oder nicht. | Bool |
| Zustand | Ruft den Status der virtuellen Netzwerkregel ab. | Schnur |
Verwendungsbeispiele
Von Azure verifizierte Module
Die folgenden Azure Verified Modules können verwendet werden, um diesen Ressourcentyp bereitzustellen.
| Modul | Beschreibung |
|---|---|
| Cognitive Service | AVM Resource Module for Cognitive Services account ( Open AI) |