Dela via


Network Interfaces - Update

Åtgärden för att uppdatera ett nätverksgränssnitt.

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

URI-parametrar

Name I Obligatorisk Typ Description
networkInterfaceName
path True

string

Namn på nätverksgränssnittet

Reguljärt uttrycksmönster: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-._a-zA-Z0-9]{0,78}[_a-zA-Z0-9]$

resourceGroupName
path True

string

Namnet på resursgruppen. Namnet är skiftlägesokänsligt.

subscriptionId
path True

string

ID för målprenumerationen.

api-version
query True

string

Den API-version som ska användas för den här åtgärden.

Begärandetext

Name Typ Description
tags

object

Resurstaggar

Svar

Name Typ Description
200 OK

NetworkInterfaces

OK

202 Accepted

Har godkänts

Sidhuvuden

Location: string

Other Status Codes

ErrorResponse

Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

UpdateNetworkInterface

Exempelbegäran

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

Exempelsvar

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

Definitioner

Name Description
createdByType

Den typ av identitet som skapade resursen.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

ErrorDetail

Felinformationen.

ErrorResponse

Felsvar

ExtendedLocation

Den komplexa typen av utökad plats.

ExtendedLocationTypes

Typen av utökad plats.

InterfaceDNSSettings
IPConfiguration

InterfaceIPConfiguration iPConfiguration i ett nätverksgränssnitt.

NetworkInterfaces

Resursdefinitionen för nätverksgränssnittet.

NetworkInterfacesUpdateRequest

Resurskorrigeringsdefinitionen för nätverksgränssnittet.

Properties

InterfaceIPConfigurationPropertiesFormategenskaper för IP-konfiguration.

ProvisioningStateEnum

Etableringstillstånd för nätverksgränssnittet.

ProvisioningStatus
Status

Status för åtgärden som utförs i nätverksgränssnittet [Succeeded, Failed, InProgress]

Subnet

Undernät – Namnet på undernätet som är bundet till IP-konfigurationen.

systemData

Metadata som rör skapande och senaste ändring av resursen.

createdByType

Den typ av identitet som skapade resursen.

Name Typ Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name Typ Description
info

object

Ytterligare information.

type

string

Den ytterligare informationstypen.

ErrorDetail

Felinformationen.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Ytterligare information om felet.

code

string

Felkoden.

details

ErrorDetail[]

Felinformationen.

message

string

Felmeddelandet.

target

string

Felmålet.

ErrorResponse

Felsvar

Name Typ Description
error

ErrorDetail

Felobjektet.

ExtendedLocation

Den komplexa typen av utökad plats.

Name Typ Description
name

string

Namnet på den utökade platsen.

type

ExtendedLocationTypes

Typen av utökad plats.

ExtendedLocationTypes

Typen av utökad plats.

Name Typ Description
CustomLocation

string

InterfaceDNSSettings

Name Typ Description
dnsServers

string[]

Lista över IP-adresser för DNS-servern för gränssnittet

IPConfiguration

InterfaceIPConfiguration iPConfiguration i ett nätverksgränssnitt.

Name Typ Description
name

string

Namn – Namnet på resursen som är unik i en resursgrupp. Det här namnet kan användas för att komma åt resursen.

properties

Properties

InterfaceIPConfigurationPropertiesFormategenskaper för IP-konfiguration.

NetworkInterfaces

Resursdefinitionen för nätverksgränssnittet.

Name Typ Description
extendedLocation

ExtendedLocation

ExtendedLocation för resursen.

id

string

Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Den geo-plats där resursen finns

name

string

Namnet på resursen

properties.dnsSettings

InterfaceDNSSettings

DNS-inställningar för gränssnittet

properties.ipConfigurations

IPConfiguration[]

IPConfigurations – En lista över IPConfigurations för nätverksgränssnittet.

properties.macAddress

string

MacAddress – MAC-adressen för nätverksgränssnittet.

properties.provisioningState

ProvisioningStateEnum

Etableringstillstånd för nätverksgränssnittet.

properties.status.errorCode

string

NetworkInterface-etableringsfelkod

properties.status.errorMessage

string

Beskrivande felmeddelande

properties.status.provisioningStatus

ProvisioningStatus

systemData

systemData

Azure Resource Manager metadata som innehåller createdBy och modifiedBy information.

tags

object

Resurstaggar.

type

string

Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

NetworkInterfacesUpdateRequest

Resurskorrigeringsdefinitionen för nätverksgränssnittet.

Name Typ Description
tags

object

Resurstaggar

Properties

InterfaceIPConfigurationPropertiesFormategenskaper för IP-konfiguration.

Name Typ Description
gateway

string

Gateway för nätverksgränssnitt

prefixLength

string

prefixLängd för nätverksgränssnitt

privateIPAddress

string

PrivateIPAddress – privat IP-adress för IP-konfigurationen.

subnet

Subnet

Undernät – Namnet på undernätet som är bundet till IP-konfigurationen.

ProvisioningStateEnum

Etableringstillstånd för nätverksgränssnittet.

Name Typ Description
Accepted

string

Canceled

string

Deleting

string

Failed

string

InProgress

string

Succeeded

string

ProvisioningStatus

Name Typ Description
operationId

string

ID för åtgärden som utförs i nätverksgränssnittet

status

Status

Status för åtgärden som utförs i nätverksgränssnittet [Succeeded, Failed, InProgress]

Status

Status för åtgärden som utförs i nätverksgränssnittet [Succeeded, Failed, InProgress]

Name Typ Description
Failed

string

InProgress

string

Succeeded

string

Subnet

Undernät – Namnet på undernätet som är bundet till IP-konfigurationen.

Name Typ Description
id

string

ID – ARM-resurs-ID i form av /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/...

systemData

Metadata som rör skapande och senaste ändring av resursen.

Name Typ Description
createdAt

string

Tidsstämpeln för resursskapande (UTC).

createdBy

string

Identiteten som skapade resursen.

createdByType

createdByType

Den typ av identitet som skapade resursen.

lastModifiedAt

string

Tidsstämpeln för resursens senaste ändring (UTC)

lastModifiedBy

string

Identiteten som senast ändrade resursen.

lastModifiedByType

createdByType

Den typ av identitet som senast ändrade resursen.