你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Private Endpoint Connections - Create Or Update

批准或拒绝具有给定名称的专用终结点连接。

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

URI 参数

Name In Required Type 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 Type Description
properties.privateEndpoint

连接所属的专用终结点。

properties.privateLinkServiceConnectionState

专用终结点连接的连接状态。

响应

Name Type Description
200 OK

已成功批准或拒绝专用终结点连接。

202 Accepted

已接受

Other Status Codes

错误响应: ***

  • 400 PrivateEndpointConnectionDoesNotExist - 专用终结点连接不存在

  • 400 PrivateEndpointConnectionStatusNotPending - 专用终结点连接状态未挂起

  • 400 NullRemotePrivateLinkServiceConnectionState - 远程专用链接服务连接状态为 Null

  • 400 NullPrivateEndpointConnectionProperties - 专用终结点连接属性为 Null

  • 400 NullRemotePrivateLinkServiceConnectionStateStatus - 远程专用链接服务连接状态为 Null

  • 400 错误PrivateLinkServiceConnectionStateStatus - 专用链接服务连接状态状态必须“已批准”或“已拒绝”

  • 400 NetworkingSubscriptionNotRegisteredWithSqlRp - 用于网络端专用终结点的订阅未注册到SQL资源提供程序

  • 404 PrivateEndpointConnectionDroppedByOtherWorkflow - {0}

  • 404 SubscriptionDoesNotHaveServer - 找不到请求的服务器

  • 404 ServerNotInSubscriptionResourceGroup - 指定的服务器不存在于指定的资源组和订阅中。

  • 404 OperationIdNotFound - ID 的操作不存在。

  • 409 OperationCancelled - 操作已被用户取消。

  • 409 OperationInterrupted - 无法完成资源上的操作,因为它被同一资源上的另一个操作中断。

  • 500 OperationTimedOut - 操作超时并自动回滚。 请重试该操作。

示例

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

Sample Request

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-08-01-preview

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

Sample Response

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

定义

PrivateEndpointConnection

专用终结点连接

PrivateEndpointProperty
PrivateEndpointProvisioningState

专用终结点连接的状态。

PrivateLinkServiceConnectionStateActionsRequire

专用链接服务连接所需的操作。

PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus

专用链接服务连接状态。

PrivateEndpointConnection

专用终结点连接

Name Type Description
id
  • string

资源 ID。

name
  • string

资源名称。

properties.groupIds
  • string[]

组 ID。

properties.privateEndpoint

连接所属的专用终结点。

properties.privateLinkServiceConnectionState

专用终结点连接的连接状态。

properties.provisioningState

专用终结点连接的状态。

type
  • string

资源类型。

PrivateEndpointProperty

Name Type Description
id
  • string

专用终结点的资源 ID。

PrivateEndpointProvisioningState

专用终结点连接的状态。

Name Type Description
Approving
  • string
Dropping
  • string
Failed
  • string
Ready
  • string
Rejecting
  • string

PrivateLinkServiceConnectionStateActionsRequire

专用链接服务连接所需的操作。

Name Type Description
None
  • string

PrivateLinkServiceConnectionStateProperty

Name Type Description
actionsRequired

专用链接服务连接所需的操作。

description
  • string

专用链接服务连接说明。

status

专用链接服务连接状态。

PrivateLinkServiceConnectionStateStatus

专用链接服务连接状态。

Name Type Description
Approved
  • string
Disconnected
  • string
Pending
  • string
Rejected
  • string