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.

Syntaxe¶

AWS:

SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT( '<provider_service_name>' )

Copy

Azure :

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

Copy

Arguments¶

provider_service_name: Spécifie le service externe ou le point de terminaison de ressource. Par exemple, com.amazonaws.us-west-2.execute-api pour Amazon API Gateway ou com.amazonaws.us-west-2.s3 pour Amazon S3.

'provider_resource_id'

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

'subresource'

Spécifie le nom de la sous-ressource de la ressource Azure.

Cet argument n’est pas requis pour Azure Private Link Service et Azure API Management Service.

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.

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¶

AWS:

Déprovisionner un point de terminaison privé avec un accès externe à Amazon S3 :

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

Copy

Azure :

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(
  '/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"