azure-devops-extension-api 4.248.0 → 4.250.0

package/src/Pipelines/Pipelines.ts

@@ -1,354 +0,0 @@
-/*
- * ---------------------------------------------------------
- * Copyright(C) Microsoft Corporation. All rights reserved.
- * ---------------------------------------------------------
- */
-
-import * as WebApi from "../WebApi/WebApi";
-
-/**
- * Artifacts are collections of files produced by a pipeline. Use artifacts to share files between stages in a pipeline or between different pipelines.
- */
-export interface Artifact {
-    /**
-     * The name of the artifact.
-     */
-    name: string;
-    /**
-     * Signed url for downloading this artifact
-     */
-    signedContent: WebApi.SignedUrl;
-    /**
-     * Self-referential url
-     */
-    url: string;
-}
-
-export interface Build {
-    artifactSourceVersionUrl: string;
-    type: string;
-    versionId: string;
-    versionName: string;
-}
-
-export interface BuildResourceParameters {
-    version: string;
-}
-
-export enum ConfigurationType {
-    /**
-     * Unknown type.
-     */
-    Unknown = 0,
-    /**
-     * YAML.
-     */
-    Yaml = 1,
-    /**
-     * Designer JSON.
-     */
-    DesignerJson = 2,
-    /**
-     * Just-in-time.
-     */
-    JustInTime = 3,
-    /**
-     * Designer-JSON.
-     */
-    DesignerHyphenJson = 2
-}
-
-export interface Container {
-    environment: { [key: string] : string; };
-    image: string;
-    mapDockerSocket: boolean;
-    options: string;
-    ports: string[];
-    volumes: string[];
-}
-
-export interface ContainerResource {
-    container: Container;
-}
-
-export interface ContainerResourceParameters {
-    version: string;
-}
-
-/**
- * Configuration parameters of the pipeline.
- */
-export interface CreatePipelineConfigurationParameters {
-    /**
-     * Type of configuration.
-     */
-    type: ConfigurationType;
-}
-
-/**
- * Parameters to create a pipeline.
- */
-export interface CreatePipelineParameters {
-    /**
-     * Configuration parameters of the pipeline.
-     */
-    configuration: CreatePipelineConfigurationParameters;
-    /**
-     * Folder of the pipeline.
-     */
-    folder: string;
-    /**
-     * Name of the pipeline.
-     */
-    name: string;
-}
-
-/**
- * Expansion options for GetArtifact and ListArtifacts.
- */
-export enum GetArtifactExpandOptions {
-    /**
-     * No expansion.
-     */
-    None = 0,
-    /**
-     * Include signed content.
-     */
-    SignedContent = 1
-}
-
-/**
- * $expand options for GetLog and ListLogs.
- */
-export enum GetLogExpandOptions {
-    None = 0,
-    SignedContent = 1
-}
-
-/**
- * Log for a pipeline.
- */
-export interface Log {
-    /**
-     * The date and time the log was created.
-     */
-    createdOn: Date;
-    /**
-     * The ID of the log.
-     */
-    id: number;
-    /**
-     * The date and time the log was last changed.
-     */
-    lastChangedOn: Date;
-    /**
-     * The number of lines in the log.
-     */
-    lineCount: number;
-    signedContent: WebApi.SignedUrl;
-    url: string;
-}
-
-/**
- * A collection of logs.
- */
-export interface LogCollection {
-    /**
-     * The list of logs.
-     */
-    logs: Log[];
-    signedContent: WebApi.SignedUrl;
-    /**
-     * URL of the log.
-     */
-    url: string;
-}
-
-export interface PackageResourceParameters {
-    version: string;
-}
-
-/**
- * Definition of a pipeline.
- */
-export interface Pipeline extends PipelineBase {
-    _links: any;
-    configuration: PipelineConfiguration;
-    /**
-     * URL of the pipeline
-     */
-    url: string;
-}
-
-export interface PipelineBase {
-    /**
-     * Pipeline folder
-     */
-    folder: string;
-    /**
-     * Pipeline ID
-     */
-    id: number;
-    /**
-     * Pipeline name
-     */
-    name: string;
-    /**
-     * Revision number
-     */
-    revision: number;
-}
-
-export interface PipelineConfiguration {
-    type: ConfigurationType;
-}
-
-/**
- * A reference to a Pipeline.
- */
-export interface PipelineReference extends PipelineBase {
-    url: string;
-}
-
-export interface PipelineResource {
-    pipeline: PipelineReference;
-    version: string;
-}
-
-export interface PipelineResourceParameters {
-    runId: number;
-    version: string;
-}
-
-export interface PreviewRun {
-    finalYaml: string;
-}
-
-export interface Repository {
-    type: RepositoryType;
-}
-
-export interface RepositoryResource {
-    refName: string;
-    repository: Repository;
-    version: string;
-}
-
-export interface RepositoryResourceParameters {
-    refName: string;
-    /**
-     * This is the security token to use when connecting to the repository.
-     */
-    token: string;
-    /**
-     * Optional. This is the type of the token given. If not provided, a type of "Bearer" is assumed. Note: Use "Basic" for a PAT token.
-     */
-    tokenType: string;
-    version: string;
-}
-
-export enum RepositoryType {
-    Unknown = 0,
-    GitHub = 1,
-    AzureReposGit = 2,
-    GitHubEnterprise = 3,
-    AzureReposGitHyphenated = 2
-}
-
-export interface Run extends RunReference {
-    _links: any;
-    createdDate: Date;
-    finalYaml: string;
-    finishedDate: Date;
-    pipeline: PipelineReference;
-    resources: RunResources;
-    result: RunResult;
-    state: RunState;
-    templateParameters: { [key: string] : any; };
-    url: string;
-    variables: { [key: string] : Variable; };
-    yamlDetails: RunYamlDetails;
-}
-
-/**
- * Settings which influence pipeline runs.
- */
-export interface RunPipelineParameters {
-    /**
-     * If true, don't actually create a new run. Instead, return the final YAML document after parsing templates.
-     */
-    previewRun: boolean;
-    /**
-     * The resources the run requires.
-     */
-    resources: RunResourcesParameters;
-    stagesToSkip: string[];
-    templateParameters: { [key: string] : string; };
-    variables: { [key: string] : Variable; };
-    /**
-     * If you use the preview run option, you may optionally supply different YAML. This allows you to preview the final YAML document without committing a changed file.
-     */
-    yamlOverride: string;
-}
-
-export interface RunReference {
-    id: number;
-    name: string;
-}
-
-export interface RunResources {
-    builds: { [key: string] : Build; };
-    containers: { [key: string] : ContainerResource; };
-    pipelines: { [key: string] : PipelineResource; };
-    repositories: { [key: string] : RepositoryResource; };
-}
-
-export interface RunResourcesParameters {
-    builds: { [key: string] : BuildResourceParameters; };
-    containers: { [key: string] : ContainerResourceParameters; };
-    packages: { [key: string] : PackageResourceParameters; };
-    pipelines: { [key: string] : PipelineResourceParameters; };
-    repositories: { [key: string] : RepositoryResourceParameters; };
-}
-
-/**
- * This is not a Flags enum because we don't want to set multiple results on a build. However, when adding values, please stick to powers of 2 as if it were a Flags enum. This will make it easier to query multiple results.
- */
-export enum RunResult {
-    Unknown = 0,
-    Succeeded = 1,
-    Failed = 2,
-    Canceled = 4
-}
-
-/**
- * This is not a Flags enum because we don't want to set multiple states on a build. However, when adding values, please stick to powers of 2 as if it were a Flags enum. This will make it easier to query multiple states.
- */
-export enum RunState {
-    Unknown = 0,
-    InProgress = 1,
-    Canceling = 2,
-    Completed = 4
-}
-
-export interface RunYamlDetails {
-    expandedYamlUrl: string;
-    extendedTemplates: YamlFileDetails[];
-    includedTemplates: YamlFileDetails[];
-    rootYamlFile: YamlFileDetails;
-}
-
-export interface SignalRConnection {
-    signedContent: WebApi.SignedUrl;
-}
-
-export interface Variable {
-    isSecret: boolean;
-    value: string;
-}
-
-export interface YamlFileDetails {
-    ref: string;
-    repoAlias: string;
-    yamlFile: string;
-}

package/src/Pipelines/PipelinesClient.ts

@@ -1,306 +0,0 @@
-/*
- * ---------------------------------------------------------
- * Copyright(C) Microsoft Corporation. All rights reserved.
- * ---------------------------------------------------------
- */
-
-import { IVssRestClientOptions } from "../Common/Context";
-import { RestClientBase } from "../Common/RestClientBase";
-
-import * as Pipelines from "../Pipelines/Pipelines";
-
-export class PipelinesRestClient extends RestClientBase {
-    constructor(options: IVssRestClientOptions) {
-        super(options);
-    }
-
-    /**
-     * Get a specific artifact from a pipeline run
-     * 
-     * @param project - Project ID or project name
-     * @param pipelineId - ID of the pipeline.
-     * @param runId - ID of the run of that pipeline.
-     * @param artifactName - Name of the artifact.
-     * @param expand - Expand options. Default is None.
-     */
-    public async getArtifact(
-        project: string,
-        pipelineId: number,
-        runId: number,
-        artifactName: string,
-        expand?: Pipelines.GetArtifactExpandOptions
-        ): Promise<Pipelines.Artifact> {
-
-        const queryValues: any = {
-            artifactName: artifactName,
-            '$expand': expand
-        };
-
-        return this.beginRequest<Pipelines.Artifact>({
-            apiVersion: "7.2-preview.1",
-            routeTemplate: "{project}/_apis/pipelines/{pipelineId}/runs/{runId}/artifacts",
-            routeValues: {
-                project: project,
-                pipelineId: pipelineId,
-                runId: runId
-            },
-            queryParams: queryValues
-        });
-    }
-
-    /**
-     * Get a specific log from a pipeline run
-     * 
-     * @param project - Project ID or project name
-     * @param pipelineId - ID of the pipeline.
-     * @param runId - ID of the run of that pipeline.
-     * @param logId - ID of the log.
-     * @param expand - Expand options. Default is None.
-     */
-    public async getLog(
-        project: string,
-        pipelineId: number,
-        runId: number,
-        logId: number,
-        expand?: Pipelines.GetLogExpandOptions
-        ): Promise<Pipelines.Log> {
-
-        const queryValues: any = {
-            '$expand': expand
-        };
-
-        return this.beginRequest<Pipelines.Log>({
-            apiVersion: "7.2-preview.1",
-            routeTemplate: "{project}/_apis/pipelines/{pipelineId}/runs/{runId}/logs/{logId}",
-            routeValues: {
-                project: project,
-                pipelineId: pipelineId,
-                runId: runId,
-                logId: logId
-            },
-            queryParams: queryValues
-        });
-    }
-
-    /**
-     * Get a list of logs from a pipeline run.
-     * 
-     * @param project - Project ID or project name
-     * @param pipelineId - ID of the pipeline.
-     * @param runId - ID of the run of that pipeline.
-     * @param expand - Expand options. Default is None.
-     */
-    public async listLogs(
-        project: string,
-        pipelineId: number,
-        runId: number,
-        expand?: Pipelines.GetLogExpandOptions
-        ): Promise<Pipelines.LogCollection> {
-
-        const queryValues: any = {
-            '$expand': expand
-        };
-
-        return this.beginRequest<Pipelines.LogCollection>({
-            apiVersion: "7.2-preview.1",
-            routeTemplate: "{project}/_apis/pipelines/{pipelineId}/runs/{runId}/logs/{logId}",
-            routeValues: {
-                project: project,
-                pipelineId: pipelineId,
-                runId: runId
-            },
-            queryParams: queryValues
-        });
-    }
-
-    /**
-     * Create a pipeline.
-     * 
-     * @param inputParameters - Input parameters.
-     * @param project - Project ID or project name
-     */
-    public async createPipeline(
-        inputParameters: Pipelines.CreatePipelineParameters,
-        project: string
-        ): Promise<Pipelines.Pipeline> {
-
-        return this.beginRequest<Pipelines.Pipeline>({
-            apiVersion: "7.2-preview.1",
-            method: "POST",
-            routeTemplate: "{project}/_apis/pipelines/{pipelineId}",
-            routeValues: {
-                project: project
-            },
-            body: inputParameters
-        });
-    }
-
-    /**
-     * Gets a pipeline, optionally at the specified version
-     * 
-     * @param project - Project ID or project name
-     * @param pipelineId - The pipeline ID
-     * @param pipelineVersion - The pipeline version
-     */
-    public async getPipeline(
-        project: string,
-        pipelineId: number,
-        pipelineVersion?: number
-        ): Promise<Pipelines.Pipeline> {
-
-        const queryValues: any = {
-            pipelineVersion: pipelineVersion
-        };
-
-        return this.beginRequest<Pipelines.Pipeline>({
-            apiVersion: "7.2-preview.1",
-            routeTemplate: "{project}/_apis/pipelines/{pipelineId}",
-            routeValues: {
-                project: project,
-                pipelineId: pipelineId
-            },
-            queryParams: queryValues
-        });
-    }
-
-    /**
-     * Get a list of pipelines.
-     * 
-     * @param project - Project ID or project name
-     * @param orderBy - A sort expression. Defaults to "name asc"
-     * @param top - The maximum number of pipelines to return
-     * @param continuationToken - A continuation token from a previous request, to retrieve the next page of results
-     */
-    public async listPipelines(
-        project: string,
-        orderBy?: string,
-        top?: number,
-        continuationToken?: string
-        ): Promise<Pipelines.Pipeline[]> {
-
-        const queryValues: any = {
-            orderBy: orderBy,
-            '$top': top,
-            continuationToken: continuationToken
-        };
-
-        return this.beginRequest<Pipelines.Pipeline[]>({
-            apiVersion: "7.2-preview.1",
-            routeTemplate: "{project}/_apis/pipelines/{pipelineId}",
-            routeValues: {
-                project: project
-            },
-            queryParams: queryValues
-        });
-    }
-
-    /**
-     * Queues a dry run of the pipeline and returns an object containing the final yaml.
-     * 
-     * @param runParameters - Optional additional parameters for this run.
-     * @param project - Project ID or project name
-     * @param pipelineId - The pipeline ID.
-     * @param pipelineVersion - The pipeline version.
-     */
-    public async preview(
-        runParameters: Pipelines.RunPipelineParameters,
-        project: string,
-        pipelineId: number,
-        pipelineVersion?: number
-        ): Promise<Pipelines.PreviewRun> {
-
-        const queryValues: any = {
-            pipelineVersion: pipelineVersion
-        };
-
-        return this.beginRequest<Pipelines.PreviewRun>({
-            apiVersion: "7.2-preview.1",
-            method: "POST",
-            routeTemplate: "{project}/_apis/pipelines/{pipelineId}/preview",
-            routeValues: {
-                project: project,
-                pipelineId: pipelineId
-            },
-            queryParams: queryValues,
-            body: runParameters
-        });
-    }
-
-    /**
-     * Gets a run for a particular pipeline.
-     * 
-     * @param project - Project ID or project name
-     * @param pipelineId - The pipeline id
-     * @param runId - The run id
-     */
-    public async getRun(
-        project: string,
-        pipelineId: number,
-        runId: number
-        ): Promise<Pipelines.Run> {
-
-        return this.beginRequest<Pipelines.Run>({
-            apiVersion: "7.2-preview.1",
-            routeTemplate: "{project}/_apis/pipelines/{pipelineId}/runs/{runId}",
-            routeValues: {
-                project: project,
-                pipelineId: pipelineId,
-                runId: runId
-            }
-        });
-    }
-
-    /**
-     * Gets top 10000 runs for a particular pipeline.
-     * 
-     * @param project - Project ID or project name
-     * @param pipelineId - The pipeline id
-     */
-    public async listRuns(
-        project: string,
-        pipelineId: number
-        ): Promise<Pipelines.Run[]> {
-
-        return this.beginRequest<Pipelines.Run[]>({
-            apiVersion: "7.2-preview.1",
-            routeTemplate: "{project}/_apis/pipelines/{pipelineId}/runs/{runId}",
-            routeValues: {
-                project: project,
-                pipelineId: pipelineId
-            }
-        });
-    }
-
-    /**
-     * Runs a pipeline.
-     * 
-     * @param runParameters - Optional additional parameters for this run.
-     * @param project - Project ID or project name
-     * @param pipelineId - The pipeline ID.
-     * @param pipelineVersion - The pipeline version.
-     */
-    public async runPipeline(
-        runParameters: Pipelines.RunPipelineParameters,
-        project: string,
-        pipelineId: number,
-        pipelineVersion?: number
-        ): Promise<Pipelines.Run> {
-
-        const queryValues: any = {
-            pipelineVersion: pipelineVersion
-        };
-
-        return this.beginRequest<Pipelines.Run>({
-            apiVersion: "7.2-preview.1",
-            method: "POST",
-            routeTemplate: "{project}/_apis/pipelines/{pipelineId}/runs/{runId}",
-            routeValues: {
-                project: project,
-                pipelineId: pipelineId
-            },
-            queryParams: queryValues,
-            body: runParameters
-        });
-    }
-
-}