Microsoft.CognitiveServices/accounts

Bicep-resourcedefinitie

Het resourcetype accounts kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Resourcegroepen - Zie opdrachten voor de implementatie van resourcegroepen

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Resource microsoft.CognitiveServices/accounts wilt maken, voegt u de volgende Bicep toe aan uw sjabloon.

resource symbolicname 'Microsoft.CognitiveServices/accounts@2024-10-01' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  kind: 'string'
  location: 'string'
  name: 'string'
  properties: {
    allowedFqdnList: [
      'string'
    ]
    amlWorkspace: {
      identityClientId: 'string'
      resourceId: '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: {
      bypass: 'string'
      defaultAction: 'string'
      ipRules: [
        {
          value: 'string'
        }
      ]
      virtualNetworkRules: [
        {
          id: 'string'
          ignoreMissingVnetServiceEndpoint: bool
          state: 'string'
        }
      ]
    }
    publicNetworkAccess: 'string'
    raiMonitorConfig: {
      adxStorageResourceId: 'string'
      identityClientId: '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'
  }
}

Eigenschapswaarden

AccountProperties

Naam	Beschrijving	Waarde
allowedFqdnList		tekenreeks[]
amlWorkspace	De eigenschappen van de AML-werkruimte van de gebruiker.	UserOwnedAmlWorkspace
apiProperties	De API-eigenschappen voor speciale API's.	ApiProperties-
customSubDomainName	Optionele subdomeinnaam die wordt gebruikt voor verificatie op basis van tokens.	snaar
disableLocalAuth		Bool
dynamicThrottlingEnabled	De vlag om dynamische beperking in te schakelen.	Bool
Codering	De versleutelingseigenschappen voor deze resource.	versleutelings
Locaties	De instellingen voor meerdere regio's van het Cognitive Services-account.	MultiRegionSettings
migrationToken	Token voor resourcemigratie.	snaar
networkAcls	Een verzameling regels voor de toegankelijkheid van specifieke netwerklocaties.	NetworkRuleSet
publicNetworkAccess	Of openbare eindpunttoegang wel of niet is toegestaan voor dit account.	'Uitgeschakeld' 'Ingeschakeld'
raiMonitorConfig	Configuratie van Cognitive Services Rai Monitor.	RaiMonitorConfig-
herstellen		Bool
restrictOutboundNetworkAccess		Bool
userOwnedStorage	De opslagaccounts voor deze resource.	UserOwnedStorage[]

AccountTags

Naam	Beschrijving	Waarde

ApiProperties

Naam	Beschrijving	Waarde
aadClientId	(Alleen Metrics Advisor) De Azure AD-client-id (toepassings-id).	string Beperkingen: Maximale lengte = 500
aadTenantId	(Alleen Metrics Advisor) De Azure AD-tenant-id.	string Beperkingen: Maximale lengte = 500
eventHubConnectionString	(Alleen persoonlijke instellingen) De vlag om statistieken van Bing Search in te schakelen.	string Beperkingen: Maximale lengte = 1000 Patroon = `^( )Endpoint=sb://(.);( )SharedAccessKeyName=(.);( )SharedAccessKey=(.)$`
qnaAzureSearchEndpointId	(Alleen QnAMaker) De Azure Search-eindpunt-id van QnAMaker.	snaar
qnaAzureSearchEndpointKey	(Alleen QnAMaker) De Azure Search-eindpuntsleutel van QnAMaker.	snaar
qnaRuntimeEndpoint	(Alleen QnAMaker) Het runtime-eindpunt van QnAMaker.	snaar
statisticsEnabled	(Alleen Bing Zoeken) De vlag om statistieken van Bing Search in te schakelen.	Bool
storageAccountConnectionString	(Alleen persoonlijke instellingen) De verbindingsreeks voor het opslagaccount.	string Beperkingen: Maximale lengte = 1000 Patroon = `^(( )DefaultEndpointsProtocol=(http\|https)( );( ))?AccountName=(.)AccountKey=(.)EndpointSuffix=(.)$`
Superuser	(Alleen Metrics Advisor) De supergebruiker van Metrics Advisor.	string Beperkingen: Maximale lengte = 500
websiteName	(Alleen Metrics Advisor) De websitenaam van Metrics Advisor.	string Beperkingen: Maximale lengte = 500

Codering

Naam	Beschrijving	Waarde
keySource	De mogelijke waarde van keySource voor versleuteling opsommen	'Microsoft.CognitiveServices' 'Microsoft.KeyVault'
keyVaultProperties	Eigenschappen van KeyVault	KeyVaultProperties-

Identiteit

Naam	Beschrijving	Waarde
type	Het identiteitstype.	'Geen' 'SystemAssigned' 'SystemAssigned, UserAssigned' UserAssigned
userAssignedIdentities	De lijst met door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De referenties voor de woordenlijst van de gebruikersidentiteit zijn ARM-resource-id's in de vorm: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}	IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Naam	Beschrijving	Waarde

IpRule

Naam	Beschrijving	Waarde
waarde	Een IPv4-adresbereik in CIDR-notatie, zoals '124.56.78.91' (eenvoudig IP-adres) of '124.56.78.0/24' (alle adressen die beginnen met 124.56.78).	tekenreeks (vereist)

KeyVaultProperties

Naam	Beschrijving	Waarde
identityClientId		snaar
keyName	Naam van de sleutel uit KeyVault	snaar
keyVaultUri	URI van KeyVault	snaar
keyVersion	Versie van de sleutel van KeyVault	snaar

Naam	Beschrijving	Waarde
identiteit	Identiteit voor de resource.	identity
soort	Het type resource.	snaar
plaats	De geografische locatie waar de resource zich bevindt	snaar
naam	De resourcenaam	string Beperkingen: Minimale lengte = 2 Maximale lengte = 64 Patroon = `^[a-zA-Z0-9][a-zA-Z0-9_.-]*$` (vereist)
Eigenschappen	Eigenschappen van Het Cognitive Services-account.	AccountProperties-
Sku	De definitie van het resourcemodel die de SKU vertegenwoordigt	SKU-
Tags	Resourcetags	Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen

MultiRegionSettings

Naam	Beschrijving	Waarde
contreien		RegionSetting[]
routingMethod	Routeringsmethoden voor meerdere regio's.	'Prestaties' Prioriteit 'Gewogen'

NetworkRuleSet

Naam	Beschrijving	Waarde
omzeilen	Instelling voor vertrouwde services.	'AzureServices' 'Geen'
defaultAction	De standaardactie wanneer geen regel van ipRules en van virtualNetworkRules overeenkomt. Dit wordt alleen gebruikt nadat de bypass-eigenschap is geëvalueerd.	'Toestaan' 'Weigeren'
ipRules	De lijst met IP-adresregels.	IpRule[]
virtualNetworkRules	De lijst met regels voor virtuele netwerken.	VirtualNetworkRule[]

RaiMonitorConfig

Naam	Beschrijving	Waarde
adxStorageResourceId	De opslagresource-id.	snaar
identityClientId	De id van de identiteitsclient voor toegang tot de opslag.	snaar

RegionSetting

Naam	Beschrijving	Waarde
customsubdomain	Hiermee wordt de regio toegewezen aan het regionale aangepaste subdomein.	snaar
naam	Naam van de regio.	snaar
waarde	Een waarde voor prioriteits- of gewogen routeringsmethoden.	Int

Sku

Naam	Beschrijving	Waarde
capaciteit	Als de SKU uitschalen/inschalen ondersteunt, moet het gehele getal van de capaciteit worden opgenomen. Als uitschalen/inschalen niet mogelijk is voor de resource, kan dit worden weggelaten.	Int
Familie	Als de service verschillende generaties hardware heeft, voor dezelfde SKU, kan die hier worden vastgelegd.	snaar
naam	De naam van de SKU. Ex - P3. Dit is meestal een letter+cijfercode	tekenreeks (vereist)
grootte	De SKU-grootte. Wanneer het naamveld de combinatie van de laag en een andere waarde is, is dit de zelfstandige code.	snaar
rang	Dit veld moet worden geïmplementeerd door de resourceprovider als de service meer dan één laag heeft, maar niet vereist is voor een PUT.	'Basis' 'Onderneming' 'Gratis' 'Premium' 'Standaard'

UserAssignedIdentity

Naam	Beschrijving	Waarde

UserOwnedAmlWorkspace

Naam	Beschrijving	Waarde
identityClientId	Id van de id van een AML-werkruimteresource.	snaar
resourceId	Volledige resource-id van een AML-werkruimteresource.	snaar

UserOwnedStorage

Naam	Beschrijving	Waarde
identityClientId		snaar
resourceId	Volledige resource-id van een Microsoft.Storage-resource.	snaar

VirtualNetworkRule

Naam	Beschrijving	Waarde
legitimatiebewijs	Volledige resource-id van een vnet-subnet, zoals '/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1'.	tekenreeks (vereist)
ignoreMissingVnetServiceEndpoint	Ontbrekend vnet-service-eindpunt negeren of niet.	Bool
staat	Hiermee haalt u de status van de regel voor het virtuele netwerk op.	snaar

Gebruiksvoorbeelden

Geverifieerde Azure-modules

De volgende azure-geverifieerde modules kunnen worden gebruikt om dit resourcetype te implementeren.

Module	Beschrijving
Azure AI Services (Cognitive Services)	AVM-resourcemodule voor Azure AI Services (Cognitive Services)

Azure-snelstartvoorbeelden

De volgende Azure-quickstartsjablonen bicep-voorbeelden bevatten voor het implementeren van dit resourcetype.

Bicep-bestand	Beschrijving
basisinstallatie van Azure AI Studio	Deze set sjablonen laat zien hoe u Azure AI Studio instelt met de basisinstallatie, wat betekent dat openbare internettoegang is ingeschakeld, door Microsoft beheerde sleutels voor versleuteling en door Microsoft beheerde identiteitconfiguratie voor de AI-resource.
basisinstallatie van Azure AI Studio	Deze set sjablonen laat zien hoe u Azure AI Studio instelt met de basisinstallatie, wat betekent dat openbare internettoegang is ingeschakeld, door Microsoft beheerde sleutels voor versleuteling en door Microsoft beheerde identiteitconfiguratie voor de AI-resource.
basisinstallatie van Azure AI Studio	Deze set sjablonen laat zien hoe u Azure AI Studio instelt met de basisinstallatie, wat betekent dat openbare internettoegang is ingeschakeld, door Microsoft beheerde sleutels voor versleuteling en door Microsoft beheerde identiteitconfiguratie voor de AI-resource.
beperkte van Azure AI Studio Network	Deze set sjablonen laat zien hoe u Azure AI Studio instelt met private link en uitgaand verkeer uitgeschakeld, met behulp van door Microsoft beheerde sleutels voor versleuteling en door Microsoft beheerde identiteitsconfiguratie voor de AI-resource.
beperkte van Azure AI Studio Network	Deze set sjablonen laat zien hoe u Azure AI Studio instelt met private link en uitgaand verkeer uitgeschakeld, met behulp van door Microsoft beheerde sleutels voor versleuteling en door Microsoft beheerde identiteitsconfiguratie voor de AI-resource.
Azure AI Studio met Microsoft Entra ID Authentication	Deze set sjablonen laat zien hoe u Azure AI Studio instelt met Microsoft Entra ID-verificatie voor afhankelijke resources, zoals Azure AI Services en Azure Storage.
Api-sleutels voor basic-agent instellen	Deze set sjablonen laat zien hoe u Azure AI Agent Service instelt met behulp van de basisinstallatie met behulp van API-sleutels voor de AI Service/AOAI-verbinding. Agents gebruiken zoek- en opslagbronnen met meerdere tenants die volledig worden beheerd door Microsoft. U hebt geen zichtbaarheid of controle over deze onderliggende Azure-resources.
Basic Agent Setup Identity	Deze set sjablonen laat zien hoe u Azure AI Agent Service instelt met de basisinstallatie met behulp van verificatie van beheerde identiteiten voor de AI-service/AOAI-verbinding. Agents gebruiken zoek- en opslagbronnen met meerdere tenants die volledig worden beheerd door Microsoft. U hebt geen zichtbaarheid of controle over deze onderliggende Azure-resources.
Een Resource voor meerdere services voor Azure AI-services implementeren	Met deze sjabloon wordt een Azure AI-servicesresource geïmplementeerd om AI binnen bereik van elke ontwikkelaar te brengen zonder dat hiervoor machine learning-expertise is vereist. Het enige wat u nodig hebt, is een API-aanroep om de mogelijkheid in te sluiten om uw apps te zien, te horen, te spreken, te zoeken, te begrijpen en te versnellen.
Een Azure AI Translator-resource implementeren	Met deze sjabloon wordt een Azure AI Translator-resource geïmplementeerd om AI binnen het bereik van elke ontwikkelaar te brengen zonder machine learning-expertise te vereisen.
Een Azure AI Vision-resource implementeren	Met deze sjabloon wordt een Azure AI Vision-resource geïmplementeerd om AI binnen bereik van elke ontwikkelaar te brengen zonder dat hiervoor machine learning-expertise is vereist.
Secure Azure AI Studio implementeren met een beheerd virtueel netwerk	Met deze sjabloon maakt u een beveiligde Azure AI Studio-omgeving met robuuste netwerk- en identiteitsbeveiligingsbeperkingen.
Met netwerk beveiligde agent met door de gebruiker beheerde identiteit	Deze set sjablonen laat zien hoe u Azure AI Agent Service instelt met isolatie van virtuele netwerken met behulp van door de gebruiker beheerde identiteit-authetication voor de AI-service/AOAI-verbinding en privénetwerkkoppelingen om de agent te verbinden met uw beveiligde gegevens.
van de Standard-agent instellen	Deze set sjablonen laat zien hoe u Azure AI Agent Service instelt met de standaardinstallatie, wat betekent dat beheerde identiteitsverificatie wordt uitgevoerd voor project-/hubverbindingen en openbare internettoegang is ingeschakeld. Agents maken gebruik van zoek- en opslagbronnen die eigendom zijn van één tenant. Met deze installatie hebt u volledige controle en zichtbaarheid van deze resources, maar er worden kosten in rekening gebracht op basis van uw gebruik.

Resourcedefinitie van ARM-sjabloon