Microsoft Azure Topics API

openapi: 3.2.0
info:
  version: 2020-08-01-preview
  title: Microsoft Azure AccessControlClient AccessConnector Topics API
tags:
- name: Topics
paths:
  /topics/{topicName}:publish:
    post:
      operationId: microsoftAzurePublishcloudevent
      description: 'Publish Single Cloud Event to namespace topic. In case of success, the server responds with an HTTP 200 status code with an empty JSON object in response. Otherwise, the server can return various error codes. For example, 401: which indicates authorization failure, 403: which indicates quota exceeded or message is too large, 410: which indicates that specific topic is not found, 400: for bad request, and 500: for internal server error. '
      parameters:
      - $ref: '#/components/parameters/Azure.Core.Foundations.ApiVersionParameter'
      - name: topicName
        in: path
        description: Topic Name.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublishResult'
        default:
          description: An unexpected error response.
          headers:
            x-ms-error-code:
              description: String error code indicating what went wrong.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Azure.Core.Foundations.ErrorResponse'
      summary: Microsoft Azure Post Topics Topicname:publish
      tags:
      - Topics
      requestBody:
        content:
          application/cloudevents+json; charset=utf-8:
            schema:
              $ref: '#/components/schemas/CloudEvent'
        description: Single Cloud Event being published.
        required: true
  /topics/{topicName}/eventsubscriptions/{eventSubscriptionName}:receive:
    post:
      operationId: microsoftAzureReceivecloudevents
      description: Receive Batch of Cloud Events from the Event Subscription.
      parameters:
      - $ref: '#/components/parameters/Azure.Core.Foundations.ApiVersionParameter'
      - name: topicName
        in: path
        description: Topic Name.
        required: true
        schema:
          type: string
      - name: eventSubscriptionName
        in: path
        description: Event Subscription Name.
        required: true
        schema:
          type: string
      - name: maxEvents
        in: query
        description: Max Events count to be received. Minimum value is 1, while maximum value is 100 events. If not specified, the default value is 1.
        required: false
        schema:
          type: integer
          format: int32
          default: 1
          maximum: 100
          minimum: 1
      - name: maxWaitTime
        in: query
        description: Max wait time value for receive operation in Seconds. It is the time in seconds that the server approximately waits for the availability of an event and responds to the request. If an event is available, the broker responds immediately to the client. Minimum value is 10 seconds, while maximum value is 120 seconds. If not specified, the default value is 60 seconds.
        required: false
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReceiveResult'
        default:
          description: An unexpected error response.
          headers:
            x-ms-error-code:
              description: String error code indicating what went wrong.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Azure.Core.Foundations.ErrorResponse'
      x-ms-examples:
        Receive Cloud Event:
          $ref: ./examples/receive.json
      summary: Microsoft Azure Post Topics Topicname Eventsubscriptions Eventsubscriptionname:receive
      tags:
      - Topics
  /topics/{topicName}/eventsubscriptions/{eventSubscriptionName}:acknowledge:
    post:
      operationId: microsoftAzureAcknowledgecloudevents
      description: Acknowledge batch of Cloud Events. The server responds with an HTTP 200 status code if the request is successfully accepted. The response body will include the set of successfully acknowledged lockTokens, along with other failed lockTokens with their corresponding error information. Successfully acknowledged events will no longer be available to any consumer.
      parameters:
      - $ref: '#/components/parameters/Azure.Core.Foundations.ApiVersionParameter'
      - name: topicName
        in: path
        description: Topic Name.
        required: true
        schema:
          type: string
      - name: eventSubscriptionName
        in: path
        description: Event Subscription Name.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AcknowledgeResult'
        default:
          description: An unexpected error response.
          headers:
            x-ms-error-code:
              description: String error code indicating what went wrong.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Azure.Core.Foundations.ErrorResponse'
      x-ms-examples:
        Acknowledge Cloud Event:
          $ref: ./examples/ack.json
      summary: Microsoft Azure Post Topics Topicname Eventsubscriptions Eventsubscriptionname:acknowledge
      tags:
      - Topics
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AcknowledgeOptions'
        description: AcknowledgeOptions.
        required: true
  /topics/{topicName}/eventsubscriptions/{eventSubscriptionName}:release:
    post:
      operationId: microsoftAzureReleasecloudevents
      description: Release batch of Cloud Events. The server responds with an HTTP 200 status code if the request is successfully accepted. The response body will include the set of successfully released lockTokens, along with other failed lockTokens with their corresponding error information.
      parameters:
      - $ref: '#/components/parameters/Azure.Core.Foundations.ApiVersionParameter'
      - name: topicName
        in: path
        description: Topic Name.
        required: true
        schema:
          type: string
      - name: eventSubscriptionName
        in: path
        description: Event Subscription Name.
        required: true
        schema:
          type: string
      - name: releaseDelayInSeconds
        in: query
        description: Release cloud events with the specified delay in seconds.
        required: false
        x-ms-enum:
          name: ReleaseDelay
          modelAsString: true
          values:
          - name: By0Seconds
            value: 0
            description: Release the event after 0 seconds.
          - name: By10Seconds
            value: 10
            description: Release the event after 10 seconds.
          - name: By60Seconds
            value: 60
            description: Release the event after 60 seconds.
          - name: By600Seconds
            value: 600
            description: Release the event after 600 seconds.
          - name: By3600Seconds
            value: 3600
            description: Release the event after 3600 seconds.
        schema:
          type: number
          enum:
          - 0
          - 10
          - 60
          - 600
          - 3600
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReleaseResult'
        default:
          description: An unexpected error response.
          headers:
            x-ms-error-code:
              description: String error code indicating what went wrong.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Azure.Core.Foundations.ErrorResponse'
      x-ms-examples:
        Release Cloud Event with an optional delay.:
          $ref: ./examples/release.json
      summary: Microsoft Azure Post Topics Topicname Eventsubscriptions Eventsubscriptionname:release
      tags:
      - Topics
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReleaseOptions'
        description: ReleaseOptions
        required: true
  /topics/{topicName}/eventsubscriptions/{eventSubscriptionName}:reject:
    post:
      operationId: microsoftAzureRejectcloudevents
      description: Reject batch of Cloud Events. The server responds with an HTTP 200 status code if the request is successfully accepted. The response body will include the set of successfully rejected lockTokens, along with other failed lockTokens with their corresponding error information.
      parameters:
      - $ref: '#/components/parameters/Azure.Core.Foundations.ApiVersionParameter'
      - name: topicName
        in: path
        description: Topic Name.
        required: true
        schema:
          type: string
      - name: eventSubscriptionName
        in: path
        description: Event Subscription Name.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RejectResult'
        default:
          description: An unexpected error response.
          headers:
            x-ms-error-code:
              description: String error code indicating what went wrong.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Azure.Core.Foundations.ErrorResponse'
      x-ms-examples:
        Reject Cloud Event:
          $ref: ./examples/reject.json
      summary: Microsoft Azure Post Topics Topicname Eventsubscriptions Eventsubscriptionname:reject
      tags:
      - Topics
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RejectOptions'
        description: RejectOptions
        required: true
  /topics/{topicName}/eventsubscriptions/{eventSubscriptionName}:renewLock:
    post:
      operationId: microsoftAzureRenewcloudeventlocks
      description: Renew lock for batch of Cloud Events. The server responds with an HTTP 200 status code if the request is successfully accepted. The response body will include the set of successfully renewed lockTokens, along with other failed lockTokens with their corresponding error information.
      parameters:
      - $ref: '#/components/parameters/Azure.Core.Foundations.ApiVersionParameter'
      - name: topicName
        in: path
        description: Topic Name.
        required: true
        schema:
          type: string
      - name: eventSubscriptionName
        in: path
        description: Event Subscription Name.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RenewCloudEventLocksResult'
        default:
          description: An unexpected error response.
          headers:
            x-ms-error-code:
              description: String error code indicating what went wrong.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Azure.Core.Foundations.ErrorResponse'
      x-ms-examples:
        Renew lock for batch of Cloud Events:
          $ref: ./examples/renewlock.json
      summary: Microsoft Azure Post Topics Topicname Eventsubscriptions Eventsubscriptionname:renewlock
      tags:
      - Topics
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RenewLockOptions'
        description: RenewLockOptions
        required: true
  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topics/{topicName}:
    get:
      tags:
      - Topics
      summary: Microsoft Azure Get A Topic
      description: Get properties of a topic.
      operationId: microsoftAzureTopicsGet
      parameters:
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - name: resourceGroupName
        in: path
        description: The name of the resource group within the user's subscription.
        required: true
        schema:
          type: string
      - name: topicName
        in: path
        description: Name of the topic.
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/ApiVersionParameter'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Topic'
        default:
          description: "*** Error Responses: ***\n\n * 400 Bad Request.\n\n * 500 Internal Server Error."
      x-ms-examples:
        Topics_Get:
          $ref: ./examples/Topics_Get.json
    put:
      tags:
      - Topics
      summary: Microsoft Azure Create A Topic
      description: Asynchronously creates a new topic with the specified parameters.
      operationId: microsoftAzureTopicsCreateorupdate
      parameters:
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - name: resourceGroupName
        in: path
        description: The name of the resource group within the user's subscription.
        required: true
        schema:
          type: string
      - name: topicName
        in: path
        description: Name of the topic.
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/ApiVersionParameter'
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Topic'
        default:
          description: "*** Error Responses: ***\n\n * 400 Bad Request.\n\n * 500 Internal Server Error."
      x-ms-examples:
        Topics_CreateOrUpdate:
          $ref: ./examples/Topics_CreateOrUpdate.json
        Topics_CreateOrUpdateForAzureArc:
          $ref: ./examples/Topics_CreateOrUpdateForAzureArc.json
      x-ms-long-running-operation: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Topic'
        description: Topic information.
        required: true
    delete:
      tags:
      - Topics
      summary: Microsoft Azure Delete A Topic
      description: Delete existing topic.
      operationId: microsoftAzureTopicsDelete
      parameters:
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - name: resourceGroupName
        in: path
        description: The name of the resource group within the user's subscription.
        required: true
        schema:
          type: string
      - name: topicName
        in: path
        description: Name of the topic.
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/ApiVersionParameter'
      responses:
        '202':
          description: Accepted
        '204':
          description: NoContent
        default:
          description: "*** Error Responses: ***\n\n * 400 Bad Request.\n\n * 404 Not Found.\n\n * 500 Internal Server Error."
      x-ms-examples:
        Topics_Delete:
          $ref: ./examples/Topics_Delete.json
      x-ms-long-running-operation: true
    patch:
      tags:
      - Topics
      summary: Microsoft Azure Update A Topic
      description: Asynchronously updates a topic with the specified parameters.
      operationId: microsoftAzureTopicsUpdate
      parameters:
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - name: resourceGroupName
        in: path
        description: The name of the resource group within the user's subscription.
        required: true
        schema:
          type: string
      - name: topicName
        in: path
        description: Name of the topic.
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/ApiVersionParameter'
      responses:
        '200':
          description: OK
        '201':
          description: Topic update request accepted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Topic'
        default:
          description: "*** Error Responses: ***\n\n * 400 Bad Request.\n\n * 500 Internal Server Error."
      x-ms-examples:
        Topics_Update:
          $ref: ./examples/Topics_Update.json
      x-ms-long-running-operation: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TopicUpdateParameters'
        description: Topic update information.
        required: true
  /subscriptions/{subscriptionId}/providers/Microsoft.EventGrid/topics:
    get:
      tags:
      - Topics
      summary: Microsoft Azure List Topics Under An Azure Subscription
      description: List all the topics under an Azure subscription.
      operationId: microsoftAzureTopicsListbysubscription
      parameters:
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/FilterParameter'
      - $ref: '#/components/parameters/TopParameter'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TopicsListResult'
        default:
          description: "*** Error Responses: ***\n\n * 400 Bad Request.\n\n * 500 Internal Server Error."
      x-ms-examples:
        Topics_ListBySubscription:
          $ref: ./examples/Topics_ListBySubscription.json
      x-ms-pageable:
        nextLinkName: nextLink
  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topics:
    get:
      tags:
      - Topics
      summary: Microsoft Azure List Topics Under A Resource Group
      description: List all the topics under a resource group.
      operationId: microsoftAzureTopicsListbyresourcegroup
      parameters:
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - name: resourceGroupName
        in: path
        description: The name of the resource group within the user's subscription.
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/FilterParameter'
      - $ref: '#/components/parameters/TopParameter'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TopicsListResult'
        default:
          description: "*** Error Responses: ***\n\n * 400 Bad Request.\n\n * 500 Internal Server Error."
      x-ms-examples:
        Topics_ListByResourceGroup:
          $ref: ./examples/Topics_ListByResourceGroup.json
      x-ms-pageable:
        nextLinkName: nextLink
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topics/{topicName}/listKeys
  : post:
      tags:
      - Topics
      summary: Microsoft Azure List Keys For A Topic
      description: List the two keys used to publish to a topic.
      operationId: microsoftAzureTopicsListsharedaccesskeys
      parameters:
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - name: resourceGroupName
        in: path
        description: The name of the resource group within the user's subscription.
        required: true
        schema:
          type: string
      - name: topicName
        in: path
        description: Name of the topic.
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/ApiVersionParameter'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TopicSharedAccessKeys'
        default:
          description: "*** Error Responses: ***\n\n * 400 Bad Request.\n\n * 500 Internal Server Error."
      x-ms-examples:
        Topics_ListSharedAccessKeys:
          $ref: ./examples/Topics_ListSharedAccessKeys.json
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topics/{topicName}/regenerateKey
  : post:
      tags:
      - Topics
      summary: Microsoft Azure Regenerate Key For A Topic
      description: Regenerate a shared access key for a topic.
      operationId: microsoftAzureTopicsRegeneratekey
      parameters:
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - name: resourceGroupName
        in: path
        description: The name of the resource group within the user's subscription.
        required: true
        schema:
          type: string
      - name: topicName
        in: path
        description: Name of the topic.
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/ApiVersionParameter'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TopicSharedAccessKeys'
        '202':
          description: Accepted
        default:
          description: "*** Error Responses: ***\n\n * 400 Bad Request.\n\n * 500 Internal Server Error."
      x-ms-examples:
        Topics_RegenerateKey:
          $ref: ./examples/Topics_RegenerateKey.json
      x-ms-long-running-operation: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TopicRegenerateKeyRequest'
        description: Request body to regenerate key.
        required: true
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{providerNamespace}/{resourceTypeName}/{resourceName}/providers/Microsoft.EventGrid/eventTypes
  : get:
      tags:
      - Topics
      summary: Microsoft Azure List Topic Event Types
      description: List event types for a topic.
      operationId: microsoftAzureTopicsListeventtypes
      parameters:
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - name: resourceGroupName
        in: path
        description: The name of the resource group within the user's subscription.
        required: true
        schema:
          type: string
      - name: providerNamespace
        in: path
        description: Namespace of the provider of the topic.
        required: true
        schema:
          type: string
      - name: resourceTypeName
        in: path
        description: Name of the topic type.
        required: true
        schema:
          type: string
      - name: resourceName
        in: path
        description: Name of the topic.
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/ApiVersionParameter'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EventTypesListResult'
        default:
          description: "*** Error Responses: ***\n\n * 400 Bad Request.\n\n * 500 Internal Server Error."
      x-ms-examples:
        Topics_ListEventTypes:
          $ref: ./examples/Topics_ListEventTypes.json
      x-ms-pageable:
        nextLinkName: null
  /{scope}/providers/Microsoft.EventGrid/extensionTopics/default:
    get:
      tags:
      - Topics
      summary: Microsoft Azure Get Properties Of An Extension Topic
      description: Get the properties of an extension topic.
      operationId: microsoftAzureExtensiontopicsGet
      parameters:
      - name: scope
        in: path
        description: The identifier of the resource to which extension topic is queried. The scope can be a subscription, or a resource group, or a top level resource belonging to a resource provider namespace. For example, use '/subscriptions/{subscriptionId}/' for a subscription, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for a resource group, and '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}' for Azure resource.
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/ApiVersionParameter'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExtensionTopic'
        default:
          description: "*** Error Responses: ***\n\n * 400 Bad Request.\n\n * 500 Internal Server Error."
      x-ms-examples:
        ExtensionTopics_Get:
          $ref: ./examples/ExtensionTopics_Get.json
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/topics
  : get:
      tags:
      - Topics
      operationId: microsoftAzureTopicsListbynamespace
      x-ms-examples:
        TopicGet:
          $ref: ./examples/Topics/SBTopicListByNameSpace.json
      description: Gets all the topics in a namespace.
      externalDocs:
        url: https://msdn.microsoft.com/en-us/library/azure/mt639388.aspx
      parameters:
      - $ref: ../../../common/v1/definitions.json#/parameters/ResourceGroupNameParameter
      - $ref: ../../../common/v1/definitions.json#/parameters/NamespaceNameParameter
      - $ref: ../../../common/v1/definitions.json#/parameters/ApiVersionParameter
      - $ref: ../../../common/v1/definitions.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../common/v1/definitions.json#/parameters/SkipParameter
      - $ref: ../../../common/v1/definitions.json#/parameters/TopParameter
      responses:
        '200':
          description: Successfully retrieved list of topics.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SBTopicListResult'
        default:
          description: ServiceBus error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: ../../../common/v1/definitions.json#/definitions/ErrorResponse
      x-ms-pageable:
        nextLinkName: nextLink
      summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Servicebus Namespaces Namespacename Topics
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/topics/{topicName}
  : put:
      tags:
      - Topics
      operationId: microsoftAzureTopicsCreateorupdate
      x-ms-examples:
        TopicCreate:
          $ref: ./examples/Topics/SBTopicCreate.json
      description: Creates a topic in the specified namespace.
      externalDocs:
        url: https://msdn.microsoft.com/en-us/library/azure/mt639409.aspx
      parameters:
      - $ref: ../../../common/v1/definitions.json#/parameters/ResourceGroupNameParameter
      - $ref: ../../../common/v1/definitions.json#/parameters/NamespaceNameParameter
      - $ref: ../../../common/v1/definitions.json#/parameters/TopicNameParameter
      - $ref: ../../../common/v1/definitions.json#/parameters/ApiVersionParameter
      - $ref: ../../../common/v1/definitions.json#/parameters/SubscriptionIdParameter
      responses:
        '200':
          description: Topic successfully created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SBTopic'
        default:
          description: ServiceBus error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: ../../../common/v1/definitions.json#/definitions/ErrorResponse
      summary: Microsoft Azure Put Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Servicebus Namespaces Namespacename Topics Topicname
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SBTopic'
        description: Parameters supplied to create a topic resource.
        required: true
    delete:
      tags:
      - Topics
      operationId: microsoftAzureTopicsDelete
      x-ms-examples:
        TopicDelete:
          $ref: ./examples/Topics/SBTopicDelete.json
      description: Deletes a topic from the specified namespace and resource group.
      externalDocs:
        url: https://msdn.microsoft.com/en-us/library/azure/mt639404.aspx
      parameters:
      - $ref: ../../../common/v1/definitions.json#/parameters/ResourceGroupNameParameter
      - $ref: ../../../common/v1/definitions.json#/parameters/NamespaceNameParameter
      - $ref: ../../../common/v1/definitions.json#/parameters/TopicNameParameter
      - $ref: ../../../common/v1/definitions.json#/parameters/ApiVersionParameter
      - $ref: ../../../common/v1/definitions.json#/parameters/SubscriptionIdParameter
      responses:
        '200':
          description: Topic successfully deleted.
        '204':
          description: No Content
        default:
          description: ServiceBus error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: ../../../common/v1/definitions.json#/definitions/ErrorResponse
      summary: Microsoft Azure Delete Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Servicebus Namespaces Namespacename Topics Topicname
    get:
      tags:
      - Topics
      operationId: microsoftAzureTopicsGet
      x-ms-examples:
        TopicGet:
          $ref: ./examples/Topics/SBTopicGet.json
      description: Returns a description for the specified topic.
      externalDocs:
        url: https://msdn.microsoft.com/en-us/library/azure/mt639399.aspx
      parameters:
      - $ref: ../../../common/v1/definitions.json#/parameters/ResourceGroupNameParameter
      - $ref: ../../../common/v1/definitions.json#/parameters/NamespaceNameParameter
      - $ref: ../../../common/v1/definitions.json#/parameters/TopicNameParameter
      - $ref: ../../../common/v1/definitions.json#/parameters/ApiVersionParameter
      - $ref: ../../../common/v1/definitions.json#/parameters/SubscriptionIdParameter
      responses:
        '200':
          description: Topic description successfully retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SBTopic'
        default:
          description: ServiceBus error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: ../../../common/v1/definitions.json#/definitions/ErrorResponse
      summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Servicebus Namespaces Namespacename Topics Topicname
components:
  schemas:
    Topic:
      description: EventGrid Topic
      type: object
      allOf:
      - $ref: '#/components/schemas/TrackedResource'
      properties:
        properties:
          $ref: '#/components/schemas/TopicProperties'
          description: Properties of the topic.
          x-ms-client-flatten: true
        sku:
          $ref: '#/components/schemas/ResourceSku'
          description: The Sku pricing tier for the topic.
        identity:
          $ref: '#/components/schemas/IdentityInfo

# --- truncated at 32 KB (62 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-azure/refs/heads/main/openapi/microsoft-azure-topics-api-openapi.yml