Compartir a través de


Controles de código fuente Microsoft.SecurityInsights

Definición de recursos de Bicep

El tipo de recurso sourcecontrols se puede implementar con operaciones que tienen como destino:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.SecurityInsights/sourcecontrols, agregue el siguiente bicep a la plantilla.

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'
    }
  }
}

Valores de propiedad

Microsoft.SecurityInsights/sourcecontrols

Nombre Descripción Valor
ETag Etag del recurso de Azure cuerda
nombre El nombre del recurso string (obligatorio)
Propiedades propiedades de control de código fuente sourceControlProperties (obligatorio)
alcance Use al crear un recurso en un ámbito diferente del ámbito de implementación. Establezca esta propiedad en el nombre simbólico de un recurso para aplicar el recurso de extensión .

Depósito

Nombre Descripción Valor
rama Nombre de rama del repositorio. string (obligatorio)
displayUrl Mostrar la dirección URL del repositorio. cuerda
URL Dirección URL del repositorio. string (obligatorio)

Acceso al repositorio

Nombre Descripción Valor
clientId ClientId de OAuth. Obligatorio cuando se kindOAuth cuerda
código Código de OAuth. Obligatorio cuando se kindOAuth cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
installationId Id. de instalación de la aplicación. Obligatorio cuando kind es App. Solo es compatible con GitHub. cuerda
amable El tipo de credenciales de acceso al repositorio 'Aplicación'
'OAuth'
'PAT' (obligatorio)
estado Estado de OAuth. Obligatorio cuando se kindOAuth cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
seña Token de acceso personal. Obligatorio cuando se kindPAT cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.

RepositoryResourceInfo

Nombre Descripción Valor
webhook (punto de enlace web) Objeto de webhook creado para el control de código fuente. de webhook

ServicePrincipal

Nombre Descripción Valor
credentialsExpireOn Hora de expiración de las credenciales de la entidad de servicio. cuerda

SourceControlProperties

Nombre Descripción Valor
contentTypes Matriz de tipos de contenido de control de código fuente. Matriz de cadenas que contiene cualquiera de:
'Regla de análisis'
'Regla de automatización'
'HuntingQuery'
'Analizador'
'Cuaderno de estrategias'
'Libro' (obligatorio)
descripción Descripción del control de código fuente cuerda
Nombre para mostrar Nombre para mostrar del control de código fuente string (obligatorio)
depósito Metadatos del repositorio. repositorio (obligatorio)
repositoryAccess Credenciales de acceso al repositorio. Se trata de un objeto de solo escritura y nunca vuelve a un usuario. Acceso al repositorio
repositoryResourceInfo Información sobre los recursos creados en el repositorio del usuario. RepositoryResourceInfo
repoType El tipo de repositorio del control de código fuente "AzureDevOps"
'Github' (obligatorio)
servicePrincipal Metadatos de la entidad de servicio. servicePrincipal

Webhook (webhook)

Nombre Descripción Valor
rotateWebhookSecret Marca para indicar al servicio back-end que rote el secreto de webhook. Bool

Definición de recursos de plantilla de ARM

El tipo de recurso sourcecontrols se puede implementar con operaciones que tienen como destino:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.SecurityInsights/sourcecontrols, agregue el siguiente JSON a la plantilla.

{
  "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"
    }
  }
}

Valores de propiedad

Microsoft.SecurityInsights/sourcecontrols

Nombre Descripción Valor
apiVersion La versión de api '2025-09-01'
ETag Etag del recurso de Azure cuerda
nombre El nombre del recurso string (obligatorio)
Propiedades propiedades de control de código fuente sourceControlProperties (obligatorio)
tipo El tipo de recurso "Microsoft.SecurityInsights/sourcecontrols"

Depósito

Nombre Descripción Valor
rama Nombre de rama del repositorio. string (obligatorio)
displayUrl Mostrar la dirección URL del repositorio. cuerda
URL Dirección URL del repositorio. string (obligatorio)

Acceso al repositorio

Nombre Descripción Valor
clientId ClientId de OAuth. Obligatorio cuando se kindOAuth cuerda
código Código de OAuth. Obligatorio cuando se kindOAuth cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
installationId Id. de instalación de la aplicación. Obligatorio cuando kind es App. Solo es compatible con GitHub. cuerda
amable El tipo de credenciales de acceso al repositorio 'Aplicación'
'OAuth'
'PAT' (obligatorio)
estado Estado de OAuth. Obligatorio cuando se kindOAuth cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
seña Token de acceso personal. Obligatorio cuando se kindPAT cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.

RepositoryResourceInfo

Nombre Descripción Valor
webhook (punto de enlace web) Objeto de webhook creado para el control de código fuente. de webhook

ServicePrincipal

Nombre Descripción Valor
credentialsExpireOn Hora de expiración de las credenciales de la entidad de servicio. cuerda

SourceControlProperties

Nombre Descripción Valor
contentTypes Matriz de tipos de contenido de control de código fuente. Matriz de cadenas que contiene cualquiera de:
'Regla de análisis'
'Regla de automatización'
'HuntingQuery'
'Analizador'
'Cuaderno de estrategias'
'Libro' (obligatorio)
descripción Descripción del control de código fuente cuerda
Nombre para mostrar Nombre para mostrar del control de código fuente string (obligatorio)
depósito Metadatos del repositorio. repositorio (obligatorio)
repositoryAccess Credenciales de acceso al repositorio. Se trata de un objeto de solo escritura y nunca vuelve a un usuario. Acceso al repositorio
repositoryResourceInfo Información sobre los recursos creados en el repositorio del usuario. RepositoryResourceInfo
repoType El tipo de repositorio del control de código fuente "AzureDevOps"
'Github' (obligatorio)
servicePrincipal Metadatos de la entidad de servicio. servicePrincipal

Webhook (webhook)

Nombre Descripción Valor
rotateWebhookSecret Marca para indicar al servicio back-end que rote el secreto de webhook. Bool

Ejemplos de uso

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso sourcecontrols se puede implementar con operaciones que tienen como destino:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.SecurityInsights/sourcecontrols, agregue el siguiente terraform a la plantilla.

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"
      }
    }
  }
}

Valores de propiedad

Microsoft.SecurityInsights/sourcecontrols

Nombre Descripción Valor
ETag Etag del recurso de Azure cuerda
nombre El nombre del recurso string (obligatorio)
parent_id Identificador del recurso al que se va a aplicar este recurso de extensión. string (obligatorio)
Propiedades propiedades de control de código fuente sourceControlProperties (obligatorio)
tipo El tipo de recurso "Microsoft.SecurityInsights/sourcecontrols@2025-09-01"

Depósito

Nombre Descripción Valor
rama Nombre de rama del repositorio. string (obligatorio)
displayUrl Mostrar la dirección URL del repositorio. cuerda
URL Dirección URL del repositorio. string (obligatorio)

Acceso al repositorio

Nombre Descripción Valor
clientId ClientId de OAuth. Obligatorio cuando se kindOAuth cuerda
código Código de OAuth. Obligatorio cuando se kindOAuth cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
installationId Id. de instalación de la aplicación. Obligatorio cuando kind es App. Solo es compatible con GitHub. cuerda
amable El tipo de credenciales de acceso al repositorio 'Aplicación'
'OAuth'
'PAT' (obligatorio)
estado Estado de OAuth. Obligatorio cuando se kindOAuth cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
seña Token de acceso personal. Obligatorio cuando se kindPAT cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.

RepositoryResourceInfo

Nombre Descripción Valor
webhook (punto de enlace web) Objeto de webhook creado para el control de código fuente. de webhook

ServicePrincipal

Nombre Descripción Valor
credentialsExpireOn Hora de expiración de las credenciales de la entidad de servicio. cuerda

SourceControlProperties

Nombre Descripción Valor
contentTypes Matriz de tipos de contenido de control de código fuente. Matriz de cadenas que contiene cualquiera de:
'Regla de análisis'
'Regla de automatización'
'HuntingQuery'
'Analizador'
'Cuaderno de estrategias'
'Libro' (obligatorio)
descripción Descripción del control de código fuente cuerda
Nombre para mostrar Nombre para mostrar del control de código fuente string (obligatorio)
depósito Metadatos del repositorio. repositorio (obligatorio)
repositoryAccess Credenciales de acceso al repositorio. Se trata de un objeto de solo escritura y nunca vuelve a un usuario. Acceso al repositorio
repositoryResourceInfo Información sobre los recursos creados en el repositorio del usuario. RepositoryResourceInfo
repoType El tipo de repositorio del control de código fuente "AzureDevOps"
'Github' (obligatorio)
servicePrincipal Metadatos de la entidad de servicio. servicePrincipal

Webhook (webhook)

Nombre Descripción Valor
rotateWebhookSecret Marca para indicar al servicio back-end que rote el secreto de webhook. Bool