Bastion Hosts - Create Or Update

指定した Bastion ホストを作成または更新します。

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

URI パラメーター

Name In Required Type Description
bastionHostName
path True
  • string

Bastion ホストの名前。

resourceGroupName
path True
  • string

リソース グループの名前。

subscriptionId
path True
  • string

Microsoft Azure サブスクリプションを一意に識別するサブスクリプション資格情報。 サブスクリプション ID は、全ての修理依頼についてURI の一部を生じさせます。

api-version
query True
  • string

クライアント API バージョン。

要求本文

Name Type Description
id
  • string

リソースの ID

location
  • string

リソースの場所。

properties.disableCopyPaste
  • boolean

Bastion ホスト リソースのコピー/貼り付け機能を有効/無効にします。

properties.dnsName
  • string

要塞ホストにアクセスできるエンドポイントの FQDN。

properties.enableFileCopy
  • boolean

Bastion ホスト リソースのファイル コピー機能を有効または無効にします。

properties.enableIpConnect
  • boolean

Bastion ホスト リソースの IP Connect機能を有効または無効にします。

properties.enableShareableLink
  • boolean

Bastion ホスト リソースの共有可能なリンクを有効または無効にします。

properties.enableTunneling
  • boolean

Bastion ホスト リソースのトンネリング機能を有効または無効にします。

properties.ipConfigurations

Bastion ホスト リソースの IP 構成。

properties.scaleUnits
  • integer

Bastion ホスト リソースのスケール ユニット。

sku

この Bastion ホストの SKU。

tags
  • object

リソース タグ。

応答

Name Type Description
200 OK

更新が成功しました。 この操作は、結果として得られる Bastion ホスト リソースを返します。

201 Created

正常に作成されます。 この操作は、結果として得られる Bastion ホスト リソースを返します。

Other Status Codes

操作に失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

OAuth2 FlowをAzure Active Directoryします。

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

Scopes

Name Description
user_impersonation ユーザー アカウントを偽装する

Create Bastion Host

Sample Request

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

定義

BastionHost

Bastion ホスト リソース。

BastionHostIPConfiguration

Bastion ホストの IP 構成。

BastionHostSkuName

この Bastion ホストの名前。

CloudError

サービスからのエラー応答。

CloudErrorBody

サービスからのエラー応答。

IPAllocationMethod

IP アドレスの割り当て方法。

ProvisioningState

現在のプロビジョニング状態。

Sku

この Bastion ホストの SKU。

SubResource

別のサブリソースへの参照。

BastionHost

Bastion ホスト リソース。

Name Type Description
etag
  • string

リソースが更新されるたびに変更される一意の読み取り専用文字列。

id
  • string

リソースの ID

location
  • string

リソースの場所。

name
  • string

リソース名。

properties.disableCopyPaste
  • boolean

Bastion ホスト リソースのコピー/貼り付け機能を有効/無効にします。

properties.dnsName
  • string

要塞ホストにアクセスできるエンドポイントの FQDN。

properties.enableFileCopy
  • boolean

Bastion ホスト リソースのファイル コピー機能を有効または無効にします。

properties.enableIpConnect
  • boolean

Bastion ホスト リソースの IP Connect機能を有効または無効にします。

properties.enableShareableLink
  • boolean

Bastion ホスト リソースの共有可能なリンクを有効または無効にします。

properties.enableTunneling
  • boolean

Bastion ホスト リソースのトンネリング機能を有効または無効にします。

properties.ipConfigurations

Bastion ホスト リソースの IP 構成。

properties.provisioningState

要塞ホスト リソースのプロビジョニング状態。

properties.scaleUnits
  • integer

Bastion ホスト リソースのスケール ユニット。

sku

この Bastion ホストの SKU。

tags
  • object

リソース タグ。

type
  • string

リソースの種類。

BastionHostIPConfiguration

Bastion ホストの IP 構成。

Name Type Description
etag
  • string

リソースが更新されるたびに変更される一意の読み取り専用文字列。

id
  • string

リソースの ID

name
  • string

リソース グループ内で一意のリソースの名前。 この名前は、リソースへのアクセスに使用できます。

properties.privateIPAllocationMethod

プライベート IP の割り当て方法。

properties.provisioningState

要塞ホスト IP 構成リソースのプロビジョニング状態。

properties.publicIPAddress

PublicIP リソースの参照。

properties.subnet

サブネット リソースの参照。

type
  • string

IP 構成の種類。

BastionHostSkuName

この Bastion ホストの名前。

Name Type Description
Basic
  • string
Standard
  • string

CloudError

サービスからのエラー応答。

Name Type Description
error

クラウド エラー本文。

CloudErrorBody

サービスからのエラー応答。

Name Type Description
code
  • string

エラーの識別子。 コードは不変であり、プログラムによって使用されることを意図しています。

details

エラーに関するその他の詳細の一覧。

message
  • string

ユーザー インターフェイスでの表示に適したエラーを説明するメッセージ。

target
  • string

特定のエラーのターゲット。 たとえば、エラーのプロパティの名前です。

IPAllocationMethod

IP アドレスの割り当て方法。

Name Type Description
Dynamic
  • string
Static
  • string

ProvisioningState

現在のプロビジョニング状態。

Name Type Description
Deleting
  • string
Failed
  • string
Succeeded
  • string
Updating
  • string

Sku

この Bastion ホストの SKU。

Name Type Description
name

この Bastion ホストの名前。

SubResource

別のサブリソースへの参照。

Name Type Description
id
  • string

リソースの ID