클라우드 컴퓨팅 장치에 대한 API 쿼리 정의

릴리스 버전: Washingtondc

업데이트 날짜 2024년 02월 01일

읽기4분

검색 패턴의 생성 또는 수정의 일부로 클라우드 REST 호출 작업을 사용하여 Microsoft Azure 또는 Amazon Web Services와 같은 PaaS(서비스형 플랫폼) 유형의 구성 항목에서 정보를 추출할 수 있습니다.

시작하기 전에

필요한 역할: pd_admin

클라우드 REST 호출 작업을 사용하려는 CI(구성 항목)의 운영 체제가 논리적 데이터센터 OS 유형 [cmdb_ci_logical_datacenter]를 확장하는지 확인하십시오.
1. CI 패턴의 기본 탭으로 이동합니다.
2. 이 CI의 운영 체제를 기록해둡니다.
3. 다음으로 이동 시스템 정의 > 테이블.
4. 검색 필드를 레이블로 설정하고 패턴의 기본 탭에 명시된 대로 운영 체제의 이름을 입력합니다.
5. 목록에서 운영 체제를 찾고 논리 데이터센터가 테이블 확장 열에 나타나는지 확인합니다.
다음과 같이 관련 패턴 단계로 이동합니다.
1. 패턴 양식에서 검색에 대한 관련 식별 섹션을 선택합니다.
  또는 서비스 매핑에 대한 관련 식별 또는 연결 섹션을 선택합니다.
2. 관련 패턴 단계를 선택하거나 을 클릭하여 단계를 추가합니다.

프로그래밍에 대한 기본 지식이 있는 것이 좋습니다.

이 태스크 정보

PaaS CI 검색에 사용되는 패턴으로 클라우드 REST 호출 작업을 배포합니다.

클라우드 REST 호출 작업을 사용하여 쿼리할 장치의 쿼리 구문을 얻으려면 제조업체에서 제공한 공식적인 API 관련 설명서를 참조하십시오. 예:

프로시저

작업 목록에서 클라우드 REST 호출을 선택합니다.

필요에 따라 쿼리 매개변수를 정의합니다.

경고:

이 작업을 패턴 작업 사용자 지정에 설명한 대로 사용자 지정한 경우 쿼리 매개변수가 다를 수 있습니다.


필드	설명
URL	공식 Microsoft Azure 또는 Amazon Web Services 설명서에 설명된 대로 URL을 지정합니다. 변수를 사용할 수 있습니다. 변수를 사용할 수 있습니다. 패턴에 값과 변수 입력에 설명된 대로 테이블 유형 변수에 있는 특정 필드의 값을 입력할 수도 있습니다.
메서드	"GET"과 같이 모두 대문자인 문자열로 메서드 값을 입력합니다. 지원되는 메서드는 다음과 같습니다. GET 게시 PUT 자세한 내용은 관련 API 가이드를 참조하십시오. API 설명서에서 HTTP 쿼리 메서드를 구체적으로 언급한 경우 GET 메서드를 사용합니다.
본문	(옵션) 요청 본문을 문자열로 입력합니다. 문자열에 따옴표가 포함되어 있으면 따옴표 앞에 백슬래시 기호를 사용하여 문자열이 따옴표로 끝나지 않음을 나타냅니다.
머리글	(옵션) 관련 API 설명서에 HTTP 헤더를 보내야 한다고 나와 있는 경우 다음 형식으로 헤더를 입력합니다. Header_name1:header_value1,header_name2:header_value2 예를 들어 `Content-Type:xml`을 입력합니다.

명령 출력 전체를 변수로 저장하려면 구문 분석 정의 목록에서 없음을 선택하고 6에 설명된 대로 변수를 정의합니다.

구문 분석 정의 목록에서 구문 분석 전략을 선택합니다.


구문 분석 전략	설명
Oracle LDAP 파일 XML 파일 INI 파일 속성 파일 JSON 파일(사용자 지정)	가로 파일 구문 분석 전략(세로 아님) 이 구문 분석 전략은 텍스트 파일에만 사용할 수 있습니다. 자세한 내용은 가로 파일의 텍스트 구문 분석 문서를 참조하십시오.
세로 파일	각 데이터 집합이 여러 라인에 걸쳐 있는 구조적 텍스트 파일에서 텍스트를 검색합니다. 자세한 내용은 세로 파일의 텍스트 구문 분석 문서를 참조하십시오.
키워드 뒤	특정 키워드 바로 다음에 나오는 텍스트를 검색합니다. 자세한 내용은 키워드, 명령 및 위치 유형을 사용하여 텍스트 구문 분석 문서를 참조하십시오.
명령줄 Java 스타일	Java 스타일 매개변수를 사용하여 명령줄 매개변수의 값을 검색합니다. 자세한 내용은 키워드, 명령 및 위치 유형을 사용하여 텍스트 구문 분석 문서를 참조하십시오.
명령줄 Unix 스타일	표준 Unix 매개변수를 사용하여 명령줄 매개변수의 값을 검색합니다. 자세한 내용은 키워드, 명령 및 위치 유형을 사용하여 텍스트 구문 분석 문서를 참조하십시오.
끝에서의 위치	라인의 끝에서 위치로 지정된 텍스트 위치를 검색합니다. 자세한 내용은 키워드, 명령 및 위치 유형을 사용하여 텍스트 구문 분석 문서를 참조하십시오.
시작에서의 위치	라인의 시작에서 위치로 지정된 텍스트를 검색합니다. 자세한 내용은 키워드, 명령 및 위치 유형을 사용하여 텍스트 구문 분석 문서를 참조하십시오.
정규 표현식	정규 표현식으로 지정된 텍스트를 검색합니다. 이 옵션을 사용하려면 Regex Java 구문을 잘 알고 있어야 합니다. 자세한 내용은 정규식을 사용하여 텍스트 구문 분석 문서를 참조하십시오.
구분 텍스트	구분 기호와 라인 내의 위치로 지정된 텍스트를 검색합니다(일반 텍스트 파일에서 텍스트를 검색하는 가장 일반적인 방법). 구분 텍스트를 사용하여 텍스트 구문 분석 문서를 참조하십시오.

디버그 모드에서 작업하는 경우 다음과 같이 구문 분석 조건을 정의합니다.
1. 작업 실행을 클릭하여 출력 창에서 결과를 봅니다.
2. 출력 창에서 변수에 포함할 텍스트나 기호를 표시합니다.
3. 변수 이름 상자에 새 변수의 이름(예: 'process_name')을 입력합니다.
4. Enter 키를 누릅니다.
  새 변수가 변수 창에 추가됩니다.
디버그 모드에서 작업하지 않는 경우 다음 단계를 수행하여 구문 분석 조건을 정의합니다.
1. 변수 창에서 변수 추가를 클릭하고 새 변수의 이름을 입력합니다.
2. 고급 아이콘을 클릭합니다.
3. 열 레이블 추가를 클릭합니다.
4. 구문 분석 쿼리를 입력합니다.
5. 구분 기호 값을 입력합니다.
6. 위치 값을 입력합니다.
결과가 없는 경우 종료를 선택하여 검색을 중지합니다.
디버그 모드인 경우 테스트를 클릭하고 작업이 원하는 결과를 표시하는지 확인하여 단계를 테스트합니다.

예

이 작업은 다음에서 사용됩니다.	운영이 사용되는 항목
계층 구조	애플리케이션
CI 유형	부하 분산 장치 서비스 [cmdb_ci_lb_service]
패턴	Amazon AWS Elastic Load Balancer Service
섹션	AWS Load Balancer 서비스
단계 번호 및 이름	2. 처음 100개 RDS 인스턴스 가져오기

클라우드 REST 호출 작업을 사용하여 Amazon 클라우드의 us-west-2 리전에서 실행 중인 데이터베이스 인스턴스에 대한 정보를 추출합니다.

다음에 수행할 작업

새 단계를 추가하고 해당 작업을 정의하여 패턴을 계속 편집합니다.
패턴을 완성합니다.