Connectivity Configurations - Create Or Update

새 네트워크 관리자 연결 구성을 만들거나 업데이트

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkManagers/{networkManagerName}/connectivityConfigurations/{configurationName}?api-version=2022-01-01

URI 매개 변수

Name In Required Type Description
configurationName
path True
  • string

네트워크 관리자 연결 구성의 이름입니다.

networkManagerName
path True
  • string

네트워크 관리자의 이름입니다.

resourceGroupName
path True
  • string

리소스 그룹의 이름.

subscriptionId
path True
  • string

Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명입니다. 구독 ID는 모든 서비스 호출에 대한 URI의 파트를 형성합니다.

api-version
query True
  • string

클라이언트 API 버전입니다.

요청 본문

Name Required Type Description
properties.appliesToGroups True

구성을 위한 그룹

properties.connectivityTopology True

연결 토폴로지 유형입니다.

properties.deleteExistingPeering

현재 기존 피어링을 제거해야 하는 경우 플래그를 지정합니다.

properties.description
  • string

연결 구성에 대한 설명입니다.

properties.hubs

hubItems 목록

properties.isGlobal

전역 메시가 지원되는 경우 플래그를 지정합니다.

응답

Name Type Description
200 OK

업데이트에 성공했습니다. 이 작업은 결과 네트워크 관리자 연결 구성을 반환합니다.

201 Created

성공적으로 만듭니다. 이 작업은 결과 네트워크 관리자 연결 구성을 반환합니다.

Other Status Codes

작업이 실패한 이유를 설명하는 리소스 공급자 오류 응답입니다.

보안

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 사용자 계정 가장

예제

ConnectivityConfigurationsPut

Sample Request

PUT https://management.azure.com/subscriptions/subscriptionA/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkManagers/testNetworkManager/connectivityConfigurations/myTestConnectivityConfig?api-version=2022-01-01

{
  "properties": {
    "description": "Sample Configuration",
    "connectivityTopology": "HubAndSpoke",
    "hubs": [
      {
        "resourceId": "subscriptions/subscriptionA/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myTestConnectivityConfig",
        "resourceType": "Microsoft.Network/virtualNetworks"
      }
    ],
    "deleteExistingPeering": "True",
    "isGlobal": "True",
    "appliesToGroups": [
      {
        "networkGroupId": "subscriptions/subscriptionA/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkManagers/testNetworkManager/networkGroups/group1",
        "useHubGateway": "True",
        "groupConnectivity": "None",
        "isGlobal": "False"
      }
    ]
  }
}

Sample Response

{
  "name": "myTestConnectivityConfig",
  "id": "subscriptions/subscriptionA/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkManagers/testNetworkManager/connectivityConfigurations/myTestConnectivityConfig",
  "type": "Microsoft.Network/networkManagers/connectivityConfigurations",
  "systemData": {
    "createdBy": "b69a9388-9488-4534-b470-7ec6d41beef5",
    "createdByType": "User",
    "createdAt": "2021-01-11T18:52:27Z",
    "lastModifiedBy": "b69a9388-9488-4534-b470-7ec6d41beef5",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-01-11T18:52:27Z"
  },
  "properties": {
    "description": "Sample Connectivity Configuration",
    "connectivityTopology": "HubAndSpoke",
    "hubs": [
      {
        "resourceId": "subscriptions/subscriptionA/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myTestConnectivityConfig",
        "resourceType": "Microsoft.Network/virtualNetworks"
      }
    ],
    "deleteExistingPeering": "True",
    "isGlobal": "True",
    "appliesToGroups": [
      {
        "networkGroupId": "subscriptions/subscriptionA/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkManagers/testNetworkManager/groups/group1",
        "useHubGateway": "True",
        "groupConnectivity": "None",
        "isGlobal": "False"
      }
    ],
    "provisioningState": "Succeeded"
  }
}
{
  "name": "myTestConnectivityConfig",
  "id": "subscriptions/subscriptionA/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkManagers/testNetworkManager/connectivityConfigurations/myTestConnectivityConfig",
  "type": "Microsoft.Network/networkManagers/connectivityConfigurations",
  "systemData": {
    "createdBy": "b69a9388-9488-4534-b470-7ec6d41beef5",
    "createdByType": "User",
    "createdAt": "2021-01-11T18:52:27Z",
    "lastModifiedBy": "b69a9388-9488-4534-b470-7ec6d41beef5",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-01-11T18:52:27Z"
  },
  "properties": {
    "description": "Sample Configuration",
    "connectivityTopology": "HubAndSpoke",
    "hubs": [
      {
        "resourceId": "subscriptions/subscriptionA/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myTestConnectivityConfig",
        "resourceType": "Microsoft.Network/virtualNetworks"
      }
    ],
    "deleteExistingPeering": "True",
    "isGlobal": "True",
    "appliesToGroups": [
      {
        "networkGroupId": "subscriptions/subscriptionA/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkManagers/testNetworkManager/networkGroups/group1",
        "useHubGateway": "True",
        "groupConnectivity": "None",
        "isGlobal": "False"
      }
    ],
    "provisioningState": "Succeeded"
  }
}

정의

CloudError

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

CloudErrorBody

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

ConnectivityConfiguration

네트워크 관리자 연결 구성 리소스

connectivityGroupItem

연결 그룹 항목입니다.

ConnectivityTopology

연결 토폴로지 유형입니다.

createdByType

리소스를 만든 ID의 형식입니다.

DeleteExistingPeering

현재 기존 피어링을 제거해야 하는 경우 플래그를 지정합니다.

GroupConnectivity

그룹 연결 유형입니다.

Hub

허브 항목입니다.

IsGlobal

전역 메시가 지원되는 경우 플래그를 지정합니다.

ProvisioningState

현재 프로비전 상태입니다.

SystemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

UseHubGateway

허브 게이트웨이를 사용해야 하는 경우 플래그를 지정합니다.

CloudError

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

Name Type Description
error

클라우드 오류 본문입니다.

CloudErrorBody

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

Name Type Description
code
  • string

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

details

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

message
  • string

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

target
  • string

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

ConnectivityConfiguration

네트워크 관리자 연결 구성 리소스

Name Type Description
etag
  • string

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

id
  • string

리소스 ID입니다.

name
  • string

리소스 이름입니다.

properties.appliesToGroups

구성을 위한 그룹

properties.connectivityTopology

연결 토폴로지 유형입니다.

properties.deleteExistingPeering

현재 기존 피어링을 제거해야 하는 경우 플래그를 지정합니다.

properties.description
  • string

연결 구성에 대한 설명입니다.

properties.hubs

hubItems 목록

properties.isGlobal

전역 메시가 지원되는 경우 플래그를 지정합니다.

properties.provisioningState

연결 구성 리소스의 프로비전 상태입니다.

systemData

이 리소스와 관련된 시스템 메타데이터입니다.

type
  • string

리소스 종류.

connectivityGroupItem

연결 그룹 항목입니다.

Name Type Description
groupConnectivity

그룹 연결 유형입니다.

isGlobal

전역이 지원되는 경우 플래그를 지정합니다.

networkGroupId
  • string

네트워크 그룹 ID입니다.

useHubGateway

허브 게이트웨이를 사용해야 하는 경우 플래그를 지정합니다.

ConnectivityTopology

연결 토폴로지 유형입니다.

Name Type Description
HubAndSpoke
  • string
Mesh
  • string

createdByType

리소스를 만든 ID의 형식입니다.

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

DeleteExistingPeering

현재 기존 피어링을 제거해야 하는 경우 플래그를 지정합니다.

Name Type Description
False
  • string
True
  • string

GroupConnectivity

그룹 연결 유형입니다.

Name Type Description
DirectlyConnected
  • string
None
  • string

Hub

허브 항목입니다.

Name Type Description
resourceId
  • string

리소스 ID입니다.

resourceType
  • string

리소스 종류입니다.

IsGlobal

전역 메시가 지원되는 경우 플래그를 지정합니다.

Name Type Description
False
  • string
True
  • string

ProvisioningState

현재 프로비전 상태입니다.

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

SystemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

Name Type Description
createdAt
  • string

리소스 만들기의 타임스탬프(UTC)입니다.

createdBy
  • string

리소스를 만든 ID입니다.

createdByType

리소스를 만든 ID의 형식입니다.

lastModifiedAt
  • string

리소스를 마지막으로 수정한 ID의 형식입니다.

lastModifiedBy
  • string

리소스를 마지막으로 수정한 ID입니다.

lastModifiedByType

리소스를 마지막으로 수정한 ID의 형식입니다.

UseHubGateway

허브 게이트웨이를 사용해야 하는 경우 플래그를 지정합니다.

Name Type Description
False
  • string
True
  • string