Condividi tramite


Network Interfaces - Update

Operazione per aggiornare un'interfaccia di rete.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
networkInterfaceName
path True

string

Nome dell'interfaccia di rete

Criterio di espressione regolare: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-._a-zA-Z0-9]{0,78}[_a-zA-Z0-9]$

resourceGroupName
path True

string

Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole.

subscriptionId
path True

string

ID della sottoscrizione di destinazione.

api-version
query True

string

Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome Tipo Descrizione
tags

object

Tag delle risorse

Risposte

Nome Tipo Descrizione
200 OK

NetworkInterfaces

OK

202 Accepted

Accettato

Intestazioni

Location: string

Other Status Codes

ErrorResponse

Risposta di errore che descrive perché l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

UpdateNetworkInterface

Esempio di richiesta

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

Risposta di esempio

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

Definizioni

Nome Descrizione
createdByType

Tipo di identità che ha creato la risorsa.

ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

ExtendedLocation

Tipo complesso della posizione estesa.

ExtendedLocationTypes

Tipo della posizione estesa.

InterfaceDNSSettings
IPConfiguration

InterfaceIPConfiguration iPConfiguration in un'interfaccia di rete.

NetworkInterfaces

Definizione della risorsa dell'interfaccia di rete.

NetworkInterfacesUpdateRequest

Definizione della patch delle risorse dell'interfaccia di rete.

Properties

Proprietà InterfaceIPConfigurationPropertiesFormat della configurazione IP.

ProvisioningStateEnum

Stato di provisioning dell'interfaccia di rete.

ProvisioningStatus
Status

Stato dell'operazione eseguita nell'interfaccia di rete [Successed, Failed, InProgress]

Subnet

Subnet: nome della subnet associata alla configurazione IP.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

createdByType

Tipo di identità che ha creato la risorsa.

Nome Tipo Descrizione
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

ExtendedLocation

Tipo complesso della posizione estesa.

Nome Tipo Descrizione
name

string

Nome della posizione estesa.

type

ExtendedLocationTypes

Tipo della posizione estesa.

ExtendedLocationTypes

Tipo della posizione estesa.

Nome Tipo Descrizione
CustomLocation

string

InterfaceDNSSettings

Nome Tipo Descrizione
dnsServers

string[]

Elenco degli indirizzi IP del server DNS per l'interfaccia

IPConfiguration

InterfaceIPConfiguration iPConfiguration in un'interfaccia di rete.

Nome Tipo Descrizione
name

string

Nome: nome della risorsa univoca all'interno di un gruppo di risorse. Questo nome può essere usato per accedere alla risorsa.

properties

Properties

Proprietà InterfaceIPConfigurationPropertiesFormat della configurazione IP.

NetworkInterfaces

Definizione della risorsa dell'interfaccia di rete.

Nome Tipo Descrizione
extendedLocation

ExtendedLocation

EstensioneLocation della risorsa.

id

string

ID di risorsa completo per la risorsa. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Posizione geografica in cui vive la risorsa

name

string

nome della risorsa.

properties.dnsSettings

InterfaceDNSSettings

Impostazioni DNS per l'interfaccia

properties.ipConfigurations

IPConfiguration[]

IPConfigurations : elenco di IPConfigurations dell'interfaccia di rete.

properties.macAddress

string

MacAddress - Indirizzo MAC dell'interfaccia di rete.

properties.provisioningState

ProvisioningStateEnum

Stato di provisioning dell'interfaccia di rete.

properties.status.errorCode

string

Codice di errore di provisioning NetworkInterface

properties.status.errorMessage

string

Messaggio di errore descrittivo

properties.status.provisioningStatus

ProvisioningStatus

systemData

systemData

Metadati di Azure Resource Manager contenenti le informazioni createBy e modificateBy.

tags

object

Tag di risorse.

type

string

Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

NetworkInterfacesUpdateRequest

Definizione della patch delle risorse dell'interfaccia di rete.

Nome Tipo Descrizione
tags

object

Tag delle risorse

Properties

Proprietà InterfaceIPConfigurationPropertiesFormat della configurazione IP.

Nome Tipo Descrizione
gateway

string

Gateway per l'interfaccia di rete

prefixLength

string

prefissoLength per l'interfaccia di rete

privateIPAddress

string

PrivateIPAddress - Indirizzo IP privato della configurazione IP.

subnet

Subnet

Subnet: nome della subnet associata alla configurazione IP.

ProvisioningStateEnum

Stato di provisioning dell'interfaccia di rete.

Nome Tipo Descrizione
Accepted

string

Canceled

string

Deleting

string

Failed

string

InProgress

string

Succeeded

string

ProvisioningStatus

Nome Tipo Descrizione
operationId

string

ID dell'operazione eseguita nell'interfaccia di rete

status

Status

Stato dell'operazione eseguita nell'interfaccia di rete [Successed, Failed, InProgress]

Status

Stato dell'operazione eseguita nell'interfaccia di rete [Successed, Failed, InProgress]

Nome Tipo Descrizione
Failed

string

InProgress

string

Succeeded

string

Subnet

Subnet: nome della subnet associata alla configurazione IP.

Nome Tipo Descrizione
id

string

ID : ID risorsa ARM sotto forma di /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/...

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome Tipo Descrizione
createdAt

string

Timestamp della creazione di risorse (UTC).

createdBy

string

Identità che ha creato la risorsa.

createdByType

createdByType

Tipo di identità che ha creato la risorsa.

lastModifiedAt

string

Timestamp dell'ultima modifica della risorsa (UTC)

lastModifiedBy

string

Identità che ha modificato l'ultima risorsa.

lastModifiedByType

createdByType

Tipo di identità che ha modificato l'ultima risorsa.