3.2. 버전 4에서 Red Hat Virtualization Manager 연결

Red Hat Virtualization Manager에 연결하려면 스크립트 시작 시 클래스를 가져와 ovirtsdk4.sdk 모듈에서 Connection 클래스 인스턴스를 생성해야 합니다. 

import ovirtsdk4 as sdk

Connection 클래스의 생성자는 여러 인수를 사용합니다. 지원되는 인수는 다음과 같습니다.

url
Manager의 기본 URL(예: https://server.example.com/ovirt-engine/api)이 포함된 문자열 입니다.
사용자 이름
연결할 사용자 이름(예: admin@internal )을 지정합니다. 이 매개변수는 필수입니다.
암호
username 매개변수에서 제공하는 사용자 이름의 암호를 지정합니다. 이 매개변수는 필수입니다.
토큰
사용자 이름 및 암호 대신 API에 액세스하기 위한 선택적 토큰입니다. token 매개변수를 지정하지 않으면 SDK가 자동으로 생성됩니다.
insecure
서버의 TLS 인증서 및 호스트 이름을 확인할지 여부를 나타내는 부울 플래그입니다.
ca_file
신뢰할 수 있는 CA 인증서가 포함된 PEM 파일입니다. 서버에서 제공하는 인증서는 이러한 CA 인증서를 사용하여 확인합니다. ca_file 매개 변수가 설정되지 않은 경우 시스템 전체 CA 인증서 저장소가 사용됩니다.
debug

디버그 출력을 생성해야 하는지 여부를 나타내는 부울 플래그입니다. 값이 True 이고 log 매개변수가 None 이 아닌 경우 서버에서 전송된 데이터가 로그에 기록됩니다.

참고

사용자 이름과 암호는 디버그 로그에 기록되므로 주의해서 처리합니다.

압축은 디버그 모드에서 비활성화되어 있습니다. 즉, 디버그 메시지가 일반 텍스트로 전송됩니다.

log
로그 메시지가 기록될 로거입니다.
kerberos
기본 인증 대신 Kerberos 인증을 사용해야 하는지 여부를 나타내는 부울 플래그입니다.
timeout
응답을 대기하는 최대 시간(초)입니다. 값 0 (기본값)은 영구적으로 기다리는 것을 의미합니다. 응답을 수신하기 전에 시간 초과가 만료되면 예외가 발생합니다.
compress
SDK가 서버에 압축된 응답을 보내도록 요청할지 여부를 나타내는 부울 플래그입니다. 기본값은 True 입니다. 이는 서버에 대한 힌트로, 이 매개 변수가 True 로 설정된 경우에도 압축되지 않은 데이터를 반환할 수 있습니다. 압축은 디버그 모드에서 비활성화되어 있습니다. 즉, 디버그 메시지가 일반 텍스트로 전송됩니다.
sso_url
서버의 기본 SSO URL이 포함된 문자열입니다. 기본 SSO URL은 sso_url 이 제공되지 않으면 URL 에서 계산됩니다.
sso_revoke_url
SSO 취소 서비스의 기본 URL이 포함된 문자열입니다. 이는 외부 인증 서비스를 사용하는 경우에만 지정해야 합니다. 기본적으로 이 URL은 url 매개변수 값에서 자동으로 계산되므로 Manager의 일부인 SSO 서비스를 사용하여 SSO 토큰 해지가 수행됩니다.
sso_token_name
SSO 서버에서 반환된 JSON SSO 응답의 토큰 이름입니다. 기본값은 access_token 입니다.
headers
모든 요청과 함께 전송되어야 하는 헤더가 있는 사전입니다.
연결
호스트에 열 최대 연결 수입니다. 값이 0 (기본값)이면 연결 수는 무제한입니다.
pipeline
응답을 기다리지 않고 HTTP 파이프라인에 넣을 최대 요청 수입니다. 값이 0 (기본값)이면 pipelining이 비활성화됩니다. 
import ovirtsdk4 as sdk

# Create a connection to the server:
connection = sdk.Connection(
    url='https://engine.example.com/ovirt-engine/api',
    username='admin@internal',
    password='password',
    ca_file='ca.pem',
)

connection.test()

print("Connected successfully!")

connection.close()

지원되는 전체 방법 목록은 Manager 머신에서 ovirtsdk.api 모듈에 대한 문서를 생성할 수 있습니다. 

$ pydoc ovirtsdk.api