Compartir a través de


Bastion Hosts - Create Or Update

Crea o actualiza el host de Bastion especificado.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
bastionHostName
path True

string

Nombre del host de Bastion.

resourceGroupName
path True

string

Nombre del grupo de recursos.

subscriptionId
path True

string

Credenciales de suscripción que identifican de forma única la suscripción de Microsoft Azure. El identificador de suscripción forma parte del URI de cada llamada de servicio.

api-version
query True

string

Versión de la API de cliente.

Cuerpo de la solicitud

Nombre Tipo Description
id

string

Identificador de recurso.

location

string

Ubicación del recurso.

properties.disableCopyPaste

boolean

Habilite o deshabilite la característica Copiar y pegar del recurso de host de Bastion.

properties.dnsName

string

FQDN para el punto de conexión en el que se puede acceder al host bastión.

properties.enableFileCopy

boolean

Habilite o deshabilite la característica Copia de archivos del recurso de host de Bastion.

properties.enableIpConnect

boolean

Habilite o deshabilite la característica Conexión IP del recurso de host de Bastion.

properties.enableKerberos

boolean

Habilite o deshabilite la característica Kerberos del recurso de host de Bastion.

properties.enablePrivateOnlyBastion

boolean

Habilite o deshabilite la característica Solo privada del recurso de host de Bastion.

properties.enableSessionRecording

boolean

Habilite o deshabilite la característica Grabación de sesión del recurso de host de Bastion.

properties.enableShareableLink

boolean

Habilite o deshabilite el vínculo que se puede compartir del recurso de host de Bastion.

properties.enableTunneling

boolean

Habilite o deshabilite la característica tunelización del recurso de host de Bastion.

properties.ipConfigurations

BastionHostIPConfiguration[]

Configuración de IP del recurso de host de Bastion.

properties.networkAcls

NetworkAcls

properties.scaleUnits

integer

Unidades de escalado para el recurso de host de Bastion.

properties.virtualNetwork

SubResource

Referencia a una red virtual existente necesaria solo para el host de Bastion para desarrolladores.

sku

Sku

SKU de este host de Bastion.

tags

object

Etiquetas de recursos.

zones

string[]

Lista de zonas de disponibilidad de las que se indica dónde debe proceder el recurso.

Respuestas

Nombre Tipo Description
200 OK

BastionHost

Se ha actualizado correctamente. La operación devuelve el recurso host de Bastion resultante.

201 Created

BastionHost

Cree correctamente. La operación devuelve el recurso host de Bastion resultante.

Other Status Codes

CloudError

Respuesta de error que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantar la cuenta de usuario

Ejemplos

Create Bastion Host
Create Bastion Host With Private Only
Create Bastion Host With Zones
Create Developer Bastion Host

Create Bastion Host

Solicitud de ejemplo

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/bastionHosts/bastionhosttenant?api-version=2024-05-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"
          }
        }
      }
    ]
  }
}

Respuesta de muestra

{
  "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,
    "enableSessionRecording": false,
    "enablePrivateOnlyBastion": 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": "bastionhosttenant'",
  "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,
    "enableSessionRecording": false,
    "enablePrivateOnlyBastion": 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 Private Only

Solicitud de ejemplo

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

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

Respuesta de muestra

{
  "name": "bastionhosttenant",
  "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": "Premium"
  },
  "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,
    "enableSessionRecording": false,
    "enablePrivateOnlyBastion": true,
    "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"
          }
        }
      }
    ]
  }
}
{
  "name": "bastionhosttenant",
  "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": "Premium"
  },
  "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,
    "enableSessionRecording": false,
    "enablePrivateOnlyBastion": true,
    "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"
          }
        }
      }
    ]
  }
}

Create Bastion Host With Zones

Solicitud de ejemplo

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/bastionHosts/bastionhosttenant?api-version=2024-05-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"
          }
        }
      }
    ]
  }
}

Respuesta de muestra

{
  "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,
    "enableSessionRecording": false,
    "enablePrivateOnlyBastion": 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,
    "enableSessionRecording": false,
    "enablePrivateOnlyBastion": 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

Solicitud de ejemplo

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

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

Respuesta de muestra

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

Definiciones

Nombre Description
BastionHost

Recurso de host de Bastion.

BastionHostIPConfiguration

Configuración de IP de un host de Bastion.

BastionHostSkuName

Nombre de la SKU de este host de Bastion.

CloudError

Respuesta de error del servicio.

CloudErrorBody

Respuesta de error del servicio.

IPAllocationMethod

Método de asignación de direcciones IP.

IPRule
NetworkAcls
ProvisioningState

Estado de aprovisionamiento actual.

Sku

SKU de este host de Bastion.

SubResource

Referencia a otro subrecurso.

BastionHost

Recurso de host de Bastion.

Nombre Tipo Valor predeterminado Description
etag

string

Cadena de solo lectura única que cambia cada vez que se actualiza el recurso.

id

string

Identificador de recurso.

location

string

Ubicación del recurso.

name

string

Nombre del recurso.

properties.disableCopyPaste

boolean

False

Habilite o deshabilite la característica Copiar y pegar del recurso de host de Bastion.

properties.dnsName

string

FQDN para el punto de conexión en el que se puede acceder al host bastión.

properties.enableFileCopy

boolean

False

Habilite o deshabilite la característica Copia de archivos del recurso de host de Bastion.

properties.enableIpConnect

boolean

False

Habilite o deshabilite la característica Conexión IP del recurso de host de Bastion.

properties.enableKerberos

boolean

False

Habilite o deshabilite la característica Kerberos del recurso de host de Bastion.

properties.enablePrivateOnlyBastion

boolean

False

Habilite o deshabilite la característica Solo privada del recurso de host de Bastion.

properties.enableSessionRecording

boolean

False

Habilite o deshabilite la característica Grabación de sesión del recurso de host de Bastion.

properties.enableShareableLink

boolean

False

Habilite o deshabilite el vínculo que se puede compartir del recurso de host de Bastion.

properties.enableTunneling

boolean

False

Habilite o deshabilite la característica tunelización del recurso de host de Bastion.

properties.ipConfigurations

BastionHostIPConfiguration[]

Configuración de IP del recurso de host de Bastion.

properties.networkAcls

NetworkAcls

properties.provisioningState

ProvisioningState

Estado de aprovisionamiento del recurso de host bastión.

properties.scaleUnits

integer

Unidades de escalado para el recurso de host de Bastion.

properties.virtualNetwork

SubResource

Referencia a una red virtual existente necesaria solo para el host de Bastion para desarrolladores.

sku

Sku

SKU de este host de Bastion.

tags

object

Etiquetas de recursos.

type

string

Tipo de recurso.

zones

string[]

Lista de zonas de disponibilidad de las que se indica dónde debe proceder el recurso.

BastionHostIPConfiguration

Configuración de IP de un host de Bastion.

Nombre Tipo Description
etag

string

Cadena de solo lectura única que cambia cada vez que se actualiza el recurso.

id

string

Identificador de recurso.

name

string

Nombre del recurso que es único dentro de un grupo de recursos. Este nombre se puede usar para acceder al recurso.

properties.privateIPAllocationMethod

IPAllocationMethod

Método de asignación de IP privada.

properties.provisioningState

ProvisioningState

Estado de aprovisionamiento del recurso de configuración de IP del host bastión.

properties.publicIPAddress

SubResource

Referencia del recurso PublicIP. Null solo para bastión privado

properties.subnet

SubResource

Referencia del recurso de subred.

type

string

Tipo de configuración ip.

BastionHostSkuName

Nombre de la SKU de este host de Bastion.

Nombre Tipo Description
Basic

string

Developer

string

Premium

string

Standard

string

CloudError

Respuesta de error del servicio.

Nombre Tipo Description
error

CloudErrorBody

Cuerpo del error en la nube.

CloudErrorBody

Respuesta de error del servicio.

Nombre Tipo Description
code

string

Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.

details

CloudErrorBody[]

Lista de detalles adicionales sobre el error.

message

string

Mensaje que describe el error, diseñado para ser adecuado para mostrarse en una interfaz de usuario.

target

string

Destino del error concreto. Por ejemplo, el nombre de la propiedad en error.

IPAllocationMethod

Método de asignación de direcciones IP.

Nombre Tipo Description
Dynamic

string

Static

string

IPRule

Nombre Tipo Description
addressPrefix

string

Especifica el intervalo IP o IP en formato CIDR. Solo se permite la dirección IPV4.

NetworkAcls

Nombre Tipo Description
ipRules

IPRule[]

Establece las reglas de ACL de IP para el host de Bastion para desarrolladores.

ProvisioningState

Estado de aprovisionamiento actual.

Nombre Tipo Description
Deleting

string

Failed

string

Succeeded

string

Updating

string

Sku

SKU de este host de Bastion.

Nombre Tipo Valor predeterminado Description
name

BastionHostSkuName

Standard

Nombre de la SKU de este host de Bastion.

SubResource

Referencia a otro subrecurso.

Nombre Tipo Description
id

string

Identificador de recurso.