UNPKG

@pulumi/databricks

Version:

A Pulumi package for creating and managing databricks cloud resources.

128 lines (127 loc) 5.85 kB
import * as pulumi from "@pulumi/pulumi"; /** * This resource allows you to manage [MLflow experiments](https://docs.databricks.com/data/data-sources/mlflow-experiment.html) in Databricks. * * ## Example Usage * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as databricks from "@pulumi/databricks"; * * const me = databricks.getCurrentUser({}); * const _this = new databricks.MlflowExperiment("this", { * name: me.then(me => `${me.home}/Sample`), * artifactLocation: "dbfs:/tmp/my-experiment", * description: "My MLflow experiment description", * }); * ``` * * ## Access Control * * * databricks.Permissions can control which groups or individual users can *Read*, *Edit*, or *Manage* individual experiments. * * ## Related Resources * * The following resources are often used in the same context: * * * databricks.RegisteredModel to create [Models in Unity Catalog](https://docs.databricks.com/en/mlflow/models-in-uc.html) in Databricks. * * End to end workspace management guide. * * databricks.Directory to manage directories in [Databricks Workpace](https://docs.databricks.com/workspace/workspace-objects.html). * * databricks.MlflowModel to create models in the [workspace model registry](https://docs.databricks.com/en/mlflow/model-registry.html) in Databricks. * * databricks.Notebook to manage [Databricks Notebooks](https://docs.databricks.com/notebooks/index.html). * * databricks.Notebook data to export a notebook from Databricks Workspace. * * databricks.Repo to manage [Databricks Repos](https://docs.databricks.com/repos.html). * * ## Import * * The experiment resource can be imported using the id of the experiment * * bash * * ```sh * $ pulumi import databricks:index/mlflowExperiment:MlflowExperiment this <experiment-id> * ``` */ export declare class MlflowExperiment extends pulumi.CustomResource { /** * Get an existing MlflowExperiment resource's state with the given name, ID, and optional extra * properties used to qualify the lookup. * * @param name The _unique_ name of the resulting resource. * @param id The _unique_ provider ID of the resource to lookup. * @param state Any extra arguments used during the lookup. * @param opts Optional settings to control the behavior of the CustomResource. */ static get(name: string, id: pulumi.Input<pulumi.ID>, state?: MlflowExperimentState, opts?: pulumi.CustomResourceOptions): MlflowExperiment; /** * Returns true if the given object is an instance of MlflowExperiment. This is designed to work even * when multiple copies of the Pulumi SDK have been loaded into the same process. */ static isInstance(obj: any): obj is MlflowExperiment; /** * Path to dbfs:/ or s3:// artifact location of the MLflow experiment. */ readonly artifactLocation: pulumi.Output<string | undefined>; readonly creationTime: pulumi.Output<number>; /** * The description of the MLflow experiment. */ readonly description: pulumi.Output<string | undefined>; readonly experimentId: pulumi.Output<string>; readonly lastUpdateTime: pulumi.Output<number>; readonly lifecycleStage: pulumi.Output<string>; /** * Name of MLflow experiment. It must be an absolute path within the Databricks workspace, e.g. `/Users/<some-username>/my-experiment`. For more information about changes to experiment naming conventions, see [mlflow docs](https://docs.databricks.com/applications/mlflow/experiments.html#experiment-migration). */ readonly name: pulumi.Output<string>; /** * Create a MlflowExperiment resource with the given unique name, arguments, and options. * * @param name The _unique_ name of the resource. * @param args The arguments to use to populate this resource's properties. * @param opts A bag of options that control this resource's behavior. */ constructor(name: string, args?: MlflowExperimentArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering MlflowExperiment resources. */ export interface MlflowExperimentState { /** * Path to dbfs:/ or s3:// artifact location of the MLflow experiment. */ artifactLocation?: pulumi.Input<string>; creationTime?: pulumi.Input<number>; /** * The description of the MLflow experiment. */ description?: pulumi.Input<string>; experimentId?: pulumi.Input<string>; lastUpdateTime?: pulumi.Input<number>; lifecycleStage?: pulumi.Input<string>; /** * Name of MLflow experiment. It must be an absolute path within the Databricks workspace, e.g. `/Users/<some-username>/my-experiment`. For more information about changes to experiment naming conventions, see [mlflow docs](https://docs.databricks.com/applications/mlflow/experiments.html#experiment-migration). */ name?: pulumi.Input<string>; } /** * The set of arguments for constructing a MlflowExperiment resource. */ export interface MlflowExperimentArgs { /** * Path to dbfs:/ or s3:// artifact location of the MLflow experiment. */ artifactLocation?: pulumi.Input<string>; creationTime?: pulumi.Input<number>; /** * The description of the MLflow experiment. */ description?: pulumi.Input<string>; experimentId?: pulumi.Input<string>; lastUpdateTime?: pulumi.Input<number>; lifecycleStage?: pulumi.Input<string>; /** * Name of MLflow experiment. It must be an absolute path within the Databricks workspace, e.g. `/Users/<some-username>/my-experiment`. For more information about changes to experiment naming conventions, see [mlflow docs](https://docs.databricks.com/applications/mlflow/experiments.html#experiment-migration). */ name?: pulumi.Input<string>; }