Interface Topics


  • public interface Topics
    Resource collection API of Topics.
    • Method Detail

      • getByResourceGroup

        Topic getByResourceGroup​(String resourceGroupName,
                                 String topicName)
        Get properties of a topic.
        Parameters:
        resourceGroupName - The name of the resource group within the user's subscription.
        topicName - Name of the topic.
        Returns:
        properties of a topic.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
      • getByResourceGroupWithResponse

        com.azure.core.http.rest.Response<Topic> getByResourceGroupWithResponse​(String resourceGroupName,
                                                                                String topicName,
                                                                                com.azure.core.util.Context context)
        Get properties of a topic.
        Parameters:
        resourceGroupName - The name of the resource group within the user's subscription.
        topicName - Name of the topic.
        context - The context to associate with this operation.
        Returns:
        properties of a topic along with Response.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
      • deleteByResourceGroup

        void deleteByResourceGroup​(String resourceGroupName,
                                   String topicName)
        Delete existing topic.
        Parameters:
        resourceGroupName - The name of the resource group within the user's subscription.
        topicName - Name of the topic.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
      • delete

        void delete​(String resourceGroupName,
                    String topicName,
                    com.azure.core.util.Context context)
        Delete existing topic.
        Parameters:
        resourceGroupName - The name of the resource group within the user's subscription.
        topicName - Name of the topic.
        context - The context to associate with this operation.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
      • list

        com.azure.core.http.rest.PagedIterable<Topic> list()
        List all the topics under an Azure subscription.
        Returns:
        result of the List Topics operation.
        Throws:
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
      • list

        com.azure.core.http.rest.PagedIterable<Topic> list​(String filter,
                                                           Integer top,
                                                           com.azure.core.util.Context context)
        List all the topics under an Azure subscription.
        Parameters:
        filter - The query used to filter the search results using OData syntax. Filtering is permitted on the 'name' property only and with limited number of OData operations. These operations are: the 'contains' function as well as the following logical operations: not, and, or, eq (for equal), and ne (for not equal). No arithmetic operations are supported. The following is a valid filter example: $filter=contains(namE, 'PATTERN') and name ne 'PATTERN-1'. The following is not a valid filter example: $filter=location eq 'westus'.
        top - The number of results to return per page for the list operation. Valid range for top parameter is 1 to 100. If not specified, the default number of results to be returned is 20 items per page.
        context - The context to associate with this operation.
        Returns:
        result of the List Topics operation.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
      • listByResourceGroup

        com.azure.core.http.rest.PagedIterable<Topic> listByResourceGroup​(String resourceGroupName)
        List all the topics under a resource group.
        Parameters:
        resourceGroupName - The name of the resource group within the user's subscription.
        Returns:
        result of the List Topics operation.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
      • listByResourceGroup

        com.azure.core.http.rest.PagedIterable<Topic> listByResourceGroup​(String resourceGroupName,
                                                                          String filter,
                                                                          Integer top,
                                                                          com.azure.core.util.Context context)
        List all the topics under a resource group.
        Parameters:
        resourceGroupName - The name of the resource group within the user's subscription.
        filter - The query used to filter the search results using OData syntax. Filtering is permitted on the 'name' property only and with limited number of OData operations. These operations are: the 'contains' function as well as the following logical operations: not, and, or, eq (for equal), and ne (for not equal). No arithmetic operations are supported. The following is a valid filter example: $filter=contains(namE, 'PATTERN') and name ne 'PATTERN-1'. The following is not a valid filter example: $filter=location eq 'westus'.
        top - The number of results to return per page for the list operation. Valid range for top parameter is 1 to 100. If not specified, the default number of results to be returned is 20 items per page.
        context - The context to associate with this operation.
        Returns:
        result of the List Topics operation.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
      • listSharedAccessKeys

        TopicSharedAccessKeys listSharedAccessKeys​(String resourceGroupName,
                                                   String topicName)
        List the two keys used to publish to a topic.
        Parameters:
        resourceGroupName - The name of the resource group within the user's subscription.
        topicName - Name of the topic.
        Returns:
        shared access keys of the Topic.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
      • listSharedAccessKeysWithResponse

        com.azure.core.http.rest.Response<TopicSharedAccessKeys> listSharedAccessKeysWithResponse​(String resourceGroupName,
                                                                                                  String topicName,
                                                                                                  com.azure.core.util.Context context)
        List the two keys used to publish to a topic.
        Parameters:
        resourceGroupName - The name of the resource group within the user's subscription.
        topicName - Name of the topic.
        context - The context to associate with this operation.
        Returns:
        shared access keys of the Topic along with Response.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
      • regenerateKey

        TopicSharedAccessKeys regenerateKey​(String resourceGroupName,
                                            String topicName,
                                            TopicRegenerateKeyRequest regenerateKeyRequest)
        Regenerate a shared access key for a topic.
        Parameters:
        resourceGroupName - The name of the resource group within the user's subscription.
        topicName - Name of the topic.
        regenerateKeyRequest - Request body to regenerate key.
        Returns:
        shared access keys of the Topic.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
      • regenerateKey

        TopicSharedAccessKeys regenerateKey​(String resourceGroupName,
                                            String topicName,
                                            TopicRegenerateKeyRequest regenerateKeyRequest,
                                            com.azure.core.util.Context context)
        Regenerate a shared access key for a topic.
        Parameters:
        resourceGroupName - The name of the resource group within the user's subscription.
        topicName - Name of the topic.
        regenerateKeyRequest - Request body to regenerate key.
        context - The context to associate with this operation.
        Returns:
        shared access keys of the Topic.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
      • listEventTypes

        com.azure.core.http.rest.PagedIterable<EventType> listEventTypes​(String resourceGroupName,
                                                                         String providerNamespace,
                                                                         String resourceTypeName,
                                                                         String resourceName)
        List event types for a topic.
        Parameters:
        resourceGroupName - The name of the resource group within the user's subscription.
        providerNamespace - Namespace of the provider of the topic.
        resourceTypeName - Name of the topic type.
        resourceName - Name of the topic.
        Returns:
        result of the List Event Types operation.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
      • listEventTypes

        com.azure.core.http.rest.PagedIterable<EventType> listEventTypes​(String resourceGroupName,
                                                                         String providerNamespace,
                                                                         String resourceTypeName,
                                                                         String resourceName,
                                                                         com.azure.core.util.Context context)
        List event types for a topic.
        Parameters:
        resourceGroupName - The name of the resource group within the user's subscription.
        providerNamespace - Namespace of the provider of the topic.
        resourceTypeName - Name of the topic type.
        resourceName - Name of the topic.
        context - The context to associate with this operation.
        Returns:
        result of the List Event Types operation.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
      • getById

        Topic getById​(String id)
        Get properties of a topic.
        Parameters:
        id - the resource ID.
        Returns:
        properties of a topic along with Response.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
      • getByIdWithResponse

        com.azure.core.http.rest.Response<Topic> getByIdWithResponse​(String id,
                                                                     com.azure.core.util.Context context)
        Get properties of a topic.
        Parameters:
        id - the resource ID.
        context - The context to associate with this operation.
        Returns:
        properties of a topic along with Response.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
      • deleteById

        void deleteById​(String id)
        Delete existing topic.
        Parameters:
        id - the resource ID.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
      • deleteByIdWithResponse

        void deleteByIdWithResponse​(String id,
                                    com.azure.core.util.Context context)
        Delete existing topic.
        Parameters:
        id - the resource ID.
        context - The context to associate with this operation.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
      • define

        Topic.DefinitionStages.Blank define​(String name)
        Begins definition for a new Topic resource.
        Parameters:
        name - resource name.
        Returns:
        the first stage of the new Topic definition.