Udostępnij przez


Microsoft.SecurityInsights — kontrole źródła

Definicja zasobu Bicep

Typ zasobu sourcecontrols można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.SecurityInsights/sourcecontrols, dodaj następujący kod Bicep do szablonu.

resource symbolicname 'Microsoft.SecurityInsights/sourcecontrols@2025-09-01' = {
  scope: resourceSymbolicName or scope
  etag: 'string'
  name: 'string'
  properties: {
    contentTypes: [
      'string'
    ]
    description: 'string'
    displayName: 'string'
    repository: {
      branch: 'string'
      displayUrl: 'string'
      url: 'string'
    }
    repositoryAccess: {
      clientId: 'string'
      code: 'string'
      installationId: 'string'
      kind: 'string'
      state: 'string'
      token: 'string'
    }
    repositoryResourceInfo: {
      webhook: {
        rotateWebhookSecret: bool
      }
    }
    repoType: 'string'
    servicePrincipal: {
      credentialsExpireOn: 'string'
    }
  }
}

Wartości właściwości

Microsoft.SecurityInsights/sourcecontrols

Nazwa Opis Wartość
Znacznik ETAG Etag zasobu platformy Azure ciąg
nazwa Nazwa zasobu ciąg (wymagany)
Właściwości właściwości kontroli źródła SourceControlProperties (wymagane)
zakres Użyj polecenia podczas tworzenia zasobu w zakresie innym niż zakres wdrożenia. Ustaw tę właściwość na symboliczną nazwę zasobu, aby zastosować zasób rozszerzenia .

Repozytorium

Nazwa Opis Wartość
branch Nazwa gałęzi repozytorium. ciąg (wymagany)
displayUrl (wyświetlany adres URL) Wyświetl adres URL repozytorium. ciąg
adres URL Adres URL repozytorium. ciąg (wymagany)

Dostęp do repozytorium

Nazwa Opis Wartość
clientId (identyfikator klienta) Identyfikator klienta OAuth. Wymagane, gdy kind jest OAuth ciąg
kod Kod OAuth. Wymagane, gdy kind jest OAuth struna

Ograniczenia:
Wartość wrażliwa. Przekaż jako bezpieczny parametr.
identyfikator instalacji Identyfikator instalacji aplikacji. Wymagane, gdy kind jest App. Obsługiwane tylko przez GitHub. ciąg
rodzaj Rodzaj poświadczeń dostępu do repozytorium "Aplikacja"
"OAuth"
"PAT" (wymagany)
stan Stan OAuth. Wymagane, gdy kind jest OAuth struna

Ograniczenia:
Wartość wrażliwa. Przekaż jako bezpieczny parametr.
kod przedpłaty Osobisty token dostępu. Wymagane, gdy kind jest PAT struna

Ograniczenia:
Wartość wrażliwa. Przekaż jako bezpieczny parametr.

RepositoryResourceInfo

Nazwa Opis Wartość
element webhook Obiekt elementu webhook utworzony na potrzeby kontroli źródła. elementu webhook

ServicePrincipal (jednostka usługi)

Nazwa Opis Wartość
credentialsExpireOn (dane uwierzytelniająceWygasać) Czas wygaśnięcia poświadczeń jednostki usługi. ciąg

Właściwości SourceControlProperties

Nazwa Opis Wartość
contentTypes (typy treści) Tablica typów zawartości kontroli źródła. Tablica ciągów zawierająca dowolną z:
"AnalyticsRule"
"AutomationRule"
"HuntingQuery"
"Analizator"
"Podręcznik"
"Skoroszyt" (wymagany)
opis Opis kontroli źródła ciąg
nazwa wyświetlana Nazwa wyświetlana kontroli źródła ciąg (wymagany)
repozytorium Metadane repozytorium. repozytorium (wymagane)
repositoryAccess Poświadczenia dostępu do repozytorium. Jest to obiekt tylko do zapisu i nigdy nie wraca do użytkownika. Dostęp do repozytorium
repositoryResourceInfo (informacje o zasobach) Informacje dotyczące zasobów utworzonych w repozytorium użytkownika. RepositoryResourceInfo
repoType (typ repozytorium) Typ repozytorium kontroli źródła "AzureDevOps"
"Github" (wymagane)
servicePrincipal (jednostka usługi) Metadane jednostki usługi. ServicePrincipal (jednostka usługi)

Element webhook

Nazwa Opis Wartość
rotateWebhookTajne Flaga nakazująca usłudze zaplecza rotację wpisu tajnego elementu webhook. Bool

Definicja zasobu szablonu usługi ARM

Typ zasobu sourcecontrols można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.SecurityInsights/sourcecontrols, dodaj następujący kod JSON do szablonu.

{
  "type": "Microsoft.SecurityInsights/sourcecontrols",
  "apiVersion": "2025-09-01",
  "name": "string",
  "etag": "string",
  "properties": {
    "contentTypes": [ "string" ],
    "description": "string",
    "displayName": "string",
    "repository": {
      "branch": "string",
      "displayUrl": "string",
      "url": "string"
    },
    "repositoryAccess": {
      "clientId": "string",
      "code": "string",
      "installationId": "string",
      "kind": "string",
      "state": "string",
      "token": "string"
    },
    "repositoryResourceInfo": {
      "webhook": {
        "rotateWebhookSecret": "bool"
      }
    },
    "repoType": "string",
    "servicePrincipal": {
      "credentialsExpireOn": "string"
    }
  }
}

Wartości właściwości

Microsoft.SecurityInsights/sourcecontrols

Nazwa Opis Wartość
apiVersion (wersja interfejsu api) Wersja interfejsu API '2025-09-01'
Znacznik ETAG Etag zasobu platformy Azure ciąg
nazwa Nazwa zasobu ciąg (wymagany)
Właściwości właściwości kontroli źródła SourceControlProperties (wymagane)
typ Typ zasobu "Microsoft.SecurityInsights/sourcecontrols"

Repozytorium

Nazwa Opis Wartość
branch Nazwa gałęzi repozytorium. ciąg (wymagany)
displayUrl (wyświetlany adres URL) Wyświetl adres URL repozytorium. ciąg
adres URL Adres URL repozytorium. ciąg (wymagany)

Dostęp do repozytorium

Nazwa Opis Wartość
clientId (identyfikator klienta) Identyfikator klienta OAuth. Wymagane, gdy kind jest OAuth ciąg
kod Kod OAuth. Wymagane, gdy kind jest OAuth struna

Ograniczenia:
Wartość wrażliwa. Przekaż jako bezpieczny parametr.
identyfikator instalacji Identyfikator instalacji aplikacji. Wymagane, gdy kind jest App. Obsługiwane tylko przez GitHub. ciąg
rodzaj Rodzaj poświadczeń dostępu do repozytorium "Aplikacja"
"OAuth"
"PAT" (wymagany)
stan Stan OAuth. Wymagane, gdy kind jest OAuth struna

Ograniczenia:
Wartość wrażliwa. Przekaż jako bezpieczny parametr.
kod przedpłaty Osobisty token dostępu. Wymagane, gdy kind jest PAT struna

Ograniczenia:
Wartość wrażliwa. Przekaż jako bezpieczny parametr.

RepositoryResourceInfo

Nazwa Opis Wartość
element webhook Obiekt elementu webhook utworzony na potrzeby kontroli źródła. elementu webhook

ServicePrincipal (jednostka usługi)

Nazwa Opis Wartość
credentialsExpireOn (dane uwierzytelniająceWygasać) Czas wygaśnięcia poświadczeń jednostki usługi. ciąg

Właściwości SourceControlProperties

Nazwa Opis Wartość
contentTypes (typy treści) Tablica typów zawartości kontroli źródła. Tablica ciągów zawierająca dowolną z:
"AnalyticsRule"
"AutomationRule"
"HuntingQuery"
"Analizator"
"Podręcznik"
"Skoroszyt" (wymagany)
opis Opis kontroli źródła ciąg
nazwa wyświetlana Nazwa wyświetlana kontroli źródła ciąg (wymagany)
repozytorium Metadane repozytorium. repozytorium (wymagane)
repositoryAccess Poświadczenia dostępu do repozytorium. Jest to obiekt tylko do zapisu i nigdy nie wraca do użytkownika. Dostęp do repozytorium
repositoryResourceInfo (informacje o zasobach) Informacje dotyczące zasobów utworzonych w repozytorium użytkownika. RepositoryResourceInfo
repoType (typ repozytorium) Typ repozytorium kontroli źródła "AzureDevOps"
"Github" (wymagane)
servicePrincipal (jednostka usługi) Metadane jednostki usługi. ServicePrincipal (jednostka usługi)

Element webhook

Nazwa Opis Wartość
rotateWebhookTajne Flaga nakazująca usłudze zaplecza rotację wpisu tajnego elementu webhook. Bool

Przykłady użycia

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu sourcecontrols można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.SecurityInsights/sourcecontrols, dodaj następujący program Terraform do szablonu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.SecurityInsights/sourcecontrols@2025-09-01"
  name = "string"
  parent_id = "string"
  body = {
    etag = "string"
    properties = {
      contentTypes = [
        "string"
      ]
      description = "string"
      displayName = "string"
      repository = {
        branch = "string"
        displayUrl = "string"
        url = "string"
      }
      repositoryAccess = {
        clientId = "string"
        code = "string"
        installationId = "string"
        kind = "string"
        state = "string"
        token = "string"
      }
      repositoryResourceInfo = {
        webhook = {
          rotateWebhookSecret = bool
        }
      }
      repoType = "string"
      servicePrincipal = {
        credentialsExpireOn = "string"
      }
    }
  }
}

Wartości właściwości

Microsoft.SecurityInsights/sourcecontrols

Nazwa Opis Wartość
Znacznik ETAG Etag zasobu platformy Azure ciąg
nazwa Nazwa zasobu ciąg (wymagany)
parent_id (identyfikator rodzica) Identyfikator zasobu, do który ma być stosowany ten zasób rozszerzenia. ciąg (wymagany)
Właściwości właściwości kontroli źródła SourceControlProperties (wymagane)
typ Typ zasobu "Microsoft.SecurityInsights/sourcecontrols@2025-09-01"

Repozytorium

Nazwa Opis Wartość
branch Nazwa gałęzi repozytorium. ciąg (wymagany)
displayUrl (wyświetlany adres URL) Wyświetl adres URL repozytorium. ciąg
adres URL Adres URL repozytorium. ciąg (wymagany)

Dostęp do repozytorium

Nazwa Opis Wartość
clientId (identyfikator klienta) Identyfikator klienta OAuth. Wymagane, gdy kind jest OAuth ciąg
kod Kod OAuth. Wymagane, gdy kind jest OAuth struna

Ograniczenia:
Wartość wrażliwa. Przekaż jako bezpieczny parametr.
identyfikator instalacji Identyfikator instalacji aplikacji. Wymagane, gdy kind jest App. Obsługiwane tylko przez GitHub. ciąg
rodzaj Rodzaj poświadczeń dostępu do repozytorium "Aplikacja"
"OAuth"
"PAT" (wymagany)
stan Stan OAuth. Wymagane, gdy kind jest OAuth struna

Ograniczenia:
Wartość wrażliwa. Przekaż jako bezpieczny parametr.
kod przedpłaty Osobisty token dostępu. Wymagane, gdy kind jest PAT struna

Ograniczenia:
Wartość wrażliwa. Przekaż jako bezpieczny parametr.

RepositoryResourceInfo

Nazwa Opis Wartość
element webhook Obiekt elementu webhook utworzony na potrzeby kontroli źródła. elementu webhook

ServicePrincipal (jednostka usługi)

Nazwa Opis Wartość
credentialsExpireOn (dane uwierzytelniająceWygasać) Czas wygaśnięcia poświadczeń jednostki usługi. ciąg

Właściwości SourceControlProperties

Nazwa Opis Wartość
contentTypes (typy treści) Tablica typów zawartości kontroli źródła. Tablica ciągów zawierająca dowolną z:
"AnalyticsRule"
"AutomationRule"
"HuntingQuery"
"Analizator"
"Podręcznik"
"Skoroszyt" (wymagany)
opis Opis kontroli źródła ciąg
nazwa wyświetlana Nazwa wyświetlana kontroli źródła ciąg (wymagany)
repozytorium Metadane repozytorium. repozytorium (wymagane)
repositoryAccess Poświadczenia dostępu do repozytorium. Jest to obiekt tylko do zapisu i nigdy nie wraca do użytkownika. Dostęp do repozytorium
repositoryResourceInfo (informacje o zasobach) Informacje dotyczące zasobów utworzonych w repozytorium użytkownika. RepositoryResourceInfo
repoType (typ repozytorium) Typ repozytorium kontroli źródła "AzureDevOps"
"Github" (wymagane)
servicePrincipal (jednostka usługi) Metadane jednostki usługi. ServicePrincipal (jednostka usługi)

Element webhook

Nazwa Opis Wartość
rotateWebhookTajne Flaga nakazująca usłudze zaplecza rotację wpisu tajnego elementu webhook. Bool