Bastion Hosts - Create Or Update

Létrehozza vagy frissíti a megadott Bastion-gazdagépet.

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

URI-paraméterek

Name In Kötelező Típus Description
bastionHostName
path True

string

A Bastion-gazdagép neve.

resourceGroupName
path True

string

Az erőforráscsoport neve.

subscriptionId
path True

string

Az előfizetés hitelesítő adatai, amelyek egyedileg azonosítják a Microsoft Azure-előfizetést. Az előfizetés-azonosító az URI részét képezi minden szolgáltatáshíváshoz.

api-version
query True

string

Ügyfél API-verziója.

Kérelem törzse

Name Típus Description
id

string

Erőforrás-azonosító.

location

string

Erőforrás helye.

properties.disableCopyPaste

boolean

A Bastion-gazdagép erőforrás másolási/beillesztési funkciójának engedélyezése/letiltása.

properties.dnsName

string

A végpont teljes tartományneve, amelyen a megerősített gazdagép elérhető.

properties.enableFileCopy

boolean

A Bastion-gazdagép erőforrás fájlmásolási funkciójának engedélyezése/letiltása.

properties.enableIpConnect

boolean

A Bastion-gazdagép erőforrás IP Connect-funkciójának engedélyezése/letiltása.

properties.enableKerberos

boolean

A Bastion-gazdagép erőforrás Kerberos-funkciójának engedélyezése/letiltása.

properties.enableShareableLink

boolean

A Bastion-gazdagép erőforrás megosztható hivatkozásának engedélyezése/letiltása.

properties.enableTunneling

boolean

A Bastion-gazdagép erőforrás bújtatási funkciójának engedélyezése/letiltása.

properties.ipConfigurations

BastionHostIPConfiguration[]

A Bastion-gazdagép-erőforrás IP-konfigurációja.

properties.networkAcls

NetworkAcls

properties.scaleUnits

integer

A Bastion-gazdagép erőforrás méretezési egységei.

properties.virtualNetwork

SubResource

Hivatkozás egy meglévő virtuális hálózatra, amely csak a Developer Bastion-gazdagéphez szükséges.

sku

Sku

A Bastion-gazdagép termékváltozata.

tags

object

Erőforráscímkék.

zones

string[]

A rendelkezésre állási zónák listája, amely azt jelöli, hogy honnan kell származnia az erőforrásnak.

Válaszok

Name Típus Description
200 OK

BastionHost

A frissítés sikeres. A művelet az eredményül kapott Bastion-gazdagép-erőforrást adja vissza.

201 Created

BastionHost

Sikeres létrehozás. A művelet az eredményül kapott Bastion-gazdagép-erőforrást adja vissza.

Other Status Codes

CloudError

Hibaválasz, amely leírja, hogy a művelet miért hiúsult meg.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow.

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

Scopes

Name Description
user_impersonation felhasználói fiók megszemélyesítése

Példák

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": []
  }
}

Definíciók

Name Description
BastionHost

Bastion-gazdagép erőforrása.

BastionHostIPConfiguration

Egy Bastion-gazdagép IP-konfigurációja.

BastionHostSkuName

Ennek a Bastion-gazdagépnek a neve.

CloudError

Hibaválasz a szolgáltatástól.

CloudErrorBody

Hibaválasz a szolgáltatástól.

IPAllocationMethod

IP-címfoglalási módszer.

IPRule
NetworkAcls
ProvisioningState

Az aktuális kiépítési állapot.

Sku

A Bastion-gazdagép termékváltozata.

SubResource

Hivatkozás egy másik alforrásra.

BastionHost

Bastion-gazdagép erőforrása.

Name Típus Alapértelmezett érték Description
etag

string

Egyedi írásvédett sztring, amely az erőforrás frissítésekor változik.

id

string

Erőforrás-azonosító.

location

string

Erőforrás helye.

name

string

Erőforrás neve.

properties.disableCopyPaste

boolean

False

A Bastion-gazdagép erőforrás másolási/beillesztési funkciójának engedélyezése/letiltása.

properties.dnsName

string

A végpont teljes tartományneve, amelyen a megerősített gazdagép elérhető.

properties.enableFileCopy

boolean

False

A Bastion-gazdagép erőforrás fájlmásolási funkciójának engedélyezése/letiltása.

properties.enableIpConnect

boolean

False

A Bastion-gazdagép erőforrás IP Connect-funkciójának engedélyezése/letiltása.

properties.enableKerberos

boolean

False

A Bastion-gazdagép erőforrás Kerberos-funkciójának engedélyezése/letiltása.

properties.enableShareableLink

boolean

False

A Bastion-gazdagép erőforrás megosztható hivatkozásának engedélyezése/letiltása.

properties.enableTunneling

boolean

False

A Bastion-gazdagép erőforrás bújtatási funkciójának engedélyezése/letiltása.

properties.ipConfigurations

BastionHostIPConfiguration[]

A Bastion-gazdagép-erőforrás IP-konfigurációja.

properties.networkAcls

NetworkAcls

properties.provisioningState

ProvisioningState

A megerősített gazdagép-erőforrás kiépítési állapota.

properties.scaleUnits

integer

A Bastion-gazdagép erőforrás méretezési egységei.

properties.virtualNetwork

SubResource

Hivatkozás egy meglévő virtuális hálózatra, amely csak a Developer Bastion-gazdagéphez szükséges.

sku

Sku

A Bastion-gazdagép termékváltozata.

tags

object

Erőforráscímkék.

type

string

Erőforrástípus.

zones

string[]

A rendelkezésre állási zónák listája, amely azt jelöli, hogy honnan kell származnia az erőforrásnak.

BastionHostIPConfiguration

Egy Bastion-gazdagép IP-konfigurációja.

Name Típus Description
etag

string

Egyedi írásvédett sztring, amely az erőforrás frissítésekor változik.

id

string

Erőforrás-azonosító.

name

string

Az erőforráscsoporton belül egyedi erőforrás neve. Ez a név használható az erőforrás eléréséhez.

properties.privateIPAllocationMethod

IPAllocationMethod

Privát IP-kiosztási módszer.

properties.provisioningState

ProvisioningState

A megerősített gazdagép IP-konfigurációs erőforrásának kiépítési állapota.

properties.publicIPAddress

SubResource

A PublicIP-erőforrás referenciája.

properties.subnet

SubResource

Az alhálózati erőforrás referenciája.

type

string

Ip-konfiguráció típusa.

BastionHostSkuName

Ennek a Bastion-gazdagépnek a neve.

Name Típus Description
Basic

string

Developer

string

Standard

string

CloudError

Hibaválasz a szolgáltatástól.

Name Típus Description
error

CloudErrorBody

Felhőbeli hibatörzs.

CloudErrorBody

Hibaválasz a szolgáltatástól.

Name Típus Description
code

string

A hiba azonosítója. A kódok invariánsak, és programozott módon használhatók.

details

CloudErrorBody[]

A hibával kapcsolatos további részletek listája.

message

string

A hibát leíró üzenet, amely alkalmas a felhasználói felületen való megjelenítésre.

target

string

Az adott hiba célja. Például a hibás tulajdonság neve.

IPAllocationMethod

IP-címfoglalási módszer.

Name Típus Description
Dynamic

string

Static

string

IPRule

Name Típus Description
addressPrefix

string

CiDR formátumban adja meg az IP- vagy IP-tartományt. Csak IPV4-cím engedélyezett.

NetworkAcls

Name Típus Description
ipRules

IPRule[]

Beállítja a Developer Bastion Host IP ACL-szabályait.

ProvisioningState

Az aktuális kiépítési állapot.

Name Típus Description
Deleting

string

Failed

string

Succeeded

string

Updating

string

Sku

A Bastion-gazdagép termékváltozata.

Name Típus Alapértelmezett érték Description
name

BastionHostSkuName

Standard

Ennek a Bastion-gazdagépnek a neve.

SubResource

Hivatkozás egy másik alforrásra.

Name Típus Description
id

string

Erőforrás-azonosító.