Share via

Microsoft.EventGrid partnerNamespaces/channels 2022-06-15

  • Article

Bicep resource definition

The partnerNamespaces/channels resource type can be deployed with operations that target:

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.EventGrid/partnerNamespaces/channels resource, add the following Bicep to your template.

resource symbolicname 'Microsoft.EventGrid/partnerNamespaces/channels@2022-06-15' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    channelType: 'string'
    expirationTimeIfNotActivatedUtc: 'string'
    messageForActivation: 'string'
    partnerTopicInfo: {
      azureSubscriptionId: 'string'
      eventTypeInfo: {
        inlineEventTypes: {
          {customized property}: {
            dataSchemaUrl: 'string'
            description: 'string'
            displayName: 'string'
            documentationUrl: 'string'
          }
        }
        kind: 'string'
      }
      name: 'string'
      resourceGroupName: 'string'
      source: 'string'
    }
    provisioningState: 'string'
    readinessState: 'string'
  }
}

Property Values

ChannelProperties

Name Description Value
channelType The type of the event channel which represents the direction flow of events. 'PartnerTopic'
expirationTimeIfNotActivatedUtc Expiration time of the channel. If this timer expires while the corresponding partner topic is never activated,
the channel and corresponding partner topic are deleted.		 string
messageForActivation Context or helpful message that can be used during the approval process by the subscriber. string
partnerTopicInfo This property should be populated when channelType is PartnerTopic and represents information about the partner topic resource corresponding to the channel. PartnerTopicInfo
provisioningState Provisioning state of the channel. 'Canceled'
'Creating'
'Deleting'
'Failed'
'IdleDueToMirroredPartnerTopicDeletion'
'Succeeded'
'Updating'
readinessState The readiness state of the corresponding partner topic. 'Activated'
'NeverActivated'

EventTypeInfo

Name Description Value
inlineEventTypes A collection of inline event types for the resource. The inline event type keys are of type string which represents the name of the event.
An example of a valid inline event name is "Contoso.OrderCreated".
The inline event type values are of type InlineEventProperties and will contain additional information for every inline event type.		 EventTypeInfoInlineEventTypes
kind The kind of event type used. 'Inline'

EventTypeInfoInlineEventTypes

Name Description Value

InlineEventProperties

Name Description Value
dataSchemaUrl The dataSchemaUrl for the inline event. string
description The description for the inline event. string
displayName The displayName for the inline event. string
documentationUrl The documentationUrl for the inline event. string

Microsoft.EventGrid/partnerNamespaces/channels

Name Description Value
name The resource name string (required)
parent In Bicep, you can specify the parent resource for a child resource. You only need to add this property when the child resource is declared outside of the parent resource.

For more information, see Child resource outside parent resource.		 Symbolic name for resource of type: partnerNamespaces
properties Properties of the Channel. ChannelProperties

PartnerTopicInfo

Name Description Value
azureSubscriptionId Azure subscription ID of the subscriber. The partner topic associated with the channel will be
created under this Azure subscription.		 string
eventTypeInfo Event Type Information for the partner topic. This information is provided by the publisher and can be used by the
subscriber to view different types of events that are published.		 EventTypeInfo
name Name of the partner topic associated with the channel. string
resourceGroupName Azure Resource Group of the subscriber. The partner topic associated with the channel will be
created under this resource group.		 string
source The source information is provided by the publisher to determine the scope or context from which the events
are originating. This information can be used by the subscriber during the approval process of the
created partner topic.		 string

ARM template resource definition

The partnerNamespaces/channels resource type can be deployed with operations that target:

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.EventGrid/partnerNamespaces/channels resource, add the following JSON to your template.

{
  "type": "Microsoft.EventGrid/partnerNamespaces/channels",
  "apiVersion": "2022-06-15",
  "name": "string",
  "properties": {
    "channelType": "string",
    "expirationTimeIfNotActivatedUtc": "string",
    "messageForActivation": "string",
    "partnerTopicInfo": {
      "azureSubscriptionId": "string",
      "eventTypeInfo": {
        "inlineEventTypes": {
          "{customized property}": {
            "dataSchemaUrl": "string",
            "description": "string",
            "displayName": "string",
            "documentationUrl": "string"
          }
        },
        "kind": "string"
      },
      "name": "string",
      "resourceGroupName": "string",
      "source": "string"
    },
    "provisioningState": "string",
    "readinessState": "string"
  }
}

Property Values

ChannelProperties

Name Description Value
channelType The type of the event channel which represents the direction flow of events. 'PartnerTopic'
expirationTimeIfNotActivatedUtc Expiration time of the channel. If this timer expires while the corresponding partner topic is never activated,
the channel and corresponding partner topic are deleted.		 string
messageForActivation Context or helpful message that can be used during the approval process by the subscriber. string
partnerTopicInfo This property should be populated when channelType is PartnerTopic and represents information about the partner topic resource corresponding to the channel. PartnerTopicInfo
provisioningState Provisioning state of the channel. 'Canceled'
'Creating'
'Deleting'
'Failed'
'IdleDueToMirroredPartnerTopicDeletion'
'Succeeded'
'Updating'
readinessState The readiness state of the corresponding partner topic. 'Activated'
'NeverActivated'

EventTypeInfo

Name Description Value
inlineEventTypes A collection of inline event types for the resource. The inline event type keys are of type string which represents the name of the event.
An example of a valid inline event name is "Contoso.OrderCreated".
The inline event type values are of type InlineEventProperties and will contain additional information for every inline event type.		 EventTypeInfoInlineEventTypes
kind The kind of event type used. 'Inline'

EventTypeInfoInlineEventTypes

Name Description Value

InlineEventProperties

Name Description Value
dataSchemaUrl The dataSchemaUrl for the inline event. string
description The description for the inline event. string
displayName The displayName for the inline event. string
documentationUrl The documentationUrl for the inline event. string

Microsoft.EventGrid/partnerNamespaces/channels

Name Description Value
apiVersion The api version '2022-06-15'
name The resource name string (required)
properties Properties of the Channel. ChannelProperties
type The resource type 'Microsoft.EventGrid/partnerNamespaces/channels'

PartnerTopicInfo

Name Description Value
azureSubscriptionId Azure subscription ID of the subscriber. The partner topic associated with the channel will be
created under this Azure subscription.		 string
eventTypeInfo Event Type Information for the partner topic. This information is provided by the publisher and can be used by the
subscriber to view different types of events that are published.		 EventTypeInfo
name Name of the partner topic associated with the channel. string
resourceGroupName Azure Resource Group of the subscriber. The partner topic associated with the channel will be
created under this resource group.		 string
source The source information is provided by the publisher to determine the scope or context from which the events
are originating. This information can be used by the subscriber during the approval process of the
created partner topic.		 string

Usage Examples

Terraform (AzAPI provider) resource definition

The partnerNamespaces/channels resource type can be deployed with operations that target:

  • Resource groups

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.EventGrid/partnerNamespaces/channels resource, add the following Terraform to your template.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.EventGrid/partnerNamespaces/channels@2022-06-15"
  name = "string"
  body = jsonencode({
    properties = {
      channelType = "string"
      expirationTimeIfNotActivatedUtc = "string"
      messageForActivation = "string"
      partnerTopicInfo = {
        azureSubscriptionId = "string"
        eventTypeInfo = {
          inlineEventTypes = {
            {customized property} = {
              dataSchemaUrl = "string"
              description = "string"
              displayName = "string"
              documentationUrl = "string"
            }
          }
          kind = "string"
        }
        name = "string"
        resourceGroupName = "string"
        source = "string"
      }
      provisioningState = "string"
      readinessState = "string"
    }
  })
}

Property Values

ChannelProperties

Name Description Value
channelType The type of the event channel which represents the direction flow of events. 'PartnerTopic'
expirationTimeIfNotActivatedUtc Expiration time of the channel. If this timer expires while the corresponding partner topic is never activated,
the channel and corresponding partner topic are deleted.		 string
messageForActivation Context or helpful message that can be used during the approval process by the subscriber. string
partnerTopicInfo This property should be populated when channelType is PartnerTopic and represents information about the partner topic resource corresponding to the channel. PartnerTopicInfo
provisioningState Provisioning state of the channel. 'Canceled'
'Creating'
'Deleting'
'Failed'
'IdleDueToMirroredPartnerTopicDeletion'
'Succeeded'
'Updating'
readinessState The readiness state of the corresponding partner topic. 'Activated'
'NeverActivated'

EventTypeInfo

Name Description Value
inlineEventTypes A collection of inline event types for the resource. The inline event type keys are of type string which represents the name of the event.
An example of a valid inline event name is "Contoso.OrderCreated".
The inline event type values are of type InlineEventProperties and will contain additional information for every inline event type.		 EventTypeInfoInlineEventTypes
kind The kind of event type used. 'Inline'

EventTypeInfoInlineEventTypes

Name Description Value

InlineEventProperties

Name Description Value
dataSchemaUrl The dataSchemaUrl for the inline event. string
description The description for the inline event. string
displayName The displayName for the inline event. string
documentationUrl The documentationUrl for the inline event. string

Microsoft.EventGrid/partnerNamespaces/channels

Name Description Value
name The resource name string (required)
parent_id The ID of the resource that is the parent for this resource. ID for resource of type: partnerNamespaces
properties Properties of the Channel. ChannelProperties
type The resource type "Microsoft.EventGrid/partnerNamespaces/channels@2022-06-15"

PartnerTopicInfo

Name Description Value
azureSubscriptionId Azure subscription ID of the subscriber. The partner topic associated with the channel will be
created under this Azure subscription.		 string
eventTypeInfo Event Type Information for the partner topic. This information is provided by the publisher and can be used by the
subscriber to view different types of events that are published.		 EventTypeInfo
name Name of the partner topic associated with the channel. string
resourceGroupName Azure Resource Group of the subscriber. The partner topic associated with the channel will be
created under this resource group.		 string
source The source information is provided by the publisher to determine the scope or context from which the events
are originating. This information can be used by the subscriber during the approval process of the
created partner topic.		 string