Equinix API
Equinix™は、にアクセスできるRESTful HTTP APIを提供しています。https://api.equinix.com/本書では、APIとその使用方法について説明します。
APIを利用すると、プロジェクト、デバイス、接続、注文、コロケーション展開、サポートチケット、Identity & Access Managementなど、エクイニクスのリソースとプログラムでやり取りできます。
Equinix APIの利用
APIの使用は、認可フローとリクエストフローに分けることができます。
API経由でエクイニクスの製品とやり取りするには、次のことが必要です：
- Equinix Customer PortalアカウントまたはOIDCプロバイダ。
- 製品固有の作成、変更、削除権限。
ユーザー認証フロー
-
カスタマーポータルでアプリケーションの登録と認証を行います。
-
コンシューマキー、コンシューマシークレット、およびユーザー認証情報を使用してを呼び出し、アクセスおよび更新トークン情報をリクエストします。
/oauth2/v1/token
-
リクエストは、短命の OAuth アクセストークンと関連するリフレッシュトークンを返します。
詳細および詳細な手順については、「API認証」を参照してください。
OIDCトークン認証フロー
-
カスタマーポータルまたはEquinix APIでOIDCプロバイダを作成します。
-
IDプロバイダのトークンとスコープを使用してエンドポイントを呼び出し、アクセスをリクエストします。
/v1/token
- リクエストは短命のアクセストークンを返します。
詳細については、「OIDC API認証」を参照してください。
リクエストの流れ
-
有効な OAuth アクセストークンを使用してリクエストを認可し、必要な認可ヘッダーを使用して API エンドポイントを呼び出します。
-
APIゲートウェイはリクエストを検証し、関連するEquinix APIを呼び出します。
-
API ゲートウェイによってレスポンスが受信されます。
-
応答が送信されます。
Terraformを使用したコードとしてのインフラストラクチャ
Equinixは、REST APIに加えて、インフラストラクチャをコードとして使用してEquinixリソースを管理できるテラフォームプロバイダも提供しています。TerraformプロバイダはEquinix APIを包含し、インフラストラクチャを定義および管理するための宣言的な方法を提供します。
Equinixテラフォームプロバイダは以下をサポートしています。
- Equinix Fabric -仮想接続、クラウドルーター、ストリーム、正確な時間
- Network Edge -仮想ネットワークデバイス
完全なドキュメント、例、利用可能なリソースについては、テラフォームプロバイダのドキュメントを参照してください。
APIリファレンス
Equinix APIは、バージョン管理された機能グループで構成されています。各機能グループには、そのグループに関連する操作を実行できる一連のAPIエンドポイントが含まれています。
API参照はOpenAPI形式で提供されており、リクエストとレスポンスの形式、必須パラメータ、リクエスト例など、各エンドポイントに関する詳細情報が含まれています。Equinix製品ドキュメント全体に、説明されている製品またはサービスに対応する「APIリファレンス」へのリンクがあります。
官能基ごとのすべてのEquinix APIリファレンスのライブラリを表示するには、APIカタログを参照してください。次のナビゲーションツリーを使用して、すべてのEquinix API参照へのリンクを検索することもできます。各先行APIパスは、このビュー内の対応するAPIリファレンスにリンクされます。