Partager via

Bastion Hosts - Get

  • Référence
Service:
Virtual Networks
Version d'API:
2024-05-01

Obtient l’hôte Bastion spécifié.

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

Paramètres URI

Nom Dans Obligatoire Type Description
bastionHostName
 path True

string

Nom de l’hôte Bastion.
resourceGroupName
 path True

string

Nom du groupe de ressources.
subscriptionId
 path True

string

Informations d’identification de l’abonnement qui identifient de manière unique l’abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI de chaque appel de service.
api-version
 query True

string

Version de l’API cliente.

Réponses

Nom Type Description
200 OK

BastionHost

Demande réussie. L’opération retourne une ressource BastionHost.
Other Status Codes

CloudError

Réponse d’erreur décrivant pourquoi l’opération a échoué.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation emprunter l’identité de votre compte d’utilisateur

Exemples

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

Get Bastion Host

Exemple de requête

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

Exemple de réponse

Code d’état:
200 
{
  "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

Exemple de requête

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

Exemple de réponse

Code d’état:
200 
{
  "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

Exemple de requête

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

Exemple de réponse

Code d’état:
200 
{
  "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

Exemple de requête

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

Exemple de réponse

Code d’état:
200 
{
  "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": []
  }
}

Définitions

Nom Description
BastionHost

Ressource hôte Bastion.
BastionHostIPConfiguration

Configuration IP d’un hôte Bastion.
BastionHostSkuName

Nom de la référence sku de cet hôte Bastion.
CloudError

Réponse d’erreur du service.
CloudErrorBody

Réponse d’erreur du service.
IPAllocationMethod

Méthode d’allocation d’adresses IP.
IPRule
NetworkAcls
ProvisioningState

État d’approvisionnement actuel.
Sku

Référence sku de cet hôte Bastion.
SubResource

Référence à une autre sous-ressource.

BastionHost

Ressource hôte Bastion.

Nom Type Valeur par défaut Description
etag

string

Chaîne en lecture seule unique qui change chaque fois que la ressource est mise à jour.
id

string

ID de ressource.
location

string

Emplacement des ressources.
name

string

Nom de la ressource.
properties.disableCopyPaste

boolean

False

Activer/désactiver la fonctionnalité Copier/Coller de la ressource hôte Bastion.
properties.dnsName

string

Nom de domaine complet pour le point de terminaison sur lequel l’hôte bastion est accessible.
properties.enableFileCopy

boolean

False

Activer/désactiver la fonctionnalité copie de fichiers de la ressource hôte Bastion.
properties.enableIpConnect

boolean

False

Activer/désactiver la fonctionnalité connexion IP de la ressource hôte Bastion.
properties.enableKerberos

boolean

False

Activer/désactiver la fonctionnalité Kerberos de la ressource hôte Bastion.
properties.enablePrivateOnlyBastion

boolean

False

Activer/désactiver la fonctionnalité Private Only de la ressource hôte Bastion.
properties.enableSessionRecording

boolean

False

Activer/désactiver la fonctionnalité d’enregistrement de session de la ressource hôte Bastion.
properties.enableShareableLink

boolean

False

Activer/désactiver le lien partageable de la ressource hôte Bastion.
properties.enableTunneling

boolean

False

Activer/désactiver la fonctionnalité de tunneling de la ressource hôte Bastion.
properties.ipConfigurations

BastionHostIPConfiguration[]

Configuration IP de la ressource hôte Bastion.
properties.networkAcls

NetworkAcls

properties.provisioningState

ProvisioningState

État d’approvisionnement de la ressource hôte bastion.
properties.scaleUnits

integer

Unités d’échelle pour la ressource Hôte Bastion.
properties.virtualNetwork

SubResource

Référence à un réseau virtuel existant requis pour l’hôte Bastion du développeur uniquement.
sku

Sku

Référence sku de cet hôte Bastion.
tags

object

Balises de ressource.
type

string

Type de ressource.
zones

string[]

Liste des zones de disponibilité indiquant à partir de laquelle la ressource doit provenir.

BastionHostIPConfiguration

Configuration IP d’un hôte Bastion.

Nom Type Description
etag

string

Chaîne en lecture seule unique qui change chaque fois que la ressource est mise à jour.
id

string

ID de ressource.
name

string

Nom de la ressource unique au sein d’un groupe de ressources. Ce nom peut être utilisé pour accéder à la ressource.
properties.privateIPAllocationMethod

IPAllocationMethod

Méthode d’allocation d’adresses IP privées.
properties.provisioningState

ProvisioningState

État d’approvisionnement de la ressource de configuration IP de l’hôte bastion.
properties.publicIPAddress

SubResource

Référence de la ressource PublicIP. Null pour bastion privé uniquement
properties.subnet

SubResource

Référence de la ressource de sous-réseau.
type

string

Type de configuration IP.

BastionHostSkuName

Nom de la référence sku de cet hôte Bastion.

Nom Type Description
Basic

string

Developer

string

Premium

string

Standard

string

CloudError

Réponse d’erreur du service.

Nom Type Description
error

CloudErrorBody

Corps de l’erreur cloud.

CloudErrorBody

Réponse d’erreur du service.

Nom Type Description
code

string

Identificateur de l’erreur. Les codes sont invariants et sont destinés à être consommés par programme.
details

CloudErrorBody[]

Liste des détails supplémentaires sur l’erreur.
message

string

Message décrivant l’erreur, destiné à être adapté à l’affichage dans une interface utilisateur.
target

string

Cible de l’erreur particulière. Par exemple, le nom de la propriété en erreur.

IPAllocationMethod

Méthode d’allocation d’adresses IP.

Nom Type Description
Dynamic

string

Static

string

IPRule

Nom Type Description
addressPrefix

string

Spécifie l’adresse IP ou la plage IP au format CIDR. Seule l’adresse IPV4 est autorisée.

NetworkAcls

Nom Type Description
ipRules

IPRule[]

Définit les règles de liste de contrôle d’accès IP pour l’hôte Bastion du développeur.

ProvisioningState

État d’approvisionnement actuel.

Nom Type Description
Deleting

string

Failed

string

Succeeded

string

Updating

string

Sku

Référence sku de cet hôte Bastion.

Nom Type Valeur par défaut Description
name

BastionHostSkuName

Standard

Nom de la référence sku de cet hôte Bastion.

SubResource

Référence à une autre sous-ressource.

Nom Type Description
id

string

ID de ressource.