Shared Private Link Resources - Create Or Update
Memulai pembuatan atau pembaruan sumber daya tautan privat bersama yang dikelola oleh layanan pencarian di grup sumber daya yang diberikan.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/sharedPrivateLinkResources/{sharedPrivateLinkResourceName}?api-version=2025-05-01
Parameter URI
| Nama | Dalam | Diperlukan | Jenis | Deskripsi |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil. |
|
search
|
path | True |
string pattern: ^(?=.{2,60}$)[a-z0-9][a-z0-9]+(-[a-z0-9]+)*$ |
Nama layanan Azure AI Search yang terkait dengan grup sumber daya yang ditentukan. |
|
shared
|
path | True |
string |
Nama sumber daya tautan privat bersama yang dikelola oleh layanan Pencarian Azure AI dalam grup sumber daya yang ditentukan. |
|
subscription
|
path | True |
string (uuid) |
ID langganan target. Nilainya harus sebuah UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Versi API yang digunakan untuk operasi ini. |
Header Permintaan
| Nama | Diperlukan | Jenis | Deskripsi |
|---|---|---|---|
| x-ms-client-request-id |
string (uuid) |
Nilai GUID yang dihasilkan klien yang mengidentifikasi permintaan ini. Jika ditentukan, ini akan disertakan dalam informasi respons sebagai cara untuk melacak permintaan. |
Isi Permintaan
| Nama | Jenis | Deskripsi |
|---|---|---|
| properties |
Menjelaskan properti sumber daya tautan privat bersama yang dikelola oleh layanan Pencarian Azure AI. |
Respons
| Nama | Jenis | Deskripsi |
|---|---|---|
| 200 OK |
Operasi pembaruan 'SharedPrivateLinkResource' sumber daya berhasil |
|
| 202 Accepted |
Operasi sumber daya diterima. Header Azure-AsyncOperation: string |
|
| Other Status Codes |
Respons kesalahan tak terduga. |
Keamanan
azure_auth
Alur OAuth2 Azure Active Directory.
Jenis:
oauth2
Alur:
implicit
URL Otorisasi:
https://login.microsoftonline.com/common/oauth2/authorize
Cakupan
| Nama | Deskripsi |
|---|---|
| user_impersonation | meniru akun pengguna Anda |
Contoh
SharedPrivateLinkResourceCreateOrUpdate
Permintaan sampel
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/sharedPrivateLinkResources/testResource?api-version=2025-05-01
{
"properties": {
"groupId": "blob",
"privateLinkResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/storageAccountName",
"requestMessage": "please approve",
"resourceRegion": null
}
}
Respon sampel
{
"name": "testResource",
"type": "Microsoft.Search/searchServices/sharedPrivateLinkResources",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/sharedPrivateLinkResources/testResource",
"properties": {
"groupId": "blob",
"privateLinkResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/storageAccountName",
"requestMessage": "please approve",
"resourceRegion": null,
"status": "Pending"
}
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchService/sharedPrivateLinkResources/testResource/operationStatuses/08586060559526078782?api-version=2025-05-01
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchService/sharedPrivateLinkResources/testResource/operationStatuses/08586060559526078782?api-version=2025-05-01
Definisi
| Nama | Deskripsi |
|---|---|
|
Cloud |
Berisi informasi tentang kesalahan API. |
|
Cloud |
Menjelaskan kesalahan API tertentu dengan kode kesalahan dan pesan. |
|
created |
Jenis identitas yang membuat sumber daya. |
|
Shared |
Menjelaskan sumber daya tautan privat bersama yang dikelola oleh layanan Pencarian Azure AI. |
|
Shared |
Menjelaskan properti sumber daya tautan privat bersama yang sudah ada yang dikelola oleh layanan Azure AI Search. |
|
Shared |
Status provisi sumber daya tautan privat bersama. Nilai yang valid adalah Memperbarui, Menghapus, Gagal, Berhasil, atau Tidak Lengkap. |
|
Shared |
Status sumber daya tautan privat bersama. Nilai yang valid tertunda, Disetujui, Ditolak, atau Terputus. |
|
system |
Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya. |
CloudError
Berisi informasi tentang kesalahan API.
| Nama | Jenis | Deskripsi |
|---|---|---|
| error |
Menjelaskan kesalahan API tertentu dengan kode kesalahan dan pesan. |
|
| message |
string |
Deskripsi singkat tentang kesalahan yang mengisyaratkan apa yang salah (untuk informasi detail/penelusuran kesalahan merujuk ke properti 'error.message'). |
CloudErrorBody
Menjelaskan kesalahan API tertentu dengan kode kesalahan dan pesan.
| Nama | Jenis | Deskripsi |
|---|---|---|
| code |
string |
Kode kesalahan yang menjelaskan kondisi kesalahan lebih tepat daripada kode status HTTP. Dapat digunakan untuk menangani kasus kesalahan tertentu secara terprogram. |
| details |
Berisi kesalahan berlapis yang terkait dengan kesalahan ini. |
|
| message |
string |
Pesan yang menjelaskan kesalahan secara rinci dan menyediakan informasi penelusuran kesalahan. |
| target |
string |
Target kesalahan tertentu (misalnya, nama properti dalam kesalahan). |
createdByType
Jenis identitas yang membuat sumber daya.
| Nilai | Deskripsi |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
SharedPrivateLinkResource
Menjelaskan sumber daya tautan privat bersama yang dikelola oleh layanan Pencarian Azure AI.
| Nama | Jenis | Deskripsi |
|---|---|---|
| id |
string (arm-id) |
ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Nama sumber daya |
| properties |
Menjelaskan properti sumber daya tautan privat bersama yang dikelola oleh layanan Pencarian Azure AI. |
|
| systemData |
Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy. |
|
| type |
string |
Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts" |
SharedPrivateLinkResourceProperties
Menjelaskan properti sumber daya tautan privat bersama yang sudah ada yang dikelola oleh layanan Azure AI Search.
| Nama | Jenis | Deskripsi |
|---|---|---|
| groupId |
string |
ID grup dari penyedia sumber daya yang digunakan untuk sumber daya tautan privat bersama. |
| privateLinkResourceId |
string |
ID sumber daya sumber daya untuk sumber daya tautan privat bersama adalah untuk. |
| provisioningState |
Status provisi sumber daya tautan privat bersama. Nilai yang valid adalah Memperbarui, Menghapus, Gagal, Berhasil, atau Tidak Lengkap. |
|
| requestMessage |
string |
Pesan untuk meminta persetujuan sumber daya tautan privat bersama. |
| resourceRegion |
string |
Fakultatif. Dapat digunakan untuk menentukan lokasi Azure Resource Manager sumber daya tempat tautan privat bersama dibuat. Ini hanya diperlukan untuk sumber daya yang konfigurasi DNS-nya regional (seperti Azure Kubernetes Service). |
| status |
Status sumber daya tautan privat bersama. Nilai yang valid tertunda, Disetujui, Ditolak, atau Terputus. |
SharedPrivateLinkResourceProvisioningState
Status provisi sumber daya tautan privat bersama. Nilai yang valid adalah Memperbarui, Menghapus, Gagal, Berhasil, atau Tidak Lengkap.
| Nilai | Deskripsi |
|---|---|
| Updating |
Sumber daya tautan privat bersama sedang dalam proses dibuat bersama dengan sumber daya lain agar berfungsi penuh. |
| Deleting |
Sumber daya tautan privat bersama sedang dalam proses dihapus. |
| Failed |
Sumber daya tautan privat bersama gagal disediakan atau dihapus. |
| Succeeded |
Sumber daya tautan privat bersama telah selesai menyediakan dan siap untuk disetujui. |
| Incomplete |
Permintaan provisi untuk sumber daya tautan privat bersama telah diterima tetapi proses pembuatan belum dimulai. |
SharedPrivateLinkResourceStatus
Status sumber daya tautan privat bersama. Nilai yang valid tertunda, Disetujui, Ditolak, atau Terputus.
| Nilai | Deskripsi |
|---|---|
| Pending |
Sumber daya tautan privat bersama telah dibuat dan menunggu persetujuan. |
| Approved |
Sumber daya tautan privat bersama disetujui dan siap digunakan. |
| Rejected |
Sumber daya tautan privat bersama telah ditolak dan tidak dapat digunakan. |
| Disconnected |
Sumber daya tautan privat bersama telah dihapus dari layanan. |
systemData
Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
| Nama | Jenis | Deskripsi |
|---|---|---|
| createdAt |
string (date-time) |
Tanda waktu pembuatan sumber daya (UTC). |
| createdBy |
string |
Identitas yang membuat sumber daya. |
| createdByType |
Jenis identitas yang membuat sumber daya. |
|
| lastModifiedAt |
string (date-time) |
Tanda waktu modifikasi terakhir sumber daya (UTC) |
| lastModifiedBy |
string |
Identitas yang terakhir mengubah sumber daya. |
| lastModifiedByType |
Jenis identitas yang terakhir memodifikasi sumber daya. |