Compartir a través de


Network Interfaces - Update

Operación para actualizar una interfaz de red.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
networkInterfaceName
path True

string

Nombre de la interfaz de red

Patrón de Regex: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-._a-zA-Z0-9]{0,78}[_a-zA-Z0-9]$

resourceGroupName
path True

string

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

subscriptionId
path True

string

Identificador de la suscripción de destino.

api-version
query True

string

Versión de API que se usará para la operación.

Cuerpo de la solicitud

Nombre Tipo Description
tags

object

Etiquetas del recurso

Respuestas

Nombre Tipo Description
200 OK

NetworkInterfaces

Aceptar

202 Accepted

Aceptado

Encabezados

Location: string

Other Status Codes

ErrorResponse

Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantación de su cuenta de usuario

Ejemplos

UpdateNetworkInterface

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre Description
createdByType

Tipo de identidad que creó el recurso.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

ExtendedLocation

Tipo complejo de la ubicación extendida.

ExtendedLocationTypes

Tipo de la ubicación extendida.

InterfaceDNSSettings
IPConfiguration

InterfaceIPConfiguration iPConfiguration en una interfaz de red.

NetworkInterfaces

Definición de recursos de la interfaz de red.

NetworkInterfacesUpdateRequest

Definición de revisión de recursos de la interfaz de red.

Properties

Propiedades InterfaceIPConfigurationPropertiesFormat de la configuración de IP.

ProvisioningStateEnum

Estado de aprovisionamiento de la interfaz de red.

ProvisioningStatus
Status

Estado de la operación realizada en la interfaz de red [Succeeded, Failed, InProgress]

Subnet

Subred: nombre de subred enlazada a la configuración de IP.

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

createdByType

Tipo de identidad que creó el recurso.

Nombre Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.

type

string

Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Los detalles del error.

message

string

El mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

ExtendedLocation

Tipo complejo de la ubicación extendida.

Nombre Tipo Description
name

string

Nombre de la ubicación extendida.

type

ExtendedLocationTypes

Tipo de la ubicación extendida.

ExtendedLocationTypes

Tipo de la ubicación extendida.

Nombre Tipo Description
CustomLocation

string

InterfaceDNSSettings

Nombre Tipo Description
dnsServers

string[]

Lista de direcciones IP del servidor DNS para la interfaz

IPConfiguration

InterfaceIPConfiguration iPConfiguration en una interfaz de red.

Nombre Tipo Description
name

string

Nombre: el nombre del recurso que es único dentro de un grupo de recursos. Este nombre se puede usar para acceder al recurso.

properties

Properties

Propiedades InterfaceIPConfigurationPropertiesFormat de la configuración de IP.

NetworkInterfaces

Definición de recursos de la interfaz de red.

Nombre Tipo Description
extendedLocation

ExtendedLocation

ExtendedLocation del recurso.

id

string

Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Ubicación geográfica donde reside el recurso

name

string

Nombre del recurso.

properties.dnsSettings

InterfaceDNSSettings

Configuración de DNS para la interfaz

properties.ipConfigurations

IPConfiguration[]

IPConfigurations: una lista de IPConfigurations de la interfaz de red.

properties.macAddress

string

MacAddress: la dirección MAC de la interfaz de red.

properties.provisioningState

ProvisioningStateEnum

Estado de aprovisionamiento de la interfaz de red.

properties.status.errorCode

string

Código de error de aprovisionamiento de NetworkInterface

properties.status.errorMessage

string

Mensaje de error descriptivo

properties.status.provisioningStatus

ProvisioningStatus

systemData

systemData

Metadatos de Azure Resource Manager que contienen información sobre los valores de createdBy y modifiedBy.

tags

object

Etiquetas del recurso.

type

string

Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

NetworkInterfacesUpdateRequest

Definición de revisión de recursos de la interfaz de red.

Nombre Tipo Description
tags

object

Etiquetas del recurso

Properties

Propiedades InterfaceIPConfigurationPropertiesFormat de la configuración de IP.

Nombre Tipo Description
gateway

string

Puerta de enlace para la interfaz de red

prefixLength

string

prefixLength para la interfaz de red

privateIPAddress

string

PrivateIPAddress: dirección IP privada de la configuración de IP.

subnet

Subnet

Subred: nombre de subred enlazada a la configuración de IP.

ProvisioningStateEnum

Estado de aprovisionamiento de la interfaz de red.

Nombre Tipo Description
Accepted

string

Canceled

string

Deleting

string

Failed

string

InProgress

string

Succeeded

string

ProvisioningStatus

Nombre Tipo Description
operationId

string

Identificador de la operación realizada en la interfaz de red

status

Status

Estado de la operación realizada en la interfaz de red [Succeeded, Failed, InProgress]

Status

Estado de la operación realizada en la interfaz de red [Succeeded, Failed, InProgress]

Nombre Tipo Description
Failed

string

InProgress

string

Succeeded

string

Subnet

Subred: nombre de subred enlazada a la configuración de IP.

Nombre Tipo Description
id

string

Identificador: el identificador de recurso de ARM en forma de /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/...

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

Nombre Tipo Description
createdAt

string

Marca de tiempo de creación de recursos (UTC).

createdBy

string

Identidad que creó el recurso.

createdByType

createdByType

Tipo de identidad que creó el recurso.

lastModifiedAt

string

Marca de tiempo de la última modificación del recurso (UTC)

lastModifiedBy

string

Identidad que modificó por última vez el recurso.

lastModifiedByType

createdByType

Tipo de identidad que modificó por última vez el recurso.