Skip to main content

managed_accounts

Creates, updates, deletes, gets or lists a managed_accounts resource.

Overview

Namemanaged_accounts
TypeResource
Idsnowflake.managed_account.managed_accounts

Fields

NameDatatypeDescription
namestringA Snowflake object identifier. 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.
account_locator_urlstringAccount URL that is used to connect to the account, in the legacy account locator format.
account_typestringType of the account.
admin_namestringName of the account administrator.
admin_passwordstringPassword for the account administrator.
cloudstringCloud in which the managed account is located. For reader accounts, this is always the same as the cloud for the provider account.
commentstringOptional comment in which to store information related to the account.
created_onstringDate and time the account was created.
locatorstringLegacy identifier for the account.
regionstringRegion in which the managed account is located. For reader accounts, this is always the same as the region for the provider account.
urlstringAccount URL that is used to connect to the account, in the account name format. The account identifier in this format follows the pattern {orgname}-{account_name}.

Methods

NameAccessible byRequired ParamsOptional ParamsDescription
list_managed_accountsSELECTendpointlikeLists the accessible managed accounts.
create_managed_accountINSERTdata__account_type, data__admin_name, data__admin_password, data__name, endpoint-Creates a managed account. You must provide the full managed account definition when creating a managed account.
delete_managed_accountDELETEname, endpoint-Removes a managed account, including all objects created in the account, and immediately restricts access to the account. Currently used by data providers to create reader accounts for their consumers. For more details, see Manage reader accounts.

Optional Parameter Details
NameDescriptionTypeDefault
likeQuery parameter to filter the command output by resource name. Uses case-insensitive pattern matching, with support for SQL wildcard characters.string-

SELECT examples

Lists the accessible managed accounts.

SELECT
name,
account_locator_url,
account_type,
admin_name,
admin_password,
cloud,
comment,
created_on,
locator,
region,
url
FROM snowflake.managed_account.managed_accounts
WHERE endpoint = '{{ endpoint }}';

INSERT example

Use the following StackQL query and manifest file to create a new managed_accounts resource.

/*+ create */
INSERT INTO snowflake.managed_account.managed_accounts (
data__name,
data__comment,
data__admin_name,
data__admin_password,
data__account_type,
endpoint
)
SELECT
'{{ name }}',
'{{ comment }}',
'{{ admin_name }}',
'{{ admin_password }}',
'{{ account_type }}',
'{{ endpoint }}'
;

DELETE example

Deletes the specified managed_accounts resource.

/*+ delete */
DELETE FROM snowflake.managed_account.managed_accounts
WHERE name = '{{ name }}'
AND endpoint = '{{ endpoint }}';