機械翻訳について

クイック・スタート

このトピックの情報を使用すると、Oracle Analytics Cloud REST APIの使用を開始する際に役立ちます。

前提条件

前提条件	詳細情報
Oracle Analytics Cloudへのサブスクライブ	Oracle Analytics Cloudをサブスクライブします
Oracle Analytics Cloudにサインインします	Oracle Analytics Cloudにアクセス

タスク1: アカウント情報の取得

Oracle Cloudアカウント管理者から、Oracle Analytics Cloud REST APIを使用できるように適切なアカウント資格証明を取得します。 具体的には、次が必要です。

• Oracle Analytics Cloudのユーザー名およびパスワード。

• Oracle Analytics CloudインスタンスのURL。

• Oracle Analytics Cloud内の適切なアプリケーション・ロール。 必要なアプリケーション・ロールは、実行するREST API操作によって異なり、UIで同じ操作を実行するために必要なアプリケーション・ロールと同じです。 たとえば:
  • カタログ: DV Content Authorが必要です
  • 接続: DV Content Authorが必要です
  • データセット: DV Content Authorが必要です
  • データ・フロー: DV Content Authorが必要です
  • 順序: DV Content Authorが必要です
  • 安全ドメイン: BI Service Administratorが必要です
  • スナップショット: BI Service Administratorが必要です
  • システム: BI Service Administratorが必要です

「スナップショット」 REST APIを使用するための追加の前提条件があります。 詳細は、「スナップショットREST APIの前提条件」を参照してください。

タスク2: 送信リクエストURLの理解

次のURLを使用して、Oracle Analytics Cloud REST APIを使用してリクエストを送信します:

https://subdomain.domain.com/path/resource-path

説明:

• subdomain.domain.com - Oracle Analytics Cloudが実行されているホスト(およびポート)。 たとえば: myoac-idabcd0efghj-ia.analytics.ocp.oraclecloud.com

• resource-path: リソースを定義する相対パス(RESTエンドポイント)。 「すべてのRESTエンドポイント」を参照してください。

cURLコマンドの例

次の表に、cURLを使用したGETおよびPOST操作の例を示します:

操作	cURLコマンド
GETを使用して、Oracle Analytics Cloudインスタンスに関する情報を取得します。	curl -i --header 'Authorization: Bearer <token>' --request GET 'https://myoac-idabcd0efghj-ia.analytics.ocp.oraclecloud.com/api/20210901/system'
POSTを使用して、スナップショットを作成および登録します。	curl -i --header 'Authorization: Bearer <token>' --request POST 'https://myoac-idabcd0efghj-ia.analytics.ocp.oraclecloud.com/api/20210901/snapshots' -d @example_request_payload.json