다음을 통해 공유

Azure Operator Nexus Network Fabric의 인터페이스 설명에 사용자 지정 접미사 추가

이 문서에서는 Azure Operator Nexus Network Fabric의 인터페이스 설명에 사용자 정의 접미사(additionalDescription)를 추가하는 방법을 설명합니다. 기본 인터페이스 설명은 읽기 전용이지만 additionalDescription 이 속성은 운영 주석에 대한 향상된 유연성을 제공합니다. 이 방법을 사용하면 사용자가 시스템 생성 설명을 변경하지 않고 특정 유지 관리 또는 운영 요구 사항에 대한 인터페이스 설명을 사용자 지정할 수 있습니다.

필수 조건

  • Azure CLI 버전 2.69 이상이 있습니다.
  • CLI 확장 managednetworkfabric 8.0.0 이상을 설치합니다.

사용자 지정 접미사를 추가하는 단계

1단계: 현재 인터페이스 설명 확인

변경하기 전에 다음 명령을 사용하여 기존 인터페이스 설명을 확인합니다.

az networkfabric interface show -g "example-rg" \
  --network-device-name "example-device" \
  --resource-name "example-interface" --query description

매개 변수 세부 정보:

매개 변수 약식 설명
az networkfabric interface show 해당 없음(N/A) 지정된 네트워크 패브릭 인터페이스의 세부 정보를 표시합니다.
-g, --resource-group -g 네트워크 디바이스가 있는 리소스 그룹의 이름입니다.
--network-device-name 해당 없음(N/A) Azure 운영자 Nexus Network Fabric 디바이스의 이름입니다.
--resource-name 해당 없음(N/A) 네트워크 인터페이스 리소스의 이름입니다.
--query 해당 없음(N/A) 지정된 필드(예 description: )만 표시하도록 출력을 필터링합니다.

2단계: 인터페이스 설명에 접미사 추가

기본 인터페이스 설명(예: AR-CE2(Fab3-AR-CE2):Et1/1 to CR1-TOR1(Fab3-CP1-TOR1)-Port23)은 읽기 전용이며 수정할 수 없습니다. 속성을 사용하여 additional-description 사용자 지정 접미사를 추가할 수 있습니다. 이 방법은 기본 설명이 additional-description 변경되지 않은 상태로 유지되는 동안에만 필드를 업데이트합니다.

사용자 지정 접미사를 추가하려면 다음 명령을 사용합니다.

az networkfabric interface update --additional-description "example-description" \
  --device "example-device" \
  -g "example-resource-group" \
  --resource-name "example-interface"

매개 변수 세부 정보:

매개 변수 설명 제약 조건
--additional-description 인터페이스 업데이트에 대한 추가 설명을 제공합니다. 영숫자(A-Z, a-z, 0-9) -및 _ 허용됩니다. 최대 64자 공백 또는 null이 있는 빈 문자열일 수 있습니다.
--device Azure Operator Nexus Network Fabric 디바이스의 이름을 지정합니다. 특정 제약 조건이 없습니다.
-g, --resource-group 디바이스가 있는 리소스 그룹의 이름을 정의합니다. 특정 제약 조건이 없습니다.
--resource-name 네트워크 인터페이스 리소스의 이름을 나타냅니다. 특정 제약 조건이 없습니다.

3단계: 구성 커밋

설명을 업데이트한 후 패브릭에 변경 내용을 적용합니다.

az networkfabric fabric commit-configuration --resource-group "example-rg" --resource-name "example-fabric"

매개 변수 세부 정보:

매개 변수 약식 설명
--resource-group -g 리소스 그룹의 이름
--resource-name 해당 없음(N/A) Azure 운영자 Nexus Network Fabric 리소스의 이름

예시

원래 인터페이스 설명

AR-CE2(Fab3-AR-CE2):Et1/1 to CR1-TOR1(Fab3-CP1-TOR1)-Port23

업데이트된 설명

AR-CE2(Fab3-AR-CE2):Et1/1 to CR1-TOR1(Fab3-CP1-TOR1)-Port23-Additional_description-1234

사용자 지정 접미사를 제거하는 단계

1단계: 인터페이스 설명 제거

기본 설명을 복원하려면 공백(additionalDescription) 또는 null이 있는 빈 문자열로 설정합니다" ".

az networkfabric interface update --additional-description "example-description" \
  --device "example-device" \
  -g "example-resource-group" \
  --resource-name "example-interface"

매개 변수 세부 정보:

매개 변수 설명 제약 조건
--additional-description 인터페이스 업데이트에 대한 추가 설명을 제공합니다. 영숫자(A-Z, a-z, 0-9) -및 _ 허용됩니다. 최대 64자 공백 또는 null이 있는 빈 문자열일 수 있습니다.
--device Azure Operator Nexus Network Fabric 디바이스의 이름을 지정합니다. 특정 제약 조건이 없습니다.
-g, --resource-group 디바이스가 있는 리소스 그룹의 이름을 정의합니다. 특정 제약 조건이 없습니다.
--resource-name 네트워크 인터페이스 리소스의 이름을 나타냅니다. 특정 제약 조건이 없습니다.

2단계: 구성 커밋

접미사를 제거한 후 패브릭에 변경 내용을 적용합니다.

az networkfabric fabric commit-configuration --resource-group "example-rg" --resource-name "example-fabric"

매개 변수 세부 정보:

매개 변수 약식 설명
--resource-group -g 리소스 그룹의 이름
--resource-name 해당 없음(N/A) Azure 운영자 Nexus Network Fabric 리소스의 이름

커밋이 완료되면 인터페이스 설명이 원래 상태로 되돌아갑니다.

AR-CE2(Fab3-AR-CE2):Et1/1 to CR1-TOR1(Fab3-CP1-TOR1)-Port23

네트워크 인터페이스 업데이트

인터페이스 설명을 표준화하기 위해 네트워크 디바이스의 네트워크 인터페이스를 업데이트했습니다. 또한 이러한 업데이트는 이제 더 나은 관리 및 추적을 위해 연결된 인터페이스의 Azure Resource Manager 리소스 ID에 인터페이스를 연결합니다.

표준화된 인터페이스 설명

인터페이스 설명은 원본 디바이스의 일관된 형식을 따라 대상 디바이스(호스트 이름 및 인터페이스 이름 포함)를 따릅니다.

예시

AR-CE2 (Fab3-AR-CE2): Et1/1 to CR1-TOR1 (Fab3-CP1-TOR1) - Port23

connectedTo 속성

이 속성은 connectedTo 사용 가능한 경우 연결된 인터페이스의 Azure Resource Manager 리소스 ID를 반환합니다.

이전 값과 새 값 비교

예시 이전 값 새 값
예제 1 CR1-TOR1-Port23 /subscriptions/<subscriptionID>/resourceGroups/<resourceGroupName>/providers/Microsoft.ManagedNetworkFabric/networkDevices/fab3nf-CompRack1-TOR1/networkInterfaces/Ethernet23-1
예제 2 AR-CE2 (Fab3-AR-CE2): Et1/1 to CR1-TOR1 (Fab3-CP1-TOR1) - Port23 /subscriptions/<subscriptionID>/resourceGroups/<resourceGroupName>/providers/Microsoft.ManagedNetworkFabric/networkDevices/fab3nf-CompRack1-TOR1/networkInterfaces/Ethernet23-1

지원되는 인터페이스 형식

위의 모든 기능은 다음 인터페이스 형식에 사용할 수 있습니다.

  • Agg Rack 고객 엣지
  • Agg 랙 관리
  • 컴프 랙 상단
  • Comp Rack 관리
  • 네트워크 패킷 브로커 디바이스

비고

Azure 운영자 Nexus Network Fabric이 관리하지 않는 디바이스(예: 공급자 에지 또는 스토리지 디바이스 connectedTo )의 경우 속성은 활성 링크가 없는 것처럼 string 값을 계속 반영합니다.