L 2 Networks - Update

サービス:: Operator Nexus - Network Cloud

API バージョン:: 2025-09-01

レイヤー 2(L2)ネットワークにパッチを適用します。
指定されたレイヤー 2 (L2) ネットワークに関連付けられているタグを更新します。

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/l2Networks/{l2NetworkName}?api-version=2025-09-01

URI パラメーター

名前	/	必須	型	説明
l2NetworkName	path	True	string pattern: ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$	L2 ネットワークの名前。
resourceGroupName	path	True	string minLength: 1 maxLength: 90	リソースグループの名前。名前は大文字と小文字が区別されます。
subscriptionId	path	True	string (uuid)	ターゲットサブスクリプションの ID。値は UUID である必要があります。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

要求ヘッダー

名前	必須	型	説明
If-Match		string	変換の ETag。現在のリソースを常に上書きするには、この値を省略します。同時変更が誤って上書きされないように、最後に表示された ETag 値を指定します。
If-None-Match		string	新しいレコードセットの作成を許可するが、既存のリソースを更新できないようにするには、'*' に設定します。その他の値はサポートされていないため、サーバーからエラーが発生します。

要求本文

名前	型	説明
tags	object	既存のものを置き換える Azure リソースタグ。

応答

名前	型	説明
200 OK	L2Network	リソースは正常に更新されました。
Other Status Codes	ErrorResponse	操作が失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

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

スコープ

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

例

Patch L2 network

要求のサンプル

HTTP

PATCH https://management.azure.com/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l2Networks/l2NetworkName?api-version=2025-09-01

{
  "tags": {
    "key1": "myvalue1",
    "key2": "myvalue2"
  }
}

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l2Networks/l2NetworkName",
  "name": "l2NetworkName",
  "systemData": {
    "createdAt": "2021-01-22T13:27:03.008Z",
    "createdBy": "identityA",
    "createdByType": "Application",
    "lastModifiedAt": "2021-01-22T13:29:03.001Z",
    "lastModifiedBy": "identityB",
    "lastModifiedByType": "User"
  },
  "type": "Microsoft.NetworkCloud/l2Networks",
  "location": "location",
  "tags": {
    "key1": "myvalue1",
    "key2": "myvalue2"
  },
  "extendedLocation": {
    "type": "CustomLocation",
    "name": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterExtendedLocationName"
  },
  "properties": {
    "interfaceName": "eth0",
    "l2IsolationDomainId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ManagedNetworkFabric/l2IsolationDomains/l2IsolationDomainName",
    "provisioningState": "Succeeded",
    "clusterId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/clusters/clusterName",
    "associatedResourceIds": [
      "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/virtualMachines/virtualMachineName"
    ],
    "detailedStatus": "Available",
    "detailedStatusMessage": "L2 network is up"
  }
}

定義

名前	説明
createdByType	リソースを作成した ID の種類。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
ExtendedLocation	ExtendedLocation は、リソースが作成される Azure カスタムの場所を表します。
HybridAksPluginType	フィールドは非推奨です。このフィールドは以前は省略可能でしたが、現在は動作が定義されていないため、無視されます。 Hybrid AKS のネットワークプラグインの種類。
L2Network	L2Network は、レイヤー 2 リソース用に設定された単一の分離ドメインを利用するネットワークを表します。
L2NetworkDetailedStatus	L2 ネットワークのより詳細なステータス。
L2NetworkPatchParameters	L2NetworkPatchParameters は、L2 ネットワークにパッチを適用するリクエストの本文を表します。
L2NetworkProvisioningState	L2 ネットワークのプロビジョニング状態。
systemData	リソースの作成と最後の変更に関連するメタデータ。

createdByType

列挙

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

値	説明
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

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

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

ErrorDetail

Object

エラーの詳細。

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

ErrorResponse

Object

エラー応答

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

ExtendedLocation

Object

ExtendedLocation は、リソースが作成される Azure カスタムの場所を表します。

名前	型	説明
name	string	リソースが作成される拡張された場所のリソース ID。
type	string	拡張された場所の種類 (CustomLocation など)。

HybridAksPluginType

列挙

フィールドは非推奨です。このフィールドは以前は省略可能でしたが、現在は動作が定義されていないため、無視されます。 Hybrid AKS のネットワークプラグインの種類。

値	説明
DPDK
SRIOV
OSDevice

L2Network

Object

L2Network は、レイヤー 2 リソース用に設定された単一の分離ドメインを利用するネットワークを表します。

名前	型	規定値	説明
etag	string		リソース ETag。
extendedLocation	ExtendedLocation		ExtendedLocation は、リソースが作成される Azure カスタムの場所を表します。リソースに関連付けられているクラスターの拡張された場所。
id	string (arm-id)		リソースの完全修飾リソース ID。例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string		リソースが存在する地理的な場所
name	string		リソースの名前
properties.associatedResourceIds	string[]		このネットワークを接続している他の Microsoft.NetworkCloud リソースのリソース ID の一覧。
properties.clusterId	string (arm-id)		この L2 ネットワークが関連付けられている Network Cloud クラスターのリソース ID。
properties.detailedStatus	L2NetworkDetailedStatus		L2 ネットワークのより詳細なステータス。
properties.detailedStatusMessage	string		現在の詳細ステータスに関する説明メッセージ。
properties.hybridAksClustersAssociatedIds	string[]		フィールドは非推奨です。これらのフィールドは空/省略されます。この L2 ネットワークに関連付けられているハイブリッド AKS クラスターリソース ID の一覧。
properties.hybridAksPluginType	HybridAksPluginType	SRIOV	フィールドは非推奨です。このフィールドは以前は省略可能でしたが、現在は動作が定義されていないため、無視されます。 Hybrid AKS のネットワークプラグインの種類。
properties.interfaceName	string maxLength: 12 pattern: ^[a-zA-Z0-9@._-]*$		仮想マシン内のこの L2 ネットワークの既定のインターフェイス名。この名前は、その仮想マシンのネットワーク添付ファイル構成で指定された名前でオーバーライドできます。
properties.l2IsolationDomainId	string (arm-id)		Network Fabric l2IsolationDomain のリソース ID。
properties.provisioningState	L2NetworkProvisioningState		L2 ネットワークのプロビジョニング状態。
properties.virtualMachinesAssociatedIds	string[]		フィールドは非推奨です。これらのフィールドは空/省略されます。現在この L2 ネットワークを使用しているハイブリッド AKS 仮想マシンを除く仮想マシンリソース ID の一覧。
systemData	systemData		createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。
tags	object		リソースタグ。
type	string		リソースの型。例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

L2NetworkDetailedStatus

列挙

L2 ネットワークのより詳細なステータス。

値	説明
Error
Available
Provisioning

L2NetworkPatchParameters

Object

L2NetworkPatchParameters は、L2 ネットワークにパッチを適用するリクエストの本文を表します。

名前	型	説明
tags	object	既存のものを置き換える Azure リソースタグ。

L2NetworkProvisioningState

列挙

L2 ネットワークのプロビジョニング状態。

値	説明
Succeeded
Failed
Canceled
Provisioning
Accepted

systemData

Object

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

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

次の方法で共有

L 2 Networks - Update

URI パラメーター

要求ヘッダー

要求本文

応答

セキュリティ

azure_auth

スコープ

例

Patch L2 network

要求のサンプル

応答のサンプル

定義

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

HybridAksPluginType

L2Network

L2NetworkDetailedStatus

L2NetworkPatchParameters

L2NetworkProvisioningState

systemData