Condividi tramite


Shared Private Link Resources - Get

Ottiene i dettagli della risorsa di collegamento privato condiviso gestita dal servizio di ricerca nel gruppo di risorse specificato.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
resourceGroupName
path True

string

Nome del gruppo di risorse all'interno della sottoscrizione corrente. È possibile ottenere questo valore dall'API di Gestione risorse di Azure o dal portale.

searchServiceName
path True

string

Nome del servizio di ricerca associato al gruppo di risorse specificato.

sharedPrivateLinkResourceName
path True

string

Nome della risorsa di collegamento privato condiviso gestita dal servizio di ricerca all'interno del gruppo di risorse specificato.

subscriptionId
path True

string

Identificatore univoco per una sottoscrizione di Microsoft Azure. È possibile ottenere questo valore dall'API di Azure Resource Manager, dagli strumenti della riga di comando o dal portale.

api-version
query True

string

Versione dell'API da usare per ogni richiesta.

Intestazione della richiesta

Nome Necessario Tipo Descrizione
x-ms-client-request-id

string

uuid

Valore GUID generato dal client che identifica la richiesta. Se specificato, questa operazione verrà inclusa nelle informazioni di risposta come modo per tenere traccia della richiesta.

Risposte

Nome Tipo Descrizione
200 OK

SharedPrivateLinkResource

La definizione della risorsa di collegamento privato condiviso è stata recuperata correttamente ed è nella risposta.

Other Status Codes

CloudError

HTTP 404 (Not Found): impossibile trovare la sottoscrizione, il gruppo di risorse, il servizio di ricerca o la risorsa di collegamento privato condiviso.

Sicurezza

azure_auth

Microsoft Entra ID flusso di autorizzazione OAuth2.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

SharedPrivateLinkResourceGet

Esempio di richiesta

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

Risposta di esempio

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

Definizioni

Nome Descrizione
CloudError

Contiene informazioni su un errore dell'API.

CloudErrorBody

Descrive un errore dell'API specifico con un codice di errore e un messaggio.

SharedPrivateLinkResource

Descrive un collegamento privato risorsa condivisa gestita dal servizio di ricerca.

SharedPrivateLinkResourceProperties

Descrive le proprietà di un collegamento privato risorsa condivisa esistente gestita dal servizio di ricerca.

SharedPrivateLinkResourceProvisioningState

Stato di provisioning della risorsa di collegamento privato condiviso. I valori validi sono Aggiornamento, Eliminazione, Errore, Esito positivo o Incompleto.

SharedPrivateLinkResourceStatus

Stato della risorsa di collegamento privato condiviso. I valori validi sono in sospeso, approvati, rifiutati o disconnessi.

CloudError

Contiene informazioni su un errore dell'API.

Nome Tipo Descrizione
error

CloudErrorBody

Descrive un errore dell'API specifico con un codice di errore e un messaggio.

CloudErrorBody

Descrive un errore dell'API specifico con un codice di errore e un messaggio.

Nome Tipo Descrizione
code

string

Codice di errore che descrive la condizione di errore più precisamente di un codice di stato HTTP. Può essere usato per gestire casi di errore specifici a livello di codice.

details

CloudErrorBody[]

Contiene errori annidati correlati a questo errore.

message

string

Messaggio che descrive l'errore in dettaglio e fornisce informazioni di debug.

target

string

Destinazione dell'errore specifico, ad esempio il nome della proprietà in errore.

SharedPrivateLinkResource

Descrive un collegamento privato risorsa condivisa gestita dal servizio di ricerca.

Nome Tipo Descrizione
id

string

ID di risorsa completo per la risorsa. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

nome della risorsa.

properties

SharedPrivateLinkResourceProperties

Descrive le proprietà di una risorsa condivisa collegamento privato gestita dal servizio di ricerca.

type

string

Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

SharedPrivateLinkResourceProperties

Descrive le proprietà di un collegamento privato risorsa condivisa esistente gestita dal servizio di ricerca.

Nome Tipo Descrizione
groupId

string

L'ID gruppo del provider della risorsa di collegamento privato condiviso è per.

privateLinkResourceId

string

L'ID risorsa della risorsa per la risorsa di collegamento privato condiviso è per.

provisioningState

SharedPrivateLinkResourceProvisioningState

Stato di provisioning della risorsa di collegamento privato condiviso. I valori validi sono Aggiornamento, Eliminazione, Errore, Esito positivo o Incompleto.

requestMessage

string

Messaggio di richiesta per richiedere l'approvazione della risorsa di collegamento privato condiviso.

resourceRegion

string

facoltativo. Può essere usato per specificare la posizione di Azure Resource Manager della risorsa a cui creare un collegamento privato condiviso. Questa operazione è necessaria solo per queste risorse la cui configurazione DNS è a livello di area (ad esempio servizio Azure Kubernetes).

status

SharedPrivateLinkResourceStatus

Stato della risorsa di collegamento privato condiviso. I valori validi sono in sospeso, approvati, rifiutati o disconnessi.

SharedPrivateLinkResourceProvisioningState

Stato di provisioning della risorsa di collegamento privato condiviso. I valori validi sono Aggiornamento, Eliminazione, Errore, Esito positivo o Incompleto.

Nome Tipo Descrizione
Deleting

string

Failed

string

Incomplete

string

Succeeded

string

Updating

string

SharedPrivateLinkResourceStatus

Stato della risorsa di collegamento privato condiviso. I valori validi sono in sospeso, approvati, rifiutati o disconnessi.

Nome Tipo Descrizione
Approved

string

Disconnected

string

Pending

string

Rejected

string