Bastion Hosts - List By Resource Group
Listas todos los hosts de Bastion de un grupo de recursos.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/bastionHosts?api-version=2023-09-01
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Nombre del grupo de recursos. |
subscription
|
path | True |
string |
Las credenciales de suscripción que identifican de forma exclusiva la suscripción a Microsoft Azure. El identificador de suscripción forma parte del URI para cada llamada al servicio. |
api-version
|
query | True |
string |
Versión de API del cliente. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Correcto. La operación devuelve una lista de recursos de BastionHost. |
|
Other Status Codes |
Respuesta de error que describe el motivo del error de la operación. |
Seguridad
azure_auth
Flujo de OAuth2 de Azure Active Directory.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nombre | Description |
---|---|
user_impersonation | suplantación de su cuenta de usuario |
Ejemplos
List all Bastion Hosts for a given resource group
Sample Request
Sample Response
{
"value": [
{
"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"
},
"zones": [],
"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"
}
}
}
]
}
}
]
}
Definiciones
Nombre | Description |
---|---|
Bastion |
Recurso de host bastión. |
Bastion |
Configuración de IP de un host de Bastion. |
Bastion |
Respuesta para la llamada del servicio api ListBastionHosts. |
Bastion |
Nombre de este host de Bastion. |
Cloud |
Respuesta de error del servicio. |
Cloud |
Respuesta de error del servicio. |
IPAllocation |
Método de asignación de direcciones IP. |
IPRule | |
Network |
|
Provisioning |
Estado de aprovisionamiento actual. |
Sku |
SKU de este host de Bastion. |
Sub |
Referencia a otro subrecurso. |
BastionHost
Recurso de host bastión.
Nombre | Tipo | Valor predeterminado | Description |
---|---|---|---|
etag |
string |
Cadena de solo lectura única que cambia cada vez que se actualiza el recurso. |
|
id |
string |
Identificador del 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 host de Bastion. |
properties.dnsName |
string |
FQDN para el punto de conexión en el que es accesible el host bastión. |
|
properties.enableFileCopy |
boolean |
False |
Habilite o deshabilite la característica Copia de archivos del recurso host de Bastion. |
properties.enableIpConnect |
boolean |
False |
Habilite o deshabilite la característica Conexión IP del recurso host de Bastion. |
properties.enableKerberos |
boolean |
False |
Habilite o deshabilite la característica Kerberos del recurso host de Bastion. |
properties.enableShareableLink |
boolean |
False |
Habilite o deshabilite el vínculo que se puede compartir del recurso host de Bastion. |
properties.enableTunneling |
boolean |
False |
Habilite o deshabilite la característica tunelización del recurso host de Bastion. |
properties.ipConfigurations |
Configuración de IP del recurso host de Bastion. |
||
properties.networkAcls | |||
properties.provisioningState |
Estado de aprovisionamiento del recurso de host bastión. |
||
properties.scaleUnits |
integer |
Unidades de escalado para el recurso host de Bastion. |
|
properties.virtualNetwork |
Referencia a una red virtual existente necesaria solo para el host de Bastion para desarrolladores. |
||
sku |
SKU de este host de Bastion. |
||
tags |
object |
Etiquetas del recurso. |
|
type |
string |
Tipo de recurso. |
|
zones |
string[] |
Una lista de zonas de disponibilidad que 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 del 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 |
Método de asignación de IP privada. |
|
properties.provisioningState |
Estado de aprovisionamiento del recurso de configuración de IP del host bastión. |
|
properties.publicIPAddress |
Referencia del recurso PublicIP. |
|
properties.subnet |
Referencia del recurso de subred. |
|
type |
string |
Tipo de configuración ip. |
BastionHostListResult
Respuesta para la llamada del servicio api ListBastionHosts.
Nombre | Tipo | Description |
---|---|---|
nextLink |
string |
Dirección URL para obtener el siguiente conjunto de resultados. |
value |
Lista de hosts de Bastion en un grupo de recursos. |
BastionHostSkuName
Nombre de este host de Bastion.
Nombre | Tipo | Description |
---|---|---|
Basic |
string |
|
Developer |
string |
|
Standard |
string |
CloudError
Respuesta de error del servicio.
Nombre | Tipo | Description |
---|---|---|
error |
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 |
Lista de detalles adicionales sobre el error. |
|
message |
string |
Mensaje que describe el error, diseñado para ser adecuado para su presentación en una interfaz de usuario. |
target |
string |
Destino del error determinado. 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 la dirección IP o el intervalo 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 | Standard |
Nombre de este host de Bastion. |
SubResource
Referencia a otro subrecurso.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador del recurso. |