Shared Private Link Resources - Create Or Update
Elindítja a keresési szolgáltatás által az adott erőforráscsoportban kezelt megosztott privát kapcsolati erőforrás létrehozását vagy frissítését.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/sharedPrivateLinkResources/{sharedPrivateLinkResourceName}?api-version=2023-11-01
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Az aktuális előfizetésen belüli erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be. |
search
|
path | True |
string |
A megadott erőforráscsoporthoz társított keresési szolgáltatás neve. |
shared
|
path | True |
string |
A keresési szolgáltatás által a megadott erőforráscsoporton belül kezelt megosztott privát kapcsolati erőforrás neve. |
subscription
|
path | True |
string |
A Microsoft Azure-előfizetés egyedi azonosítója. Ezt az értéket az Azure Resource Manager API-ból, parancssori eszközökből vagy a portálról szerezheti be. |
api-version
|
query | True |
string |
Az egyes kérésekhez használni kívánt API-verzió. |
Kérelem fejléce
Name | Kötelező | Típus | Description |
---|---|---|---|
x-ms-client-request-id |
string uuid |
Egy ügyfél által létrehozott GUID-érték, amely azonosítja ezt a kérést. Ha meg van adva, ez a kérés nyomon követésének módjaként szerepelni fog a válaszinformációkban. |
Kérelem törzse
Name | Típus | Description |
---|---|---|
properties |
A keresési szolgáltatás által felügyelt megosztott Private Link-erőforrás tulajdonságait ismerteti. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
A létrehozott vagy frissített megosztott privát kapcsolati erőforrás részletei. |
|
202 Accepted |
A megosztott privát kapcsolat erőforrás-létrehozási vagy frissítési művelete elfogadott, és aszinkron módon fog befejeződni. |
|
Other Status Codes |
HTTP 400 (hibás kérelem): A megadott megosztott privát kapcsolat erőforrásneve vagy a megosztott privát kapcsolat erőforrásdefiníciója érvénytelen; A részletekért tekintse meg a hibakódot és az üzenetet a válaszban. HTTP 404 (Nem található): Nem található az előfizetés, az erőforráscsoport, a keresési szolgáltatás vagy a megosztott privát kapcsolati erőforrás. HTTP 409 (ütközés): A megadott előfizetés le van tiltva. |
Biztonság
azure_auth
Microsoft Entra ID OAuth2 engedélyezési folyamat.
Típus:
oauth2
Folyamat:
implicit
Engedélyezési URL:
https://login.microsoftonline.com/common/oauth2/authorize
Hatókörök
Name | Description |
---|---|
user_impersonation | felhasználói fiók megszemélyesítése |
Példák
SharedPrivateLinkResourceCreateOrUpdate
Mintakérelem
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
}
}
Mintaválasz
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
}
}
Definíciók
Name | Description |
---|---|
Cloud |
API-hibával kapcsolatos információkat tartalmaz. |
Cloud |
Egy adott API-hibát ír le hibakóddal és üzenettel. |
Shared |
A keresési szolgáltatás által felügyelt megosztott Private Link-erőforrást ismerteti. |
Shared |
A keresési szolgáltatás által felügyelt meglévő megosztott Private Link-erőforrás tulajdonságait ismerteti. |
Shared |
A megosztott privát kapcsolati erőforrás kiépítési állapota. Az érvényes értékek: Frissítés, Törlés, Sikertelen, Sikeres vagy Hiányos. |
Shared |
A megosztott privát kapcsolati erőforrás állapota. Az érvényes értékek Függőben, Jóváhagyva, Elutasítva vagy Leválasztva. |
CloudError
API-hibával kapcsolatos információkat tartalmaz.
Name | Típus | Description |
---|---|---|
error |
Egy adott API-hibát ír le hibakóddal és üzenettel. |
CloudErrorBody
Egy adott API-hibát ír le hibakóddal és üzenettel.
Name | Típus | Description |
---|---|---|
code |
string |
Hibakód, amely pontosabban írja le a hibafeltételt, mint egy HTTP-állapotkód. Adott hibaesetek programozott kezelésére használható. |
details |
Beágyazott hibákat tartalmaz, amelyek ehhez a hibához kapcsolódnak. |
|
message |
string |
Egy üzenet, amely részletesen leírja a hibát, és hibakeresési információkat nyújt. |
target |
string |
Az adott hiba célja (például a hiba tulajdonságának neve). |
SharedPrivateLinkResource
A keresési szolgáltatás által felügyelt megosztott Private Link-erőforrást ismerteti.
Name | Típus | Description |
---|---|---|
id |
string |
Az erőforrás teljes erőforrás-azonosítója. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Az erőforrás neve |
properties |
A keresési szolgáltatás által felügyelt megosztott Private Link-erőforrás tulajdonságait ismerteti. |
|
type |
string |
Az erőforrás típusa. Például "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts" |
SharedPrivateLinkResourceProperties
A keresési szolgáltatás által felügyelt meglévő megosztott Private Link-erőforrás tulajdonságait ismerteti.
Name | Típus | Description |
---|---|---|
groupId |
string |
Annak az erőforrásnak a szolgáltatójától származó csoportazonosító, amelyre a megosztott privát kapcsolat erőforrása tartozik. |
privateLinkResourceId |
string |
Annak az erőforrásnak az erőforrás-azonosítója, amelyre a megosztott privát kapcsolat erőforrása tartozik. |
provisioningState |
A megosztott privát kapcsolati erőforrás kiépítési állapota. Az érvényes értékek: Frissítés, Törlés, Sikertelen, Sikeres vagy Hiányos. |
|
requestMessage |
string |
A megosztott privát kapcsolati erőforrás jóváhagyását kérő üzenet. |
resourceRegion |
string |
Választható. Megadhatja annak az erőforrásnak az Azure Resource Manager helyét, amelyhez megosztott privát kapcsolatot kíván létrehozni. Ez csak azokhoz az erőforrásokhoz szükséges, amelyek DNS-konfigurációja regionális (például Azure Kubernetes Service). |
status |
A megosztott privát kapcsolati erőforrás állapota. Az érvényes értékek Függőben, Jóváhagyva, Elutasítva vagy Leválasztva. |
SharedPrivateLinkResourceProvisioningState
A megosztott privát kapcsolati erőforrás kiépítési állapota. Az érvényes értékek: Frissítés, Törlés, Sikertelen, Sikeres vagy Hiányos.
Name | Típus | Description |
---|---|---|
Deleting |
string |
|
Failed |
string |
|
Incomplete |
string |
|
Succeeded |
string |
|
Updating |
string |
SharedPrivateLinkResourceStatus
A megosztott privát kapcsolati erőforrás állapota. Az érvényes értékek Függőben, Jóváhagyva, Elutasítva vagy Leválasztva.
Name | Típus | Description |
---|---|---|
Approved |
string |
|
Disconnected |
string |
|
Pending |
string |
|
Rejected |
string |