Partilhar via


Network Interfaces - Update

A operação para atualizar uma interface de rede.

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

Parâmetros do URI

Name Em Necessário Tipo Description
networkInterfaceName
path True

string

Nome da interface de rede

Padrão Regex: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-._a-zA-Z0-9]{0,78}[_a-zA-Z0-9]$

resourceGroupName
path True

string

O nome do grupo de recursos. O nome não é sensível a maiúsculas e minúsculas.

subscriptionId
path True

string

O ID da subscrição de destino.

api-version
query True

string

A versão da API a utilizar para esta operação.

Corpo do Pedido

Name Tipo Description
tags

object

Etiquetas de recursos

Respostas

Name Tipo Description
200 OK

NetworkInterfaces

OK

202 Accepted

Aceite

Cabeçalhos

Location: string

Other Status Codes

ErrorResponse

Resposta de erro que descreve o motivo pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation representar a sua conta de utilizador

Exemplos

UpdateNetworkInterface

Pedido de amostra

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

Resposta da amostra

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

Definições

Name Description
createdByType

O tipo de identidade que criou o recurso.

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta a erros

ExtendedLocation

O tipo complexo da localização expandida.

ExtendedLocationTypes

O tipo de localização expandida.

InterfaceDNSSettings
IPConfiguration

InterfaceIPConfiguration iPConfiguration numa interface de rede.

NetworkInterfaces

A definição de recurso da interface de rede.

NetworkInterfacesUpdateRequest

A definição de patch de recurso da interface de rede.

Properties

InterfaceIPConfigurationPropertiesFormat propriedades da configuração de IP.

ProvisioningStateEnum

Estado de aprovisionamento da interface de rede.

ProvisioningStatus
Status

O estado da operação realizada na interface de rede [Succeeded, Failed, InProgress]

Subnet

Sub-rede - Nome da Sub-rede vinculada à configuração de IP.

systemData

Metadados relativos à criação e última modificação do recurso.

createdByType

O tipo de identidade que criou o recurso.

Name Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

Name Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informações adicionais.

ErrorDetail

O detalhe do erro.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta a erros

Name Tipo Description
error

ErrorDetail

O objeto de erro.

ExtendedLocation

O tipo complexo da localização expandida.

Name Tipo Description
name

string

O nome da localização expandida.

type

ExtendedLocationTypes

O tipo de localização expandida.

ExtendedLocationTypes

O tipo de localização expandida.

Name Tipo Description
CustomLocation

string

InterfaceDNSSettings

Name Tipo Description
dnsServers

string[]

Lista de Endereços IP do servidor DNS para a interface

IPConfiguration

InterfaceIPConfiguration iPConfiguration numa interface de rede.

Name Tipo Description
name

string

Nome – o nome do recurso que é exclusivo num grupo de recursos. Este nome pode ser utilizado para aceder ao recurso.

properties

Properties

InterfaceIPConfigurationPropertiesFormat propriedades da configuração de IP.

NetworkInterfaces

A definição de recurso da interface de rede.

Name Tipo Description
extendedLocation

ExtendedLocation

A extendedLocation do recurso.

id

string

ID de recurso completamente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

A localização geográfica onde reside o recurso

name

string

O nome do recurso

properties.dnsSettings

InterfaceDNSSettings

Definições de DNS para a interface

properties.ipConfigurations

IPConfiguration[]

IPConfigurations – uma lista de IPConfigurations da interface de rede.

properties.macAddress

string

MacAddress – o endereço MAC da interface de rede.

properties.provisioningState

ProvisioningStateEnum

Estado de aprovisionamento da interface de rede.

properties.status.errorCode

string

Código de erro de aprovisionamento networkInterface

properties.status.errorMessage

string

Mensagem de erro descritiva

properties.status.provisioningStatus

ProvisioningStatus

systemData

systemData

O Azure Resource Manager metadados que contêm createdBy e modifiedBy information.

tags

object

Etiquetas de recursos.

type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

NetworkInterfacesUpdateRequest

A definição de patch de recurso da interface de rede.

Name Tipo Description
tags

object

Etiquetas de recursos

Properties

InterfaceIPConfigurationPropertiesFormat propriedades da configuração de IP.

Name Tipo Description
gateway

string

Gateway para interface de rede

prefixLength

string

prefixLength para a interface de rede

privateIPAddress

string

PrivateIPAddress – endereço IP privado da configuração do IP.

subnet

Subnet

Sub-rede - Nome da Sub-rede vinculada à configuração de IP.

ProvisioningStateEnum

Estado de aprovisionamento da interface de rede.

Name Tipo Description
Accepted

string

Canceled

string

Deleting

string

Failed

string

InProgress

string

Succeeded

string

ProvisioningStatus

Name Tipo Description
operationId

string

O ID da operação executada na interface de rede

status

Status

O estado da operação realizada na interface de rede [Succeeded, Failed, InProgress]

Status

O estado da operação realizada na interface de rede [Succeeded, Failed, InProgress]

Name Tipo Description
Failed

string

InProgress

string

Succeeded

string

Subnet

Sub-rede - Nome da Sub-rede vinculada à configuração de IP.

Name Tipo Description
id

string

ID – o ID de recurso do ARM sob a forma de /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/...

systemData

Metadados relativos à criação e última modificação do recurso.

Name Tipo Description
createdAt

string

O carimbo de data/hora da criação de recursos (UTC).

createdBy

string

A identidade que criou o recurso.

createdByType

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt

string

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy

string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.