Private Endpoint Connections - Delete
Desconecta a conexão de ponto de extremidade privado e a exclui do serviço de pesquisa.
DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/privateEndpointConnections/{privateEndpointConnectionName}?api-version=2023-11-01
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
private
|
path | True |
string |
O nome da conexão de ponto de extremidade privado com o serviço de pesquisa com o grupo de recursos especificado. |
resource
|
path | True |
string |
O nome do grupo de recursos dentro da assinatura atual. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal. |
search
|
path | True |
string |
O nome do serviço de pesquisa associado ao grupo de recursos especificado. |
subscription
|
path | True |
string |
O identificador exclusivo de uma assinatura do Microsoft Azure. Você pode obter esse valor da API de Resource Manager do Azure, das ferramentas de linha de comando ou do portal. |
api-version
|
query | True |
string |
A versão da API a ser usada para cada solicitação. |
Cabeçalho da solicitação
Nome | Obrigatório | Tipo | Description |
---|---|---|---|
x-ms-client-request-id |
string uuid |
Um valor de GUID gerado pelo cliente que identifica esta solicitação. Se especificado, isso será incluído nas informações de resposta como uma maneira de acompanhar a solicitação. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
A conexão de ponto de extremidade privado foi desconectada e removida com êxito do serviço de pesquisa. A resposta conterá a definição atualizada da conexão de ponto de extremidade privado. |
|
404 Not Found |
Não foi possível encontrar a assinatura, o grupo de recursos, o serviço de pesquisa ou a conexão de ponto de extremidade privado. |
|
Other Status Codes |
Erro inesperado durante operação. |
Segurança
azure_auth
Microsoft Entra ID fluxo de autorização OAuth2.
Tipo:
oauth2
Flow:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Escopos
Nome | Description |
---|---|
user_impersonation | representar sua conta de usuário |
Exemplos
PrivateEndpointConnectionDelete
Solicitação de exemplo
Resposta de exemplo
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/privateEndpointConnections/testEndpoint.50bf4fbe-d7c1-4b48-a642-4f5892642546",
"name": "testEndpoint.50bf4fbe-d7c1-4b48-a642-4f5892642546",
"type": "Microsoft.Search/searchServices/privateEndpointConnections",
"properties": {
"privateEndpoint": {
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/privateEndpoints/testEndpoint"
},
"privateLinkServiceConnectionState": {
"status": "Disconnected",
"description": "",
"actionsRequired": "None"
}
}
}
Definições
Nome | Description |
---|---|
Cloud |
Contém informações sobre um erro de API. |
Cloud |
Descreve um erro de API específico com um código de erro e uma mensagem. |
Private |
O recurso de ponto de extremidade privado do provedor Microsoft.Network. |
Private |
Descreve uma conexão de ponto de extremidade privado existente com o serviço de pesquisa. |
Private |
Descreve as propriedades de uma conexão de ponto de extremidade privado existente com o serviço de pesquisa. |
Private |
O estado de provisionamento da conexão de serviço de link privado. Os valores válidos são Atualização, Exclusão, Falha, Êxito ou Incompleto |
Private |
Descreve o estado atual de uma conexão de serviço Link Privado existente com o ponto de extremidade privado do Azure. |
Private |
Status da conexão de serviço de link privado. Os valores válidos são Pendente, Aprovado, Rejeitado ou Desconectado. |
CloudError
Contém informações sobre um erro de API.
Nome | Tipo | Description |
---|---|---|
error |
Descreve um erro de API específico com um código de erro e uma mensagem. |
CloudErrorBody
Descreve um erro de API específico com um código de erro e uma mensagem.
Nome | Tipo | Description |
---|---|---|
code |
string |
Um código de erro que descreve a condição de erro com mais precisão do que um código de status HTTP. Pode ser usado para lidar programaticamente com casos de erro específicos. |
details |
Contém erros aninhados relacionados a esse erro. |
|
message |
string |
Uma mensagem que descreve o erro em detalhes e fornece informações de depuração. |
target |
string |
O destino do erro específico (por exemplo, o nome da propriedade em erro). |
PrivateEndpoint
O recurso de ponto de extremidade privado do provedor Microsoft.Network.
Nome | Tipo | Description |
---|---|---|
id |
string |
A ID do recurso de ponto de extremidade privado do provedor Microsoft.Network. |
PrivateEndpointConnection
Descreve uma conexão de ponto de extremidade privado existente com o serviço de pesquisa.
Nome | Tipo | Description |
---|---|---|
id |
string |
ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
O nome do recurso |
properties |
Descreve as propriedades de uma conexão de ponto de extremidade privado existente com o serviço de pesquisa. |
|
type |
string |
Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
PrivateEndpointConnectionProperties
Descreve as propriedades de uma conexão de ponto de extremidade privado existente com o serviço de pesquisa.
Nome | Tipo | Description |
---|---|---|
groupId |
string |
A ID do grupo do provedor de recursos para o qual a conexão de serviço de link privado se destina. |
privateEndpoint |
O recurso de ponto de extremidade privado do provedor Microsoft.Network. |
|
privateLinkServiceConnectionState |
Descreve o estado atual de uma conexão de serviço Link Privado existente com o ponto de extremidade privado do Azure. |
|
provisioningState |
O estado de provisionamento da conexão de serviço de link privado. Os valores válidos são Atualização, Exclusão, Falha, Êxito ou Incompleto |
PrivateLinkServiceConnectionProvisioningState
O estado de provisionamento da conexão de serviço de link privado. Os valores válidos são Atualização, Exclusão, Falha, Êxito ou Incompleto
Nome | Tipo | Description |
---|---|---|
Canceled |
string |
A solicitação de provisionamento para o recurso de conexão do serviço de link privado foi cancelada |
Deleting |
string |
A conexão de serviço de link privado está em processo de exclusão. |
Failed |
string |
Falha ao provisionar ou excluir a conexão do serviço de link privado. |
Incomplete |
string |
A solicitação de provisionamento para o recurso de conexão de serviço de link privado foi aceita, mas o processo de criação ainda não começou. |
Succeeded |
string |
A conexão de serviço de link privado concluiu o provisionamento e está pronta para aprovação. |
Updating |
string |
A conexão de serviço de link privado está em processo de criação junto com outros recursos para que ela seja totalmente funcional. |
PrivateLinkServiceConnectionState
Descreve o estado atual de uma conexão de serviço Link Privado existente com o ponto de extremidade privado do Azure.
Nome | Tipo | Valor padrão | Description |
---|---|---|---|
actionsRequired |
string |
None |
Uma descrição de todas as ações extras que podem ser necessárias. |
description |
string |
A descrição do estado de conexão do serviço de link privado. |
|
status |
Status da conexão de serviço de link privado. Os valores válidos são Pendente, Aprovado, Rejeitado ou Desconectado. |
PrivateLinkServiceConnectionStatus
Status da conexão de serviço de link privado. Os valores válidos são Pendente, Aprovado, Rejeitado ou Desconectado.
Nome | Tipo | Description |
---|---|---|
Approved |
string |
A conexão de ponto de extremidade privado é aprovada e está pronta para uso. |
Disconnected |
string |
A conexão de ponto de extremidade privado foi removida do serviço. |
Pending |
string |
A conexão de ponto de extremidade privado foi criada e está com aprovação pendente. |
Rejected |
string |
A conexão de ponto de extremidade privado foi rejeitada e não pode ser usada. |