Aliases - Create
建立新的搜尋別名。
POST {endpoint}/aliases?api-version=2023-10-01-PreviewURI 參數
| 名稱 | 位於 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
endpoint
|
path | True |
string |
搜尋服務的端點 URL。 |
|
api-version
|
query | True |
string |
用戶端 API 版本。 |
要求標頭
| 名稱 | 必要 | 類型 | Description |
|---|---|---|---|
| x-ms-client-request-id |
string (uuid) |
隨要求一起傳送的追蹤標識碼，以協助偵錯。 |
要求本文
| 名稱 | 必要 | 類型 | Description |
|---|---|---|---|
| indexes | True |
string[] |
這個別名所對應的索引名稱。 只能指定一個索引名稱。 |
| name | True |
string |
別名的名稱。 |
| @odata.etag |
string |
別名的 ETag。 |
回應
| 名稱 | 類型 | Description |
|---|---|---|
| 201 Created | ||
| Other Status Codes |
錯誤回應。 |
範例
SearchServiceCreateAlias
範例要求
POST https://myservice.search.windows.net/aliases?api-version=2023-10-01-Preview
{
"name": "production",
"indexes": [
"hotels"
]
}
範例回覆
{
"name": "production",
"indexes": [
"hotels"
]
}定義
| 名稱 | Description |
|---|---|
|
Search |
表示索引別名，描述從別名名稱到索引的對應。 別名名稱可用來取代支援作業的索引名稱。 |
|
Search |
描述 API 的錯誤狀況。 |
SearchAlias
表示索引別名，描述從別名名稱到索引的對應。 別名名稱可用來取代支援作業的索引名稱。
| 名稱 | 類型 | Description |
|---|---|---|
| @odata.etag |
string |
別名的 ETag。 |
| indexes |
string[] |
這個別名所對應的索引名稱。 只能指定一個索引名稱。 |
| name |
string |
別名的名稱。 |
SearchError
描述 API 的錯誤狀況。
| 名稱 | 類型 | Description |
|---|---|---|
| code |
string |
其中一組伺服器定義的錯誤碼。 |
| details |
導致此錯誤之特定錯誤的詳細數據陣列。 |
|
| message |
string |
錯誤的人類可讀取表示法。 |