vRealize Business for Cloud에서는 기본 보고서 집합을 내보낼 수 있습니다. 뿐만 아니라 필요에 맞게 이러한 기본 보고서에 기반하여 사용자 지정된 보고서를 생성하고 내보낼 수 있습니다.
프로시저
- vRealize Business for Cloud 가상 장치에 로그인합니다.
- 설정을 기반으로 다음 명령 중 하나를 실행하여 토큰을 생성합니다.
vRealize Automation 통합 vRealize Business for Cloud 설정의 경우
wget --no-check-certificate -S -q --header "Accept: application/json" --header='Content-Type: application/json' --post-data '{"username":"USER_NAME","password":"PASSWORD","tenant":"TENANT"}' -output-document - vRA_SERVER/identity/api/tokens
여기서,
USER_NAME은 vRealize Business for Cloud에 액세스하기 위한 관리자 사용 권한이 있는 사용자 이름입니다.
PASSWORD는 관리자 계정에 대한 암호입니다.
TENANT는 vRealize Business for Cloud 등록된 테넌트입니다.
vRA_SERVER는 vRealize Automation 서버의 IP 주소 또는 FQDN입니다.
VMware Identity Manager 통합 vRealize Business for Cloud 설정의 경우
curl -k -X POST -H "Authorization:Basic CODE" https://vIDM_SERVER/SAAS/API/1.0/oauth2/token?grant_type=client_credentials
여기서,
CODE는
Base64(client_id:client_secret)
입니다.vIDM_SERVER는 VMware Identity Manager 서버의 IP 주소 또는 FQDN입니다.
참고:https://www.base64encode.org/를 사용하여 기본 인증 헤더의 Base64를 생성할 수 있습니다. /server/conf/itfm-oauth.properties에서
client_id
및client_secret
값을 가져올 수도 있습니다.출력에 토큰이 표시됩니다. 예를 들면 다음과 같습니다.
{"access_token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJqdGkiOiIyYzJlZDRjMi0wYjcyLTQ5MDYtODE3MC0wYzhjYjUzNjJjNTMiLCJwcm4iOiJ2cmJfb2F1dGhfY2xpZW50aWRfYzk5ODUzYzYtMmY5MC00OTMwLWI2ZjktYzJjM2U3YmQ5Nzk5QEJMUi1WMTQ0LUlQLTE4NCIsImRvbWFpbiI6IlN5c3RlbSBEb21haW4iLCJ1c2VyX2lkIjoiMTkwIiwiYXV0aF90aW1lIjoxNTUzMjAyMDExLCJpc3MiOiJodHRwczovL2Jsci12MTQ0LWlwLTE4NC5lbmcudm13YXJlLmNvbS9TQUFTL2F1dGgiLCJhdWQiOiJodHRwczovL2Jsci12MTQ0LWlwLTE4NC5lbmcudm13YXJlLmNvbS9TQUFTL2F1dGgvb2F1dGh0b2tlbiIsImN0eCI6Ilt7XCJtdGRcIjpcInVybjpvYXNpczpuYW1lczp0YzpTQU1MOjIuMDphYzpjbGFzc2VzOlBhc3N3b3JkUHJvdGVjdGVkVHJhbnNwb3J0XCIsXCJpYXRcIjoxNTUzMjAyMDExLFwiaWRcIjoxNX1dIiwic2NwIjoib3BlbmlkIGFkbWluIHVzZXIiLCJpZHAiOiIwIiwiZW1sIjoiT0F1dGhDbGllbnRfdnJiX29hdXRoX2NsaWVudGlkX2M5OTg1M2M2MmY5MDQ5MzBiNmY5YzJjM2U3YmQ5Nzk5QG5vcmVwbHkuY29tIiwiY2lkIjoidnJiX29hdXRoX2NsaWVudGlkX2M5OTg1M2M2LTJmOTAtNDkzMC1iNmY5LWMyYzNlN2JkOTc5OSIsImRpZCI6IiIsIndpZCI6IiIsInJ1bGVzIjp7ImV4cGlyeSI6MTU1MzIzMDgxMSwicnVsZXMiOlt7InJlc291cmNlcyI6WyIqIl0sImFjdGlvbnMiOlsiKiJdLCJjb25kaXRpb25zIjpudWxsfV0sImxpbmsiOm51bGx9LCJleHAiOjE1NTMyMzA4MTEsImlhdCI6MTU1MzIwMjAxMSwic3ViIjoiMzU3OTEyZGMtYWJkZS00YjIwLWI1MGQtY2I5ZDhhZmRiZTQ4IiwicHJuX3R5cGUiOiJTRVJWSUNFIn0.TEsB5mkpXED7VzuhiL66I4ls6cEYsWUcq_iKetDmTFxi8xQXr56uDChOBQtUerGkDXdKht6QflVd86BtqOTyBKYr8ndlD14DqujhRHq3aB5HmFA4jVB-vr7nhJNzpCHwD1BKWwjyTvCdMccYC-vwpCHx_dcEdbJiqdpejJPJfNbsN8MITUQtk_yk2ia3fkrBRt8Pv_VPm-xYIC_qHumaEiompB_iRLk3AfnZgx7yhdv3yarGrocFWKsizvpRbfFsf3T3EPIzACV_bGoX-syvGW9sdEjWlsBidSNRTgdOTaikIwoW1cyc3WbMeThIx7PeRop_Z-DB5a0yvL6uWfWNtw","token_type":"Bearer","expires_in":28799,"scope":"openid admin user","id_token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6IjE1NDkzNjI4MzYifQ.eyJ1cGRhdGVkX2F0IjowLCJleHAiOjE1NTMyMDIxMzEsImlhdCI6MTU1MzIwMjAxMSwic3ViIjoidnJiX29hdXRoX2NsaWVudGlkX2M5OTg1M2M2LTJmOTAtNDkzMC1iNmY5LWMyYzNlN2JkOTc5OUBCTFItVjE0NC1JUC0xODQiLCJpc3MiOiJodHRwczovL2Jsci12MTQ0LWlwLTE4NC5lbmcudm13YXJlLmNvbS9TQUFTL2F1dGgiLCJhdWQiOlsidnJiX29hdXRoX2NsaWVudGlkX2M5OTg1M2M2LTJmOTAtNDkzMC1iNmY5LWMyYzNlN2JkOTc5OSJdLCJhdXRoX3RpbWUiOjE1NTMyMDIwMTEsImF6cCI6InZyYl9vYXV0aF9jbGllbnRpZF9jOTk4NTNjNi0yZjkwLTQ5MzAtYjZmOS1jMmMzZTdiZDk3OTkiLCJhdF9oYXNoIjoicGR6ajhEX2kyVUt2bWc1YWlSRnVUdyJ9.LD0SOVvPhxUno06ATZyE1__MI0xNcgzdR9JTT2yxBkaWf3x11nKijfaasTClgGy4llo0FJezmYAQkuCese3ge2Ub2ZBOHZ9bN98yjVXzQ5BzLZarImD727YYUiauB-pPmyvjaW-K2QH7-bIAQ8OMO0gxP_cYuol61oo9N3hwU4ocJqg2M-ir_B3PHUG5S0Ads2tlrmoObuYQ_YeMhSMyBGKCQuqgjU_Eva3PoaEaDRCRiffDVYCc0CHw08Qcb6PtcoHaltWlhWm93gBrUw4fHZKhMspapuLVFBZF7jZF56D9JJR-M2w2LiZYRRg-a_97wZ9MO810ASbFfehB__LspQ"}
access_token 값은 인증할 토큰입니다.
"eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJqdGkiOiIyYzJlZDRjMi0wYjcyLTQ5MDYtODE3MC0wYzhjYjUzNjJjNTMiLCJwcm4iOiJ2cmJfb2F1dGhfY2xpZW50aWRfYzk5ODUzYzYtMmY5MC00OTMwLWI2ZjktYzJjM2U3YmQ5Nzk5QEJMUi1WMTQ0LUlQLTE4NCIsImRvbWFpbiI6IlN5c3RlbSBEb21haW4iLCJ1c2VyX2lkIjoiMTkwIiwiYXV0aF90aW1lIjoxNTUzMjAyMDExLCJpc3MiOiJodHRwczovL2Jsci12MTQ0LWlwLTE4NC5lbmcudm13YXJlLmNvbS9TQUFTL2F1dGgiLCJhdWQiOiJodHRwczovL2Jsci12MTQ0LWlwLTE4NC5lbmcudm13YXJlLmNvbS9TQUFTL2F1dGgvb2F1dGh0b2tlbiIsImN0eCI6Ilt7XCJtdGRcIjpcInVybjpvYXNpczpuYW1lczp0YzpTQU1MOjIuMDphYzpjbGFzc2VzOlBhc3N3b3JkUHJvdGVjdGVkVHJhbnNwb3J0XCIsXCJpYXRcIjoxNTUzMjAyMDExLFwiaWRcIjoxNX1dIiwic2NwIjoib3BlbmlkIGFkbWluIHVzZXIiLCJpZHAiOiIwIiwiZW1sIjoiT0F1dGhDbGllbnRfdnJiX29hdXRoX2NsaWVudGlkX2M5OTg1M2M2MmY5MDQ5MzBiNmY5YzJjM2U3YmQ5Nzk5QG5vcmVwbHkuY29tIiwiY2lkIjoidnJiX29hdXRoX2NsaWVudGlkX2M5OTg1M2M2LTJmOTAtNDkzMC1iNmY5LWMyYzNlN2JkOTc5OSIsImRpZCI6IiIsIndpZCI6IiIsInJ1bGVzIjp7ImV4cGlyeSI6MTU1MzIzMDgxMSwicnVsZXMiOlt7InJlc291cmNlcyI6WyIqIl0sImFjdGlvbnMiOlsiKiJdLCJjb25kaXRpb25zIjpudWxsfV0sImxpbmsiOm51bGx9LCJleHAiOjE1NTMyMzA4MTEsImlhdCI6MTU1MzIwMjAxMSwic3ViIjoiMzU3OTEyZGMtYWJkZS00YjIwLWI1MGQtY2I5ZDhhZmRiZTQ4IiwicHJuX3R5cGUiOiJTRVJWSUNFIn0.TEsB5mkpXED7VzuhiL66I4ls6cEYsWUcq_iKetDmTFxi8xQXr56uDChOBQtUerGkDXdKht6QflVd86BtqOTyBKYr8ndlD14DqujhRHq3aB5HmFA4jVB-vr7nhJNzpCHwD1BKWwjyTvCdMccYC-vwpCHx_dcEdbJiqdpejJPJfNbsN8MITUQtk_yk2ia3fkrBRt8Pv_VPm-xYIC_qHumaEiompB_iRLk3AfnZgx7yhdv3yarGrocFWKsizvpRbfFsf3T3EPIzACV_bGoX-syvGW9sdEjWlsBidSNRTgdOTaikIwoW1cyc3WbMeThIx7PeRop_Z-DB5a0yvL6uWfWNtw"
참고:토큰에는 만료 시간이 있습니다.
- 원하는 보고서를 가져오는 명령을 실행합니다.
보고서 유형
명령
사용자 지정 보고서
wget --no-check-certificate -S -q --header "Accept: application/json" --header='Content-Type: application/json' --header='Authorization: Bearer <TOKEN>' -O - https://VRB_SERVER/itfm-cloud/rest/reports-api/export-csv?name=REPORT_NAME
. 여기서,VRB_SERVER는 vRealize Business for Cloud 서버의 IP 주소 또는 FQDN입니다.
REPORT_NAME은 사용자 지정 보고서에 대해 제공하는 이름입니다.
기본 보고서
전체 데이터를 내보내려면 다음 명령을 실행합니다.
wget --no-check-certificate -S -q --header "Accept: text/plain" --header='Content-Type: text/plain' --header "accept-encoding: gzip" --header='Authorization: Bearer TOKEN' -O - https://VRB_SERVER/itfm-cloud/rest/reports/export-filters/DEFAULT_REPORT_NAME>>out.xls
. 여기서 DEFAULT_REPORT_NAME은 다음 테이블에 언급된 표준 보고서 이름입니다.보고서 유형
표준 보고서 이름
vCenter Server 보고서
servers
datastores
vsan-datastores
vms
clusters
vCloud Director 보고서
vcd-orgs
vcd-org-vdcs
vcd-vms
vcd-vapps
vcd-cis
vRealize Automation 가상 시스템 보고서
vcac-vms
스토리지 보고서
storage-arrays
storage-luns
AWS 보고서
aws-resources
aws-vms
쇼백(Showback) 보고서
showback-vms
showback-add-svcs
예산 보고서
rest/budget/export
특정 기간에 대한 보고서를 내보내려면 다음 명령을 실행합니다.
wget --no-check-certificate -S -q --header "Accept: text/plain" --header='Content-Type: text/plain' --header "accept-encoding: gzip" --header='Authorization: Bearer <TOKEN>' -O - 'https://VRB_SERVER/itfm-cloud/rest/reports/export-filters/DEFAULT_REPORT_NAME?startmonth=yyyy-mm&&endmonth=yyyy-mm'>>out.xls
. 여기서, DEFAULT_REPORT_NAME은 테이블에 언급된 표준 보고서 이름입니다.startmonth 및 endmonth를 지정하면 vRealize Business for Cloud에서는 startmonth에 지정한 월의 첫째 날부터 endmonth에 지정한 월(이전 달의 마지막 날)까지의 보고서를 생성합니다.
예를 들어
startmonth=2016-02&&endmonth=2016-06
을 입력하면 2월 1일부터 5월 말일까지의 보고서가 내보내집니다.startmonth만 지정하면 vRealize Business for Cloud에서 지정한 월의 첫째 날부터 당월까지의 보고서를 생성합니다.
예를 들어 startmonth=2016-02를 지정하면 2월 1일부터 당월까지의 보고서가 내보내집니다.
endmonth만 지정하면 vRealize Business for Cloud에서는 데이터가 존재하는 월부터 endmonth에 지정한 월(이전 달의 마지막 날까지)까지의 보고서를 생성합니다.
예를 들어 endmonthendmonth=2016-10을 지정하면 9월 말일까지의 보고서가 내보내집니다.
참고:vCenter Server 가상 시스템 보고서(vms), vRealize Automation 가상 시스템 보고서(vcac-vms), AWS 보고서(aws-vms, aws-resources) 및 쇼백(Showback) 보고서(showback-vms, showback-add-svcs)에 대한 기간을 지정할 수 있습니다 특정 기간에 대한 vCloud Director 및 예산 보고서는 생성할 수 없습니다.
내보내는 보고서는 CSV 또는 XLS 형식입니다.
조직 수준의 vCloud Director 데이터
wget --no-check-certificate -S -q --header "Accept: application/json" --header='Content-Type: application/json' --header "accept-encoding: gzip" --header='Authorization: Bearer <TOKEN>' -O - https://VRB_SERVER/itfm-cloud/rest/reports/v1/vcd/organization?month=01.MM.YYYY
VRB_SERVER는 vRealize Business for Cloud 서버의 IP 주소 또는 FQDN입니다.
01.MM.YYYY는 보고서를 원하는 월을 지정하는 매개 변수입니다. 이 매개 변수에서는 월과 연도 값만 수정할 수 있습니다. 날짜 값은 01이어야 합니다. 예를 들면 01.02.2017과 같습니다. 명령에 ?month=01.MM.YYYY 매개 변수를 포함하지 않으면 보고서에 당월의 월간 누계 세부 정보가 생성됩니다.
특정 조직에 관련된 vCloud Director 데이터
wget --no-check-certificate -S -q --header "Accept: application/json" --header='Content-Type: application/json' --header "accept-encoding: gzip" --header='Authorization: Bearer <TOKEN>' -O - https://VRB_SERVER/itfm-cloud/rest/reports/v1/vcd/organization/{orgId}?month=01.MM.YYYY
VRB_SERVER는 vRealize Business for Cloud 서버의 IP 주소 또는 FQDN입니다.
01.MM.YYYY는 보고서를 원하는 월을 지정하는 매개 변수입니다. 이 매개 변수에서는 월과 연도 값만 수정할 수 있습니다. 날짜 값은 01이어야 합니다. 예를 들면 01.02.2017과 같습니다. 명령에 ?month=01.MM.YYYY 매개 변수를 포함하지 않으면 보고서에 당월의 월간 누계 세부 정보가 생성됩니다.
조직 vDC 수준의 vCloud Director 데이터
wget --no-check-certificate -S -q --header "Accept: application/json" --header='Content-Type: application/json' --header "accept-encoding: gzip" --header='Authorization: Bearer <TOKEN>' -O - https://VRB_SERVER/itfm-cloud/rest/reports/v1/vcd/orgVdc?month=01.MM.YYYY
VRB_SERVER는 vRealize Business for Cloud 서버의 IP 주소 또는 FQDN입니다.
01.MM.YYYY는 보고서를 원하는 월을 지정하는 매개 변수입니다. 이 매개 변수에서는 월과 연도 값만 수정할 수 있습니다. 날짜 값은 01이어야 합니다. 예를 들면 01.02.2017과 같습니다. 명령에 ?month=01.MM.YYYY 매개 변수를 포함하지 않으면 보고서에 당월의 월간 누계 세부 정보가 생성됩니다.
특정 조직 vDC에 관련된 vCloud Director 데이터
wget --no-check-certificate -S -q --header "Accept: application/json" --header='Content-Type: application/json' --header "accept-encoding: gzip" --header='Authorization: Bearer <TOKEN>' -O - https://VRB_SERVER/itfm-cloud/rest/reports/v1/vcd/orgVdc/{orgVdcId}?month=01.mm.yyyy
VRB_SERVER는 vRealize Business for Cloud 서버의 IP 주소 또는 FQDN입니다.
01.MM.YYYY는 보고서를 원하는 월을 지정하는 매개 변수입니다. 이 매개 변수에서는 월과 연도 값만 수정할 수 있습니다. 날짜 값은 01이어야 합니다. 예를 들면 01.02.2017과 같습니다. 명령에 ?month=01.MM.YYYY 매개 변수를 포함하지 않으면 보고서에 당월의 월간 누계 세부 정보가 생성됩니다.
vApp 수준의 vCloud Director 데이터
wget --no-check-certificate -S -q --header "Accept: application/json" --header='Content-Type: application/json' --header "accept-encoding: gzip" --header='Authorization: Bearer <TOKEN>' -O - https://VRB_SERVER/itfm-cloud/rest/reports/v1/vcd/vapp?month=01.MM.YYYY
VRB_SERVER는 vRealize Business for Cloud 서버의 IP 주소 또는 FQDN입니다.
01.MM.YYYY는 보고서를 원하는 월을 지정하는 매개 변수입니다. 이 매개 변수에서는 월과 연도 값만 수정할 수 있습니다. 날짜 값은 01이어야 합니다. 예를 들면 01.02.2017과 같습니다. 명령에 ?month=01.MM.YYYY 매개 변수를 포함하지 않으면 보고서에 당월의 월간 누계 세부 정보가 생성됩니다.
특정 vApp에 관련된 vCloud Director 데이터
wget --no-check-certificate -S -q --header "Accept: application/json" --header='Content-Type: application/json' --header "accept-encoding: gzip" --header='Authorization: Bearer <TOKEN>' -O - https://VRB_SERVER/itfm-cloud/rest/reports/v1/vcd/vapp/{vappId}?month=01.MM.YYYY
VRB_SERVER는 vRealize Business for Cloud 서버의 IP 주소 또는 FQDN입니다.
01.MM.YYYY는 보고서를 원하는 월을 지정하는 매개 변수입니다. 이 매개 변수에서는 월과 연도 값만 수정할 수 있습니다. 날짜 값은 01이어야 합니다. 예를 들면 01.02.2017과 같습니다. 명령에 ?month=01.MM.YYYY 매개 변수를 포함하지 않으면 보고서에 당월의 월간 누계 세부 정보가 생성됩니다.
VM 수준의 vCloud Director 데이터
wget --no-check-certificate -S -q --header "Accept: application/json" --header='Content-Type: application/json' --header "accept-encoding: gzip" --header='Authorization: Bearer <TOKEN>' -O - https://VRB_SERVER/itfm-cloud/rest/reports/v1/vcd/vm?month=01.MM.YYYY
VRB_SERVER는 vRealize Business for Cloud 서버의 IP 주소 또는 FQDN입니다.
01.MM.YYYY는 보고서를 원하는 월을 지정하는 매개 변수입니다. 이 매개 변수에서는 월과 연도 값만 수정할 수 있습니다. 날짜 값은 01이어야 합니다. 예를 들면 01.02.2017과 같습니다. 명령에 ?month=01.MM.YYYY 매개 변수를 포함하지 않으면 보고서에 당월의 월간 누계 세부 정보가 생성됩니다.
특정 VM에 관련된 vCloud Director 데이터
wget --no-check-certificate -S -q --header "Accept: application/json" --header='Content-Type: application/json' --header "accept-encoding: gzip" --header='Authorization: Bearer <TOKEN>' -O - https://VRB_SERVER/itfm-cloud/rest/reports/v1/vcd/vm?month=01.MM.YYYY
VRB_SERVER는 vRealize Business for Cloud 서버의 IP 주소 또는 FQDN입니다.
01.MM.YYYY는 보고서를 원하는 월을 지정하는 매개 변수입니다. 이 매개 변수에서는 월과 연도 값만 수정할 수 있습니다. 날짜 값은 01이어야 합니다. 예를 들면 01.02.2017과 같습니다. 명령에 ?month=01.MM.YYYY 매개 변수를 포함하지 않으면 보고서에 당월의 월간 누계 세부 정보가 생성됩니다.
조직 vDC 수준의 vCloud Director 일별 세부 정보
wget --no-check-certificate -S -q --header "Accept: application/json" --header='Content-Type: application/json' --header "accept-encoding: gzip" --header='Authorization: Bearer <TOKEN>' -O - https://VRB_SERVER/itfm-cloud/rest/reports/v1/vcd/orgVdc/daily
참고:이 보고서에 대해서는 서비스 수준 세부 정보가 제공되지 않습니다.
VM 수준의 vCloud Director 일별 세부 정보
wget --no-check-certificate -S -q --header "Accept: application/json" --header='Content-Type: application/json' --header "accept-encoding: gzip" --header='Authorization: Bearer <TOKEN>' -O - https://VRB_SERVER/itfm-cloud/rest/reports/v1/vcd/vm/daily