Interface Databases


public interface Databases
Resource collection API of Databases.
  • Method Details

    • checkNameAvailability

      CheckNameResult checkNameAvailability(String resourceGroupName, String clusterName, CheckNameRequest resourceName)
      Checks that the databases resource name is valid and is not already in use.
      Parameters:
      resourceGroupName - The name of the resource group containing the Kusto cluster.
      clusterName - The name of the Kusto cluster.
      resourceName - The name of the resource.
      Returns:
      the result returned from a check name availability request.
      Throws:
      IllegalArgumentException - thrown if parameters fail the validation.
      com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
      RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
    • checkNameAvailabilityWithResponse

      com.azure.core.http.rest.Response<CheckNameResult> checkNameAvailabilityWithResponse(String resourceGroupName, String clusterName, CheckNameRequest resourceName, com.azure.core.util.Context context)
      Checks that the databases resource name is valid and is not already in use.
      Parameters:
      resourceGroupName - The name of the resource group containing the Kusto cluster.
      clusterName - The name of the Kusto cluster.
      resourceName - The name of the resource.
      context - The context to associate with this operation.
      Returns:
      the result returned from a check name availability request along with Response.
      Throws:
      IllegalArgumentException - thrown if parameters fail the validation.
      com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
      RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
    • listByCluster

      com.azure.core.http.rest.PagedIterable<Database> listByCluster(String resourceGroupName, String clusterName)
      Returns the list of databases of the given Kusto cluster.
      Parameters:
      resourceGroupName - The name of the resource group containing the Kusto cluster.
      clusterName - The name of the Kusto cluster.
      Returns:
      the list Kusto databases operation response as paginated response with PagedIterable.
      Throws:
      IllegalArgumentException - thrown if parameters fail the validation.
      com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
      RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
    • listByCluster

      com.azure.core.http.rest.PagedIterable<Database> listByCluster(String resourceGroupName, String clusterName, com.azure.core.util.Context context)
      Returns the list of databases of the given Kusto cluster.
      Parameters:
      resourceGroupName - The name of the resource group containing the Kusto cluster.
      clusterName - The name of the Kusto cluster.
      context - The context to associate with this operation.
      Returns:
      the list Kusto databases operation response as paginated response with PagedIterable.
      Throws:
      IllegalArgumentException - thrown if parameters fail the validation.
      com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
      RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
    • get

      Database get(String resourceGroupName, String clusterName, String databaseName)
      Returns a database.
      Parameters:
      resourceGroupName - The name of the resource group containing the Kusto cluster.
      clusterName - The name of the Kusto cluster.
      databaseName - The name of the database in the Kusto cluster.
      Returns:
      class representing a Kusto database.
      Throws:
      IllegalArgumentException - thrown if parameters fail the validation.
      com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
      RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
    • getWithResponse

      com.azure.core.http.rest.Response<Database> getWithResponse(String resourceGroupName, String clusterName, String databaseName, com.azure.core.util.Context context)
      Returns a database.
      Parameters:
      resourceGroupName - The name of the resource group containing the Kusto cluster.
      clusterName - The name of the Kusto cluster.
      databaseName - The name of the database in the Kusto cluster.
      context - The context to associate with this operation.
      Returns:
      class representing a Kusto database along with Response.
      Throws:
      IllegalArgumentException - thrown if parameters fail the validation.
      com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
      RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
    • createOrUpdate

      Database createOrUpdate(String resourceGroupName, String clusterName, String databaseName, DatabaseInner parameters, CallerRole callerRole)
      Creates or updates a database.
      Parameters:
      resourceGroupName - The name of the resource group containing the Kusto cluster.
      clusterName - The name of the Kusto cluster.
      databaseName - The name of the database in the Kusto cluster.
      parameters - The database parameters supplied to the CreateOrUpdate operation.
      callerRole - By default, any user who run operation on a database become an Admin on it. This property allows the caller to exclude the caller from Admins list.
      Returns:
      class representing a Kusto database.
      Throws:
      IllegalArgumentException - thrown if parameters fail the validation.
      com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
      RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
    • createOrUpdate

      Database createOrUpdate(String resourceGroupName, String clusterName, String databaseName, DatabaseInner parameters)
      Creates or updates a database.
      Parameters:
      resourceGroupName - The name of the resource group containing the Kusto cluster.
      clusterName - The name of the Kusto cluster.
      databaseName - The name of the database in the Kusto cluster.
      parameters - The database parameters supplied to the CreateOrUpdate operation.
      Returns:
      class representing a Kusto database.
      Throws:
      IllegalArgumentException - thrown if parameters fail the validation.
      com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
      RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
    • createOrUpdate

      Database createOrUpdate(String resourceGroupName, String clusterName, String databaseName, DatabaseInner parameters, CallerRole callerRole, com.azure.core.util.Context context)
      Creates or updates a database.
      Parameters:
      resourceGroupName - The name of the resource group containing the Kusto cluster.
      clusterName - The name of the Kusto cluster.
      databaseName - The name of the database in the Kusto cluster.
      parameters - The database parameters supplied to the CreateOrUpdate operation.
      callerRole - By default, any user who run operation on a database become an Admin on it. This property allows the caller to exclude the caller from Admins list.
      context - The context to associate with this operation.
      Returns:
      class representing a Kusto database.
      Throws:
      IllegalArgumentException - thrown if parameters fail the validation.
      com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
      RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
    • update

      Database update(String resourceGroupName, String clusterName, String databaseName, DatabaseInner parameters, CallerRole callerRole)
      Updates a database.
      Parameters:
      resourceGroupName - The name of the resource group containing the Kusto cluster.
      clusterName - The name of the Kusto cluster.
      databaseName - The name of the database in the Kusto cluster.
      parameters - The database parameters supplied to the Update operation.
      callerRole - By default, any user who run operation on a database become an Admin on it. This property allows the caller to exclude the caller from Admins list.
      Returns:
      class representing a Kusto database.
      Throws:
      IllegalArgumentException - thrown if parameters fail the validation.
      com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
      RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
    • update

      Database update(String resourceGroupName, String clusterName, String databaseName, DatabaseInner parameters)
      Updates a database.
      Parameters:
      resourceGroupName - The name of the resource group containing the Kusto cluster.
      clusterName - The name of the Kusto cluster.
      databaseName - The name of the database in the Kusto cluster.
      parameters - The database parameters supplied to the Update operation.
      Returns:
      class representing a Kusto database.
      Throws:
      IllegalArgumentException - thrown if parameters fail the validation.
      com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
      RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
    • update

      Database update(String resourceGroupName, String clusterName, String databaseName, DatabaseInner parameters, CallerRole callerRole, com.azure.core.util.Context context)
      Updates a database.
      Parameters:
      resourceGroupName - The name of the resource group containing the Kusto cluster.
      clusterName - The name of the Kusto cluster.
      databaseName - The name of the database in the Kusto cluster.
      parameters - The database parameters supplied to the Update operation.
      callerRole - By default, any user who run operation on a database become an Admin on it. This property allows the caller to exclude the caller from Admins list.
      context - The context to associate with this operation.
      Returns:
      class representing a Kusto database.
      Throws:
      IllegalArgumentException - thrown if parameters fail the validation.
      com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
      RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
    • delete

      void delete(String resourceGroupName, String clusterName, String databaseName)
      Deletes the database with the given name.
      Parameters:
      resourceGroupName - The name of the resource group containing the Kusto cluster.
      clusterName - The name of the Kusto cluster.
      databaseName - The name of the database in the Kusto cluster.
      Throws:
      IllegalArgumentException - thrown if parameters fail the validation.
      com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
      RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
    • delete

      void delete(String resourceGroupName, String clusterName, String databaseName, com.azure.core.util.Context context)
      Deletes the database with the given name.
      Parameters:
      resourceGroupName - The name of the resource group containing the Kusto cluster.
      clusterName - The name of the Kusto cluster.
      databaseName - The name of the database in the Kusto cluster.
      context - The context to associate with this operation.
      Throws:
      IllegalArgumentException - thrown if parameters fail the validation.
      com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
      RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
    • listPrincipals

      com.azure.core.http.rest.PagedIterable<DatabasePrincipal> listPrincipals(String resourceGroupName, String clusterName, String databaseName)
      Returns a list of database principals of the given Kusto cluster and database.
      Parameters:
      resourceGroupName - The name of the resource group containing the Kusto cluster.
      clusterName - The name of the Kusto cluster.
      databaseName - The name of the database in the Kusto cluster.
      Returns:
      the list Kusto database principals operation response as paginated response with PagedIterable.
      Throws:
      IllegalArgumentException - thrown if parameters fail the validation.
      com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
      RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
    • listPrincipals

      com.azure.core.http.rest.PagedIterable<DatabasePrincipal> listPrincipals(String resourceGroupName, String clusterName, String databaseName, com.azure.core.util.Context context)
      Returns a list of database principals of the given Kusto cluster and database.
      Parameters:
      resourceGroupName - The name of the resource group containing the Kusto cluster.
      clusterName - The name of the Kusto cluster.
      databaseName - The name of the database in the Kusto cluster.
      context - The context to associate with this operation.
      Returns:
      the list Kusto database principals operation response as paginated response with PagedIterable.
      Throws:
      IllegalArgumentException - thrown if parameters fail the validation.
      com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
      RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
    • addPrincipals

      DatabasePrincipalListResult addPrincipals(String resourceGroupName, String clusterName, String databaseName, DatabasePrincipalListRequest databasePrincipalsToAdd)
      Add Database principals permissions.
      Parameters:
      resourceGroupName - The name of the resource group containing the Kusto cluster.
      clusterName - The name of the Kusto cluster.
      databaseName - The name of the database in the Kusto cluster.
      databasePrincipalsToAdd - List of database principals to add.
      Returns:
      the list Kusto database principals operation response.
      Throws:
      IllegalArgumentException - thrown if parameters fail the validation.
      com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
      RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
    • addPrincipalsWithResponse

      com.azure.core.http.rest.Response<DatabasePrincipalListResult> addPrincipalsWithResponse(String resourceGroupName, String clusterName, String databaseName, DatabasePrincipalListRequest databasePrincipalsToAdd, com.azure.core.util.Context context)
      Add Database principals permissions.
      Parameters:
      resourceGroupName - The name of the resource group containing the Kusto cluster.
      clusterName - The name of the Kusto cluster.
      databaseName - The name of the database in the Kusto cluster.
      databasePrincipalsToAdd - List of database principals to add.
      context - The context to associate with this operation.
      Returns:
      the list Kusto database principals operation response along with Response.
      Throws:
      IllegalArgumentException - thrown if parameters fail the validation.
      com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
      RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
    • removePrincipals

      DatabasePrincipalListResult removePrincipals(String resourceGroupName, String clusterName, String databaseName, DatabasePrincipalListRequest databasePrincipalsToRemove)
      Remove Database principals permissions.
      Parameters:
      resourceGroupName - The name of the resource group containing the Kusto cluster.
      clusterName - The name of the Kusto cluster.
      databaseName - The name of the database in the Kusto cluster.
      databasePrincipalsToRemove - List of database principals to remove.
      Returns:
      the list Kusto database principals operation response.
      Throws:
      IllegalArgumentException - thrown if parameters fail the validation.
      com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
      RuntimeException - all other wrapped checked exceptions if the request fails to be sent.
    • removePrincipalsWithResponse

      com.azure.core.http.rest.Response<DatabasePrincipalListResult> removePrincipalsWithResponse(String resourceGroupName, String clusterName, String databaseName, DatabasePrincipalListRequest databasePrincipalsToRemove, com.azure.core.util.Context context)
      Remove Database principals permissions.
      Parameters:
      resourceGroupName - The name of the resource group containing the Kusto cluster.
      clusterName - The name of the Kusto cluster.
      databaseName - The name of the database in the Kusto cluster.
      databasePrincipalsToRemove - List of database principals to remove.
      context - The context to associate with this operation.
      Returns:
      the list Kusto database principals operation response along with Response.
      Throws:
      IllegalArgumentException - thrown if parameters fail the validation.
      com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
      RuntimeException - all other wrapped checked exceptions if the request fails to be sent.