Udostępnij za pośrednictwem


Virtual Hubs - List By Resource Group

Wyświetla listę wszystkich usług VirtualHubs w grupie zasobów.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs?api-version=2024-05-01

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
resourceGroupName
path True

string

Nazwa grupy zasobów usługi VirtualHub.

subscriptionId
path True

string

Poświadczenia subskrypcji, które jednoznacznie identyfikują subskrypcję platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi.

api-version
query True

string

Wersja interfejsu API klienta.

Odpowiedzi

Nazwa Typ Opis
200 OK

ListVirtualHubsResult

Żądanie powiodło się. Zwraca szczegóły wszystkich usługi VirtualHubs w grupie zasobów.

Other Status Codes

CloudError

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

VirtualHubListByResourceGroup

Przykładowe żądanie

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs?api-version=2024-05-01

Przykładowa odpowiedź

{
  "value": [
    {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1",
      "etag": "w/\\00000000-0000-0000-0000-000000000000\\",
      "location": "West US",
      "name": "virtualHub1",
      "type": "Microsoft.Network/virtualHubs",
      "properties": {
        "provisioningState": "Succeeded",
        "virtualWan": {
          "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualWans/virtualWan1"
        },
        "virtualHubRouteTableV2s": [
          {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub2/routeTables/virtualHubRouteTable2",
            "etag": "w/\\00000000-0000-0000-0000-000000000000\\",
            "name": "rt2a",
            "properties": {
              "provisioningState": "Succeeded",
              "routes": [
                {
                  "destinationType": "CIDR",
                  "destinations": [
                    "20.10.0.0/16",
                    "20.20.0.0/16"
                  ],
                  "nextHopType": "IPAddress",
                  "nextHops": [
                    "10.0.0.68"
                  ]
                },
                {
                  "destinationType": "CIDR",
                  "destinations": [
                    "0.0.0.0/0"
                  ],
                  "nextHopType": "IPAddress",
                  "nextHops": [
                    "10.0.0.68"
                  ]
                }
              ],
              "attachedConnections": [
                "All_Vnets"
              ]
            }
          }
        ],
        "addressPrefix": "10.10.1.0/24",
        "sku": "Basic",
        "routingState": "Provisioned",
        "virtualRouterAsn": 65515,
        "virtualRouterIps": [
          "10.10.1.12",
          "10.10.1.13"
        ],
        "allowBranchToBranchTraffic": false,
        "preferredRoutingGateway": "ExpressRoute",
        "hubRoutingPreference": "ExpressRoute",
        "virtualRouterAutoScaleConfiguration": {
          "minCapacity": 2
        }
      }
    },
    {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub2",
      "etag": "w/\\00000000-0000-0000-0000-000000000000\\",
      "location": "East US",
      "name": "virtualHub2",
      "type": "Microsoft.Network/virtualHubs",
      "properties": {
        "provisioningState": "Succeeded",
        "virtualWan": {
          "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualWans/virtualWan1"
        },
        "virtualHubRouteTableV2s": [
          {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub2/routeTables/virtualHubRouteTable2",
            "etag": "w/\\00000000-0000-0000-0000-000000000000\\",
            "name": "rt2a",
            "properties": {
              "provisioningState": "Succeeded",
              "routes": [
                {
                  "destinationType": "CIDR",
                  "destinations": [
                    "20.10.0.0/16",
                    "20.20.0.0/16"
                  ],
                  "nextHopType": "IPAddress",
                  "nextHops": [
                    "10.0.0.68"
                  ]
                },
                {
                  "destinationType": "CIDR",
                  "destinations": [
                    "0.0.0.0/0"
                  ],
                  "nextHopType": "IPAddress",
                  "nextHops": [
                    "10.0.0.68"
                  ]
                }
              ],
              "attachedConnections": [
                "All_Vnets"
              ]
            }
          }
        ],
        "addressPrefix": "210.10.1.0/24",
        "sku": "Basic",
        "routingState": "Provisioned",
        "virtualRouterAsn": 65515,
        "virtualRouterIps": [
          "10.10.1.12",
          "10.10.1.13"
        ],
        "allowBranchToBranchTraffic": false,
        "preferredRoutingGateway": "ExpressRoute",
        "hubRoutingPreference": "ExpressRoute",
        "virtualRouterAutoScaleConfiguration": {
          "minCapacity": 2
        }
      }
    }
  ]
}

Definicje

Nazwa Opis
CloudError

Odpowiedź na błąd z usługi.

CloudErrorBody

Odpowiedź na błąd z usługi.

HubRoutingPreference

Typy bram preferencji routingu koncentratora

ListVirtualHubsResult

Wynik żądania wyświetlenia listy usługi VirtualHubs. Zawiera listę usług VirtualHubs i adres URL oboklinku, aby uzyskać następny zestaw wyników.

PreferredRoutingGateway

Preferowane typy bram routingu

ProvisioningState

Bieżący stan aprowizacji.

RoutingState

Bieżący stan routingu usługi VirtualHub.

SubResource

Odwołanie do innego podźródła.

VirtualHub

Zasób usługi VirtualHub.

VirtualHubRoute

Trasa usługi VirtualHub.

VirtualHubRouteTable

Tabela tras usługi VirtualHub.

VirtualHubRouteTableV2

Zasób VirtualHubRouteTableV2.

VirtualHubRouteV2

Trasa VirtualHubRouteTableV2.

VirtualRouterAutoScaleConfiguration

Konfiguracja automatycznego skalowania routera usługi VirtualHub.

CloudError

Odpowiedź na błąd z usługi.

Nazwa Typ Opis
error

CloudErrorBody

Treść błędu chmury.

CloudErrorBody

Odpowiedź na błąd z usługi.

Nazwa Typ Opis
code

string

Identyfikator błędu. Kody są niezmienne i mają być używane programowo.

details

CloudErrorBody[]

Lista dodatkowych szczegółów dotyczących błędu.

message

string

Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika.

target

string

Element docelowy określonego błędu. Na przykład nazwa właściwości w błędzie.

HubRoutingPreference

Typy bram preferencji routingu koncentratora

Nazwa Typ Opis
ASPath

string

ExpressRoute

string

VpnGateway

string

ListVirtualHubsResult

Wynik żądania wyświetlenia listy usługi VirtualHubs. Zawiera listę usług VirtualHubs i adres URL oboklinku, aby uzyskać następny zestaw wyników.

Nazwa Typ Opis
nextLink

string

Adres URL umożliwiający pobranie następnego zestawu wyników listy operacji, jeśli istnieją.

value

VirtualHub[]

Lista usługi VirtualHubs.

PreferredRoutingGateway

Preferowane typy bram routingu

Nazwa Typ Opis
ExpressRoute

string

None

string

VpnGateway

string

ProvisioningState

Bieżący stan aprowizacji.

Nazwa Typ Opis
Deleting

string

Failed

string

Succeeded

string

Updating

string

RoutingState

Bieżący stan routingu usługi VirtualHub.

Nazwa Typ Opis
Failed

string

None

string

Provisioned

string

Provisioning

string

SubResource

Odwołanie do innego podźródła.

Nazwa Typ Opis
id

string

Identyfikator zasobu.

VirtualHub

Zasób usługi VirtualHub.

Nazwa Typ Opis
etag

string

Unikatowy ciąg tylko do odczytu, który zmienia się za każdym razem, gdy zasób jest aktualizowany.

id

string

Identyfikator zasobu.

kind

string

Rodzaj koncentratora wirtualnego usługi. Są to metadane używane w środowisku witryny Azure Portal dla usługi Route Server.

location

string

Lokalizacja zasobu.

name

string

Nazwa zasobu.

properties.addressPrefix

string

Prefiks adresu dla tej usługi VirtualHub.

properties.allowBranchToBranchTraffic

boolean

Flaga do kontrolowania tranzytu dla koncentratora VirtualRouter.

properties.azureFirewall

SubResource

AzureFirewall skojarzone z tą usługą VirtualHub.

properties.bgpConnections

SubResource[]

Lista odwołań do połączeń Bgp.

properties.expressRouteGateway

SubResource

Brama expressRouteGateway skojarzona z tą usługą VirtualHub.

properties.hubRoutingPreference

HubRoutingPreference

HubRoutingPreference dla tej usługi VirtualHub.

properties.ipConfigurations

SubResource[]

Lista odwołań do obiektów IpConfigurations.

properties.p2SVpnGateway

SubResource

Brama P2SVpnGateway skojarzona z tą usługą VirtualHub.

properties.preferredRoutingGateway

PreferredRoutingGateway

Preferowana brama do kierowania ruchu lokalnego

properties.provisioningState

ProvisioningState

Stan aprowizacji zasobu koncentratora wirtualnego.

properties.routeMaps

SubResource[]

Lista odwołań do routeMaps.

properties.routeTable

VirtualHubRouteTable

Tabela routeTable skojarzona z tym koncentratorem wirtualnym.

properties.routingState

RoutingState

Stan routingu.

properties.securityPartnerProvider

SubResource

Dostawca securityPartnerProvider skojarzony z tą usługą VirtualHub.

properties.securityProviderName

string

Nazwa dostawcy zabezpieczeń.

properties.sku

string

Jednostka SKU tej usługi VirtualHub.

properties.virtualHubRouteTableV2s

VirtualHubRouteTableV2[]

Lista wszystkich tabel tras koncentratora wirtualnego w wersji 2 skojarzonych z tą usługą VirtualHub.

properties.virtualRouterAsn

integer

VirtualRouter ASN.

properties.virtualRouterAutoScaleConfiguration

VirtualRouterAutoScaleConfiguration

Konfiguracja automatycznego skalowania routera usługi VirtualHub.

properties.virtualRouterIps

string[]

Wirtualne adresy IP.

properties.virtualWan

SubResource

Wirtualna siećWAN, do której należy usługa VirtualHub.

properties.vpnGateway

SubResource

Brama VpnGateway skojarzona z tą usługą VirtualHub.

tags

object

Tagi zasobów.

type

string

Typ zasobu.

VirtualHubRoute

Trasa usługi VirtualHub.

Nazwa Typ Opis
addressPrefixes

string[]

Lista wszystkich adresówPrefiksy.

nextHopIpAddress

string

Adres IP elementu NextHop.

VirtualHubRouteTable

Tabela tras usługi VirtualHub.

Nazwa Typ Opis
routes

VirtualHubRoute[]

Lista wszystkich tras.

VirtualHubRouteTableV2

Zasób VirtualHubRouteTableV2.

Nazwa Typ Opis
etag

string

Unikatowy ciąg tylko do odczytu, który zmienia się za każdym razem, gdy zasób jest aktualizowany.

id

string

Identyfikator zasobu.

name

string

Nazwa zasobu, który jest unikatowy w grupie zasobów. Ta nazwa może służyć do uzyskiwania dostępu do zasobu.

properties.attachedConnections

string[]

Lista wszystkich połączeń dołączonych do tej tabeli tras w wersji 2.

properties.provisioningState

ProvisioningState

Stan aprowizacji zasobu tabeli tras koncentratora wirtualnego w wersji 2.

properties.routes

VirtualHubRouteV2[]

Lista wszystkich tras.

VirtualHubRouteV2

Trasa VirtualHubRouteTableV2.

Nazwa Typ Opis
destinationType

string

Typ miejsc docelowych.

destinations

string[]

Lista wszystkich miejsc docelowych.

nextHopType

string

Typ następnego przeskoku.

nextHops

string[]

NextHops adres IP.

VirtualRouterAutoScaleConfiguration

Konfiguracja automatycznego skalowania routera usługi VirtualHub.

Nazwa Typ Opis
minCapacity

integer

Minimalna liczba jednostek skalowania dla routera usługi VirtualHub.