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

import com.microsoft.azure.management.apigeneration.Beta;
import com.microsoft.azure.management.apigeneration.Fluent;
import com.microsoft.azure.management.apigeneration.Method;
import com.microsoft.azure.management.resources.fluentcore.arm.models.Resource;
import com.microsoft.azure.management.resources.fluentcore.collection.SupportsCreating;
import com.microsoft.azure.management.resources.fluentcore.model.Creatable;
import rx.Observable;

A representation of the Azure SQL Failover Group operations.
/**
 * A representation of the Azure SQL Failover Group operations.
 */
@Fluent
@Beta(Beta.SinceVersion.V1_8_0)
public interface SqlFailoverGroupOperations extends
    SupportsCreating<SqlFailoverGroupOperations.DefinitionStages.WithSqlServer>,
    SqlChildrenOperations<SqlFailoverGroup> {

    
Fails over from the current primary server to this server.
Params:
resourceGroupName – the name of the resource group that contains the resource
serverName – the name of the server containing the failover group
failoverGroupName – the name of the failover group
Returns:
the SqlFailoverGroup object/**
     * Fails over from the current primary server to this server.
     *
     * @param resourceGroupName the name of the resource group that contains the resource
     * @param serverName the name of the server containing the failover group
     * @param failoverGroupName the name of the failover group
     * @return the SqlFailoverGroup object
     */
    SqlFailoverGroup failover(String resourceGroupName, String serverName, String failoverGroupName);

    
Asynchronously fails over from the current primary server to this server.
Params:
resourceGroupName – the name of the resource group that contains the resource
serverName – the name of the server containing the failover group
failoverGroupName – the name of the failover group
Returns:
a representation of the deferred computation of this call returning the SqlFailoverGroup object/**
     * Asynchronously fails over from the current primary server to this server.
     *
     * @param resourceGroupName the name of the resource group that contains the resource
     * @param serverName the name of the server containing the failover group
     * @param failoverGroupName the name of the failover group
     * @return a representation of the deferred computation of this call returning the SqlFailoverGroup object
     */
    Observable<SqlFailoverGroup> failoverAsync(String resourceGroupName, String serverName, String failoverGroupName);

    
Fails over from the current primary server to this server. This operation might result in data loss.
Params:
resourceGroupName – the name of the resource group that contains the resource
serverName – the name of the server containing the failover group
failoverGroupName – the name of the failover group
Returns:
the SqlFailoverGroup object/**
     * Fails over from the current primary server to this server. This operation might result in data loss.
     *
     * @param resourceGroupName the name of the resource group that contains the resource
     * @param serverName the name of the server containing the failover group
     * @param failoverGroupName the name of the failover group
     * @return the SqlFailoverGroup object
     */
    SqlFailoverGroup forceFailoverAllowDataLoss(String resourceGroupName, String serverName, String failoverGroupName);

    
Fails over from the current primary server to this server. This operation might result in data loss.
Params:
resourceGroupName – the name of the resource group that contains the resource
serverName – the name of the server containing the failover group
failoverGroupName – the name of the failover group
Returns:
a representation of the deferred computation of this call returning the SqlFailoverGroup object/**
     * Fails over from the current primary server to this server. This operation might result in data loss.
     *
     * @param resourceGroupName the name of the resource group that contains the resource
     * @param serverName the name of the server containing the failover group
     * @param failoverGroupName the name of the failover group
     * @return a representation of the deferred computation of this call returning the SqlFailoverGroup object
     */
    Observable<SqlFailoverGroup> forceFailoverAllowDataLossAsync(String resourceGroupName, String serverName, String failoverGroupName);


    
Container interface for all the definitions that need to be implemented.
/**
     * Container interface for all the definitions that need to be implemented.
     */
    @Beta(Beta.SinceVersion.V1_8_0)
    interface SqlFailoverGroupOperationsDefinition extends
        SqlFailoverGroupOperations.DefinitionStages.WithSqlServer,
        SqlFailoverGroupOperations.DefinitionStages.WithReadWriteEndpointPolicy,
        SqlFailoverGroupOperations.DefinitionStages.WithReadOnlyEndpointPolicy,
        SqlFailoverGroupOperations.DefinitionStages.WithPartnerServer,
        SqlFailoverGroupOperations.DefinitionStages.WithDatabase,
        SqlFailoverGroupOperations.DefinitionStages.WithCreate {
    }

    
Grouping of all the SQL Failover Group definition stages.
/**
     * Grouping of all the SQL Failover Group definition stages.
     */
    @Beta(Beta.SinceVersion.V1_8_0)
    interface DefinitionStages {
        
The first stage of the SQL Failover Group definition.
/**
         * The first stage of the SQL Failover Group definition.
         */
        @Beta(Beta.SinceVersion.V1_8_0)
        interface WithSqlServer {
            
Sets the parent SQL server name and resource group it belongs to.
Params:
resourceGroupName – the name of the resource group the parent SQL server
sqlServerName –     the parent SQL server name
location –          the parent SQL server location
Returns:
the next stage of the definition/**
             * Sets the parent SQL server name and resource group it belongs to.
             *
             * @param resourceGroupName the name of the resource group the parent SQL server
             * @param sqlServerName     the parent SQL server name
             * @param location          the parent SQL server location
             * @return the next stage of the definition
             */
            SqlFailoverGroupOperations.DefinitionStages.WithReadWriteEndpointPolicy withExistingSqlServer(String resourceGroupName, String sqlServerName, String location);

            
Sets the parent SQL server for the new Failover Group.
Params:
sqlServer – the parent SQL server
Returns:
the next stage of the definition/**
             * Sets the parent SQL server for the new Failover Group.
             *
             * @param sqlServer the parent SQL server
             * @return the next stage of the definition
             */
            SqlFailoverGroupOperations.DefinitionStages.WithReadWriteEndpointPolicy withExistingSqlServer(SqlServer sqlServer);
        }

        
The SQL Failover Group definition to set the read-write endpoint failover policy.
/**
         * The SQL Failover Group definition to set the read-write endpoint failover policy.
         */
        @Beta(Beta.SinceVersion.V1_8_0)
        interface WithReadWriteEndpointPolicy {
            
Sets the SQL Failover Group read-write endpoint failover policy as "Automatic".
Params:
gracePeriodInMinutes – the grace period before failover with data loss is attempted for the read-write endpoint
Returns:
the next stage of the definition/**
             * Sets the SQL Failover Group read-write endpoint failover policy as "Automatic".
             *
             * @param gracePeriodInMinutes the grace period before failover with data loss is attempted for the read-write endpoint
             * @return the next stage of the definition
             */
            SqlFailoverGroupOperations.DefinitionStages.WithPartnerServer withAutomaticReadWriteEndpointPolicyAndDataLossGracePeriod(int gracePeriodInMinutes);

            
Sets the SQL Failover Group read-write endpoint failover policy as "Manual".
Returns:
the next stage of the definition/**
             * Sets the SQL Failover Group read-write endpoint failover policy as "Manual".
             *
             * @return the next stage of the definition
             */
            @Method
            SqlFailoverGroupOperations.DefinitionStages.WithPartnerServer withManualReadWriteEndpointPolicy();
        }

        
The SQL Failover Group definition to set the failover policy of the read-only endpoint.
/**
         * The SQL Failover Group definition to set the failover policy of the read-only endpoint.
         */
        @Beta(Beta.SinceVersion.V1_8_0)
        interface WithReadOnlyEndpointPolicy {
            
Sets the SQL Failover Group failover policy of the read-only endpoint to "Enabled".
Returns:
The next stage of the definition./**
             * Sets the SQL Failover Group failover policy of the read-only endpoint to "Enabled".
             *
             * @return The next stage of the definition.
             */
            @Method
            SqlFailoverGroupOperations.DefinitionStages.WithCreate withReadOnlyEndpointPolicyEnabled();

            
Sets the SQL Failover Group failover policy of the read-only endpoint to "Disabled".
Returns:
the next stage of the definition/**
             * Sets the SQL Failover Group failover policy of the read-only endpoint to "Disabled".
             *
             * @return the next stage of the definition
             */
            @Method
            SqlFailoverGroupOperations.DefinitionStages.WithCreate withReadOnlyEndpointPolicyDisabled();
        }

        
The SQL Failover Group definition to set the partner servers.
/**
         * The SQL Failover Group definition to set the partner servers.
         */
        @Beta(Beta.SinceVersion.V1_8_0)
        interface WithPartnerServer extends SqlFailoverGroupOperations.DefinitionStages.WithCreate {
            
Sets the SQL Failover Group partner server.
Params:
id – the ID of the partner SQL server
Returns:
The next stage of the definition./**
             * Sets the SQL Failover Group partner server.
             *
             * @param id the ID of the partner SQL server
             * @return The next stage of the definition.
             */
            SqlFailoverGroupOperations.DefinitionStages.WithPartnerServer withPartnerServerId(String id);
        }

        
The SQL Failover Group definition to set the partner servers.
/**
         * The SQL Failover Group definition to set the partner servers.
         */
        @Beta(Beta.SinceVersion.V1_8_0)
        interface WithDatabase {
            
Sets the SQL Failover Group database.
Params:
id – the ID of the database
Returns:
The next stage of the definition./**
             * Sets the SQL Failover Group database.
             *
             * @param id the ID of the database
             * @return The next stage of the definition.
             */
            SqlFailoverGroupOperations.DefinitionStages.WithCreate withDatabaseId(String id);

            
Sets the SQL Failover Group partner servers.
Params:
ids – the IDs of the databases
Returns:
the next stage of the definition/**
             * Sets the SQL Failover Group partner servers.
             *
             * @param ids the IDs of the databases
             * @return the next stage of the definition
             */
            @Method
            SqlFailoverGroupOperations.DefinitionStages.WithCreate withDatabaseIds(String... ids);
        }

        
The final stage of the SQL Failover Group definition.
/**
         * The final stage of the SQL Failover Group definition.
         */
        interface WithCreate extends
            SqlFailoverGroupOperations.DefinitionStages.WithReadOnlyEndpointPolicy,
            SqlFailoverGroupOperations.DefinitionStages.WithDatabase,
            Resource.DefinitionWithTags<SqlFailoverGroupOperations.DefinitionStages.WithCreate>,
            Creatable<SqlFailoverGroup> {
        }
    }

    
Grouping of the Azure SQL Failover Group common actions.
/**
     * Grouping of the Azure SQL Failover Group common actions.
     */
    @Beta(Beta.SinceVersion.V1_8_0)
    interface SqlFailoverGroupActionsDefinition extends SqlChildrenActionsDefinition<SqlFailoverGroup> {
        
Begins the definition of a new SQL Failover Group to be added to this server.
Params:
failoverGroupName – the name of the new Failover Group to be created for the selected SQL server
Returns:
the first stage of the new SQL Failover Group definition/**
         * Begins the definition of a new SQL Failover Group to be added to this server.
         *
         * @param failoverGroupName the name of the new Failover Group to be created for the selected SQL server
         * @return the first stage of the new SQL Failover Group definition
         */
        SqlFailoverGroupOperations.DefinitionStages.WithReadWriteEndpointPolicy define(String failoverGroupName);

        
Fails over from the current primary server to this server.
Params:
failoverGroupName – the name of the failover group
Returns:
the SqlFailoverGroup object/**
         * Fails over from the current primary server to this server.
         *
         * @param failoverGroupName the name of the failover group
         * @return the SqlFailoverGroup object
         */
        SqlFailoverGroup failover(String failoverGroupName);

        
Asynchronously fails over from the current primary server to this server.
Params:
failoverGroupName – the name of the failover group
Returns:
a representation of the deferred computation of this call returning the SqlFailoverGroup object/**
         * Asynchronously fails over from the current primary server to this server.
         *
         * @param failoverGroupName the name of the failover group
         * @return a representation of the deferred computation of this call returning the SqlFailoverGroup object
         */
        Observable<SqlFailoverGroup> failoverAsync(String failoverGroupName);

        
Fails over from the current primary server to this server. This operation might result in data loss.
Params:
failoverGroupName – the name of the failover group
Returns:
the SqlFailoverGroup object/**
         * Fails over from the current primary server to this server. This operation might result in data loss.
         *
         * @param failoverGroupName the name of the failover group
         * @return the SqlFailoverGroup object
         */
        SqlFailoverGroup forceFailoverAllowDataLoss(String failoverGroupName);

        
Fails over from the current primary server to this server. This operation might result in data loss.
Params:
failoverGroupName – the name of the failover group
Returns:
a representation of the deferred computation of this call returning the SqlFailoverGroup object/**
         * Fails over from the current primary server to this server. This operation might result in data loss.
         *
         * @param failoverGroupName the name of the failover group
         * @return a representation of the deferred computation of this call returning the SqlFailoverGroup object
         */
        Observable<SqlFailoverGroup> forceFailoverAllowDataLossAsync(String failoverGroupName);
    }
}