Clusters - Create Or Update

サービス:: Azure Kusto

API バージョン:: 2025-02-14

Kusto クラスターを作成または更新します。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}?api-version=2025-02-14

URI パラメーター

名前	/	必須	型	説明
clusterName	path	True	string pattern: ^.*$	Kusto クラスターの名前。
resourceGroupName	path	True	string minLength: 1 maxLength: 90	リソースグループの名前。名前の大文字と小文字は区別されません。
subscriptionId	path	True	string minLength: 1	ターゲットサブスクリプションの ID。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

要求ヘッダー

名前	必須	型	説明
If-Match		string	クラスターの ETag。現在のクラスターを常に上書きするには、この値を省略します。同時変更が誤って上書きされないように、最後に表示された ETag 値を指定します。
If-None-Match		string	新しいクラスターの作成を許可するが、既存のクラスターを更新できないようにするには、'*' に設定します。その他の値は、412 の事前条件失敗応答になります。

要求本文

名前	必須	型	説明
location	True	string	リソースが存在する地理的な場所
sku	True	AzureSku	クラスターの SKU。
identity		Identity	クラスターの ID (構成されている場合)。
properties.acceptedAudiences		AcceptedAudiences[]	クラスターの受け入れ対象ユーザー。
properties.allowedFqdnList		string[]	クラスターからのエグレスで許可される FQDN (完全修飾ドメイン名) の一覧。
properties.allowedIpRangeList		string[]	クラスターへの接続が許可されている CIDR 形式の IP の一覧。
properties.calloutPolicies		CalloutPolicy[]	クラスターからのエグレスのコールアウトポリシーの一覧。
properties.enableAutoStop		boolean	クラスターを自動的に停止できるかどうかを示すブール値 (データが不足しているか、何日間もアクティビティがないため)。
properties.enableDiskEncryption		boolean	クラスターのディスクが暗号化されているかどうかを示すブール値。
properties.enableDoubleEncryption		boolean	二重暗号化が有効かどうかを示すブール値。
properties.enablePurge		boolean	消去操作が有効かどうかを示すブール値。
properties.enableStreamingIngest		boolean	ストリーミングインジェストが有効かどうかを示すブール値。
properties.engineType		EngineType	エンジンの種類
properties.keyVaultProperties		KeyVaultProperties	クラスター暗号化の KeyVault プロパティ。
properties.languageExtensions		LanguageExtensionsList	クラスターの言語拡張機能の一覧。
properties.optimizedAutoscale		OptimizedAutoscale	最適化された自動スケール定義。
properties.publicIPType		PublicIPType	作成するパブリック IP の種類 (IPv4 (既定))、または DualStack (IPv4 と IPv6 の両方) を示します
properties.publicNetworkAccess		PublicNetworkAccess	クラスターへのパブリックネットワークアクセスは、既定で有効になっています。無効にすると、クラスターへのプライベートエンドポイント接続のみが許可されます
properties.restrictOutboundNetworkAccess		ClusterNetworkAccessFlag	送信ネットワークアクセスを制限するかどうか。値は省略可能ですが、渡される場合は 'Enabled' または 'Disabled' である必要があります
properties.trustedExternalTenants		TrustedExternalTenant[]	クラスターの外部テナント。
properties.virtualClusterGraduationProperties		string (password)	仮想クラスターの卒業プロパティ
properties.virtualNetworkConfiguration		VirtualNetworkConfiguration	仮想ネットワーク定義。
tags		object	リソースタグ。
zones		string[]	可用性ゾーン。

応答

名前	型	説明
200 OK	Cluster	リソース 'Cluster' 更新操作に成功しました
201 Created	Cluster	リソース 'Cluster' の作成操作が成功しましたヘッダー Location: string Retry-After: integer
Other Status Codes	ErrorResponse	予期しないエラー応答。

名前

型

説明

200 OK

Cluster

リソース 'Cluster' 更新操作に成功しました

201 Created

Cluster

リソース 'Cluster' の作成操作が成功しました

ヘッダー

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

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

スコープ

名前	説明
user_impersonation	ユーザーアカウントを偽装する

例

KustoClusterCreateWithCMKFederatedIdentity

KustoClusterCreateWithCMKUserAssignedIdentity

KustoClustersCreateOrUpdate

KustoClusterCreateWithCMKFederatedIdentity

要求のサンプル

HTTP

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.Kusto/clusters/kustoClusterCMK?api-version=2025-02-14

{
  "location": "westus",
  "sku": {
    "name": "Standard_L16as_v3",
    "capacity": 2,
    "tier": "Standard"
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity": {}
    }
  },
  "properties": {
    "enableStreamingIngest": true,
    "enablePurge": true,
    "enableDoubleEncryption": false,
    "enableAutoStop": true,
    "publicIPType": "IPv4",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled",
    "keyVaultProperties": {
      "keyVaultUri": "https://myvault.vault.azure.net",
      "keyName": "myClusterCMKKey",
      "keyVersion": "12345678-1234-1234-1234-123456789098",
      "userIdentity": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity",
      "federatedIdentityClientId": "11111111-2222-3333-4444-555555555555"
    },
    "engineType": "V3"
  }
}

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.Kusto/Clusters/kustoClusterCMK",
  "name": "kustoClusterCMK",
  "type": "Microsoft.Kusto/Clusters",
  "location": "westus",
  "properties": {
    "provisioningState": "Succeeded",
    "enableDiskEncryption": false,
    "enableStreamingIngest": true,
    "enablePurge": true,
    "enableDoubleEncryption": false,
    "enableAutoStop": true,
    "publicIPType": "IPv4",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled",
    "keyVaultProperties": {
      "keyVaultUri": "https://myvault.vault.azure.net",
      "keyName": "myClusterCMKKey",
      "keyVersion": "12345678-1234-1234-1234-123456789098",
      "userIdentity": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity",
      "federatedIdentityClientId": "11111111-2222-3333-4444-555555555555"
    },
    "engineType": "V3"
  },
  "sku": {
    "name": "Standard_L16as_v3",
    "tier": "Standard",
    "capacity": 2
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity": {
        "clientId": "11111111-2222-3333-4444-555555555555",
        "principalId": "66666666-7777-8888-9999-000000000000"
      }
    }
  },
  "etag": "abcd1234"
}

状態コード:: 201

Azure-AsyncOperation: https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789098/providers/Microsoft.Kusto/locations/westus/operationResults/742bef43-608b-4b58-ba96-6f7a32ec5f0f?api-version=2025-02-14

{
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.Kusto/Clusters/kustoClusterCMK",
  "name": "kustoClusterCMK",
  "type": "Microsoft.Kusto/Clusters",
  "location": "westus",
  "properties": {
    "provisioningState": "Running",
    "enableDiskEncryption": false,
    "enableStreamingIngest": true,
    "enablePurge": true,
    "enableDoubleEncryption": false,
    "enableAutoStop": true,
    "publicIPType": "IPv4",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled",
    "keyVaultProperties": {
      "keyVaultUri": "https://myvault.vault.azure.net",
      "keyName": "myClusterCMKKey",
      "keyVersion": "12345678-1234-1234-1234-123456789098",
      "userIdentity": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity",
      "federatedIdentityClientId": "11111111-2222-3333-4444-555555555555"
    },
    "engineType": "V3"
  },
  "sku": {
    "name": "Standard_L16as_v3",
    "tier": "Standard",
    "capacity": 2
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity": {
        "clientId": "11111111-2222-3333-4444-555555555555",
        "principalId": "66666666-7777-8888-9999-000000000000"
      }
    }
  },
  "etag": "abcd1234"
}

KustoClusterCreateWithCMKUserAssignedIdentity

要求のサンプル

HTTP

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.Kusto/clusters/kustoClusterCMK?api-version=2025-02-14

{
  "location": "westus",
  "sku": {
    "name": "Standard_L16as_v3",
    "capacity": 2,
    "tier": "Standard"
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity": {}
    }
  },
  "properties": {
    "enableStreamingIngest": true,
    "enablePurge": true,
    "enableDoubleEncryption": false,
    "enableAutoStop": true,
    "publicIPType": "IPv4",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled",
    "keyVaultProperties": {
      "keyVaultUri": "https://myvault.vault.azure.net",
      "keyName": "myClusterCMKKey",
      "keyVersion": "12345678-1234-1234-1234-123456789098",
      "userIdentity": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity"
    },
    "engineType": "V3"
  }
}

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.Kusto/Clusters/kustoClusterCMK",
  "name": "kustoClusterCMK",
  "type": "Microsoft.Kusto/Clusters",
  "location": "westus",
  "properties": {
    "provisioningState": "Succeeded",
    "enableDiskEncryption": false,
    "enableStreamingIngest": true,
    "enablePurge": true,
    "enableDoubleEncryption": false,
    "enableAutoStop": true,
    "publicIPType": "IPv4",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled",
    "keyVaultProperties": {
      "keyVaultUri": "https://myvault.vault.azure.net",
      "keyName": "myClusterCMKKey",
      "keyVersion": "12345678-1234-1234-1234-123456789098",
      "userIdentity": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity"
    },
    "engineType": "V3"
  },
  "sku": {
    "name": "Standard_L16as_v3",
    "tier": "Standard",
    "capacity": 2
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity": {
        "clientId": "11111111-2222-3333-4444-555555555555",
        "principalId": "66666666-7777-8888-9999-000000000000"
      }
    }
  },
  "etag": "abcd1234"
}

状態コード:: 201

Azure-AsyncOperation: https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789098/providers/Microsoft.Kusto/locations/westus/operationResults/742bef43-608b-4b58-ba96-6f7a32ec5f0f?api-version=2025-02-14

{
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.Kusto/Clusters/kustoClusterCMK",
  "name": "kustoClusterCMK",
  "type": "Microsoft.Kusto/Clusters",
  "location": "westus",
  "properties": {
    "provisioningState": "Running",
    "enableDiskEncryption": false,
    "enableStreamingIngest": true,
    "enablePurge": true,
    "enableDoubleEncryption": false,
    "enableAutoStop": true,
    "publicIPType": "IPv4",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled",
    "keyVaultProperties": {
      "keyVaultUri": "https://myvault.vault.azure.net",
      "keyName": "myClusterCMKKey",
      "keyVersion": "12345678-1234-1234-1234-123456789098",
      "userIdentity": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity"
    },
    "engineType": "V3"
  },
  "sku": {
    "name": "Standard_L16as_v3",
    "tier": "Standard",
    "capacity": 2
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity": {
        "clientId": "11111111-2222-3333-4444-555555555555",
        "principalId": "66666666-7777-8888-9999-000000000000"
      }
    }
  },
  "etag": "abcd1234"
}

KustoClustersCreateOrUpdate

要求のサンプル

HTTP

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Kusto/clusters/kustoCluster?api-version=2025-02-14

{
  "identity": {
    "type": "SystemAssigned"
  },
  "location": "westus",
  "properties": {
    "allowedIpRangeList": [
      "0.0.0.0/0"
    ],
    "enableAutoStop": true,
    "enableDoubleEncryption": false,
    "enablePurge": true,
    "enableStreamingIngest": true,
    "languageExtensions": {
      "value": [
        {
          "languageExtensionImageName": "Python3_10_8",
          "languageExtensionName": "PYTHON"
        },
        {
          "languageExtensionImageName": "R",
          "languageExtensionName": "R"
        }
      ]
    },
    "publicIPType": "DualStack",
    "publicNetworkAccess": "Enabled"
  },
  "sku": {
    "name": "Standard_L16as_v3",
    "capacity": 2,
    "tier": "Standard"
  }
}

応答のサンプル

状態コード:: 200

{
  "name": "kustoCluster",
  "type": "Microsoft.Kusto/Clusters",
  "etag": "abcd",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Kusto/Clusters/kustoCluster",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "faabad1f-4876-463c-af9d-6ba2d2d2394c",
    "tenantId": "b932977f-6277-4ab7-a2cd-5bd21f07aaf4",
    "userAssignedIdentities": {}
  },
  "location": "westus",
  "properties": {
    "allowedIpRangeList": [
      "0.0.0.0/0"
    ],
    "enableAutoStop": true,
    "enableDiskEncryption": false,
    "enableDoubleEncryption": false,
    "enablePurge": true,
    "enableStreamingIngest": true,
    "engineType": "V3",
    "keyVaultProperties": {
      "keyName": "keyName",
      "keyVaultUri": "https://dummy.keyvault.com",
      "keyVersion": "keyVersion"
    },
    "languageExtensions": {
      "value": [
        {
          "languageExtensionImageName": "Python3_10_8",
          "languageExtensionName": "PYTHON"
        },
        {
          "languageExtensionImageName": "R",
          "languageExtensionName": "R"
        }
      ]
    },
    "provisioningState": "Succeeded",
    "publicIPType": "DualStack",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled"
  },
  "sku": {
    "name": "Standard_L16as_v3",
    "capacity": 2,
    "tier": "Standard"
  }
}

状態コード:: 201

{
  "name": "kustoCluster",
  "type": "Microsoft.Kusto/Clusters",
  "etag": "abcd123",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Kusto/Clusters/kustoCluster",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "faabad1f-4876-463c-af9d-6ba2d2d2394c",
    "tenantId": "b932977f-6277-4ab7-a2cd-5bd21f07aaf4",
    "userAssignedIdentities": {}
  },
  "location": "westus",
  "properties": {
    "allowedIpRangeList": [
      "0.0.0.0/0"
    ],
    "enableAutoStop": true,
    "enableDiskEncryption": false,
    "enableDoubleEncryption": false,
    "enablePurge": true,
    "enableStreamingIngest": true,
    "engineType": "V3",
    "keyVaultProperties": {
      "keyName": "keyName",
      "keyVaultUri": "https://dummy.keyvault.com",
      "keyVersion": "keyVersion"
    },
    "languageExtensions": {
      "value": [
        {
          "languageExtensionImageName": "Python3_10_8",
          "languageExtensionName": "PYTHON"
        },
        {
          "languageExtensionImageName": "R",
          "languageExtensionName": "R"
        }
      ]
    },
    "provisioningState": "Succeeded",
    "publicIPType": "DualStack",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled"
  },
  "sku": {
    "name": "Standard_L16as_v3",
    "capacity": 2,
    "tier": "Standard"
  }
}

定義

名前	説明
AcceptedAudiences	クラスターに信頼される受け入れられたオーディエンスを表しています。
AzureSku	Azure SKU definition.
AzureSkuName	SKU 名。
AzureSkuTier	SKU レベル。
CalloutPolicy	外部コールアウトポリシーの設定(URIパターン、アクセスタイプ、サービスタイプなど)。
CalloutType	アクセスする外部リソースまたはサービスの種類を指定する、コールアウトサービスの種類。
Cluster	クラスはクストクラスターを表します。
ClusterNetworkAccessFlag	送信ネットワークアクセスを制限するかどうか。値は省略可能ですが、渡される場合は 'Enabled' または 'Disabled' である必要があります
ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties
createdByType	リソースを作成した ID の種類。
EngineType	エンジンの種類
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
Identity	リソースの ID。
IdentityType	使用されるマネージド ID の種類。型 'SystemAssigned, UserAssigned' には、暗黙的に作成された ID とユーザー割り当て ID のセットの両方が含まれます。型 'None' は、すべての ID を削除します。
KeyVaultProperties	キーコンテナーのプロパティ。
LanguageExtension	言語拡張オブジェクトです。
LanguageExtensionImageName	言語拡張画像名。
LanguageExtensionName	KQLクエリ内で動作可能な言語拡張。
LanguageExtensionsList	言語拡張オブジェクトのリスト。
MigrationClusterProperties	移動の一部であるクラスタの性質を表します。
MigrationClusterRole	移住プロセスにおけるクラスターの役割。
OptimizedAutoscale	最適化された自動スケール定義を含むクラスです。
OutboundAccess	指定した URI パターンに対して送信アクセスが許可されているかどうかを示します。
PrivateEndpointConnection	プライベートエンドポイント接続
PrivateEndpointProperty	接続が属するプライベートエンドポイント。
PrivateLinkServiceConnectionStateProperty	プライベートエンドポイント接続の接続状態。
ProvisioningState	リソースのプロビジョニング済み状態。
PublicIPType	作成するパブリック IP の種類 (IPv4 (既定))、または DualStack (IPv4 と IPv6 の両方) を示します
PublicNetworkAccess	クラスターへのパブリックネットワークアクセスは、既定で有効になっています。無効にすると、クラスターへのプライベートエンドポイント接続のみが許可されます
State	資源の状態です。
systemData	リソースの作成と最後の変更に関連するメタデータ。
TrustedExternalTenant	クラスタが信頼するテナントIDを表します。
VirtualNetworkConfiguration	仮想ネットワーク定義を含むクラスです。
VnetState	有効にすると、クラスターは構成済みのサブネットにデプロイされ、無効にするとサブネットから削除されます。
ZoneStatus	星団がゾーン性か非ゾーン性かを示します。

AcceptedAudiences

Object

クラスターに信頼される受け入れられたオーディエンスを表しています。

名前	型	説明
value	string	受け入れられた対象ユーザーを表す GUID または有効な URL。

AzureSku

Object

Azure SKU definition.

名前	型	説明
capacity	integer (int32)	クラスターのインスタンスの数。
name	AzureSkuName	SKU 名。
tier	AzureSkuTier	SKU レベル。

AzureSkuName

列挙

SKU 名。

値	説明
Dev(No SLA)_Standard_D11_v2	Dev(No SLA)_Standard_D11_v2
Dev(No SLA)_Standard_E2a_v4	Dev(No SLA)_Standard_E2a_v4
Standard_D11_v2	Standard_D11_v2
Standard_D12_v2	Standard_D12_v2
Standard_D13_v2	Standard_D13_v2
Standard_D14_v2	Standard_D14_v2
Standard_D32d_v4	Standard_D32d_v4
Standard_D16d_v5	Standard_D16d_v5
Standard_D32d_v5	Standard_D32d_v5
Standard_DS13_v2+1TB_PS	Standard_DS13_v2+1TB_PS
Standard_DS13_v2+2TB_PS	Standard_DS13_v2+2TB_PS
Standard_DS14_v2+3TB_PS	Standard_DS14_v2+3TB_PS
Standard_DS14_v2+4TB_PS	Standard_DS14_v2+4TB_PS
Standard_L4s	Standard_L4s
Standard_L8s	Standard_L8s
Standard_L16s	Standard_L16s
Standard_L8s_v2	Standard_L8s_v2
Standard_L16s_v2	Standard_L16s_v2
Standard_L8s_v3	Standard_L8s_v3
Standard_L16s_v3	Standard_L16s_v3
Standard_L32s_v3	Standard_L32s_v3
Standard_L8as_v3	Standard_L8as_v3
Standard_L16as_v3	Standard_L16as_v3
Standard_L32as_v3	Standard_L32as_v3
Standard_E64i_v3	Standard_E64i_v3
Standard_E80ids_v4	Standard_E80ids_v4
Standard_E2a_v4	Standard_E2a_v4
Standard_E4a_v4	Standard_E4a_v4
Standard_E8a_v4	Standard_E8a_v4
Standard_E16a_v4	Standard_E16a_v4
Standard_E8as_v4+1TB_PS	Standard_E8as_v4+1TB_PS
Standard_E8as_v4+2TB_PS	Standard_E8as_v4+2TB_PS
Standard_E16as_v4+3TB_PS	Standard_E16as_v4+3TB_PS
Standard_E16as_v4+4TB_PS	Standard_E16as_v4+4TB_PS
Standard_E8as_v5+1TB_PS	Standard_E8as_v5+1TB_PS
Standard_E8as_v5+2TB_PS	Standard_E8as_v5+2TB_PS
Standard_E16as_v5+3TB_PS	Standard_E16as_v5+3TB_PS
Standard_E16as_v5+4TB_PS	Standard_E16as_v5+4TB_PS
Standard_E2ads_v5	Standard_E2ads_v5
Standard_E4ads_v5	Standard_E4ads_v5
Standard_E8ads_v5	Standard_E8ads_v5
Standard_E16ads_v5	Standard_E16ads_v5
Standard_EC8as_v5+1TB_PS	Standard_EC8as_v5+1TB_PS
Standard_EC8as_v5+2TB_PS	Standard_EC8as_v5+2TB_PS
Standard_EC16as_v5+3TB_PS	Standard_EC16as_v5+3TB_PS
Standard_EC16as_v5+4TB_PS	Standard_EC16as_v5+4TB_PS
Standard_EC8ads_v5	Standard_EC8ads_v5
Standard_EC16ads_v5	Standard_EC16ads_v5
Standard_E8s_v4+1TB_PS	Standard_E8s_v4+1TB_PS
Standard_E8s_v4+2TB_PS	Standard_E8s_v4+2TB_PS
Standard_E16s_v4+3TB_PS	Standard_E16s_v4+3TB_PS
Standard_E16s_v4+4TB_PS	Standard_E16s_v4+4TB_PS
Standard_E8s_v5+1TB_PS	Standard_E8s_v5+1TB_PS
Standard_E8s_v5+2TB_PS	Standard_E8s_v5+2TB_PS
Standard_E16s_v5+3TB_PS	Standard_E16s_v5+3TB_PS
Standard_E16s_v5+4TB_PS	Standard_E16s_v5+4TB_PS
Standard_E2d_v4	Standard_E2d_v4
Standard_E4d_v4	Standard_E4d_v4
Standard_E8d_v4	Standard_E8d_v4
Standard_E16d_v4	Standard_E16d_v4
Standard_E2d_v5	Standard_E2d_v5
Standard_E4d_v5	Standard_E4d_v5
Standard_E8d_v5	Standard_E8d_v5
Standard_E16d_v5	Standard_E16d_v5

AzureSkuTier

列挙

SKU レベル。

値	説明
Basic	Basic
Standard	Standard

CalloutPolicy

Object

外部コールアウトポリシーの設定(URIパターン、アクセスタイプ、サービスタイプなど)。

名前	型	説明
calloutId	string	吹き出し構成の一意の識別子。
calloutType	CalloutType	アクセスする外部リソースまたはサービスの種類を指定する、コールアウトサービスの種類。
calloutUriRegex	string	吹き出し URI の正規表現または FQDN パターン。
outboundAccess	OutboundAccess	指定した URI パターンに対して送信アクセスが許可されているかどうかを示します。

CalloutType

列挙

アクセスする外部リソースまたはサービスの種類を指定する、コールアウトサービスの種類。

値	説明
kusto	クスト
sql	sql
cosmosdb	cosmosdb
external_data	external_data
azure_digital_twins	azure_digital_twins
sandbox_artifacts	sandbox_artifacts
webapi	webapi (英語)
mysql	mysql
postgresql	postgresql
genevametrics	ジェネヴァメトリクス
azure_openai	azure_openai

Cluster

Object

クラスはクストクラスターを表します。

名前	型	規定値	説明
etag	string		「etagが応答本文で指定されている場合は、通常のetag規則に従ってヘッダーとして提供することもできます。エンティティタグは、同じ要求されたリソースから 2 つ以上のエンティティを比較するために使用されます。 HTTP/1.1 は、etag (セクション 14.19)、If-Match (セクション 14.24)、If-None-Match (セクション 14.26)、および If-Range (セクション 14.27) ヘッダーフィールドでエンティティタグを使用します。
id	string		リソースの完全修飾リソース ID。例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	Identity		クラスターの ID (構成されている場合)。
location	string		リソースが存在する地理的な場所
name	string		リソースの名前
properties.acceptedAudiences	AcceptedAudiences[]		クラスターの受け入れ対象ユーザー。
properties.allowedFqdnList	string[]		クラスターからのエグレスで許可される FQDN (完全修飾ドメイン名) の一覧。
properties.allowedIpRangeList	string[]		クラスターへの接続が許可されている CIDR 形式の IP の一覧。
properties.calloutPolicies	CalloutPolicy[]		クラスターからのエグレスのコールアウトポリシーの一覧。
properties.dataIngestionUri	string		クラスタデータインジェスティングURI。
properties.enableAutoStop	boolean	True	クラスターを自動的に停止できるかどうかを示すブール値 (データが不足しているか、何日間もアクティビティがないため)。
properties.enableDiskEncryption	boolean	False	クラスターのディスクが暗号化されているかどうかを示すブール値。
properties.enableDoubleEncryption	boolean	False	二重暗号化が有効かどうかを示すブール値。
properties.enablePurge	boolean	False	消去操作が有効かどうかを示すブール値。
properties.enableStreamingIngest	boolean	False	ストリーミングインジェストが有効かどうかを示すブール値。
properties.engineType	EngineType	V3	エンジンの種類
properties.keyVaultProperties	KeyVaultProperties		クラスター暗号化の KeyVault プロパティ。
properties.languageExtensions	LanguageExtensionsList		クラスターの言語拡張機能の一覧。
properties.migrationCluster	MigrationClusterProperties		このクラスタへの移行に関与するピアクラスタのプロパティ。
properties.optimizedAutoscale	OptimizedAutoscale		最適化された自動スケール定義。
properties.privateEndpointConnections	PrivateEndpointConnection[]		プライベートエンドポイント接続の一覧。
properties.provisioningState	ProvisioningState		リソースのプロビジョニング済み状態。
properties.publicIPType	PublicIPType	IPv4	作成するパブリック IP の種類 (IPv4 (既定))、または DualStack (IPv4 と IPv6 の両方) を示します
properties.publicNetworkAccess	PublicNetworkAccess	Enabled	クラスターへのパブリックネットワークアクセスは、既定で有効になっています。無効にすると、クラスターへのプライベートエンドポイント接続のみが許可されます
properties.restrictOutboundNetworkAccess	ClusterNetworkAccessFlag	Disabled	送信ネットワークアクセスを制限するかどうか。値は省略可能ですが、渡される場合は 'Enabled' または 'Disabled' である必要があります
properties.state	State		資源の状態です。
properties.stateReason	string		クラスターの現在の状態の理由。
properties.trustedExternalTenants	TrustedExternalTenant[]		クラスターの外部テナント。
properties.uri	string		クラスターURIです。
properties.virtualClusterGraduationProperties	string (password)		仮想クラスターの卒業プロパティ
properties.virtualNetworkConfiguration	VirtualNetworkConfiguration		仮想ネットワーク定義。
properties.zoneStatus	ZoneStatus		星団がゾーン性か非ゾーン性かを示します。
sku	AzureSku		クラスターの SKU。
systemData	systemData		createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。
tags	object		リソースタグ。
type	string		リソースの型。例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"
zones	string[]		可用性ゾーン。

ClusterNetworkAccessFlag

列挙

送信ネットワークアクセスを制限するかどうか。値は省略可能ですが、渡される場合は 'Enabled' または 'Disabled' である必要があります

値	説明
Enabled	有効
Disabled	Disabled

ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties

Object

名前	型	説明
clientId	string	ユーザー割り当て ID のクライアント ID。
principalId	string	ユーザー割り当て ID のプリンシパル ID。

createdByType

列挙

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

値	説明
User
Application
ManagedIdentity
Key

EngineType

列挙

エンジンの種類

値	説明
V2	V2
V3	V3

ErrorAdditionalInfo

Object

リソース管理エラーの追加情報。

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラーコード。
details	ErrorDetail[]	エラーの詳細。
message	string	エラーメッセージ。
target	string	エラーターゲット。

ErrorResponse

Object

エラー応答

名前	型	説明
error	ErrorDetail	エラーオブジェクト。

Identity

Object

リソースの ID。

名前	型	説明
principalId	string	リソース ID のプリンシパル ID。
tenantId	string	リソースのテナント ID。
type	IdentityType	使用されるマネージド ID の種類。型 'SystemAssigned, UserAssigned' には、暗黙的に作成された ID とユーザー割り当て ID のセットの両方が含まれます。型 'None' は、すべての ID を削除します。
userAssignedIdentities	<string, ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties>	Kusto クラスターに関連付けられているユーザー ID の一覧。ユーザー ID ディクショナリのキー参照は、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' という形式の ARM リソース ID になります。

IdentityType

列挙

使用されるマネージド ID の種類。型 'SystemAssigned, UserAssigned' には、暗黙的に作成された ID とユーザー割り当て ID のセットの両方が含まれます。型 'None' は、すべての ID を削除します。

値	説明
None	なし
SystemAssigned	SystemAssigned
UserAssigned	UserAssigned
SystemAssigned, UserAssigned	システム割り当て済み、ユーザー割り当て済み

KeyVaultProperties

Object

キーコンテナーのプロパティ。

名前	型	説明
federatedIdentityClientId	string	マルチテナントのMicrosoft Entraアプリケーションのアプリケーション(クライアントID)。暗号化鍵がクラスターとは異なるテナントに保存されるクロステナントの顧客管理キーシナリオに使用されます。アプリケーションは、ユーザーが割り当てた管理IDをフェデレーテッドID認証として設定する必要があります。
keyName	string	キーコンテナーキーの名前。
keyVaultUri	string	キーコンテナーの URI。
keyVersion	string	キーコンテナーキーのバージョン。
userIdentity	string	キーにアクセスできるユーザー割り当て ID (ARM リソース ID)。アイデンティティはKey Vaultキーに対して「取得」「Wrap Key」「Unwrap Key」の権限を持つか、「Key Vault Crypto Service Encryption User」の役割を割り当てる必要があります。

LanguageExtension

Object

言語拡張オブジェクトです。

名前	型	説明
languageExtensionCustomImageName	string	アクティブな言語拡張として有効にすべきサンドボックスカスタムイメージ名です。サンドボックスカスタムイメージはクラスタのサブリソースです。このプロパティを設定する場合、LanguageExtensionImageNameは「PythonCustomImage」に設定すべきです。
languageExtensionImageName	LanguageExtensionImageName	言語拡張イメージ名。
languageExtensionName	LanguageExtensionName	言語拡張機能の名前。

LanguageExtensionImageName

列挙

言語拡張画像名。

値	説明
R	R
Python3_6_5	Python3_6_5
Python3_10_8	Python3_10_8
Python3_10_8_DL	Python3_10_8_DL
PythonCustomImage	パイソンカスタムイメージ
Python3_11_7	Python3_11_7
Python3_11_7_DL	Python3_11_7_DL

LanguageExtensionName

列挙

KQLクエリ内で動作可能な言語拡張。

値	説明
PYTHON	ニシキヘビ
R	R

LanguageExtensionsList

Object

言語拡張オブジェクトのリスト。

名前	型	説明
nextLink	string	次のリソースページへのリンクです。
value	LanguageExtension[]	言語拡張の一覧。

MigrationClusterProperties

Object

移動の一部であるクラスタの性質を表します。

名前	型	説明
dataIngestionUri	string	クラスタの公開データ取り込みURLです。
id	string	クラスターのリソースID。
role	MigrationClusterRole	移住プロセスにおけるクラスターの役割。
uri	string	クラスターの公開URLです。

MigrationClusterRole

列挙

移住プロセスにおけるクラスターの役割。

値	説明
Source	情報源
Destination	行き先

OptimizedAutoscale

Object

最適化された自動スケール定義を含むクラスです。

名前	型	説明
isEnabled	boolean	最適化された自動スケール機能が有効かどうかを示すブール値。
maximum	integer (int32)	許可されるインスタンスの最大数。
minimum	integer (int32)	許可される最小インスタンス数。
version	integer (int32)	定義されているテンプレートのバージョン (例: 1)。

OutboundAccess

列挙

指定した URI パターンに対して送信アクセスが許可されているかどうかを示します。

値	説明
Allow	許可する
Deny	Deny

PrivateEndpointConnection

Object

プライベートエンドポイント接続

名前	型	説明
id	string	リソースの完全修飾リソース ID。例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	リソースの名前
properties.groupId	string	プライベートエンドポイントのグループ ID。
properties.privateEndpoint	PrivateEndpointProperty	接続が属するプライベートエンドポイント。
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	プライベートエンドポイント接続の接続状態。
properties.provisioningState	string	プライベートエンドポイントのプロビジョニング状態。
systemData	systemData	createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。
type	string	リソースの型。例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

PrivateEndpointProperty

Object

接続が属するプライベートエンドポイント。

名前	型	説明
id	string	プライベートエンドポイントのリソース ID。

PrivateLinkServiceConnectionStateProperty

Object

プライベートエンドポイント接続の接続状態。

名前	型	説明
actionsRequired	string	基本的なワークフローを超えて必要なアクション (承認/拒否/切断)
description	string	プライベートリンクサービスの接続の説明。
status	string	プライベートリンクサービスの接続状態。

ProvisioningState

列挙

リソースのプロビジョニング済み状態。

値	説明
Running	Running
Creating	作成
Deleting	削除中
Succeeded	成功しました
Failed	失敗
Moving	涙ぐましい
Canceled	取り消し済み

PublicIPType

列挙

作成するパブリック IP の種類 (IPv4 (既定))、または DualStack (IPv4 と IPv6 の両方) を示します

値	説明
IPv4	IPv4
DualStack	デュアルスタック

PublicNetworkAccess

列挙

クラスターへのパブリックネットワークアクセスは、既定で有効になっています。無効にすると、クラスターへのプライベートエンドポイント接続のみが許可されます

値	説明
Enabled	有効
Disabled	Disabled
SecuredByPerimeter	SecuredByPerimeter

State

列挙

資源の状態です。

値	説明
Creating	作成
Unavailable	使用不可
Running	Running
Deleting	削除中
Deleted	削除済み
Stopping	停車
Stopped	停止済み
Starting	開始中
Updating	更新中
Migrated	移行されるもの

systemData

Object

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

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

TrustedExternalTenant

Object

クラスタが信頼するテナントIDを表します。

名前	型	説明
value	string	外部テナントを表す GUID。

VirtualNetworkConfiguration

Object

仮想ネットワーク定義を含むクラスです。

名前	型	規定値	説明
dataManagementPublicIpId	string		データ管理のサービスパブリック IP アドレスリソース ID。
enginePublicIpId	string		エンジンサービスのパブリック IP アドレスリソース ID。
state	VnetState	Enabled	有効にすると、クラスターは構成済みのサブネットにデプロイされ、無効にするとサブネットから削除されます。
subnetId	string		サブネットリソース ID。

VnetState

列挙

有効にすると、クラスターは構成済みのサブネットにデプロイされ、無効にするとサブネットから削除されます。

値	説明
Enabled	有効
Disabled	Disabled

ZoneStatus

列挙

星団がゾーン性か非ゾーン性かを示します。

値	説明
NonZonal	ノンゾーン
ZonalInconsistency	ゾーンの不整合
Zonal	ゾーンベース

次の方法で共有

Clusters - Create Or Update

URI パラメーター

要求ヘッダー

要求本文

応答

セキュリティ

azure_auth

スコープ

例

KustoClusterCreateWithCMKFederatedIdentity

要求のサンプル

応答のサンプル

KustoClusterCreateWithCMKUserAssignedIdentity

要求のサンプル

応答のサンプル

KustoClustersCreateOrUpdate

要求のサンプル

応答のサンプル

定義

AcceptedAudiences

AzureSku

AzureSkuName

AzureSkuTier

CalloutPolicy

CalloutType

Cluster

ClusterNetworkAccessFlag

ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties

createdByType

EngineType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Identity

IdentityType

KeyVaultProperties

LanguageExtension

LanguageExtensionImageName

LanguageExtensionName

LanguageExtensionsList

MigrationClusterProperties

MigrationClusterRole

OptimizedAutoscale

OutboundAccess

PrivateEndpointConnection

PrivateEndpointProperty

PrivateLinkServiceConnectionStateProperty

ProvisioningState

PublicIPType

PublicNetworkAccess

State

systemData

TrustedExternalTenant

VirtualNetworkConfiguration

VnetState

ZoneStatus