API - AWS Direct Connectへの接続

FabricとAWS Direct Connectを使用して、IBXコロケーションアセットとAmazon Web Services（AWS）リソース間の直接レイヤー2接続を確立します。APIを使用して、ポート、Network Edgeデバイス、またはFabric Cloud Routerから接続を作成します。

AWS提供のサービストークンがある場合は、「サービストークンを使用して接続先に接続する」を参照してください。

API の前提条件

1. 認証 - OAuth2用のユーザー認証情報、クライアントID、クライアントシークレットを送信します。 認証。OAuth APIを呼び出して認証情報を検証および認証する方法については、「API認証」を参照してください。

2. Aサイド情報を決定します。次のいずれかを実行

   • エンドポイントにリクエストを/fabric/v4/ports送信して、Equinix Fabricポート情報を決定します。GETポートUUIDとリンクプロトコルタイプ（Dot1QまたはQinQ）が必要です。

   または

   • エンドポイントにリクエストを/fabric/v4/serviceTokens送信して、Aサイドのサービストークンを取得します。GETトークンのUUIDが必要です。Aサイドトークンは、接続のAサイドを設定するための関連情報を提供します。

   または

   • Network Edgeデバイス情報を確認します。エンドポイントにリクエストを/ne/v1/devices送信して、利用可能な仮想デバイスとクラスタを確認します。GETデバイスのUUIDが必要です。デバイスの詳細を取得するためのリクエストを/ne/v1/devices/{device_id}エンドポイントに送信します。GET接続には、デバイスで使用可能なインターフェースを選択できます。指定しない場合、接続は次に使用可能なインターフェースに自動的に割り当てられます。

   または

   • Fabric Cloud Router情報を確認します。エンドポイントにリクエストを/fabric/v4/routers/search送信して、利用可能なクラウドルーターを確認します。POSTルーターのUUIDが必要です。

3. AWS Direct Connectサービスプロファイルとロケーション情報を特定する。どのサービスプロファイルを選択すべきかの詳細については、AWS Direct Connectの概要ページを参照してください。

   • AWS Direct Connect UUID -69ee618d-be52-468d-bc99-00566f2dd2b9
   • AWS Direct Connect大容量UUID-de55ca94-df3b-4680-845f-6f7093f76bef
   • AWS Direct Connect冗長UUID -8b5cbdbd-53da-4d37-9bfc-cc988eb522f1
   • AWS Direct Connect -大容量冗長-ed48616a-c182-40b4-a462-a78ba812e961

   ロケーション情報を見つけるには、AWS Direct ConnectサービスプロファイルIDSのいずれかを使用して、エンドポイントにリクエストを/fabric/v4/serviceProfiles/{service_profile_ID}送信します。GET``metros応答内のオブジェクトには、Equinix都市圏とそれに関連付けられたAWS地域のリストが含まれています。接続を作成するには、両方が必要です。

4. AmazonアカウントIDを特定して検証します。AWS Management Consoleにログインし、アカウント番号を確認します。アカウント番号の確認方法については、AWSのドキュメントを参照してください。エンドポイントにリクエストを/fabric/v4/connections/validate送信して、POSTAWSアカウントIDを使用して、指定の都市圏で選択したサービスプロファイルへの接続を作成できることを確認します。

DOT1Q ポートからの接続

Dot1QポートからAWSへの接続を作成するには、エンドポイントにリクエストを/fabric/v4/connections送信します。POST接続はtypeです。EVPL_VC

オブジェクトにポート情報を入力します。aSide以下を含みます。

• accessPoint.typeASCOLO
• ポートのUUIDをに入力してくださいport.uuid
• linkProtocolタイプDOT1Q
• VLAN IDをに提供linkProtocol.vlanTag

AWS Direct Connectの詳細とロケーションの詳細をオブジェクトに入力します。zSide以下を含みます。

• に設定します。accessPoint.type``SP
• に設定します。profile.type``L2_PROFILE
• で、接続先のAWSサービスプロファイルを指定します。profile.uuid
• で接続するEquinix都市圏の場所を指定します。location.metroCode
• で、Equinix都市圏に関連付けられたAWS地域を指定します。sellerRegionこの情報はエンドポイントから見つけることができます。/fabric/v4/serviceProfiles/{service_profile_ID}「API前提条件エンドポイント」を参照してください。詳細については、APIの前提条件を参照してください。
• AWSアカウントIDとして設定します。authenticationKey

redundancyリクエストの本文で、およびを含むその他の接続構成の詳細を指定します。bandwidthパラメータの完全なリストとその説明については、APIリファレンスを参照してください。

サンプルcURLリクエスト：

curl -X
POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
  "type": "EVPL_VC",
  "name": "<your_connection_name>",
  "bandwidth": <connection_speed>,
  "redundancy": {
    "priority": "<redundancy_code>"
  },
  "aSide": {
    "accessPoint": {
      "type": "COLO",
      "port": {
        "uuid": "<port_uuid>"
      },
      "linkProtocol": {
        "type": "DOT1Q",
        "vlanTag": <vlan_ID>
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<equinix_metro_code>"
      },
      "sellerRegion": "<aws_region_name>",
      "authenticationKey": "<amazon_account_ID>"
    }
  },
  "project": {
    "projectId": "<project_uuid>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
      "<contact_email>"
      ]
    }
  ]
}'

QINQ ポートからの接続

QinQポートからAWSへの接続を作成するには、エンドポイントにリクエストを/fabric/v4/connections送信します。POST接続はtypeです。EVPL_VC

オブジェクトにポート情報を入力します。aSide以下を含みます。

• として設定accessPoint.type``COLO
• ポートのUUIDをに入力してくださいport.uuid
• linkProtocol.type ASQINQ
• 内部タグIDをに提供しますlinkProtocol.vlanCTag
• 外部タグIDをに提供しますlinkProtocol.vlanSTag

AWS Direct Connectの詳細とロケーションの詳細をオブジェクトに入力します。zSide以下を含みます。

• に設定します。accessPoint.type``SP
• に設定します。profile.type``L2_PROFILE
• で、接続先のAWSサービスプロファイルを指定します。profile.uuid
• で接続するEquinix都市圏の場所を指定します。location.metroCode
• で、Equinix都市圏に関連付けられたAWS地域を指定します。sellerRegionこの情報はエンドポイントから見つけることができます。/fabric/v4/serviceProfiles/{service_profile_ID}「API前提条件エンドポイント」を参照してください。詳細については、APIの前提条件を参照してください。
• AWSアカウントIDとして設定します。authenticationKey

redundancyリクエストの本文で、およびを含むその他の接続構成の詳細を指定します。bandwidthパラメータの完全なリストとその説明については、APIリファレンスを参照してください。

サンプルcURLリクエスト：

curl -X
POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
  "type": "EVPL_VC",
  "name": "<your_connection_name>",
  "bandwidth": <connection_speed>,
  "redundancy": {
    "priority": "<redundancy_code>"
  },
  "aSide": {
    "accessPoint": {
      "type": "COLO",
      "port": {
        "uuid": "<port_uuid>"
      },
      "linkProtocol": {
        "type": "QINQ",
        "vlanCTag": <inner_tag_ID>,
        "vlanSTag": <outer_tag_ID>
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<equinix_metro_code>"
      },
      "sellerRegion": "<aws_region_name>",
      "authenticationKey": "<amazon_account_ID>"
    }
  },
  "project": {
    "projectId": "<project_uuid>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
      "<contact_email>"
      ]
    }
  ]
}

サービス・トークンを使った接続

Aサイドサービストークンを使用してAWSへの接続を作成するには、エンドポイントにリクエストを/fabric/v4/connections送信します。POST接続はtypeです。EVPL_VC

オブジェクト内のサービストークンUUIDをにプロバイダします。aSideサービストークンは、接続を確立するために必要なその他すべての情報を提供します。

AWS Direct Connectの詳細とロケーションの詳細をオブジェクトに入力します。zSide以下を含みます。

• に設定します。accessPoint.type``SP
• に設定します。profile.type``L2_PROFILE
• で、接続先のAWSサービスプロファイルを指定します。profile.uuid
• で接続するEquinix都市圏の場所を指定します。location.metroCode
• で、Equinix都市圏に関連付けられたAWS地域を指定します。sellerRegionこの情報はエンドポイントから見つけることができます。/fabric/v4/serviceProfiles/{service_profile_ID}「API前提条件エンドポイント」を参照してください。詳細については、APIの前提条件を参照してください。
• AWSアカウントIDとして設定します。authenticationKey

redundancyリクエストの本文で、およびを含むその他の接続構成の詳細を指定します。bandwidthパラメータの完全なリストとその説明については、APIリファレンスを参照してください。

サンプルcURLリクエスト：

curl -X
POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
  "type": "EVPL_VC",
  "name": "<your_connection_name>",
  "bandwidth": <connection_speed>,
  "redundancy": {
    "priority": "<redundancy_code>"
  },
  "aSide": {
    "serviceToken": {
      "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<equinix_metro_code>"
      },
      "sellerRegion": "<aws_region_name>",
      "authenticationKey": "<amazon_account_ID>"
    }
  },
  "project": {
    "projectId": "<project_uuid>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
      "<contact_email>"
      ]
    }
  ]
}

Network Edge デバイスから接続する

Network EdgeデバイスからAWSへの接続を作成するには、エンドポイントにリクエストを/fabric/v4/connections送信します。POST接続はtypeです。EVPL_VC

オブジェクトでNetwork Edgeデバイスを定義する。aSide以下を含みます。

• accessPoint.type as VD
• virtualDevice.typeASEDGE
• virtualDevice.uuid デバイスのUUIDとして

AWS Direct Connectの詳細とロケーションの詳細をオブジェクトに入力します。zSide以下を含みます。

• に設定します。accessPoint.type``SP
• に設定します。profile.type``L2_PROFILE
• で、接続先のAWSサービスプロファイルを指定します。profile.uuid
• で接続するEquinix都市圏の場所を指定します。location.metroCode
• で、Equinix都市圏に関連付けられたAWS地域を指定します。sellerRegionこの情報はエンドポイントから見つけることができます。/fabric/v4/serviceProfiles/{service_profile_ID}「API前提条件エンドポイント」を参照してください。詳細については、APIの前提条件を参照してください。
• AWSアカウントIDとして設定します。authenticationKey

redundancyリクエストの本文で、およびを含むその他の接続構成の詳細を指定します。bandwidthパラメータの完全なリストとその説明については、APIリファレンスを参照してください。

サンプルcURLリクエスト：

curl -X
POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
  "type": "EVPL_VC",
  "name": "<your_connection_name>",
  "bandwidth": <connection_speed>,
  "redundancy": {
    "priority": "<redundancy_code>"
  },
  "aSide": {
    "accessPoint": {
      "type": "VD",
      "virtualDevice": {
        "type": "EDGE",
        "uuid": "<device_uuid>"
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<equinix_metro_code>"
      },
      "sellerRegion": "<aws_region_name>",
      "authenticationKey": "<amazon_account_ID>"
    }
  },
  "project": {
    "projectId": "<project_uuid>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
      "<contact_email>"
      ]
    }
  ]
}'

Fabric Cloud Router から接続する

Fabric Cloud RouterからAWSへの接続を作成するには、エンドポイントにリクエストを/fabric/v4/connections送信します。POST接続はtypeです。IP_VC

オブジェクトにFabric Cloud Routerを定義する。aSide以下が含まれます。

• に設定します。accessPoint.type``CLOUD_ROUTER
• ルーターのUUIDとして設定します。router.uuid

AWS Direct Connectの詳細とロケーションの詳細をオブジェクトに入力します。zSide以下を含みます。

• に設定します。accessPoint.type``SP
• に設定します。profile.type``L2_PROFILE
• で、接続先のAWSサービスプロファイルを指定します。profile.uuid
• で接続するEquinix都市圏の場所を指定します。location.metroCode
• で、Equinix都市圏に関連付けられたAWS地域を指定します。sellerRegionこの情報はエンドポイントから見つけることができます。/fabric/v4/serviceProfiles/{service_profile_ID}「API前提条件エンドポイント」を参照してください。詳細については、APIの前提条件を参照してください。
• AWSアカウントIDとして設定authenticationKey

サンプルcURLリクエスト：

curl -X
POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
  "type": "IP_VC",
  "name": "<your_connection_name>",
    "bandwidth": <connection_speed>,
    "redundancy": {
      "priority": "<redundancy_code>"
    },
  "aSide": {
    "accessPoint": {
      "type": "CLOUD_ROUTER",
      "router": {
        "uuid": "<cloud_router_uuid>"
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<equinix_metro_code>"
      },
      "sellerRegion": "<aws_region_name>",
      "authenticationKey": "<amazon_account_ID>"
    }
  },
  "project": {
    "projectId": "<project_uuid>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
      "<contact_email>"
      ]
    }
  ]
}'

接続状況の監視

接続ステータスを監視するリクエストをfabric/v4/connections/{connection_id}エンドポイントに送信します。GET

equinixStatus属性値	providerStatus属性値	AWS Direct Connect状態	説明
PROVISIONING	PROVISIONING		接続リクエストはまだAWSに送信されていません。
PROVISIONED	PENDING_APPROVAL	注文 -> リクエスト	接続が承認されるのを待っています。
PROVISIONED	PROVISIONING	保留中	接続確立中。
PROVISIONED	PROVISIONED	保留中 -> 利用可能	接続が承認されました。