Поделиться через


Network Interfaces - Update

Операция обновления сетевого интерфейса.

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

Параметры URI

Имя В Обязательно Тип Описание
networkInterfaceName
path True

string

Имя сетевого интерфейса

Шаблон регулярного выражения: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-._a-zA-Z0-9]{0,78}[_a-zA-Z0-9]$

resourceGroupName
path True

string

Имя группы ресурсов. Регистр букв в имени не учитывается.

subscriptionId
path True

string

Идентификатор целевой подписки.

api-version
query True

string

Версия API, используемая для данной операции.

Текст запроса

Имя Тип Описание
tags

object

Теги ресурсов

Ответы

Имя Тип Описание
200 OK

NetworkInterfaces

ОК

202 Accepted

Принято

Заголовки

Location: string

Other Status Codes

ErrorResponse

Ответ об ошибке, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
user_impersonation олицетворения учетной записи пользователя

Примеры

UpdateNetworkInterface

Образец запроса

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

Пример ответа

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

Определения

Имя Описание
createdByType

Тип удостоверения, создавшего ресурс.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

ErrorDetail

Сведения об ошибке.

ErrorResponse

Сообщение об ошибке

ExtendedLocation

Сложный тип расширенного расположения.

ExtendedLocationTypes

Тип расширенного расположения.

InterfaceDNSSettings
IPConfiguration

InterfaceIPConfiguration iPConfiguration в сетевом интерфейсе.

NetworkInterfaces

Определение ресурса сетевого интерфейса.

NetworkInterfacesUpdateRequest

Определение исправления ресурса сетевого интерфейса.

Properties

Свойства InterfaceIPConfigurationPropertiesFormat конфигурации IP.

ProvisioningStateEnum

Состояние подготовки сетевого интерфейса.

ProvisioningStatus
Status

Состояние операции, выполняемой в сетевом интерфейсе [Успешно, Сбой, InProgress]

Subnet

Подсеть — имя подсети, привязанной к IP-конфигурации.

systemData

Метаданные, относящиеся к созданию и последнему изменению ресурса.

createdByType

Тип удостоверения, создавшего ресурс.

Имя Тип Описание
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя Тип Описание
info

object

Дополнительные сведения.

type

string

Тип дополнительных сведений.

ErrorDetail

Сведения об ошибке.

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.

code

string

Код ошибки.

details

ErrorDetail[]

Сведения об ошибке.

message

string

Сообщение об ошибке.

target

string

Целевой объект ошибки.

ErrorResponse

Сообщение об ошибке

Имя Тип Описание
error

ErrorDetail

Объект ошибки.

ExtendedLocation

Сложный тип расширенного расположения.

Имя Тип Описание
name

string

Имя расширенного расположения.

type

ExtendedLocationTypes

Тип расширенного расположения.

ExtendedLocationTypes

Тип расширенного расположения.

Имя Тип Описание
CustomLocation

string

InterfaceDNSSettings

Имя Тип Описание
dnsServers

string[]

Список IP-адресов DNS-сервера для интерфейса

IPConfiguration

InterfaceIPConfiguration iPConfiguration в сетевом интерфейсе.

Имя Тип Описание
name

string

Имя — имя ресурса, уникального в пределах группы ресурсов. Это имя можно использовать для доступа к ресурсу.

properties

Properties

Свойства InterfaceIPConfigurationPropertiesFormat конфигурации IP.

NetworkInterfaces

Определение ресурса сетевого интерфейса.

Имя Тип Описание
extendedLocation

ExtendedLocation

ExtendedLocation ресурса.

id

string

Полный идентификатор ресурса. Пример : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Географическое расположение, в котором находится ресурс

name

string

Имя ресурса.

properties.dnsSettings

InterfaceDNSSettings

Параметры DNS для интерфейса

properties.ipConfigurations

IPConfiguration[]

IPConfigurations — список IPConfigurations сетевого интерфейса.

properties.macAddress

string

MacAddress — MAC-адрес сетевого интерфейса.

properties.provisioningState

ProvisioningStateEnum

Состояние подготовки сетевого интерфейса.

properties.status.errorCode

string

Код ошибки подготовки NetworkInterface

properties.status.errorMessage

string

Описательное сообщение об ошибке

properties.status.provisioningStatus

ProvisioningStatus

systemData

systemData

Azure Resource Manager метаданные, содержащие сведения о createdBy и modifiedBy.

tags

object

Теги ресурсов.

type

string

Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

NetworkInterfacesUpdateRequest

Определение исправления ресурса сетевого интерфейса.

Имя Тип Описание
tags

object

Теги ресурсов

Properties

Свойства InterfaceIPConfigurationPropertiesFormat конфигурации IP.

Имя Тип Описание
gateway

string

Шлюз для сетевого интерфейса

prefixLength

string

prefixLength для сетевого интерфейса

privateIPAddress

string

PrivateIPAddress — частный IP-адрес IP-конфигурации.

subnet

Subnet

Подсеть — имя подсети, привязанной к IP-конфигурации.

ProvisioningStateEnum

Состояние подготовки сетевого интерфейса.

Имя Тип Описание
Accepted

string

Canceled

string

Deleting

string

Failed

string

InProgress

string

Succeeded

string

ProvisioningStatus

Имя Тип Описание
operationId

string

Идентификатор операции, выполняемой в сетевом интерфейсе.

status

Status

Состояние операции, выполняемой в сетевом интерфейсе [Успешно, Сбой, InProgress]

Status

Состояние операции, выполняемой в сетевом интерфейсе [Успешно, Сбой, InProgress]

Имя Тип Описание
Failed

string

InProgress

string

Succeeded

string

Subnet

Подсеть — имя подсети, привязанной к IP-конфигурации.

Имя Тип Описание
id

string

Идентификатор — идентификатор ресурса ARM в виде /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/...

systemData

Метаданные, относящиеся к созданию и последнему изменению ресурса.

Имя Тип Описание
createdAt

string

Метка времени создания ресурса (UTC).

createdBy

string

Удостоверение, создающее ресурс.

createdByType

createdByType

Тип удостоверения, создавшего ресурс.

lastModifiedAt

string

Метка времени последнего изменения ресурса (UTC)

lastModifiedBy

string

Удостоверение, которое в последний раз изменял ресурс.

lastModifiedByType

createdByType

Тип удостоверения, изменяющего ресурс в последний раз.