bots

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

Overview

Name	bots
Type	Resource
Id	azure.bot_service.bots

Fields

The following fields are returned by SELECT queries:

get

The resource provider should return 200 (OK) to indicate that the operation completed successfully.

Name	Datatype	Description
id	string	Specifies the resource ID.
name	string	Specifies the name of the resource.
etag	string	Entity Tag.
kind	string	Required. Gets or sets the Kind of the resource.
location	string	Specifies the location of the resource.
properties	object	The set of properties specific to bot resource
sku	object	The SKU of the cognitive services account.
tags	object	Contains resource tags defined as key/value pairs.
type	string	Specifies the type of the resource.
zones	array	Entity zones

list_by_resource_group

The resource provider should return 200 (OK) to indicate that the operation completed successfully. For other errors (e.g. internal errors) use the appropriate HTTP error code.
The nextLink field is expected to point to the URL the client should use to fetch the next page (per server side paging). This matches the OData guidelines for paged responses here. If a resource provider does not support paging, it should return the same body (JSON object with “value” property) but omit nextLink entirely (or set to null, not empty string) for future compatibility.
The nextLink should be implemented using following query parameters:
· skipToken: opaque token that allows the resource provider to skip resources already enumerated. This value is defined and returned by the RP after first request via nextLink.
· top: the optional client query parameter which defines the maximum number of records to be returned by the server.
Implementation details:
· NextLink may include all the query parameters (specifically OData $filter) used by the client in the first query.
· Server may return less records than requested with nextLink. Returning zero records with NextLink is an acceptable response.
Clients must fetch records until the nextLink is not returned back / null. Clients should never rely on number of returned records to determinate if pagination is completed.

Name	Datatype	Description
id	string	Specifies the resource ID.
name	string	Specifies the name of the resource.
etag	string	Entity Tag.
kind	string	Required. Gets or sets the Kind of the resource.
location	string	Specifies the location of the resource.
properties	object	The set of properties specific to bot resource
sku	object	The SKU of the cognitive services account.
tags	object	Contains resource tags defined as key/value pairs.
type	string	Specifies the type of the resource.
zones	array	Entity zones

list

The resource provider should return 200 (OK) to indicate that the operation completed successfully. For other errors (e.g. internal errors) use the appropriate HTTP error code.
The nextLink field is expected to point to the URL the client should use to fetch the next page (per server side paging). This matches the OData guidelines for paged responses. If a resource provider does not support paging, it should return the same body but leave nextLink empty for future compatibility.
For a detailed explanation of each field in the response body, please refer to the request body description in the PUT resource section.

Name	Datatype	Description
id	string	Specifies the resource ID.
name	string	Specifies the name of the resource.
etag	string	Entity Tag.
kind	string	Required. Gets or sets the Kind of the resource.
location	string	Specifies the location of the resource.
properties	object	The set of properties specific to bot resource
sku	object	The SKU of the cognitive services account.
tags	object	Contains resource tags defined as key/value pairs.
type	string	Specifies the type of the resource.
zones	array	Entity zones

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	resourceGroupName, resourceName, subscriptionId		Returns a BotService specified by the parameters.
list_by_resource_group	select	resourceGroupName, subscriptionId		Returns all the resources of a particular type belonging to a resource group
list	select	subscriptionId		Returns all the resources of a particular type belonging to a subscription.
create	insert	resourceGroupName, resourceName, subscriptionId		Creates a Bot Service. Bot Service is a resource group wide resource type.
update	update	resourceGroupName, resourceName, subscriptionId		Updates a Bot Service
delete	delete	resourceGroupName, resourceName, subscriptionId		Deletes a Bot Service from the resource group.

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.

Name	Datatype	Description
resourceGroupName	string	The name of the Bot resource group in the user subscription.
resourceName	string	The name of the Bot resource.
subscriptionId	string	Azure Subscription ID.

SELECT examples

get

Returns a BotService specified by the parameters.

SELECT
id,
name,
etag,
kind,
location,
properties,
sku,
tags,
type,
zones
FROM azure.bot_service.bots
WHERE resourceGroupName = '{{ resourceGroupName }}' -- required
AND resourceName = '{{ resourceName }}' -- required
AND subscriptionId = '{{ subscriptionId }}' -- required
;

list_by_resource_group

Returns all the resources of a particular type belonging to a resource group

SELECT
id,
name,
etag,
kind,
location,
properties,
sku,
tags,
type,
zones
FROM azure.bot_service.bots
WHERE resourceGroupName = '{{ resourceGroupName }}' -- required
AND subscriptionId = '{{ subscriptionId }}' -- required
;

list

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

SELECT
id,
name,
etag,
kind,
location,
properties,
sku,
tags,
type,
zones
FROM azure.bot_service.bots
WHERE subscriptionId = '{{ subscriptionId }}' -- required
;

INSERT examples

create

Creates a Bot Service. Bot Service is a resource group wide resource type.

INSERT INTO azure.bot_service.bots (
data__location,
data__tags,
data__sku,
data__kind,
data__etag,
data__properties,
resourceGroupName,
resourceName,
subscriptionId
)
SELECT 
'{{ location }}',
'{{ tags }}',
'{{ sku }}',
'{{ kind }}',
'{{ etag }}',
'{{ properties }}',
'{{ resourceGroupName }}',
'{{ resourceName }}',
'{{ subscriptionId }}'
RETURNING
id,
name,
etag,
kind,
location,
properties,
sku,
tags,
type,
zones
;

Manifest

# Description fields are for documentation purposes
- name: bots
  props:
    - name: resourceGroupName
      value: string
      description: Required parameter for the bots resource.
    - name: resourceName
      value: string
      description: Required parameter for the bots resource.
    - name: subscriptionId
      value: string
      description: Required parameter for the bots resource.
    - name: location
      value: string
      description: |
        Specifies the location of the resource.
    - name: tags
      value: object
      description: |
        Contains resource tags defined as key/value pairs.
    - name: sku
      value: object
      description: |
        The SKU of the cognitive services account.
    - name: kind
      value: string
      description: |
        Required. Gets or sets the Kind of the resource.
      valid_values: ['sdk', 'designer', 'bot', 'function', 'azurebot']
    - name: etag
      value: string
      description: |
        Entity Tag.
    - name: properties
      value: object
      description: |
        The set of properties specific to bot resource

UPDATE examples

update

Updates a Bot Service

UPDATE azure.bot_service.bots
SET 
data__location = '{{ location }}',
data__tags = '{{ tags }}',
data__sku = '{{ sku }}',
data__kind = '{{ kind }}',
data__etag = '{{ etag }}',
data__properties = '{{ properties }}'
WHERE 
resourceGroupName = '{{ resourceGroupName }}' --required
AND resourceName = '{{ resourceName }}' --required
AND subscriptionId = '{{ subscriptionId }}' --required
RETURNING
id,
name,
etag,
kind,
location,
properties,
sku,
tags,
type,
zones;

DELETE examples

delete

Deletes a Bot Service from the resource group.

DELETE FROM azure.bot_service.bots
WHERE resourceGroupName = '{{ resourceGroupName }}' --required
AND resourceName = '{{ resourceName }}' --required
AND subscriptionId = '{{ subscriptionId }}' --required
;