Gateways - Create Gateway

Service:

Core

API-versie:

v1

Notitie

Deze API is in preview.

Hiermee maakt u een gateway.

Vereiste gedelegeerde bereiken

Gateway.ReadWrite.All

Door Microsoft Entra ondersteunde identiteiten

Deze API ondersteunt de Microsoft -identiteiten vermeld in deze sectie.

Identiteit	Steunen
Gebruiker	Ja
service-principal en beheerde identiteiten	Ja

Interface

POST https://api.fabric.microsoft.com/v1/gateways

Aanvraagbody

CreateVirtualNetworkGatewayRequest

Name	Vereist	Type	Description
capacityId	True	string uuid	De object-id van de fabric-licentiecapaciteit.
displayName	True	string	De weergavenaam van de gateway van het virtuele netwerk. De maximale lengte is 200 tekens.
inactivityMinutesBeforeSleep	True	integer	De minuten van inactiviteit voordat de gateway van het virtuele netwerk in de automatische slaapstand wordt gezet. Moet een van de volgende waarden zijn: 30, 60, 90, 120, 150, 240, 360, 480, 720, 1440.
numberOfMemberGateways	True	integer	Het aantal lidgateways. Een getal tussen 1 en 7.
type	True	string: VirtualNetwork	Het type gateway.
virtualNetworkAzureResource	True	VirtualNetworkAzureResource	De virtuele Azure-netwerkresource.

Antwoorden

Name	Type	Description
201 Created	Gateway: OnPremisesGateway OnPremisesGatewayPersonal VirtualNetworkGateway	Geschapen. De bewerking is geslaagd.
Other Status Codes	ErrorResponse	Veelvoorkomende foutcodes: DuplicateGatewayName: de naam van de gateway is al in gebruik. InvalidCapacityState: de status van de capaciteit is ongeldig. InvalidCapacitySKU: de SKU van de capaciteit is ongeldig. PowerPlatformVirtualNetworkSubnetNotConfiguredForDelegation : het virtuele Power Platform-netwerk is niet geconfigureerd voor delegatie.

Voorbeelden

Virtual network gateway example

Voorbeeldaanvraag

HTTP

POST https://api.fabric.microsoft.com/v1/gateways

{
  "type": "VirtualNetwork",
  "displayName": "ContosoVirtualNetworkGateway",
  "capacityId": "ed26b6f3-7bc5-44b0-9565-a8942619ef4c",
  "virtualNetworkAzureResource": {
    "subscriptionId": "879b4ba0-ed17-4ff2-851e-4a2228e00b70",
    "resourceGroupName": "ContosoResourceGroup",
    "virtualNetworkName": "ContosoVirtualNetwork",
    "subnetName": "ContosoSubnet"
  },
  "inactivityMinutesBeforeSleep": 120,
  "numberOfMemberGateways": 3
}

Voorbeeldrespons

Statuscode:

200

{
  "id": "271c5c9a-0860-4927-b1da-ce49008d6565",
  "type": "VirtualNetwork",
  "displayName": "ContosoVirtualNetworkGateway",
  "capacityId": "ed26b6f3-7bc5-44b0-9565-a8942619ef4c",
  "virtualNetworkAzureResource": {
    "subscriptionId": "879b4ba0-ed17-4ff2-851e-4a2228e00b70",
    "resourceGroupName": "ContosoResourceGroup",
    "virtualNetworkName": "ContosoVirtualNetwork",
    "subnetName": "ContosoSubnet"
  },
  "inactivityMinutesBeforeSleep": 120,
  "numberOfMemberGateways": 3
}

Definities

Name	Description
CreateVirtualNetworkGatewayRequest
ErrorRelatedResource	Het foutgerelateerde resourcedetailsobject.
ErrorResponse	Het foutbericht.
ErrorResponseDetails	De details van het foutbericht.
GatewayType	Het type gateway. Er kunnen in de loop van de tijd extra gatewaytypen worden toegevoegd.
LoadBalancingSetting	De taakverdelingsinstelling van het gatewaycluster. Er kunnen na verloop van tijd extra taakverdelingsinstellingen worden toegevoegd.
OnPremisesGateway
OnPremisesGatewayPersonal
PublicKey	De openbare sleutel van de on-premises gateway.
VirtualNetworkAzureResource	De eigenschappen van een Azure-resource voor een virtueel netwerk
VirtualNetworkGateway

CreateVirtualNetworkGatewayRequest

Object

Name	Type	Description
capacityId	string uuid	De object-id van de fabric-licentiecapaciteit.
displayName	string	De weergavenaam van de gateway van het virtuele netwerk. De maximale lengte is 200 tekens.
inactivityMinutesBeforeSleep	integer	De minuten van inactiviteit voordat de gateway van het virtuele netwerk in de automatische slaapstand wordt gezet. Moet een van de volgende waarden zijn: 30, 60, 90, 120, 150, 240, 360, 480, 720, 1440.
numberOfMemberGateways	integer	Het aantal lidgateways. Een getal tussen 1 en 7.
type	string: VirtualNetwork	Het type gateway.
virtualNetworkAzureResource	VirtualNetworkAzureResource	De virtuele Azure-netwerkresource.

ErrorRelatedResource

Object

Het foutgerelateerde resourcedetailsobject.

Name	Type	Description
resourceId	string	De resource-id die betrokken is bij de fout.
resourceType	string	Het type resource dat betrokken is bij de fout.

ErrorResponse

Object

Het foutbericht.

Name	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message	string	Een leesbare weergave van de fout.
moreDetails	ErrorResponseDetails[]	Lijst met aanvullende foutdetails.
relatedResource	ErrorRelatedResource	De foutgerelateerde resourcedetails.
requestId	string	Id van de aanvraag die is gekoppeld aan de fout.

ErrorResponseDetails

Object

De details van het foutbericht.

Name	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message	string	Een leesbare weergave van de fout.
relatedResource	ErrorRelatedResource	De foutgerelateerde resourcedetails.

GatewayType

Inventarisatie

Het type gateway. Er kunnen in de loop van de tijd extra gatewaytypen worden toegevoegd.

Waarde	Description
OnPremises	De on-premises gateway.
OnPremisesPersonal	De on-premises gateway (persoonlijke modus).
VirtualNetwork	De gateway van het virtuele netwerk.

LoadBalancingSetting

Inventarisatie

De taakverdelingsinstelling van het gatewaycluster. Er kunnen na verloop van tijd extra taakverdelingsinstellingen worden toegevoegd.

Waarde	Description
DistributeEvenly	Aanvragen worden gelijkmatig verdeeld over alle ingeschakelde gatewayclusterleden.
Failover	Aanvragen worden verzonden naar het eerste beschikbare gatewayclusterlid.

OnPremisesGateway

Object

Name	Type	Description
allowCloudConnectionRefresh	boolean	Of cloudverbindingen via deze on-premises gateway moeten worden vernieuwd. True - Toestaan, Onwaar - Niet toestaan.
allowCustomConnectors	boolean	Of aangepaste connectors mogen worden gebruikt met deze on-premises gateway. True - Toestaan, Onwaar - Niet toestaan.
displayName	string	De weergavenaam van de on-premises gateway.
id	string uuid	De object-id van de gateway.
loadBalancingSetting	LoadBalancingSetting	De taakverdelingsinstelling van de on-premises gateway.
numberOfMemberGateways	integer	Het aantal gatewayleden in de on-premises gateway.
publicKey	PublicKey	De openbare sleutel van het primaire gatewaylid. Wordt gebruikt voor het versleutelen van de referenties voor het maken en bijwerken van verbindingen.
type	string: OnPremises	Het type gateway.
version	string	De versie van het geïnstalleerde primaire gatewaylid.

OnPremisesGatewayPersonal

Object

Name	Type	Description
id	string uuid	De object-id van de gateway.
publicKey	PublicKey	De openbare sleutel van de gateway. Wordt gebruikt voor het versleutelen van de referenties voor het maken en bijwerken van verbindingen.
type	string: OnPremisesPersonal	Het type gateway.
version	string	De versie van de gateway.

PublicKey

Object

De openbare sleutel van de on-premises gateway.

Name	Type	Description
exponent	string	De exponent van de openbare sleutel.
modulus	string	De modulus van de openbare sleutel.

VirtualNetworkAzureResource

Object

De eigenschappen van een Azure-resource voor een virtueel netwerk

Name	Type	Description
resourceGroupName	string	De naam van de resourcegroep
subnetName	string	De naam van het subnet
subscriptionId	string uuid	De abonnements-id
virtualNetworkName	string	De naam van het virtuele netwerk

VirtualNetworkGateway

Object

Name	Type	Description
capacityId	string uuid	De object-id van de fabric-licentiecapaciteit.
displayName	string	De weergavenaam van de gateway van het virtuele netwerk.
id	string uuid	De object-id van de gateway.
inactivityMinutesBeforeSleep	integer	De minuten van inactiviteit voordat de gateway van het virtuele netwerk in de automatische slaapstand wordt gezet.
numberOfMemberGateways	integer	Het aantal lidgateways.
type	string: VirtualNetwork	Het type gateway.
virtualNetworkAzureResource	VirtualNetworkAzureResource	De virtuele Azure-netwerkresource.