L 2 Networks - Update

Usługa:: Operator Nexus - Network Cloud

Wersja interfejsu API:: 2026-07-01

Aktualizuj tagi skojarzone z podaną siecią warstwy 2 (L2).

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
l2NetworkName	path	True	string pattern: ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$	Nazwa sieci L2.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
subscriptionId	path	True	string (uuid)	Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
If-Match		string	Element ETag przekształcenia. Pomiń tę wartość, aby zawsze zastąpić bieżący zasób. Określ ostatnio widzianą wartość elementu ETag, aby zapobiec przypadkowemu zastępowaniu współbieżnych zmian.
If-None-Match		string	Ustaw wartość "*", aby zezwolić na utworzenie nowego zestawu rekordów, ale aby zapobiec aktualizowaniu istniejącego zasobu. Inne wartości spowodują błąd z serwera, ponieważ nie są one obsługiwane.

Treść żądania

Nazwa	Typ	Opis
tags	object	Tagi zasobów.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	L2Network	Operacja platformy Azure została zakończona pomyślnie.
Other Status Codes	ErrorResponse	Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 w usłudze Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	podszywaj się pod konto użytkownika

Przykłady

Patch L2 network

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:: 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"
}

Definicje

Nazwa	Opis
Azure.ResourceManager.CommonTypes.ExtendedLocation	Typ złożony lokalizacji rozszerzonej.
createdByType	Typ tożsamości, która utworzyła zasób.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
ExtendedLocationType	Typ lokalizacji rozszerzonej.
HybridAksPluginType	Pole jest przestarzałe. Pole było wcześniej opcjonalne, teraz nie będzie miało zdefiniowanego zachowania i zostanie zignorowane. Typ wtyczki sieciowej dla hybrydowej usługi AKS.
L2Network	L2Network reprezentuje sieć, która korzysta z jednej domeny izolacji skonfigurowanej dla zasobów warstwy 2.
L2NetworkDetailedStatus	Bardziej szczegółowy stan sieci L2.
L2NetworkPatchParameters	L2NetworkPatchParameters reprezentuje treść żądania poprawki sieci L2.
L2NetworkProvisioningState	Stan aprowizacji sieci L2.
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Azure.ResourceManager.CommonTypes.ExtendedLocation

Objekt

Typ złożony lokalizacji rozszerzonej.

Nazwa	Typ	Opis
name	string	Nazwa lokalizacji rozszerzonej.
type	ExtendedLocationType	Typ lokalizacji rozszerzonej.

createdByType

Wyliczenie

Typ tożsamości, która utworzyła zasób.

Wartość	Opis
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Objekt

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Cel błędu.

ErrorResponse

Objekt

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

ExtendedLocationType

Wyliczenie

Typ lokalizacji rozszerzonej.

Wartość	Opis
EdgeZone	Typ lokalizacji stref usługi Azure Edge Zones
CustomLocation	Typ lokalizacji niestandardowych platformy Azure

HybridAksPluginType

Wyliczenie

Pole jest przestarzałe. Pole było wcześniej opcjonalne, teraz nie będzie miało zdefiniowanego zachowania i zostanie zignorowane. Typ wtyczki sieciowej dla hybrydowej usługi AKS.

Wartość	Opis
DPDK	Typ wtyczki DPDK.
SRIOV	Typ wtyczki SRIOV.
OSDevice	Typ wtyczki OSDevice.

L2Network

Objekt

L2Network reprezentuje sieć, która korzysta z jednej domeny izolacji skonfigurowanej dla zasobów warstwy 2.

Nazwa	Typ	Domyślna wartość	Opis
etag	string		"Jeśli etag jest podany w treści odpowiedzi, może być również dostarczony jako nagłówek zgodnie z normalną konwencją etag. Tagi jednostek są używane do porównywania co najmniej dwóch jednostek z tego samego żądanego zasobu. Protokół HTTP/1.1 używa tagów encji w polach nagłówka etag (sekcja 14.19), If-Match (sekcja 14.24), If-None-Match (sekcja 14.26) i If-Range (sekcja 14.27).")
extendedLocation	Azure.ResourceManager.CommonTypes.ExtendedLocation		Rozszerzone położenie zasobu. Ta właściwość jest wymagana podczas tworzenia zasobu.
id	string (arm-id)		W pełni określony identyfikator zasobu dla tego zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string		Lokalizacja geograficzna, w której znajduje się zasób
name	string		Nazwa zasobu
properties.associatedResourceIds	string[]		Lista identyfikatorów zasobów dla innych zasobów Microsoft.NetworkCloud, które dołączyły tę sieć.
properties.clusterId	string (arm-id)		Identyfikator zasobu klastra chmury sieciowej, z tą siecią L2 jest skojarzona.
properties.detailedStatus	L2NetworkDetailedStatus		Bardziej szczegółowy stan sieci L2.
properties.detailedStatusMessage	string		Komunikat opisujący aktualny szczegółowy stan.
properties.hybridAksClustersAssociatedIds	string[]		Pole jest przestarzałe. Te pola będą puste/pominięte. Lista identyfikatorów zasobów klastra hybrydowego usługi AKS skojarzonych z tą siecią L2.
properties.hybridAksPluginType	HybridAksPluginType	SRIOV	Pole jest przestarzałe. Pole było wcześniej opcjonalne, teraz nie będzie miało zdefiniowanego zachowania i zostanie zignorowane. Typ wtyczki sieciowej dla hybrydowej usługi AKS.
properties.interfaceName	string maxLength: 12 pattern: ^[a-zA-Z0-9@._-]*$		Domyślna nazwa interfejsu dla tej sieci L2 na maszynie wirtualnej. Tę nazwę można zastąpić nazwą podaną w konfiguracji załącznika sieciowego tej maszyny wirtualnej.
properties.l2IsolationDomainId	string (arm-id)		Identyfikator zasobu sieci szkieletowej l2IsolationDomain.
properties.provisioningState	L2NetworkProvisioningState		Stan aprowizacji sieci L2.
properties.virtualMachinesAssociatedIds	string[]		Pole jest przestarzałe. Te pola będą puste/pominięte. Lista identyfikatorów zasobów maszyny wirtualnej z wyłączeniem wszystkich maszyn wirtualnych hybrydowej usługi AKS, które obecnie korzystają z tej sieci L2.
systemData	systemData		Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”.
tags	object		Tagi zasobów.
type	string		Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

L2NetworkDetailedStatus

Wyliczenie

Bardziej szczegółowy stan sieci L2.

Wartość	Opis
Error	Status błędu.
Available	Status dostępny.
Provisioning	Status Provisioning.

L2NetworkPatchParameters

Objekt

L2NetworkPatchParameters reprezentuje treść żądania poprawki sieci L2.

Nazwa	Typ	Opis
tags	object	Tagi zasobów.

L2NetworkProvisioningState

Wyliczenie

Stan aprowizacji sieci L2.

Wartość	Opis
Succeeded	Status sukcesy.
Failed	Status Nieudanego.
Canceled	Status Anulowany.
Provisioning	Status Provisioning.
Accepted	Status Akceptowany.

systemData

Objekt

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string (date-time)	Sygnatura czasowa tworzenia zasobu (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string (date-time)	Znacznik czasu ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.