Copyright (c) Microsoft Corporation. All rights reserved.
Licensed under the MIT License. See License.txt in the project root for
license information.
/**
 * Copyright (c) Microsoft Corporation. All rights reserved.
 * Licensed under the MIT License. See License.txt in the project root for
 * license information.
 */

package com.microsoft.azure.management.servicebus;

import com.microsoft.azure.management.apigeneration.Fluent;
import com.microsoft.azure.management.resources.fluentcore.arm.models.IndependentChildResource;
import com.microsoft.azure.management.resources.fluentcore.model.Refreshable;
import com.microsoft.azure.management.servicebus.implementation.ServiceBusManager;
import com.microsoft.azure.management.servicebus.implementation.SharedAccessAuthorizationRuleInner;
import rx.Observable;

import java.util.List;

Type representing authorization rule.
Type parameters:
<RuleT> – the specific rule type/**
 * Type representing authorization rule.
 *
 * @param <RuleT> the specific rule type
 */
@Fluent
public interface AuthorizationRule<RuleT extends AuthorizationRule<RuleT>> extends
        IndependentChildResource<ServiceBusManager, SharedAccessAuthorizationRuleInner>,
        Refreshable<RuleT> {

    
Returns:
rights associated with the rule/**
     * @return rights associated with the rule
     */
    List<AccessRights> rights();

    
Returns:
a representation of the deferred computation of this call, returning the primary, secondary keys and the connection strings/**
     * @return a representation of the deferred computation of this call, returning the primary, secondary keys and the connection strings
     */
    Observable<AuthorizationKeys> getKeysAsync();

    
Returns:
the primary, secondary keys and connection strings/**
     * @return the primary, secondary keys and connection strings
     */
    AuthorizationKeys getKeys();

    
Regenerates primary or secondary keys.
Params:
policykey – the key to regenerate
Returns:
a representation of the deferred computation of this call, returning the primary, secondary keys and the connection strings/**
     * Regenerates primary or secondary keys.
     *
     * @param policykey the key to regenerate
     * @return a representation of the deferred computation of this call, returning the primary, secondary keys and the connection strings
     */
    Observable<AuthorizationKeys> regenerateKeyAsync(Policykey policykey);

    
Regenerates primary or secondary keys.
Params:
policykey – the key to regenerate
Returns:
primary, secondary keys and connection strings/**
     * Regenerates primary or secondary keys.
     *
     * @param policykey the key to regenerate
     * @return primary, secondary keys and connection strings
     */
    AuthorizationKeys regenerateKey(Policykey policykey);

    
Grouping of commons authorization rule definition stages shared between different Service Bus
entities (namespace, queue, topic, subscription) access rules.
/**
     * Grouping of commons authorization rule definition stages shared between different Service Bus
     * entities (namespace, queue, topic, subscription) access rules.
     */
    interface DefinitionStages {
        
The stage of the Service Bus authorization rule definition allowing to enable listen policy.
Type parameters:
<T> – the next stage of the definition/**
         * The stage of the Service Bus authorization rule definition allowing to enable listen policy.
         *
         * @param <T> the next stage of the definition
         */
        interface WithListen<T> {
            
Returns:
the next stage of the definition/**
             * @return the next stage of the definition
             */
            T withListeningEnabled();
        }

        
The stage of the Service Bus authorization rule definition allowing to enable send policy.
Type parameters:
<T> – the next stage of the definition/**
         * The stage of the Service Bus authorization rule definition allowing to enable send policy.
         *
         * @param <T> the next stage of the definition
         */
        interface WithSend<T> {
            
Returns:
the next stage of the definition/**
             * @return the next stage of the definition
             */
            T withSendingEnabled();
        }

        
The stage of the Service Bus authorization rule definition allowing to enable manage policy.
Type parameters:
<T> – the next stage of the definition/**
         * The stage of the Service Bus authorization rule definition allowing to enable manage policy.
         *
         * @param <T> the next stage of the definition
         */
        interface WithManage<T> {
            
Returns:
the next stage of the definition/**
             * @return the next stage of the definition
             */
            T withManagementEnabled();
        }

        
The stage of the Service Bus authorization rule definition allowing to enable send or manage policy.
Type parameters:
<T> – the next stage of the definition/**
         * The stage of the Service Bus authorization rule definition allowing to enable send or manage policy.
         *
         * @param <T> the next stage of the definition
         */
        interface WithSendOrManage<T> extends WithSend<T>, WithManage<T> {
        }

        
The stage of the Service Bus authorization rule definition allowing to enable listen, send or manage policy.
Type parameters:
<T> – the next stage of the definition/**
         * The stage of the Service Bus authorization rule definition allowing to enable listen, send or manage policy.
         *
         * @param <T> the next stage of the definition
         */
        interface WithListenOrSendOrManage<T> extends WithListen<T>, WithSendOrManage<T> {
        }
    }

    
Grouping of commons authorization rule update stages shared between different Service Bus
entities (namespace, queue, topic, subscription) access rules.
/**
     * Grouping of commons authorization rule update stages shared between different Service Bus
     * entities (namespace, queue, topic, subscription) access rules.
     */
    interface UpdateStages {
        
The stage of the Service Bus authorization rule update allowing to enable listen policy.
Type parameters:
<T> – the next stage of the update/**
         * The stage of the Service Bus authorization rule update allowing to enable listen policy.
         *
         * @param <T> the next stage of the update
         */
        interface WithListen<T> {
            
Returns:
the next stage of the update/**
             * @return the next stage of the update
             */
            T withListeningEnabled();
        }

        
The stage of the Service Bus authorization rule update allowing to enable send policy.
Type parameters:
<T> – the next stage of the update/**
         * The stage of the Service Bus authorization rule update allowing to enable send policy.
         *
         * @param <T> the next stage of the update
         */
        interface WithSend<T> {
            
Returns:
the next stage of the update/**
             * @return the next stage of the update
             */
            T withSendingEnabled();
        }

        
The stage of Service Bus authorization rule update allowing to enable manage policy.
Type parameters:
<T> – the next stage of the update/**
         * The stage of Service Bus authorization rule update allowing to enable manage policy.
         *
         * @param <T> the next stage of the update
         */
        interface WithManage<T> {
            
Returns:
the next stage of the update/**
             * @return the next stage of the update
             */
            T withManagementEnabled();
        }

        
The stage of the Service Bus authorization rule update allowing to enable send or manage policy.
Type parameters:
<T> – the next stage of the update/**
         * The stage of the Service Bus authorization rule update allowing to enable send or manage policy.
         *
         * @param <T> the next stage of the update
         */
        interface WithSendOrManage<T> extends WithSend<T>, WithManage<T> {
        }

        
The stage of the Service Bus authorization rule update allowing to enable listen, send or manage policy.
Type parameters:
<T> – the next stage of the update/**
         * The stage of the Service Bus authorization rule update allowing to enable listen, send or manage policy.
         *
         * @param <T> the next stage of the update
         */
        interface WithListenOrSendOrManage<T> extends WithListen<T>, WithSendOrManage<T> {
        }
    }
}