Skip to main content

sql_resources

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

Overview

Namesql_resources
TypeResource
Idazure.cosmosdb.sql_resources

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringFully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}.
namestringThe name of the resource.
identityobjectIdentity for the resource.
locationstringThe location of the resource group to which the resource belongs.
resourceobject:vartype resource: ~azure.mgmt.cosmosdb.models.SqlStoredProcedureGetPropertiesResource
systemDataobjectAzure Resource Manager metadata containing createdBy and modifiedBy information.
tagsobjectTags are a list of key-value pairs that describe the resource. These tags can be used in viewing and grouping this resource (across resource groups). A maximum of 15 tags can be provided for a resource. Each tag must have a key no greater than 128 characters and value no greater than 256 characters. For example, the default experience for a template type is set with "defaultExperience": "Cassandra". Current "defaultExperience" values also include "Table", "Graph", "DocumentDB", and "MongoDB".
typestringThe type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts".

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_sql_stored_procedureselectresource_group_name, account_name, database_name, container_name, stored_procedure_name, subscription_idGets the SQL storedProcedure under an existing Azure Cosmos DB database account.
get_sql_user_defined_functionselectresource_group_name, account_name, database_name, container_name, user_defined_function_name, subscription_idGets the SQL userDefinedFunction under an existing Azure Cosmos DB database account.
get_sql_triggerselectresource_group_name, account_name, database_name, container_name, trigger_name, subscription_idGets the SQL trigger under an existing Azure Cosmos DB database account.
list_sql_stored_proceduresselectresource_group_name, account_name, database_name, container_name, subscription_idLists the SQL storedProcedure under an existing Azure Cosmos DB database account.
get_client_encryption_keyselectresource_group_name, account_name, database_name, client_encryption_key_name, subscription_idGets the ClientEncryptionKey under an existing Azure Cosmos DB SQL database.
list_client_encryption_keysselectresource_group_name, account_name, database_name, subscription_idLists the ClientEncryptionKeys under an existing Azure Cosmos DB SQL database.
get_sql_role_definitionselectrole_definition_id, resource_group_name, account_name, subscription_idRetrieves the properties of an existing Azure Cosmos DB SQL Role Definition with the given Id.
get_sql_role_assignmentselectrole_assignment_id, resource_group_name, account_name, subscription_idRetrieves the properties of an existing Azure Cosmos DB SQL Role Assignment with the given Id.
list_sql_databasesselectresource_group_name, account_name, subscription_idLists the SQL databases under an existing Azure Cosmos DB database account.
list_sql_containersexecresource_group_name, account_name, database_name, subscription_idLists the SQL container under an existing Azure Cosmos DB database account.
list_sql_user_defined_functionsexecresource_group_name, account_name, database_name, container_name, subscription_idLists the SQL userDefinedFunction under an existing Azure Cosmos DB database account.
list_sql_triggersexecresource_group_name, account_name, database_name, container_name, subscription_idLists the SQL trigger under an existing Azure Cosmos DB database account.
list_sql_role_definitionsexecresource_group_name, account_name, subscription_idRetrieves the list of all Azure Cosmos DB SQL Role Definitions.
list_sql_role_assignmentsexecresource_group_name, account_name, subscription_idRetrieves the list of all Azure Cosmos DB SQL Role Assignments.
get_sql_databaseexecresource_group_name, account_name, database_name, subscription_idGets the SQL database under an existing Azure Cosmos DB database account with the provided name.
create_update_sql_databaseexecresource_group_name, account_name, database_name, subscription_id, propertiesCreate or update an Azure Cosmos DB SQL database.
delete_sql_databaseexecresource_group_name, account_name, database_name, subscription_idDeletes an existing Azure Cosmos DB SQL database.
get_sql_database_throughputexecresource_group_name, account_name, database_name, subscription_idGets the RUs per second of the SQL database under an existing Azure Cosmos DB database account with the provided name.
update_sql_database_throughputexecresource_group_name, account_name, database_name, subscription_id, propertiesUpdate RUs per second of an Azure Cosmos DB SQL database.
get_sql_container_throughputexecresource_group_name, account_name, database_name, container_name, subscription_idGets the RUs per second of the SQL container under an existing Azure Cosmos DB database account.
update_sql_container_throughputexecresource_group_name, account_name, database_name, container_name, subscription_id, propertiesUpdate RUs per second of an Azure Cosmos DB SQL container.
create_update_client_encryption_keyexecresource_group_name, account_name, database_name, client_encryption_key_name, subscription_id, propertiesCreate or update a ClientEncryptionKey. This API is meant to be invoked via tools such as the Azure Powershell (instead of directly).
get_sql_containerexecresource_group_name, account_name, database_name, container_name, subscription_idGets the SQL container under an existing Azure Cosmos DB database account.
create_update_sql_containerexecresource_group_name, account_name, database_name, container_name, subscription_id, propertiesCreate or update an Azure Cosmos DB SQL container.
delete_sql_containerexecresource_group_name, account_name, database_name, container_name, subscription_idDeletes an existing Azure Cosmos DB SQL container.
create_update_sql_stored_procedureexecresource_group_name, account_name, database_name, container_name, stored_procedure_name, subscription_id, propertiesCreate or update an Azure Cosmos DB SQL storedProcedure.
delete_sql_stored_procedureexecresource_group_name, account_name, database_name, container_name, stored_procedure_name, subscription_idDeletes an existing Azure Cosmos DB SQL storedProcedure.
create_update_sql_user_defined_functionexecresource_group_name, account_name, database_name, container_name, user_defined_function_name, subscription_id, propertiesCreate or update an Azure Cosmos DB SQL userDefinedFunction.
delete_sql_user_defined_functionexecresource_group_name, account_name, database_name, container_name, user_defined_function_name, subscription_idDeletes an existing Azure Cosmos DB SQL userDefinedFunction.
create_update_sql_triggerexecresource_group_name, account_name, database_name, container_name, trigger_name, subscription_id, propertiesCreate or update an Azure Cosmos DB SQL trigger.
delete_sql_triggerexecresource_group_name, account_name, database_name, container_name, trigger_name, subscription_idDeletes an existing Azure Cosmos DB SQL trigger.
create_update_sql_role_definitionexecrole_definition_id, resource_group_name, account_name, subscription_idCreates or updates an Azure Cosmos DB SQL Role Definition.
delete_sql_role_definitionexecrole_definition_id, resource_group_name, account_name, subscription_idDeletes an existing Azure Cosmos DB SQL Role Definition.
create_update_sql_role_assignmentexecrole_assignment_id, resource_group_name, account_name, subscription_idCreates or updates an Azure Cosmos DB SQL Role Assignment.
delete_sql_role_assignmentexecrole_assignment_id, resource_group_name, account_name, subscription_idDeletes an existing Azure Cosmos DB SQL Role Assignment.
migrate_sql_database_to_autoscaleexecresource_group_name, account_name, database_name, subscription_idMigrate an Azure Cosmos DB SQL database from manual throughput to autoscale.
migrate_sql_database_to_manual_throughputexecresource_group_name, account_name, database_name, subscription_idMigrate an Azure Cosmos DB SQL database from autoscale to manual throughput.
migrate_sql_container_to_autoscaleexecresource_group_name, account_name, database_name, container_name, subscription_idMigrate an Azure Cosmos DB SQL container from manual throughput to autoscale.
migrate_sql_container_to_manual_throughputexecresource_group_name, account_name, database_name, container_name, subscription_idMigrate an Azure Cosmos DB SQL container from autoscale to manual throughput.
retrieve_continuous_backup_informationexecresource_group_name, account_name, database_name, container_name, subscription_idRetrieves continuous backup information for a container resource.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
account_namestringCosmos DB database account name. Required.
client_encryption_key_namestringCosmos DB ClientEncryptionKey name. Required.
container_namestringCosmos DB container name. Required.
database_namestringCosmos DB database name. Required.
resource_group_namestringThe name of the resource group. The name is case insensitive. Required.
role_assignment_idstringThe GUID for the Role Assignment. Required.
role_definition_idstringThe GUID for the Role Definition. Required.
stored_procedure_namestringCosmos DB storedProcedure name. Required.
subscription_idstring
trigger_namestringCosmos DB trigger name. Required.
user_defined_function_namestringCosmos DB userDefinedFunction name. Required.

SELECT examples

Gets the SQL storedProcedure under an existing Azure Cosmos DB database account.

SELECT
id,
name,
identity,
location,
resource,
systemData,
tags,
type
FROM azure.cosmosdb.sql_resources
WHERE resource_group_name = '{{ resource_group_name }}' -- required
AND account_name = '{{ account_name }}' -- required
AND database_name = '{{ database_name }}' -- required
AND container_name = '{{ container_name }}' -- required
AND stored_procedure_name = '{{ stored_procedure_name }}' -- required
AND subscription_id = '{{ subscription_id }}' -- required
;

Lifecycle Methods

Lists the SQL container under an existing Azure Cosmos DB database account.

EXEC azure.cosmosdb.sql_resources.list_sql_containers 
@resource_group_name='{{ resource_group_name }}' --required,
@account_name='{{ account_name }}' --required,
@database_name='{{ database_name }}' --required,
@subscription_id='{{ subscription_id }}' --required
;