SearchServiceUpdate Class

The parameters used to update an Azure Cognitive Search service.

Variables are only populated by the server, and will be ignored when sending a request.

Inheritance

azure.mgmt.search.models._models_py3.Resource

SearchServiceUpdate

Constructor

SearchServiceUpdate(*, sku: Optional[azure.mgmt.search.models._models_py3.Sku] = None, location: Optional[str] = None, tags: Optional[Dict[str, str]] = None, identity: Optional[azure.mgmt.search.models._models_py3.Identity] = None, replica_count: Optional[int] = 1, partition_count: Optional[int] = 1, hosting_mode: Optional[Union[str, azure.mgmt.search.models._search_management_client_enums.HostingMode]] = 'default', public_network_access: Optional[Union[str, azure.mgmt.search.models._search_management_client_enums.PublicNetworkAccess]] = 'enabled', network_rule_set: Optional[azure.mgmt.search.models._models_py3.NetworkRuleSet] = None, **kwargs)

Parameters

sku

Sku

Required

The SKU of the Search Service, which determines price tier and capacity limits. This property is required when creating a new Search Service.

location

str

Required

The geographic location of the resource. This must be one of the supported and registered Azure Geo Regions (for example, West US, East US, Southeast Asia, and so forth). This property is required when creating a new resource.

tags

dict[str, str]

Required

A set of tags. Tags to help categorize the resource in the Azure portal.

identity

Identity

Required

The identity of the resource.

replica_count

int

Required

The number of replicas in the search service. If specified, it must be a value between 1 and 12 inclusive for standard SKUs or between 1 and 3 inclusive for basic SKU.

partition_count

int

Required

The number of partitions in the search service; if specified, it can be 1, 2, 3, 4, 6, or 12. Values greater than 1 are only valid for standard SKUs. For 'standard3' services with hostingMode set to 'highDensity', the allowed values are between 1 and 3.

hosting_mode

str or HostingMode

Required

Applicable only for the standard3 SKU. You can set this property to enable up to 3 high density partitions that allow up to 1000 indexes, which is much higher than the maximum indexes allowed for any other SKU. For the standard3 SKU, the value is either 'default' or 'highDensity'. For all other SKUs, this value must be 'default'. Possible values include: "default", "highDensity". Default value: "default".

public_network_access

str or PublicNetworkAccess

Required

This value can be set to 'enabled' to avoid breaking changes on existing customer resources and templates. If set to 'disabled', traffic over public interface is not allowed, and private endpoint connections would be the exclusive access method. Possible values include: "enabled", "disabled". Default value: "enabled".

network_rule_set

NetworkRuleSet

Required

Network specific rules that determine how the Azure Cognitive Search service may be reached.

Variables

id

str

Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}.

name

str

The name of the resource.

type

str

The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts".

status

str or SearchServiceStatus

The status of the search service. Possible values include: 'running': The search service is running and no provisioning operations are underway. 'provisioning': The search service is being provisioned or scaled up or down. 'deleting': The search service is being deleted. 'degraded': The search service is degraded. This can occur when the underlying search units are not healthy. The search service is most likely operational, but performance might be slow and some requests might be dropped. 'disabled': The search service is disabled. In this state, the service will reject all API requests. 'error': The search service is in an error state. If your service is in the degraded, disabled, or error states, it means the Azure Cognitive Search team is actively investigating the underlying issue. Dedicated services in these states are still chargeable based on the number of search units provisioned. Possible values include: "running", "provisioning", "deleting", "degraded", "disabled", "error".

status_details

str

The details of the search service status.

provisioning_state

str or ProvisioningState

The state of the last provisioning operation performed on the search service. Provisioning is an intermediate state that occurs while service capacity is being established. After capacity is set up, provisioningState changes to either 'succeeded' or 'failed'. Client applications can poll provisioning status (the recommended polling interval is from 30 seconds to one minute) by using the Get Search Service operation to see when an operation is completed. If you are using the free service, this value tends to come back as 'succeeded' directly in the call to Create search service. This is because the free service uses capacity that is already set up. Possible values include: "succeeded", "provisioning", "failed".

private_endpoint_connections

list[PrivateEndpointConnection]

The list of private endpoint connections to the Azure Cognitive Search service.

shared_private_link_resources

list[SharedPrivateLinkResource]

The list of shared private link resources managed by the Azure Cognitive Search service.