Sdílet prostřednictvím


Network Interfaces - Update

Operace aktualizace síťového rozhraní.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
networkInterfaceName
path True

string

Název síťového rozhraní

Vzor regulárního výrazu: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-._a-zA-Z0-9]{0,78}[_a-zA-Z0-9]$

resourceGroupName
path True

string

Název skupiny prostředků. V názvu se rozlišují malá a velká písmena.

subscriptionId
path True

string

ID cílového předplatného.

api-version
query True

string

Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name Typ Description
tags

object

Značky prostředků

Odpovědi

Name Typ Description
200 OK

NetworkInterfaces

OK

202 Accepted

Přijato

Hlavičky

Location: string

Other Status Codes

ErrorResponse

Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

UpdateNetworkInterface

Ukázkový požadavek

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

Ukázková odpověď

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

Definice

Name Description
createdByType

Typ identity, která prostředek vytvořila.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

ErrorDetail

Podrobnosti o chybě

ErrorResponse

Chybová odpověď

ExtendedLocation

Komplexní typ rozšířeného umístění.

ExtendedLocationTypes

Typ rozšířeného umístění.

InterfaceDNSSettings
IPConfiguration

InterfaceIPConfiguration iPConfiguration v síťovém rozhraní.

NetworkInterfaces

Definice prostředku síťového rozhraní.

NetworkInterfacesUpdateRequest

Definice opravy prostředků síťového rozhraní

Properties

Vlastnosti InterfaceIPConfigurationPropertiesFormat konfigurace PROTOKOLU IP.

ProvisioningStateEnum

Stav zřizování síťového rozhraní.

ProvisioningStatus
Status

Stav operace provedené v síťovém rozhraní [Succeeded, Failed, InProgress]

Subnet

Podsíť – název podsítě vázané na konfiguraci PROTOKOLU IP.

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

createdByType

Typ identity, která prostředek vytvořila.

Name Typ Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name Typ Description
info

object

Další informace.

type

string

Typ další informace.

ErrorDetail

Podrobnosti o chybě

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Další informace o chybě.

code

string

Kód chyby

details

ErrorDetail[]

Podrobnosti o chybě.

message

string

Chybová zpráva

target

string

Cíl chyby.

ErrorResponse

Chybová odpověď

Name Typ Description
error

ErrorDetail

Objekt chyby.

ExtendedLocation

Komplexní typ rozšířeného umístění.

Name Typ Description
name

string

Název rozšířeného umístění.

type

ExtendedLocationTypes

Typ rozšířeného umístění.

ExtendedLocationTypes

Typ rozšířeného umístění.

Name Typ Description
CustomLocation

string

InterfaceDNSSettings

Name Typ Description
dnsServers

string[]

Seznam IP adres serveru DNS pro rozhraní

IPConfiguration

InterfaceIPConfiguration iPConfiguration v síťovém rozhraní.

Name Typ Description
name

string

Název – název prostředku, který je jedinečný v rámci skupiny prostředků. Tento název se dá použít pro přístup k prostředku.

properties

Properties

Vlastnosti InterfaceIPConfigurationPropertiesFormat konfigurace PROTOKOLU IP.

NetworkInterfaces

Definice prostředku síťového rozhraní.

Name Typ Description
extendedLocation

ExtendedLocation

ExtendedLocation prostředku.

id

string

Plně kvalifikované ID prostředku Příklad : /subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/providers/{resourceProviderNamespace}/{typ_prostředku}/{název_prostředku}

location

string

Geografické umístění, kde se prostředek nachází

name

string

Název prostředku

properties.dnsSettings

InterfaceDNSSettings

Nastavení DNS pro rozhraní

properties.ipConfigurations

IPConfiguration[]

IPConfigurations – seznam IPKonfigurací síťového rozhraní.

properties.macAddress

string

MacAddress – adresa MAC síťového rozhraní.

properties.provisioningState

ProvisioningStateEnum

Stav zřizování síťového rozhraní.

properties.status.errorCode

string

Kód chyby zřizování NetworkInterface

properties.status.errorMessage

string

Popisná chybová zpráva

properties.status.provisioningStatus

ProvisioningStatus

systemData

systemData

Azure Resource Manager metadata obsahující informace createdBy a modifiedBy.

tags

object

Značky prostředků.

type

string

Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

NetworkInterfacesUpdateRequest

Definice opravy prostředků síťového rozhraní

Name Typ Description
tags

object

Značky prostředků

Properties

Vlastnosti InterfaceIPConfigurationPropertiesFormat konfigurace PROTOKOLU IP.

Name Typ Description
gateway

string

Brána pro síťové rozhraní

prefixLength

string

prefixLength pro síťové rozhraní

privateIPAddress

string

PrivateIPAddress – privátní IP adresa konfigurace IP adresy.

subnet

Subnet

Podsíť – název podsítě vázané na konfiguraci PROTOKOLU IP.

ProvisioningStateEnum

Stav zřizování síťového rozhraní.

Name Typ Description
Accepted

string

Canceled

string

Deleting

string

Failed

string

InProgress

string

Succeeded

string

ProvisioningStatus

Name Typ Description
operationId

string

ID operace provedené v síťovém rozhraní

status

Status

Stav operace provedené v síťovém rozhraní [Succeeded, Failed, InProgress]

Status

Stav operace provedené v síťovém rozhraní [Succeeded, Failed, InProgress]

Name Typ Description
Failed

string

InProgress

string

Succeeded

string

Subnet

Podsíť – název podsítě vázané na konfiguraci PROTOKOLU IP.

Name Typ Description
id

string

ID – ID prostředku ARM ve tvaru /subscriptions/{SubscriptionId}/resourceGroups/{Název_skupiny_prostředků}/...

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

Name Typ Description
createdAt

string

Časové razítko vytvoření prostředku (UTC)

createdBy

string

Identita, která vytvořila prostředek.

createdByType

createdByType

Typ identity, která prostředek vytvořila.

lastModifiedAt

string

Časové razítko poslední změny prostředku (UTC)

lastModifiedBy

string

Identita, která naposledy změnila prostředek.

lastModifiedByType

createdByType

Typ identity, která naposledy změnila prostředek.