Private Endpoint Connections - Create Or Update

참조

Service:: SQL Database

API Version:: 2021-11-01

지정된 이름의 프라이빗 엔드포인트 연결을 승인하거나 거부합니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
privateEndpointConnectionName	path	True	string
resourceGroupName	path	True	string	리소스를 포함하는 리소스 그룹의 이름입니다. Azure 리소스 관리자 API 또는 포털에서 이 값을 가져올 수 있습니다.
serverName	path	True	string	서버의 이름입니다.
subscriptionId	path	True	string	Azure 구독을 식별하는 구독 ID입니다.
api-version	query	True	string	요청에 사용할 API 버전입니다.

요청 본문

Name	형식	Description
properties.privateEndpoint	PrivateEndpointProperty	연결이 속한 프라이빗 엔드포인트입니다.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	프라이빗 엔드포인트 연결의 연결 상태입니다.

응답

Name	형식	Description
200 OK	PrivateEndpointConnection	프라이빗 엔드포인트 연결을 승인하거나 거부했습니다.
202 Accepted		수락됨
Other Status Codes		오류 응답: *** 400 PrivateEndpointConnectionDoesNotExist - 프라이빗 엔드포인트 연결이 없습니다. 400 PrivateEndpointConnectionStatusNotPending - 프라이빗 엔드포인트 연결 상태가 보류 중이 아닙니다. 400 NullRemotePrivateLinkServiceConnectionState - 원격 Private Link 서비스 연결 상태가 Null입니다. 400 NullPrivateEndpointConnectionProperties - 프라이빗 엔드포인트 연결 속성이 Null입니다. 400 NullRemotePrivateLinkServiceConnectionStateStatus - 원격 Private Link 서비스 연결 상태가 Null입니다. 400 IncorrectPrivateLinkServiceConnectionStateStatus - Private Link 서비스 연결 상태 상태는 "승인됨" 또는 "거부됨"이어야 합니다. 400 NetworkingSubscriptionNotRegisteredWithSqlRp - 네트워크 쪽 프라이빗 엔드포인트에 사용되는 구독이 SQL 리소스 공급자에 등록되지 않았습니다. 404 PrivateEndpointConnectionDroppedByOtherWorkflow - {0} 404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다. 404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다. 404 OperationIdNotFound - ID가 있는 작업이 없습니다. 409 OperationCancelled - 사용자가 작업을 취소했습니다. 409 OperationInterrupted - 동일한 리소스의 다른 작업에 의해 중단되었으므로 리소스에 대한 작업을 완료할 수 없습니다. 429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 500 OperationTimedOut - 작업 시간이 초과되고 자동으로 롤백됩니다. 작업을 다시 시도하세요. 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

Name

형식

Description

200 OK

PrivateEndpointConnection

프라이빗 엔드포인트 연결을 승인하거나 거부했습니다.

202 Accepted

수락됨

Other Status Codes

오류 응답: ***

400 PrivateEndpointConnectionDoesNotExist - 프라이빗 엔드포인트 연결이 없습니다.
400 PrivateEndpointConnectionStatusNotPending - 프라이빗 엔드포인트 연결 상태가 보류 중이 아닙니다.
400 NullRemotePrivateLinkServiceConnectionState - 원격 Private Link 서비스 연결 상태가 Null입니다.
400 NullPrivateEndpointConnectionProperties - 프라이빗 엔드포인트 연결 속성이 Null입니다.
400 NullRemotePrivateLinkServiceConnectionStateStatus - 원격 Private Link 서비스 연결 상태가 Null입니다.
400 IncorrectPrivateLinkServiceConnectionStateStatus - Private Link 서비스 연결 상태 상태는 "승인됨" 또는 "거부됨"이어야 합니다.
400 NetworkingSubscriptionNotRegisteredWithSqlRp - 네트워크 쪽 프라이빗 엔드포인트에 사용되는 구독이 SQL 리소스 공급자에 등록되지 않았습니다.
404 PrivateEndpointConnectionDroppedByOtherWorkflow - {0}
404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다.
404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다.
404 OperationIdNotFound - ID가 있는 작업이 없습니다.
409 OperationCancelled - 사용자가 작업을 취소했습니다.
409 OperationInterrupted - 동일한 리소스의 다른 작업에 의해 중단되었으므로 리소스에 대한 작업을 완료할 수 없습니다.
429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.
429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.
500 OperationTimedOut - 작업 시간이 초과되고 자동으로 롤백됩니다. 작업을 다시 시도하세요.
503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

예제

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

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"
    }
  }
}


import com.azure.core.util.Context;
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")),
            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

Sample Response

Status code:: 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"
    }
  }
}

Status code:: 202

정의

Name	Description
PrivateEndpointConnection	프라이빗 엔드포인트 연결
PrivateEndpointProperty
PrivateEndpointProvisioningState	프라이빗 엔드포인트 연결의 상태입니다.
PrivateLinkServiceConnectionStateActionsRequire	프라이빗 링크 서비스 연결에 필요한 작업입니다.
PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus	프라이빗 링크 서비스 연결 상태.

PrivateEndpointConnection

프라이빗 엔드포인트 연결

Name	형식	Description
id	string	리소스 ID입니다.
name	string	리소스 이름입니다.
properties.groupIds	string[]	그룹 ID.
properties.privateEndpoint	PrivateEndpointProperty	연결이 속한 프라이빗 엔드포인트입니다.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	프라이빗 엔드포인트 연결의 연결 상태입니다.
properties.provisioningState	PrivateEndpointProvisioningState	프라이빗 엔드포인트 연결의 상태입니다.
type	string	리소스 종류.

PrivateEndpointProperty

Name	형식	Description
id	string	프라이빗 엔드포인트의 리소스 ID입니다.

PrivateEndpointProvisioningState

프라이빗 엔드포인트 연결의 상태입니다.

Name	형식	Description
Approving	string
Dropping	string
Failed	string
Ready	string
Rejecting	string

PrivateLinkServiceConnectionStateActionsRequire

프라이빗 링크 서비스 연결에 필요한 작업입니다.

Name	형식	Description
None	string

PrivateLinkServiceConnectionStateProperty

Name	형식	Description
actionsRequired	PrivateLinkServiceConnectionStateActionsRequire	프라이빗 링크 서비스 연결에 필요한 작업입니다.
description	string	프라이빗 링크 서비스 연결 설명입니다.
status	PrivateLinkServiceConnectionStateStatus	프라이빗 링크 서비스 연결 상태.

PrivateLinkServiceConnectionStateStatus

프라이빗 링크 서비스 연결 상태.

Name	형식	Description
Approved	string
Disconnected	string
Pending	string
Rejected	string

Share via

Private Endpoint Connections - Create Or Update

URI 매개 변수

요청 본문

응답

예제

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

Sample Request

Sample Response

정의

PrivateEndpointConnection

PrivateEndpointProperty

PrivateEndpointProvisioningState

PrivateLinkServiceConnectionStateActionsRequire

PrivateLinkServiceConnectionStateProperty

PrivateLinkServiceConnectionStateStatus

추가 리소스