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

SYSTEM$RESTORE_PRIVATELINK_ENDPOINT_TSS¶

Restaure un point de terminaison de connectivité privée dans le VPC ou VNet Snowflake pour permettre à Snowflake de se connecter à un service de gestion des clés externes (KMS) à l’aide d’une connexion 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.

Vous pouvez restaurer un point de terminaison privé dans les 7 jours suivant son déprovisionnement. Après 7 jours, le point de terminaison ne peut pas être restauré et vous devez recréer le point de terminaison avec la fonction système SYSTEM$PROVISION_PRIVATELINK_ENDPOINT_TSS.

Syntaxe¶

AWS:

SYSTEM$RESTORE_PRIVATELINK_ENDPOINT_TSS(
  '<provider_service_name>'
  )

Copy

Azure :

SYSTEM$RESTORE_PRIVATELINK_ENDPOINT_TSS(
  '<provider_resource_id>'
  )

Copy

Arguments¶

AWS:

provider_service_name: Spécifie le point de terminaison de ressource KMS externe à rétablir.

Azure :

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

Renvoie¶

Renvoie un message de statut indiquant que le point de terminaison, avec son identificateur, est restauré correctement.

En cas d’échec, renvoie une erreur — par exemple, si l’argument fourni n’est pas un point de terminaison existant valide. Si vous ne connaissez pas le nom du point de terminaison, vous pouvez utiliser la fonction système SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO pour répertorier tous les points de terminaison de votre compte Snowflake.

Exigences en matière de contrôle d’accès¶

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:

Restaurez un point de terminaison privé avec un accès externe à une clé AWS :

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

Copy

Azure :

Restaurez un point de terminaison privé pour permettre à Snowflake sur Microsoft Azure de se connecter au coffre-fort de clés Azure dans votre VNet Azure :

SELECT SYSTEM$RESTORE_PRIVATELINK_ENDPOINT_TSS(
  '/subscriptions/12345678-90ab-cdef-1234-567890abcdef/resourceGroups/myvault/providers/Microsoft.KeyVault/vaults/TriSecretVault'
  );

Copy

"Resource Endpoint with id "/subscriptions/12345678-90ab-cdef-1234-567890abcdef/resourceGroups/myvault/privatelink-test/providers/Microsoft.KeyVault/vaults/TriSecretVault/privateEndpoints/" restored successfully.