소개

이 문서에서는 UI와 API를 통해 Cisco Intersight에 태그를 추가하는 데 필요한 단계를 설명합니다.현재 Intersight 웹 포털에서는 모든 객체의 태깅을 지원하지 않습니다(CSCvs3046 참조). 그러나 거의 모든 객체는 API를 통해 태깅할 수 있습니다.

요구 사항 

• 어카운트에 대한 관리자 레벨 액세스
• API 엔드포인트에 대한 액세스(API를 사용하는 경우) 예: iam.Account 엔드포인트

Cisco Intersight 사용자 인터페이스를 통해 태그 업데이트

사전 요구 사항

인증

에서 객체를 업데이트할 계정에 대해 인증되었는지 확인합니다.계정 관리자 역할로 로그인했는지 확인합니다.오른쪽 상단의 이름을 클릭하면 현재 어카운트 이름, 어카운트 ID, 이메일 및 역할이 표시됩니다.

계정 태그 업데이트

1. Intersight 내에서 Gear and Settings를 선택합니다.

2. 설정 창에서 [계정 세부 정보] 탭이 선택되었는지 확인하고 [구성] 단추를 누릅니다.

3. 태그 설정 입력에 원하는 태그를 입력합니다.

참고:이전에 어카운트에서 태그를 사용하지 않은 경우 예측으로 표시되지 않습니다. 괜찮습니다. 태그를 입력한 후 Enter 키를 누르기만 하면 됩니다.태그는 "key:value" 형식(예: 입력한 값 위):

AutoRMAEmail: kmccabe2@cisco.com,sttardy@cisco.com

이렇게 하면 AutoRAMEmail의 키와 kmccabe2@cisco.com,sttardy@cisco.com의 값을 가진 태그가 만들어집니다.

4. Enter 키를 누른 후 저장을 클릭합니다.

6. 이제 계정에 태그가 표시됩니다.

목록 보기에서 업데이트

Intersight의 목록 보기에 표시되는 많은 개체에 태그를 지정할 수 있습니다.예: 서버, 클러스터, 패브릭 인터커넥트, 섀시 등

참고:사전 대응적 RMA 기능의 컨피그레이션에 태그를 사용하는 경우, 위에서 설명한 어카운트 이외의 UI에서 태깅을 지원하는 항목(서버, 패브릭 인터커넥트 등)은 모두 명예가 적용되지 않습니다.사전 대응적 RMA 태그 컨피그레이션에는 아래 단계를 사용하지 마십시오.

1. 지정된 목록 뷰에서 태그를 지정할 항목을 선택합니다.

2. 태그 단추를 누릅니다(3개 기간 옆).

3. 대화 상자에 태그를 입력합니다.

참고:이전에 어카운트에서 태그를 사용하지 않은 경우 예측으로 표시되지 않습니다. 괜찮습니다. 태그를 입력한 후 Enter 키를 누르기만 하면 됩니다.태그는 "key:value" 형식(예: 위에서 입력한 위치):RTP .이렇게 하면 Location 키와 RTP 값이 있는 태그가 생성됩니다.

4. Enter 키를 누른 후 저장을 클릭합니다.

API를 통해 태그 업데이트

사전 요구 사항

인증

계정에 태그를 지정하려는 관리자는 Intersight에 로그인해야 합니다.로그인하면 화면의 오른쪽 상단 모서리가 아래 이미지와 같이 관리자 이름을 표시해야 합니다.

로그인하지 않은 관리자는 아래 이미지에 표시된 대로 이름 대신 로그인이 표시됩니다.

또한 관리자는 태그를 지정할 객체가 포함된 해당 어카운트에 대해 인증되어야 합니다.오른쪽 상단의 이름을 클릭하면 현재 어카운트 이름, 어카운트 ID, 이메일 및 역할이 표시됩니다.

조직 태깅

1. 조직을 위한 개방형 API 문서

조직에 대한 api doc 페이지로 이동합니다.

참고:Connected Virtual Appliance를 사용하는 경우 https://[어플라이언스의 FQDN]/apidocs/apirefs/organization/Organizations/model/대신으로 이동합니다.

2. 갱신할 조직을 식별합니다.

참조는 Intersight API 쿼리 가이드를 참조하십시오.

사용자는 GET 엔드포인트를 사용하여 매개변수 없이 모든 조직을 나열할 수 있습니다.계정에 하나의 출력으로 쉽게 볼 수 있는 조직이 너무 많으면 $select 쿼리 매개 변수를 사용하여 표시된 필드를 제한할 수 있지만 $select 문에 태그를 포함시켜야 합니다. 예:

API 출력에서 필요한 필드는 Moid 필드이며, 이 필드는 Intersight에 있는 이 조직의 고유 식별자이며 다음 단계에서 사용됩니다. 다음 단계에 해당하는 태그도 가져와야 합니다.

4. 조직의 태그 갱신

여기서는 조직 패치 API 엔드포인트를 활용합니다.여기에서는 이전에 moid 입력 필드에 수집된 MOID와 본문 필드 전에 수집된 태그를 사용합니다.

중요:DELETE API를 사용하지 않는지 확인합니다. 이 경우 조직이 삭제됩니다.

위의 샘플 PATCH 호출의 본문:

{"Tags":[{"Key":"AutoRMAEmail","Value":"joe@somedomain.com"}]}

등록된 모든 기존 태그를 태그 배열에 추가할 수 있습니다.

참고:사전 대응적 RMA를 구성하기 위해 이 절차를 따르는 경우 여기에 있는 이메일 주소는 CCO 어카운트와 관련이 있어야 합니다.

등록된 디바이스 태그 지정

1. 등록된 디바이스에 대한 개방형 API 문서

등록된 디바이스의 API 문서 페이지로 이동합니다.

참고:Connected Virtual Appliance를 사용하는 경우 https://[어플라이언스의 FQDN]/apidocs/apirefs/asset/DeviceRegistrations/model/대신으로 이동합니다.

2. 업데이트해야 하는 등록된 디바이스를 식별합니다.

참조는 Intersight API 쿼리 가이드를 참조하십시오.

가장 쉽게 쿼리할 수 있는 방법 중 하나는 호스트 이름으로 쿼리하는 것입니다. 이렇게 하려면 다음과 같이 쿼리를 만들 수 있습니다.

DeviceHostname eq 'F340-21-22-UCS4'

$filter와 $select를 활용하여 보다 관리하기 쉬운 결과를 볼 수 있습니다.

3. PATCH API를 사용하여 태그를 갱신합니다.

등록된 디바이스와 디바이스의 moid에 이미 있는 태그를 모두 추출합니다.PATCH 엔드포인트에 재전송하고, 위쪽 moid 항목의 Moid에 붙여넣습니다. 예:

위의 샘플 PATCH 호출의 본문:

{"Tags":[{"Key":"AutoRMAEmail","Value":"joe@somedomain.com"}]}

등록된 모든 기존 태그를 태그 배열에 추가할 수 있습니다.

참고:사전 대응적 RMA를 구성하기 위해 이 절차를 따르는 경우 여기에 있는 이메일 주소는 CCO 어카운트와 관련이 있어야 합니다.