azure-devops-extension-api 4.252.0 → 4.254.0

package/Management/Management.d.ts

@@ -130,6 +130,69 @@ export interface BilledCommitter {
      */
     userIdentity: WebApi.IdentityRef;
 }
+/**
+ * A list of billed committers
+ */
+export interface BilledCommittersList {
+    /**
+     * A list of BilledCommitter objects that contain the identityRef of committers.
+     */
+    billedUsers: BilledCommitter[];
+    /**
+     * Count of billed committers in BilledUsers
+     */
+    uniqueCommitterCount: number;
+}
+export interface CodeScanningFeatures {
+    /**
+     * CodeQL enablement status set to False when disabled and True when enabled; Null is never explicitly set.
+     */
+    codeQLEnabled: boolean;
+    /**
+     * Dependabot enablement status set to False when disabled and True when enabled; Null is never explicitly set. \<br /\>When true, Dependabot will open PRs to support security updates for outdated dependencies. \<br /\>Setting Dependabot enablement state is only supported for repo enablement and not org or project enablement at this time.
+     */
+    dependabotEnabled: boolean;
+    /**
+     * Dependency Scanning Injection enablement status set to False when disabled and True when enabled; Null is never explicitly set. \<br /\> If Advanced Security is NOT already enabled, behavior will depend on if Advanced Security is to be enabled/disabled. DependencyScanningInjectionEnabled will not affect anything in this scenario. \<br /\> If Advanced Security is to be disabled, the value of DependencyScanningInjectionEnabled will have no effect. \<br /\> Setting Dependency Scanning enablement state is only supported for repo enablement and not org or project enablement at this time.
+     */
+    dependencyScanningInjectionEnabled: boolean;
+}
+export interface EnablementOnCreateSettings {
+    /**
+     * Automatically enable Code Scanning on newly created repositories.
+     */
+    enableCodeScanningOnCreate: boolean;
+    /**
+     * Automatically enable Secret Scanning on newly created repositories.
+     */
+    enableSecretScanningOnCreate: boolean;
+}
+export interface EnablementSettings {
+    /**
+     * Code Scan enablement status set to False when disabled and True when enabled; Null is never explicitly set.
+     */
+    codeScanningEnabled: boolean;
+    /**
+     * Includes code scanning features that can be enabled.
+     */
+    codeScanningFeatures: CodeScanningFeatures;
+    /**
+     * Auto enablement setting for newly created repositories.
+     */
+    enablementOnCreateSettings: EnablementOnCreateSettings;
+    /**
+     * A list of enablement statuses for repositories within the specified organization or project.
+     */
+    reposEnablementStatus: RepoEnablementSettings[];
+    /**
+     * Secret Scan enablement status set to False when disabled and True when enabled; Null is never explicitly set.
+     */
+    secretScanningEnabled: boolean;
+    /**
+     * Includes secret scanning features that can be enabled.
+     */
+    secretScanningFeatures: SecretScanningFeatures;
+}
 /**
  * Information related to billing for Advanced Security services
  */
@@ -168,3 +231,104 @@ export interface MeterUsage {
      */
     uniqueCommitterCount: number;
 }
+/**
+ * Information related to meter usage estimate for Code Scanning and Secret Scanning
+ */
+export interface MeterUsageEstimate {
+    /**
+     * Meter usage estimate when enabling Code Scanning
+     */
+    codeScanningMeterUsageEstimate: BilledCommittersList;
+    /**
+     * Meter usage estimate when enabling Secret Scanning
+     */
+    secretScanningMeterUsageEstimate: BilledCommittersList;
+}
+/**
+ * Information related to meter usage for a Scanning plan
+ */
+export interface MeterUsageForPlan {
+    /**
+     * The Azure DevOps account
+     */
+    accountId: string;
+    azureSubscriptionId: string;
+    /**
+     * The identityRef of committers that contributed to repositories with Scanning plan enabled
+     */
+    billedUsers: BilledCommittersList;
+    /**
+     * The date this billing information pertains to
+     */
+    billingDate: Date;
+    /**
+     * True when the Scanning plan is enabled in this organization
+     */
+    isPlanEnabled: boolean;
+    /**
+     * The Azure subscription
+     */
+    tenantId: string;
+}
+export interface OrgEnablementSettings extends EnablementSettings {
+}
+export declare enum Plan {
+    /**
+     * The Code Security plan
+     */
+    CodeSecurity = 0,
+    /**
+     * The Secret Protection plan
+     */
+    SecretProtection = 1
+}
+export interface ProjectEnablementSettings extends EnablementSettings {
+}
+export interface RepoEnablementSettings {
+    /**
+     * Code Scan enablement status set to False when disabled and True when enabled; Null is never explicitly set.
+     */
+    codeScanningEnabled: boolean;
+    /**
+     * The last time the status of Code Scanning for this repository was updated
+     */
+    codeScanningEnablementLastChangedDate: Date;
+    /**
+     * Includes code scanning features that can be enabled.
+     */
+    codeScanningFeatures: CodeScanningFeatures;
+    /**
+     * Indicates whether the repository is part of the bundled SKU (old billing plan) or unbundled SKUs (new billing plan).
+     */
+    isBundledSKU: boolean;
+    /**
+     * The project Id
+     */
+    projectId: string;
+    /**
+     * The repository Id
+     */
+    repositoryId: string;
+    /**
+     * Secret Scan enablement status set to False when disabled and True when enabled; Null is never explicitly set.
+     */
+    secretScanningEnabled: boolean;
+    /**
+     * The last time the status of Secret Scanning for this repository was updated
+     */
+    secretScanningEnablementLastChangedDate: Date;
+    /**
+     * Includes secret scanning features that can be enabled.
+     */
+    secretScanningFeatures: SecretScanningFeatures;
+}
+export interface SecretScanningFeatures {
+    /**
+     * When true, pushes containing secrets will be blocked. \<br /\>When false, pushes are scanned for secrets and are not blocked. \<br /\>If includeAllProperties in the request is false, this value will be null.
+     */
+    blockPushes: boolean;
+    /**
+     * ForceRepoSecretScanning will be set to true when Enabled, false when Disabled, and null when not set. \<br /\> If GHAzDO is NOT already enabled, behavior will depend on if GHAzDO is to be enabled/disabled. ForceRepoSecretScanning will not affect anything in this scenario. \<br /\> If GHAzDO is to be disabled, the value of ForceRepoSecretScan will have no effect. \<br /\> If GHAzDO is to be enabled for the first time on a repo, then ForceRepoSecretScanning will have no effect. \<br /\> If GHAzDO is to be enabled and the repo is already enabled, then ForceRepoSecretScanning will force the secret scanning job to be run if it is set to true. \<br /\> In all cases where ForceRepoSecretScanning is not expected to affect behavior, it will be set to false before being sent to Tfs.
+     */
+    forceRepoSecretScanning: boolean;
+}

package/Management/Management.js

@@ -6,4 +6,15 @@
 define(["require", "exports"], function (require, exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
+    var Plan;
+    (function (Plan) {
+        /**
+         * The Code Security plan
+         */
+        Plan[Plan["CodeSecurity"] = 0] = "CodeSecurity";
+        /**
+         * The Secret Protection plan
+         */
+        Plan[Plan["SecretProtection"] = 1] = "SecretProtection";
+    })(Plan = exports.Plan || (exports.Plan = {}));
 });

package/Management/Management.min.js

@@ -1 +1 @@
-define(["require","exports"],function(e,r){"use strict";Object.defineProperty(r,"__esModule",{value:!0})});
+define(["require","exports"],function(e,t){"use strict";Object.defineProperty(t,"__esModule",{value:!0});!function(e){e[e.CodeSecurity=0]="CodeSecurity",e[e.SecretProtection=1]="SecretProtection"}(t.Plan||(t.Plan={}))});

package/Management/ManagementClient.d.ts

@@ -3,6 +3,22 @@ import { RestClientBase } from "../Common/RestClientBase";
 import * as Management from "../Management/Management";
 export declare class ManagementRestClient extends RestClientBase {
     constructor(options: IVssRestClientOptions);
+    /**
+     * Determine if Advanced Security is enabled for a repository
+     *
+     * @param project - Project ID or project name
+     * @param repository - The name or ID of the repository
+     * @param includeAllProperties - When true, will also determine if pushes are blocked when secrets are detected
+     */
+    getRepoEnablementStatus2(project: string, repository: string, includeAllProperties?: boolean): Promise<Management.RepoEnablementSettings>;
+    /**
+     * Update the enablement of Advanced Security for a repository
+     *
+     * @param savedAdvSecEnablementStatus - new status
+     * @param project - Project ID or project name
+     * @param repository - Name or ID of the repository
+     */
+    updateRepoAdvSecEnablementStatus2(savedAdvSecEnablementStatus: Management.RepoEnablementSettings, project: string, repository: string): Promise<void>;
     /**
      * During multi-org billing computation in primary scale unit(EUS21), this API is used to create billing snapshot for a specific org. Primary scale unit will call this API for each org in different scsle units to create billing snapshot. Data will be stored in the org specific partition DB -\> billing snapshot table. This is needed as customers will fetch billing data from their org specific partition DB.
      *
@@ -24,6 +40,31 @@ export declare class ManagementRestClient extends RestClientBase {
      * @param billingDate - The date to query, or if not provided, today
      */
     getMeterUsage(billingDate?: Date): Promise<Management.MeterUsage>;
+    /**
+     * During multi-org billing computation in primary scale unit(EUS21), this API is used to create billing snapshot for a specific org. Primary scale unit will call this API for each org in different scsle units to create billing snapshot. Data will be stored in the org specific partition DB -\> billing snapshot table. This is needed as customers will fetch billing data from their org specific partition DB.
+     *
+     * @param meterUsage -
+     * @param plan -
+     */
+    createBillingSnapshot2(meterUsage: Management.MeterUsageForPlan, plan: Management.Plan): Promise<void>;
+    /**
+     * Get all billable committers details, including those not matched with a VSID.
+     *
+     * @param plan - The plan to query. Plans supported: CodeSecurity and SecretProtection. This is a mandatory parameter.
+     * @param billingDate - The date to query, or if not provided, today
+     */
+    getBillableCommitterDetails2(plan: Management.Plan, billingDate?: Date): Promise<Management.BillableCommitterDetails[]>;
+    /**
+     * @param plan -
+     */
+    getLastMeterUsage2(plan: Management.Plan): Promise<Management.MeterUsageForPlan>;
+    /**
+     * Get commiters used when calculating billing information.
+     *
+     * @param plan - The plan to query. Plans supported: CodeSecurity and SecretProtection. This is a mandatory parameter.
+     * @param billingDate - The date to query, or if not provided, today
+     */
+    getMeterUsage2(plan: Management.Plan, billingDate?: Date): Promise<Management.MeterUsageForPlan>;
     /**
      * Get the current status of Advanced Security for the organization
      *
@@ -36,6 +77,18 @@ export declare class ManagementRestClient extends RestClientBase {
      * @param savedAdvSecEnablementStatus - The new status
      */
     updateOrgEnablementStatus(savedAdvSecEnablementStatus: Management.AdvSecEnablementSettingsUpdate): Promise<void>;
+    /**
+     * Get the current status of Advanced Security for the organization
+     *
+     * @param includeAllProperties - When true, also determine if pushes are blocked if they contain secrets
+     */
+    getOrgEnablementStatus2(includeAllProperties?: boolean): Promise<Management.OrgEnablementSettings>;
+    /**
+     * Update the status of Advanced Security for the organization
+     *
+     * @param savedAdvSecEnablementStatus - The new status
+     */
+    updateOrgEnablementStatus2(savedAdvSecEnablementStatus: Management.OrgEnablementSettings): Promise<void>;
     /**
      * Estimate the pushers that would be added to the customer's usage if Advanced Security was enabled for this organization.
      *
@@ -46,6 +99,16 @@ export declare class ManagementRestClient extends RestClientBase {
      *
      */
     getEstimatedOrgBillablePushers(): Promise<string[]>;
+    /**
+     * Estimate the pushers that would be added to the customer's usage if Advanced Security was enabled for this organization.
+     *
+     */
+    getEstimatedBillablePushersDetailsForOrg2(): Promise<Management.MeterUsageEstimate>;
+    /**
+     * Estimate the committers that would be added to the customer's usage if Advanced Security was enabled for this organization.
+     *
+     */
+    getEstimatedOrgBillablePushers2(): Promise<string[]>;
     /**
      * Get the current status of Advanced Security for a project
      *
@@ -60,6 +123,20 @@ export declare class ManagementRestClient extends RestClientBase {
      * @param project - Project ID or project name
      */
     updateProjectEnablementStatus(savedAdvSecEnablementStatus: Management.AdvSecEnablementSettingsUpdate, project: string): Promise<void>;
+    /**
+     * Get the current status of Advanced Security for a project
+     *
+     * @param project - Project ID or project name
+     * @param includeAllProperties - When true, also determine if pushes are blocked if they contain secrets
+     */
+    getProjectEnablementStatus2(project: string, includeAllProperties?: boolean): Promise<Management.ProjectEnablementSettings>;
+    /**
+     * Update the status of Advanced Security for the project
+     *
+     * @param savedAdvSecEnablementStatus - The new status
+     * @param project - Project ID or project name
+     */
+    updateProjectEnablementStatus2(savedAdvSecEnablementStatus: Management.ProjectEnablementSettings, project: string): Promise<void>;
     /**
      * Estimate the pushers that would be added to the customer's usage if Advanced Security was enabled for this project.
      *
@@ -72,6 +149,18 @@ export declare class ManagementRestClient extends RestClientBase {
      * @param project - Project ID or project name
      */
     getEstimatedProjectBillablePushers(project: string): Promise<string[]>;
+    /**
+     * Estimate the pushers that would be added to the customer's usage if Advanced Security was enabled for this project.
+     *
+     * @param project - Project ID or project name
+     */
+    getEstimatedBillablePushersDetailsForProject2(project: string): Promise<Management.MeterUsageEstimate>;
+    /**
+     * Estimate the number of committers that would be added to the customer's usage if Advanced Security was enabled for this project.
+     *
+     * @param project - Project ID or project name
+     */
+    getEstimatedProjectBillablePushers2(project: string): Promise<string[]>;
     /**
      * Determine if Advanced Security is enabled for a repository
      *
@@ -102,4 +191,18 @@ export declare class ManagementRestClient extends RestClientBase {
      * @param repository -
      */
     getEstimatedRepoBillablePushersDetails(project: string, repository: string): Promise<Management.BilledCommitter[]>;
+    /**
+     * Estimate the committers that would be added to the customer's usage if Advanced Security was enabled for this repository.
+     *
+     * @param project - Project ID or project name
+     * @param repository - The name or ID of the repository
+     */
+    getEstimatedRepoBillableCommitters2(project: string, repository: string): Promise<string[]>;
+    /**
+     * Estimate the pushers that would be added to the customer's usage if Advanced Security was enabled for this repository.
+     *
+     * @param project - Project ID or project name
+     * @param repository -
+     */
+    getEstimatedRepoBillableCommittersDetails2(project: string, repository: string): Promise<Management.MeterUsageEstimate>;
 }