Private Endpoint Connections - Delete

Referência

Service:: Key Vault

API Version:: 2022-07-01

Elimina a ligação de ponto final privado especificada associada ao cofre de chaves.

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName}/privateEndpointConnections/{privateEndpointConnectionName}?api-version=2022-07-01

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
privateEndpointConnectionName	path	True	string	Nome da ligação de ponto final privado associada ao cofre de chaves.
resourceGroupName	path	True	string	Nome do grupo de recursos que contém o cofre de chaves.
subscriptionId	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.
vaultName	path	True	string	O nome do cofre de chaves. Regex pattern: `^[a-zA-Z0-9-]{3,24}$`
api-version	query	True	string	Versão da API de Cliente.

Respostas

Name	Tipo	Description
200 OK	PrivateEndpointConnection	A ligação de ponto final privado foi eliminada com êxito.
202 Accepted		A ligação de ponto final privado está a ser eliminada. Headers Retry-After: integer Location: string
204 No Content		A ligação de ponto final privado não existe.
Other Status Codes	CloudError	Resposta de erro que descreve a razão pela qual a operação falhou.

Exemplos

KeyVaultDeletePrivateEndpointConnection

DELETE https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-group/providers/Microsoft.KeyVault/vaults/sample-vault/privateEndpointConnections/sample-pec?api-version=2022-07-01

from azure.identity import DefaultAzureCredential
from azure.mgmt.keyvault import KeyVaultManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-keyvault
# USAGE
    python delete_private_endpoint_connection.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = KeyVaultManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-0000-0000-0000-000000000000",
    )

    response = client.private_endpoint_connections.begin_delete(
        resource_group_name="sample-group",
        vault_name="sample-vault",
        private_endpoint_connection_name="sample-pec",
    ).result()
    print(response)


# x-ms-original-file: specification/keyvault/resource-manager/Microsoft.KeyVault/stable/2022-07-01/examples/deletePrivateEndpointConnection.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 200

{
  "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",
  "properties": {
    "provisioningState": "Disconnected"
  }
}

Status code:: 202

Retry-After: 60
Location: https://some.endpoint.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-group/providers/Microsoft.KeyVault/vaults/sample-vault/privateEndpointConnections/sample-pec?operationid=25334578

Status code:: 204

Definições

Name	Description
ActionsRequired	Uma mensagem a indicar se as alterações no fornecedor de serviços necessitam de atualizações no consumidor.
CloudError	Uma resposta de erro do fornecedor de recursos Key Vault
CloudErrorBody	Uma resposta de erro do fornecedor de recursos Key Vault
PrivateEndpoint	Propriedades do objeto de ponto final privado.
PrivateEndpointConnection	Recurso de ligação de ponto final privado.
PrivateEndpointConnectionProvisioningState	O estado de aprovisionamento atual.
PrivateEndpointServiceConnectionStatus	O estado da ligação do ponto final privado.
PrivateLinkServiceConnectionState	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	CloudErrorBody	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	PrivateEndpoint	Propriedades do objeto de ponto final privado.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	Estado de aprovação da ligação de ligação privada.
properties.provisioningState	PrivateEndpointConnectionProvisioningState	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.

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	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	PrivateEndpointServiceConnectionStatus	Indica se a ligação foi aprovada, rejeitada ou removida pelo proprietário do cofre de chaves.