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 com.microsoft.azure.management.apigeneration.Beta;
import com.microsoft.azure.management.apigeneration.Beta.SinceVersion;
import com.microsoft.azure.management.apigeneration.Fluent;
import com.microsoft.azure.management.network.implementation.AvailableProvidersListInner;
import com.microsoft.azure.management.resources.fluentcore.arm.models.HasParent;
import com.microsoft.azure.management.resources.fluentcore.model.Executable;
import com.microsoft.azure.management.resources.fluentcore.model.HasInner;

import java.util.Map;

An immutable client-side representation of available Internet service providers.
/**
 * An immutable client-side representation of available Internet service providers.
 */
@Fluent
@Beta(SinceVersion.V1_10_0)
public interface AvailableProviders extends Executable<AvailableProviders>,
        HasInner<AvailableProvidersListInner>,
        HasParent<NetworkWatcher> {
    
Returns:
parameters used to query available internet providers/**
     * @return parameters used to query available internet providers
     */
    AvailableProvidersListParameters availableProvidersParameters();

    
Returns:
read-only map of available internet providers, indexed by country/**
     * @return read-only map of available internet providers, indexed by country
     */
    Map<String, AvailableProvidersListCountry> providersByCountry();

    
The entirety of available providers parameters definition.
/**
     * The entirety of available providers parameters definition.
     */
    interface Definition extends DefinitionStages.WithExecuteAndCountry,
        DefinitionStages.WithExecuteAndState,
        DefinitionStages.WithExecuteAndCity {
    }

    
Grouping of available providers parameters definition stages.
/**
     * Grouping of available providers parameters definition stages.
     */
    interface DefinitionStages {
        
The first stage of available providers parameters definition.
/**
         * The first stage of available providers parameters definition.
         */
        interface WithAzureLocations {
            
Set the list of Azure regions. Note: this will overwrite locations if already set.
Params:
azureLocations – locations list
Returns:
the AvailableProviders object itself./**
             * Set the list of Azure regions. Note: this will overwrite locations if already set.
             *
             * @param azureLocations locations list
             * @return the AvailableProviders object itself.
             */
            WithExecute withAzureLocations(String... azureLocations);
            
Sets Azure region name. Note: this method has additive effect.
Params:
azureLocation – region name
Returns:
the AvailableProviders object itself./**
             * Sets Azure region name. Note: this method has additive effect.
             *
             * @param azureLocation region name
             * @return the AvailableProviders object itself.
             */
            WithExecuteAndCountry withAzureLocation(String azureLocation);
        }

        
The stage of the definition which contains all the minimum required inputs for execution, but also allows
for any other optional settings to be specified.
/**
         * The stage of the definition which contains all the minimum required inputs for execution, but also allows
         * for any other optional settings to be specified.
         */
        interface WithExecute extends
                Executable<AvailableProviders>,
                DefinitionStages.WithAzureLocations {
        }

        
The stage of the definition which allows to specify country or execute the query.
/**
         * The stage of the definition which allows to specify country or execute the query.
         */
        interface WithExecuteAndCountry extends WithExecute {
            
Params:
country – the country for available providers list
Returns:
the next stage of the definition/**
             * @param country the country for available providers list
             * @return the next stage of the definition
             */
            WithExecuteAndState withCountry(String country);
        }

        
The stage of the definition which allows to specify state or execute the query.
/**
         * The stage of the definition which allows to specify state or execute the query.
         */
        interface WithExecuteAndState extends WithExecute {
            
Params:
state – the state for available providers list
Returns:
the next stage of the definition/**
             * @param state the state for available providers list
             * @return the next stage of the definition
             */
            WithExecuteAndCity withState(String state);
        }

        
The stage of the definition which allows to specify city or execute the query.
/**
         * The stage of the definition which allows to specify city or execute the query.
         */
        interface WithExecuteAndCity extends WithExecute {
            
Params:
city – the city or town for available providers list
Returns:
the next stage of the definition/**
             * @param city the city or town for available providers list
             * @return the next stage of the definition
             */
            WithExecute withCity(String city);
        }
    }
}