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>' )

Azure :

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

Google Cloud

 SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT(
   '<service_attachment_id>'
);

Arguments¶

AWS

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

Azure

'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.

Google Cloud

'target_service_id': Spécifie l’ID de l’attache de service dans votre réseau VPC ou l’API Google régionale.

Renvoie¶

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

Access control requirements¶

Seuls les administrateurs de comptes (utilisateurs dotés du rôle ACCOUNTADMIN) peuvent appeler cette fonction.

Notes sur l’utilisation¶

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');

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'
  );
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'
  );
"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'
);
"Resource Endpoint with id "/subscriptions/57faea9a-20c2-4d35-b283-9c0c1e9593d8/resourceGroups/privatelink-test/providers/Microsoft.Network/privateEndpoints/external-network-access-pe" deprovisioned successfully"

Google Cloud

Supprimez un point de terminaison privé pour empêcher Snowflake sur Google Cloud de se connecter à l’attache de service dans votre réseau VPC Google Cloud :
SELECT SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT(
  'projects/my-project/regions/us-east4/serviceAttachments/my-service-attachment'
  );
Private endpoint with id "abcd0000000000000001" 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 Google Cloud de se connecter à un point de terminaison de service Google régional (CloudKMS) :
SELECT SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT(
 'cloudkms.us-east4.rep.googleapis.com'
 );
Private endpoint with id "abcd0000000000000001" 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 de se connecter à une zone de préparation externe pour Google Cloud :
SELECT SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT(
 'storage.us-east4.rep.googleapis.com'
 );
Private endpoint with id "abcd0000000000000001" successfully marked for deletion. Before it is fully deleted in 7-8 days, it can be restored.