첫 번째 ONTAP tools REST API 호출
curl을 사용하여 API 호출을 실행하면 ONTAP tools for VMware vSphere 10 REST API를 시작할 수 있습니다.
시작하기 전에
curl 예제에 필요한 정보와 매개변수를 검토해야 합니다.
다음이 필요합니다:
-
ONTAP tools for VMware vSphere 10 IP 주소 또는 FQDN 및 포트
-
ONTAP tools Manager 관리자 자격 증명(사용자 이름 및 비밀번호)
아래의 curl 예제에는 Bash 스타일 변수가 포함되어 있습니다. 이러한 변수는 Bash 환경에서 설정하거나 명령을 실행하기 전에 수동으로 업데이트할 수 있습니다. 변수를 설정하면 셸은 각 명령이 실행되기 전에 해당 값으로 대체합니다. 변수에 대한 설명은 아래 표를 참조하십시오.
| 변수 | 설명 |
|---|---|
$FQDN_IP_PORT |
ONTAP tools Manager의 정규화된 도메인 이름 또는 IP 주소와 포트 번호입니다. |
$MYUSER |
ONTAP tools Manager 계정의 사용자 이름입니다. |
$MYPASSWORD |
ONTAP tools Manager 사용자 이름과 연결된 비밀번호입니다. |
$ACCESS_TOKEN |
ONTAP tools Manager에서 발급한 액세스 토큰입니다. |
다음은 Linux CLI에서 변수를 설정하고 표시하는 방법을 보여주는 명령과 출력입니다.
FQDN_IP_PORT=172.14.31.224:8443 echo $FQDN_IP 172.14.31.224:8443
1단계: 액세스 토큰 획득
REST API를 사용하려면 액세스 토큰을 발급받아야 합니다. 액세스 토큰을 요청하는 방법의 예시는 아래와 같습니다. 사용 환경에 맞게 값을 적절히 바꿔 사용하십시오.
curl --request POST \
--location "https://$FQDN_IP_PORT/virtualization/api/v1/auth/login” \
--header "Content-Type: application/json" \
--header "Accept: */*" \
-d "{"username": "$MYUSER", "password": "$MYPASSWORD"}"
응답에 제공된 액세스 토큰을 복사하여 저장하십시오.
2단계: REST API 호출 실행
액세스 토큰을 얻은 후에는 curl을 사용하여 REST API 호출을 실행할 수 있습니다. 첫 번째 단계에서 얻은 액세스 토큰을 포함하십시오.
curl --request GET \
--location "https://$FQDN_IP_PORT/virtualization/api/v1/vcenters" \
--header "Accept: */*" \
--header "x-auth: $ACCESS_TOKEN"
JSON 응답에는 ONTAP tools Manager에 구성된 VMware vCenter 인스턴스 목록이 포함되어 있습니다.