Services - Create Or Update

Servizio:: Search Management

Versione API:: 2025-02-01-preview

Crea o aggiorna un servizio di ricerca nel gruppo di risorse specificato. Se il servizio di ricerca esiste già, tutte le proprietà verranno aggiornate con i valori specificati.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}?api-version=2025-02-01-preview

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string	Nome del gruppo di risorse all'interno della sottoscrizione corrente. È possibile ottenere questo valore dall'API di Azure Resource Manager o dal portale.
searchServiceName	path	True	string	Nome del servizio Ricerca intelligenza artificiale di Azure da creare o aggiornare. I nomi dei servizi di ricerca devono contenere solo lettere minuscole, cifre o trattini, non possono usare trattini come primi due o ultimi caratteri, non possono contenere trattini consecutivi e devono avere una lunghezza compresa tra 2 e 60 caratteri. I nomi dei servizi di ricerca devono essere univoci a livello globale poiché fanno parte dell'URI del servizio (https://< name.search.windows.net>). Non è possibile modificare il nome del servizio dopo la creazione del servizio.
subscriptionId	path	True	string	Identificatore univoco per una sottoscrizione di Microsoft Azure. È possibile ottenere questo valore dall'API di Azure Resource Manager o dal portale.
api-version	query	True	string	Versione dell'API da usare per ogni richiesta.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
x-ms-client-request-id		string (uuid)	Valore GUID generato dal client che identifica questa richiesta. Se specificato, verrà incluso nelle informazioni di risposta come modo per tenere traccia della richiesta.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
location	True	string	Posizione geografica in cui risiede la risorsa
identity		Identity	Identità della risorsa.
properties.authOptions		DataPlaneAuthOptions	Definisce le opzioni per il modo in cui l'API del piano dati di un servizio di ricerca autentica le richieste. Non è possibile impostare questa impostazione se 'disableLocalAuth' è impostato su true.
properties.computeType		ComputeType	Configurare questa proprietà per supportare il servizio di ricerca usando il calcolo predefinito o Il confidential compute di Azure.
properties.disableLocalAuth		boolean	Se impostato su true, le chiamate al servizio di ricerca non saranno autorizzate a usare le chiavi API per l'autenticazione. Non è possibile impostare su true se è definito 'dataPlaneAuthOptions'.
properties.disabledDataExfiltrationOptions		SearchDisabledDataExfiltrationOption[]	Elenco di scenari di esfiltrazione di dati non consentiti in modo esplicito per il servizio di ricerca. Attualmente, l'unico valore supportato è "All" per disabilitare tutti i possibili scenari di esportazione dei dati con controlli più granulari pianificati per il futuro.
properties.encryptionWithCmk		EncryptionWithCmk	Specifica i criteri relativi alla crittografia delle risorse (ad esempio gli indici) usando le chiavi di Customer Manager all'interno di un servizio di ricerca.
properties.endpoint		string (uri)	Endpoint del servizio Ricerca intelligenza artificiale di Azure.
properties.hostingMode		HostingMode	Applicabile solo per lo SKU Standard3. È possibile impostare questa proprietà per abilitare fino a 3 partizioni ad alta densità che consentono fino a 1000 indici, che è molto più alto rispetto agli indici massimi consentiti per qualsiasi altro SKU. Per lo SKU standard3, il valore è "default" o "highDensity". Per tutti gli altri SKU, questo valore deve essere 'default'.
properties.networkRuleSet		NetworkRuleSet	Regole specifiche della rete che determinano il modo in cui è possibile raggiungere il servizio Ricerca di intelligenza artificiale di Azure.
properties.partitionCount		integer (int32) minimum: 1 maximum: 12	Numero di partizioni nel servizio di ricerca; se specificato, può essere 1, 2, 3, 4, 6 o 12. I valori maggiori di 1 sono validi solo per gli SKU standard. Per i servizi 'standard3' con hostingMode impostato su 'highDensity', i valori consentiti sono compresi tra 1 e 3.
properties.publicNetworkAccess		PublicNetworkAccess	Questo valore può essere impostato su "enabled" per evitare modifiche di rilievo nelle risorse e nei modelli dei clienti esistenti. Se impostato su "disabilitato", il traffico sull'interfaccia pubblica non è consentito e le connessioni endpoint private saranno il metodo di accesso esclusivo.
properties.replicaCount		integer (int32) minimum: 1 maximum: 12	Numero di repliche nel servizio di ricerca. Se specificato, deve essere un valore compreso tra 1 e 12 inclusi per gli SKU standard o compreso tra 1 e 3 inclusi per lo SKU basic.
properties.semanticSearch		SearchSemanticSearch	Imposta le opzioni che controllano la disponibilità della ricerca semantica. Questa configurazione è possibile solo per determinati SKU di Ricerca intelligenza artificiale di Azure in determinate posizioni.
sku		Sku	SKU del servizio di ricerca, che determina il livello di prezzo e i limiti di capacità. Questa proprietà è necessaria quando si crea un nuovo servizio di ricerca.
tags		object	Tag di risorsa.

Risposte

Nome	Tipo	Descrizione
200 OK	SearchService	La definizione del servizio esistente è stata aggiornata correttamente. Se è stato modificato il numero di repliche o partizioni, l'operazione di scalabilità verrà eseguita in modo asincrono. È possibile controllare lo stato di un'operazione di scalabilità tramite la proprietà provisioningState di una richiesta Get Service.
201 Created	SearchService	Se è stata richiesta la creazione di un servizio di ricerca gratuito, il servizio viene ora sottoposto a provisioning e pronto per l'uso, in base al ritardo di propagazione DNS. Per altri tipi di SKU, il provisioning avviene in modo asincrono. È possibile controllare lo stato di un'operazione di scalabilità tramite la proprietà provisioningState di una richiesta Get Service.
Other Status Codes	CloudError	HTTP 400 (richiesta non valida): il nome del servizio specificato o la definizione del servizio non è valido. Per informazioni dettagliate, vedere il codice di errore e il messaggio nella risposta. HTTP 404 (non trovato): impossibile trovare la sottoscrizione o il gruppo di risorse. HTTP 409 (Conflitto): la sottoscrizione specificata è disabilitata.

Sicurezza

azure_auth

Specifica un flusso di concessione implicita, come supportato in Microsoft Identity Platform.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

SearchCreateOrUpdateService

SearchCreateOrUpdateServiceAuthOptions

SearchCreateOrUpdateServiceDisableLocalAuth

SearchCreateOrUpdateServiceToAllowAccessFromPrivateEndpoints

SearchCreateOrUpdateServiceToAllowAccessFromPublicCustomIPs

SearchCreateOrUpdateServiceToAllowAccessFromPublicCustomIPsAndBypass

SearchCreateOrUpdateServiceWithCmkEnforcement

SearchCreateOrUpdateServiceWithDataExfiltration

SearchCreateOrUpdateServiceWithIdentity

SearchCreateOrUpdateWithSemanticSearch

SearchCreateOrUpdateService

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-02-01-preview

{
  "location": "westus",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "hostingMode": "default",
    "computeType": "default"
  }
}

Risposta di esempio

Codice di stato:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "name": "mysearchservice",
  "location": "westus",
  "type": "Microsoft.Search/searchServices",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "Provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "disabledDataExfiltrationOptions": [],
    "upgradeAvailable": false,
    "serviceUpgradeDate": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z"
  }
}

Codice di stato:: 201

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "name": "mysearchservice",
  "location": "westus",
  "type": "Microsoft.Search/searchServices",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "Provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "disabledDataExfiltrationOptions": [],
    "upgradeAvailable": false,
    "serviceUpgradeDate": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z"
  }
}

SearchCreateOrUpdateServiceAuthOptions

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-02-01-preview

{
  "location": "westus",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "hostingMode": "default",
    "computeType": "default",
    "authOptions": {
      "aadOrApiKey": {
        "aadAuthFailureMode": "http401WithBearerChallenge"
      }
    }
  }
}

Risposta di esempio

Codice di stato:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "name": "mysearchservice",
  "location": "westus",
  "type": "Microsoft.Search/searchServices",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "Provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "authOptions": {
      "aadOrApiKey": {
        "aadAuthFailureMode": "http401WithBearerChallenge"
      }
    },
    "disabledDataExfiltrationOptions": [],
    "upgradeAvailable": true,
    "serviceUpgradeDate": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "[email protected]",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

Codice di stato:: 201

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "name": "mysearchservice",
  "location": "westus",
  "type": "Microsoft.Search/searchServices",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "Provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "authOptions": {
      "aadOrApiKey": {
        "aadAuthFailureMode": "http401WithBearerChallenge"
      }
    },
    "disabledDataExfiltrationOptions": [],
    "upgradeAvailable": false,
    "serviceUpgradeDate": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "[email protected]",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

SearchCreateOrUpdateServiceDisableLocalAuth

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-02-01-preview

{
  "location": "westus",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "hostingMode": "default",
    "computeType": "default",
    "disableLocalAuth": true
  }
}

Risposta di esempio

Codice di stato:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "name": "mysearchservice",
  "location": "westus",
  "type": "Microsoft.Search/searchServices",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "Provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": true,
    "authOptions": null,
    "disabledDataExfiltrationOptions": [],
    "upgradeAvailable": false,
    "serviceUpgradeDate": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "[email protected]",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

Codice di stato:: 201

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "name": "mysearchservice",
  "location": "westus",
  "type": "Microsoft.Search/searchServices",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "Provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": true,
    "authOptions": null,
    "disabledDataExfiltrationOptions": [],
    "upgradeAvailable": false,
    "serviceUpgradeDate": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "[email protected]",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

SearchCreateOrUpdateServiceToAllowAccessFromPrivateEndpoints

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-02-01-preview

{
  "location": "westus",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "publicNetworkAccess": "disabled",
    "hostingMode": "default",
    "computeType": "default"
  }
}

Risposta di esempio

Codice di stato:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "name": "mysearchservice",
  "location": "westus",
  "type": "Microsoft.Search/searchServices",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "Provisioning",
    "publicNetworkAccess": "disabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "disabledDataExfiltrationOptions": [],
    "upgradeAvailable": false,
    "serviceUpgradeDate": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "[email protected]",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

Codice di stato:: 201

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "name": "mysearchservice",
  "location": "westus",
  "type": "Microsoft.Search/searchServices",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "Provisioning",
    "publicNetworkAccess": "disabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "disabledDataExfiltrationOptions": [],
    "upgradeAvailable": false,
    "serviceUpgradeDate": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "[email protected]",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

SearchCreateOrUpdateServiceToAllowAccessFromPublicCustomIPs

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-02-01-preview

{
  "location": "westus",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 1,
    "partitionCount": 1,
    "networkRuleSet": {
      "ipRules": [
        {
          "value": "123.4.5.6"
        },
        {
          "value": "123.4.6.0/18"
        }
      ]
    },
    "hostingMode": "default",
    "computeType": "default"
  }
}

Risposta di esempio

Codice di stato:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "name": "mysearchservice",
  "location": "westus",
  "type": "Microsoft.Search/searchServices",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 1,
    "partitionCount": 1,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "Provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [
        {
          "value": "123.4.5.6"
        },
        {
          "value": "123.4.6.0/18"
        }
      ]
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "disabledDataExfiltrationOptions": [],
    "upgradeAvailable": false,
    "serviceUpgradeDate": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "[email protected]",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

Codice di stato:: 201

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "name": "mysearchservice",
  "location": "westus",
  "type": "Microsoft.Search/searchServices",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 1,
    "partitionCount": 1,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "Provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [
        {
          "value": "123.4.5.6"
        },
        {
          "value": "123.4.6.0/18"
        }
      ]
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "disabledDataExfiltrationOptions": [],
    "upgradeAvailable": false,
    "serviceUpgradeDate": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "[email protected]",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

SearchCreateOrUpdateServiceToAllowAccessFromPublicCustomIPsAndBypass

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-02-01-preview

{
  "location": "westus",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 1,
    "partitionCount": 1,
    "networkRuleSet": {
      "ipRules": [
        {
          "value": "123.4.5.6"
        },
        {
          "value": "123.4.6.0/18"
        }
      ],
      "bypass": "AzurePortal"
    },
    "hostingMode": "default",
    "computeType": "default"
  }
}

Risposta di esempio

Codice di stato:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "name": "mysearchservice",
  "location": "westus",
  "type": "Microsoft.Search/searchServices",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 1,
    "partitionCount": 1,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "Provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [
        {
          "value": "123.4.5.6"
        },
        {
          "value": "123.4.6.0/18"
        }
      ],
      "bypass": "AzurePortal"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "disabledDataExfiltrationOptions": [],
    "upgradeAvailable": false,
    "serviceUpgradeDate": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "[email protected]",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

Codice di stato:: 201

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "name": "mysearchservice",
  "location": "westus",
  "type": "Microsoft.Search/searchServices",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 1,
    "partitionCount": 1,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "Provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [
        {
          "value": "123.4.5.6"
        },
        {
          "value": "123.4.6.0/18"
        }
      ],
      "bypass": "AzurePortal"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "disabledDataExfiltrationOptions": [],
    "upgradeAvailable": false,
    "serviceUpgradeDate": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "[email protected]",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

SearchCreateOrUpdateServiceWithCmkEnforcement

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-02-01-preview

{
  "location": "westus",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "hostingMode": "default",
    "computeType": "default",
    "encryptionWithCmk": {
      "enforcement": "Enabled"
    }
  }
}

Risposta di esempio

Codice di stato:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "name": "mysearchservice",
  "location": "westus",
  "type": "Microsoft.Search/searchServices",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "Provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Enabled",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "disabledDataExfiltrationOptions": [],
    "upgradeAvailable": false,
    "serviceUpgradeDate": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "[email protected]",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

Codice di stato:: 201

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "name": "mysearchservice",
  "location": "westus",
  "type": "Microsoft.Search/searchServices",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "Provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Enabled",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "disabledDataExfiltrationOptions": [],
    "upgradeAvailable": false,
    "serviceUpgradeDate": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "[email protected]",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

SearchCreateOrUpdateServiceWithDataExfiltration

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-02-01-preview

{
  "location": "westus",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "hostingMode": "default",
    "computeType": "default",
    "disabledDataExfiltrationOptions": [
      "All"
    ]
  }
}

Risposta di esempio

Codice di stato:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "name": "mysearchservice",
  "location": "westus",
  "type": "Microsoft.Search/searchServices",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "Provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "disabledDataExfiltrationOptions": [
      "All"
    ],
    "upgradeAvailable": false,
    "serviceUpgradeDate": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "[email protected]",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

Codice di stato:: 201

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "name": "mysearchservice",
  "location": "westus",
  "type": "Microsoft.Search/searchServices",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "Provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "disabledDataExfiltrationOptions": [
      "All"
    ],
    "upgradeAvailable": false,
    "serviceUpgradeDate": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "[email protected]",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

SearchCreateOrUpdateServiceWithIdentity

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-02-01-preview

{
  "location": "westus",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "hostingMode": "default",
    "computeType": "default"
  },
  "identity": {
    "type": "SystemAssigned, UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/user-mi": {}
    }
  }
}

Risposta di esempio

Codice di stato:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "name": "mysearchservice",
  "location": "westus",
  "type": "Microsoft.Search/searchServices",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "Provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "disabledDataExfiltrationOptions": [],
    "upgradeAvailable": false,
    "serviceUpgradeDate": null
  },
  "identity": {
    "type": "SystemAssigned, UserAssigned",
    "principalId": "9d1e1f18-2122-4988-a11c-878782e40a5c",
    "tenantId": "f686d426-8d16-42db-81b7-ab578e110ccd",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/user-mi": {
        "clientId": "cd1dcac8-82dd-45b5-9aed-76795d529f6b",
        "principalId": "24e07a75-1286-41e5-a15d-ded85ec3acd7"
      }
    }
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "[email protected]",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

Codice di stato:: 201

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "name": "mysearchservice",
  "location": "westus",
  "type": "Microsoft.Search/searchServices",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "Provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "disabledDataExfiltrationOptions": [],
    "upgradeAvailable": false,
    "serviceUpgradeDate": null
  },
  "identity": {
    "type": "SystemAssigned, UserAssigned",
    "principalId": "9d1e1f18-2122-4988-a11c-878782e40a5c",
    "tenantId": "f686d426-8d16-42db-81b7-ab578e110ccd",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/user-mi": {
        "clientId": "cd1dcac8-82dd-45b5-9aed-76795d529f6b",
        "principalId": "24e07a75-1286-41e5-a15d-ded85ec3acd7"
      }
    }
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "[email protected]",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

SearchCreateOrUpdateWithSemanticSearch

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-02-01-preview

{
  "location": "westus",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "hostingMode": "default",
    "computeType": "default",
    "semanticSearch": "free"
  }
}

Risposta di esempio

Codice di stato:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "name": "mysearchservice",
  "location": "westus",
  "type": "Microsoft.Search/searchServices",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "Provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "disabledDataExfiltrationOptions": [],
    "semanticSearch": "free",
    "upgradeAvailable": false,
    "serviceUpgradeDate": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "[email protected]",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

Codice di stato:: 201

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "name": "mysearchservice",
  "location": "westus",
  "type": "Microsoft.Search/searchServices",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "Provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "disabledDataExfiltrationOptions": [],
    "semanticSearch": "free",
    "upgradeAvailable": false,
    "serviceUpgradeDate": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "[email protected]",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

Definizioni

Nome	Descrizione
AadAuthFailureMode	Descrive la risposta inviata dall'API del piano dati di un servizio di ricerca per le richieste che hanno avuto esito negativo.
ApiKeyOnly	Indica che solo la chiave API può essere usata per l'autenticazione.
CloudError	Contiene informazioni su un errore dell'API.
CloudErrorBody	Descrive un particolare errore dell'API con un codice di errore e un messaggio.
ComputeType	Configurare questa proprietà per supportare il servizio di ricerca usando il calcolo predefinito o Il confidential compute di Azure.
createdByType	Tipo di identità che ha creato la risorsa.
DataPlaneAadOrApiKeyAuthOption	Indica che è possibile usare la chiave API o un token di accesso da un tenant di Microsoft Entra ID per l'autenticazione.
DataPlaneAuthOptions	Definisce le opzioni per il modo in cui il servizio di ricerca autentica una richiesta di piano dati. Non è possibile impostare questa impostazione se 'disableLocalAuth' è impostato su true.
EncryptionWithCmk	Descrive un criterio che determina il modo in cui le risorse all'interno del servizio di ricerca devono essere crittografate con chiavi gestite dal cliente.
HostingMode	Applicabile solo per lo SKU Standard3. È possibile impostare questa proprietà per abilitare fino a 3 partizioni ad alta densità che consentono fino a 1000 indici, che è molto più alto rispetto agli indici massimi consentiti per qualsiasi altro SKU. Per lo SKU standard3, il valore è "default" o "highDensity". Per tutti gli altri SKU, questo valore deve essere 'default'.
Identity	Dettagli sull'identità del servizio di ricerca. Un valore Null indica che al servizio di ricerca non è assegnata alcuna identità.
IdentityType	Tipo di identità usata per la risorsa. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata dal sistema che un set di identità assegnate dall'utente. Il tipo 'None' rimuoverà tutte le identità dal servizio.
IpRule	Regola di restrizione IP del servizio Ricerca intelligenza artificiale di Azure.
NetworkRuleSet	Regole specifiche della rete che determinano il modo in cui è possibile raggiungere il servizio Ricerca di intelligenza artificiale di Azure.
PrivateEndpoint	Risorsa endpoint privato dal provider Microsoft.Network.
PrivateEndpointConnection	Descrive una connessione endpoint privato esistente al servizio Ricerca intelligenza artificiale di Azure.
PrivateEndpointConnectionProperties	Descrive le proprietà di una connessione endpoint privato esistente al servizio di ricerca.
PrivateLinkServiceConnectionProvisioningState	Stato di provisioning della connessione al servizio collegamento privato. I valori validi sono Aggiornamento, Eliminazione, Operazione non riuscita, Completata, Incompleta o Annullata.
PrivateLinkServiceConnectionState	Descrive lo stato corrente di una connessione al servizio collegamento privato di Azure esistente all'endpoint privato.
PrivateLinkServiceConnectionStatus	Stato della connessione al servizio collegamento privato. I valori validi sono In sospeso, Approvato, Rifiutato o Disconnesso.
ProvisioningState	Stato dell'ultima operazione di provisioning eseguita nel servizio di ricerca. Il provisioning è uno stato intermedio che si verifica durante la creazione della capacità del servizio. Dopo la configurazione della capacità, provisioningState cambia in 'Succeeded' o 'Failed'. Le applicazioni client possono eseguire il polling dello stato di provisioning (l'intervallo di polling consigliato è compreso tra 30 secondi e un minuto) usando l'operazione Get Search Service per verificare quando viene completata un'operazione. Se si usa il servizio gratuito, questo valore tende a tornare come "Succeeded" direttamente nella chiamata a Crea servizio di ricerca. Questo perché il servizio gratuito usa la capacità già configurata.
PublicNetworkAccess	Questo valore può essere impostato su "enabled" per evitare modifiche di rilievo nelle risorse e nei modelli dei clienti esistenti. Se impostato su "disabilitato", il traffico sull'interfaccia pubblica non è consentito e le connessioni endpoint private saranno il metodo di accesso esclusivo.
SearchBypass	Possibili origini del traffico in ingresso che possono ignorare le regole definite nella sezione "ipRules".
SearchDisabledDataExfiltrationOption	Elenco di scenari di esfiltrazione di dati non consentiti in modo esplicito per il servizio di ricerca. Attualmente, l'unico valore supportato è "All" per disabilitare tutti i possibili scenari di esportazione dei dati con controlli più granulari pianificati per il futuro.
SearchEncryptionComplianceStatus	Restituisce lo stato di conformità del servizio di ricerca rispetto agli oggetti non crittografati con chiave gestita dal cliente. Se un servizio ha più di un oggetto non crittografato e l'imposizione è abilitata, il servizio viene contrassegnato come non conforme.
SearchEncryptionWithCmk	Descrive in che modo un servizio di ricerca deve applicare la conformità se trova oggetti non crittografati con la chiave gestita dal cliente.
SearchSemanticSearch	Imposta le opzioni che controllano la disponibilità della ricerca semantica. Questa configurazione è possibile solo per determinati SKU di Ricerca intelligenza artificiale di Azure in determinate posizioni.
SearchService	Descrive un servizio ricerca di intelligenza artificiale di Azure e il relativo stato corrente.
SearchServiceStatus	Stato del servizio di ricerca. I valori possibili includono: 'running': il servizio di ricerca è in esecuzione e non sono in corso operazioni di provisioning. 'provisioning': il servizio di ricerca viene effettuato il provisioning o la riduzione delle prestazioni. 'delete': il servizio di ricerca viene eliminato. "degradato": il servizio di ricerca è danneggiato. Ciò può verificarsi quando le unità di ricerca sottostanti non sono integre. Il servizio di ricerca è molto probabilmente operativo, ma le prestazioni potrebbero essere lente e alcune richieste potrebbero essere eliminate. 'disabled': il servizio di ricerca è disabilitato. In questo stato, il servizio rifiuterà tutte le richieste API. 'error': il servizio di ricerca si trova in uno stato di errore. 'stopped': il servizio di ricerca si trova in una sottoscrizione disabilitata. Se il servizio si trova negli stati di errore, disabilitati o degradati, significa che il team di Ricerca intelligenza artificiale di Azure sta esaminando attivamente il problema sottostante. I servizi dedicati in questi stati sono ancora addebitati in base al numero di unità di ricerca di cui è stato effettuato il provisioning.
SharedPrivateLinkResource	Descrive una risorsa di collegamento privato condivisa gestita dal servizio Ricerca intelligenza artificiale di Azure.
SharedPrivateLinkResourceProperties	Descrive le proprietà di una risorsa di collegamento privato condiviso esistente gestita dal servizio Ricerca intelligenza artificiale di Azure.
SharedPrivateLinkResourceProvisioningState	Stato di provisioning della risorsa collegamento privato condiviso. I valori validi sono Aggiornamento, Eliminazione, Operazione non riuscita, Operazione completata o Incompleta.
SharedPrivateLinkResourceStatus	Stato della risorsa collegamento privato condiviso. I valori validi sono In sospeso, Approvato, Rifiutato o Disconnesso.
Sku	Definisce lo SKU di un servizio di ricerca, che determina i limiti di fatturazione e capacità.
SkuName	SKU del servizio di ricerca. I valori validi includono: 'free': Servizio condiviso. 'basic': servizio dedicato con un massimo di 3 repliche. 'standard': servizio dedicato con un massimo di 12 partizioni e 12 repliche. 'standard2': simile allo standard, ma con una maggiore capacità per ogni unità di ricerca. 'standard3': la più grande offerta Standard con un massimo di 12 partizioni e 12 repliche (o fino a 3 partizioni con più indici se si imposta anche la proprietà hostingMode su 'highDensity'). 'storage_optimized_l1': supporta 1 TB per partizione, fino a 12 partizioni. 'storage_optimized_l2': supporta 2 TB per partizione, fino a 12 partizioni.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
UserAssignedManagedIdentity	Dettagli dell'identità gestita assegnata dall'utente assegnata al servizio di ricerca.

AadAuthFailureMode

Enumerazione

Descrive la risposta inviata dall'API del piano dati di un servizio di ricerca per le richieste che hanno avuto esito negativo.

Valore	Descrizione
http403	Indica che le richieste di autenticazione non riuscite devono essere presentate con un codice di stato HTTP 403 (Accesso negato).
http401WithBearerChallenge	Indica che le richieste di autenticazione non riuscite devono essere presentate con un codice di stato HTTP 401 (non autorizzato) e presentano una richiesta di verifica di connessione.

ApiKeyOnly

Oggetto

Indica che solo la chiave API può essere usata per l'autenticazione.

CloudError

Oggetto

Contiene informazioni su un errore dell'API.

Nome	Tipo	Descrizione
error	CloudErrorBody	Descrive un particolare errore dell'API con un codice di errore e un messaggio.
message	string	Breve descrizione dell'errore che indica cosa è andato storto (per informazioni dettagliate/debug fare riferimento alla proprietà 'error.message').

CloudErrorBody

Oggetto

Descrive un particolare errore dell'API con un codice di errore e un messaggio.

Nome	Tipo	Descrizione
code	string	Codice di errore che descrive più precisamente la condizione di errore rispetto a un codice di stato HTTP. Può essere usato per gestire casi di errore specifici a livello di codice.
details	CloudErrorBody[]	Contiene errori annidati correlati a questo errore.
message	string	Messaggio che descrive l'errore in dettaglio e fornisce informazioni di debug.
target	string	Destinazione dell'errore specifico, ad esempio il nome della proprietà in errore.

ComputeType

Enumerazione

Configurare questa proprietà per supportare il servizio di ricerca usando il calcolo predefinito o Il confidential compute di Azure.

Valore	Descrizione
default	Creare il servizio con il calcolo predefinito.
confidential	Creare il servizio con Confidential Compute di Azure.

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

DataPlaneAadOrApiKeyAuthOption

Oggetto

Indica che è possibile usare la chiave API o un token di accesso da un tenant di Microsoft Entra ID per l'autenticazione.

Nome	Tipo	Descrizione
aadAuthFailureMode	AadAuthFailureMode	Descrive la risposta inviata dall'API del piano dati di un servizio di ricerca per le richieste che hanno avuto esito negativo.

DataPlaneAuthOptions

Oggetto

Definisce le opzioni per il modo in cui il servizio di ricerca autentica una richiesta di piano dati. Non è possibile impostare questa impostazione se 'disableLocalAuth' è impostato su true.

Nome	Tipo	Descrizione
aadOrApiKey	DataPlaneAadOrApiKeyAuthOption	Indica che è possibile usare la chiave API o un token di accesso da un tenant di Microsoft Entra ID per l'autenticazione.
apiKeyOnly	ApiKeyOnly	Indica che solo la chiave API può essere usata per l'autenticazione.

EncryptionWithCmk

Oggetto

Descrive un criterio che determina il modo in cui le risorse all'interno del servizio di ricerca devono essere crittografate con chiavi gestite dal cliente.

Nome	Tipo	Descrizione
encryptionComplianceStatus	SearchEncryptionComplianceStatus	Restituisce lo stato di conformità del servizio di ricerca rispetto agli oggetti non crittografati con chiave gestita dal cliente. Se un servizio ha più di un oggetto non crittografato e l'imposizione è abilitata, il servizio viene contrassegnato come non conforme.
enforcement	SearchEncryptionWithCmk	Descrive in che modo un servizio di ricerca deve applicare la conformità se trova oggetti non crittografati con la chiave gestita dal cliente.

HostingMode

Enumerazione

Applicabile solo per lo SKU Standard3. È possibile impostare questa proprietà per abilitare fino a 3 partizioni ad alta densità che consentono fino a 1000 indici, che è molto più alto rispetto agli indici massimi consentiti per qualsiasi altro SKU. Per lo SKU standard3, il valore è "default" o "highDensity". Per tutti gli altri SKU, questo valore deve essere 'default'.

Valore	Descrizione
default	Il limite per il numero di indici è determinato dai limiti predefiniti per lo SKU.
highDensity	Solo l'applicazione per lo SKU Standard3, in cui il servizio di ricerca può avere fino a 1000 indici.

Identity

Oggetto

Dettagli sull'identità del servizio di ricerca. Un valore Null indica che al servizio di ricerca non è assegnata alcuna identità.

Nome	Tipo	Descrizione
principalId	string	ID principale dell'identità assegnata dal sistema del servizio di ricerca.
tenantId	string	ID tenant dell'identità assegnata dal sistema del servizio di ricerca.
type	IdentityType	Tipo di identità usata per la risorsa. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata dal sistema che un set di identità assegnate dall'utente. Il tipo 'None' rimuoverà tutte le identità dal servizio.
userAssignedIdentities	<string, UserAssignedManagedIdentity>	Elenco di identità utente associate alla risorsa. I riferimenti alla chiave del dizionario delle identità utente saranno ID risorsa ARM nel formato '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

IdentityType

Enumerazione

Tipo di identità usata per la risorsa. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata dal sistema che un set di identità assegnate dall'utente. Il tipo 'None' rimuoverà tutte le identità dal servizio.

Valore	Descrizione
None	Indica che è necessario rimuovere qualsiasi identità associata al servizio di ricerca.
SystemAssigned	Indica che l'identità assegnata dal sistema per il servizio di ricerca verrà abilitata.
UserAssigned	Indica che una o più identità assegnate dall'utente verranno assegnate al servizio di ricerca.
SystemAssigned, UserAssigned	Indica che l'identità assegnata dal sistema per il servizio di ricerca verrà abilitata insieme all'assegnazione di una o più identità assegnate dall'utente.

IpRule

Oggetto

Regola di restrizione IP del servizio Ricerca intelligenza artificiale di Azure.

Nome	Tipo	Descrizione
value	string	Valore corrispondente a un singolo indirizzo IPv4 (ad esempio, 123.1.2.3) o a un intervallo IP in formato CIDR (ad esempio, 123.1.2.3/24) da consentire.

NetworkRuleSet

Oggetto

Regole specifiche della rete che determinano il modo in cui è possibile raggiungere il servizio Ricerca di intelligenza artificiale di Azure.

Nome	Tipo	Descrizione
bypass	SearchBypass	Possibili origini del traffico in ingresso che possono ignorare le regole definite nella sezione "ipRules".
ipRules	IpRule[]	Elenco di regole di restrizione IP che definisce le reti in ingresso con l'accesso all'endpoint del servizio di ricerca. Nel frattempo, tutte le altre reti IP pubbliche vengono bloccate dal firewall. Queste regole di restrizione vengono applicate solo quando il "publicNetworkAccess" del servizio di ricerca è "abilitato". in caso contrario, il traffico sull'interfaccia pubblica non è consentito anche con regole IP pubbliche e le connessioni endpoint private sono il metodo di accesso esclusivo.

PrivateEndpoint

Oggetto

Risorsa endpoint privato dal provider Microsoft.Network.

Nome	Tipo	Descrizione
id	string	ID risorsa della risorsa endpoint privato dal provider Microsoft.Network.

PrivateEndpointConnection

Oggetto

Descrive una connessione endpoint privato esistente al servizio Ricerca intelligenza artificiale di Azure.

Nome	Tipo	Descrizione
id	string	ID risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nome della risorsa
properties	PrivateEndpointConnectionProperties	Descrive le proprietà di una connessione endpoint privato esistente al servizio Ricerca intelligenza artificiale di Azure.
type	string	Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

PrivateEndpointConnectionProperties

Oggetto

Descrive le proprietà di una connessione endpoint privato esistente al servizio di ricerca.

Nome	Tipo	Descrizione
groupId	string	ID del gruppo della risorsa di Azure per cui si trova il servizio collegamento privato.
privateEndpoint	PrivateEndpoint	Risorsa endpoint privato dal provider Microsoft.Network.
privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	Descrive lo stato corrente di una connessione al servizio collegamento privato di Azure esistente all'endpoint privato.
provisioningState	PrivateLinkServiceConnectionProvisioningState	Stato di provisioning della connessione al servizio collegamento privato. I valori validi sono Aggiornamento, Eliminazione, Operazione non riuscita, Completata, Incompleta o Annullata.

PrivateLinkServiceConnectionProvisioningState

Enumerazione

Stato di provisioning della connessione al servizio collegamento privato. I valori validi sono Aggiornamento, Eliminazione, Operazione non riuscita, Completata, Incompleta o Annullata.

Valore	Descrizione
Updating	La connessione al servizio di collegamento privato è in corso di creazione insieme ad altre risorse affinché sia completamente funzionante.
Deleting	La connessione al servizio collegamento privato è in corso di eliminazione.
Failed	Impossibile effettuare il provisioning o l'eliminazione della connessione al servizio collegamento privato.
Succeeded	Il provisioning della connessione al servizio collegamento privato è terminato ed è pronto per l'approvazione.
Incomplete	La richiesta di provisioning per la risorsa di connessione al servizio di collegamento privato è stata accettata, ma il processo di creazione non è ancora stato avviato.
Canceled	La richiesta di provisioning per la risorsa di connessione al servizio collegamento privato è stata annullata.

PrivateLinkServiceConnectionState

Oggetto

Descrive lo stato corrente di una connessione al servizio collegamento privato di Azure esistente all'endpoint privato.

Nome	Tipo	Valore predefinito	Descrizione
actionsRequired	string	None	Descrizione di eventuali azioni aggiuntive che possono essere necessarie.
description	string		Descrizione dello stato della connessione al servizio di collegamento privato.
status	PrivateLinkServiceConnectionStatus		Stato della connessione al servizio collegamento privato. I valori validi sono In sospeso, Approvato, Rifiutato o Disconnesso.

PrivateLinkServiceConnectionStatus

Enumerazione

Stato della connessione al servizio collegamento privato. I valori validi sono In sospeso, Approvato, Rifiutato o Disconnesso.

Valore	Descrizione
Pending	La connessione all'endpoint privato è stata creata ed è in attesa di approvazione.
Approved	La connessione all'endpoint privato è approvata ed è pronta per l'uso.
Rejected	La connessione all'endpoint privato è stata rifiutata e non può essere usata.
Disconnected	La connessione all'endpoint privato è stata rimossa dal servizio.

ProvisioningState

Enumerazione

Stato dell'ultima operazione di provisioning eseguita nel servizio di ricerca. Il provisioning è uno stato intermedio che si verifica durante la creazione della capacità del servizio. Dopo la configurazione della capacità, provisioningState cambia in 'Succeeded' o 'Failed'. Le applicazioni client possono eseguire il polling dello stato di provisioning (l'intervallo di polling consigliato è compreso tra 30 secondi e un minuto) usando l'operazione Get Search Service per verificare quando viene completata un'operazione. Se si usa il servizio gratuito, questo valore tende a tornare come "Succeeded" direttamente nella chiamata a Crea servizio di ricerca. Questo perché il servizio gratuito usa la capacità già configurata.

Valore	Descrizione
Succeeded	L'ultima operazione di provisioning è stata completata correttamente.
Provisioning	Il servizio di ricerca viene effettuato il provisioning o la riduzione delle prestazioni.
Failed	L'ultima operazione di provisioning non è riuscita.

PublicNetworkAccess

Enumerazione

Questo valore può essere impostato su "enabled" per evitare modifiche di rilievo nelle risorse e nei modelli dei clienti esistenti. Se impostato su "disabilitato", il traffico sull'interfaccia pubblica non è consentito e le connessioni endpoint private saranno il metodo di accesso esclusivo.

Valore	Descrizione
enabled	Il servizio di ricerca è accessibile dal traffico proveniente dalla rete Internet pubblica.
disabled	Il servizio di ricerca non è accessibile dal traffico proveniente dalla rete Internet pubblica. L'accesso è consentito solo tramite connessioni endpoint private approvate.

SearchBypass

Enumerazione

Possibili origini del traffico in ingresso che possono ignorare le regole definite nella sezione "ipRules".

Valore	Descrizione
None	Indica che nessuna origine può ignorare le regole definite nella sezione 'ipRules'. Si tratta dell'impostazione predefinita.
AzurePortal	Indica che le richieste provenienti dal portale di Azure possono ignorare le regole definite nella sezione "ipRules".
AzureServices	Indica che le richieste provenienti da servizi attendibili di Azure possono ignorare le regole definite nella sezione "ipRules".

SearchDisabledDataExfiltrationOption

Enumerazione

Elenco di scenari di esfiltrazione di dati non consentiti in modo esplicito per il servizio di ricerca. Attualmente, l'unico valore supportato è "All" per disabilitare tutti i possibili scenari di esportazione dei dati con controlli più granulari pianificati per il futuro.

Valore	Descrizione
All	Indica che tutti gli scenari di esfiltrazione dei dati sono disabilitati.

SearchEncryptionComplianceStatus

Enumerazione

Restituisce lo stato di conformità del servizio di ricerca rispetto agli oggetti non crittografati con chiave gestita dal cliente. Se un servizio ha più di un oggetto non crittografato e l'imposizione è abilitata, il servizio viene contrassegnato come non conforme.

Valore	Descrizione
Compliant	Indica che il servizio di ricerca è conforme, perché il numero di oggetti non crittografati da CMK è zero o l'imposizione è disabilitata.
NonCompliant	Indica che il servizio di ricerca dispone di più oggetti non crittografati con chiave gestita dal cliente.

SearchEncryptionWithCmk

Enumerazione

Descrive in che modo un servizio di ricerca deve applicare la conformità se trova oggetti non crittografati con la chiave gestita dal cliente.

Valore	Descrizione
Disabled	Non verrà eseguita alcuna imposizione della crittografia della chiave gestita dal cliente. Viene usata solo la crittografia gestita dal servizio predefinita.
Enabled	Il servizio di ricerca verrà contrassegnato come non conforme se uno o più oggetti non sono crittografati con una chiave gestita dal cliente.
Unspecified	I criteri di imposizione non vengono specificati in modo esplicito, con il comportamento uguale a se fosse impostato su "Disabilitato".

SearchSemanticSearch

Enumerazione

Imposta le opzioni che controllano la disponibilità della ricerca semantica. Questa configurazione è possibile solo per determinati SKU di Ricerca intelligenza artificiale di Azure in determinate posizioni.

Valore	Descrizione
disabled	Indica che il reranker semantico è disabilitato per il servizio di ricerca. Si tratta dell'impostazione predefinita.
free	Abilita il reranker semantico in un servizio di ricerca e indica che deve essere usato entro i limiti del piano gratuito. Il piano gratuito limiterebbe il volume di richieste di classificazione semantica e viene offerto senza costi aggiuntivi. Si tratta dell'impostazione predefinita per i nuovi servizi di ricerca di cui è stato effettuato il provisioning.
standard	Abilita il reranker semantico in un servizio di ricerca come funzionalità fatturabile, con una velocità effettiva e un volume più elevati di query con classificazione semantica.

SearchService

Oggetto

Descrive un servizio ricerca di intelligenza artificiale di Azure e il relativo stato corrente.

Nome	Tipo	Valore predefinito	Descrizione
id	string		ID risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	Identity		Identità della risorsa.
location	string		Posizione geografica in cui risiede la risorsa
name	string		Nome della risorsa
properties.authOptions	DataPlaneAuthOptions		Definisce le opzioni per il modo in cui l'API del piano dati di un servizio di ricerca autentica le richieste. Non è possibile impostare questa impostazione se 'disableLocalAuth' è impostato su true.
properties.computeType	ComputeType		Configurare questa proprietà per supportare il servizio di ricerca usando il calcolo predefinito o Il confidential compute di Azure.
properties.disableLocalAuth	boolean		Se impostato su true, le chiamate al servizio di ricerca non saranno autorizzate a usare le chiavi API per l'autenticazione. Non è possibile impostare su true se è definito 'dataPlaneAuthOptions'.
properties.disabledDataExfiltrationOptions	SearchDisabledDataExfiltrationOption[]		Elenco di scenari di esfiltrazione di dati non consentiti in modo esplicito per il servizio di ricerca. Attualmente, l'unico valore supportato è "All" per disabilitare tutti i possibili scenari di esportazione dei dati con controlli più granulari pianificati per il futuro.
properties.eTag	string		Proprietà generata dal sistema che rappresenta l'etag del servizio che può essere per il controllo della concorrenza ottimistica durante gli aggiornamenti.
properties.encryptionWithCmk	EncryptionWithCmk		Specifica i criteri relativi alla crittografia delle risorse (ad esempio gli indici) usando le chiavi di Customer Manager all'interno di un servizio di ricerca.
properties.endpoint	string (uri)		Endpoint del servizio Ricerca intelligenza artificiale di Azure.
properties.hostingMode	HostingMode	default	Applicabile solo per lo SKU Standard3. È possibile impostare questa proprietà per abilitare fino a 3 partizioni ad alta densità che consentono fino a 1000 indici, che è molto più alto rispetto agli indici massimi consentiti per qualsiasi altro SKU. Per lo SKU standard3, il valore è "default" o "highDensity". Per tutti gli altri SKU, questo valore deve essere 'default'.
properties.networkRuleSet	NetworkRuleSet		Regole specifiche della rete che determinano il modo in cui è possibile raggiungere il servizio Ricerca di intelligenza artificiale di Azure.
properties.partitionCount	integer (int32) minimum: 1 maximum: 12	1	Numero di partizioni nel servizio di ricerca; se specificato, può essere 1, 2, 3, 4, 6 o 12. I valori maggiori di 1 sono validi solo per gli SKU standard. Per i servizi 'standard3' con hostingMode impostato su 'highDensity', i valori consentiti sono compresi tra 1 e 3.
properties.privateEndpointConnections	PrivateEndpointConnection[]		Elenco di connessioni endpoint privato al servizio Ricerca intelligenza artificiale di Azure.
properties.provisioningState	ProvisioningState		Stato dell'ultima operazione di provisioning eseguita nel servizio di ricerca. Il provisioning è uno stato intermedio che si verifica durante la creazione della capacità del servizio. Dopo la configurazione della capacità, provisioningState cambia in 'Succeeded' o 'Failed'. Le applicazioni client possono eseguire il polling dello stato di provisioning (l'intervallo di polling consigliato è compreso tra 30 secondi e un minuto) usando l'operazione Get Search Service per verificare quando viene completata un'operazione. Se si usa il servizio gratuito, questo valore tende a tornare come "Succeeded" direttamente nella chiamata a Crea servizio di ricerca. Questo perché il servizio gratuito usa la capacità già configurata.
properties.publicNetworkAccess	PublicNetworkAccess	enabled	Questo valore può essere impostato su "enabled" per evitare modifiche di rilievo nelle risorse e nei modelli dei clienti esistenti. Se impostato su "disabilitato", il traffico sull'interfaccia pubblica non è consentito e le connessioni endpoint private saranno il metodo di accesso esclusivo.
properties.replicaCount	integer (int32) minimum: 1 maximum: 12	1	Numero di repliche nel servizio di ricerca. Se specificato, deve essere un valore compreso tra 1 e 12 inclusi per gli SKU standard o compreso tra 1 e 3 inclusi per lo SKU basic.
properties.semanticSearch	SearchSemanticSearch		Imposta le opzioni che controllano la disponibilità della ricerca semantica. Questa configurazione è possibile solo per determinati SKU di Ricerca intelligenza artificiale di Azure in determinate posizioni.
properties.serviceUpgradeDate	string (date-time)		Data e ora dell'ultimo aggiornamento del servizio di ricerca. Questo campo sarà Null finché il servizio non viene aggiornato per la prima volta.
properties.sharedPrivateLinkResources	SharedPrivateLinkResource[]		Elenco di risorse di collegamento privato condiviso gestite dal servizio Ricerca di intelligenza artificiale di Azure.
properties.status	SearchServiceStatus		Stato del servizio di ricerca. I valori possibili includono: 'running': il servizio di ricerca è in esecuzione e non sono in corso operazioni di provisioning. 'provisioning': il servizio di ricerca viene effettuato il provisioning o la riduzione delle prestazioni. 'delete': il servizio di ricerca viene eliminato. "degradato": il servizio di ricerca è danneggiato. Ciò può verificarsi quando le unità di ricerca sottostanti non sono integre. Il servizio di ricerca è molto probabilmente operativo, ma le prestazioni potrebbero essere lente e alcune richieste potrebbero essere eliminate. 'disabled': il servizio di ricerca è disabilitato. In questo stato, il servizio rifiuterà tutte le richieste API. 'error': il servizio di ricerca si trova in uno stato di errore. 'stopped': il servizio di ricerca si trova in una sottoscrizione disabilitata. Se il servizio si trova negli stati di errore, disabilitati o degradati, significa che il team di Ricerca intelligenza artificiale di Azure sta esaminando attivamente il problema sottostante. I servizi dedicati in questi stati sono ancora addebitati in base al numero di unità di ricerca di cui è stato effettuato il provisioning.
properties.statusDetails	string		Dettagli dello stato del servizio di ricerca.
properties.upgradeAvailable	boolean		Indica se il servizio di ricerca ha o meno un aggiornamento disponibile.
sku	Sku		SKU del servizio di ricerca, che determina il livello di prezzo e i limiti di capacità. Questa proprietà è necessaria quando si crea un nuovo servizio di ricerca.
systemData	systemData		Metadati di Azure Resource Manager del servizio di ricerca contenente le informazioni createdBy e modifiedBy.
tags	object		Tag di risorsa.
type	string		Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

SearchServiceStatus

Enumerazione

Stato del servizio di ricerca. I valori possibili includono: 'running': il servizio di ricerca è in esecuzione e non sono in corso operazioni di provisioning. 'provisioning': il servizio di ricerca viene effettuato il provisioning o la riduzione delle prestazioni. 'delete': il servizio di ricerca viene eliminato. "degradato": il servizio di ricerca è danneggiato. Ciò può verificarsi quando le unità di ricerca sottostanti non sono integre. Il servizio di ricerca è molto probabilmente operativo, ma le prestazioni potrebbero essere lente e alcune richieste potrebbero essere eliminate. 'disabled': il servizio di ricerca è disabilitato. In questo stato, il servizio rifiuterà tutte le richieste API. 'error': il servizio di ricerca si trova in uno stato di errore. 'stopped': il servizio di ricerca si trova in una sottoscrizione disabilitata. Se il servizio si trova negli stati di errore, disabilitati o degradati, significa che il team di Ricerca intelligenza artificiale di Azure sta esaminando attivamente il problema sottostante. I servizi dedicati in questi stati sono ancora addebitati in base al numero di unità di ricerca di cui è stato effettuato il provisioning.

Valore	Descrizione
running	Il servizio di ricerca è in esecuzione e non sono in corso operazioni di provisioning.
provisioning	Il servizio di ricerca viene effettuato il provisioning o la riduzione delle prestazioni.
deleting	Il servizio di ricerca viene eliminato.
degraded	Il servizio di ricerca è danneggiato perché le unità di ricerca sottostanti non sono integre.
disabled	Il servizio di ricerca è disabilitato e tutte le richieste API verranno rifiutate.
error	Il servizio di ricerca è in stato di errore, che indica un errore di provisioning o di eliminazione.
stopped	Il servizio di ricerca si trova in una sottoscrizione disabilitata.

SharedPrivateLinkResource

Oggetto

Descrive una risorsa di collegamento privato condivisa gestita dal servizio Ricerca intelligenza artificiale di Azure.

Nome	Tipo	Descrizione
id	string	ID risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nome della risorsa
properties	SharedPrivateLinkResourceProperties	Descrive le proprietà di una risorsa di collegamento privato condiviso gestita dal servizio Ricerca intelligenza artificiale di Azure.
type	string	Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

SharedPrivateLinkResourceProperties

Oggetto

Descrive le proprietà di una risorsa di collegamento privato condiviso esistente gestita dal servizio Ricerca intelligenza artificiale di Azure.

Nome	Tipo	Descrizione
groupId	string	L'ID gruppo del provider della risorsa per la risorsa collegamento privato condiviso è per.
privateLinkResourceId	string	L'ID risorsa della risorsa per cui la risorsa collegamento privato condiviso è destinata.
provisioningState	SharedPrivateLinkResourceProvisioningState	Stato di provisioning della risorsa collegamento privato condiviso. I valori validi sono Aggiornamento, Eliminazione, Operazione non riuscita, Operazione completata o Incompleta.
requestMessage	string	Messaggio per richiedere l'approvazione della risorsa di collegamento privato condiviso.
resourceRegion	string	Optional. Può essere usato per specificare il percorso di Azure Resource Manager della risorsa per cui viene creato un collegamento privato condiviso. Questa operazione è necessaria solo per le risorse la cui configurazione DNS è a livello di area, ad esempio il servizio Azure Kubernetes.
status	SharedPrivateLinkResourceStatus	Stato della risorsa collegamento privato condiviso. I valori validi sono In sospeso, Approvato, Rifiutato o Disconnesso.

SharedPrivateLinkResourceProvisioningState

Enumerazione

Stato di provisioning della risorsa collegamento privato condiviso. I valori validi sono Aggiornamento, Eliminazione, Operazione non riuscita, Operazione completata o Incompleta.

Valore	Descrizione
Updating	La risorsa di collegamento privato condiviso sta per essere creata insieme ad altre risorse affinché sia completamente funzionante.
Deleting	La risorsa collegamento privato condiviso sta per essere eliminata.
Failed	Impossibile effettuare il provisioning o l'eliminazione della risorsa collegamento privato condiviso.
Succeeded	Il provisioning della risorsa collegamento privato condiviso è terminato ed è pronto per l'approvazione.
Incomplete	La richiesta di provisioning per la risorsa collegamento privato condiviso è stata accettata, ma il processo di creazione non è ancora stato avviato.

SharedPrivateLinkResourceStatus

Enumerazione

Stato della risorsa collegamento privato condiviso. I valori validi sono In sospeso, Approvato, Rifiutato o Disconnesso.

Valore	Descrizione
Pending	La risorsa collegamento privato condiviso è stata creata ed è in attesa di approvazione.
Approved	La risorsa collegamento privato condiviso è approvata ed è pronta per l'uso.
Rejected	La risorsa collegamento privato condiviso è stata rifiutata e non può essere usata.
Disconnected	La risorsa collegamento privato condiviso è stata rimossa dal servizio.

Sku

Oggetto

Definisce lo SKU di un servizio di ricerca, che determina i limiti di fatturazione e capacità.

Nome	Tipo	Descrizione
name	SkuName	SKU del servizio di ricerca. I valori validi includono: 'free': Servizio condiviso. 'basic': servizio dedicato con un massimo di 3 repliche. 'standard': servizio dedicato con un massimo di 12 partizioni e 12 repliche. 'standard2': simile allo standard, ma con una maggiore capacità per ogni unità di ricerca. 'standard3': la più grande offerta Standard con un massimo di 12 partizioni e 12 repliche (o fino a 3 partizioni con più indici se si imposta anche la proprietà hostingMode su 'highDensity'). 'storage_optimized_l1': supporta 1 TB per partizione, fino a 12 partizioni. 'storage_optimized_l2': supporta 2 TB per partizione, fino a 12 partizioni.

SkuName

Enumerazione

SKU del servizio di ricerca. I valori validi includono: 'free': Servizio condiviso. 'basic': servizio dedicato con un massimo di 3 repliche. 'standard': servizio dedicato con un massimo di 12 partizioni e 12 repliche. 'standard2': simile allo standard, ma con una maggiore capacità per ogni unità di ricerca. 'standard3': la più grande offerta Standard con un massimo di 12 partizioni e 12 repliche (o fino a 3 partizioni con più indici se si imposta anche la proprietà hostingMode su 'highDensity'). 'storage_optimized_l1': supporta 1 TB per partizione, fino a 12 partizioni. 'storage_optimized_l2': supporta 2 TB per partizione, fino a 12 partizioni.

Valore	Descrizione
free	Livello gratuito, senza garanzie di contratto di servizio e un subset delle funzionalità offerte nei livelli fatturabili.
basic	Livello fatturabile per un servizio dedicato con un massimo di 3 repliche.
standard	Livello fatturabile per un servizio dedicato con un massimo di 12 partizioni e 12 repliche.
standard2	Simile a "standard", ma con una maggiore capacità per ogni unità di ricerca.
standard3	L'offerta Standard più grande con un massimo di 12 partizioni e 12 repliche (o fino a 3 partizioni con più indici se si imposta anche la proprietà hostingMode su 'highDensity').
storage_optimized_l1	Livello fatturabile per un servizio dedicato che supporta 1 TB per partizione, fino a 12 partizioni.
storage_optimized_l2	Livello fatturabile per un servizio dedicato che supporta 2 TB per partizione, fino a 12 partizioni.

systemData

Oggetto

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

UserAssignedManagedIdentity

Oggetto

Dettagli dell'identità gestita assegnata dall'utente assegnata al servizio di ricerca.

Nome	Tipo	Descrizione
clientId	string	ID client dell'identità assegnata dall'utente.
principalId	string	ID principale dell'identità assegnata dall'utente.