Lists the endpoints in a Snowpark Container Services service (or a job service). Use the command to list endpoints in a service or service running as a job.
CREATE SERVICE , ALTER SERVICE, DROP SERVICE , SHOW SERVICES
SHOW ENDPOINTS IN SERVICE <name>
Copy
Parameters¶name
Specifies the identifier for the service whose endpoints to list.
If the identifier contains spaces or special characters, the entire string must be enclosed in double quotes. Identifiers enclosed in double quotes are also case-sensitive.
For more information, see Identifier requirements.
The command output provides service properties and metadata in the following columns:
Column
Description
name
User-friendly endpoint name that represents the corresponding port.
port
The network port the service is listening on. NULL, when portRange is specified.
port_range
The network port range the service is listening on. NULL, when port is specified.
protocol
Supported network protocol (TCP, HTTP, or HTTPS). The default is HTTP. Public endpoints and service functions (see Using a service) require HTTP or HTTPS.
is_public
True, if the endpoint is public, accessible from internet.
ingress_url
Endpoint URL accessible from the internet.
privatelink_ingress_url
Endpoint URL accessible via Private Connectivity. The column is returned only for Business Critical accounts.
Access control requirements¶A role used to execute this operation must have the following privileges at a minimum:
Privilege
Object
Notes
USAGE
Service
The USAGE privilege on the parent database and schema are required to perform operations on any object in a schema.
For instructions on creating a custom role with a specified set of privileges, see Creating custom roles.
For general information about roles and privilege grants for performing SQL actions on securable objects, see Overview of Access Control.
Usage notes¶The command doesn’t require a running warehouse to execute.
The command only returns objects for which the current user’s current role has been granted at least one access privilege.
The MANAGE GRANTS access privilege implicitly allows its holder to see every object in the account. By default, only the account administrator (users with the ACCOUNTADMIN role) and security administrator (users with the SECURITYADMIN role) have the MANAGE GRANTS privilege.
To post-process the output of this command, you can use the pipe operator (->>) or the RESULT_SCAN function. Both constructs treat the output as a result set that you can query.
The output column names for this command are generated in lowercase. If you consume a result set from this command with the pipe operator or the RESULT_SCAN function, use double-quoted identifiers for the column names in the query to ensure that they match the column names in the output that was scanned. For example, if the name of an output column is type, then specify "type" for the identifier.
The following example lists endpoints exposed by echo_service service:
SHOW ENDPOINTS IN SERVICE echo_service;
Copy
+--------------+------+------------+----------+-----------+------------------------------------------------------------------------------+-----------------------------------------------+ | name | port | port_range | protocol | is_public | ingress_url | privatelink_ingress_url | |--------------+------+------------+----------+-----------+------------------------------------------------------------------------------|-----------------------------------------------* | echoendpoint | 8080 | | HTTP | true | d7qoajz-orgname-acctname.pp-snowflakecomputing.app | d7qoajz.spcs.pdxaac.privatelink.snowflake.app | +--------------+------+------------+----------+-----------+------------------------------------------------------------------------------+-----------------------------------------------*
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4