L 2 Networks - Update

Služba:: Operator Nexus - Network Cloud

Verze rozhraní API:: 2026-07-01

Aktualizujte značky přidružené k poskytnuté síti vrstvy 2 (L2).

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
l2NetworkName	path	True	string pattern: ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$	Název sítě L2.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny zdrojů. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string (uuid)	ID cílového předplatného. Hodnota musí být UUID.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Hlavička požadavku

Name	Vyžadováno	Typ	Description
If-Match		string	Značky ETag transformace. Tuto hodnotu vynecháte, pokud chcete aktuální prostředek vždy přepsat. Zadejte naposledy zobrazenou hodnotu značky ETag, abyste zabránili náhodnému přepsání souběžných změn.
If-None-Match		string	Nastavte na *, aby se mohla vytvořit nová sada záznamů, ale aby se zabránilo aktualizaci existujícího prostředku. Jiné hodnoty budou mít za následek chybu ze serveru, protože nejsou podporované.

Text požadavku

Name	Typ	Description
tags	object	Štítky prostředků

Odpovědi

Name	Typ	Description
200 OK	L2Network	Operace Azure byla úspěšně dokončena.
Other Status Codes	ErrorResponse	Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok OAuth2 služby Azure Active Directory.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	vydávat se za svůj uživatelský účet

Příklady

Patch L2 network

Ukázkový požadavek

HTTP

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

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

Ukázková odpověď

Stavový kód:: 200

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

Definice

Name	Description
Azure.ResourceManager.CommonTypes.ExtendedLocation	Komplexní typ rozšířeného umístění.
createdByType	Typ identity, která prostředek vytvořila.
ErrorAdditionalInfo	Další informace o chybě při správě prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
ExtendedLocationType	Typ rozšířeného umístění.
HybridAksPluginType	Pole je zastaralé. Pole bylo dříve volitelné, teď nebude mít definované chování a bude ignorováno. Typ síťového modulu plug-in pro Hybridní AKS.
L2Network	L2Network představuje síť, která využívá jednu izolovanou doménu nastavenou pro prostředky vrstvy 2.
L2NetworkDetailedStatus	Podrobnější stav sítě L2.
L2NetworkPatchParameters	L2NetworkPatchParameters představuje tělo požadavku na opravu sítě L2.
L2NetworkProvisioningState	Stav zřizování sítě L2.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.

Azure.ResourceManager.CommonTypes.ExtendedLocation

Objekt

Komplexní typ rozšířeného umístění.

Name	Typ	Description
name	string	Název rozšířeného umístění.
type	ExtendedLocationType	Typ rozšířeného umístění.

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Další informace o chybě při správě prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

ExtendedLocationType

Výčet

Typ rozšířeného umístění.

Hodnota	Description
EdgeZone	Typ umístění zón Azure Edge
CustomLocation	Typ vlastních umístění Azure

HybridAksPluginType

Výčet

Pole je zastaralé. Pole bylo dříve volitelné, teď nebude mít definované chování a bude ignorováno. Typ síťového modulu plug-in pro Hybridní AKS.

Hodnota	Description
DPDK	Typ pluginu DPDK.
SRIOV	Typ pluginu SRIOV.
OSDevice	Typ pluginu OSDevice.

L2Network

Objekt

L2Network představuje síť, která využívá jednu izolovanou doménu nastavenou pro prostředky vrstvy 2.

Name	Typ	Default value	Description
etag	string		"Pokud je v těle odpovědi uveden etag, může být také poskytnut jako hlavička podle normální konvence etag. Značky entit se používají k porovnání dvou nebo více entit ze stejného požadovaného prostředku. Protokol HTTP/1.1 používá značky entit v polích záhlaví značek etag (oddíl 14.19), If-Match (oddíl 14.24), If-None-Match (oddíl 14.26) a If-Range (oddíl 14.27).")
extendedLocation	Azure.ResourceManager.CommonTypes.ExtendedLocation		Rozšířená poloha zdroje. Tato vlastnost je vyžadována při vytváření zdroje.
id	string (arm-id)		Plně kvalifikované ID prostředku pro prostředek. Např. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string		Geografické umístění, ve kterém se nachází zdroj
name	string		Název prostředku
properties.associatedResourceIds	string[]		Seznam ID prostředků pro ostatní prostředky Microsoft.NetworkCloud, které tuto síť připojily.
properties.clusterId	string (arm-id)		ID prostředku clusteru Síťový cloud je tato síť L2 přidružená.
properties.detailedStatus	L2NetworkDetailedStatus		Podrobnější stav sítě L2.
properties.detailedStatusMessage	string		Popisná zpráva o aktuálním detailním stavu.
properties.hybridAksClustersAssociatedIds	string[]		Pole je zastaralé. Tato pole budou prázdná nebo vynechána. Seznam ID prostředků hybridního clusteru AKS, které jsou přidružené k této síti L2.
properties.hybridAksPluginType	HybridAksPluginType	SRIOV	Pole je zastaralé. Pole bylo dříve volitelné, teď nebude mít definované chování a bude ignorováno. Typ síťového modulu plug-in pro Hybridní AKS.
properties.interfaceName	string maxLength: 12 pattern: ^[a-zA-Z0-9@._-]*$		Výchozí název rozhraní pro tuto síť L2 ve virtuálním počítači. Tento název lze přepsat názvem zadaným v konfiguraci síťové přílohy tohoto virtuálního počítače.
properties.l2IsolationDomainId	string (arm-id)		ID prostředku network fabric l2IsolationDomain.
properties.provisioningState	L2NetworkProvisioningState		Stav zřizování sítě L2.
properties.virtualMachinesAssociatedIds	string[]		Pole je zastaralé. Tato pole budou prázdná nebo vynechána. Seznam ID prostředků virtuálního počítače s výjimkou všech hybridních virtuálních počítačů AKS, které aktuálně používají tuto síť L2.
systemData	systemData		Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
tags	object		Štítky prostředků
type	string		Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

L2NetworkDetailedStatus

Výčet

Podrobnější stav sítě L2.

Hodnota	Description
Error	Stav chyby.
Available	Stav dostupnosti.
Provisioning	Stav Provisioning.

L2NetworkPatchParameters

Objekt

L2NetworkPatchParameters představuje tělo požadavku na opravu sítě L2.

Name	Typ	Description
tags	object	Štítky prostředků

L2NetworkProvisioningState

Výčet

Stav zřizování sítě L2.

Hodnota	Description
Succeeded	Status Successed.
Failed	Stav Neúspěšný.
Canceled	Stav zrušený.
Provisioning	Stav Provisioning.
Accepted	Status Přijato.

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.