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 |
---|---|---|---|---|
l2Network
|
path | True |
string pattern: ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$ |
Nama jaringan L2. |
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil. |
subscription
|
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 mewakili lokasi kustom Azure tempat sumber daya akan dibuat. |
|
location | True |
string |
Lokasi geografis tempat sumber daya berada |
properties.l2IsolationDomainId | True |
string (arm-id) |
ID sumber daya Network Fabric l2IsolationDomain. |
properties.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: 12pattern: ^[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 |
Sumber daya telah berhasil dibuat atau diperbarui. |
|
201 Created |
Sumber daya telah diterima untuk pembuatan atau pembaruan. Header Azure-AsyncOperation: string |
|
Other Status Codes |
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 |
---|---|
created |
Jenis identitas yang membuat sumber daya. |
Error |
Info tambahan kesalahan manajemen sumber daya. |
Error |
Detail kesalahan. |
Error |
Tanggapan kesalahan |
Extended |
ExtendedLocation mewakili lokasi kustom Azure tempat sumber daya akan dibuat. |
Hybrid |
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. |
L2Network |
Status jaringan L2 yang lebih rinci. |
L2Network |
Status provisi jaringan L2. |
system |
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 |
Info tambahan kesalahan. |
|
code |
string |
Kode kesalahan. |
details |
Detail kesalahan. |
|
message |
string |
Pesan kesalahan. |
target |
string |
Target kesalahan. |
ErrorResponse
Tanggapan kesalahan
Nama | Jenis | Deskripsi |
---|---|---|
error |
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 mewakili lokasi kustom Azure tempat sumber daya akan dibuat. |
||
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 |
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 | 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: 12pattern: ^[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 |
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 |
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 |
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 |
Jenis identitas yang terakhir memodifikasi sumber daya. |