类别：: :doc:`/sql-reference/functions-system`（系统控制）

SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT¶

取消 Snowflake VPC 或 VNet 中的专用连接端点的设置，或阻止 Snowflake 使用专用连接连接到外部服务。端点可以是服务端点或资源端点，具体取决于托管 Snowflake 账户的云平台。

如果调用此函数并指定了错误的专用连接端点，请调用 SYSTEM$RESTORE_PRIVATELINK_ENDPOINT 系统函数在七天期限内恢复端点。七天后，端点将被删除，无法恢复；您需要使用 SYSTEM$PROVISION_PRIVATELINK_ENDPOINT 系统函数重新创建端点。

语法¶

AWS：

SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT( '<provider_service_name>' )

Copy

Azure：

SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT(
 '<provider_resource_id>'
 [, '<subresource>' ]
)

Copy

实参¶

provider_service_name: 指定外部服务或资源端点。例如，com.amazonaws.us-west-2.execute-api for the Amazon API Gateway 或 com.amazonaws.us-west-2.s3 for Amazon S3。

'provider_resource_id'

指定 VPC 或 VNet 中资源的完全限定标识符。

'subresource'

指定 Azure 资源的子资源的名称。

Azure 专用链接服务 (https://learn.microsoft.com/en-us/azure/private-link/private-link-service-overview) 和 Azure API 管理服务不需要此实参。

有关所有支持的值，请参阅子资源表 (https://learn.microsoft.com/en-us/azure/private-link/private-endpoint-overview#private-link-resource)。

返回¶

返回一条状态消息，表明已成功取消配置端点及其标识符。

使用说明¶

只有账户管理员（具有 ACCOUNTADMIN 角色的用户）才能调用此函数。
如果专用连接端点未与指定实参关联，则会出现错误消息。

示例¶

AWS：

取消配置对 Amazon S3 具有外部访问权限的专用端点：

SELECT SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT('com.amazonaws.us-west-2.s3');

Copy

Azure：

取消配置专用端点，防止 Microsoft Azure 上的 Snowflake 连接到 Microsoft Azure VNet 中的 Microsoft Azure API 管理服务：

SELECT SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT(
  '/subscriptions/f4b00c5f-f6bf-41d6-806b-e1cac4f1f36f/resourceGroups/aztest1-external-function-rg/providers/Microsoft.ApiManagement/service/aztest1-external-function-api',
  'Gateway'
  );

Copy

Private endpoint with id "/subscriptions/e48379a7-2fc4-473e-b071-f94858cc83f5/resourcegroups/test_rg/providers/microsoft.network/privateendpoints/5ef8fd34-07db-4583-b0dd-0e2360398ed3" successfully marked for deletion. Before it is fully deleted in 7-8 days, it can be restored.

取消配置专用端点，防止 Microsoft Azure 上的 Snowflake 使用外部网络访问连接到外部服务：

SELECT SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT(
  '/subscriptions/11111111-2222-3333-4444-5555555555/resourceGroups/leorg1/providers/Microsoft.Sql/servers/myserver/databases/testdb',
  'sqlServer'
  );

Copy

"Resource Endpoint with id "/subscriptions/f0abb333-1b05-47c6-8c31-dd36d2512fd1/resourceGroups/privatelink-test/providers/Microsoft.Network/privateEndpoints/external-network-access-pe" deprovisioned successfully"

取消配置专用端点，防止 Snowflake 连接到 Microsoft Azure 外部暂存区：

SELECT SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT(
  '/subscriptions/cb72345g5-d347-4sdc-r3ee-70d234551a78/resourceGroups/rg-db-dev/providers/Microsoft.Storage/storageAccounts/dbasdfffext',
  'blob'
);

Copy

"Resource Endpoint with id "/subscriptions/57faea9a-20c2-4d35-b283-9c0c1e9593d8/resourceGroups/privatelink-test/providers/Microsoft.Network/privateEndpoints/external-network-access-pe" deprovisioned successfully"