Udostępnij za pośrednictwem


Network Interfaces - Update

Operacja aktualizowania interfejsu sieciowego.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/networkInterfaces/{networkInterfaceName}?api-version=2024-01-01

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
networkInterfaceName
path True

string

Nazwa interfejsu sieciowego

Wzorzec wyrażenia regularnego: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-._a-zA-Z0-9]{0,78}[_a-zA-Z0-9]$

resourceGroupName
path True

string

Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter.

subscriptionId
path True

string

Identyfikator subskrypcji docelowej.

api-version
query True

string

Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa Typ Opis
tags

object

Tagi zasobów

Odpowiedzi

Nazwa Typ Opis
200 OK

NetworkInterfaces

OK

202 Accepted

Zaakceptowano

Nagłówki

Location: string

Other Status Codes

ErrorResponse

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

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

Zakresy

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

UpdateNetworkInterface

Przykładowe żądanie

PATCH https://management.azure.com/subscriptions/fd3c3665-1729-4b7b-9a38-238e83b0f98b/resourceGroups/test-rg/providers/Microsoft.AzureStackHCI/networkInterfaces/test-nic?api-version=2024-01-01

{
  "tags": {
    "additionalProperties": "sample"
  }
}

Przykładowa odpowiedź

{
  "id": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.AzureStackHCI/networkInterfaces/test-nic",
  "name": "test-nic",
  "type": "Microsoft.AzureStackHCI/networkInterfaces",
  "location": "West US2",
  "extendedLocation": {
    "name": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.ExtendedLocation/customLocations/dogfood-location",
    "type": "CustomLocation"
  },
  "properties": {
    "ipConfigurations": [
      {
        "name": "ipconfig-sample",
        "properties": {
          "subnet": {
            "id": "test-lnet"
          }
        }
      }
    ],
    "provisioningState": "Accepted"
  }
}
azure-asyncoperation: http://azure.async.operation/status

Definicje

Nazwa Opis
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

ExtendedLocation

Typ złożony lokalizacji rozszerzonej.

ExtendedLocationTypes

Typ lokalizacji rozszerzonej.

InterfaceDNSSettings
IPConfiguration

InterfaceIPConfiguration iPConfiguration w interfejsie sieciowym.

NetworkInterfaces

Definicja zasobu interfejsu sieciowego.

NetworkInterfacesUpdateRequest

Definicja poprawki zasobu interfejsu sieciowego.

Properties

InterfaceIPConfigurationPropertiesFormat właściwości konfiguracji adresu IP.

ProvisioningStateEnum

Stan aprowizacji interfejsu sieciowego.

ProvisioningStatus
Status

Stan operacji wykonanej w interfejsie sieciowym [Succeeded, Failed, InProgress]

Subnet

Podsieć — nazwa podsieci powiązanej z konfiguracją adresu IP.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

createdByType

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

Nazwa Typ Opis
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

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

Nazwa Typ Opis
info

object

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

ErrorDetail

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

Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

Obiekt error.

ExtendedLocation

Typ złożony lokalizacji rozszerzonej.

Nazwa Typ Opis
name

string

Nazwa lokalizacji rozszerzonej.

type

ExtendedLocationTypes

Typ lokalizacji rozszerzonej.

ExtendedLocationTypes

Typ lokalizacji rozszerzonej.

Nazwa Typ Opis
CustomLocation

string

InterfaceDNSSettings

Nazwa Typ Opis
dnsServers

string[]

Lista adresów IP serwera DNS dla interfejsu

IPConfiguration

InterfaceIPConfiguration iPConfiguration w interfejsie sieciowym.

Nazwa Typ Opis
name

string

Nazwa — nazwa zasobu, który jest unikatowy w grupie zasobów. Ta nazwa może służyć do uzyskiwania dostępu do zasobu.

properties

Properties

InterfaceIPConfigurationPropertiesFormat właściwości konfiguracji adresu IP.

NetworkInterfaces

Definicja zasobu interfejsu sieciowego.

Nazwa Typ Opis
extendedLocation

ExtendedLocation

ExtendedLocation zasobu.

id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Lokalizacja geograficzna, w której znajduje się zasób

name

string

Nazwa zasobu

properties.dnsSettings

InterfaceDNSSettings

Ustawienia DNS dla interfejsu

properties.ipConfigurations

IPConfiguration[]

IPConfigurations — lista konfiguracji IP interfejsu sieciowego.

properties.macAddress

string

MacAddress — adres MAC interfejsu sieciowego.

properties.provisioningState

ProvisioningStateEnum

Stan aprowizacji interfejsu sieciowego.

properties.status.errorCode

string

Kod błędu aprowizacji NetworkInterface

properties.status.errorMessage

string

Opisowy komunikat o błędzie

properties.status.provisioningStatus

ProvisioningStatus

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"

NetworkInterfacesUpdateRequest

Definicja poprawki zasobu interfejsu sieciowego.

Nazwa Typ Opis
tags

object

Tagi zasobów

Properties

InterfaceIPConfigurationPropertiesFormat właściwości konfiguracji adresu IP.

Nazwa Typ Opis
gateway

string

Brama dla interfejsu sieciowego

prefixLength

string

prefixLength dla interfejsu sieciowego

privateIPAddress

string

PrivateIPAddress — prywatny adres IP konfiguracji adresu IP.

subnet

Subnet

Podsieć — nazwa podsieci powiązanej z konfiguracją adresu IP.

ProvisioningStateEnum

Stan aprowizacji interfejsu sieciowego.

Nazwa Typ Opis
Accepted

string

Canceled

string

Deleting

string

Failed

string

InProgress

string

Succeeded

string

ProvisioningStatus

Nazwa Typ Opis
operationId

string

Identyfikator operacji wykonanej w interfejsie sieciowym

status

Status

Stan operacji wykonanej w interfejsie sieciowym [Succeeded, Failed, InProgress]

Status

Stan operacji wykonanej w interfejsie sieciowym [Succeeded, Failed, InProgress]

Nazwa Typ Opis
Failed

string

InProgress

string

Succeeded

string

Subnet

Podsieć — nazwa podsieci powiązanej z konfiguracją adresu IP.

Nazwa Typ Opis
id

string

IDENTYFIKATOR — identyfikator zasobu usługi ARM w postaci /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/...

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa Typ Opis
createdAt

string

Sygnatura czasowa tworzenia zasobów (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

Sygnatura czasowa 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.