Catégories :: Fonctions système (Contrôle du système)

SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT¶

Supprime un point de terminaison de connectivité privée dans le VPC ou VNet Snowflake pour empêcher Snowflake de se connecter à un service externe à l’aide d’une connectivité privée. Le point de terminaison peut être un point de terminaison de service ou un point de terminaison de ressource selon la plateforme cloud qui héberge votre compte Snowflake.

Si vous appelez cette fonction et spécifiez le mauvais point de terminaison de connectivité privée, appelez la fonction système SYSTEM$RESTORE_PRIVATELINK_ENDPOINT pour restaurer le point de terminaison dans une période de sept jours. Après sept jours, le point de terminaison est supprimé et ne peut pas être récupéré ; vous devrez recréer le point de terminaison avec la fonction système SYSTEM$PROVISION_PRIVATELINK_ENDPOINT.

Voir aussi :: Introduction à la connectivité privée, Gestion des points de terminaison de la connectivité privée : Azure

Syntaxe¶

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

Copy

Arguments¶

provider_resource_id

Spécifie l’identificateur complet de la ressource ou du service dans votre VPC ou VNet.

'subresource'

Spécifie le nom de la sous-ressource dans l’argument host_name ; la valeur host_name est utilisée lors de la mise en service du point de terminaison privé.

Si vous souhaitez utiliser une connectivité privée sortante avec les services suivants, spécifiez ces valeurs :

Accès au réseau externe sur Microsoft Azure : Si la valeur du nom d’hôte est externalaccessdemo.database.windows.net, la valeur subresource est sqlServer.
Zones de préparation externes sur Microsoft Azure : Si la valeur du nom d’hôte est storagedemo.blob.core.windows.net, la valeur subresource est blob.

Pour toutes les valeurs prises en charge, consultez la Table des sous-ressources.

Renvoie¶

Renvoie un message de statut indiquant que le point de terminaison, avec son identifiant, est déprovisionné correctement.

Azure :

Private endpoint with id "/subscriptions/e48379a7-2fc4-473e-b071-f94858cc83f5/resourcegroups/dbsec_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.

Notes sur l’utilisation¶

Seuls les administrateurs de comptes (utilisateurs dotés du rôle ACCOUNTADMIN) peuvent appeler cette fonction.
Un message d’erreur s’affiche si un point de terminaison de connectivité privée n’est pas associé aux arguments spécifiés.

Exemples¶

Déprovisionnez un point de terminaison privé pour permettre à Snowflake sur Microsoft Azure de se connecter au service Azure API Management dans votre Azure VNet :

Supprimez un point de terminaison privé pour empêcher Snowflake sur Microsoft Azure de se connecter au service de gestion des API Microsoft Azure dans votre VNet Microsoft Azure :

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.

Supprimez un point de terminaison privé pour empêcher Snowflake sur Microsoft Azure de se connecter à un service externe à l’aide d’un accès réseau externe :

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"

Supprimez un point de terminaison privé pour empêcher Snowflake de se connecter à une zone de préparation externe pour Microsoft Azure :

SELECT SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT(
  'storagedemo.blob.core.windows.net',
  '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"