Connectivity Configurations - Create Or Update

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

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

URI 매개 변수

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

connectivityGroupItem[]

구성을 위한 그룹

properties.connectivityTopology True

ConnectivityTopology

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

properties.deleteExistingPeering

DeleteExistingPeering

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

properties.description

string

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

properties.hubs

Hub[]

hubItems 목록

properties.isGlobal

IsGlobal

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

응답

Name 형식 Description
200 OK

ConnectivityConfiguration

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

201 Created

ConnectivityConfiguration

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

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

예제

ConnectivityConfigurationsPut

Sample Request

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkManagers/testNetworkManager/connectivityConfigurations/myTestConnectivityConfig?api-version=2023-09-01

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

Sample Response

{
  "name": "myTestConnectivityConfig",
  "id": "subscriptions/00000000-0000-0000-0000-000000000000/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/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myTestConnectivityConfig",
        "resourceType": "Microsoft.Network/virtualNetworks"
      }
    ],
    "deleteExistingPeering": "True",
    "isGlobal": "True",
    "appliesToGroups": [
      {
        "networkGroupId": "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkManagers/testNetworkManager/groups/group1",
        "useHubGateway": "True",
        "groupConnectivity": "None",
        "isGlobal": "False"
      }
    ],
    "provisioningState": "Succeeded",
    "resourceGuid": "00000000-0000-0000-0000-000000000000"
  }
}
{
  "name": "myTestConnectivityConfig",
  "id": "subscriptions/00000000-0000-0000-0000-000000000000/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/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myTestConnectivityConfig",
        "resourceType": "Microsoft.Network/virtualNetworks"
      }
    ],
    "deleteExistingPeering": "True",
    "isGlobal": "True",
    "appliesToGroups": [
      {
        "networkGroupId": "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkManagers/testNetworkManager/networkGroups/group1",
        "useHubGateway": "True",
        "groupConnectivity": "None",
        "isGlobal": "False"
      }
    ],
    "provisioningState": "Succeeded",
    "resourceGuid": "00000000-0000-0000-0000-000000000000"
  }
}

정의

Name Description
CloudError

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

CloudErrorBody

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

ConnectivityConfiguration

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

connectivityGroupItem

연결 그룹 항목입니다.

ConnectivityTopology

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

createdByType

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

DeleteExistingPeering

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

GroupConnectivity

그룹 연결 유형입니다.

Hub

허브 항목입니다.

IsGlobal

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

ProvisioningState

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

SystemData

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

UseHubGateway

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

CloudError

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

Name 형식 Description
error

CloudErrorBody

클라우드 오류 본문.

CloudErrorBody

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

Name 형식 Description
code

string

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

details

CloudErrorBody[]

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

message

string

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

target

string

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

ConnectivityConfiguration

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

Name 형식 Description
etag

string

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

id

string

리소스 ID입니다.

name

string

리소스 이름입니다.

properties.appliesToGroups

connectivityGroupItem[]

구성을 위한 그룹

properties.connectivityTopology

ConnectivityTopology

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

properties.deleteExistingPeering

DeleteExistingPeering

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

properties.description

string

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

properties.hubs

Hub[]

hubItems 목록

properties.isGlobal

IsGlobal

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

properties.provisioningState

ProvisioningState

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

properties.resourceGuid

string

이 리소스의 고유 식별자입니다.

systemData

SystemData

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

type

string

리소스 종류.

connectivityGroupItem

연결 그룹 항목입니다.

Name 형식 Description
groupConnectivity

GroupConnectivity

그룹 연결 유형입니다.

isGlobal

IsGlobal

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

networkGroupId

string

네트워크 그룹 ID입니다.

useHubGateway

UseHubGateway

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

ConnectivityTopology

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

Name 형식 Description
HubAndSpoke

string

Mesh

string

createdByType

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

Name 형식 Description
Application

string

Key

string

ManagedIdentity

string

User

string

DeleteExistingPeering

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

Name 형식 Description
False

string

True

string

GroupConnectivity

그룹 연결 유형입니다.

Name 형식 Description
DirectlyConnected

string

None

string

Hub

허브 항목입니다.

Name 형식 Description
resourceId

string

리소스 ID입니다.

resourceType

string

리소스 종류입니다.

IsGlobal

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

Name 형식 Description
False

string

True

string

ProvisioningState

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

Name 형식 Description
Deleting

string

Failed

string

Succeeded

string

Updating

string

SystemData

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

Name 형식 Description
createdAt

string

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

createdBy

string

리소스를 만든 ID입니다.

createdByType

createdByType

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

lastModifiedAt

string

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

lastModifiedBy

string

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

lastModifiedByType

createdByType

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

UseHubGateway

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

Name 형식 Description
False

string

True

string