Private Endpoint Connections - List By Resource
A operação Lista obtém informações sobre as ligações de ponto final privado associadas ao cofre.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName}/privateEndpointConnections?api-version=2022-07-01
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Nome do grupo de recursos que contém o cofre de chaves. |
subscription
|
path | True |
string |
Credenciais de subscrição que identificam exclusivamente a subscrição do Microsoft Azure. O ID da subscrição faz parte do URI para cada chamada de serviço. |
vault
|
path | True |
string |
O nome do cofre de chaves. Regex pattern: |
api-version
|
query | True |
string |
Versão da API de Cliente. |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
Obtenha informações sobre todas as ligações de ponto final privado no grupo de recursos especificado. |
|
Other Status Codes |
Resposta de erro que descreve a razão pela qual a operação falhou. |
Exemplos
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
}
Definições
Name | Description |
---|---|
Actions |
Uma mensagem a indicar se as alterações no fornecedor de serviços necessitam de atualizações no consumidor. |
Cloud |
Uma resposta de erro do fornecedor de recursos Key Vault |
Cloud |
Uma resposta de erro do fornecedor de recursos Key Vault |
Private |
Propriedades do objeto de ponto final privado. |
Private |
Recurso de ligação de ponto final privado. |
Private |
Lista de ligações de pontos finais privados. |
Private |
O estado de aprovisionamento atual. |
Private |
O estado da ligação do ponto final privado. |
Private |
Um objeto que representa o estado de aprovação da ligação de ligação privada. |
ActionsRequired
Uma mensagem a indicar se as alterações no fornecedor de serviços necessitam de atualizações no consumidor.
Name | Tipo | Description |
---|---|---|
None |
string |
CloudError
Uma resposta de erro do fornecedor de recursos Key Vault
Name | Tipo | Description |
---|---|---|
error |
Uma resposta de erro do fornecedor de recursos Key Vault |
CloudErrorBody
Uma resposta de erro do fornecedor de recursos Key Vault
Name | Tipo | Description |
---|---|---|
code |
string |
Código de erro. Este é um mnemónico que pode ser consumido programaticamente. |
message |
string |
Mensagem de erro amigável do utilizador. Normalmente, a mensagem é localizada e pode variar consoante a versão do serviço. |
PrivateEndpoint
Propriedades do objeto de ponto final privado.
Name | Tipo | Description |
---|---|---|
id |
string |
Identificador completo do recurso de ponto final privado. |
PrivateEndpointConnection
Recurso de ligação de ponto final privado.
Name | Tipo | Description |
---|---|---|
etag |
string |
Modificado sempre que existir uma alteração no estado da ligação de ponto final privado. |
id |
string |
Identificador completamente qualificado do recurso do cofre de chaves. |
location |
string |
Localização do Azure do recurso do cofre de chaves. |
name |
string |
Nome do recurso do cofre de chaves. |
properties.privateEndpoint |
Propriedades do objeto de ponto final privado. |
|
properties.privateLinkServiceConnectionState |
Estado de aprovação da ligação de ligação privada. |
|
properties.provisioningState |
Estado de aprovisionamento da ligação de ponto final privado. |
|
tags |
object |
Etiquetas atribuídas ao recurso do cofre de chaves. |
type |
string |
Tipo de recurso do recurso do cofre de chaves. |
PrivateEndpointConnectionListResult
Lista de ligações de pontos finais privados.
Name | Tipo | Description |
---|---|---|
nextLink |
string |
O URL para obter o próximo conjunto de ligações de ponto final privado. |
value |
A lista de ligações de pontos finais privados. |
PrivateEndpointConnectionProvisioningState
O estado de aprovisionamento atual.
Name | Tipo | Description |
---|---|---|
Creating |
string |
|
Deleting |
string |
|
Disconnected |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
PrivateEndpointServiceConnectionStatus
O estado da ligação do ponto final privado.
Name | Tipo | Description |
---|---|---|
Approved |
string |
|
Disconnected |
string |
|
Pending |
string |
|
Rejected |
string |
PrivateLinkServiceConnectionState
Um objeto que representa o estado de aprovação da ligação de ligação privada.
Name | Tipo | Description |
---|---|---|
actionsRequired |
Uma mensagem a indicar se as alterações no fornecedor de serviços necessitam de atualizações no consumidor. |
|
description |
string |
O motivo da aprovação ou rejeição. |
status |
Indica se a ligação foi aprovada, rejeitada ou removida pelo proprietário do cofre de chaves. |