Source Controls - List

Dienst:

Sentinel

API-Version:

2025-09-01

Ruft alle Quellcodeverwaltungen ohne Quellcodeverwaltungselemente ab.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/providers/Microsoft.SecurityInsights/sourcecontrols?api-version=2025-09-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string (uuid)	Hierbei handelt es sich um die ID des Zielabonnements. Der Wert muss eine UUID sein.
workspaceName	path	True	string minLength: 1 maxLength: 90 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	Der Name des Arbeitsbereichs.
api-version	query	True	string minLength: 1	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Antworten

Name	Typ	Beschreibung
200 OK	SourceControlList	OKAY
Other Status Codes	CloudError	Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

Get all source controls.

Beispielanforderung

HTTP

GET https://management.azure.com/subscriptions/b28fbe4a-0bb1-4593-960b-061c8655a550/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/sourcecontrols?api-version=2025-09-01

Beispiel für eine Antwort

Statuscode:

200

{
  "value": [
    {
      "id": "/subscriptions/b28fbe4a-0bb1-4593-960b-061c8655a550/resourceGroups/myRg/providers/Microsoft.OperationalIinsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/sourcecontrols/789e0c1f-4a3d-43ad-809c-e713b677b04a",
      "version": "V2",
      "name": "789e0c1f-4a3d-43ad-809c-e713b677b04a",
      "type": "Microsoft.SecurityInsights/SourceControls",
      "etag": "\"0300bf09-0000-0000-0000-5c37296e0000\"",
      "properties": {
        "id": "789e0c1f-4a3d-43ad-809c-e713b677b04a",
        "displayName": "My Source Control",
        "description": "this is a source control",
        "repoType": "Github",
        "contentTypes": [
          "AnalyticsRule",
          "Workbook"
        ],
        "repository": {
          "url": "https://github.com/user/repo",
          "branch": "master",
          "displayUrl": "https://github.com/user/repo",
          "deploymentLogsUrl": "https://github.com/user/repo/actions"
        },
        "servicePrincipal": {
          "id": "6a5f9fbd-6ce5-45a5-a729-79f8943472f3",
          "tenantId": "336ffe99-ff10-48fa-8c21-6da2a653dcce",
          "appId": "307ef030-13ed-4342-8cc2-c11760649f4d"
        },
        "workloadIdentityFederation": {
          "id": "c2c12197-fc2c-4880-9b18-0996ffe7aeca",
          "tenantId": "336ffe99-ff10-48fa-8c21-6da2a653dcce",
          "appId": "307ef030-13ed-4342-8cc2-c11760649f4d",
          "subject": "repo:user/repo:ref:refs/heads/branch",
          "issuer": "https://token.actions.githubusercontent.com"
        },
        "repositoryResourceInfo": {
          "webhook": {
            "webhookId": "342768323",
            "webhookUrl": "https://cac.sentinel.azure.com/workspaces/eeca17ff-d744-4a8b-9f5e-1edcc3346a1d/webhooks/ado/sourceControl/789e0c1f-4a3d-43ad-809c-e713b677b04a",
            "webhookSecretUpdateTime": "2021-01-01T17:18:19.1234567Z"
          },
          "gitHubResourceInfo": {
            "appInstallationId": "123"
          },
          "azureDevOpsResourceInfo": null
        },
        "lastDeploymentInfo": {
          "deploymentFetchStatus": "Success",
          "deployment": {
            "deploymentId": "4985046420",
            "deploymentState": "Completed",
            "deploymentResult": "Success",
            "deploymentTime": "2021-01-01T17:18:19.1234567Z",
            "deploymentLogsUrl": "https://github.com/user/repo/actions"
          },
          "message": "Successful deployment"
        },
        "pullRequest": {
          "url": "https://github.com/user/repo/pull/123",
          "state": "Open"
        }
      },
      "systemData": {
        "createdBy": "user1",
        "createdByType": "User",
        "createdAt": "2021-01-01T17:18:19.1234567Z",
        "lastModifiedBy": "user2",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2021-01-02T17:18:19.1234567Z"
      }
    }
  ]
}

Definitionen

Name	Beschreibung
AzureDevOpsResourceInfo	Ressourcen, die im Azure DevOps-Repository erstellt wurden.
CloudError	Struktur der Fehlerantwort.
CloudErrorBody	Fehlerdetails.
ContentType	Der Inhaltstyp eines Quellcodeverwaltungspfads.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
Deployment	Beschreibung einer Bereitstellung.
DeploymentFetchStatus	Status beim Versuch, die Bereitstellungsinformationen abzurufen.
DeploymentInfo	Informationen zu einer Bereitstellung.
DeploymentResult	Status beim Versuch, die Bereitstellungsinformationen abzurufen.
DeploymentState	Der aktuelle Status der Bereitstellung.
GitHubResourceInfo	Ressourcen, die im GitHub-Repository erstellt wurden.
PullRequest	Informationen zum Pull Request für geschützte Branches.
Repository	Metadaten eines Repositoriums.
RepositoryAccess	Anmeldeinformationen für den Zugriff auf das Repository.
RepositoryAccessKind	Die Art der Anmeldeinformationen für den Repository-Zugriff
RepositoryResourceInfo	Ressourcen, die im Repository des Benutzers für die Quellcodeverwaltung erstellt wurden.
RepoType	Der Typ des Repositorys.
ServicePrincipal	Metadaten des Dienstprinzipals.
SourceControl	Stellt eine SourceControl in Azure Security Insights dar.
SourceControlList	Listen Sie alle Quellcodesteuerelemente auf.
state	Status des Pull Requests
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.
Version	Die Version der Quellcodeverwaltung.
Webhook	Detail zum Webhook-Objekt.
WorkloadIdentityFederation	Metadaten des Workload-Identitätsverbunds.

AzureDevOpsResourceInfo

Objekt

Ressourcen, die im Azure DevOps-Repository erstellt wurden.

Name	Typ	Beschreibung
pipelineId	string	ID der Pipeline, die für die Quellcodeverwaltung erstellt wurde.
serviceConnectionId	string	ID der Dienstverbindung, die für die Quellcodeverwaltung erstellt wurde.

CloudError

Objekt

Struktur der Fehlerantwort.

Name	Typ	Beschreibung
error	CloudErrorBody	Fehlerdaten

CloudErrorBody

Objekt

Fehlerdetails.

Name	Typ	Beschreibung
code	string	Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollen programmgesteuert genutzt werden.
message	string	Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet ist.

ContentType

Enumeration

Der Inhaltstyp eines Quellcodeverwaltungspfads.

Wert	Beschreibung
AnalyticsRule
AutomationRule
HuntingQuery
Parser
Playbook
Workbook

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
User
Application
ManagedIdentity
Key

Deployment

Objekt

Beschreibung einer Bereitstellung.

Name	Typ	Beschreibung
deploymentId	string	Bereitstellungs-ID.
deploymentLogsUrl	string	URL für den Zugriff auf Repository-Aktionsprotokolle.
deploymentResult	DeploymentResult	Das Ergebnis der Bereitstellung.
deploymentState	DeploymentState	Aktueller Status der Bereitstellung.
deploymentTime	string (date-time)	Der Zeitpunkt, zu dem die Bereitstellung abgeschlossen wurde.

DeploymentFetchStatus

Enumeration

Status beim Versuch, die Bereitstellungsinformationen abzurufen.

Wert	Beschreibung
Success
Unauthorized
NotFound

DeploymentInfo

Objekt

Informationen zu einer Bereitstellung.

Name	Typ	Beschreibung
deployment	Deployment	Informationen zur Bereitstellung.
deploymentFetchStatus	DeploymentFetchStatus	Status beim Abrufen der letzten Bereitstellung.
message	string	Zusätzliche Details zur Bereitstellung, die dem Benutzer angezeigt werden können.

DeploymentResult

Enumeration

Status beim Versuch, die Bereitstellungsinformationen abzurufen.

Wert	Beschreibung
Success
Canceled
Failed

DeploymentState

Enumeration

Der aktuelle Status der Bereitstellung.

Wert	Beschreibung
In_Progress
Completed
Queued
Canceling

GitHubResourceInfo

Objekt

Ressourcen, die im GitHub-Repository erstellt wurden.

Name	Typ	Beschreibung
appInstallationId	string	Installations-ID der GitHub-Anwendung.

PullRequest

Objekt

Informationen zum Pull Request für geschützte Branches.

Name	Typ	Beschreibung
state	state	Status des Pull Requests
url	string	URL des Pull Requests

Repository

Objekt

Metadaten eines Repositoriums.

Name	Typ	Beschreibung
branch	string	Name des Zweigs des Repositorys.
deploymentLogsUrl	string	URL für den Zugriff auf Repository-Aktionsprotokolle.
displayUrl	string	URL des Repositorys anzeigen.
url	string	URL des Repositorys.

RepositoryAccess

Objekt

Anmeldeinformationen für den Zugriff auf das Repository.

Name	Typ	Beschreibung
clientId	string	OAuth-Client-ID. Erforderlich, wenn kindOAuth
code	string	OAuth-Code. Erforderlich, wenn kindOAuth
installationId	string	Installations-ID der Anwendung. Erforderlich, wenn kind .App Nur unterstützt von GitHub .
kind	RepositoryAccessKind	Die Art der Anmeldeinformationen für den Repository-Zugriff
state	string	OAuth-Zustand. Erforderlich, wenn kindOAuth
token	string	Persönliches Zugriffstoken. Erforderlich, wenn kindPAT

RepositoryAccessKind

Enumeration

Die Art der Anmeldeinformationen für den Repository-Zugriff

Wert	Beschreibung
OAuth
PAT
App

RepositoryResourceInfo

Objekt

Ressourcen, die im Repository des Benutzers für die Quellcodeverwaltung erstellt wurden.

Name	Typ	Beschreibung
azureDevOpsResourceInfo	AzureDevOpsResourceInfo	Ressourcen, die in Azure DevOps für diese Quellcodeverwaltung erstellt wurden.
gitHubResourceInfo	GitHubResourceInfo	Ressourcen, die in GitHub für diese Quellcodeverwaltung erstellt wurden.
webhook	Webhook	Das Webhookobjekt, das für die Quellcodeverwaltung erstellt wurde.

RepoType

Enumeration

Der Typ des Repositorys.

Wert	Beschreibung
Github
AzureDevOps

ServicePrincipal

Objekt

Metadaten des Dienstprinzipals.

Name	Typ	Beschreibung
appId	string	App-ID des Dienstprinzipals.
credentialsExpireOn	string (date-time)	Ablaufzeit der Anmeldeinformationen für den Dienstprinzipal.
id	string	ID des Dienstprinzipals.
tenantId	string	Mandanten-ID des Dienstprinzipals.

SourceControl

Objekt

Stellt eine SourceControl in Azure Security Insights dar.

Name	Typ	Beschreibung
etag	string	Etag der Azure-Ressource
id	string (arm-id)	Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Der Name der Ressource
properties.contentTypes	ContentType[]	Array von Inhaltstypen der Quellcodeverwaltung.
properties.description	string	Eine Beschreibung der Quellcodeverwaltung
properties.displayName	string	Der Anzeigename der Quellcodeverwaltung
properties.id	string	Die ID (eine GUID) der Quellcodeverwaltung
properties.lastDeploymentInfo	DeploymentInfo	Informationen zur neuesten Bereitstellung für die Quellcodeverwaltung.
properties.pullRequest	PullRequest	Informationen zum Pull Request der Quellcodeverwaltung.
properties.repoType	RepoType	Der Repository-Typ der Quellcodeverwaltung
properties.repository	Repository	Metadaten des Repositorys.
properties.repositoryAccess	RepositoryAccess	Anmeldeinformationen für den Repository-Zugriff. Hierbei handelt es sich um ein schreibgeschütztes Objekt, das nie an einen Benutzer zurückgegeben wird.
properties.repositoryResourceInfo	RepositoryResourceInfo	Informationen zu den Ressourcen, die im Repository des Benutzers erstellt wurden.
properties.servicePrincipal	ServicePrincipal	Metadaten des Dienstprinzipals.
properties.version	Version	Die Versionsnummer, die der Quellcodeverwaltung zugeordnet ist
properties.workloadIdentityFederation	WorkloadIdentityFederation	Metadaten der Workload-Identität.
systemData	systemData	Azure Resource Manager-Metadaten mit createdBy- und modifiedBy-Informationen.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

SourceControlList

Objekt

Listen Sie alle Quellcodesteuerelemente auf.

Name	Typ	Beschreibung
nextLink	string	URL zum Abrufen des nächsten Satzes von Quellcodesteuerelementen.
value	SourceControl[]	Array von Quellcode-Steuerelementen.

state

Enumeration

Status des Pull Requests

Wert	Beschreibung
Open
Closed

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.

Version

Enumeration

Die Version der Quellcodeverwaltung.

Wert	Beschreibung
V1
V2

Webhook

Objekt

Detail zum Webhook-Objekt.

Name	Typ	Beschreibung
rotateWebhookSecret	boolean	Ein Flag, mit dem der Back-End-Dienst angewiesen wird, den geheimen Webhookschlüssel zu rotieren.
webhookId	string	Eindeutiger Bezeichner für den Webhook.
webhookSecretUpdateTime	string (date-time)	Zeitpunkt, zu dem das Webhook-Geheimnis aktualisiert wurde.
webhookUrl	string	URL, die vom Webhook aufgerufen wird.

WorkloadIdentityFederation

Objekt

Metadaten des Workload-Identitätsverbunds.

Name	Typ	Beschreibung
appId	string	App-ID des Workload-Identitätsverbunds.
id	string	ID des Workload-Identitätsverbunds.
issuer	string	Aussteller des Workload-Identitätsverbunds.
subject	string	Gegenstand der Workload Identity Federation.
tenantId	string	Mandanten-ID des Workload-Identitätsverbunds.