Skip to main content

bots

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

Overview

Namebots
TypeResource
Idazure.bot_service.bots

Fields

NameDatatypeDescription
idtextSpecifies the resource ID.
nametextSpecifies the name of the resource.
descriptiontextfield from the properties object
all_settingstextfield from the properties object
app_password_hinttextfield from the properties object
cmek_encryption_statustextfield from the properties object
cmek_key_vault_urltextfield from the properties object
configured_channelstextfield from the properties object
developer_app_insight_keytextfield from the properties object
developer_app_insights_api_keytextfield from the properties object
developer_app_insights_application_idtextfield from the properties object
disable_local_authtextfield from the properties object
display_nametextfield from the properties object
enabled_channelstextfield from the properties object
endpointtextfield from the properties object
endpoint_versiontextfield from the properties object
etagtextEntity Tag.
icon_urltextfield from the properties object
is_cmek_enabledtextfield from the properties object
is_developer_app_insights_api_key_settextfield from the properties object
is_streaming_supportedtextfield from the properties object
kindtextIndicates the type of bot service
locationtextSpecifies the location of the resource.
luis_app_idstextfield from the properties object
luis_keytextfield from the properties object
manifest_urltextfield from the properties object
migration_tokentextfield from the properties object
msa_app_idtextfield from the properties object
msa_app_msi_resource_idtextfield from the properties object
msa_app_tenant_idtextfield from the properties object
msa_app_typetextfield from the properties object
network_security_perimeter_configurationstextfield from the properties object
open_with_hinttextfield from the properties object
parameterstextfield from the properties object
private_endpoint_connectionstextfield from the properties object
provisioning_statetextfield from the properties object
public_network_accesstextfield from the properties object
publishing_credentialstextfield from the properties object
resourceGroupNametextfield from the properties object
resourceNametextfield from the properties object
schema_transformation_versiontextfield from the properties object
skutextThe SKU of the cognitive services account.
storage_resource_idtextfield from the properties object
subscriptionIdtextfield from the properties object
tagstextContains resource tags defined as key/value pairs.
tenant_idtextfield from the properties object
typetextSpecifies the type of the resource.
zonestextEntity zones

Methods

NameAccessible byRequired ParamsDescription
getSELECTresourceGroupName, resourceName, subscriptionIdReturns a BotService specified by the parameters.
listSELECTsubscriptionIdReturns all the resources of a particular type belonging to a subscription.
list_by_resource_groupSELECTresourceGroupName, subscriptionIdReturns all the resources of a particular type belonging to a resource group
createINSERTresourceGroupName, resourceName, subscriptionIdCreates a Bot Service. Bot Service is a resource group wide resource type.
deleteDELETEresourceGroupName, resourceName, subscriptionIdDeletes a Bot Service from the resource group.
updateUPDATEresourceGroupName, resourceName, subscriptionIdUpdates a Bot Service

SELECT examples

Returns all the resources of a particular type belonging to a subscription.

SELECT
id,
name,
description,
all_settings,
app_password_hint,
cmek_encryption_status,
cmek_key_vault_url,
configured_channels,
developer_app_insight_key,
developer_app_insights_api_key,
developer_app_insights_application_id,
disable_local_auth,
display_name,
enabled_channels,
endpoint,
endpoint_version,
etag,
icon_url,
is_cmek_enabled,
is_developer_app_insights_api_key_set,
is_streaming_supported,
kind,
location,
luis_app_ids,
luis_key,
manifest_url,
migration_token,
msa_app_id,
msa_app_msi_resource_id,
msa_app_tenant_id,
msa_app_type,
network_security_perimeter_configurations,
open_with_hint,
parameters,
private_endpoint_connections,
provisioning_state,
public_network_access,
publishing_credentials,
resourceGroupName,
resourceName,
schema_transformation_version,
sku,
storage_resource_id,
subscriptionId,
tags,
tenant_id,
type,
zones
FROM azure.bot_service.vw_bots
WHERE subscriptionId = '{{ subscriptionId }}';

INSERT example

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

/*+ create */
INSERT INTO azure.bot_service.bots (
resourceGroupName,
resourceName,
subscriptionId,
location,
tags,
sku,
kind,
etag,
properties
)
SELECT
'{{ resourceGroupName }}',
'{{ resourceName }}',
'{{ subscriptionId }}',
'{{ location }}',
'{{ tags }}',
'{{ sku }}',
'{{ kind }}',
'{{ etag }}',
'{{ properties }}'
;

UPDATE example

Updates a bots resource.

/*+ update */
UPDATE azure.bot_service.bots
SET
location = '{{ location }}',
tags = '{{ tags }}',
sku = '{{ sku }}',
kind = '{{ kind }}',
etag = '{{ etag }}',
properties = '{{ properties }}'
WHERE
resourceGroupName = '{{ resourceGroupName }}'
AND resourceName = '{{ resourceName }}'
AND subscriptionId = '{{ subscriptionId }}';

DELETE example

Deletes the specified bots resource.

/*+ delete */
DELETE FROM azure.bot_service.bots
WHERE resourceGroupName = '{{ resourceGroupName }}'
AND resourceName = '{{ resourceName }}'
AND subscriptionId = '{{ subscriptionId }}';