Bastion Hosts - Create Or Update

Hiermee wordt de opgegeven Bastion-host gemaakt of bijgewerkt.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/bastionHosts/{bastionHostName}?api-version=2023-09-01

URI-parameters

Name In Vereist Type Description
bastionHostName
path True

string

De naam van de Bastion-host.

resourceGroupName
path True

string

De naam van de resourcegroep.

subscriptionId
path True

string

De abonnementsreferenties waarmee het Microsoft Azure-abonnement uniek wordt geïdentificeerd. De abonnements-id maakt deel uit van de URI voor elke service-aanroep.

api-version
query True

string

Client-API-versie.

Aanvraagbody

Name Type Description
id

string

Resource-id.

location

string

Resourcelocatie.

properties.disableCopyPaste

boolean

De functie Kopiëren/plakken van de Bastion-hostresource in-/uitschakelen.

properties.dnsName

string

FQDN voor het eindpunt waarop de bastionhost toegankelijk is.

properties.enableFileCopy

boolean

De functie Bestandskopie van de Bastion Host-resource in-/uitschakelen.

properties.enableIpConnect

boolean

De functie IP Connect van de Bastion Host-resource in-/uitschakelen.

properties.enableKerberos

boolean

Kerberos-functie van de Bastion Host-resource in-/uitschakelen.

properties.enableShareableLink

boolean

Deelbare koppeling van de Bastion Host-resource in-/uitschakelen.

properties.enableTunneling

boolean

De functie Tunneling van de Bastion Host-resource in-/uitschakelen.

properties.ipConfigurations

BastionHostIPConfiguration[]

IP-configuratie van de Bastion Host-resource.

properties.networkAcls

NetworkAcls

properties.scaleUnits

integer

De schaaleenheden voor de Bastion Host-resource.

properties.virtualNetwork

SubResource

Verwijzing naar een bestaand virtueel netwerk dat alleen is vereist voor Developer Bastion Host.

sku

Sku

De SKU van deze Bastion-host.

tags

object

Resourcetags.

zones

string[]

Een lijst met beschikbaarheidszones die aangeeft waar de resource vandaan moet komen.

Antwoorden

Name Type Description
200 OK

BastionHost

De update is voltooid. De bewerking retourneert de resulterende Bastion Host-resource.

201 Created

BastionHost

Maken is voltooid. De bewerking retourneert de resulterende Bastion Host-resource.

Other Status Codes

CloudError

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

Create Bastion Host
Create Bastion Host With Zones
Create Developer Bastion Host

Create Bastion Host

Sample Request

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/bastionHosts/bastionhosttenant?api-version=2023-09-01

{
  "properties": {
    "ipConfigurations": [
      {
        "name": "bastionHostIpConfiguration",
        "properties": {
          "subnet": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnet2/subnets/BastionHostSubnet"
          },
          "publicIPAddress": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/pipName"
          }
        }
      }
    ]
  }
}

Sample Response

{
  "name": "bastionhost",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/bastionHosts/bastionhosttenant'",
  "type": "Microsoft.Network/bastionHosts",
  "etag": "w/\\00000000-0000-0000-0000-000000000000\\",
  "location": "West US",
  "sku": {
    "name": "Standard"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "dnsName": "bst-9d89d361-100e-4c01-b92d-466548c476dc.bastion.azure.com",
    "scaleUnits": 2,
    "disableCopyPaste": false,
    "enableTunneling": false,
    "enableIpConnect": false,
    "enableShareableLink": false,
    "enableKerberos": false,
    "ipConfigurations": [
      {
        "name": "bastionHostIpConfiguration",
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/bastionHosts/bastionhosttenant/bastionHostIpConfigurations/bastionHostIpConfiguration",
        "etag": "w/\\00000000-0000-0000-0000-000000000000\\",
        "type": "Microsoft.Network/bastionHosts/bastionHostIpConfigurations",
        "properties": {
          "provisioningState": "Succeeded",
          "privateIPAllocationMethod": "Dynamic",
          "subnet": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnet2/subnets/BastionHostSubnet"
          },
          "publicIPAddress": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/pipName"
          }
        }
      }
    ]
  }
}
{
  "name": "bastionhost'",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/bastionHosts/bastionhosttenant'",
  "type": "Microsoft.Network/bastionHosts",
  "etag": "w/\\00000000-0000-0000-0000-000000000000\\",
  "location": "West US",
  "sku": {
    "name": "Standard"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "dnsName": "bst-9d89d361-100e-4c01-b92d-466548c476dc.bastion.azure.com",
    "scaleUnits": 2,
    "disableCopyPaste": false,
    "enableTunneling": false,
    "enableIpConnect": false,
    "enableShareableLink": false,
    "enableKerberos": false,
    "ipConfigurations": [
      {
        "name": "bastionHostIpConfiguration",
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/bastionHosts/bastionhosttenant/bastionHostIpConfigurations/bastionHostIpConfiguration",
        "etag": "w/\\00000000-0000-0000-0000-000000000000\\",
        "type": "Microsoft.Network/bastionHosts/bastionHostIpConfigurations",
        "properties": {
          "provisioningState": "Succeeded",
          "privateIPAllocationMethod": "Dynamic",
          "subnet": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnet2/subnets/BastionHostSubnet"
          },
          "publicIPAddress": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/pipName"
          }
        }
      }
    ]
  }
}

Create Bastion Host With Zones

Sample Request

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/bastionHosts/bastionhosttenant?api-version=2023-09-01

{
  "properties": {
    "ipConfigurations": [
      {
        "name": "bastionHostIpConfiguration",
        "properties": {
          "subnet": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnet2/subnets/BastionHostSubnet"
          },
          "publicIPAddress": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/pipName"
          }
        }
      }
    ]
  }
}

Sample Response

{
  "name": "bastionhost",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/bastionHosts/bastionhosttenant'",
  "type": "Microsoft.Network/bastionHosts",
  "etag": "w/\\00000000-0000-0000-0000-000000000000\\",
  "location": "West US",
  "sku": {
    "name": "Standard"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "dnsName": "bst-9d89d361-100e-4c01-b92d-466548c476dc.bastion.azure.com",
    "scaleUnits": 2,
    "disableCopyPaste": false,
    "enableTunneling": false,
    "enableIpConnect": false,
    "enableShareableLink": false,
    "enableKerberos": false,
    "ipConfigurations": [
      {
        "name": "bastionHostIpConfiguration",
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/bastionHosts/bastionhosttenant/bastionHostIpConfigurations/bastionHostIpConfiguration",
        "etag": "w/\\00000000-0000-0000-0000-000000000000\\",
        "type": "Microsoft.Network/bastionHosts/bastionHostIpConfigurations",
        "properties": {
          "provisioningState": "Succeeded",
          "privateIPAllocationMethod": "Dynamic",
          "subnet": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnet2/subnets/BastionHostSubnet"
          },
          "publicIPAddress": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/pipName"
          }
        }
      }
    ]
  }
}
{
  "name": "bastionhost'",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/bastionHosts/bastionhosttenant'",
  "type": "Microsoft.Network/bastionHosts",
  "etag": "w/\\00000000-0000-0000-0000-000000000000\\",
  "location": "West US",
  "sku": {
    "name": "Standard"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "dnsName": "bst-9d89d361-100e-4c01-b92d-466548c476dc.bastion.azure.com",
    "scaleUnits": 2,
    "disableCopyPaste": false,
    "enableTunneling": false,
    "enableIpConnect": false,
    "enableShareableLink": false,
    "enableKerberos": false,
    "ipConfigurations": [
      {
        "name": "bastionHostIpConfiguration",
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/bastionHosts/bastionhosttenant/bastionHostIpConfigurations/bastionHostIpConfiguration",
        "etag": "w/\\00000000-0000-0000-0000-000000000000\\",
        "type": "Microsoft.Network/bastionHosts/bastionHostIpConfigurations",
        "properties": {
          "provisioningState": "Succeeded",
          "privateIPAllocationMethod": "Dynamic",
          "subnet": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnet2/subnets/BastionHostSubnet"
          },
          "publicIPAddress": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/pipName"
          }
        }
      }
    ]
  }
}

Create Developer Bastion Host

Sample Request

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg2/providers/Microsoft.Network/bastionHosts/bastionhostdeveloper?api-version=2023-09-01

{
  "properties": {
    "virtualNetwork": {
      "id": "/subscriptions/subid/resourceGroups/rg2/providers/Microsoft.Network/virtualNetworks/vnet2"
    },
    "networkAcls": {
      "ipRules": [
        {
          "addressPrefix": "1.1.1.1/16"
        }
      ]
    },
    "ipConfigurations": []
  }
}

Sample Response

{
  "name": "bastionhostdeveloper",
  "id": "/subscriptions/subid/resourceGroups/rg2/providers/Microsoft.Network/bastionHosts/bastionhostdeveloper'",
  "type": "Microsoft.Network/bastionHosts",
  "etag": "w/\\00000000-0000-0000-0000-000000000000\\",
  "location": "West US",
  "sku": {
    "name": "Developer"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "dnsName": "omnibrain.uswest.bastionglobal.azure.com",
    "virtualNetwork": {
      "id": "/subscriptions/subid/resourceGroups/rg2/providers/Microsoft.Network/virtualNetworks/vnet2"
    },
    "networkAcls": {
      "ipRules": [
        {
          "addressPrefix": "1.1.1.1/16"
        }
      ]
    },
    "ipConfigurations": []
  }
}
{
  "name": "bastionhostdeveloper'",
  "id": "/subscriptions/subid/resourceGroups/rg2/providers/Microsoft.Network/bastionHosts/bastionhostdeveloper'",
  "type": "Microsoft.Network/bastionHosts",
  "etag": "w/\\00000000-0000-0000-0000-000000000000\\",
  "location": "West US",
  "sku": {
    "name": "Developer"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "dnsName": "omnibrain.uswest.bastionglobal.azure.com",
    "virtualNetwork": {
      "id": "/subscriptions/subid/resourceGroups/rg2/providers/Microsoft.Network/virtualNetworks/vnet2"
    },
    "networkAcls": {
      "ipRules": [
        {
          "addressPrefix": "1.1.1.1/16"
        }
      ]
    },
    "ipConfigurations": []
  }
}

Definities

Name Description
BastionHost

Bastion Host-resource.

BastionHostIPConfiguration

IP-configuratie van een Bastion-host.

BastionHostSkuName

De naam van deze Bastion-host.

CloudError

Een foutreactie van de service.

CloudErrorBody

Een foutreactie van de service.

IPAllocationMethod

Methode voor ip-adrestoewijzing.

IPRule
NetworkAcls
ProvisioningState

De huidige inrichtingsstatus.

Sku

De SKU van deze Bastion-host.

SubResource

Verwijzing naar een andere subbron.

BastionHost

Bastion Host-resource.

Name Type Standaardwaarde Description
etag

string

Een unieke alleen-lezen tekenreeks die wordt gewijzigd wanneer de resource wordt bijgewerkt.

id

string

Resource-id.

location

string

Resourcelocatie.

name

string

Resourcenaam.

properties.disableCopyPaste

boolean

False

De functie Kopiëren/plakken van de Bastion-hostresource in-/uitschakelen.

properties.dnsName

string

FQDN voor het eindpunt waarop de bastionhost toegankelijk is.

properties.enableFileCopy

boolean

False

De functie Bestandskopie van de Bastion Host-resource in-/uitschakelen.

properties.enableIpConnect

boolean

False

De functie IP Connect van de Bastion Host-resource in-/uitschakelen.

properties.enableKerberos

boolean

False

Kerberos-functie van de Bastion Host-resource in-/uitschakelen.

properties.enableShareableLink

boolean

False

Deelbare koppeling van de Bastion Host-resource in-/uitschakelen.

properties.enableTunneling

boolean

False

De functie Tunneling van de Bastion Host-resource in-/uitschakelen.

properties.ipConfigurations

BastionHostIPConfiguration[]

IP-configuratie van de Bastion Host-resource.

properties.networkAcls

NetworkAcls

properties.provisioningState

ProvisioningState

De inrichtingsstatus van de bastionhostresource.

properties.scaleUnits

integer

De schaaleenheden voor de Bastion Host-resource.

properties.virtualNetwork

SubResource

Verwijzing naar een bestaand virtueel netwerk dat alleen is vereist voor Developer Bastion Host.

sku

Sku

De SKU van deze Bastion-host.

tags

object

Resourcetags.

type

string

Resourcetype.

zones

string[]

Een lijst met beschikbaarheidszones die aangeeft waar de resource vandaan moet komen.

BastionHostIPConfiguration

IP-configuratie van een Bastion-host.

Name Type Description
etag

string

Een unieke alleen-lezen tekenreeks die wordt gewijzigd wanneer de resource wordt bijgewerkt.

id

string

Resource-id.

name

string

Naam van de resource die uniek is binnen een resourcegroep. Deze naam kan worden gebruikt voor toegang tot de resource.

properties.privateIPAllocationMethod

IPAllocationMethod

Methode voor privé-IP-toewijzing.

properties.provisioningState

ProvisioningState

De inrichtingsstatus van de IP-configuratieresource van de bastionhost.

properties.publicIPAddress

SubResource

Referentie van de PublicIP-resource.

properties.subnet

SubResource

Verwijzing naar de subnetresource.

type

string

IP-configuratietype.

BastionHostSkuName

De naam van deze Bastion-host.

Name Type Description
Basic

string

Developer

string

Standard

string

CloudError

Een foutreactie van de service.

Name Type Description
error

CloudErrorBody

Hoofdtekst van cloudfout.

CloudErrorBody

Een foutreactie van de service.

Name Type Description
code

string

Een id voor de fout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt.

details

CloudErrorBody[]

Een lijst met aanvullende informatie over de fout.

message

string

Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface.

target

string

Het doel van de specifieke fout. Bijvoorbeeld de naam van de eigenschap fout.

IPAllocationMethod

Methode voor ip-adrestoewijzing.

Name Type Description
Dynamic

string

Static

string

IPRule

Name Type Description
addressPrefix

string

Hiermee geeft u het IP-adres of IP-bereik in CIDR-indeling. Alleen IPV4-adres is toegestaan.

NetworkAcls

Name Type Description
ipRules

IPRule[]

Hiermee stelt u de IP-ACL-regels voor Developer Bastion Host.

ProvisioningState

De huidige inrichtingsstatus.

Name Type Description
Deleting

string

Failed

string

Succeeded

string

Updating

string

Sku

De SKU van deze Bastion-host.

Name Type Standaardwaarde Description
name

BastionHostSkuName

Standard

De naam van deze Bastion-host.

SubResource

Verwijzing naar een andere subbron.

Name Type Description
id

string

Resource-id.