你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Services - Create Or Update

在给定资源组中创建或更新搜索服务。 如果搜索服务已存在,将使用给定值更新所有属性。

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

URI 参数

名称 必需 类型 说明
resourceGroupName
path True

string

当前订阅中的资源组的名称。 可以从 Azure 资源管理器 API 或门户获取此值。

searchServiceName
path True

string

要创建或更新的搜索服务的名称。 搜索服务名称必须仅包含小写字母、数字或短划线,不能使用短划线作为前两个字符或最后一个字符,不能包含连续短划线,并且长度必须介于 2 到 60 个字符之间。 搜索服务名称必须全局唯一,因为它们是服务 URI (https://.search.windows.net). 创建服务后,无法更改服务名称。

subscriptionId
path True

string

Microsoft Azure 订阅的唯一标识符。 可以从 Azure 资源管理器 API、命令行工具或门户获取此值。

api-version
query True

string

要用于每个请求的 API 版本。

请求头

名称 必需 类型 说明
x-ms-client-request-id

string

uuid

客户端生成的用于标识此请求的 GUID 值。 如果指定,则会将其包含在响应信息中,作为跟踪请求的一种方式。

请求正文

名称 必需 类型 说明
location True

string

资源所在的地理位置

identity

Identity

资源的标识。

properties.authOptions

DataPlaneAuthOptions

定义搜索服务的数据平面 API 如何对请求进行身份验证的选项。 如果“disableLocalAuth”设置为 true,则无法设置此值。

properties.disableLocalAuth

boolean

如果设置为 true,则不允许对搜索服务的调用利用 API 密钥进行身份验证。 如果定义了“dataPlaneAuthOptions”,则不能将其设置为 true。

properties.encryptionWithCmk

EncryptionWithCmk

指定有关使用搜索服务中客户经理密钥) 资源 ((例如索引)加密的任何策略。

properties.hostingMode

HostingMode

仅适用于 standard3 SKU。 可以将此属性设置为启用最多 3 个高密度分区,允许最多 1000 个索引,这远远高于任何其他 SKU 允许的最大索引数。 对于 standard3 SKU,该值为“default”或“highDensity”。 对于所有其他 SKU,此值必须为“default”。

properties.networkRuleSet

NetworkRuleSet

特定于网络的规则,用于确定如何访问搜索服务。

properties.partitionCount

integer

搜索服务中的分区数;如果指定,它可以是 1、2、3、4、6 或 12。 大于 1 的值仅对标准 SKU 有效。 对于 hostingMode 设置为“highDensity”的“standard3”服务,允许的值介于 1 和 3 之间。

properties.publicNetworkAccess

PublicNetworkAccess

此值可以设置为“已启用”,以避免对现有客户资源和模板进行中断性变更。 如果设置为“disabled”,则不允许通过公共接口的流量,专用终结点连接将是独占访问方法。

properties.replicaCount

integer

搜索服务中的副本数。 如果指定,则对于标准 SKU,该值必须是介于 1 到 12(非独占)之间,对于基本 SKU,该值必须是介于 1 到 3(非独占)之间的值。

properties.semanticSearch

SearchSemanticSearch

设置控制语义搜索可用性的选项。 此配置仅适用于特定位置中的某些搜索 SKU。

sku

Sku

搜索服务的 SKU,用于确定计费速率和容量限制。 创建新的搜索服务时,此属性是必需的。

tags

object

资源标记。

响应

名称 类型 说明
200 OK

SearchService

已成功更新现有服务定义。 如果更改了副本或分区数,则缩放操作将以异步方式发生。 可以通过 provisioningState 属性定期获取服务定义并监视进度。

201 Created

SearchService

如果请求创建免费搜索服务,则服务现已预配并可供使用,但存在 DNS 传播延迟。 对于其他 SKU 类型,预配以异步方式进行。 可以通过 provisioningState 属性定期获取服务定义并监视进度。

Other Status Codes

CloudError

HTTP 400 (错误的请求) :给定的服务名称或服务定义无效;有关详细信息,请参阅响应中的错误代码和消息。 HTTP 404 (找不到) :找不到订阅或资源组。 HTTP 409 (冲突) :禁用指定的订阅。

安全性

azure_auth

Microsoft Entra ID OAuth2 授权流。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
user_impersonation 模拟用户帐户

示例

SearchCreateOrUpdateService
SearchCreateOrUpdateServiceAuthOptions
SearchCreateOrUpdateServiceDisableLocalAuth
SearchCreateOrUpdateServiceToAllowAccessFromPrivateEndpoints
SearchCreateOrUpdateServiceToAllowAccessFromPublicCustomIPs
SearchCreateOrUpdateServiceWithCmkEnforcement
SearchCreateOrUpdateServiceWithIdentity
SearchCreateOrUpdateWithSemanticSearch

SearchCreateOrUpdateService

示例请求

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

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

示例响应

{
  "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,
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": []
    },
    "privateEndpointConnections": []
  }
}
{
  "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,
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": []
    },
    "privateEndpointConnections": []
  }
}

SearchCreateOrUpdateServiceAuthOptions

示例请求

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

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

示例响应

{
  "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,
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": []
    },
    "authOptions": {
      "aadOrApiKey": {
        "aadAuthFailureMode": "http401WithBearerChallenge"
      }
    }
  }
}
{
  "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,
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": []
    },
    "authOptions": {
      "aadOrApiKey": {
        "aadAuthFailureMode": "http401WithBearerChallenge"
      }
    }
  }
}

SearchCreateOrUpdateServiceDisableLocalAuth

示例请求

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

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

示例响应

{
  "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,
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": []
    },
    "disableLocalAuth": true,
    "authOptions": null
  }
}
{
  "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,
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": []
    },
    "disableLocalAuth": true,
    "authOptions": null
  }
}

SearchCreateOrUpdateServiceToAllowAccessFromPrivateEndpoints

示例请求

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

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

示例响应

{
  "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,
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "disabled",
    "networkRuleSet": {
      "ipRules": []
    },
    "privateEndpointConnections": []
  }
}
{
  "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,
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "disabled",
    "networkRuleSet": {
      "ipRules": []
    },
    "privateEndpointConnections": []
  }
}

SearchCreateOrUpdateServiceToAllowAccessFromPublicCustomIPs

示例请求

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

{
  "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"
  }
}

示例响应

{
  "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,
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [
        {
          "value": "123.4.5.6"
        },
        {
          "value": "123.4.6.0/18"
        }
      ]
    },
    "privateEndpointConnections": []
  }
}
{
  "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,
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [
        {
          "value": "123.4.5.6"
        },
        {
          "value": "123.4.6.0/18"
        }
      ]
    },
    "privateEndpointConnections": []
  }
}

SearchCreateOrUpdateServiceWithCmkEnforcement

示例请求

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

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

示例响应

{
  "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,
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": []
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Enabled",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    }
  }
}
{
  "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,
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": []
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Enabled",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    }
  }
}

SearchCreateOrUpdateServiceWithIdentity

示例请求

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

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

示例响应

{
  "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,
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": []
    },
    "privateEndpointConnections": []
  },
  "identity": {
    "type": "SystemAssigned",
    "principalId": "9d1e1f18-2122-4988-a11c-878782e40a5c",
    "tenantId": "f686d426-8d16-42db-81b7-ab578e110ccd"
  }
}
{
  "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,
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": []
    },
    "privateEndpointConnections": []
  },
  "identity": {
    "type": "SystemAssigned",
    "principalId": "9d1e1f18-2122-4988-a11c-878782e40a5c",
    "tenantId": "f686d426-8d16-42db-81b7-ab578e110ccd"
  }
}

SearchCreateOrUpdateWithSemanticSearch

示例请求

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

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

示例响应

{
  "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,
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": []
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "semanticSearch": "free"
  }
}
{
  "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,
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": []
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "semanticSearch": "free"
  }
}

定义

名称 说明
AadAuthFailureMode

描述搜索服务的数据平面 API 将为身份验证失败的请求发送的响应。

ApiKeyOnly

指示只能使用 API 密钥进行身份验证。

CloudError

包含有关 API 错误的信息。

CloudErrorBody

描述具有错误代码和消息的特定 API 错误。

DataPlaneAadOrApiKeyAuthOption

指示 API 密钥或来自Microsoft Entra ID租户的访问令牌可用于身份验证。

DataPlaneAuthOptions

定义搜索服务如何对数据平面请求进行身份验证的选项。 如果“disableLocalAuth”设置为 true,则无法设置此值。

EncryptionWithCmk

描述一个策略,该策略确定如何使用 customer=managed 密钥加密搜索服务中的资源。

HostingMode

仅适用于 standard3 SKU。 可以将此属性设置为启用最多 3 个高密度分区,允许最多 1000 个索引,这远远高于任何其他 SKU 允许的最大索引数。 对于 standard3 SKU,该值为“default”或“highDensity”。 对于所有其他 SKU,此值必须为“default”。

Identity

资源的标识。

IdentityType

标识类型。

IpRule

搜索服务的 IP 限制规则。

NetworkRuleSet

特定于网络的规则,用于确定如何访问搜索服务。

PrivateEndpoint

Microsoft.Network 提供程序提供的专用终结点资源。

PrivateEndpointConnection

描述与搜索服务的现有专用终结点连接。

PrivateEndpointConnectionProperties

描述与搜索服务的现有专用终结点连接的属性。

PrivateLinkServiceConnectionProvisioningState

专用链接服务连接的预配状态。 有效值为 Updateing、删除、Failed、Succeeded 或 Incomplete

PrivateLinkServiceConnectionState

描述与 Azure 专用终结点的现有专用链接服务连接的当前状态。

PrivateLinkServiceConnectionStatus

专用链接服务连接的状态。 有效值为 Pending、Approved、Rejected 或 Disconnected。

ProvisioningState

对搜索服务执行的最后一个预配操作的状态。 “正在设置”是一种中间状态,在建立服务容量时出现。 设置容量后,provisioningState 将更改为“succeeded”或“failed”。 客户端应用程序可以使用获取搜索服务操作查看操作完成时间, (建议的轮询间隔为 30 秒到一分钟) 轮询预配状态。 如果使用免费服务,则此值往往在调用创建搜索服务时直接以“成功”的形式返回。 这是因为免费服务使用了已设置的容量。

PublicNetworkAccess

此值可以设置为“已启用”,以避免对现有客户资源和模板进行中断性变更。 如果设置为“disabled”,则不允许通过公共接口的流量,专用终结点连接将是独占访问方法。

SearchEncryptionComplianceStatus

描述搜索服务在具有非客户加密资源方面是否合规。 如果一个服务具有多个非客户加密资源,并且“强制”处于“启用状态”,则该服务将标记为“不符合”。

SearchEncryptionWithCmk

描述搜索服务应如何强制拥有一个或多个非客户加密资源。

SearchSemanticSearch

设置控制语义搜索可用性的选项。 此配置仅适用于特定位置中的某些搜索 SKU。

SearchService

描述搜索服务及其当前状态。

SearchServiceStatus

搜索服务的状态。 可能的值包括:“running”:搜索服务正在运行,并且没有预配操作正在进行中。 “预配”:正在预配或纵向扩展或缩减搜索服务。 “正在删除”:正在删除搜索服务。 “已降级”:搜索服务已降级。 当基础搜索单元不正常时,可能会发生这种情况。 搜索服务最有可能正常运行,但性能可能很慢,某些请求可能会被删除。 “disabled”:搜索服务已禁用。 在此状态下,服务将拒绝所有 API 请求。 “error”:搜索服务处于错误状态。 如果服务处于降级、禁用或错误状态,Microsoft 正在积极调查根本问题。 这些状态下的专用服务仍根据预配的搜索单位数收费。

SharedPrivateLinkResource

描述搜索服务管理的共享专用链接资源。

SharedPrivateLinkResourceProperties

描述搜索服务管理的现有共享专用链接资源的属性。

SharedPrivateLinkResourceProvisioningState

共享专用链接资源的预配状态。 有效值为 Updateing、删除、Failed、Succeeded 或 Incomplete。

SharedPrivateLinkResourceStatus

共享专用链接资源的状态。 有效值为 Pending、Approved、Rejected 或 Disconnected。

Sku

定义搜索服务的 SKU,用于确定计费费率和容量限制。

SkuName

搜索服务的 SKU。 有效值包括:“free”:共享服务。 “basic”:最多包含 3 个副本的专用服务。 “standard”:具有最多 12 个分区和 12 个副本的专用服务。 “standard2”:类似于标准,但每个搜索单元的容量更大。 “standard3”:最大标准产品/服务最多包含 12 个分区和 12 个副本, (最多 3 个分区,如果同时将 hostingMode 属性设置为“highDensity”) 。 “storage_optimized_l1”:支持每个分区 1TB,最多支持 12 个分区。 “storage_optimized_l2”:支持每个分区 2TB,最多 12 个分区。

AadAuthFailureMode

描述搜索服务的数据平面 API 将为身份验证失败的请求发送的响应。

名称 类型 说明
http401WithBearerChallenge

string

指示身份验证失败的请求应显示 HTTP 状态代码 401 (未授权) 并呈现持有者质询。

http403

string

指示身份验证失败的请求应显示 HTTP 状态代码 403 (禁止) 。

ApiKeyOnly

指示只能使用 API 密钥进行身份验证。

CloudError

包含有关 API 错误的信息。

名称 类型 说明
error

CloudErrorBody

使用错误代码和消息描述特定的 API 错误。

CloudErrorBody

描述具有错误代码和消息的特定 API 错误。

名称 类型 说明
code

string

一个错误代码,它比 HTTP 状态代码更准确地描述错误条件。 可用于以编程方式处理特定错误情况。

details

CloudErrorBody[]

包含与此错误相关的嵌套错误。

message

string

一条消息,详细说明错误并提供调试信息。

target

string

特定错误的目标 (例如,错误) 中的属性的名称。

DataPlaneAadOrApiKeyAuthOption

指示 API 密钥或来自Microsoft Entra ID租户的访问令牌可用于身份验证。

名称 类型 说明
aadAuthFailureMode

AadAuthFailureMode

描述搜索服务的数据平面 API 将为身份验证失败的请求发送的响应。

DataPlaneAuthOptions

定义搜索服务如何对数据平面请求进行身份验证的选项。 如果“disableLocalAuth”设置为 true,则无法设置此值。

名称 类型 说明
aadOrApiKey

DataPlaneAadOrApiKeyAuthOption

指示 API 密钥或来自Microsoft Entra ID租户的访问令牌可用于身份验证。

apiKeyOnly

ApiKeyOnly

指示只有 API 密钥可用于身份验证。

EncryptionWithCmk

描述一个策略,该策略确定如何使用 customer=managed 密钥加密搜索服务中的资源。

名称 类型 说明
encryptionComplianceStatus

SearchEncryptionComplianceStatus

描述搜索服务在具有非客户加密资源方面是否合规。 如果服务具有多个非客户加密的资源,并且“强制”已“已启用”,则该服务将标记为“不符合”。

enforcement

SearchEncryptionWithCmk

描述搜索服务应如何强制拥有一个或多个非客户加密的资源。

HostingMode

仅适用于 standard3 SKU。 可以将此属性设置为启用最多 3 个高密度分区,允许最多 1000 个索引,这远远高于任何其他 SKU 允许的最大索引数。 对于 standard3 SKU,该值为“default”或“highDensity”。 对于所有其他 SKU,此值必须为“default”。

名称 类型 说明
default

string

索引数限制由 SKU 的默认限制决定。

highDensity

string

仅适用于标准 3 SKU,其中搜索服务最多可以有 1000 个索引。

Identity

资源的标识。

名称 类型 说明
principalId

string

搜索服务的系统分配标识的主体 ID。

tenantId

string

搜索服务的系统分配标识的租户 ID。

type

IdentityType

标识类型。

IdentityType

标识类型。

名称 类型 说明
None

string

SystemAssigned

string

IpRule

搜索服务的 IP 限制规则。

名称 类型 说明
value

string

对应于单个 IPv4 地址的值 (例如,123.1.2.3) 或 CIDR 格式的 IP 范围 (允许 123.1.2.3/24) 。

NetworkRuleSet

特定于网络的规则,用于确定如何访问搜索服务。

名称 类型 说明
ipRules

IpRule[]

用于 IP 防火墙的 IP 限制规则列表。 防火墙会阻止与规则不匹配的任何 IP。 仅当搜索服务的“publicNetworkAccess”处于“启用”状态时,才应用这些规则。

PrivateEndpoint

Microsoft.Network 提供程序提供的专用终结点资源。

名称 类型 说明
id

string

来自 Microsoft.Network 提供程序的专用终结点资源的资源 ID。

PrivateEndpointConnection

描述与搜索服务的现有专用终结点连接。

名称 类型 说明
id

string

资源的完全限定的资源 ID。 例如 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

资源的名称

properties

PrivateEndpointConnectionProperties

描述与搜索服务的现有专用终结点连接的属性。

type

string

资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

PrivateEndpointConnectionProperties

描述与搜索服务的现有专用终结点连接的属性。

名称 类型 说明
groupId

string

专用链接服务连接所针对的资源提供程序的组 ID。

privateEndpoint

PrivateEndpoint

Microsoft.Network 提供程序提供的专用终结点资源。

privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

描述与 Azure 专用终结点的现有专用链接服务连接的当前状态。

provisioningState

PrivateLinkServiceConnectionProvisioningState

专用链接服务连接的预配状态。 有效值为 Updateing、删除、Failed、Succeeded 或 Incomplete

PrivateLinkServiceConnectionProvisioningState

专用链接服务连接的预配状态。 有效值为 Updateing、删除、Failed、Succeeded 或 Incomplete

名称 类型 说明
Canceled

string

已取消专用链接服务连接资源的预配请求

Deleting

string

正在删除专用链接服务连接。

Failed

string

无法预配或删除专用链接服务连接。

Incomplete

string

已接受专用链接服务连接资源的预配请求,但创建过程尚未开始。

Succeeded

string

专用链接服务连接已完成预配,并已准备好审批。

Updating

string

专用链接服务连接正与其他资源一起创建,以便其完全正常运行。

PrivateLinkServiceConnectionState

描述与 Azure 专用终结点的现有专用链接服务连接的当前状态。

名称 类型 默认值 说明
actionsRequired

string

None

描述可能需要执行的任何额外操作。

description

string

专用链接服务连接状态的说明。

status

PrivateLinkServiceConnectionStatus

专用链接服务连接的状态。 有效值为 Pending、Approved、Rejected 或 Disconnected。

PrivateLinkServiceConnectionStatus

专用链接服务连接的状态。 有效值为 Pending、Approved、Rejected 或 Disconnected。

名称 类型 说明
Approved

string

专用终结点连接已获批准,可供使用。

Disconnected

string

专用终结点连接已从服务中删除。

Pending

string

专用终结点连接已创建,正在等待审批。

Rejected

string

专用终结点连接已被拒绝,无法使用。

ProvisioningState

对搜索服务执行的最后一个预配操作的状态。 “正在设置”是一种中间状态,在建立服务容量时出现。 设置容量后,provisioningState 将更改为“succeeded”或“failed”。 客户端应用程序可以使用获取搜索服务操作查看操作完成时间, (建议的轮询间隔为 30 秒到一分钟) 轮询预配状态。 如果使用免费服务,则此值往往在调用创建搜索服务时直接以“成功”的形式返回。 这是因为免费服务使用了已设置的容量。

名称 类型 说明
failed

string

上次预配操作失败。

provisioning

string

正在预配或纵向扩展或缩减搜索服务。

succeeded

string

上一个预配操作已成功完成。

PublicNetworkAccess

此值可以设置为“已启用”,以避免对现有客户资源和模板进行中断性变更。 如果设置为“disabled”,则不允许通过公共接口的流量,专用终结点连接将是独占访问方法。

名称 类型 说明
disabled

string

enabled

string

SearchEncryptionComplianceStatus

描述搜索服务在具有非客户加密资源方面是否合规。 如果一个服务具有多个非客户加密资源,并且“强制”处于“启用状态”,则该服务将标记为“不符合”。

名称 类型 说明
Compliant

string

指示搜索服务符合要求,因为非客户加密的资源数为零或强制禁用。

NonCompliant

string

指示搜索服务具有多个非客户加密的资源。

SearchEncryptionWithCmk

描述搜索服务应如何强制拥有一个或多个非客户加密资源。

名称 类型 说明
Disabled

string

不会执行任何强制措施,并且搜索服务可以具有非客户加密的资源。

Enabled

string

如果存在一个或多个非客户加密的资源,搜索服务将被标记为不合规。

Unspecified

string

未显式指定强制策略,其行为与设置为“Disabled”时的行为相同。

SearchSemanticSearch

设置控制语义搜索可用性的选项。 此配置仅适用于特定位置中的某些搜索 SKU。

名称 类型 说明
disabled

string

指示为搜索服务禁用语义排名。

free

string

在搜索服务上启用语义排名,并指示它在免费层的限制内使用。 这将限制语义排名请求的数量,并且免费提供。 这是新预配的搜索服务的默认值。

standard

string

在搜索服务上启用语义排名作为计费功能,具有更高的吞吐量和语义排名请求量。

SearchService

描述搜索服务及其当前状态。

名称 类型 默认值 说明
id

string

资源的完全限定的资源 ID。 例如 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

Identity

资源的标识。

location

string

资源所在的地理位置

name

string

资源的名称

properties.authOptions

DataPlaneAuthOptions

定义搜索服务的数据平面 API 如何对请求进行身份验证的选项。 如果“disableLocalAuth”设置为 true,则无法设置此值。

properties.disableLocalAuth

boolean

如果设置为 true,则不允许对搜索服务的调用使用 API 密钥进行身份验证。 如果定义了“dataPlaneAuthOptions”,则不能将其设置为 true。

properties.encryptionWithCmk

EncryptionWithCmk

指定有关资源加密的任何策略, (如索引) 使用搜索服务中的客户经理密钥。

properties.hostingMode

HostingMode

default

仅适用于 standard3 SKU。 可以将此属性设置为启用最多 3 个高密度分区,这些分区最多允许 1000 个索引,这远远高于任何其他 SKU 允许的最大索引数。 对于 standard3 SKU,该值为“default”或“highDensity”。 对于所有其他 SKU,此值必须为“default”。

properties.networkRuleSet

NetworkRuleSet

特定于网络的规则,用于确定如何访问搜索服务。

properties.partitionCount

integer

1

搜索服务中的分区数;如果指定,它可以是 1、2、3、4、6 或 12。 大于 1 的值仅对标准 SKU 有效。 对于 hostingMode 设置为“highDensity”的“standard3”服务,允许的值介于 1 和 3 之间。

properties.privateEndpointConnections

PrivateEndpointConnection[]

与搜索服务的专用终结点连接的列表。

properties.provisioningState

ProvisioningState

对搜索服务执行的最后一个预配操作的状态。 “正在设置”是一种中间状态,在建立服务容量时出现。 设置容量后,provisioningState 将更改为“成功”或“失败”。 客户端应用程序可以使用“获取搜索服务”操作查看操作完成时间, (建议的轮询间隔为 30 秒到 1 分钟) 轮询预配状态。 如果使用的是免费服务,则此值往往在调用 Create search service 时直接以“成功”的形式返回。 这是因为免费服务使用了已设置的容量。

properties.publicNetworkAccess

PublicNetworkAccess

enabled

此值可以设置为“enabled”,以避免对现有客户资源和模板进行中断性变更。 如果设置为“disabled”,则不允许通过公共接口的流量,专用终结点连接将是独占访问方法。

properties.replicaCount

integer

1

搜索服务中的副本数。 如果指定,则对于标准 SKU,该值必须介于 1 到 12(含 1 和 12)之间,对于基本 SKU,该值必须是介于 1 到 3(含 1 到 3)之间的值。

properties.semanticSearch

SearchSemanticSearch

设置控制语义搜索可用性的选项。 此配置仅适用于特定位置中的某些搜索 SKU。

properties.sharedPrivateLinkResources

SharedPrivateLinkResource[]

搜索服务管理的共享专用链接资源的列表。

properties.status

SearchServiceStatus

搜索服务的状态。 可能的值包括:“running”:搜索服务正在运行,并且没有预配操作正在进行中。 “预配”:正在预配或纵向扩展或缩减搜索服务。 “正在删除”:正在删除搜索服务。 “已降级”:搜索服务已降级。 当基础搜索单元不正常时,可能会发生这种情况。 搜索服务很可能正常运行,但性能可能较慢,并且某些请求可能会被删除。 “disabled”:搜索服务已禁用。 在此状态下,服务将拒绝所有 API 请求。 “error”:搜索服务处于错误状态。 如果服务处于降级、禁用或错误状态,Microsoft 正在积极调查根本问题。 这些状态下的专用服务仍根据预配的搜索单位数收费。

properties.statusDetails

string

搜索服务状态的详细信息。

sku

Sku

搜索服务的 SKU,用于确定计费费率和容量限制。 创建新的搜索服务时需要此属性。

tags

object

资源标记。

type

string

资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

SearchServiceStatus

搜索服务的状态。 可能的值包括:“running”:搜索服务正在运行,并且没有预配操作正在进行中。 “预配”:正在预配或纵向扩展或缩减搜索服务。 “正在删除”:正在删除搜索服务。 “已降级”:搜索服务已降级。 当基础搜索单元不正常时,可能会发生这种情况。 搜索服务最有可能正常运行,但性能可能很慢,某些请求可能会被删除。 “disabled”:搜索服务已禁用。 在此状态下,服务将拒绝所有 API 请求。 “error”:搜索服务处于错误状态。 如果服务处于降级、禁用或错误状态,Microsoft 正在积极调查根本问题。 这些状态下的专用服务仍根据预配的搜索单位数收费。

名称 类型 说明
degraded

string

由于基础搜索单元不正常,因此搜索服务已降级。

deleting

string

正在删除搜索服务。

disabled

string

搜索服务处于禁用状态,所有 API 请求都将被拒绝。

error

string

搜索服务处于错误状态,表示预配失败或要删除。

provisioning

string

正在预配或纵向扩展或缩减搜索服务。

running

string

搜索服务正在运行,并且未执行任何预配操作。

SharedPrivateLinkResource

描述搜索服务管理的共享专用链接资源。

名称 类型 说明
id

string

资源的完全限定的资源 ID。 例如 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

资源的名称

properties

SharedPrivateLinkResourceProperties

描述搜索服务管理的共享专用链接资源的属性。

type

string

资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

SharedPrivateLinkResourceProperties

描述搜索服务管理的现有共享专用链接资源的属性。

名称 类型 说明
groupId

string

共享专用链接资源所属的资源提供程序中的组 ID。

privateLinkResourceId

string

共享专用链接资源所针对的资源的资源的资源 ID。

provisioningState

SharedPrivateLinkResourceProvisioningState

共享专用链接资源的预配状态。 有效值为 Updateing、删除、Failed、Succeeded 或 Incomplete。

requestMessage

string

请求批准共享专用链接资源的请求消息。

resourceRegion

string

可选。 可用于指定要创建共享专用链接的资源的 Azure 资源管理器位置。 只有 DNS 配置为区域 ((例如Azure Kubernetes 服务) )的资源才需要这样做。

status

SharedPrivateLinkResourceStatus

共享专用链接资源的状态。 有效值为 Pending、Approved、Rejected 或 Disconnected。

SharedPrivateLinkResourceProvisioningState

共享专用链接资源的预配状态。 有效值为 Updateing、删除、Failed、Succeeded 或 Incomplete。

名称 类型 说明
Deleting

string

Failed

string

Incomplete

string

Succeeded

string

Updating

string

SharedPrivateLinkResourceStatus

共享专用链接资源的状态。 有效值为 Pending、Approved、Rejected 或 Disconnected。

名称 类型 说明
Approved

string

Disconnected

string

Pending

string

Rejected

string

Sku

定义搜索服务的 SKU,用于确定计费费率和容量限制。

名称 类型 说明
name

SkuName

搜索服务的 SKU。 有效值包括:“free”:共享服务。 “basic”:最多包含 3 个副本的专用服务。 “standard”:具有最多 12 个分区和 12 个副本的专用服务。 “standard2”:类似于标准,但每个搜索单元的容量更大。 “standard3”:最大标准产品/服务最多包含 12 个分区和 12 个副本, (最多 3 个分区,如果同时将 hostingMode 属性设置为“highDensity”) 。 “storage_optimized_l1”:支持每个分区 1TB,最多支持 12 个分区。 “storage_optimized_l2”:支持每个分区 2TB,最多支持 12 个分区。

SkuName

搜索服务的 SKU。 有效值包括:“free”:共享服务。 “basic”:最多包含 3 个副本的专用服务。 “standard”:具有最多 12 个分区和 12 个副本的专用服务。 “standard2”:类似于标准,但每个搜索单元的容量更大。 “standard3”:最大标准产品/服务最多包含 12 个分区和 12 个副本, (最多 3 个分区,如果同时将 hostingMode 属性设置为“highDensity”) 。 “storage_optimized_l1”:支持每个分区 1TB,最多支持 12 个分区。 “storage_optimized_l2”:支持每个分区 2TB,最多 12 个分区。

名称 类型 说明
basic

string

最多包含 3 个副本的专用服务的计费层。

free

string

免费层,没有 SLA 保证,并且部分功能在可计费层上提供。

standard

string

具有最多 12 个分区和 12 个副本的专用服务的计费层。

standard2

string

类似于“标准”,但每个搜索单位的容量更大。

standard3

string

最大标准产品/服务最多包含 12 个分区和 12 个副本 (或最多 3 个具有更多索引的分区(如果还将 hostingMode 属性设置为“highDensity”) )。

storage_optimized_l1

string

专用服务的计费层,每个分区支持 1TB,最多支持 12 个分区。

storage_optimized_l2

string

专用服务的计费层,每个分区支持 2 TB,最多支持 12 个分区。