Private Endpoint Connections - Create Or Update

Serviço:

SQL Database

Versão da API:

2021-11-01

Aprovar ou rejeitar uma ligação de ponto final privado com um determinado nome.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/privateEndpointConnections/{privateEndpointConnectionName}?api-version=2021-11-01

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
privateEndpointConnectionName	path	True	string
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string	O ID da subscrição que identifica uma subscrição do Azure.
api-version	query	True	string	A versão da API a utilizar para o pedido.

Corpo do Pedido

Name	Tipo	Description
properties.privateEndpoint	PrivateEndpointProperty	Ponto final privado ao qual pertence a ligação.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	Estado de ligação da ligação do ponto final privado.

Respostas

Name	Tipo	Description
200 OK	PrivateEndpointConnection	Ligação de ponto final privado aprovada ou rejeitada com êxito.
202 Accepted		Aceite
Other Status Codes		Respostas de Erro: *** 400 PrivateEndpointConnectionDoesNotExist – A Ligação de Ponto Final Privado não existe 400 PrivateEndpointConnectionStatusNotPending – O Estado da Ligação do Ponto Final Privado não está Pendente 400 NullRemotePrivateLinkServiceConnectionState - Remote Private Link Service Connection State is Null 400 NullPrivateEndpointConnectionProperties - Private Endpoint Connection Properties is Null 400 NullRemotePrivateLinkServiceConnectionStateStatus - Remote Private Link Service Connection State Status is Null 400 IncorrectPrivateLinkServiceConnectionStateStatus - Private Link Estado do Estado da Ligação do Serviço tem de ser "Aprovado" ou "Rejeitado" 400 NetworkingSubscriptionNotRegisteredWithSqlRp – a subscrição utilizada para o Ponto Final Privado do lado da rede não está registada no fornecedor de recursos SQL 404 PrivateEndpointConnectionDroppedByOtherWorkflow - {0} 404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na subscrição especificados. 404 OperationIdNotFound – a operação com o ID não existe. 409 OperationCancelled - A operação foi cancelada pelo utilizador. 409 OperationInterrupted - Não foi possível concluir a operação no recurso porque foi interrompida por outra operação no mesmo recurso. 429 SubscriptionTooManyCreateUpdateRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis. 429 SubscriptionTooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis. 500 OperationTimedOut – a operação excedeu o limite de tempo e foi revertida automaticamente. Repita a operação. 503 TooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis.

Exemplos

Approve or reject a private endpoint connection with a given name.

Pedido de amostra

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/test-svr/privateEndpointConnections/private-endpoint-connection-name?api-version=2021-11-01

{
  "properties": {
    "privateLinkServiceConnectionState": {
      "status": "Approved",
      "description": "Approved by johndoe@contoso.com"
    }
  }
}

Java

import com.azure.resourcemanager.sql.fluent.models.PrivateEndpointConnectionInner;
import com.azure.resourcemanager.sql.models.PrivateLinkServiceConnectionStateProperty;
import com.azure.resourcemanager.sql.models.PrivateLinkServiceConnectionStateStatus;

/**
 * Samples for PrivateEndpointConnections CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/PrivateEndpointConnectionUpdate.json
     */
    /**
     * Sample code: Approve or reject a private endpoint connection with a given name.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        approveOrRejectAPrivateEndpointConnectionWithAGivenName(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getPrivateEndpointConnections().createOrUpdate("Default",
            "test-svr", "private-endpoint-connection-name",
            new PrivateEndpointConnectionInner()
                .withPrivateLinkServiceConnectionState(new PrivateLinkServiceConnectionStateProperty()
                    .withStatus(PrivateLinkServiceConnectionStateStatus.APPROVED)
                    .withDescription("Approved by johndoe@contoso.com")),
            com.azure.core.util.Context.NONE);
    }
}

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

Resposta da amostra

Código de estado:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/test-svr/privateEndpointConnections/private-endpoint-connection-name",
  "name": "private-endpoint-connection-name",
  "type": "Microsoft.Sql/servers/privateEndpointConnections",
  "properties": {
    "provisioningState": "Ready",
    "privateEndpoint": {
      "id": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-Network/providers/Microsoft.Network/privateEndpoints/private-endpoint-name"
    },
    "privateLinkServiceConnectionState": {
      "status": "Approved",
      "description": "Approved by johndoe@contoso.com",
      "actionsRequired": "None"
    }
  }
}

Código de estado:

202

Definições

Name	Description
PrivateEndpointConnection	Uma ligação de ponto final privado
PrivateEndpointProperty
PrivateEndpointProvisioningState	Estado da ligação de ponto final privado.
PrivateLinkServiceConnectionStateActionsRequire	As ações necessárias para a ligação do serviço de ligação privada.
PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus	O estado da ligação do serviço de ligação privada.

PrivateEndpointConnection

Object

Uma ligação de ponto final privado

Name	Tipo	Description
id	string	ID do Recurso.
name	string	Nome do recurso.
properties.groupIds	string[]	IDs de grupo.
properties.privateEndpoint	PrivateEndpointProperty	Ponto final privado ao qual pertence a ligação.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	Estado de ligação da ligação do ponto final privado.
properties.provisioningState	PrivateEndpointProvisioningState	Estado da ligação de ponto final privado.
type	string	Tipo de recurso.

PrivateEndpointProperty

Object

Name	Tipo	Description
id	string	ID do recurso do ponto final privado.

PrivateEndpointProvisioningState

Enumeration

Estado da ligação de ponto final privado.

Valor	Description
Approving
Dropping
Failed
Ready
Rejecting

PrivateLinkServiceConnectionStateActionsRequire

Enumeration

As ações necessárias para a ligação do serviço de ligação privada.

Valor	Description
None

PrivateLinkServiceConnectionStateProperty

Object

Name	Tipo	Description
actionsRequired	PrivateLinkServiceConnectionStateActionsRequire	As ações necessárias para a ligação do serviço de ligação privada.
description	string	A descrição da ligação do serviço de ligação privada.
status	PrivateLinkServiceConnectionStateStatus	O estado da ligação do serviço de ligação privada.

PrivateLinkServiceConnectionStateStatus

Enumeration

O estado da ligação do serviço de ligação privada.

Valor	Description
Approved
Disconnected
Pending
Rejected