Private Endpoint Connections - List By Resource
Der List-Vorgang ruft Informationen zu den privaten Endpunktverbindungen ab, die dem Tresor zugeordnet sind.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName}/privateEndpointConnections?api-version=2022-07-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
resource
|
path | True |
string |
Der Name der Ressourcengruppe, die den Schlüsseltresor enthält. |
subscription
|
path | True |
string |
Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf. |
vault
|
path | True |
string |
Der Name des Schlüsseltresors. Regex pattern: |
api-version
|
query | True |
string |
Client-API-Version. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Rufen Sie Informationen zu allen verbindungen des privaten Endpunkts in der angegebenen Ressourcengruppe ab. |
|
Other Status Codes |
Fehlerantwort mit Beschreibung des Grunds für den Fehler. |
Beispiele
KeyVaultListPrivateEndpointConnection
Sample Request
Sample Response
{
"value": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-group/providers/Microsoft.KeyVault/vaults/sample-vault/privateEndpointConnections/sample-pec",
"name": "sample-pec",
"type": "Microsoft.KeyVault/vaults/privateEndpointConnections",
"etag": "",
"properties": {
"provisioningState": "Succeeded",
"privateEndpoint": {
"id": "/subscriptions/00000000-0000-0000-1234-000000000000/resourceGroups/sample-group/providers/Microsoft.Network/privateEndpoints/sample-pe"
},
"privateLinkServiceConnectionState": {
"status": "Approved",
"description": "This was automatically approved by user1234@contoso.com",
"actionsRequired": "None"
}
}
},
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-group/providers/Microsoft.KeyVault/vaults/sample-vault/privateEndpointConnections/sample-pec",
"name": "sample-pec",
"type": "Microsoft.KeyVault/vaults/privateEndpointConnections",
"etag": "",
"properties": {
"provisioningState": "Succeeded",
"privateEndpoint": {
"id": "/subscriptions/00000000-0000-0000-1234-000000000000/resourceGroups/sample-group/providers/Microsoft.Network/privateEndpoints/sample-pe"
},
"privateLinkServiceConnectionState": {
"status": "Approved",
"description": "This was automatically approved by user1234@contoso.com",
"actionsRequired": "None"
}
}
}
],
"nextLink": null
}
Definitionen
Name | Beschreibung |
---|---|
Actions |
Eine Meldung, die angibt, ob Änderungen am Dienstanbieter Updates für den Consumer erfordern. |
Cloud |
Eine Fehlerantwort von Key Vault Ressourcenanbieter |
Cloud |
Eine Fehlerantwort von Key Vault Ressourcenanbieter |
Private |
Eigenschaften des privaten Endpunktobjekts. |
Private |
Verbindungsressource für private Endpunkte. |
Private |
Liste der Verbindungen mit privaten Endpunkten. |
Private |
Der aktuelle Bereitstellungsstatus. |
Private |
Die private Endpunktverbindung status. |
Private |
Ein -Objekt, das den Genehmigungsstatus der Private Link-Verbindung darstellt. |
ActionsRequired
Eine Meldung, die angibt, ob Änderungen am Dienstanbieter Updates für den Consumer erfordern.
Name | Typ | Beschreibung |
---|---|---|
None |
string |
CloudError
Eine Fehlerantwort von Key Vault Ressourcenanbieter
Name | Typ | Beschreibung |
---|---|---|
error |
Eine Fehlerantwort von Key Vault Ressourcenanbieter |
CloudErrorBody
Eine Fehlerantwort von Key Vault Ressourcenanbieter
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Fehlercode Dies ist ein mnemonisches, das programmgesteuert genutzt werden kann. |
message |
string |
Benutzerfreundliche Fehlermeldung. Die Nachricht ist in der Regel lokalisiert und kann je nach Dienstversion variieren. |
PrivateEndpoint
Eigenschaften des privaten Endpunktobjekts.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Vollständiger Bezeichner der privaten Endpunktressource. |
PrivateEndpointConnection
Verbindungsressource für private Endpunkte.
Name | Typ | Beschreibung |
---|---|---|
etag |
string |
Wird immer dann geändert, wenn sich der Status der Verbindung mit privaten Endpunkten ändert. |
id |
string |
Vollqualifizierter Bezeichner der Schlüsseltresorressource. |
location |
string |
Azure-Speicherort der Schlüsseltresorressource. |
name |
string |
Name der Schlüsseltresorressource. |
properties.privateEndpoint |
Eigenschaften des privaten Endpunktobjekts. |
|
properties.privateLinkServiceConnectionState |
Genehmigungsstatus der Verbindung mit privatem Link. |
|
properties.provisioningState |
Bereitstellungsstatus der privaten Endpunktverbindung. |
|
tags |
object |
Tags, die der Schlüsseltresorressource zugewiesen sind. |
type |
string |
Ressourcentyp der Schlüsseltresorressource. |
PrivateEndpointConnectionListResult
Liste der Verbindungen mit privaten Endpunkten.
Name | Typ | Beschreibung |
---|---|---|
nextLink |
string |
Die URL, um den nächsten Satz privater Endpunktverbindungen abzurufen. |
value |
Die Liste der Verbindungen mit privaten Endpunkten. |
PrivateEndpointConnectionProvisioningState
Der aktuelle Bereitstellungsstatus.
Name | Typ | Beschreibung |
---|---|---|
Creating |
string |
|
Deleting |
string |
|
Disconnected |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
PrivateEndpointServiceConnectionStatus
Die private Endpunktverbindung status.
Name | Typ | Beschreibung |
---|---|---|
Approved |
string |
|
Disconnected |
string |
|
Pending |
string |
|
Rejected |
string |
PrivateLinkServiceConnectionState
Ein -Objekt, das den Genehmigungsstatus der Private Link-Verbindung darstellt.
Name | Typ | Beschreibung |
---|---|---|
actionsRequired |
Eine Meldung, die angibt, ob Änderungen am Dienstanbieter Updates für den Consumer erfordern. |
|
description |
string |
Der Grund für die Genehmigung oder Ablehnung. |
status |
Gibt an, ob die Verbindung vom Besitzer des Schlüsseltresors genehmigt, abgelehnt oder entfernt wurde. |