AlertRestClient class

Classe de base qui doit être utilisée (dérivée de) pour effectuer des requêtes à des API REST VSS

Extends

Méthodes

autofixCallback(AutofixCallbackRequest, string, string, number)

Reçoit un rappel du pipeline autofix avec le résultat de la course. Idempotent : appels répétés pour une requête déjà en état terminal retournent 200 sans modifications.

createAutofixRequest(string, number, string)

Créez une demande d’autofixation pour l’alerte spécifiée.

createLegalReview(string, string, number, string)

Créez un examen juridique. Cela crée l’examen juridique associé à l’alerte. Il s’agit de l’URL de l’élément de travail de révision.

deleteAllPipelineAnalyses(string, string)

Supprime de manière réversible les données d’analyse pour tous les pipelines d’un référentiel, en supprimant les alertes Advanced Security associées.

deletePipelineAnalysis(string, string, number)

Supprime de manière réversible les données d’analyse d’un pipeline spécifique, en supprimant les alertes Advanced Security associées.

exportSarif(string, string, number[], string)

Exporter les alertes sous forme d’un seul fichier SARIF

getAlert(string, number, string, string, ExpandOption)

Obtenez une alerte.

getAlertInstances(string, number, string, string)

Obtenir des instances d’une alerte sur une branche spécifiée avec @ref. Si @ref n’est pas fourni, retournez des instances d’une alerte sur la branche par défaut (si l’alerte existe dans la branche par défaut) ou la branche affectée la plus récente.

getAlertMetadata(string, number, string)

Obtenez une alerte de métadonnées.

getAlertMetadataBatch(AlertMetadataBatchRequest, string, string)

Recevez des alertes, des métadonnées.

getAlerts(string, string, number, string, SearchCriteria, AlertListExpandOption, string)

Obtenir des alertes pour un référentiel

getAlertSarif(string, number, string, string, ExpandOption)

Obtenez une alerte.

getAlertsByIds(AlertBatchRequest, string, string)

Obtenir des alertes par ID d’alerte Prend actuellement en charge l’extraction d’alertes secrètes uniquement.

getAutofixRequestsByAlertId(string, number, string)

Obtenez toutes les demandes d’autofix pour l’alerte spécifiée.

getBranches(string, string, AlertType, string, string, number, boolean)

Retourne les branches pour lesquelles les résultats d’analyse ont été envoyés.

getOrgLevelAlertsByIds(number[])

Recevez des alertes par leur ID au niveau de l’organisation. Ne reprend que les alertes que l’utilisateur est autorisé à afficher. Renvoie uniquement les alertes des plans de référence SKU activés.

getSarif(number)

Obtenir l’état du travail de traitement Sarif

getUxFilters(string, string, AlertType)
getValidityData(string, string, number)

Obtenez les détails de validité d’une alerte.

initiateValidation(string, string, number)

Lancer le processus de validation d’une alerte donnée

updateAlert(AlertStateUpdate, string, number, string)

Mettre à jour l’état d’une alerte

updateAlertsMetadata(AlertMetadata[], string, string)

Mettez à jour les associations de métadonnées d’alerte.

uploadOrgSarif(string)

Télécharger un fichier Sarif au niveau de l’organisation

uploadSarif(string, string, string, String)

Charger un Sarif contenant des alertes de sécurité

uploadSarifToGitHub(string, string, string, string, string)

Téléverser un SARIF sur GitHub en scannant le code via une application GitOps.

Détails du constructeur

AlertRestClient(IVssRestClientOptions)

new AlertRestClient(options: IVssRestClientOptions)

Paramètres

Détails de la méthode

autofixCallback(AutofixCallbackRequest, string, string, number)

Reçoit un rappel du pipeline autofix avec le résultat de la course. Idempotent : appels répétés pour une requête déjà en état terminal retournent 200 sans modifications.

function autofixCallback(callbackRequest: AutofixCallbackRequest, project: string, repository: string, alertId: number): Promise<void>

Paramètres

callbackRequest
AutofixCallbackRequest

La charge utile de rappel contenant requestId, status, et pullRequestId optionnel.

project

string

ID de projet ou nom du projet

repository

string

Nom ou ID du référentiel.

alertId

number

L’identifiant de l’alerte pour créer une correction automatique.

Retours

Promise<void>

createAutofixRequest(string, number, string)

Créez une demande d’autofixation pour l’alerte spécifiée.

function createAutofixRequest(project: string, alertId: number, repository: string): Promise<AutofixRequest>

Paramètres

project

string

ID de projet ou nom du projet

alertId

number

L’identifiant de l’alerte pour créer une correction automatique.

repository

string

Nom ou ID du référentiel.

Retours

Promise<AutofixRequest>

createLegalReview(string, string, number, string)

Créez un examen juridique. Cela crée l’examen juridique associé à l’alerte. Il s’agit de l’URL de l’élément de travail de révision.

function createLegalReview(project: string, repository: string, alertId: number, ref?: string): Promise<LegalReview>

Paramètres

project

string

ID de projet ou nom du projet

repository

string

Nom ou identifiant d’un référentiel pour l’alerte juridique

alertId

number

Alerte de sécurité préalable identifiant de l’alerte juridique pour obtenir l’examen juridique

ref

string

Retours

Promise<LegalReview>

deleteAllPipelineAnalyses(string, string)

Supprime de manière réversible les données d’analyse pour tous les pipelines d’un référentiel, en supprimant les alertes Advanced Security associées.

function deleteAllPipelineAnalyses(project: string, repository: string): Promise<void>

Paramètres

project

string

ID de projet ou nom du projet

repository

string

Nom ou ID du référentiel.

Retours

Promise<void>

deletePipelineAnalysis(string, string, number)

Supprime de manière réversible les données d’analyse d’un pipeline spécifique, en supprimant les alertes Advanced Security associées.

function deletePipelineAnalysis(project: string, repository: string, adoPipelineId: number): Promise<void>

Paramètres

project

string

ID de projet ou nom du projet

repository

string

Nom ou ID du référentiel.

adoPipelineId

number

ID du pipeline ADO dont les données d’analyse doivent être nettoyées.

Retours

Promise<void>

exportSarif(string, string, number[], string)

Exporter les alertes sous forme d’un seul fichier SARIF

function exportSarif(project: string, repository: string, alertIds: number[], branchName?: string): Promise<any>

Paramètres

project

string

ID de projet ou nom du projet

repository

string

Nom ou ID d’un référentiel

alertIds

number[]

Liste des identifiants d’alerte à exporter

branchName

string

Le nom de la branche de la cible alerte. Si cela n’est pas spécifié, la branche par défaut sera utilisée.

Retours

Promise<any>

getAlert(string, number, string, string, ExpandOption)

Obtenez une alerte.

function getAlert(project: string, alertId: number, repository: string, ref?: string, expand?: ExpandOption): Promise<Alert>

Paramètres

project

string

ID de projet ou nom du projet

alertId

number

ID d’alerte à récupérer

repository

string

Nom ou ID d’un référentiel dont l’alerte fait partie

ref

string

expand
ExpandOption

Développez les attributs d’une alerte secrète. Les valeurs possibles sont None et ValidationFingerprint. La valeur par défaut est None. N’oubliez pas que si expand elle est définie ValidationFingerprint, la réponse peut contenir le secret sous sa forme non chiffrée. Faites preuve de prudence lors de l’utilisation de ces données.

Retours

Promise<Alert>

getAlertInstances(string, number, string, string)

Obtenir des instances d’une alerte sur une branche spécifiée avec @ref. Si @ref n’est pas fourni, retournez des instances d’une alerte sur la branche par défaut (si l’alerte existe dans la branche par défaut) ou la branche affectée la plus récente.

function getAlertInstances(project: string, alertId: number, repository: string, ref?: string): Promise<AlertAnalysisInstance[]>

Paramètres

project

string

ID de projet ou nom du projet

alertId

number

ID d’alerte à récupérer

repository

string

Nom ou ID d’un référentiel dont l’alerte fait partie

ref

string

Retours

getAlertMetadata(string, number, string)

Obtenez une alerte de métadonnées.

function getAlertMetadata(project: string, alertId: number, repository: string): Promise<AlertMetadata>

Paramètres

project

string

ID de projet ou nom du projet

alertId

number

ID d’alerte à récupérer

repository

string

Nom ou ID d’un référentiel dont l’alerte fait partie

Retours

Promise<AlertMetadata>

getAlertMetadataBatch(AlertMetadataBatchRequest, string, string)

Recevez des alertes, des métadonnées.

function getAlertMetadataBatch(alertMetadataBatchRequest: AlertMetadataBatchRequest, project: string, repository: string): Promise<AlertMetadata[]>

Paramètres

alertMetadataBatchRequest
AlertMetadataBatchRequest
project

string

ID de projet ou nom du projet

repository

string

Nom ou ID d’un référentiel dont l’alerte fait partie

Retours

Promise<AlertMetadata[]>

getAlerts(string, string, number, string, SearchCriteria, AlertListExpandOption, string)

Obtenir des alertes pour un référentiel

function getAlerts(project: string, repository: string, top?: number, orderBy?: string, criteria?: SearchCriteria, expand?: AlertListExpandOption, continuationToken?: string): Promise<PagedList<Alert>>

Paramètres

project

string

ID de projet ou nom du projet

repository

string

Nom ou ID du référentiel

top

number

Nombre maximal d’alertes à retourner

orderBy

string

Doit être « id » « firstSeen » « lastSeen » « fixedOn » ou « gravité » Par défaut sur « id »

criteria
SearchCriteria

Options permettant de limiter les alertes retournées

continuationToken

string

S’il existe plus d’alertes que possible, un jeton de continuation est placé dans l’en-tête « x-ms-continuationtoken ». Utilisez ce jeton ici pour obtenir la page suivante des alertes

Retours

Promise<PagedList<Alert>>

getAlertSarif(string, number, string, string, ExpandOption)

Obtenez une alerte.

function getAlertSarif(project: string, alertId: number, repository: string, ref?: string, expand?: ExpandOption): Promise<string>

Paramètres

project

string

ID de projet ou nom du projet

alertId

number

ID d’alerte à récupérer

repository

string

Nom ou ID d’un référentiel dont l’alerte fait partie

ref

string

expand
ExpandOption

Développez les attributs d’une alerte secrète. Les valeurs possibles sont None et ValidationFingerprint. La valeur par défaut est None. N’oubliez pas que si expand elle est définie ValidationFingerprint, la réponse peut contenir le secret sous sa forme non chiffrée. Faites preuve de prudence lors de l’utilisation de ces données.

Retours

Promise<string>

getAlertsByIds(AlertBatchRequest, string, string)

Obtenir des alertes par ID d’alerte Prend actuellement en charge l’extraction d’alertes secrètes uniquement.

function getAlertsByIds(request: AlertBatchRequest, project: string, repository: string): Promise<Alert[]>

Paramètres

request
AlertBatchRequest

Requête contenant les identifiants d’alerte et un filtre optionnel pour le type d’alerte

project

string

ID de projet ou nom du projet

repository

string

Nom ou ID du référentiel

Retours

Promise<Alert[]>

getAutofixRequestsByAlertId(string, number, string)

Obtenez toutes les demandes d’autofix pour l’alerte spécifiée.

function getAutofixRequestsByAlertId(project: string, alertId: number, repository: string): Promise<AutofixRequest[]>

Paramètres

project

string

ID de projet ou nom du projet

alertId

number

ID de l’alerte.

repository

string

Nom ou ID du référentiel.

Retours

Promise<AutofixRequest[]>

getBranches(string, string, AlertType, string, string, number, boolean)

Retourne les branches pour lesquelles les résultats d’analyse ont été envoyés.

function getBranches(project: string, repository: string, alertType: AlertType, continuationToken?: string, branchNameContains?: string, top?: number, includePullRequestBranches?: boolean): Promise<Branch[]>

Paramètres

project

string

ID de projet ou nom du projet

repository

string

alertType
AlertType

Type d’alerte : Analyse des dépendances (1), Secret (2), Code QL (3), etc.

continuationToken

string

Variable de chaîne qui représente le nom de la branche et est utilisée pour extraire des branches qui le suivent dans l’ordre alphabétique.

branchNameContains

string

Variable de chaîne utilisée pour extraire des branches qui contiennent cette chaîne n’importe où dans le nom de la branche, ne respectant pas la casse.

top

number

Variable int utilisée pour retourner les branches k supérieures qui répondent aux critères de recherche.

includePullRequestBranches

boolean

Variable bool indiquant s’il faut inclure ou non des branches de demande de tirage.

Retours

Promise<Branch[]>

getOrgLevelAlertsByIds(number[])

Recevez des alertes par leur ID au niveau de l’organisation. Ne reprend que les alertes que l’utilisateur est autorisé à afficher. Renvoie uniquement les alertes des plans de référence SKU activés.

function getOrgLevelAlertsByIds(alertIds: number[]): Promise<Alert[]>

Paramètres

alertIds

number[]

Liste des ID d’alerte à récupérer

Retours

Promise<Alert[]>

getSarif(number)

Obtenir l’état du travail de traitement Sarif

function getSarif(sarifId: number): Promise<SarifUploadStatus>

Paramètres

sarifId

number

ID Sarif retourné lorsque le Sarif a été chargé

Retours

getUxFilters(string, string, AlertType)

function getUxFilters(project: string, repository: string, alertType: AlertType): Promise<UxFilters>

Paramètres

project

string

ID de projet ou nom du projet

repository

string

alertType
AlertType

Retours

Promise<UxFilters>

getValidityData(string, string, number)

Obtenez les détails de validité d’une alerte.

function getValidityData(project: string, repository: string, alertId: number): Promise<ValidationRequestInfo>

Paramètres

project

string

ID de projet ou nom du projet

repository

string

Nom ou ID d’un référentiel

alertId

number

ID de l’alerte

Retours

initiateValidation(string, string, number)

Lancer le processus de validation d’une alerte donnée

function initiateValidation(project: string, repository: string, alertId: number): Promise<AlertValidationRequestStatus>

Paramètres

project

string

ID de projet ou nom du projet

repository

string

Nom ou ID d’un référentiel

alertId

number

ID de l’alerte

Retours

updateAlert(AlertStateUpdate, string, number, string)

Mettre à jour l’état d’une alerte

function updateAlert(stateUpdate: AlertStateUpdate, project: string, alertId: number, repository: string): Promise<Alert>

Paramètres

stateUpdate
AlertStateUpdate

Nouvel état de l’alerte

project

string

ID de projet ou nom du projet

alertId

number

ID de l’alerte

repository

string

Nom ou ID du référentiel

Retours

Promise<Alert>

updateAlertsMetadata(AlertMetadata[], string, string)

Mettez à jour les associations de métadonnées d’alerte.

function updateAlertsMetadata(alertsMetadata: AlertMetadata[], project: string, repository: string): Promise<AlertMetadataChange[]>

Paramètres

alertsMetadata

AlertMetadata[]

Liste des métadonnées à associer aux alertes.

project

string

ID de projet ou nom du projet

repository

string

Nom ou ID du référentiel.

Retours

Promise<AlertMetadataChange[]>

uploadOrgSarif(string)

Télécharger un fichier Sarif au niveau de l’organisation

function uploadOrgSarif(content: string): Promise<number>

Paramètres

content

string

Contenu à charger

Retours

Promise<number>

uploadSarif(string, string, string, String)

Charger un Sarif contenant des alertes de sécurité

function uploadSarif(content: string, project: string, repository: string, notificationFlag?: String): Promise<number>

Paramètres

content

string

Contenu à charger

project

string

ID de projet ou nom du projet

repository

string

Nom ou ID d’un référentiel

notificationFlag

String

En-tête pour signaler qu’il s’agit d’une notification de progression

Retours

Promise<number>

uploadSarifToGitHub(string, string, string, string, string)

Téléverser un SARIF sur GitHub en scannant le code via une application GitOps.

function uploadSarifToGitHub(content: string, project: string, hostname: string, owner: string, repo: string): Promise<string>

Paramètres

content

string

Contenu à charger

project

string

ID de projet ou nom du projet

hostname

string

Le nom d’hôte GitHub (par exemple, github.com ou microsoft.ghe.com)

owner

string

Le propriétaire du dépôt GitHub (organisation ou utilisateur)

repo

string

Le nom du dépôt GitHub

Retours

Promise<string>