Nsp Links - List

Referens

Tjänst:: Network Manager

API-version:: 2023-07-01-preview

Visar NSP Link-resurserna i den angivna nätverkssäkerhetsperimetern.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkSecurityPerimeters/{networkSecurityPerimeterName}/links?api-version=2023-07-01-preview

Med valfria parametrar:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkSecurityPerimeters/{networkSecurityPerimeterName}/links?api-version=2023-07-01-preview&$top={$top}&$skipToken={$skipToken}

URI-parametrar

Name	I	Obligatorisk	Typ	Description
networkSecurityPerimeterName	path	True	string	Namnet på nätverkssäkerhetsperimetern.
resourceGroupName	path	True	string	Namnet på resursgruppen.
subscriptionId	path	True	string	Autentiseringsuppgifterna för prenumerationen som unikt identifierar Microsoft Azure-prenumerationen. Prenumerations-ID:t utgör en del av URI:n för varje tjänstanrop.
api-version	query	True	string	Klient-API-version.
$skipToken	query		string	SkipToken används endast om en tidigare åtgärd returnerade ett partiellt resultat. Om ett tidigare svar innehåller ett nextLink-element innehåller värdet för nextLink-elementet en skipToken-parameter som anger en startpunkt som ska användas för efterföljande anrop.
$top	query		integer (int32) minimum: 1 maximum: 20	En valfri frågeparameter som anger det maximala antalet poster som ska returneras av servern.

Svar

Name	Typ	Description
200 OK	NspLinkListResult	OK – Returnerar listan över NSP-länkresurser.
Other Status Codes	CloudError	Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

NspLinkList

Exempelbegäran

HTTP

GET https://management.azure.com/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityPerimeters/nsp1/links?api-version=2023-07-01-preview

Exempelsvar

Statuskod:: 200

{
  "value": [
    {
      "name": "link1",
      "id": "/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityPerimeters/nsp1/links/link1",
      "type": "Microsoft.Network/networkSecurityPerimeters/links",
      "properties": {
        "provisioningState": "Succeeded",
        "autoApprovedRemotePerimeterResourceId": "/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityPerimeters/nsp2",
        "remotePerimeterGuid": "guid",
        "remotePerimeterLocation": "westus2",
        "localInboundProfiles": [
          "*"
        ],
        "localOutboundProfiles": [
          "*"
        ],
        "remoteInboundProfiles": [
          "*"
        ],
        "remoteOutboundProfiles": [
          "*"
        ],
        "description": "Auto Approved",
        "status": "Approved"
      }
    }
  ],
  "nextLink": "{baseurl}/subscriptions/subId/resourceGroup/rg1/providers/Microsoft.Network/networkSecurityPerimeters/nsp1/links?api-version=2023-07-01-preview&$skipToken=10"
}

Definitioner

Name	Description
CloudError	Ett felsvar från tjänsten.
CloudErrorBody	Ett felsvar från tjänsten.
NspLink	Nätverkssäkerhetslänkresursen
NspLinkListResult	Resultatet av begäran om att visa NSP-länkresurser. Innehåller en lista över NSP-länkresurser och en URL-länk för att hämta nästa uppsättning resultat.
nspLinkProvisioningState	Etableringstillståndet för NSP Link-resursen.
nspLinkStatus	NSP-länktillståndet.

CloudError

Objekt

Ett felsvar från tjänsten.

Name	Typ	Description
error	CloudErrorBody	Molnfeltext.

CloudErrorBody

Objekt

Ett felsvar från tjänsten.

Name	Typ	Description
code	string	En identifierare för felet. Koder är invarianta och är avsedda att användas programmatiskt.
details	CloudErrorBody[]	En lista med ytterligare information om felet.
message	string	Ett meddelande som beskriver felet, avsett att vara lämpligt för visning i ett användargränssnitt.
target	string	Målet för det specifika felet. Till exempel namnet på egenskapen i fel.

NspLink

Objekt

Nätverkssäkerhetslänkresursen

Name	Typ	Description
etag	string	En unik skrivskyddad sträng som ändras när resursen uppdateras.
id	string	Resurs-ID.
name	string	Resursnamn.
properties.autoApprovedRemotePerimeterResourceId	string	Perimeter-ARM-ID för den fjärranslutna NSP som länken skapas med i läget För automatiskt godkännande. Den bör användas när NSP-administratören har behörigheten Microsoft.Network/networkSecurityPerimeters/linkPerimeter/action på den fjärranslutna NSP-resursen.
properties.description	string	Ett meddelande som skickas till ägaren av den fjärranslutna NSP-länkresursen med den här anslutningsbegäran. Om flödet godkänns automatiskt är det standardvärdet "Automatiskt godkänt". Begränsad till 140 tecken.
properties.localInboundProfiles	string[]	Lokala inkommande profilnamn som Inkommande tillåts till. Använd ['*'] för att tillåta inkommande trafik till alla profiler.
properties.localOutboundProfiles	string[]	Lokala utgående profilnamn som Utgående tillåts från. I den aktuella versionen är den skrivskyddad egenskap och dess värde är inställt på ['*'] för att tillåta utgående trafik från alla profiler. I senare version kan användaren ändra den.
properties.provisioningState	nspLinkProvisioningState	Etableringstillståndet för NSP Link-resursen.
properties.remoteInboundProfiles	string[]	Fjärrnamn för inkommande profiler som Inkommande tillåts till. Använd ['*'] för att tillåta inkommande trafik till alla profiler. Den här egenskapen kan bara uppdateras i läget för automatiskt godkännande.
properties.remoteOutboundProfiles	string[]	Fjärrnamn för utgående profil som Utgående tillåts från. I den aktuella versionen är den skrivskyddad egenskap och dess värde är inställt på ['*'] för att tillåta utgående trafik från alla profiler. I senare version kan användaren ändra den.
properties.remotePerimeterGuid	string	Fjärr-NSP Guid som länken skapas med.
properties.remotePerimeterLocation	string	Fjärr-NSP-plats som länken skapas med.
properties.status	nspLinkStatus	NSP-länktillståndet.
type	string	Resurstyp.

NspLinkListResult

Objekt

Resultatet av begäran om att visa NSP-länkresurser. Innehåller en lista över NSP-länkresurser och en URL-länk för att hämta nästa uppsättning resultat.

Name	Typ	Description
nextLink	string	Hämtar URL:en för att hämta nästa sida med resultat.
value	NspLink[]	Hämtar en sida med NSP Link-resurser.

nspLinkProvisioningState

Uppräkning

Etableringstillståndet för NSP Link-resursen.

Värde	Description
Accepted
Creating
Deleting
Failed
Succeeded
Updating
WaitForRemoteCompletion

nspLinkStatus

Uppräkning

NSP-länktillståndet.

Värde	Description
Approved
Disconnected
Pending
Rejected

Dela via

Nsp Links - List

URI-parametrar

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

NspLinkList

Exempelbegäran

Exempelsvar

Definitioner

CloudError

CloudErrorBody

NspLink

NspLinkListResult

nspLinkProvisioningState

nspLinkStatus