Azure DevOps Projects - List

Service:: Defender for Cloud

Version d'API:: 2024-04-01

Retourne la liste des projets Azure DevOps intégrés au connecteur.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/azureDevOpsOrgs/{orgName}/projects?api-version=2024-04-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
orgName	path	True	string	Nom de l’organisation Azure DevOps.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
securityConnectorName	path	True	string	Nom du connecteur de sécurité.
subscriptionId	path	True	string minLength: 1	ID de l’abonnement cible.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Réponses

Nom	Type	Description
200 OK	AzureDevOpsProjectListResponse	Fournit la liste des détails du projet Azure DevOps
Other Status Codes	ErrorResponse	Réponse d’erreur décrivant pourquoi l’opération a échoué.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

List_AzureDevOpsProjects

Exemple de requête

HTTP

GET https://management.azure.com/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/azureDevOpsOrgs/myAzDevOpsOrg/projects?api-version=2024-04-01

Exemple de réponse

Code d’état:: 200

{
  "value": [
    {
      "properties": {
        "parentOrgName": "myAzDevOpsOrg",
        "projectId": "9ebbed8f-a9cc-405f-a647-b235e22179de",
        "onboardingState": "Onboarded",
        "actionableRemediation": {
          "state": "Enabled"
        },
        "provisioningState": "Succeeded"
      },
      "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/azureDevOpsOrgs/myAzDevOpsOrg/projects/myAzDevOpsProject",
      "name": "myAzDevOpsProject",
      "type": "Microsoft.Security/securityConnectors/devops/azureDevOpsOrgs/projects"
    }
  ]
}

Définitions

Nom	Description
ActionableRemediation	Charge utile de configuration pour les annotations de demande de tirage.
ActionableRemediationState	Paramètre ActionableRemediation. Aucun : le paramètre n’a jamais été défini. Activé : ActionableRemediation est activé. Disabled : ActionableRemediation est désactivé.
AnnotateDefaultBranchState	Configuration des annotations de demande de tirage sur la branche par défaut. Activé : les annotations de demande de tirage sont activées sur la branche par défaut de la ressource. Désactivé : les annotations de demande de tirage sont désactivées sur la branche par défaut de la ressource.
AzureDevOpsProject	Ressource Azure DevOps Project.
AzureDevOpsProjectListResponse	Liste des ressources rp qui prennent en charge la pagination.
AzureDevOpsProjectProperties	Propriétés d’Azure DevOps Project.
CategoryConfiguration	Niveau de gravité par configuration de catégorie pour les annotations de demande de tirage.
createdByType	Type d’identité qui a créé la ressource.
DevOpsProvisioningState	État d’approvisionnement de la ressource. En attente : approvisionnement en attente. Échec : échec de l’approvisionnement. Réussite : approvisionnement réussi. Annulé : approvisionnement annulé. PendingDeletion - Suppression en attente. SuppressionSuccess - Suppression réussie. SuppressionFailure - Échec de suppression.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
InheritFromParentState	Mettre à jour les paramètres. Activé : la ressource doit hériter des configurations du parent. Désactivé : la ressource ne doit pas hériter des configurations du parent.
OnboardingState	Détails sur l’état d’intégration des ressources sur tous les connecteurs. OnboardedByOtherConnector : cette ressource a déjà été intégrée à un autre connecteur. Cela s’applique uniquement aux ressources de niveau supérieur. Intégré : cette ressource a déjà été intégrée par le connecteur spécifié. NotOnboarded : cette ressource n’a pas été intégrée à un connecteur. NotApplicable : l’état d’intégration n’est pas applicable au point de terminaison actuel.
RuleCategory	Catégories de règles. Code : résultats de l’analyse du code. Résultats de l’analyse des artefacts. Résultats de l’analyse des dépendances. Résultats iaC. Résultats de l’analyse des secrets. Résultats de l’analyse du conteneur.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
TargetBranchConfiguration	Configuration de la branche de référentiel pour les annotations pr.

ActionableRemediation

Objet

Charge utile de configuration pour les annotations de demande de tirage.

Nom	Type	Description
branchConfiguration	TargetBranchConfiguration	Configuration de la branche de référentiel pour les annotations pr.
categoryConfigurations	CategoryConfiguration[]	Obtient ou définit la liste des catégories et niveaux de gravité.
inheritFromParentState	InheritFromParentState	Mettre à jour les paramètres. Activé : la ressource doit hériter des configurations du parent. Désactivé : la ressource ne doit pas hériter des configurations du parent.
state	ActionableRemediationState	Paramètre ActionableRemediation. Aucun : le paramètre n’a jamais été défini. Activé : ActionableRemediation est activé. Disabled : ActionableRemediation est désactivé.

ActionableRemediationState

Énumération

Paramètre ActionableRemediation. Aucun : le paramètre n’a jamais été défini. Activé : ActionableRemediation est activé. Disabled : ActionableRemediation est désactivé.

Valeur	Description
None
Disabled
Enabled

AnnotateDefaultBranchState

Énumération

Configuration des annotations de demande de tirage sur la branche par défaut.

Activé : les annotations de demande de tirage sont activées sur la branche par défaut de la ressource. Désactivé : les annotations de demande de tirage sont désactivées sur la branche par défaut de la ressource.

Valeur	Description
Disabled
Enabled

AzureDevOpsProject

Objet

Ressource Azure DevOps Project.

Nom	Type	Description
id	string	ID de ressource complet pour la ressource. ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nom de la ressource
properties	AzureDevOpsProjectProperties	Propriétés d’Azure DevOps Project.
systemData	systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

AzureDevOpsProjectListResponse

Objet

Liste des ressources rp qui prennent en charge la pagination.

Nom	Type	Description
nextLink	string	Obtient ou définit le lien suivant pour faire défiler les résultats.
value	AzureDevOpsProject[]	Obtient ou définit la liste des ressources.

AzureDevOpsProjectProperties

Objet

Propriétés d’Azure DevOps Project.

Nom	Type	Description
actionableRemediation	ActionableRemediation	Charge utile de configuration pour les annotations de demande de tirage.
onboardingState	OnboardingState	Détails sur l’état d’intégration des ressources sur tous les connecteurs. OnboardedByOtherConnector : cette ressource a déjà été intégrée à un autre connecteur. Cela s’applique uniquement aux ressources de niveau supérieur. Intégré : cette ressource a déjà été intégrée par le connecteur spécifié. NotOnboarded : cette ressource n’a pas été intégrée à un connecteur. NotApplicable : l’état d’intégration n’est pas applicable au point de terminaison actuel.
parentOrgName	string	Obtient ou définit le nom de l’organisation Azure DevOps parent.
projectId	string	Obtient ou définit l’ID du projet Azure DevOps.
provisioningState	DevOpsProvisioningState	État d’approvisionnement de la ressource. En attente : approvisionnement en attente. Échec : échec de l’approvisionnement. Réussite : approvisionnement réussi. Annulé : approvisionnement annulé. PendingDeletion - Suppression en attente. SuppressionSuccess - Suppression réussie. SuppressionFailure - Échec de suppression.
provisioningStatusMessage	string	Obtient ou définit le message d’état de la ressource.
provisioningStatusUpdateTimeUtc	string (date-time)	Obtient ou définit l’heure de la dernière vérification de la ressource.

CategoryConfiguration

Objet

Niveau de gravité par configuration de catégorie pour les annotations de demande de tirage.

Nom	Type	Description
category	RuleCategory	Catégories de règles. Code : résultats de l’analyse du code. Résultats de l’analyse des artefacts. Résultats de l’analyse des dépendances. Résultats iaC. Résultats de l’analyse des secrets. Résultats de l’analyse du conteneur.
minimumSeverityLevel	string	Obtient ou définit le niveau de gravité minimal pour une catégorie donnée.

createdByType

Énumération

Type d’identité qui a créé la ressource.

Valeur	Description
User
Application
ManagedIdentity
Key

DevOpsProvisioningState

Énumération

État d’approvisionnement de la ressource.

En attente : approvisionnement en attente. Échec : échec de l’approvisionnement. Réussite : approvisionnement réussi. Annulé : approvisionnement annulé. PendingDeletion - Suppression en attente. SuppressionSuccess - Suppression réussie. SuppressionFailure - Échec de suppression.

Valeur	Description
Succeeded
Failed
Canceled
Pending
PendingDeletion
DeletionSuccess
DeletionFailure

ErrorAdditionalInfo

Objet

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Objet

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d’erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Objet

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

InheritFromParentState

Énumération

Mettre à jour les paramètres.

Activé : la ressource doit hériter des configurations du parent. Désactivé : la ressource ne doit pas hériter des configurations du parent.

Valeur	Description
Disabled
Enabled

OnboardingState

Énumération

Détails sur l’état d’intégration des ressources sur tous les connecteurs.

OnboardedByOtherConnector : cette ressource a déjà été intégrée à un autre connecteur. Cela s’applique uniquement aux ressources de niveau supérieur. Intégré : cette ressource a déjà été intégrée par le connecteur spécifié. NotOnboarded : cette ressource n’a pas été intégrée à un connecteur. NotApplicable : l’état d’intégration n’est pas applicable au point de terminaison actuel.

Valeur	Description
NotApplicable
OnboardedByOtherConnector
Onboarded
NotOnboarded

RuleCategory

Énumération

Catégories de règles. Code : résultats de l’analyse du code. Résultats de l’analyse des artefacts. Résultats de l’analyse des dépendances. Résultats iaC. Résultats de l’analyse des secrets. Résultats de l’analyse du conteneur.

Valeur	Description
Code
Artifacts
Dependencies
Secrets
IaC
Containers

systemData

Objet

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string (date-time)	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string (date-time)	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.

TargetBranchConfiguration

Objet

Configuration de la branche de référentiel pour les annotations pr.

Nom	Type	Description
annotateDefaultBranch	AnnotateDefaultBranchState	Configuration des annotations de demande de tirage sur la branche par défaut. Activé : les annotations de demande de tirage sont activées sur la branche par défaut de la ressource. Désactivé : les annotations de demande de tirage sont désactivées sur la branche par défaut de la ressource.
branchNames	string[]	Obtient ou définit des branches qui doivent avoir des annotations.

Nom

Type

Description

annotateDefaultBranch

AnnotateDefaultBranchState

Configuration des annotations de demande de tirage sur la branche par défaut.

branchNames

string[]

Obtient ou définit des branches qui doivent avoir des annotations.

Partager via

Azure DevOps Projects - List

Paramètres URI

Réponses

Sécurité

azure_auth

Étendues

Exemples

List_AzureDevOpsProjects

Exemple de requête

Exemple de réponse

Définitions

ActionableRemediation

ActionableRemediationState

AnnotateDefaultBranchState

AzureDevOpsProject

AzureDevOpsProjectListResponse

AzureDevOpsProjectProperties

CategoryConfiguration

createdByType

DevOpsProvisioningState

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

InheritFromParentState

OnboardingState

RuleCategory

systemData

TargetBranchConfiguration