Account Microsoft.CognitiveServices/distribuzioni 2024-04-01-preview
Definizione di risorsa Bicep
Il tipo di risorsa account/distribuzioni può essere distribuito con operazioni destinate a:
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Formato risorsa
Per creare una risorsa Microsoft.CognitiveServices/accounts/deployments, aggiungere il bicep seguente al modello.
resource symbolicname 'Microsoft.CognitiveServices/accounts/deployments@2024-04-01-preview' = {
parent: resourceSymbolicName
name: 'string'
properties: {
capacitySettings: {
designatedCapacity: int
priority: int
}
currentCapacity: int
model: {
format: 'string'
name: 'string'
source: 'string'
version: 'string'
}
raiPolicyName: 'string'
scaleSettings: {
capacity: int
scaleType: 'string'
}
versionUpgradeOption: 'string'
}
sku: {
capacity: int
family: 'string'
name: 'string'
size: 'string'
tier: 'string'
}
tags: {
{customized property}: 'string'
}
}
Valori delle proprietà
DeploymentCapacitySettings
| Nome | Descrizione | Valore |
|---|---|---|
| designCapacity | Capacità designata. | Int Vincoli: Valore minimo = 0 |
| priorità | Priorità di questa impostazione di capacità. | Int Vincoli: Valore minimo = 0 |
DeploymentModel
| Nome | Descrizione | Valore |
|---|---|---|
| formato | Formato del modello di distribuzione. | corda |
| nome | Nome del modello di distribuzione. | corda |
| fonte | Opzionale. ID risorsa ARM del modello di distribuzione. | corda |
| Versione | Opzionale. Versione del modello di distribuzione. Se la versione non è specificata, verrà assegnata una versione predefinita. La versione predefinita è diversa per i diversi modelli e può cambiare quando è disponibile una nuova versione per un modello. La versione predefinita per un modello è disponibile nell'API dei modelli di elenco. | corda |
DeploymentProperties
| Nome | Descrizione | Valore |
|---|---|---|
| capacitySettings | Solo uso interno. | DeploymentCapacitySettings |
| currentCapacity | Capacità corrente. | Int |
| modello | Proprietà del modello di distribuzione dell'account servizi cognitivi. | DeploymentModel |
| raiPolicyName | Nome della politica RAI. | corda |
| scaleSettings | Proprietà del modello di distribuzione dell'account servizi cognitivi. (Deprecato, usare invece Deployment.sku. | DeploymentScaleSettings di |
| versionUpgradeOption | Opzione di aggiornamento della versione del modello di distribuzione. | 'NoAutoUpgrade' 'OnceCurrentVersionExpired' 'OnceNewDefaultVersionAvailable' |
DeploymentScaleSettings
| Nome | Descrizione | Valore |
|---|---|---|
| capacità | Capacità di distribuzione. | Int |
| scaleType | Tipo di scalabilità di distribuzione. | 'Manual' 'Standard' |
DeploymentTag
| Nome | Descrizione | Valore |
|---|
Microsoft.CognitiveServices/accounts/deployments
| Nome | Descrizione | Valore |
|---|---|---|
| nome | Nome della risorsa | stringa (obbligatorio) |
| genitore | In Bicep è possibile specificare la risorsa padre per una risorsa figlio. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre. Per altre informazioni, vedere risorsa figlio all'esterno della risorsa padre. |
Nome simbolico per la risorsa di tipo: account |
| proprietà | Proprietà della distribuzione dell'account servizi cognitivi. | |
| Sku | Definizione del modello di risorse che rappresenta lo SKU | sku |
| Tag | Tag delle risorse | Dizionario di nomi e valori di tag. Vedere tag nei modelli |
Sku
| Nome | Descrizione | Valore |
|---|---|---|
| capacità | Se lo SKU supporta l'aumento o l'aumento del numero di istanze, è necessario includere l'intero della capacità. Se non è possibile aumentare o ridurre il numero di istanze per la risorsa, potrebbe essere omesso. | Int |
| famiglia | Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui. | corda |
| nome | Nome dello SKU. Ad esempio - P3. Si tratta in genere di un codice lettera+numero | stringa (obbligatorio) |
| grandezza | Dimensioni dello SKU. Quando il campo nome è la combinazione di livello e un altro valore, si tratta del codice autonomo. | corda |
| livello | Questo campo deve essere implementato dal provider di risorse se il servizio ha più di un livello, ma non è necessario in un PUT. | 'Basic' 'Enterprise' 'Free' 'Premium' 'Standard' |
Esempi di utilizzo
Esempi di avvio rapido di Azure
I modelli di avvio rapido di Azure seguenti contengono esempi Bicep per la distribuzione di questo tipo di risorsa.
| Bicep File | Descrizione |
|---|---|
| delle chiavi API di installazione dell'agente di base | Questo set di modelli illustra come configurare il servizio Azure AI Agent con la configurazione di base usando l'autenticazione delle chiavi API per la connessione al servizio di intelligenza artificiale/AOAI. Gli agenti usano risorse di ricerca e archiviazione multi-tenant completamente gestite da Microsoft. Non si avrà visibilità o controllo su queste risorse di Azure sottostanti. |
| di configurazione dell'agente di base | Questo set di modelli illustra come configurare il servizio Azure AI Agent con la configurazione di base usando l'autenticazione dell'identità gestita per la connessione al servizio di intelligenza artificiale/AOAI. Gli agenti usano risorse di ricerca e archiviazione multi-tenant completamente gestite da Microsoft. Non si avrà visibilità o controllo su queste risorse di Azure sottostanti. |
| Distribuire Secure Azure AI Studio con una rete virtuale gestita | Questo modello crea un ambiente sicuro di Azure AI Studio con forti restrizioni di sicurezza di rete e identità. |
| agente protetto dalla rete con identità gestita dall'utente | Questo set di modelli illustra come configurare il servizio Agente di intelligenza artificiale di Azure con isolamento della rete virtuale usando l'autenticazione dell'identità gestita dall'utente per la connessione al servizio di intelligenza artificiale/AOAI e i collegamenti di rete privata per connettere l'agente ai dati sicuri. |
| configurazione dell'agente standard | Questo set di modelli illustra come configurare il servizio Azure AI Agent con la configurazione standard, ovvero con l'autenticazione dell'identità gestita per le connessioni di progetto/hub e l'accesso a Internet pubblico abilitato. Gli agenti usano risorse di ricerca e archiviazione a tenant singolo di proprietà del cliente. Con questa configurazione, si ha il controllo completo e la visibilità su queste risorse, ma si comportano costi in base all'utilizzo. |
Definizione di risorsa del modello di Resource Manager
Il tipo di risorsa account/distribuzioni può essere distribuito con operazioni destinate a:
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Formato risorsa
Per creare una risorsa Microsoft.CognitiveServices/accounts/deployments, aggiungere il codice JSON seguente al modello.
{
"type": "Microsoft.CognitiveServices/accounts/deployments",
"apiVersion": "2024-04-01-preview",
"name": "string",
"properties": {
"capacitySettings": {
"designatedCapacity": "int",
"priority": "int"
},
"currentCapacity": "int",
"model": {
"format": "string",
"name": "string",
"source": "string",
"version": "string"
},
"raiPolicyName": "string",
"scaleSettings": {
"capacity": "int",
"scaleType": "string"
},
"versionUpgradeOption": "string"
},
"sku": {
"capacity": "int",
"family": "string",
"name": "string",
"size": "string",
"tier": "string"
},
"tags": {
"{customized property}": "string"
}
}
Valori delle proprietà
DeploymentCapacitySettings
| Nome | Descrizione | Valore |
|---|---|---|
| designCapacity | Capacità designata. | Int Vincoli: Valore minimo = 0 |
| priorità | Priorità di questa impostazione di capacità. | Int Vincoli: Valore minimo = 0 |
DeploymentModel
| Nome | Descrizione | Valore |
|---|---|---|
| formato | Formato del modello di distribuzione. | corda |
| nome | Nome del modello di distribuzione. | corda |
| fonte | Opzionale. ID risorsa ARM del modello di distribuzione. | corda |
| Versione | Opzionale. Versione del modello di distribuzione. Se la versione non è specificata, verrà assegnata una versione predefinita. La versione predefinita è diversa per i diversi modelli e può cambiare quando è disponibile una nuova versione per un modello. La versione predefinita per un modello è disponibile nell'API dei modelli di elenco. | corda |
DeploymentProperties
| Nome | Descrizione | Valore |
|---|---|---|
| capacitySettings | Solo uso interno. | DeploymentCapacitySettings |
| currentCapacity | Capacità corrente. | Int |
| modello | Proprietà del modello di distribuzione dell'account servizi cognitivi. | DeploymentModel |
| raiPolicyName | Nome della politica RAI. | corda |
| scaleSettings | Proprietà del modello di distribuzione dell'account servizi cognitivi. (Deprecato, usare invece Deployment.sku. | DeploymentScaleSettings di |
| versionUpgradeOption | Opzione di aggiornamento della versione del modello di distribuzione. | 'NoAutoUpgrade' 'OnceCurrentVersionExpired' 'OnceNewDefaultVersionAvailable' |
DeploymentScaleSettings
| Nome | Descrizione | Valore |
|---|---|---|
| capacità | Capacità di distribuzione. | Int |
| scaleType | Tipo di scalabilità di distribuzione. | 'Manual' 'Standard' |
DeploymentTag
| Nome | Descrizione | Valore |
|---|
Microsoft.CognitiveServices/accounts/deployments
| Nome | Descrizione | Valore |
|---|---|---|
| apiVersion | Versione dell'API | '2024-04-01-preview' |
| nome | Nome della risorsa | stringa (obbligatorio) |
| proprietà | Proprietà della distribuzione dell'account servizi cognitivi. | |
| Sku | Definizione del modello di risorse che rappresenta lo SKU | sku |
| Tag | Tag delle risorse | Dizionario di nomi e valori di tag. Vedere tag nei modelli |
| digitare | Tipo di risorsa | 'Microsoft.CognitiveServices/accounts/deployments' |
Sku
| Nome | Descrizione | Valore |
|---|---|---|
| capacità | Se lo SKU supporta l'aumento o l'aumento del numero di istanze, è necessario includere l'intero della capacità. Se non è possibile aumentare o ridurre il numero di istanze per la risorsa, potrebbe essere omesso. | Int |
| famiglia | Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui. | corda |
| nome | Nome dello SKU. Ad esempio - P3. Si tratta in genere di un codice lettera+numero | stringa (obbligatorio) |
| grandezza | Dimensioni dello SKU. Quando il campo nome è la combinazione di livello e un altro valore, si tratta del codice autonomo. | corda |
| livello | Questo campo deve essere implementato dal provider di risorse se il servizio ha più di un livello, ma non è necessario in un PUT. | 'Basic' 'Enterprise' 'Free' 'Premium' 'Standard' |
Esempi di utilizzo
Modelli di avvio rapido di Azure
I modelli di avvio rapido di Azure seguenti distribuire questo tipo di risorsa.
| Sagoma | Descrizione |
|---|---|
delle chiavi API di installazione dell'agente di base
|
Questo set di modelli illustra come configurare il servizio Azure AI Agent con la configurazione di base usando l'autenticazione delle chiavi API per la connessione al servizio di intelligenza artificiale/AOAI. Gli agenti usano risorse di ricerca e archiviazione multi-tenant completamente gestite da Microsoft. Non si avrà visibilità o controllo su queste risorse di Azure sottostanti. |
|
di configurazione dell'agente di base
|
Questo set di modelli illustra come configurare il servizio Azure AI Agent con la configurazione di base usando l'autenticazione dell'identità gestita per la connessione al servizio di intelligenza artificiale/AOAI. Gli agenti usano risorse di ricerca e archiviazione multi-tenant completamente gestite da Microsoft. Non si avrà visibilità o controllo su queste risorse di Azure sottostanti. |
|
Distribuire Secure Azure AI Studio con una rete virtuale gestita
|
Questo modello crea un ambiente sicuro di Azure AI Studio con forti restrizioni di sicurezza di rete e identità. |
|
agente protetto dalla rete con identità gestita dall'utente
|
Questo set di modelli illustra come configurare il servizio Agente di intelligenza artificiale di Azure con isolamento della rete virtuale usando l'autenticazione dell'identità gestita dall'utente per la connessione al servizio di intelligenza artificiale/AOAI e i collegamenti di rete privata per connettere l'agente ai dati sicuri. |
|
configurazione dell'agente standard
|
Questo set di modelli illustra come configurare il servizio Azure AI Agent con la configurazione standard, ovvero con l'autenticazione dell'identità gestita per le connessioni di progetto/hub e l'accesso a Internet pubblico abilitato. Gli agenti usano risorse di ricerca e archiviazione a tenant singolo di proprietà del cliente. Con questa configurazione, si ha il controllo completo e la visibilità su queste risorse, ma si comportano costi in base all'utilizzo. |
Definizione di risorsa Terraform (provider AzAPI)
Il tipo di risorsa account/distribuzioni può essere distribuito con operazioni destinate a:
- gruppi di risorse
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Formato risorsa
Per creare una risorsa Microsoft.CognitiveServices/accounts/deployments, aggiungere il file Terraform seguente al modello.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.CognitiveServices/accounts/deployments@2024-04-01-preview"
name = "string"
sku = {
capacity = int
family = "string"
name = "string"
size = "string"
tier = "string"
}
tags = {
{customized property} = "string"
}
body = jsonencode({
properties = {
capacitySettings = {
designatedCapacity = int
priority = int
}
currentCapacity = int
model = {
format = "string"
name = "string"
source = "string"
version = "string"
}
raiPolicyName = "string"
scaleSettings = {
capacity = int
scaleType = "string"
}
versionUpgradeOption = "string"
}
})
}
Valori delle proprietà
DeploymentCapacitySettings
| Nome | Descrizione | Valore |
|---|---|---|
| designCapacity | Capacità designata. | Int Vincoli: Valore minimo = 0 |
| priorità | Priorità di questa impostazione di capacità. | Int Vincoli: Valore minimo = 0 |
DeploymentModel
| Nome | Descrizione | Valore |
|---|---|---|
| formato | Formato del modello di distribuzione. | corda |
| nome | Nome del modello di distribuzione. | corda |
| fonte | Opzionale. ID risorsa ARM del modello di distribuzione. | corda |
| Versione | Opzionale. Versione del modello di distribuzione. Se la versione non è specificata, verrà assegnata una versione predefinita. La versione predefinita è diversa per i diversi modelli e può cambiare quando è disponibile una nuova versione per un modello. La versione predefinita per un modello è disponibile nell'API dei modelli di elenco. | corda |
DeploymentProperties
| Nome | Descrizione | Valore |
|---|---|---|
| capacitySettings | Solo uso interno. | DeploymentCapacitySettings |
| currentCapacity | Capacità corrente. | Int |
| modello | Proprietà del modello di distribuzione dell'account servizi cognitivi. | DeploymentModel |
| raiPolicyName | Nome della politica RAI. | corda |
| scaleSettings | Proprietà del modello di distribuzione dell'account servizi cognitivi. (Deprecato, usare invece Deployment.sku. | DeploymentScaleSettings di |
| versionUpgradeOption | Opzione di aggiornamento della versione del modello di distribuzione. | 'NoAutoUpgrade' 'OnceCurrentVersionExpired' 'OnceNewDefaultVersionAvailable' |
DeploymentScaleSettings
| Nome | Descrizione | Valore |
|---|---|---|
| capacità | Capacità di distribuzione. | Int |
| scaleType | Tipo di scalabilità di distribuzione. | 'Manual' 'Standard' |
DeploymentTag
| Nome | Descrizione | Valore |
|---|
Microsoft.CognitiveServices/accounts/deployments
| Nome | Descrizione | Valore |
|---|---|---|
| nome | Nome della risorsa | stringa (obbligatorio) |
| parent_id | ID della risorsa padre per questa risorsa. | ID per la risorsa di tipo: account |
| proprietà | Proprietà della distribuzione dell'account servizi cognitivi. | |
| Sku | Definizione del modello di risorse che rappresenta lo SKU | sku |
| Tag | Tag delle risorse | Dizionario di nomi e valori di tag. |
| digitare | Tipo di risorsa | "Microsoft.CognitiveServices/accounts/deployments@2024-04-01-preview" |
Sku
| Nome | Descrizione | Valore |
|---|---|---|
| capacità | Se lo SKU supporta l'aumento o l'aumento del numero di istanze, è necessario includere l'intero della capacità. Se non è possibile aumentare o ridurre il numero di istanze per la risorsa, potrebbe essere omesso. | Int |
| famiglia | Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui. | corda |
| nome | Nome dello SKU. Ad esempio - P3. Si tratta in genere di un codice lettera+numero | stringa (obbligatorio) |
| grandezza | Dimensioni dello SKU. Quando il campo nome è la combinazione di livello e un altro valore, si tratta del codice autonomo. | corda |
| livello | Questo campo deve essere implementato dal provider di risorse se il servizio ha più di un livello, ma non è necessario in un PUT. | 'Basic' 'Enterprise' 'Free' 'Premium' 'Standard' |