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=2023-11-01
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
resource
|
path | True |
string |
Nama grup sumber daya dalam langganan saat ini. Anda dapat memperoleh nilai ini dari Azure Resource Manager API atau portal. |
search
|
path | True |
string |
Nama layanan pencarian yang terkait dengan grup sumber daya yang ditentukan. |
shared
|
path | True |
string |
Nama sumber daya tautan privat bersama yang dikelola oleh layanan pencarian dalam grup sumber daya yang ditentukan. |
subscription
|
path | True |
string |
Pengidentifikasi unik untuk langganan Microsoft Azure. Anda dapat memperoleh nilai ini dari Azure Resource Manager API, alat baris perintah, atau portal. |
api-version
|
query | True |
string |
Versi API yang digunakan untuk setiap permintaan. |
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 Private Link Bersama yang dikelola oleh layanan pencarian. |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
Detail sumber daya tautan privat bersama yang dibuat atau diperbarui. |
|
202 Accepted |
Operasi pembuatan atau pembaruan sumber daya tautan privat bersama telah diterima dan akan selesai secara asinkron. |
|
Other Status Codes |
HTTP 400 (Permintaan Buruk): Nama sumber daya tautan privat bersama yang diberikan atau definisi sumber daya tautan privat bersama tidak valid; Lihat kode kesalahan dan pesan dalam respons untuk detailnya. HTTP 404 (Tidak Ditemukan): Langganan, grup sumber daya, layanan pencarian, atau sumber daya tautan privat bersama tidak dapat ditemukan. HTTP 409 (Konflik): Langganan yang ditentukan dinonaktifkan. |
Keamanan
azure_auth
Microsoft Entra ID alur otorisasi OAuth2.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nama | Deskripsi |
---|---|
user_impersonation | meniru akun pengguna Anda |
Contoh
SharedPrivateLinkResourceCreateOrUpdate
Sample Request
PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/sharedPrivateLinkResources/testResource?api-version=2023-11-01
{
"properties": {
"requestMessage": "please approve",
"groupId": "blob",
"privateLinkResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/storageAccountName",
"resourceRegion": null
}
}
Sample Response
Location: https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchService/sharedPrivateLinkResources/testResource/operationStatuses/08586060559526078782?api-version=2023-11-01
Azure-AsyncOperation: https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchService/sharedPrivateLinkResources/testResource/operationStatuses/08586060559526078782?api-version=2023-11-01
{
"name": "testResource",
"type": "Microsoft.Search/searchServices/sharedPrivateLinkResources",
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/sharedPrivateLinkResources/testResource",
"properties": {
"requestMessage": "please approve",
"groupId": "blob",
"privateLinkResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/storageAccountName",
"status": "Pending",
"resourceRegion": null
}
}
Definisi
Nama | Deskripsi |
---|---|
Cloud |
Berisi informasi tentang kesalahan API. |
Cloud |
Menjelaskan kesalahan API tertentu dengan kode kesalahan dan pesan. |
Shared |
Menjelaskan Sumber Daya Private Link Bersama yang dikelola oleh layanan pencarian. |
Shared |
Menjelaskan properti Sumber Daya Private Link Bersama yang sudah ada yang dikelola oleh layanan pencarian. |
Shared |
Status penyediaan 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. |
CloudError
Berisi informasi tentang kesalahan API.
Nama | Jenis | Deskripsi |
---|---|---|
error |
Menjelaskan kesalahan API tertentu dengan kode kesalahan dan pesan. |
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). |
SharedPrivateLinkResource
Menjelaskan Sumber Daya Private Link Bersama yang dikelola oleh layanan pencarian.
Nama | Jenis | Deskripsi |
---|---|---|
id |
string |
ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Nama sumber daya. |
properties |
Menjelaskan properti Sumber Daya Private Link Bersama yang dikelola oleh layanan pencarian. |
|
type |
string |
Jenis sumber daya. Misalnya "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts" |
SharedPrivateLinkResourceProperties
Menjelaskan properti Sumber Daya Private Link Bersama yang sudah ada yang dikelola oleh layanan pencarian.
Nama | Jenis | Deskripsi |
---|---|---|
groupId |
string |
Id grup dari penyedia sumber daya untuk sumber daya tautan privat bersama adalah untuk. |
privateLinkResourceId |
string |
Id sumber daya sumber daya untuk sumber daya tautan privat bersama adalah untuk. |
provisioningState |
Status penyediaan sumber daya tautan privat bersama. Nilai yang valid adalah Memperbarui, Menghapus, Gagal, Berhasil, atau Tidak Lengkap. |
|
requestMessage |
string |
Pesan permintaan untuk meminta persetujuan sumber daya tautan privat bersama. |
resourceRegion |
string |
Pilihan. Dapat digunakan untuk menentukan lokasi Azure Resource Manager sumber daya tempat tautan privat bersama akan 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 penyediaan sumber daya tautan privat bersama. Nilai yang valid adalah Memperbarui, Menghapus, Gagal, Berhasil, atau Tidak Lengkap.
Nama | Jenis | Deskripsi |
---|---|---|
Deleting |
string |
|
Failed |
string |
|
Incomplete |
string |
|
Succeeded |
string |
|
Updating |
string |
SharedPrivateLinkResourceStatus
Status sumber daya tautan privat bersama. Nilai yang valid tertunda, Disetujui, Ditolak, atau Terputus.
Nama | Jenis | Deskripsi |
---|---|---|
Approved |
string |
|
Disconnected |
string |
|
Pending |
string |
|
Rejected |
string |