@canonical/jujulib/dist/api/facades/model-manager/ModelManagerV5.d.ts

Juju API client

/**
  Juju ModelManager version 5.
  This facade is available on:
    Controller-machine-agent
    Machine-agent
    Unit-agent
    Controllers

  NOTE: This file was generated using the Juju schema
  from Juju 2.9-rc3 at the git SHA cb361902f8.
  Do not manually edit this file.
*/
import { ConnectionInfo, Transport } from "../../client.js";
import { Facade } from "../../types.js";
export interface ChangeModelCredentialParams {
    "credential-tag": string;
    "model-tag": string;
}
export interface ChangeModelCredentialsParams {
    "model-credentials": ChangeModelCredentialParams[];
}
export interface DestroyModelParams {
    "destroy-storage"?: boolean;
    force?: boolean;
    "max-wait"?: number;
    "model-tag": string;
}
export interface DestroyModelsParams {
    models: DestroyModelParams[];
}
export interface DumpModelRequest {
    entities: Entity[];
    simplified: boolean;
}
export interface Entities {
    entities: Entity[];
}
export interface Entity {
    tag: string;
}
export interface EntityStatus {
    data?: AdditionalProperties;
    info: string;
    since: string;
    status: string;
}
export interface Error {
    code: string;
    info?: AdditionalProperties;
    message: string;
}
export interface ErrorResult {
    error?: Error;
}
export interface ErrorResults {
    results: ErrorResult[];
}
export interface MachineHardware {
    arch?: string;
    "availability-zone"?: string;
    cores?: number;
    "cpu-power"?: number;
    mem?: number;
    "root-disk"?: number;
    tags?: string[];
}
export interface MapResult {
    error?: Error;
    result: AdditionalProperties;
}
export interface MapResults {
    results: MapResult[];
}
export interface Model {
    name: string;
    "owner-tag": string;
    type: string;
    uuid: string;
}
export interface ModelCreateArgs {
    "cloud-tag"?: string;
    config?: AdditionalProperties;
    credential?: string;
    name: string;
    "owner-tag": string;
    region?: string;
}
export interface ModelDefaultValues {
    "cloud-region"?: string;
    "cloud-tag"?: string;
    config: AdditionalProperties;
}
export interface ModelDefaults {
    controller?: AdditionalProperties;
    default?: AdditionalProperties;
    regions?: RegionDefaults[];
}
export interface ModelDefaultsResult {
    config: Record<string, ModelDefaults>;
    error?: Error;
}
export interface ModelEntityCount {
    count: number;
    entity: string;
}
export interface ModelFilesystemInfo {
    detachable?: boolean;
    id: string;
    message?: string;
    "provider-id"?: string;
    status?: string;
}
export interface ModelInfo {
    "agent-version": string;
    "cloud-credential-tag"?: string;
    "cloud-credential-validity"?: boolean;
    "cloud-region"?: string;
    "cloud-tag": string;
    "controller-uuid": string;
    "default-series"?: string;
    "is-controller": boolean;
    life: string;
    machines: ModelMachineInfo[];
    migration?: ModelMigrationStatus;
    name: string;
    "owner-tag": string;
    "provider-type"?: string;
    sla: ModelSLAInfo;
    status?: EntityStatus;
    type: string;
    users: ModelUserInfo[];
    uuid: string;
}
export interface ModelInfoResult {
    error?: Error;
    result?: ModelInfo;
}
export interface ModelInfoResults {
    results: ModelInfoResult[];
}
export interface ModelMachineInfo {
    "display-name"?: string;
    "ha-primary"?: boolean;
    hardware?: MachineHardware;
    "has-vote"?: boolean;
    id: string;
    "instance-id"?: string;
    message?: string;
    status?: string;
    "wants-vote"?: boolean;
}
export interface ModelMigrationStatus {
    end?: string;
    start: string;
    status: string;
}
export interface ModelSLAInfo {
    level: string;
    owner: string;
}
export interface ModelStatus {
    "application-count": number;
    error?: Error;
    filesystems?: ModelFilesystemInfo[];
    "hosted-machine-count": number;
    life: string;
    machines?: ModelMachineInfo[];
    "model-tag": string;
    "owner-tag": string;
    type: string;
    "unit-count": number;
    volumes?: ModelVolumeInfo[];
}
export interface ModelStatusResults {
    models: ModelStatus[];
}
export interface ModelSummariesRequest {
    all?: boolean;
    "user-tag": string;
}
export interface ModelSummary {
    "agent-version": string;
    "cloud-credential-tag"?: string;
    "cloud-region"?: string;
    "cloud-tag": string;
    "controller-uuid": string;
    counts: ModelEntityCount[];
    "default-series"?: string;
    "is-controller": boolean;
    "last-connection": string;
    life: string;
    migration?: ModelMigrationStatus;
    name: string;
    "owner-tag": string;
    "provider-type"?: string;
    sla: ModelSLAInfo;
    status?: EntityStatus;
    type: string;
    "user-access": string;
    uuid: string;
}
export interface ModelSummaryResult {
    error?: Error;
    result?: ModelSummary;
}
export interface ModelSummaryResults {
    results: ModelSummaryResult[];
}
export interface ModelUnsetKeys {
    "cloud-region"?: string;
    "cloud-tag"?: string;
    keys: string[];
}
export interface ModelUserInfo {
    access: string;
    "display-name": string;
    "last-connection": string;
    user: string;
}
export interface ModelVolumeInfo {
    detachable?: boolean;
    id: string;
    message?: string;
    "provider-id"?: string;
    status?: string;
}
export interface ModifyModelAccess {
    access: string;
    action: string;
    "model-tag": string;
    "user-tag": string;
}
export interface ModifyModelAccessRequest {
    changes: ModifyModelAccess[];
}
export interface Number {
    Build: number;
    Major: number;
    Minor: number;
    Patch: number;
    Tag: string;
}
export interface RegionDefaults {
    "region-name": string;
    value: AdditionalProperties;
}
export interface SetModelDefaults {
    config: ModelDefaultValues[];
}
export interface StringResult {
    error?: Error;
    result: string;
}
export interface StringResults {
    results: StringResult[];
}
export interface UnsetModelDefaults {
    keys: ModelUnsetKeys[];
}
export interface UserModel {
    "last-connection": string;
    model: Model;
}
export interface UserModelList {
    "user-models": UserModel[];
}
export interface ValidateModelUpgradeParam {
    "model-tag": string;
}
export interface ValidateModelUpgradeParams {
    force: boolean;
    model: ValidateModelUpgradeParam[];
}
export interface AdditionalProperties {
    [key: string]: any;
}
/**
  ModelManagerAPIV5 provides a way to wrap the different calls between
  version 5 and version 6 of the model manager API
*/
declare class ModelManagerV5 implements Facade {
    static NAME: string;
    static VERSION: number;
    NAME: string;
    VERSION: number;
    _transport: Transport;
    _info: ConnectionInfo;
    constructor(transport: Transport, info: ConnectionInfo);
    /**
      ChangeModelCredential changes cloud credential reference for models.
      These new cloud credentials must already exist on the controller.
    */
    changeModelCredential(params: ChangeModelCredentialsParams): Promise<ErrorResults>;
    /**
      CreateModel creates a new model using the account and
      model config specified in the args.
    */
    createModel(params: ModelCreateArgs): Promise<ModelInfo>;
    /**
      DestroyModels will try to destroy the specified models.
      If there is a block on destruction, this method will return an error.
      From ModelManager v7 onwards, DestroyModels gains 'force' and 'max-wait' parameters.
    */
    destroyModels(params: DestroyModelsParams): Promise<ErrorResults>;
    /**
      DumpModels will export the models into the database agnostic
      representation. The user needs to either be a controller admin, or have
      admin privileges on the model itself.
    */
    dumpModels(params: DumpModelRequest): Promise<StringResults>;
    /**
      DumpModelsDB will gather all documents from all model collections
      for the specified model. The map result contains a map of collection
      names to lists of documents represented as maps.
    */
    dumpModelsDB(params: Entities): Promise<MapResults>;
    /**
      ListModelSummaries returns models that the specified user
      has access to in the current server.  Controller admins (superuser)
      can list models for any user.  Other users
      can only ask about their own models.
    */
    listModelSummaries(params: ModelSummariesRequest): Promise<ModelSummaryResults>;
    /**
      ListModels returns the models that the specified user
      has access to in the current server.  Controller admins (superuser)
      can list models for any user.  Other users
      can only ask about their own models.
    */
    listModels(params: Entity): Promise<UserModelList>;
    /**
      ModelDefaults returns the default config values used when creating a new model.
    */
    modelDefaults(params: any): Promise<ModelDefaultsResult>;
    /**
      ModelInfo returns information about the specified models.
    */
    modelInfo(params: Entities): Promise<ModelInfoResults>;
    /**
      ModelStatus returns a summary of the model.
    */
    modelStatus(params: Entities): Promise<ModelStatusResults>;
    /**
      ModifyModelAccess changes the model access granted to users.
    */
    modifyModelAccess(params: ModifyModelAccessRequest): Promise<ErrorResults>;
    /**
      SetModelDefaults writes new values for the specified default model settings.
    */
    setModelDefaults(params: SetModelDefaults): Promise<ErrorResults>;
    /**
      UnsetModelDefaults removes the specified default model settings.
    */
    unsetModelDefaults(params: UnsetModelDefaults): Promise<ErrorResults>;
    /**
      ValidateModelUpgrades validates if a model is allowed to perform an upgrade.
      Examples of why you would want to block a model upgrade, would be situations
      like upgrade-series. If performing an upgrade-series we don't know the
      current status of the machine, so performing an upgrade-model can lead to
      bad unintended errors down the line.
    */
    validateModelUpgrades(params: ValidateModelUpgradeParams): Promise<ErrorResults>;
}
export default ModelManagerV5;