Korzystając z Oracle Analytics Cloud REST API, można w magazynie OCI (Oracle Cloud Infrastructure) programistycznie tworzyć i odtwarzać zapisy stanu (pliki BAR), a także nimi zarządzać. Na przykład można utworzyć skrypt sporządzający regularnie kopie zapasowe (zapisy stanu).
Uwaga:
Na stronie "Zapisy stanu" w konsoli Oracle Analytics Cloud są wyświetlane zapisy stanu sporządzone za pomocą konsoli. Na stronie "Zapisy stanu" nie są wyświetlane zapisy stanu sporządzone i zarejestrowane za pomocą REST API.
Poniżej przedstawiono niektóre typowe zadania z użyciem REST API.
| Zadanie | Opis | Dokumentacja REST API |
|---|---|---|
| Zrozumienie wymagań wstępnych |
Należy zrozumieć i wykonać kilka wymaganych wstępnie zadań. Do zarządzania zapisami stanu za pomocą REST API są wymagane w Oracle Analytics Cloud uprawnienia administratora (administrator usługi BI). Potrzebny jest także dostęp do usługi Oracle Cloud Infrastructure (OCI) Object Storage oraz uprawnienia do utworzenia koszyka, w którym będą składowane zapisy stanu. W szczególności są wymagane następujące uprawnienia w odniesieniu do koszyka, w którym są składowane zapisy stanu: |
Wymagania wstępne |
| Zrozumienie identyfikacji za pomocą tokenów OAuth 2.0 | Identyfikacja i autoryzacja w Oracle Analytics Cloud są zarządzane przez Oracle Identity Cloud Service. Do uzyskania dostępu do Oracle Analytics Cloud REST API jest potrzebny token dostępu OAuth 2.0, służący do autoryzacji. | Identyfikacja za pomocą tokenów OAuth 2.0 |
| Sporządzenie zapisu stanu | Zawartość i ustawienia w systemie w danej chwili można zarejestrować w zapisie stanu (plik BAR). Następnie zapis stanu należy zapisać w magazynie w chmurze i zarejestrować z Oracle Analytics Cloud. | Create a snapshot (type=CREATE) |
| Rejestrowanie istniejącego zapisu stanu | Można zarejestrować z Oracle Analytics Cloud zapis stanu przechowywany w magazynie w chmurze. | Create a snapshot (type=REGISTER) |
| Odtworzenie z zapisu stanu | Można odtworzyć system do poprzedniego poprawnego stanu, używając zapisu stanu z magazynu w chmurze. | Restore a snapshot |
| Usunięcie zapisu stanu | Można usunąć z magazynu w chmurze niepotrzebne zapisy stanu. | Delete snapshots |
| Uzyskanie szczegółów zapisu stanu | Można uzyskać szczegóły zapisu stanu lub wszystkich zapisów stanu, które są przechowywane w magazynie w chmurze. | Get a snapshot |
| Uzyskanie statusu zlecenia roboczego dot. zapisu stanu | Można monitorować status zleceń roboczych REST. | Get a work request item |