다음을 통해 공유


Bastion Hosts - Create Or Update

지정된 Bastion 호스트를 만들거나 업데이트합니다.

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

URI 매개 변수

Name In(다음 안에) 필수 형식 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 형식 Description
id

string

리소스 ID입니다.

location

string

리소스 위치.

properties.disableCopyPaste

boolean

Bastion 호스트 리소스의 복사/붙여넣기 기능을 사용하거나 사용하지 않도록 설정합니다.

properties.dnsName

string

베스천 호스트에 액세스할 수 있는 엔드포인트에 대한 FQDN입니다.

properties.enableFileCopy

boolean

Bastion 호스트 리소스의 파일 복사 기능을 사용하거나 사용하지 않도록 설정합니다.

properties.enableIpConnect

boolean

Bastion 호스트 리소스의 IP 연결 기능을 사용하거나 사용하지 않도록 설정합니다.

properties.enableKerberos

boolean

Bastion 호스트 리소스의 Kerberos 기능을 사용하거나 사용하지 않도록 설정합니다.

properties.enableShareableLink

boolean

Bastion 호스트 리소스의 공유 가능한 링크를 사용하거나 사용하지 않도록 설정합니다.

properties.enableTunneling

boolean

Bastion 호스트 리소스의 터널링 기능을 사용하거나 사용하지 않도록 설정합니다.

properties.ipConfigurations

BastionHostIPConfiguration[]

Bastion 호스트 리소스의 IP 구성입니다.

properties.networkAcls

NetworkAcls

properties.scaleUnits

integer

Bastion 호스트 리소스의 배율 단위입니다.

properties.virtualNetwork

SubResource

개발자 Bastion 호스트에만 필요한 기존 가상 네트워크에 대한 참조입니다.

sku

Sku

이 Bastion 호스트의 sku입니다.

tags

object

리소스 태그.

zones

string[]

리소스의 원본 위치를 나타내는 가용성 영역 목록입니다.

응답

Name 형식 Description
200 OK

BastionHost

업데이트에 성공했습니다. 작업은 결과 Bastion 호스트 리소스를 반환합니다.

201 Created

BastionHost

만들기에 성공했습니다. 작업은 결과 Bastion 호스트 리소스를 반환합니다.

Other Status Codes

CloudError

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow.

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

Scopes

Name Description
user_impersonation 사용자 계정 가장

예제

Create Bastion Host
Create Bastion Host With Zones
Create Developer Bastion Host

Create Bastion Host

Sample Request

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

Sample Request

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

Sample Request

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

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

Sample Response

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

정의

Name Description
BastionHost

Bastion 호스트 리소스.

BastionHostIPConfiguration

Bastion 호스트의 IP 구성입니다.

BastionHostSkuName

이 Bastion 호스트의 이름입니다.

CloudError

서비스의 오류 응답입니다.

CloudErrorBody

서비스의 오류 응답입니다.

IPAllocationMethod

IP 주소 할당 방법입니다.

IPRule
NetworkAcls
ProvisioningState

현재 프로비저닝 상태입니다.

Sku

이 Bastion 호스트의 sku입니다.

SubResource

다른 하위 리소스에 대한 참조입니다.

BastionHost

Bastion 호스트 리소스.

Name 형식 기본값 Description
etag

string

리소스를 업데이트할 때마다 변경되는 고유한 읽기 전용 문자열입니다.

id

string

리소스 ID입니다.

location

string

리소스 위치.

name

string

리소스 이름입니다.

properties.disableCopyPaste

boolean

False

Bastion 호스트 리소스의 복사/붙여넣기 기능을 사용하거나 사용하지 않도록 설정합니다.

properties.dnsName

string

베스천 호스트에 액세스할 수 있는 엔드포인트에 대한 FQDN입니다.

properties.enableFileCopy

boolean

False

Bastion 호스트 리소스의 파일 복사 기능을 사용하거나 사용하지 않도록 설정합니다.

properties.enableIpConnect

boolean

False

Bastion 호스트 리소스의 IP 연결 기능을 사용하거나 사용하지 않도록 설정합니다.

properties.enableKerberos

boolean

False

Bastion 호스트 리소스의 Kerberos 기능을 사용하거나 사용하지 않도록 설정합니다.

properties.enableShareableLink

boolean

False

Bastion 호스트 리소스의 공유 가능한 링크를 사용하거나 사용하지 않도록 설정합니다.

properties.enableTunneling

boolean

False

Bastion 호스트 리소스의 터널링 기능을 사용하거나 사용하지 않도록 설정합니다.

properties.ipConfigurations

BastionHostIPConfiguration[]

Bastion 호스트 리소스의 IP 구성입니다.

properties.networkAcls

NetworkAcls

properties.provisioningState

ProvisioningState

베스천 호스트 리소스의 프로비전 상태입니다.

properties.scaleUnits

integer

Bastion 호스트 리소스의 배율 단위입니다.

properties.virtualNetwork

SubResource

개발자 Bastion 호스트에만 필요한 기존 가상 네트워크에 대한 참조입니다.

sku

Sku

이 Bastion 호스트의 sku입니다.

tags

object

리소스 태그.

type

string

리소스 종류.

zones

string[]

리소스의 원본 위치를 나타내는 가용성 영역 목록입니다.

BastionHostIPConfiguration

Bastion 호스트의 IP 구성입니다.

Name 형식 Description
etag

string

리소스를 업데이트할 때마다 변경되는 고유한 읽기 전용 문자열입니다.

id

string

리소스 ID입니다.

name

string

리소스 그룹 내에서 고유한 리소스의 이름입니다. 이 이름은 리소스에 액세스하는 데 사용할 수 있습니다.

properties.privateIPAllocationMethod

IPAllocationMethod

개인 IP 할당 방법입니다.

properties.provisioningState

ProvisioningState

베스천 호스트 IP 구성 리소스의 프로비전 상태입니다.

properties.publicIPAddress

SubResource

PublicIP 리소스의 참조입니다.

properties.subnet

SubResource

서브넷 리소스의 참조입니다.

type

string

Ip 구성 유형입니다.

BastionHostSkuName

이 Bastion 호스트의 이름입니다.

Name 형식 Description
Basic

string

Developer

string

Standard

string

CloudError

서비스의 오류 응답입니다.

Name 형식 Description
error

CloudErrorBody

클라우드 오류 본문.

CloudErrorBody

서비스의 오류 응답입니다.

Name 형식 Description
code

string

오류의 식별자입니다. 코드는 고정이며 프로그래밍 방식으로 사용하기 위한 것입니다.

details

CloudErrorBody[]

오류에 대한 추가 세부 정보 목록입니다.

message

string

사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.

target

string

특정 오류의 대상입니다. 예를 들어 오류에 있는 속성의 이름입니다.

IPAllocationMethod

IP 주소 할당 방법입니다.

Name 형식 Description
Dynamic

string

Static

string

IPRule

Name 형식 Description
addressPrefix

string

IP 또는 IP 범위를 CIDR 형식으로 지정합니다. IPV4 주소만 허용됩니다.

NetworkAcls

Name 형식 Description
ipRules

IPRule[]

개발자 Bastion 호스트에 대한 IP ACL 규칙을 설정합니다.

ProvisioningState

현재 프로비저닝 상태입니다.

Name 형식 Description
Deleting

string

Failed

string

Succeeded

string

Updating

string

Sku

이 Bastion 호스트의 sku입니다.

Name 형식 기본값 Description
name

BastionHostSkuName

Standard

이 Bastion 호스트의 이름입니다.

SubResource

다른 하위 리소스에 대한 참조입니다.

Name 형식 Description
id

string

리소스 ID입니다.