Private Endpoint Connections - List By Resource
清單作業會取得與保存庫相關聯之私人端點連線的相關信息。
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName}/privateEndpointConnections?api-version=2022-07-01
URI 參數
名稱 | 位於 | 必要 | 類型 | Description |
---|---|---|---|---|
resource
|
path | True |
string |
包含金鑰保存庫的資源群組名稱。 |
subscription
|
path | True |
string |
可唯一識別 Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶識別碼會構成每個服務呼叫 URI 的一部分。 |
vault
|
path | True |
string |
金鑰保存庫的名稱。 Regex pattern: |
api-version
|
query | True |
string |
用戶端 API 版本。 |
回應
名稱 | 類型 | Description |
---|---|---|
200 OK |
取得指定資源群組中所有私人端點連線的相關信息。 |
|
Other Status Codes |
描述作業失敗原因的錯誤回應。 |
範例
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
}
定義
名稱 | Description |
---|---|
Actions |
訊息,指出服務提供者上的變更是否需要在取用者上進行任何更新。 |
Cloud |
來自 金鑰保存庫 資源提供者的錯誤回應 |
Cloud |
來自 金鑰保存庫 資源提供者的錯誤回應 |
Private |
私人端點對象屬性。 |
Private |
私人端點聯機資源。 |
Private |
私人端點連線的清單。 |
Private |
目前的布建狀態。 |
Private |
私人端點連線狀態。 |
Private |
物件,表示私人連結連線的核准狀態。 |
ActionsRequired
訊息,指出服務提供者上的變更是否需要在取用者上進行任何更新。
名稱 | 類型 | Description |
---|---|---|
None |
string |
CloudError
來自 金鑰保存庫 資源提供者的錯誤回應
名稱 | 類型 | Description |
---|---|---|
error |
來自 金鑰保存庫 資源提供者的錯誤回應 |
CloudErrorBody
來自 金鑰保存庫 資源提供者的錯誤回應
名稱 | 類型 | Description |
---|---|---|
code |
string |
錯誤碼。 這是可透過程序設計方式取用的助記鍵。 |
message |
string |
使用者易記的錯誤訊息。 訊息通常會當地語系化,而且可能會隨服務版本而有所不同。 |
PrivateEndpoint
私人端點對象屬性。
名稱 | 類型 | Description |
---|---|---|
id |
string |
私人端點資源的完整標識碼。 |
PrivateEndpointConnection
私人端點聯機資源。
名稱 | 類型 | Description |
---|---|---|
etag |
string |
每當私人端點連線的狀態有所變更時,即已修改。 |
id |
string |
金鑰保存庫資源的完整識別碼。 |
location |
string |
金鑰保存庫資源的 Azure 位置。 |
name |
string |
金鑰保存庫資源的名稱。 |
properties.privateEndpoint |
私人端點對象的屬性。 |
|
properties.privateLinkServiceConnectionState |
私人連結連線的核准狀態。 |
|
properties.provisioningState |
私人端點聯機的布建狀態。 |
|
tags |
object |
指派給金鑰保存庫資源的標記。 |
type |
string |
金鑰保存庫資源的資源類型。 |
PrivateEndpointConnectionListResult
私人端點連線的清單。
名稱 | 類型 | Description |
---|---|---|
nextLink |
string |
要取得下一組私人端點連線的URL。 |
value |
私人端點連線的清單。 |
PrivateEndpointConnectionProvisioningState
目前的布建狀態。
名稱 | 類型 | Description |
---|---|---|
Creating |
string |
|
Deleting |
string |
|
Disconnected |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
PrivateEndpointServiceConnectionStatus
私人端點連線狀態。
名稱 | 類型 | Description |
---|---|---|
Approved |
string |
|
Disconnected |
string |
|
Pending |
string |
|
Rejected |
string |
PrivateLinkServiceConnectionState
物件,表示私人連結連線的核准狀態。
名稱 | 類型 | Description |
---|---|---|
actionsRequired |
訊息,指出服務提供者上的變更是否需要在取用者上進行任何更新。 |
|
description |
string |
核准或拒絕的原因。 |
status |
指出金鑰保存庫擁有者是否已核准、拒絕或移除連線。 |