Microsoft.CognitiveServices-Konten
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@2023-05-01' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
sku: {
capacity: int
family: 'string'
name: 'string'
size: 'string'
tier: 'string'
}
kind: 'string'
identity: {
type: 'string'
userAssignedIdentities: {}
}
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'
}
}
locations: {
regions: [
{
customsubdomain: 'string'
name: 'string'
value: int
}
]
routingMethod: '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
Konten
Name | Beschreibung | Wert |
---|---|---|
Name | Der Ressourcenname | Zeichenfolge (erforderlich) Zeichenlimit: 2-64 Gültige Zeichen: Alphanumerische und Bindestriche. Beginnen und enden Sie mit alphanumerisch. |
Ort | Der geografische Standort, an dem sich die Ressource befindet | Schnur |
Schilder | Ressourcentags. | Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen |
Sku | Die Definition des Ressourcenmodells, die SKU darstellt | Sku- |
Art | Die Art der Ressource. | Schnur |
Identität | Identität für die Ressource. | Identity |
Eigenschaften | Eigenschaften des Cognitive Services-Kontos. | AccountProperties- |
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} | Objekt |
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- |
Orte | Die Multiregion-Einstellungen des Cognitive Services-Kontos. | MultiRegionSettings |
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[] |
ApiProperties
Name | Beschreibung | Wert |
---|---|---|
aadClientId | (Nur Metrikenratgeber) Die Azure AD-Client-ID (Anwendungs-ID). | Schnur |
aadTenantId | (Nur Metrikenratgeber) Die Azure AD-Mandanten-ID. | Schnur |
eventHubConnectionString | (Nur Personalisierung) Das Kennzeichen zum Aktivieren von Statistiken von Bing Search. | Schnur |
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 |
Superuser | (Nur Metrikenratgeber) Der Superbenutzer von Metrics Advisor. | Schnur |
websiteName | (Nur Metrikenratgeber) Der Websitename von Metrics Advisor. | Schnur |
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 |
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 |
MultiRegionSettings
Name | Beschreibung | Wert |
---|---|---|
Regionen | RegionSetting[] | |
routingMethod | Multiregion-Routingmethoden. | "Leistung" "Priorität" "Gewichtet" |
RegionSetting
Name | Beschreibung | Wert |
---|---|---|
customsubdomain | Ordnet die Region der regionalen benutzerdefinierten Unterdomäne zu. | Schnur |
Name | Name der Region. | Schnur |
Wert | Ein Wert für Prioritäts- oder Gewichtungsroutingmethoden. | Int |
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[] |
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) |
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 |
UserOwnedStorage
Name | Beschreibung | Wert |
---|---|---|
identityClientId | Schnur | |
resourceId | Vollständige Ressourcen-ID einer Microsoft.Storage-Ressource. | Schnur |
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" |
Schnellstartvorlagen
Die folgenden Schnellstartvorlagen stellen diesen Ressourcentyp bereit.
Schablone | Beschreibung |
---|---|
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 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 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. |
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 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. |
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": "2023-05-01",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"sku": {
"capacity": "int",
"family": "string",
"name": "string",
"size": "string",
"tier": "string"
},
"kind": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {}
},
"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"
}
},
"locations": {
"regions": [
{
"customsubdomain": "string",
"name": "string",
"value": "int"
}
],
"routingMethod": "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
Konten
Name | Beschreibung | Wert |
---|---|---|
Art | Der Ressourcentyp | "Microsoft.CognitiveServices/accounts" |
apiVersion | Die Ressourcen-API-Version | '2023-05-01' |
Name | Der Ressourcenname | Zeichenfolge (erforderlich) Zeichenlimit: 2-64 Gültige Zeichen: Alphanumerische und Bindestriche. Beginnen und enden Sie mit alphanumerisch. |
Ort | Der geografische Standort, an dem sich die Ressource befindet | Schnur |
Schilder | Ressourcentags. | Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen |
Sku | Die Definition des Ressourcenmodells, die SKU darstellt | Sku- |
Art | Die Art der Ressource. | Schnur |
Identität | Identität für die Ressource. | Identity |
Eigenschaften | Eigenschaften des Cognitive Services-Kontos. | AccountProperties- |
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} | Objekt |
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- |
Orte | Die Multiregion-Einstellungen des Cognitive Services-Kontos. | MultiRegionSettings |
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[] |
ApiProperties
Name | Beschreibung | Wert |
---|---|---|
aadClientId | (Nur Metrikenratgeber) Die Azure AD-Client-ID (Anwendungs-ID). | Schnur |
aadTenantId | (Nur Metrikenratgeber) Die Azure AD-Mandanten-ID. | Schnur |
eventHubConnectionString | (Nur Personalisierung) Das Kennzeichen zum Aktivieren von Statistiken von Bing Search. | Schnur |
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 |
Superuser | (Nur Metrikenratgeber) Der Superbenutzer von Metrics Advisor. | Schnur |
websiteName | (Nur Metrikenratgeber) Der Websitename von Metrics Advisor. | Schnur |
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 |
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 |
MultiRegionSettings
Name | Beschreibung | Wert |
---|---|---|
Regionen | RegionSetting[] | |
routingMethod | Multiregion-Routingmethoden. | "Leistung" "Priorität" "Gewichtet" |
RegionSetting
Name | Beschreibung | Wert |
---|---|---|
customsubdomain | Ordnet die Region der regionalen benutzerdefinierten Unterdomäne zu. | Schnur |
Name | Name der Region. | Schnur |
Wert | Ein Wert für Prioritäts- oder Gewichtungsroutingmethoden. | Int |
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[] |
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) |
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 |
UserOwnedStorage
Name | Beschreibung | Wert |
---|---|---|
identityClientId | Schnur | |
resourceId | Vollständige Ressourcen-ID einer Microsoft.Storage-Ressource. | Schnur |
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" |
Schnellstartvorlagen
Die folgenden Schnellstartvorlagen stellen diesen Ressourcentyp bereit.
Schablone | Beschreibung |
---|---|
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 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 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. |
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 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. |
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@2023-05-01"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
identity {
type = "string"
identity_ids = []
}
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"
}
}
locations = {
regions = [
{
customsubdomain = "string"
name = "string"
value = int
}
]
routingMethod = "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"
}
kind = "string"
})
}
Eigenschaftswerte
Konten
Name | Beschreibung | Wert |
---|---|---|
Art | Der Ressourcentyp | "Microsoft.CognitiveServices/accounts@2023-05-01" |
Name | Der Ressourcenname | Zeichenfolge (erforderlich) Zeichenlimit: 2-64 Gültige Zeichen: Alphanumerische und Bindestriche. Beginnen und enden Sie mit alphanumerisch. |
Ort | Der geografische Standort, an dem sich die Ressource befindet | Schnur |
parent_id | Verwenden Sie die ID dieser Ressourcengruppe, um sie in einer Ressourcengruppe bereitzustellen. | Zeichenfolge (erforderlich) |
Schilder | Ressourcentags. | Wörterbuch der Tagnamen und -werte. |
Sku | Die Definition des Ressourcenmodells, die SKU darstellt | Sku- |
Art | Die Art der Ressource. | Schnur |
Identität | Identität für die Ressource. | Identity |
Eigenschaften | Eigenschaften des Cognitive Services-Kontos. | AccountProperties- |
Identität
Name | Beschreibung | Wert |
---|---|---|
Art | Der Identitätstyp. | "SystemAssigned" "SystemAssigned, UserAssigned" "UserAssigned" |
identity_ids | 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} | Array von Benutzeridentitäts-IDs. |
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- |
Orte | Die Multiregion-Einstellungen des Cognitive Services-Kontos. | MultiRegionSettings |
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[] |
ApiProperties
Name | Beschreibung | Wert |
---|---|---|
aadClientId | (Nur Metrikenratgeber) Die Azure AD-Client-ID (Anwendungs-ID). | Schnur |
aadTenantId | (Nur Metrikenratgeber) Die Azure AD-Mandanten-ID. | Schnur |
eventHubConnectionString | (Nur Personalisierung) Das Kennzeichen zum Aktivieren von Statistiken von Bing Search. | Schnur |
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 |
Superuser | (Nur Metrikenratgeber) Der Superbenutzer von Metrics Advisor. | Schnur |
websiteName | (Nur Metrikenratgeber) Der Websitename von Metrics Advisor. | Schnur |
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 |
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 |
MultiRegionSettings
Name | Beschreibung | Wert |
---|---|---|
Regionen | RegionSetting[] | |
routingMethod | Multiregion-Routingmethoden. | "Leistung" "Priorität" "Gewichtet" |
RegionSetting
Name | Beschreibung | Wert |
---|---|---|
customsubdomain | Ordnet die Region der regionalen benutzerdefinierten Unterdomäne zu. | Schnur |
Name | Name der Region. | Schnur |
Wert | Ein Wert für Prioritäts- oder Gewichtungsroutingmethoden. | Int |
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" "Verweigern" |
ipRules | Die Liste der IP-Adressregeln. | IpRule-[] |
virtualNetworkRules | Die Liste der Regeln für virtuelle Netzwerke. | VirtualNetworkRule[] |
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) |
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 |
UserOwnedStorage
Name | Beschreibung | Wert |
---|---|---|
identityClientId | Schnur | |
resourceId | Vollständige Ressourcen-ID einer Microsoft.Storage-Ressource. | Schnur |
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" |