Microsoft.SecurityInsights ソースコントロール 2025-09-01

Bicep リソース定義

sourcecontrols リソースの種類は、次を対象とする操作でデプロイできます。

各 API バージョンで変更されたプロパティの一覧については、「変更ログ」を参照してください。

リソース形式

Microsoft.SecurityInsights/sourcecontrols リソースを作成するには、次の Bicep をテンプレートに追加します。

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

プロパティ値

Microsoft.SecurityInsights/sourcecontrols

名前 Description 価値
etag Azure リソースの Etag 文字列
名前 リソース名 string (必須)
プロパティ ソース管理プロパティ SourceControlProperties (必須)
スコープ デプロイ スコープとは異なるスコープでリソースを作成するときに使用します。 このプロパティをリソースのシンボリック名に設定して、拡張リソースを適用します。

リポジトリ

名前 Description 価値
ブランチ リポジトリのブランチ名。 string (必須)
表示URL リポジトリの URL を表示します。 文字列
URL リポジトリの URL。 string (必須)

リポジトリアクセス

名前 Description 価値
clientId OAuth ClientId です。 kindOAuth されている場合は必須 文字列
コード OAuthコード。 kindOAuth されている場合は必須 string

制約:
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。
インストールID アプリケーション のインストール ID。 kindAppされている場合に必要です。 GitHub でのみサポートされます。 文字列
kind リポジトリ アクセス資格情報の種類 「アプリ」
「OAuth」
'PAT' (必須)
状態 OAuth状態。 kindOAuth されている場合は必須 string

制約:
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。
トークン 個人用アクセス トークン。 kindPAT されている場合は必須 string

制約:
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。

リポジトリリソース情報

名前 Description 価値
Webhook ソース管理用に作成された webhook オブジェクト。 Webhook

サービスプリンシパル

名前 Description 価値
資格情報有効期限 サービス プリンシパル資格情報の有効期限。 文字列

SourceControlProperties (ソースコントロールプロパティ)

名前 Description 価値
contentTypes ソース管理コンテンツ タイプの配列。 次のいずれかを含む文字列配列:
'アナリティクスルール'
'オートメーションルール'
'ハンティングクエリ'
「パーサー」
「プレイブック」
'ワークブック' (必須)
説明 ソース管理の説明 文字列
ディスプレイ名 ソース管理の表示名 string (必須)
リポジトリ リポジトリ メタデータ。 リポジトリ (必須)
リポジトリアクセス リポジトリ アクセス資格情報。 これは書き込み専用オブジェクトであり、ユーザーに戻ることはありません。 リポジトリアクセス
リポジトリリソース情報 ユーザーのリポジトリに作成されたリソースに関する情報。 リポジトリリソース情報
リポジトリタイプ ソース管理のリポジトリの種類 'AzureDevOps'
'Github' (必須)
servicePrincipal サービス プリンシパルのメタデータ。 ServicePrincipal

Webhook

名前 Description 価値
回転Webhookシークレット Webhook シークレットをローテーションするようにバックエンド サービスに指示するフラグ。 ブール (bool)

ARM テンプレート リソース定義

sourcecontrols リソースの種類は、次を対象とする操作でデプロイできます。

各 API バージョンで変更されたプロパティの一覧については、「変更ログ」を参照してください。

リソース形式

Microsoft.SecurityInsights/sourcecontrols リソースを作成するには、次の JSON をテンプレートに追加します。

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

プロパティ値

Microsoft.SecurityInsights/sourcecontrols

名前 Description 価値
apiVersion API のバージョン '2025-09-01'
etag Azure リソースの Etag 文字列
名前 リソース名 string (必須)
プロパティ ソース管理プロパティ SourceControlProperties (必須)
リソースの種類 'Microsoft.SecurityInsights/sourcecontrols'

リポジトリ

名前 Description 価値
ブランチ リポジトリのブランチ名。 string (必須)
表示URL リポジトリの URL を表示します。 文字列
URL リポジトリの URL。 string (必須)

リポジトリアクセス

名前 Description 価値
clientId OAuth ClientId です。 kindOAuth されている場合は必須 文字列
コード OAuthコード。 kindOAuth されている場合は必須 string

制約:
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。
インストールID アプリケーション のインストール ID。 kindAppされている場合に必要です。 GitHub でのみサポートされます。 文字列
kind リポジトリ アクセス資格情報の種類 「アプリ」
「OAuth」
'PAT' (必須)
状態 OAuth状態。 kindOAuth されている場合は必須 string

制約:
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。
トークン 個人用アクセス トークン。 kindPAT されている場合は必須 string

制約:
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。

リポジトリリソース情報

名前 Description 価値
Webhook ソース管理用に作成された webhook オブジェクト。 Webhook

サービスプリンシパル

名前 Description 価値
資格情報有効期限 サービス プリンシパル資格情報の有効期限。 文字列

SourceControlProperties (ソースコントロールプロパティ)

名前 Description 価値
contentTypes ソース管理コンテンツ タイプの配列。 次のいずれかを含む文字列配列:
'アナリティクスルール'
'オートメーションルール'
'ハンティングクエリ'
「パーサー」
「プレイブック」
'ワークブック' (必須)
説明 ソース管理の説明 文字列
ディスプレイ名 ソース管理の表示名 string (必須)
リポジトリ リポジトリ メタデータ。 リポジトリ (必須)
リポジトリアクセス リポジトリ アクセス資格情報。 これは書き込み専用オブジェクトであり、ユーザーに戻ることはありません。 リポジトリアクセス
リポジトリリソース情報 ユーザーのリポジトリに作成されたリソースに関する情報。 リポジトリリソース情報
リポジトリタイプ ソース管理のリポジトリの種類 'AzureDevOps'
'Github' (必須)
servicePrincipal サービス プリンシパルのメタデータ。 ServicePrincipal

Webhook

名前 Description 価値
回転Webhookシークレット Webhook シークレットをローテーションするようにバックエンド サービスに指示するフラグ。 ブール (bool)

使用例

Terraform (AzAPI プロバイダー) リソース定義

sourcecontrols リソースの種類は、次を対象とする操作でデプロイできます。

各 API バージョンで変更されたプロパティの一覧については、「変更ログ」を参照してください。

リソース形式

Microsoft.SecurityInsights/sourcecontrols リソースを作成するには、次の Terraform をテンプレートに追加します。

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

プロパティ値

Microsoft.SecurityInsights/sourcecontrols

名前 Description 価値
etag Azure リソースの Etag 文字列
名前 リソース名 string (必須)
parent_id この拡張リソースを適用するリソースの ID。 string (必須)
プロパティ ソース管理プロパティ SourceControlProperties (必須)
リソースの種類 "Microsoft.SecurityInsights/sourcecontrols@2025-09-01"

リポジトリ

名前 Description 価値
ブランチ リポジトリのブランチ名。 string (必須)
表示URL リポジトリの URL を表示します。 文字列
URL リポジトリの URL。 string (必須)

リポジトリアクセス

名前 Description 価値
clientId OAuth ClientId です。 kindOAuth されている場合は必須 文字列
コード OAuthコード。 kindOAuth されている場合は必須 string

制約:
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。
インストールID アプリケーション のインストール ID。 kindAppされている場合に必要です。 GitHub でのみサポートされます。 文字列
kind リポジトリ アクセス資格情報の種類 「アプリ」
「OAuth」
'PAT' (必須)
状態 OAuth状態。 kindOAuth されている場合は必須 string

制約:
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。
トークン 個人用アクセス トークン。 kindPAT されている場合は必須 string

制約:
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。

リポジトリリソース情報

名前 Description 価値
Webhook ソース管理用に作成された webhook オブジェクト。 Webhook

サービスプリンシパル

名前 Description 価値
資格情報有効期限 サービス プリンシパル資格情報の有効期限。 文字列

SourceControlProperties (ソースコントロールプロパティ)

名前 Description 価値
contentTypes ソース管理コンテンツ タイプの配列。 次のいずれかを含む文字列配列:
'アナリティクスルール'
'オートメーションルール'
'ハンティングクエリ'
「パーサー」
「プレイブック」
'ワークブック' (必須)
説明 ソース管理の説明 文字列
ディスプレイ名 ソース管理の表示名 string (必須)
リポジトリ リポジトリ メタデータ。 リポジトリ (必須)
リポジトリアクセス リポジトリ アクセス資格情報。 これは書き込み専用オブジェクトであり、ユーザーに戻ることはありません。 リポジトリアクセス
リポジトリリソース情報 ユーザーのリポジトリに作成されたリソースに関する情報。 リポジトリリソース情報
リポジトリタイプ ソース管理のリポジトリの種類 'AzureDevOps'
'Github' (必須)
servicePrincipal サービス プリンシパルのメタデータ。 ServicePrincipal

Webhook

名前 Description 価値
回転Webhookシークレット Webhook シークレットをローテーションするようにバックエンド サービスに指示するフラグ。 ブール (bool)