Compartilhar via


Bastion Hosts - Get

Obtém o Host do Bastion especificado.

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
bastionHostName
path True

string

O nome do Host do Bastion.

resourceGroupName
path True

string

O nome do grupo de recursos.

subscriptionId
path True

string

As credenciais de assinatura que identificam exclusivamente a assinatura do Microsoft Azure. A ID da assinatura faz parte do URI para cada chamada de serviço.

api-version
query True

string

Versão da API do cliente.

Respostas

Nome Tipo Description
200 OK

BastionHost

Solicitação bem-sucedida. A operação retorna um recurso bastionHost.

Other Status Codes

CloudError

Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

Get Bastion Host
Get Bastion Host With Private Only
Get Bastion Host With Zones
Get Developer Bastion Host

Get Bastion Host

Solicitação de exemplo

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

Resposta de exemplo

{
  "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",
  "tags": {
    "key1": "value1"
  },
  "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,
    "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"
          }
        }
      }
    ]
  }
}

Get Bastion Host With Private Only

Solicitação de exemplo

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

Resposta de exemplo

{
  "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",
  "tags": {
    "key1": "value1"
  },
  "sku": {
    "name": "Premium"
  },
  "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,
    "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"
          }
        }
      }
    ]
  }
}

Get Bastion Host With Zones

Solicitação de exemplo

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

Resposta de exemplo

{
  "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",
  "tags": {
    "key1": "value1"
  },
  "sku": {
    "name": "Standard"
  },
  "zones": [
    "1",
    "2"
  ],
  "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"
          }
        }
      }
    ]
  }
}

Get Developer Bastion Host

Solicitação de exemplo

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

Resposta de exemplo

{
  "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",
    "virtualNetwork": {
      "id": "/subscriptions/subid/resourceGroups/rg2/providers/Microsoft.Network/virtualNetworks/vnet2"
    },
    "networkAcls": {
      "ipRules": [
        {
          "addressPrefix": "1.1.1.1/16"
        }
      ]
    },
    "dnsName": "omnibrain.uswest.bastionglobal.azure.com",
    "ipConfigurations": []
  }
}

Definições

Nome Description
BastionHost

Recurso de Host do Bastion.

BastionHostIPConfiguration

Configuração de IP de um Host do Bastion.

BastionHostSkuName

O nome do sku deste Host do Bastion.

CloudError

Uma resposta de erro do serviço.

CloudErrorBody

Uma resposta de erro do serviço.

IPAllocationMethod

Método de alocação de endereço IP.

IPRule
NetworkAcls
ProvisioningState

O estado de provisionamento atual.

Sku

O sku deste Host do Bastion.

SubResource

Referência a outro sub-recurso.

BastionHost

Recurso de Host do Bastion.

Nome Tipo Valor padrão Description
etag

string

Uma cadeia de caracteres somente leitura exclusiva que é alterada sempre que o recurso é atualizado.

id

string

ID do recurso.

location

string

Local do recurso.

name

string

Nome do recurso.

properties.disableCopyPaste

boolean

False

Habilitar/desabilitar o recurso Copiar/Colar do recurso de Host do Bastion.

properties.dnsName

string

FQDN para o ponto de extremidade no qual o host bastion está acessível.

properties.enableFileCopy

boolean

False

Habilitar/desabilitar o recurso de Cópia de Arquivo do recurso de Host do Bastion.

properties.enableIpConnect

boolean

False

Habilitar/desabilitar o recurso do IP Connect do recurso de Host do Bastion.

properties.enableKerberos

boolean

False

Habilitar/desabilitar o recurso Kerberos do recurso de Host do Bastion.

properties.enablePrivateOnlyBastion

boolean

False

Habilitar/desabilitar o recurso Somente Privado do recurso de Host do Bastion.

properties.enableSessionRecording

boolean

False

Habilitar/desabilitar o recurso de Gravação de Sessão do recurso de Host do Bastion.

properties.enableShareableLink

boolean

False

Habilitar/desabilitar o Link de Compartilhamento do recurso de Host do Bastion.

properties.enableTunneling

boolean

False

Habilitar/desabilitar o recurso de túnel do recurso de Host do Bastion.

properties.ipConfigurations

BastionHostIPConfiguration[]

Configuração de IP do recurso de Host do Bastion.

properties.networkAcls

NetworkAcls

properties.provisioningState

ProvisioningState

O estado de provisionamento do recurso de host do bastion.

properties.scaleUnits

integer

As unidades de escala para o recurso de Host do Bastion.

properties.virtualNetwork

SubResource

Referência a uma rede virtual existente necessária apenas para o Host do Desenvolvedor Bastion.

sku

Sku

O sku deste Host do Bastion.

tags

object

Marcas de recurso.

type

string

Tipo de recurso.

zones

string[]

Uma lista de zonas de disponibilidade indicando de onde o recurso precisa vir.

BastionHostIPConfiguration

Configuração de IP de um Host do Bastion.

Nome Tipo Description
etag

string

Uma cadeia de caracteres somente leitura exclusiva que é alterada sempre que o recurso é atualizado.

id

string

ID do recurso.

name

string

Nome do recurso exclusivo em um grupo de recursos. Esse nome pode ser usado para acessar o recurso.

properties.privateIPAllocationMethod

IPAllocationMethod

Método de alocação de IP privado.

properties.provisioningState

ProvisioningState

O estado de provisionamento do recurso de configuração de IP do host bastion.

properties.publicIPAddress

SubResource

Referência do recurso PublicIP. Nulo somente para bastiões privados

properties.subnet

SubResource

Referência do recurso de sub-rede.

type

string

Tipo de configuração de ip.

BastionHostSkuName

O nome do sku deste Host do Bastion.

Nome Tipo Description
Basic

string

Developer

string

Premium

string

Standard

string

CloudError

Uma resposta de erro do serviço.

Nome Tipo Description
error

CloudErrorBody

Corpo do erro de nuvem.

CloudErrorBody

Uma resposta de erro do serviço.

Nome Tipo Description
code

string

Um identificador para o erro. Os códigos são invariáveis e devem ser consumidos programaticamente.

details

CloudErrorBody[]

Uma lista de detalhes adicionais sobre o erro.

message

string

Uma mensagem que descreve o erro, destinada a ser adequada para exibição em uma interface do usuário.

target

string

O destino do erro específico. Por exemplo, o nome da propriedade em erro.

IPAllocationMethod

Método de alocação de endereço IP.

Nome Tipo Description
Dynamic

string

Static

string

IPRule

Nome Tipo Description
addressPrefix

string

Especifica o intervalo de IP ou IP no formato CIDR. Somente o endereço IPV4 é permitido.

NetworkAcls

Nome Tipo Description
ipRules

IPRule[]

Define as regras de ACL de IP para o Host do Bastion do Desenvolvedor.

ProvisioningState

O estado de provisionamento atual.

Nome Tipo Description
Deleting

string

Failed

string

Succeeded

string

Updating

string

Sku

O sku deste Host do Bastion.

Nome Tipo Valor padrão Description
name

BastionHostSkuName

Standard

O nome do sku deste Host do Bastion.

SubResource

Referência a outro sub-recurso.

Nome Tipo Description
id

string

ID do recurso.