Access Bridges - Create Or Update

サービス:: Operator Nexus - Network Cloud

API バージョン:: 2026-01-01-preview

新しいアクセスブリッジを作成するか、既存のアクセスブリッジのプロパティを更新してください。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/accessBridges/{accessBridgeName}?api-version=2026-01-01-preview

URI パラメーター

名前	/	必須	型	説明
accessBridgeName	path	True	AccessBridgeAllowedName	アクセスブリッジの名前だ。
resourceGroupName	path	True	string minLength: 1 maxLength: 90	リソースグループの名前。名前の大文字と小文字は区別されません。
subscriptionId	path	True	string (uuid)	ターゲットサブスクリプションの ID。値は UUID である必要があります。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

要求本文

名前	必須	型	説明
extendedLocation	True	Azure.ResourceManager.CommonTypes.ExtendedLocation	資源の広がった位置。この性質はリソース作成時に必要です。
location	True	string	リソースが存在する地理的な場所
properties.networkId	True	string (arm-id)	利用するIPサブネットを含むレイヤー3の隔離ドメイン内の内部ネットワークのリソースID。
properties.ipv4ConnectedPrefix		string	アクセスブリッジがアドレスを割り当てるIPv4サブネット。このサブネットはnetworkIdによって指定された内部ネットワークの一部でなければなりません。
properties.ipv6ConnectedPrefix		string	アクセスブリッジがアドレスを割り当てるIPv6サブネット。このサブネットはnetworkIdによって指定された内部ネットワークの一部でなければなりません。
properties.securityRules		AccessBridgeSecurityRule[]	アクセスブリッジによって強制されるセキュリティルールのリスト。
tags		object	リソースタグ。

応答

名前	型	説明
200 OK	AccessBridge	リソース「AccessBridge」更新操作が成功しました
201 Created	AccessBridge	リソース「AccessBridge」作成操作が成功しましたヘッダー Azure-AsyncOperation: string
Other Status Codes	ErrorResponse	予期しないエラー応答。

名前

型

説明

200 OK

AccessBridge

リソース「AccessBridge」更新操作が成功しました

201 Created

AccessBridge

リソース「AccessBridge」作成操作が成功しました

ヘッダー

Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 Flow.

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
user_impersonation	ユーザーアカウントを偽装する

例

Create or update access bridge

要求のサンプル

HTTP

PUT https://management.azure.com/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/accessBridges/Bastion?api-version=2026-01-01-preview

{
  "extendedLocation": {
    "name": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterExtendedLocationName",
    "type": "CustomLocation"
  },
  "location": "location",
  "properties": {
    "ipv4ConnectedPrefix": "198.51.100.0/24",
    "ipv6ConnectedPrefix": "2001:db8::/64",
    "networkId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/providers/Microsoft.ManagedNetworkFabric/l3IsolationDomains/l3IsolationDomainName/internalNetworks/internalNetworkName",
    "securityRules": [
      {
        "description": "Allow management plane egress",
        "direction": "Outbound",
        "ipv4Addresses": [
          "10.10.20.10-10.10.20.20"
        ],
        "ipv6Addresses": [
          "2001:db8:abcd:12::1000-2001:db8:abcd:12::1fff"
        ],
        "port": "24562-24570"
      }
    ]
  },
  "tags": {
    "key1": "myvalue1",
    "key2": "myvalue2"
  }
}

応答のサンプル

状態コード:: 200

{
  "extendedLocation": {
    "name": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterExtendedLocationName",
    "type": "CustomLocation"
  },
  "id": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/accessBridges/accessBridgeName",
  "location": "location",
  "name": "accessBridgeName",
  "properties": {
    "detailedStatus": "Running",
    "detailedStatusMessage": "The access bridge is serving traffic from the VIP and storage appliance endpoints.",
    "endpoints": [
      {
        "fqdn": "bastion.contoso.example.com",
        "ipv4Address": "192.51.100.10",
        "ipv6Address": "2001:db8::10",
        "name": "vip"
      }
    ],
    "ipv4ConnectedPrefix": "198.51.100.0/24",
    "ipv6ConnectedPrefix": "2001:db8::/64",
    "networkId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/providers/Microsoft.ManagedNetworkFabric/l3IsolationDomains/l3IsolationDomainName/internalNetworks/internalNetworkName",
    "protocol": "TCP",
    "provisioningState": "Succeeded",
    "securityRules": [
      {
        "description": "Allow management plane egress",
        "direction": "Outbound",
        "ipv4Addresses": [
          "10.10.20.10-10.10.20.20"
        ],
        "ipv6Addresses": [
          "2001:db8:abcd:12::1000-2001:db8:abcd:12::1fff"
        ],
        "port": "24562-24570"
      }
    ]
  },
  "systemData": {
    "createdAt": "2021-01-22T13:27:03.008Z",
    "createdBy": "identityA",
    "createdByType": "Application",
    "lastModifiedAt": "2021-01-22T13:29:03.001Z",
    "lastModifiedBy": "identityB",
    "lastModifiedByType": "User"
  },
  "tags": {
    "key1": "myvalue1",
    "key2": "myvalue2"
  },
  "type": "Microsoft.NetworkCloud/accessBridges"
}

状態コード:: 201

Azure-AsyncOperation: https://management.azure.com/subscriptions/123e4567-e89b-12d3-a456-426655440000/providers/Microsoft.NetworkCloud/locations/location/operationStatuses/operationId?api-version=2026-01-01-preview

{
  "extendedLocation": {
    "name": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterExtendedLocationName",
    "type": "CustomLocation"
  },
  "id": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/accessBridges/accessBridgeName",
  "location": "location",
  "name": "accessBridgeName",
  "properties": {
    "detailedStatus": "Running",
    "detailedStatusMessage": "The access bridge is serving traffic from the VIP and storage appliance endpoints.",
    "endpoints": [
      {
        "fqdn": "bastion.contoso.example.com",
        "ipv4Address": "192.51.100.10",
        "ipv6Address": "2001:db8::10",
        "name": "vip"
      }
    ],
    "ipv4ConnectedPrefix": "198.51.100.0/24",
    "ipv6ConnectedPrefix": "2001:db8::/64",
    "networkId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/providers/Microsoft.ManagedNetworkFabric/l3IsolationDomains/l3IsolationDomainName/internalNetworks/internalNetworkName",
    "protocol": "TCP",
    "provisioningState": "Accepted",
    "securityRules": [
      {
        "description": "Allow management plane egress",
        "direction": "Outbound",
        "ipv4Addresses": [
          "10.10.20.10-10.10.20.20"
        ],
        "ipv6Addresses": [
          "2001:db8:abcd:12::1000-2001:db8:abcd:12::1fff"
        ],
        "port": "24562-24570"
      }
    ]
  },
  "systemData": {
    "createdAt": "2021-01-22T13:27:03.008Z",
    "createdBy": "identityA",
    "createdByType": "Application",
    "lastModifiedAt": "2021-01-22T13:29:03.001Z",
    "lastModifiedBy": "identityB",
    "lastModifiedByType": "User"
  },
  "tags": {
    "key1": "myvalue1",
    "key2": "myvalue2"
  },
  "type": "Microsoft.NetworkCloud/accessBridges"
}

定義

名前	説明
AccessBridge	AccessBridgeは管理されたアクセスブリッジリソースを表します。
AccessBridgeAllowedName	アクセスブリッジの名前だ。
AccessBridgeDetailedStatus	アクセスブリッジから報告された詳細な状況。
AccessBridgeEndpoint	AccessBridgeEndpointは、単一の広告されたサービスエンドポイントを指します。
AccessBridgeProvisioningState	アクセスブリッジのプロビジョニング状態。
AccessBridgeSecurityRule	AccessBridgeSecurityRuleは、ブリッジによって強制される個別アクセスルールをキャプチャします。
Azure.ResourceManager.CommonTypes.ExtendedLocation	拡張された場所の複合型。
createdByType	リソースを作成した ID の種類。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
ExtendedLocationType	拡張された場所の種類。
SecurityRuleDirection	ルールに基づくネットワークトラフィックの方向性が認められました。
systemData	リソースの作成と最後の変更に関連するメタデータ。
TransportProtocol	アクセスブリッジのエンドポイントが宣伝するプロトコルです。

AccessBridge

Object

AccessBridgeは管理されたアクセスブリッジリソースを表します。

名前	型	説明
etag	string	「etagが応答本文で指定されている場合は、通常のetag規則に従ってヘッダーとして提供することもできます。エンティティタグは、同じ要求されたリソースから 2 つ以上のエンティティを比較するために使用されます。 HTTP/1.1 は、etag (セクション 14.19)、If-Match (セクション 14.24)、If-None-Match (セクション 14.26)、および If-Range (セクション 14.27) ヘッダーフィールドでエンティティタグを使用します。
extendedLocation	Azure.ResourceManager.CommonTypes.ExtendedLocation	資源の広がった位置。この性質はリソース作成時に必要です。
id	string (arm-id)	リソースの完全修飾リソース ID。例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	リソースが存在する地理的な場所
name	string	リソースの名前
properties.detailedStatus	AccessBridgeDetailedStatus	アクセスブリッジから報告された詳細な状況。
properties.detailedStatusMessage	string	詳細な状況に添えられる説明的なメッセージ。
properties.endpoints	AccessBridgeEndpoint[]	クライアントがアクセスブリッジにアクセスするために利用すべき観察されたエンドポイント。
properties.ipv4ConnectedPrefix	string	アクセスブリッジがアドレスを割り当てるIPv4サブネット。このサブネットはnetworkIdによって指定された内部ネットワークの一部でなければなりません。
properties.ipv6ConnectedPrefix	string	アクセスブリッジがアドレスを割り当てるIPv6サブネット。このサブネットはnetworkIdによって指定された内部ネットワークの一部でなければなりません。
properties.networkId	string (arm-id)	利用するIPサブネットを含むレイヤー3の隔離ドメイン内の内部ネットワークのリソースID。
properties.protocol	TransportProtocol	アクセスブリッジのエンドポイントが宣伝するプロトコルです。
properties.provisioningState	AccessBridgeProvisioningState	アクセスブリッジのプロビジョニング状態。
properties.securityRules	AccessBridgeSecurityRule[]	アクセスブリッジによって強制されるセキュリティルールのリスト。
systemData	systemData	create By と modifiedBy の情報を含む Azure Resource Manager メタデータ。
tags	object	リソースタグ。
type	string	リソースの型。例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

AccessBridgeAllowedName

列挙

アクセスブリッジの名前だ。

値	説明
Bastion	裸金属製の機械バスチオンアクセス用のアクセス橋。
PrivateVault	プライベートボールトへのクラスターアクセス用のアクセスブリッジ。
StorageDashboard	ストレージダッシュボードへのアクセスのためのアクセスブリッジです。

AccessBridgeDetailedStatus

列挙

アクセスブリッジから報告された詳細な状況。

値	説明
Running	アクセスブリッジは健康で正常に動作しています。
Degraded	アクセスブリッジは性能低下または部分的な障害を経験しています。
Failed	アクセスブリッジは稼働していません。

AccessBridgeEndpoint

Object

AccessBridgeEndpointは、単一の広告されたサービスエンドポイントを指します。

名前	型	説明
fqdn	string	エンドポイントの証明書名を表すために使われる完全限定ドメイン名。
ipv4Address	string	エンドポイントに関連付けられたIPv4アドレスです。
ipv6Address	string	エンドポイントに関連付けられたIPv6アドレスです。
name	string	エンドポイントの種類(例:VIPやホスト)を識別する名前です。

AccessBridgeProvisioningState

列挙

アクセスブリッジのプロビジョニング状態。

値	説明
Accepted	受け入れステータス。
Canceled	キャンセル状態。
Failed	失敗者の状態。
Provisioning	プロビジョニングの状態。
Succeeded	成功者ステータス。

AccessBridgeSecurityRule

Object

AccessBridgeSecurityRuleは、ブリッジによって強制される個別アクセスルールをキャプチャします。

名前	型	説明
description	string	このルールについて説明した価値があるとユーザーは述べました。
direction	SecurityRuleDirection	ルールに基づくネットワークトラフィックの方向性が認められました。
ipv4Addresses	string[]	セキュリティルールの送信元または宛先として許可されたIPv4アドレスの集合。単一のアドレスとしては、/32(CIDR表記)を用いてください。 Ipv4アドレスとIPv6アドレスの1つまたは両方を指定する必要があります。例のフォーマット:10.10.10-10.10.10.20 または 10.10.10.10/24。
ipv6Addresses	string[]	セキュリティルールの送信元または宛先として許可されたIPv6アドレスの集合。単一アドレスの場合は/128(CIDR表記)を使用します。 Ipv4アドレスとIPv6アドレスの1つまたは両方を指定する必要があります。例のフォーマット:2001:db8:abcd::1-2001:db8:abcd::ff または 2001:db8:abcd::1/64。
port	string	送信元ポート、宛先ポート、またはポートレンジ。例として24562や24562-24570などがあります。

Azure.ResourceManager.CommonTypes.ExtendedLocation

Object

拡張された場所の複合型。

名前	型	説明
name	string	拡張された場所の名前。
type	ExtendedLocationType	拡張された場所の種類。

createdByType

列挙

リソースを作成した ID の種類。

値	説明
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

リソース管理エラーの追加情報。

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラーコード。
details	ErrorDetail[]	エラーの詳細。
message	string	エラーメッセージ。
target	string	エラーターゲット。

ErrorResponse

Object

エラー応答

名前	型	説明
error	ErrorDetail	エラーオブジェクト。

ExtendedLocationType

列挙

拡張された場所の種類。

値	説明
EdgeZone	Azure Edge ゾーンの場所の種類
CustomLocation	Azure カスタムの場所の種類

SecurityRuleDirection

列挙

ルールに基づくネットワークトラフィックの方向性が認められました。

値	説明
Inbound	オンプレミスクラスターへのインバウンドトラフィック。
Outbound	オンプレミスクラスターからのアウトバウンドトラフィック。

systemData

Object

リソースの作成と最後の変更に関連するメタデータ。

名前	型	説明
createdAt	string (date-time)	リソース作成のタイムスタンプ (UTC)。
createdBy	string	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string (date-time)	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。

TransportProtocol

列挙

アクセスブリッジのエンドポイントが宣伝するプロトコルです。

値	説明
TCP	TCPトランスポートプロトコル。
UDP	UDPトランスポートプロトコル。

次の方法で共有

Access Bridges - Create Or Update

URI パラメーター

要求本文

応答

セキュリティ

azure_auth

スコープ

例

Create or update access bridge

要求のサンプル

応答のサンプル

定義

AccessBridge

AccessBridgeAllowedName

AccessBridgeDetailedStatus

AccessBridgeEndpoint

AccessBridgeProvisioningState

AccessBridgeSecurityRule

Azure.ResourceManager.CommonTypes.ExtendedLocation

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocationType

SecurityRuleDirection

systemData

TransportProtocol