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.network;

import java.util.Map;
import java.util.Set;

import com.microsoft.azure.management.apigeneration.Fluent;
import com.microsoft.azure.management.network.implementation.NetworkManager;
import com.microsoft.azure.management.network.implementation.NetworkSecurityGroupInner;
import com.microsoft.azure.management.network.model.HasAssociatedSubnets;
import com.microsoft.azure.management.network.model.UpdatableWithTags;
import com.microsoft.azure.management.resources.fluentcore.arm.models.GroupableResource;
import com.microsoft.azure.management.resources.fluentcore.arm.models.Resource;
import com.microsoft.azure.management.resources.fluentcore.model.Appliable;
import com.microsoft.azure.management.resources.fluentcore.model.Attachable;
import com.microsoft.azure.management.resources.fluentcore.model.Creatable;
import com.microsoft.azure.management.resources.fluentcore.model.Refreshable;
import com.microsoft.azure.management.resources.fluentcore.model.Updatable;

Network security group.
/**
 * Network security group.
 */
@Fluent()
public interface NetworkSecurityGroup extends
        GroupableResource<NetworkManager, NetworkSecurityGroupInner>,
        Refreshable<NetworkSecurityGroup>,
        Updatable<NetworkSecurityGroup.Update>,
        UpdatableWithTags<NetworkSecurityGroup>,
        HasAssociatedSubnets {

    // Getters

    
Returns:
security rules associated with this network security group, indexed by their names/**
     * @return security rules associated with this network security group, indexed by their names
     */
    Map<String, NetworkSecurityRule> securityRules();

    
Returns:
default security rules associated with this network security group, indexed by their name/**
     * @return default security rules associated with this network security group, indexed by their name
     */
    Map<String, NetworkSecurityRule> defaultSecurityRules();

    
Returns:
the IDs of the network interfaces associated with this network security group/**
     * @return the IDs of the network interfaces associated with this network security group
     */
    Set<String> networkInterfaceIds();

    // Fluent interfaces for creating NSGs

    
The entirety of the network security group definition.
/**
     * The entirety of the network security group definition.
     */
    interface Definition extends
        DefinitionStages.Blank,
        DefinitionStages.WithGroup,
        DefinitionStages.WithCreate {
    }

    
Grouping of network security group definition stages.
/**
     * Grouping of network security group definition stages.
     */
    interface DefinitionStages {
        
The first stage of the definition.
/**
         * The first stage of the definition.
         */
        interface Blank
            extends GroupableResource.DefinitionWithRegion<WithGroup> {
        }

        
The stage allowing to specify the resource group.
/**
         * The stage allowing to specify the resource group.
         */
        interface WithGroup
            extends GroupableResource.DefinitionStages.WithGroup<WithCreate> {
        }

        
The stage allowing to define a new security rule.
 When the security rule description is complete enough, use Attachable.attach() to attach it to this network security group. /**
         * The stage allowing to define a new security rule.
         * <p>
         * When the security rule description is complete enough, use {@link Attachable#attach()} to attach it to
         * this network security group.
         */
        interface WithRule {
            
Starts the definition of a new security rule.
Params:
name – the name for the new security rule
Returns:
the first stage of the security rule definition/**
             * Starts the definition of a new security rule.
             * @param name the name for the new security rule
             * @return the first stage of the security rule definition
             */
            NetworkSecurityRule.DefinitionStages.Blank<WithCreate> defineRule(String name);
        }

        
The stage of the definition which contains all the minimum required inputs for the resource to be created (via Creatable<NetworkSecurityGroup>.create()), but also allows for any other optional settings to be specified. /**
         * The stage of the definition which contains all the minimum required inputs for
         * the resource to be created (via {@link WithCreate#create()}), but also allows
         * for any other optional settings to be specified.
         */
        interface WithCreate extends
            Creatable<NetworkSecurityGroup>,
            Resource.DefinitionWithTags<WithCreate>,
            DefinitionStages.WithRule {
        }
    }

    
Grouping of network security group update stages.
/**
     * Grouping of network security group update stages.
     */
    interface UpdateStages {
        
The stage of the resource definition allowing to add or remove security rules.
/**
         * The stage of the resource definition allowing to add or remove security rules.
         */
        interface WithRule {
            
Removes an existing security rule.
Params:
name – the name of the security rule to remove
Returns:
the next stage of the network security group description/**
             * Removes an existing security rule.
             * @param name the name of the security rule to remove
             * @return the next stage of the network security group description
             */
            Update withoutRule(String name);

            
Begins the definition of a new security rule to be added to this network security group.
Params:
name – the name of the new security rule
Returns:
the first stage of the new security rule definition/**
             * Begins the definition of a new security rule to be added to this network security group.
             * @param name the name of the new security rule
             * @return the first stage of the new security rule definition
             */
            NetworkSecurityRule.UpdateDefinitionStages.Blank<Update> defineRule(String name);

            
Begins the description of an update of an existing security rule of this network security group.
Params:
name – the name of an existing security rule
Returns:
the first stage of the security rule update description/**
             * Begins the description of an update of an existing security rule of this network security group.
             * @param name the name of an existing security rule
             * @return the first stage of the security rule update description
             */
            NetworkSecurityRule.Update updateRule(String name);
        }
    }

    
The template for an update operation, containing all the settings that
can be modified.
 Call Appliable<NetworkSecurityGroup>.apply() to apply the changes to the resource in Azure. /**
     * The template for an update operation, containing all the settings that
     * can be modified.
     * <p>
     * Call {@link Update#apply()} to apply the changes to the resource in Azure.
     */
    interface Update extends
        Appliable<NetworkSecurityGroup>,
        Resource.UpdateWithTags<Update>,
        UpdateStages.WithRule {
    }
}