// Copyright (c) Microsoft Corporation. All rights reserved.
// Licensed under the MIT License.
// Code generated by Microsoft (R) TypeSpec Code Generator.

package azure.resourcemanager.resources.models;

import azure.resourcemanager.resources.fluent.models.LocationResourceInner;
import com.azure.core.management.SystemData;
import com.azure.core.util.Context;

/**
 * An immutable client-side representation of LocationResource.
 */
public interface LocationResource {
    /**
     * Gets the id property: Fully qualified resource Id for the resource.
     * 
     * @return the id value.
     */
    String id();

    /**
     * Gets the name property: The name of the resource.
     * 
     * @return the name value.
     */
    String name();

    /**
     * Gets the type property: The type of the resource.
     * 
     * @return the type value.
     */
    String type();

    /**
     * Gets the properties property: The resource-specific properties for this resource.
     * 
     * @return the properties value.
     */
    LocationResourceProperties properties();

    /**
     * Gets the systemData property: Azure Resource Manager metadata containing createdBy and modifiedBy information.
     * 
     * @return the systemData value.
     */
    SystemData systemData();

    /**
     * Gets the inner azure.resourcemanager.resources.fluent.models.LocationResourceInner object.
     * 
     * @return the inner object.
     */
    LocationResourceInner innerModel();

    /**
     * The entirety of the LocationResource definition.
     */
    interface Definition
        extends DefinitionStages.Blank, DefinitionStages.WithParentResource, DefinitionStages.WithCreate {
    }

    /**
     * The LocationResource definition stages.
     */
    interface DefinitionStages {
        /**
         * The first stage of the LocationResource definition.
         */
        interface Blank extends WithParentResource {
        }

        /**
         * The stage of the LocationResource definition allowing to specify parent resource.
         */
        interface WithParentResource {
            /**
             * Specifies location.
             * 
             * @param location The name of the Azure region.
             * @return the next definition stage.
             */
            WithCreate withExistingLocation(String location);
        }

        /**
         * The stage of the LocationResource definition which contains all the minimum required properties for the
         * resource to be created, but also allows for any other optional properties to be specified.
         */
        interface WithCreate extends DefinitionStages.WithProperties {
            /**
             * Executes the create request.
             * 
             * @return the created resource.
             */
            LocationResource create();

            /**
             * Executes the create request.
             * 
             * @param context The context to associate with this operation.
             * @return the created resource.
             */
            LocationResource create(Context context);
        }

        /**
         * The stage of the LocationResource definition allowing to specify properties.
         */
        interface WithProperties {
            /**
             * Specifies the properties property: The resource-specific properties for this resource..
             * 
             * @param properties The resource-specific properties for this resource.
             * @return the next definition stage.
             */
            WithCreate withProperties(LocationResourceProperties properties);
        }
    }

    /**
     * Begins update for the LocationResource resource.
     * 
     * @return the stage of resource update.
     */
    LocationResource.Update update();

    /**
     * The template for LocationResource update.
     */
    interface Update extends UpdateStages.WithProperties {
        /**
         * Executes the update request.
         * 
         * @return the updated resource.
         */
        LocationResource apply();

        /**
         * Executes the update request.
         * 
         * @param context The context to associate with this operation.
         * @return the updated resource.
         */
        LocationResource apply(Context context);
    }

    /**
     * The LocationResource update stages.
     */
    interface UpdateStages {
        /**
         * The stage of the LocationResource update allowing to specify properties.
         */
        interface WithProperties {
            /**
             * Specifies the properties property: The resource-specific properties for this resource..
             * 
             * @param properties The resource-specific properties for this resource.
             * @return the next definition stage.
             */
            Update withProperties(LocationResourceProperties properties);
        }
    }

    /**
     * Refreshes the resource to sync with Azure.
     * 
     * @return the refreshed resource.
     */
    LocationResource refresh();

    /**
     * Refreshes the resource to sync with Azure.
     * 
     * @param context The context to associate with this operation.
     * @return the refreshed resource.
     */
    LocationResource refresh(Context context);
}
