Jak zacząć korzystać z API?
Posted by on 02.07.2013 11:20
|
|
Osoby rozpoczynające swoją przygodę z API Oktawave zadają nam najczęściej następujące pytania. Poniżej znajdziecie informacje, które pozwolą Wam na rozpoczęcie swojej przygody z naszym API.
1. Skąd można pobrać przykłady kodu aplikacji współpracujących z API Oktawave? Aby zweryfikować działanie konkretnych metod, najłatwiej jest zajrzeć do przykładowego kodu źródłowego aplikacji napisanych w różnych językach. Na liście poniżej znajdziesz przykłady kodu dla Pythona, PHP oraz Ruby'ego.
2. Jak za pomocą API stworzyć nowe OCI, jednocześnie ustawiając jej klasę inną niż domyślna? Aby stworzyć nowe OCI za pomocą API, należy skorzystać z funkcji CreateVirtualMachine. Funkcja ta przyjmuje wiele parametrów, a jednym z nich jest selectedClass (Nullable<Int32>), który oznacza właśnie klasę instancji. Klasa nie może być niższa niż minimalna klasa szablonu instancji. Parametr ten jest opcjonalny i przyjmuje wartości zgodne z poniższą listą.
Należy pamiętać że ID mogą się zmieniać i najlepszym rozwiązaniem jest sprawdzenie dostępnych klas przed wywołaniem metody CreateVirtualMachine.
3. Jak sprawdzić ID klasy (typu) instancji, a także identyfikatory parametrów wszystkich metod (parametry słownikowe)? Sprawdzanie słowników klas oraz parametrów metod można wykonać za pomocą metody GetDictionaryItems należącej do CommonService. Parametrem metody GetDictionaryItem jest INT dictionaryID, który dla słownika klas instancji przyjmuje wartość 12.
4. Jak zidentyfikować słownikowe parametry metod za pomocą pliku WSDL na przykładzie metody CloneVirtualMachine?
5. Czy za pomocą API można korzystać z tzw. prywatnych szablonów? Nie, obecnie platforma nie obsługuje natywnie prywatnych szablonów. Można natomiast wykorzystać mechanizm klonowania, aby stworzyć własne pseudo szablony. W tym celu należy przygotować OCI, które będzie pełniło rolę szablonu, a następnie je wyłączyć. ID tak przygotowanej OCI można wykorzystać w metodzie CloneVirtualMachine w parametrze virtualMachineId.
6. Jak sprawdzić identyfikator (virtualMachineID) konkretnej OCI? W tym celu należy skorzystać z metody GetVirtualMachines, która w parametrze przyjmuje: searchParams (VirtualMachineSearchParams), gdzie należy przekazać ClientID czyli parametr identyfikujący konto. W odpowiedzi uzyskamy listę uproszczonych obiektów instancji OCI, a w każdym z nich będzie identyfikator VirtualMachineId. Metoda GetVirtualMachines zwróci wszystkie instancje OCI oraz aplikację. Wyniki możemy zawęzić poprzez użycie filtru w searchParams.
7. Jak sprawdzić hasło do nowo utworzonej instancji OCI? Aby uzyskać dane dostępowe do nowo stworzonej OCI, należy pobrać wpisy z event loga metodą GetVirtualMachineHistories, podając jako ActionTypeFilter wartość 247 (czyli VirtualMachineAccessData). | |
|