Virtual Network Links - List

Usługa:

DNS

Wersja interfejsu API:

2018-09-01

Wyświetla listę łączy sieci wirtualnej z określoną prywatną strefą DNS.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateZoneName}/virtualNetworkLinks?api-version=2018-09-01

Z parametrami opcjonalnymi:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateZoneName}/virtualNetworkLinks?$top={$top}&api-version=2018-09-01

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
privateZoneName	path	True	string	Nazwa prywatnej strefy DNS (bez kropki zakończenia).
resourceGroupName	path	True	string	Nazwa grupy zasobów.
subscriptionId	path	True	string	Pobiera 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.
$top	query		integer (int32)	Maksymalna liczba linków sieci wirtualnej do zwrócenia. Jeśli nie zostanie określony, zwraca maksymalnie 100 łączy sieci wirtualnej.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	VirtualNetworkLinkListResult	Sukces.
Other Status Codes	CloudError	Odpowiedź domyślna. Zostanie on zdeserializowany zgodnie z definicją Błędu.

Przykłady

Get Private DNS Zone Virtual Network Links

Przykładowe żądanie

HTTP

GET https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/virtualNetworkLinks?api-version=2018-09-01

Przykładowa odpowiedź

Kod stanu:

200

{
  "nextLink": "https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/virtualNetworkLinks?api-version=2018-09-01&$skipToken=skipToken",
  "value": [
    {
      "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/virtualNetworkLinks/virtualNetworkLink1",
      "name": "virtualNetworkLink1",
      "type": "Microsoft.Network/privateDnsZones/virtualNetworkLinks",
      "location": "global",
      "etag": "00000000-0000-0000-0000-000000000000",
      "properties": {
        "virtualNetwork": {
          "id": "/subscriptions/virtualNetworkSubscriptionId/resourceGroups/virtualNetworkResourceGroup/providers/Microsoft.Network/virtualNetworks/virtualNetworkName"
        },
        "registrationEnabled": false,
        "virtualNetworkLinkState": "Completed",
        "provisioningState": "Succeeded"
      },
      "tags": {
        "key1": "value1"
      }
    },
    {
      "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/virtualNetworkLinks/virtualNetworkLink2",
      "name": "virtualNetworkLink2",
      "type": "Microsoft.Network/privateDnsZones/virtualNetworkLinks",
      "location": "global",
      "etag": "00000000-0000-0000-0000-000000000000",
      "properties": {
        "virtualNetwork": {
          "id": "/subscriptions/virtualNetworkSubscriptionId/resourceGroups/virtualNetworkResourceGroup/providers/Microsoft.Network/virtualNetworks/virtualNetworkName"
        },
        "registrationEnabled": true,
        "virtualNetworkLinkState": "InProgress",
        "provisioningState": "Succeeded"
      }
    }
  ]
}

Definicje

Nazwa	Opis
CloudError	Odpowiedź na błąd z usługi.
CloudErrorBody	Odpowiedź na błąd z usługi.
ProvisioningState	Stan aprowizacji zasobu. Jest to właściwość tylko do odczytu, a każda próba ustawienia tej wartości zostanie zignorowana.
SubResource	Odwołanie do innego podźródła.
VirtualNetworkLink	Opisuje link do sieci wirtualnej dla prywatnej strefy DNS.
VirtualNetworkLinkListResult	Odpowiedź na listę połączenia sieci wirtualnej z operacją prywatnej strefy DNS.
VirtualNetworkLinkState	Stan połączenia sieci wirtualnej z prywatną strefą DNS. Możliwe wartości to "InProgress" i "Done". Jest to właściwość tylko do odczytu, a każda próba ustawienia tej wartości zostanie zignorowana.

CloudError

Objekt

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

Nazwa	Typ	Opis
error	CloudErrorBody	Treść błędu chmury.

CloudErrorBody

Objekt

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.

ProvisioningState

Wyliczanie

Stan aprowizacji zasobu. Jest to właściwość tylko do odczytu, a każda próba ustawienia tej wartości zostanie zignorowana.

Wartość	Opis
Canceled
Creating
Deleting
Failed
Succeeded
Updating

SubResource

Objekt

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

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.

VirtualNetworkLink

Objekt

Opisuje link do sieci wirtualnej dla prywatnej strefy DNS.

Nazwa	Typ	Opis
etag	string	Element ETag linku sieci wirtualnej.
id	string	W pełni kwalifikowany identyfikator zasobu dla zasobu. Przykład — "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateDnsZoneName}".
location	string	Region świadczenia usługi Azure, w którym znajduje się zasób
name	string	Nazwa zasobu
properties.provisioningState	ProvisioningState	Stan aprowizacji zasobu. Jest to właściwość tylko do odczytu, a każda próba ustawienia tej wartości zostanie zignorowana.
properties.registrationEnabled	boolean	Czy włączono automatyczną rejestrację rekordów maszyn wirtualnych w sieci wirtualnej w prywatnej strefie DNS?
properties.virtualNetwork	SubResource	Odwołanie do sieci wirtualnej.
properties.virtualNetworkLinkState	VirtualNetworkLinkState	Stan połączenia sieci wirtualnej z prywatną strefą DNS. Możliwe wartości to "InProgress" i "Done". Jest to właściwość tylko do odczytu, a każda próba ustawienia tej wartości zostanie zignorowana.
tags	object	Tagi zasobów.
type	string	Typ zasobu. Przykład — "Microsoft.Network/privateDnsZones".

VirtualNetworkLinkListResult

Objekt

Odpowiedź na listę połączenia sieci wirtualnej z operacją prywatnej strefy DNS.

Nazwa	Typ	Opis
nextLink	string	Token kontynuacji dla następnej strony wyników.
value	VirtualNetworkLink[]	Informacje o łączach sieci wirtualnej do prywatnych stref DNS.

VirtualNetworkLinkState

Wyliczanie

Stan połączenia sieci wirtualnej z prywatną strefą DNS. Możliwe wartości to "InProgress" i "Done". Jest to właściwość tylko do odczytu, a każda próba ustawienia tej wartości zostanie zignorowana.

Wartość	Opis
Completed
InProgress