# Cross Connect APIテスト Cross Connect APIを使用すると、Equinixデータセンター内の機器間の物理ケーブル接続の注文、管理、およびデインストールが可能になります。 このガイドでは、[Cross Connect API](https://docs.equinix.com/api-catalog/crossconnectsv2/)と統合するためのテスト戦略、事例、ベストプラクティスをご紹介します。 ## 概要[​](#概要 "への直接リンク概要") Cross-Connectは、同軸ケーブル、ファイバーケーブル、銅線ケーブルを使用した物理的なケーブル接続で、エクイニクスのデータセンター内でお客様の機器と他のお客様の機器を直接接続します。 クロスコネクトはデータをポイントツーポイントで伝送するため、パブリックインターネットの遅延や混雑の問題を回避できます。 Cross Connect API v2は、主に3つのエンドポイントを提供します: | Method | Endpoint | Description | | ------ | ------------------------------------------------ | ----------------------------------- | | POST | `/colocations/v2/orders/crossConnects` | Order new cross connects | | PATCH | `/colocations/v2/orders/crossConnects/{orderId}` | Update existing cross connect order | | POST | `/colocations/v2/orders/crossConnects/deinstall` | Deinstall existing cross connects | Cross Connect APIをテストする前に、以下を確認してください: * Cross Connect発注権限を持つエクイニクスデベロッパーアカウント * 有効なAPI認証情報(クライアントIDとクライアントシークレット) * 適切なデータセンターロケーションへのアクセス * [API認証](https://docs.equinix.com/ja/equinix-api/api-authentication.md)の理解 ## Cross Connectテストワークフロー[​](#cross-connectテストワークフロー "への直接リンクCross Connectテストワークフロー") Cross Connect APIで認証フローを検証することから始めましょう: ``` # Test authentication for Cross Connect API (Python example) import requests auth_url = "https://api.equinix.com/oauth2/v1/token" auth_payload = { "grant_type": "client_credentials", "client_id": "", "client_secret": "" } response = requests.post(auth_url, data=auth_payload) data = response.json() if response.status_code != 200: raise Exception(f"Authentication failed: {response.status_code} {data}") access_token = data.get("access_token") print("Access token:", access_token) print("Token timeout:", data.get("token_timeout")) ``` **基本クロスコネクト発注テスト** 最も一般的なシナリオであるシングルモードファイバーのクロスコネクトをテストします: ``` import requests import json # Setup authentication base_url = "https://api.equinix.com" auth_url = f"{base_url}/oauth2/v1/token" auth_payload = { "grant_type": "client_credentials", "client_id": "YOUR_CLIENT_ID", "client_secret": "YOUR_CLIENT_SECRET" } auth_response = requests.post(auth_url, data=auth_payload) token = auth_response.json()["access_token"] # Prepare request headers = { "Authorization": f"Bearer {token}", "Content-Type": "application/json" } # Test ordering a basic single mode fiber cross connect payload = { "customerReferenceId": "TEST-CC-001", "description": "Test cross connect for API integration", "details": [ { "aSide": { "connectionService": "SINGLE_MODE_FIBER", "mediaType": "SINGLE_MODE_FIBER", "protocolType": "10_GIG_ETHERNET", "connectorType": "FC", "patchPanel": { "id": "CP:0104:1199890" } }, "zSide": { "patchPanel": { "id": "PP:0104:1190123" }, "circuitId": "TEST-CIRCUIT-001", "connectorType": "LC" } } ] } response = requests.post( f"{base_url}/colocations/v2/orders/crossConnects", headers=headers, data=json.dumps(payload) ) # Verify response assert response.status_code == 201, f"Failed to create order: {response.text}" order_data = response.json() order_id = order_data.get("orderId") print(f"Successfully created Cross Connect order with ID: {order_id}") print(f"Current status: {order_data.get('status')}") ``` ## クロスコネクトAPIテストのベストプラクティス[​](#クロスコネクトapiテストのベストプラクティス "への直接リンククロスコネクトAPIテストのベストプラクティス") **無効なパッチパネルID** * パッチパネルIDが正しいフォーマットに従っていることを確認してください:cp:xxxx :xxxxxx \`。 * 対象のデータセンターでパッチパネルが利用可能かどうかを確認します。 **認証エラー** * トークンの有効期限の確認(通常1時間) * クライアントの認証情報が正しいことを確認 * OAuth2フローの適切な実装 **検証エラー** * API仕様の必須フィールドとオプションフィールドの比較 * データタイプとフォーマット要件の確認 * connectionService、mediaTypeなどの列挙値を検証します。 **パーミッションエラー** * お客様のアカウントにCross Connectの注文権限があることを確認してください。 * データセンターへのアクセス許可の確認 * 指定されたIBXロケーションに確実にアクセスできます。 ## 関連ドキュメント[​](#関連ドキュメント "への直接リンク関連ドキュメント") * [Cross Connect API OpenAPI Specification](https://docs.equinix.com/ja/api-catalog/crossconnectsv2.md) * [General API Testing Guidelines](https://docs.equinix.com/ja/equinix-api/testing.md) * [API Authentication Guide](https://docs.equinix.com/ja/equinix-api/api-authentication.md) ## ヘルプ[​](#ヘルプ "への直接リンクヘルプ") Cross Connect APIのテスト中に問題が発生した場合: * API [FAQ](https://docs.equinix.com/ja/equinix-api/api-faqs.md)を確認してください。 * [エクイニクスサポート](https://support.equinix.com)までお問い合わせください。