Network Virtual Appliances - List

서비스:: Virtual Networks

API 버전:: 2025-05-01

구독의 모든 네트워크 가상 어플라이언스를 가져옵니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Network/networkVirtualAppliances?api-version=2025-05-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
subscriptionId	path	True	string (uuid)	대상 구독의 ID입니다. 값은 UUID여야 합니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

응답

Name	형식	Description
200 OK	NetworkVirtualApplianceListResult	Azure 작업이 성공적으로 완료되었습니다.
Other Status Codes	Common.CloudError	예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

List all Network Virtual Appliances for a given subscription

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/networkVirtualAppliances?api-version=2025-05-01

const { NetworkManagementClient } = require("@azure/arm-network");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to Gets all Network Virtual Appliances in a subscription.
 *
 * @summary Gets all Network Virtual Appliances in a subscription.
 * x-ms-original-file: specification/network/resource-manager/Microsoft.Network/Network/stable/2025-05-01/examples/NetworkVirtualApplianceListBySubscription.json
 */
async function listAllNetworkVirtualAppliancesForAGivenSubscription() {
  const subscriptionId = process.env["NETWORK_SUBSCRIPTION_ID"] || "subid";
  const credential = new DefaultAzureCredential();
  const client = new NetworkManagementClient(credential, subscriptionId);
  const resArray = new Array();
  for await (const item of client.networkVirtualAppliances.list()) {
    resArray.push(item);
  }
  console.log(resArray);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

샘플 응답

상태 코드:: 200

{
  "value": [
    {
      "name": "nva",
      "type": "Microsoft.Network/networkVirtualAppliances",
      "etag": "w/\\00000000-0000-0000-0000-000000000000\\",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networkVirtualAppliances/nva",
      "identity": {
        "type": "UserAssigned",
        "userAssignedIdentities": {
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity1": {}
        }
      },
      "location": "West US",
      "properties": {
        "additionalNics": [
          {
            "name": "exrsdwan",
            "hasPublicIp": true
          }
        ],
        "addressPrefix": "192.168.1.0/16",
        "bootStrapConfigurationBlobs": [
          "https://csrncvhdstorage1.blob.core.windows.net/csrncvhdstoragecont/csrbootstrapconfig"
        ],
        "cloudInitConfigurationBlobs": [
          "https://csrncvhdstorage1.blob.core.windows.net/csrncvhdstoragecont/csrcloudinitconfig"
        ],
        "inboundSecurityRules": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networkVirtualAppliances/nva/InboundSecurityRules/rule1"
          }
        ],
        "internetIngressPublicIps": [
          {
            "id": "/subscriptions/{{subscriptionId}}/resourceGroups/{{rg}}/providers/Microsoft.Network/publicIPAddresses/slbip"
          }
        ],
        "networkProfile": {
          "networkInterfaceConfigurations": [
            {
              "type": "PublicNic",
              "properties": {
                "ipConfigurations": [
                  {
                    "name": "publicnicipconfig",
                    "properties": {
                      "primary": true
                    }
                  },
                  {
                    "name": "publicnicipconfig-2",
                    "properties": {
                      "primary": false
                    }
                  }
                ]
              }
            },
            {
              "type": "PrivateNic",
              "properties": {
                "ipConfigurations": [
                  {
                    "name": "privatenicipconfig",
                    "properties": {
                      "primary": true
                    }
                  },
                  {
                    "name": "privatenicipconfig-2",
                    "properties": {
                      "primary": false
                    }
                  }
                ]
              }
            }
          ]
        },
        "nvaSku": {
          "bundledScaleUnit": "1",
          "marketPlaceVersion": "12.1",
          "vendor": "Cisco SDWAN"
        },
        "provisioningState": "Succeeded",
        "virtualApplianceAsn": 10000,
        "virtualApplianceNics": [
          {
            "name": "publicnicipconfig",
            "instanceName": "nva_0",
            "nicType": "PublicNic",
            "privateIpAddress": "192.168.12.1",
            "publicIpAddress": "40.30.2.2"
          },
          {
            "name": "publicnicipconfig-2",
            "instanceName": "nva_0",
            "nicType": "PublicNic",
            "privateIpAddress": "192.168.12.2",
            "publicIpAddress": "40.30.2.3"
          },
          {
            "name": "privatenicipconfig",
            "instanceName": "nva_0",
            "nicType": "PrivateNic",
            "privateIpAddress": "192.168.12.3",
            "publicIpAddress": ""
          },
          {
            "name": "privatenicipconfig-2",
            "instanceName": "nva_0",
            "nicType": "PrivateNic",
            "privateIpAddress": "192.168.12.4",
            "publicIpAddress": ""
          },
          {
            "name": "exrsdwan",
            "instanceName": "nva_0",
            "nicType": "AdditionalNic",
            "privateIpAddress": "10.1.113.4",
            "publicIpAddress": "4.231.25.19"
          }
        ],
        "virtualApplianceSites": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networtkVirtualAppliances/nva/virtualApplianceSites/site1"
          }
        ],
        "virtualHub": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/hub1"
        }
      },
      "tags": {
        "key1": "value1"
      }
    }
  ]
}

정의

Name	Description
Common.CloudError	서비스의 오류 응답입니다.
Common.CloudErrorBody	서비스의 오류 응답입니다.
Common.ManagedServiceIdentity	리소스의 ID입니다.
Common.SubResource	다른 하위 리소스에 대한 참조입니다.
DelegationProperties	위임의 속성입니다.
InternetIngressPublicIpsProperties	인터넷 수신 공용 IP 속성
ManagedServiceIdentityUserAssignedIdentities
NetworkVirtualAppliance	NetworkVirtualAppliance 리소스.
NetworkVirtualApplianceListResult	NetworkVirtualAppliance 리스트 작업의 응답.
NetworkVirtualAppliancePropertiesFormatNetworkProfile	공용 및 프라이빗 NIC에 대한 구성을 포함하는 네트워크 프로필입니다.
NicTypeInRequest	NIC 유형입니다. PublicNic 또는 PrivateNic여야 합니다.
NicTypeInResponse	NIC 유형 - PublicNic, PrivateNic 또는 AdditionalNic; AdditionalPrivateNic 및 AdditionalPublicNic은 VNet에 배포된 NVA에 대해서만 지원됩니다.
NvaInterfaceConfigurationsProperties	VNet 인터페이스 구성에서 NVA에 필요한 입력 매개 변수를 지정합니다.
NvaInVnetSubnetReferenceProperties	NVA NIC가 배포될 서브넷 참조
NvaNicType
PartnerManagedResourceProperties	파트너 관리 리소스의 속성입니다. SaaS NVA에만 적용됩니다.
ProvisioningState	애플리케이션 보안 그룹 리소스의 프로비저닝 상태입니다.
ResourceIdentityType	리소스에 사용되는 ID의 형식입니다. 'SystemAssigned, UserAssigned' 형식에는 암시적으로 생성된 ID와 사용자 할당 ID 집합이 모두 포함됩니다. 'None' 형식은 가상 머신에서 모든 ID를 제거합니다.
VirtualApplianceAdditionalNicProperties	네트워크 가상 어플라이언스 추가 NIC 속성
VirtualApplianceIPConfiguration	단일 IP 구성을 나타냅니다.
VirtualApplianceIPConfigurationProperties	단일 IP 구성 속성을 나타냅니다.
VirtualApplianceNetworkInterfaceConfiguration	단일 NIC 구성을 나타냅니다.
VirtualApplianceNetworkInterfaceConfigurationProperties	단일 NIC 구성 속성을 나타냅니다.
VirtualApplianceNicProperties	네트워크 가상 어플라이언스 NIC 속성입니다.
VirtualApplianceSkuProperties	네트워크 가상 어플라이언스 SKU 속성입니다.

Common.CloudError

Object

서비스의 오류 응답입니다.

Name	형식	Description
error	Common.CloudErrorBody	클라우드 오류 본문.

Common.CloudErrorBody

Object

서비스의 오류 응답입니다.

Name	형식	Description
code	string	오류의 식별자입니다. 코드는 고정적이며 프로그래밍 방식으로 사용할 수 있습니다.
details	Common.CloudErrorBody[]	오류에 대한 추가 세부 정보 목록입니다.
message	string	사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.
target	string	특정 오류의 대상입니다. 예를 들어 오류가 발생한 속성의 이름입니다.

Common.ManagedServiceIdentity

Object

리소스의 ID입니다.

Name	형식	Description
principalId	string	시스템 할당 ID의 주체 ID입니다. 이 속성은 시스템 할당 ID에 대해서만 제공됩니다.
tenantId	string	시스템 할당 ID의 테넌트 ID입니다. 이 속성은 시스템 할당 ID에 대해서만 제공됩니다.
type	ResourceIdentityType	리소스에 사용되는 ID의 형식입니다. 'SystemAssigned, UserAssigned' 형식에는 암시적으로 생성된 ID와 사용자 할당 ID 집합이 모두 포함됩니다. 'None' 형식은 가상 머신에서 모든 ID를 제거합니다.
userAssignedIdentities	<string, ManagedServiceIdentityUserAssignedIdentities>	리소스와 연결된 사용자 ID 목록입니다. 사용자 ID 사전 키 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' 형식의 ARM 리소스 ID입니다.

Common.SubResource

Object

다른 하위 리소스에 대한 참조입니다.

Name	형식	Description
id	string	리소스 ID입니다.

DelegationProperties

Object

위임의 속성입니다.

Name	형식	Description
provisioningState	ProvisioningState	리소스의 상태를 프로비전합니다.
serviceName	string	NVA가 위임되는 서비스 이름입니다.

InternetIngressPublicIpsProperties

Object

인터넷 수신 공용 IP 속성

Name	형식	Description
id	string (arm-id)	공용 IP의 리소스 URI

ManagedServiceIdentityUserAssignedIdentities

Object

Name	형식	Description
clientId	string	사용자 할당 ID의 클라이언트 ID입니다.
principalId	string	사용자 할당 ID의 보안 주체 ID입니다.

NetworkVirtualAppliance

Object

NetworkVirtualAppliance 리소스.

Name	형식	Description
etag	string	리소스를 업데이트할 때마다 변경되는 고유한 읽기 전용 문자열입니다.
id	string	리소스 ID입니다.
identity	Common.ManagedServiceIdentity	cloud-init 및 구성 Blob에 대한 읽기 권한이 있는 서비스 주체입니다.
location	string	리소스 위치입니다.
name	string	리소스 이름입니다.
properties.additionalNics	VirtualApplianceAdditionalNicProperties[]	추가 네트워크 인터페이스에 필요한 세부 정보입니다. 이 속성은 VNet에 배포된 NVA와 호환되지 않습니다.
properties.addressPrefix	string	주소 접두사입니다.
properties.bootStrapConfigurationBlobs	string[]	BootStrapConfigurationBlobs 스토리지 URL.
properties.cloudInitConfiguration	string	일반 텍스트의 CloudInitConfiguration 문자열입니다.
properties.cloudInitConfigurationBlobs	string[]	CloudInitConfigurationBlob 스토리지 URL.
properties.delegation	DelegationProperties	가상 어플라이언스에 대한 위임입니다. SaaS NVA에만 적용됩니다.
properties.deploymentType	string	배포 유형입니다. SaaS NVA를 위한 PartnerManaged
properties.inboundSecurityRules	Common.SubResource[]	InboundSecurityRules에 대한 참조 목록입니다.
properties.internetIngressPublicIps	InternetIngressPublicIpsProperties[]	인터넷 수신 시나리오에 대한 공용 IP의 리소스 URI 목록입니다.
properties.networkProfile	NetworkVirtualAppliancePropertiesFormatNetworkProfile	공용 및 프라이빗 NIC에 대한 구성을 포함하는 네트워크 프로필입니다.
properties.nvaInterfaceConfigurations	NvaInterfaceConfigurationsProperties[]	VNet 인터페이스 구성의 NVA
properties.nvaSku	VirtualApplianceSkuProperties	네트워크 가상 어플라이언스 SKU.
properties.partnerManagedResource	PartnerManagedResourceProperties	가상 어플라이언스 위임
properties.privateIpAddress	string	내부 Load Balancer의 HA 포트 프런트 엔드 IP 주소입니다. NVA 인스턴스 간에 트래픽의 부하를 분산하기 위해 경로 및 UDR을 설정하는 데 사용할 수 있습니다.
properties.provisioningState	ProvisioningState	리소스의 프로비전 상태입니다.
properties.sshPublicKey	string	SSH 로그인에 대한 공개 키입니다.
properties.virtualApplianceAsn	integer (int64) minimum: 0 maximum: 4294967295	VirtualAppliance ASN입니다. Microsoft 프라이빗, 퍼블릭 및 IANA 예약 ASN은 지원되지 않습니다.
properties.virtualApplianceConnections	Common.SubResource[]	VirtualApplianceConnections에 대한 참조 목록입니다.
properties.virtualApplianceNics	VirtualApplianceNicProperties[]	가상 어플라이언스 네트워크 인터페이스 목록입니다.
properties.virtualApplianceSites	Common.SubResource[]	VirtualApplianceSite에 대한 참조 목록입니다.
properties.virtualHub	Common.SubResource	네트워크 가상 어플라이언스 배포 중인 가상 허브입니다.
tags	object	리소스 태그.
type	string	리소스 종류입니다.

NetworkVirtualApplianceListResult

Object

NetworkVirtualAppliance 리스트 작업의 응답.

Name	형식	Description
nextLink	string (uri)	항목의 다음 페이지에 대한 링크
value	NetworkVirtualAppliance[]	이 페이지의 NetworkVirtualAppliance 항목들

NetworkVirtualAppliancePropertiesFormatNetworkProfile

Object

공용 및 프라이빗 NIC에 대한 구성을 포함하는 네트워크 프로필입니다.

Name	형식	Description
networkInterfaceConfigurations	VirtualApplianceNetworkInterfaceConfiguration[]	단일 NIC 구성을 나타냅니다.

NicTypeInRequest

열거형

NIC 유형입니다. PublicNic 또는 PrivateNic여야 합니다.

값	Description
PublicNic	퍼블릭닉
PrivateNic	프라이빗닉

NicTypeInResponse

열거형

NIC 유형 - PublicNic, PrivateNic 또는 AdditionalNic; AdditionalPrivateNic 및 AdditionalPublicNic은 VNet에 배포된 NVA에 대해서만 지원됩니다.

값	Description
PublicNic	퍼블릭닉
PrivateNic	프라이빗닉
AdditionalNic	추가 정보

NvaInterfaceConfigurationsProperties

Object

VNet 인터페이스 구성에서 NVA에 필요한 입력 매개 변수를 지정합니다.

Name	형식	Description
name	string maxLength: 70	인터페이스의 이름을 지정합니다. 최대 길이는 70자입니다.
subnet	NvaInVnetSubnetReferenceProperties	NVA NIC가 배포될 서브넷 참조 NIC가 배포될 서브넷 리소스 ID입니다. 각 서브넷 리소스 URI는 고유해야 합니다.
type	NvaNicType[]	NVA 인터페이스 구성에 대한 NIC 유형을 지정합니다. 허용되는 값: PrivateNic, PublicNic, AdditionalPrivateNic, AdditionalPublicNic. 현재 PrivateNic과 PublicNic의 조합만 지원됩니다.

NvaInVnetSubnetReferenceProperties

Object

NVA NIC가 배포될 서브넷 참조

Name	형식	Description
id	string (arm-id)	서브넷의 리소스 URI

NvaNicType

열거형

값	Description
PrivateNic	개인 NIC 유형
PublicNic	공용 NIC 유형
AdditionalPrivateNic	추가 개인 NIC 유형
AdditionalPublicNic	추가 공용 NIC 유형

PartnerManagedResourceProperties

Object

파트너 관리 리소스의 속성입니다. SaaS NVA에만 적용됩니다.

Name	형식	Description
id	string (arm-id)	파트너 관리 리소스 ID입니다.
internalLoadBalancerId	string (arm-id)	파트너가 관리한 ILB 리소스 ID
standardLoadBalancerId	string (arm-id)	파트너 관리 SLB 리소스 ID

ProvisioningState

열거형

애플리케이션 보안 그룹 리소스의 프로비저닝 상태입니다.

값	Description
Failed	실패
Succeeded	성공함
Canceled	취소됨
Creating	만드는 중
Updating	업데이트 중
Deleting	삭제 중

ResourceIdentityType

열거형

리소스에 사용되는 ID의 형식입니다. 'SystemAssigned, UserAssigned' 형식에는 암시적으로 생성된 ID와 사용자 할당 ID 집합이 모두 포함됩니다. 'None' 형식은 가상 머신에서 모든 ID를 제거합니다.

값	Description
SystemAssigned	시스템 지정됨
UserAssigned	UserAssigned
SystemAssigned, UserAssigned	SystemAssigned, UserAssigned(시스템할당)
None	없음

VirtualApplianceAdditionalNicProperties

Object

네트워크 가상 어플라이언스 추가 NIC 속성

Name	형식	Description
hasPublicIp	boolean	추가 nic에서 공용 IP에 대한 의도에 대한 플래그(true 또는 false)
name	string	추가 nic의 이름

VirtualApplianceIPConfiguration

Object

단일 IP 구성을 나타냅니다.

Name	형식	Description
name	string	허브 NVA의 경우 기본 IP 구성의 이름은 'privatenicipconfig' 및 'publicnicipconfig'여야 하며, 기본이 아닌 구성은 이러한 접두사를 사용해야 합니다. VNet의 NVA에는 명명 제한이 적용되지 않습니다. 최대 80자가 허용됩니다.
properties	VirtualApplianceIPConfigurationProperties	단일 IP 구성 속성을 나타냅니다.

VirtualApplianceIPConfigurationProperties

Object

단일 IP 구성 속성을 나타냅니다.

Name	형식	Description
primary	boolean	이것이 NIC의 기본 IP 구성인지 여부입니다.

VirtualApplianceNetworkInterfaceConfiguration

Object

단일 NIC 구성을 나타냅니다.

Name	형식	Description
properties	VirtualApplianceNetworkInterfaceConfigurationProperties	단일 NIC 구성 속성을 나타냅니다.
type	NicTypeInRequest	NIC 유형입니다. PublicNic 또는 PrivateNic여야 합니다.

VirtualApplianceNetworkInterfaceConfigurationProperties

Object

단일 NIC 구성 속성을 나타냅니다.

Name	형식	Description
ipConfigurations	VirtualApplianceIPConfiguration[]	단일 IP 구성을 나타냅니다.

VirtualApplianceNicProperties

Object

네트워크 가상 어플라이언스 NIC 속성입니다.

Name	형식	Description
instanceName	string	nic가 연결된 인스턴스입니다.
name	string	NIC 이름입니다.
nicType	NicTypeInResponse	NIC 유형 - PublicNic, PrivateNic 또는 AdditionalNic; AdditionalPrivateNic 및 AdditionalPublicNic은 VNet에 배포된 NVA에 대해서만 지원됩니다.
privateIpAddress	string	개인 IP 주소입니다.
publicIpAddress	string	공용 IP 주소.

VirtualApplianceSkuProperties

Object

네트워크 가상 어플라이언스 SKU 속성입니다.

Name	형식	Description
bundledScaleUnit	string	가상 어플라이언스 배율 단위입니다.
marketPlaceVersion	string	가상 어플라이언스 버전입니다.
vendor	string	가상 어플라이언스 공급업체.