Data Connectors - Create Or Update

リファレンス

サービス:: Sentinel

API バージョン:: 2024-03-01

データコネクタを作成または更新します。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/providers/Microsoft.SecurityInsights/dataConnectors/{dataConnectorId}?api-version=2024-03-01

URI パラメーター

名前	/	必須	型	説明
dataConnectorId	path	True	string	コネクタ ID
resourceGroupName	path	True	string	リソースグループの名前。名前の大文字と小文字は区別されます。
subscriptionId	path	True	string	ターゲットサブスクリプションの ID。
workspaceName	path	True	string	ワークスペースの名前。正規表現パターン: `^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$`
api-version	query	True	string	この操作に使用する API バージョン。

要求本文

要求本文は、次のいずれかの可能性があります。

名前	説明
AADDataConnector	AAD (Azure Active Directory) データコネクタを表します。
AATPDataConnector	AATP (Azure Advanced Threat Protection) データコネクタを表します。
ASCDataConnector	ASC (Azure Security Center) データコネクタを表します。
AwsCloudTrailDataConnector	アマゾンウェブサービス CloudTrail データコネクタを表します。
MCASDataConnector	MCAS (Microsoft Cloud App Security) データコネクタを表します。
MDATPDataConnector	MDATP (Microsoft Defender Advanced Threat Protection) データコネクタを表します。
OfficeDataConnector	Office データコネクタを表します。
TIDataConnector	脅威インテリジェンスデータコネクタを表します。

AADDataConnector

AAD (Azure Active Directory) データコネクタを表します。

名前	必須	型	説明
kind	True	string: AzureActiveDirectory	データコネクタの種類
etag		string	Azure リソースの Etag
properties.dataTypes		AlertsDataTypeOfDataConnector	コネクタで使用できるデータ型。
properties.tenantId		string	接続してデータを取得するテナント ID。

AATPDataConnector

AATP (Azure Advanced Threat Protection) データコネクタを表します。

名前	必須	型	説明
kind	True	string: AzureAdvancedThreatProtection	データコネクタの種類
etag		string	Azure リソースの Etag
properties.dataTypes		AlertsDataTypeOfDataConnector	コネクタで使用できるデータ型。
properties.tenantId		string	接続してデータを取得するテナント ID。

ASCDataConnector

ASC (Azure Security Center) データコネクタを表します。

名前	必須	型	説明
kind	True	string: AzureSecurityCenter	データコネクタの種類
etag		string	Azure リソースの Etag
properties.dataTypes		AlertsDataTypeOfDataConnector	コネクタで使用できるデータ型。
properties.subscriptionId		string	接続してデータを取得するサブスクリプション ID。

AwsCloudTrailDataConnector

アマゾンウェブサービス CloudTrail データコネクタを表します。

名前	必須	型	説明
kind	True	string: AmazonWebServicesCloudTrail	データコネクタの種類
etag		string	Azure リソースの Etag
properties.awsRoleArn		string	Aws アカウントへのアクセスに使用される Aws ロール Arn (CloudTrailReadOnly ポリシーを使用)。
properties.dataTypes		AwsCloudTrailDataConnectorDataTypes	コネクタで使用できるデータ型。

MCASDataConnector

MCAS (Microsoft Cloud App Security) データコネクタを表します。

名前	必須	型	説明
kind	True	string: MicrosoftCloudAppSecurity	データコネクタの種類
etag		string	Azure リソースの Etag
properties.dataTypes		MCASDataConnectorDataTypes	コネクタで使用できるデータ型。
properties.tenantId		string	接続してデータを取得するテナント ID。

MDATPDataConnector

MDATP (Microsoft Defender Advanced Threat Protection) データコネクタを表します。

名前	必須	型	説明
kind	True	string: MicrosoftDefenderAdvancedThreatProtection	データコネクタの種類
etag		string	Azure リソースの Etag
properties.dataTypes		AlertsDataTypeOfDataConnector	コネクタで使用できるデータ型。
properties.tenantId		string	接続してデータを取得するテナント ID。

OfficeDataConnector

Office データコネクタを表します。

名前	必須	型	説明
kind	True	string: Office365	データコネクタの種類
etag		string	Azure リソースの Etag
properties.dataTypes		OfficeDataConnectorDataTypes	コネクタで使用できるデータ型。
properties.tenantId		string	接続してデータを取得するテナント ID。

TIDataConnector

脅威インテリジェンスデータコネクタを表します。

名前	必須	型	説明
kind	True	string: ThreatIntelligence	データコネクタの種類
etag		string	Azure リソースの Etag
properties.dataTypes		TIDataConnectorDataTypes	コネクタで使用できるデータ型。
properties.tenantId		string	接続してデータを取得するテナント ID。
properties.tipLookbackPeriod		string	インポートするフィードのルックバック期間。

応答

名前	型	説明
200 OK	DataConnector: AADDataConnector AATPDataConnector ASCDataConnector AwsCloudTrailDataConnector MCASDataConnector MDATPDataConnector TIDataConnector OfficeDataConnector	OK、操作が正常に完了しました
201 Created	DataConnector: AADDataConnector AATPDataConnector ASCDataConnector AwsCloudTrailDataConnector MCASDataConnector MDATPDataConnector TIDataConnector OfficeDataConnector	作成済み
Other Status Codes	CloudError	操作に失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
user_impersonation	ユーザーアカウントの借用

例

Creates or updates an Office365 data connector.

Creates or updates an Threat Intelligence Platform data connector.

Creates or updates an Office365 data connector.

要求のサンプル

HTTP

PUT https://management.azure.com/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/dataConnectors/73e01a99-5cd7-4139-a149-9f2736ff2ab5?api-version=2024-03-01

{
  "kind": "Office365",
  "etag": "\"0300bf09-0000-0000-0000-5c37296e0000\"",
  "properties": {
    "tenantId": "2070ecc9-b4d5-4ae4-adaa-936fa1954fa8",
    "dataTypes": {
      "sharePoint": {
        "state": "Enabled"
      },
      "exchange": {
        "state": "Enabled"
      },
      "teams": {
        "state": "Enabled"
      }
    }
  }
}

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/dataConnectors/73e01a99-5cd7-4139-a149-9f2736ff2ab5",
  "name": "73e01a99-5cd7-4139-a149-9f2736ff2ab5",
  "type": "Microsoft.SecurityInsights/dataConnectors",
  "kind": "Office365",
  "etag": "\"0300bf09-0000-0000-0000-5c37296e0000\"",
  "properties": {
    "tenantId": "2070ecc9-b4d5-4ae4-adaa-936fa1954fa8",
    "dataTypes": {
      "sharePoint": {
        "state": "Enabled"
      },
      "exchange": {
        "state": "Enabled"
      },
      "teams": {
        "state": "Enabled"
      }
    }
  }
}

状態コード:: 201

{
  "id": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/dataConnectors/73e01a99-5cd7-4139-a149-9f2736ff2ab5",
  "name": "73e01a99-5cd7-4139-a149-9f2736ff2ab5",
  "type": "Microsoft.SecurityInsights/dataConnectors",
  "kind": "Office365",
  "etag": "\"0300bf09-0000-0000-0000-5c37296e0000\"",
  "properties": {
    "tenantId": "2070ecc9-b4d5-4ae4-adaa-936fa1954fa8",
    "dataTypes": {
      "sharePoint": {
        "state": "Enabled"
      },
      "exchange": {
        "state": "Enabled"
      },
      "teams": {
        "state": "Enabled"
      }
    }
  }
}

Creates or updates an Threat Intelligence Platform data connector.

要求のサンプル

HTTP

PUT https://management.azure.com/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/dataConnectors/73e01a99-5cd7-4139-a149-9f2736ff2ab5?api-version=2024-03-01

{
  "kind": "ThreatIntelligence",
  "properties": {
    "tenantId": "06b3ccb8-1384-4bcc-aec7-852f6d57161b",
    "tipLookbackPeriod": "2020-01-01T13:00:30.123Z",
    "dataTypes": {
      "indicators": {
        "state": "Enabled"
      }
    }
  }
}

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/dataConnectors/73e01a99-5cd7-4139-a149-9f2736ff2ab5",
  "name": "73e01a99-5cd7-4139-a149-9f2736ff2ab5",
  "type": "Microsoft.SecurityInsights/dataConnectors",
  "kind": "ThreatIntelligence",
  "etag": "\"0300bf09-0000-0000-0000-5c37296e0000\"",
  "properties": {
    "tenantId": "06b3ccb8-1384-4bcc-aec7-852f6d57161b",
    "tipLookbackPeriod": "2020-01-01T13:00:30.123Z",
    "dataTypes": {
      "indicators": {
        "state": "Enabled"
      }
    }
  }
}

状態コード:: 201

{
  "id": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/dataConnectors/73e01a99-5cd7-4139-a149-9f2736ff2ab5",
  "name": "73e01a99-5cd7-4139-a149-9f2736ff2ab5",
  "type": "Microsoft.SecurityInsights/dataConnectors",
  "kind": "ThreatIntelligence",
  "etag": "\"0300bf09-0000-0000-0000-5c37296e0000\"",
  "properties": {
    "tenantId": "06b3ccb8-1384-4bcc-aec7-852f6d57161b",
    "tipLookbackPeriod": "2020-01-01T13:00:30.123Z",
    "dataTypes": {
      "indicators": {
        "state": "Enabled"
      }
    }
  }
}

定義

名前	説明
AADDataConnector	AAD (Azure Active Directory) データコネクタを表します。
AATPDataConnector	AATP (Azure Advanced Threat Protection) データコネクタを表します。
AlertsDataTypeOfDataConnector	データコネクタのデータ型を警告します。
ASCDataConnector	ASC (Azure Security Center) データコネクタを表します。
AwsCloudTrailDataConnector	アマゾンウェブサービス CloudTrail データコネクタを表します。
AwsCloudTrailDataConnectorDataTypes	アマゾンウェブサービス CloudTrail データコネクタで使用できるデータ型。
CloudError	エラー応答の構造。
CloudErrorBody	エラーの詳細。
createdByType	リソースを作成した ID の種類。
DataConnectorDataTypeCommon	データコネクタのデータ型の共通フィールド。
DataConnectorKind	データコネクタの種類
DataTypeState	このデータ型接続が有効かどうかを説明します。
Exchange	Exchange データ型の接続。
Indicators	インジケーター接続のデータ型。
Logs	データ型をログに記録します。
MCASDataConnector	MCAS (Microsoft Cloud App Security) データコネクタを表します。
MCASDataConnectorDataTypes	MCAS (Microsoft Cloud App Security) データコネクタで使用できるデータ型。
MDATPDataConnector	MDATP (Microsoft Defender Advanced Threat Protection) データコネクタを表します。
OfficeDataConnector	Office データコネクタを表します。
OfficeDataConnectorDataTypes	Office データコネクタで使用できるデータ型。
SharePoint	SharePoint データ型の接続。
systemData	リソースの作成と最後の変更に関連するメタデータ。
Teams	Teams データ型の接続。
TIDataConnector	脅威インテリジェンスデータコネクタを表します。
TIDataConnectorDataTypes	TI (脅威インテリジェンス) データコネクタで使用できるデータ型。

AADDataConnector

AAD (Azure Active Directory) データコネクタを表します。

名前	型	説明
etag	string	Azure リソースの Etag
id	string	リソースの完全修飾リソース ID。例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
kind	string: AzureActiveDirectory	データコネクタの種類
name	string	リソースの名前
properties.dataTypes	AlertsDataTypeOfDataConnector	コネクタで使用できるデータ型。
properties.tenantId	string	接続してデータを取得するテナント ID。
systemData	systemData	createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。
type	string	リソースの型。例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

AATPDataConnector

AATP (Azure Advanced Threat Protection) データコネクタを表します。

名前	型	説明
etag	string	Azure リソースの Etag
id	string	リソースの完全修飾リソース ID。例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
kind	string: AzureAdvancedThreatProtection	データコネクタの種類
name	string	リソースの名前
properties.dataTypes	AlertsDataTypeOfDataConnector	コネクタで使用できるデータ型。
properties.tenantId	string	接続してデータを取得するテナント ID。
systemData	systemData	createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。
type	string	リソースの型。例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

AlertsDataTypeOfDataConnector

データコネクタのデータ型を警告します。

名前	型	説明
alerts	DataConnectorDataTypeCommon	データ型の接続を警告します。

ASCDataConnector

ASC (Azure Security Center) データコネクタを表します。

名前	型	説明
etag	string	Azure リソースの Etag
id	string	リソースの完全修飾リソース ID。例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
kind	string: AzureSecurityCenter	データコネクタの種類
name	string	リソースの名前
properties.dataTypes	AlertsDataTypeOfDataConnector	コネクタで使用できるデータ型。
properties.subscriptionId	string	接続してデータを取得するサブスクリプション ID。
systemData	systemData	createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。
type	string	リソースの型。例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

AwsCloudTrailDataConnector

アマゾンウェブサービス CloudTrail データコネクタを表します。

名前	型	説明
etag	string	Azure リソースの Etag
id	string	リソースの完全修飾リソース ID。例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
kind	string: AmazonWebServicesCloudTrail	データコネクタの種類
name	string	リソースの名前
properties.awsRoleArn	string	Aws アカウントへのアクセスに使用される AWS ロール Arn (CloudTrailReadOnly ポリシーを使用)。
properties.dataTypes	AwsCloudTrailDataConnectorDataTypes	コネクタで使用できるデータ型。
systemData	systemData	createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。
type	string	リソースの型。例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

AwsCloudTrailDataConnectorDataTypes

アマゾンウェブサービス CloudTrail データコネクタで使用できるデータ型。

名前	型	説明
logs	Logs	データ型をログに記録します。

CloudError

エラー応答の構造。

名前	型	説明
error	CloudErrorBody	エラーデータ

CloudErrorBody

エラーの詳細。

名前	型	説明
code	string	エラーの識別子。コードは不変であり、プログラムによって使用されることを意図しています。
message	string	ユーザーインターフェイスでの表示に適したエラーを説明するメッセージ。

createdByType

リソースを作成した ID の種類。

名前	型	説明
Application	string
Key	string
ManagedIdentity	string
User	string

DataConnectorDataTypeCommon

データコネクタのデータ型の共通フィールド。

名前	型	説明
state	DataTypeState	このデータ型接続が有効かどうかを説明します。

DataConnectorKind

データコネクタの種類

名前	型	説明
AmazonWebServicesCloudTrail	string
AzureActiveDirectory	string
AzureAdvancedThreatProtection	string
AzureSecurityCenter	string
MicrosoftCloudAppSecurity	string
MicrosoftDefenderAdvancedThreatProtection	string
Office365	string
ThreatIntelligence	string

DataTypeState

このデータ型接続が有効かどうかを説明します。

名前	型	説明
Disabled	string
Enabled	string

Exchange

Exchange データ型の接続。

名前	型	説明
state	DataTypeState	このデータ型接続が有効かどうかを説明します。

Indicators

インジケーター接続のデータ型。

名前	型	説明
state	DataTypeState	このデータ型接続が有効かどうかを説明します。

Logs

データ型をログに記録します。

名前	型	説明
state	DataTypeState	このデータ型接続が有効かどうかを説明します。

MCASDataConnector

MCAS (Microsoft Cloud App Security) データコネクタを表します。

名前	型	説明
etag	string	Azure リソースの Etag
id	string	リソースの完全修飾リソース ID。例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
kind	string: MicrosoftCloudAppSecurity	データコネクタの種類
name	string	リソースの名前
properties.dataTypes	MCASDataConnectorDataTypes	コネクタで使用できるデータ型。
properties.tenantId	string	接続してデータを取得するテナント ID。
systemData	systemData	createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。
type	string	リソースの型。例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

MCASDataConnectorDataTypes

MCAS (Microsoft Cloud App Security) データコネクタで使用できるデータ型。

名前	型	説明
alerts	DataConnectorDataTypeCommon	データ型の接続を警告します。
discoveryLogs	DataConnectorDataTypeCommon	検出ログのデータ型の接続。

MDATPDataConnector

MDATP (Microsoft Defender Advanced Threat Protection) データコネクタを表します。

名前	型	説明
etag	string	Azure リソースの Etag
id	string	リソースの完全修飾リソース ID。例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
kind	string: MicrosoftDefenderAdvancedThreatProtection	データコネクタの種類
name	string	リソースの名前
properties.dataTypes	AlertsDataTypeOfDataConnector	コネクタで使用できるデータ型。
properties.tenantId	string	接続してデータを取得するテナント ID。
systemData	systemData	createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。
type	string	リソースの型。例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

OfficeDataConnector

Office データコネクタを表します。

名前	型	説明
etag	string	Azure リソースの Etag
id	string	リソースの完全修飾リソース ID。例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
kind	string: Office365	データコネクタの種類
name	string	リソースの名前
properties.dataTypes	OfficeDataConnectorDataTypes	コネクタで使用できるデータ型。
properties.tenantId	string	接続してデータを取得するテナント ID。
systemData	systemData	createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。
type	string	リソースの型。例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

OfficeDataConnectorDataTypes

Office データコネクタで使用できるデータ型。

名前	型	説明
exchange	Exchange	Exchange データ型の接続。
sharePoint	SharePoint	SharePoint データ型の接続。
teams	Teams	Teams データ型の接続。

SharePoint

SharePoint データ型の接続。

名前	型	説明
state	DataTypeState	このデータ型接続が有効かどうかを説明します。

systemData

リソースの作成と最後の変更に関連するメタデータ。

名前	型	説明
createdAt	string	リソース作成のタイムスタンプ (UTC)。
createdBy	string	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。

Teams

Teams データ型の接続。

名前	型	説明
state	DataTypeState	このデータ型接続が有効かどうかを説明します。

TIDataConnector

脅威インテリジェンスデータコネクタを表します。

名前	型	説明
etag	string	Azure リソースの Etag
id	string	リソースの完全修飾リソース ID。例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
kind	string: ThreatIntelligence	データコネクタの種類
name	string	リソースの名前
properties.dataTypes	TIDataConnectorDataTypes	コネクタで使用できるデータ型。
properties.tenantId	string	接続してデータを取得するテナント ID。
properties.tipLookbackPeriod	string	インポートするフィードのルックバック期間。
systemData	systemData	createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。
type	string	リソースの型。例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

TIDataConnectorDataTypes

TI (脅威インテリジェンス) データコネクタで使用できるデータ型。

名前	型	説明
indicators	Indicators	インジケーター接続のデータ型。

次の方法で共有

Data Connectors - Create Or Update

URI パラメーター

要求本文

AADDataConnector

AATPDataConnector

ASCDataConnector

AwsCloudTrailDataConnector

MCASDataConnector

MDATPDataConnector

OfficeDataConnector

TIDataConnector

応答

セキュリティ

azure_auth

スコープ

例

Creates or updates an Office365 data connector.

要求のサンプル

応答のサンプル

Creates or updates an Threat Intelligence Platform data connector.

要求のサンプル

応答のサンプル

定義

AADDataConnector

AATPDataConnector

AlertsDataTypeOfDataConnector

ASCDataConnector

AwsCloudTrailDataConnector

AwsCloudTrailDataConnectorDataTypes

CloudError

CloudErrorBody

createdByType

DataConnectorDataTypeCommon

DataConnectorKind

DataTypeState

Exchange

Indicators

Logs

MCASDataConnector

MCASDataConnectorDataTypes

MDATPDataConnector

OfficeDataConnector

OfficeDataConnectorDataTypes

SharePoint

systemData

Teams

TIDataConnector

TIDataConnectorDataTypes

その他のリソース