Bagikan melalui


L 2 Networks - Create Or Update

Membuat atau memperbarui jaringan lapisan 2 (L2).
Buat jaringan lapisan 2 (L2) baru atau perbarui properti jaringan yang ada.

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

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
l2NetworkName
path True

string

pattern: ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$

Nama jaringan L2.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.

subscriptionId
path True

string (uuid)

ID langganan target. Nilainya harus sebuah UUID.

api-version
query True

string

minLength: 1

Versi API yang digunakan untuk operasi ini.

Header Permintaan

Nama Diperlukan Jenis Deskripsi
If-Match

string

ETag transformasi. Hilangkan nilai ini untuk selalu menimpa sumber daya saat ini. Tentukan nilai ETag yang terakhir dilihat untuk mencegah penimpaan perubahan bersamaan secara tidak sengaja.

If-None-Match

string

Atur ke '*' untuk mengizinkan kumpulan catatan baru dibuat, tetapi untuk mencegah pembaruan sumber daya yang ada. Nilai lain akan mengakibatkan kesalahan dari server karena tidak didukung.

Isi Permintaan

Nama Diperlukan Jenis Deskripsi
extendedLocation True

ExtendedLocation

ExtendedLocation mewakili lokasi kustom Azure tempat sumber daya akan dibuat.
Lokasi kluster yang diperluas yang terkait dengan sumber daya.

location True

string

Lokasi geografis tempat sumber daya berada

properties.l2IsolationDomainId True

string (arm-id)

ID sumber daya Network Fabric l2IsolationDomain.

properties.hybridAksPluginType

HybridAksPluginType

Bidang Tidak digunakan lagi. Bidang sebelumnya opsional, sekarang tidak akan memiliki perilaku yang ditentukan dan akan diabaikan. Jenis plugin jaringan untuk Hybrid AKS.

properties.interfaceName

string

maxLength: 12
pattern: ^[a-zA-Z0-9@._-]*$

Nama antarmuka default untuk jaringan L2 ini di komputer virtual. Nama ini dapat diganti dengan nama yang disediakan dalam konfigurasi lampiran jaringan komputer virtual tersebut.

tags

object

Tag sumber daya.

Respons

Nama Jenis Deskripsi
200 OK

L2Network

Sumber daya telah berhasil dibuat atau diperbarui.

201 Created

L2Network

Sumber daya telah diterima untuk pembuatan atau pembaruan.

Header

Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

Respons kesalahan yang menjelaskan mengapa operasi gagal.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama Deskripsi
user_impersonation meniru akun pengguna Anda

Contoh

Create or update L2 network

Permintaan sampel

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

{
  "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",
    "hybridAksPluginType": "DPDK"
  }
}

Respon sampel

{
  "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"
  }
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/123e4567-e89b-12d3-a456-426655440000/providers/Microsoft.NetworkCloud/locations/location/operationStatuses/operationId?api-version=2025-02-01
{
  "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"
  }
}

Definisi

Nama Deskripsi
createdByType

Jenis identitas yang membuat sumber daya.

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

ErrorDetail

Detail kesalahan.

ErrorResponse

Tanggapan kesalahan

ExtendedLocation

ExtendedLocation mewakili lokasi kustom Azure tempat sumber daya akan dibuat.

HybridAksPluginType

Bidang Tidak digunakan lagi. Bidang sebelumnya opsional, sekarang tidak akan memiliki perilaku yang ditentukan dan akan diabaikan. Jenis plugin jaringan untuk Hybrid AKS.

L2Network

L2Network mewakili jaringan yang menggunakan satu domain isolasi yang disiapkan untuk sumber daya lapisan-2.

L2NetworkDetailedStatus

Status jaringan L2 yang lebih rinci.

L2NetworkProvisioningState

Status provisi jaringan L2.

systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

createdByType

Jenis identitas yang membuat sumber daya.

Nilai Deskripsi
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

Nama Jenis Deskripsi
info

object

Info tambahan.

type

string

Jenis info tambahan.

ErrorDetail

Detail kesalahan.

Nama Jenis Deskripsi
additionalInfo

ErrorAdditionalInfo[]

Info tambahan kesalahan.

code

string

Kode kesalahan.

details

ErrorDetail[]

Detail kesalahan.

message

string

Pesan kesalahan.

target

string

Target kesalahan.

ErrorResponse

Tanggapan kesalahan

Nama Jenis Deskripsi
error

ErrorDetail

Objek kesalahan.

ExtendedLocation

ExtendedLocation mewakili lokasi kustom Azure tempat sumber daya akan dibuat.

Nama Jenis Deskripsi
name

string

ID sumber daya dari lokasi yang diperluas tempat sumber daya akan dibuat.

type

string

Jenis lokasi yang diperluas, misalnya, CustomLocation.

HybridAksPluginType

Bidang Tidak digunakan lagi. Bidang sebelumnya opsional, sekarang tidak akan memiliki perilaku yang ditentukan dan akan diabaikan. Jenis plugin jaringan untuk Hybrid AKS.

Nilai Deskripsi
DPDK
OSDevice
SRIOV

L2Network

L2Network mewakili jaringan yang menggunakan satu domain isolasi yang disiapkan untuk sumber daya lapisan-2.

Nama Jenis Nilai default Deskripsi
etag

string

Sumber Daya ETag.

extendedLocation

ExtendedLocation

ExtendedLocation mewakili lokasi kustom Azure tempat sumber daya akan dibuat.
Lokasi kluster yang diperluas yang terkait dengan sumber daya.

id

string (arm-id)

ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

location

string

Lokasi geografis tempat sumber daya berada

name

string

Nama sumber daya

properties.associatedResourceIds

string[]

Daftar ID sumber daya untuk sumber daya Microsoft.NetworkCloud lainnya yang telah melampirkan jaringan ini.

properties.clusterId

string (arm-id)

ID sumber daya kluster Network Cloud yang dikaitkan dengan jaringan L2 ini.

properties.detailedStatus

L2NetworkDetailedStatus

Status jaringan L2 yang lebih rinci.

properties.detailedStatusMessage

string

Pesan deskriptif tentang status terperinci saat ini.

properties.hybridAksClustersAssociatedIds

string[]

Bidang Tidak digunakan lagi. Bidang ini akan kosong/dihilangkan. Daftar ID sumber daya kluster Hybrid AKS yang terkait dengan jaringan L2 ini.

properties.hybridAksPluginType

HybridAksPluginType

SRIOV

Bidang Tidak digunakan lagi. Bidang sebelumnya opsional, sekarang tidak akan memiliki perilaku yang ditentukan dan akan diabaikan. Jenis plugin jaringan untuk Hybrid AKS.

properties.interfaceName

string

maxLength: 12
pattern: ^[a-zA-Z0-9@._-]*$

Nama antarmuka default untuk jaringan L2 ini di komputer virtual. Nama ini dapat diganti dengan nama yang disediakan dalam konfigurasi lampiran jaringan komputer virtual tersebut.

properties.l2IsolationDomainId

string (arm-id)

ID sumber daya Network Fabric l2IsolationDomain.

properties.provisioningState

L2NetworkProvisioningState

Status provisi jaringan L2.

properties.virtualMachinesAssociatedIds

string[]

Bidang Tidak digunakan lagi. Bidang ini akan kosong/dihilangkan. Daftar ID sumber daya komputer virtual, tidak termasuk komputer virtual Hybrid AKS apa pun, yang saat ini menggunakan jaringan L2 ini.

systemData

systemData

Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.

tags

object

Tag sumber daya.

type

string

Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

L2NetworkDetailedStatus

Status jaringan L2 yang lebih rinci.

Nilai Deskripsi
Available
Error
Provisioning

L2NetworkProvisioningState

Status provisi jaringan L2.

Nilai Deskripsi
Accepted
Canceled
Failed
Provisioning
Succeeded

systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama Jenis Deskripsi
createdAt

string (date-time)

Tanda waktu pembuatan sumber daya (UTC).

createdBy

string

Identitas yang membuat sumber daya.

createdByType

createdByType

Jenis identitas yang membuat sumber daya.

lastModifiedAt

string (date-time)

Tanda waktu modifikasi terakhir sumber daya (UTC)

lastModifiedBy

string

Identitas yang terakhir mengubah sumber daya.

lastModifiedByType

createdByType

Jenis identitas yang terakhir memodifikasi sumber daya.