Categories:: Systemfunktionen (System Control)

SYSTEM$UNREGISTER_PRIVATELINK_ENDPOINT¶

Hebt die Registrierung eines privaten Konnektivitätsendpunkts auf, um Ihre Verbindung zum Snowflake-Dienst zu routen.

Syntax¶

AWS

SYSTEM$UNREGISTER_PRIVATELINK_ENDPOINT(
  '<aws_private_endpoint_vpce_id>',
  '<aws_account_id>',
  '<token>'
  )

Azure

SYSTEM$UNREGISTER_PRIVATELINK_ENDPOINT(
  '<azure_private_endpoint_link_id>',
  '<azure_private_endpoint_resource_id>',
  '<token>'
  )

Argumente¶

AWS

aws_private_endpoint_vpce_id

Gibt den Bezeichner für Ihren Amazon Web Services (AWS) Virtual Private Cloud-Endpunkt (AWS VPCEID) an.

Um den Wert AWS VPCEID zu erhalten, navigieren Sie durch die AWS-Konsole oder verwenden Sie den folgenden Befehl:

aws ec2 describe-vpc-endpoints

aws_account_id

Der 12-stellige Bezeichner, mit dem Ihr Amazon Web Services (AWS)-Konto als Zeichenfolge eindeutig identifiziert wird.

Um den ID-Wert für das AWS-Konto zu erhalten, navigieren Sie durch die AWS-Konsole oder verwenden Sie den folgenden Befehl:

aws sts get-caller-identity

Azure

azure_private_endpoint_link_id

Gibt den Bezeichner für Ihren Microsoft Azure (Azure) Virtual Private Cloud-Endpunkt-Link an (Azure LinkID).

Um den Wert von Azure LinkID zu erhalten:

Führen Sie die Systemfunktion SYSTEM$GET_PRIVATELINK_AUTHORIZED_ENDPOINTS aus.

azure_private_endpoint_resource_id

Der Bezeichner, mit dem Ihr Snowflake-Konto in Microsoft Azure (Azure) als Zeichenfolge eindeutig identifiziert wird.

Um die Azure-Ressourcen-ID für den privaten Endpunkt zu erhalten, verwenden Sie den folgenden Befehl:

az network private-endpoint list --resource-group my_resource_group

token

Gibt ein Zugriffstoken an, um den Besitz des privaten Konnektivitätsendpunkt zu überprüfen.

Um das Token zu erhalten, müssen Sie mindestens über die entsprechende Berechtigung zum Lesen oder Beschreiben auf dem privaten Konnektivitätsendpunkt verfügen. Weitere Informationen dazu finden Sie unter:

Um das Token zu erhalten, verwenden Sie die folgenden Befehle:

Snowflake auf AWS:

aws sts get-federation-token --name snowflake --policy '{ "Version": "2012-10-17", "Statement"
: [ { "Effect": "Allow", "Action": ["ec2:DescribeVpcEndpoints"], "Resource": ["*"] } ] }'

Snowflake auf Azure:

az account get-access-token --subscription <subscription_id>

Weitere Informationen zur Einschränkung des Geltungsbereichs eines Zugriffstokens finden Sie unter:

Für Snowflake auf AWS: Verwalten des Geltungsbereichs von Zugriffstoken auf Amazon Web Services
Für Snowflake auf Azure: Verwalten des Geltungsbereichs von Zugriffstoken auf Microsoft Azure

Rückgabewerte¶

Gibt eine Statusmeldung über die Registrierung des privaten Konnektivitätsendpunktes zurück.

Nutzungshinweise¶

Diese Funktion kann nur von Kontoadministratoren (d. h. Benutzer mit der Rolle ACCOUNTADMIN) ausgeführt werden.

Beispiele¶

Registrierung eines VPC-Endpunkts für Ihr Snowflake-Konto aufheben. Beachten Sie, dass die AccessKeyId, SecretAccessKey- und SessionToken-Werte abgeschnitten sind:

AWS

SELECT SYSTEM$UNREGISTER_PRIVATELINK_ENDPOINT(
  'vpce-0c1...',
  '174...',
  '{
    "Credentials": {
      "AccessKeyId": "ASI...",
      "SecretAccessKey": "aFP...",
      "SessionToken": "Fwo...",
      "Expiration": "2024-04-26 05:49:09+00:00"
    },
    "FederatedUser": {
      "FederatedUserId": "0123...:snowflake",
      "Arn": "arn:aws:sts::174...:federated-user/sam"
    },
    "PackedPolicySize": 9
  }'
);

Azure

SELECT SYSTEM$UNREGISTER_PRIVATELINK_ENDPOINT(
  '123...',
  '/subscriptions/0cc51670-.../resourceGroups/dbsec_test_rg/providers/Microsoft.Network/
  privateEndpoints/...',
  'eyJ...'
  );