# 2つのサービストークンを使った接続 サービストークンで事前に定義された情報を使用して、アセットまたはサードパーティ間の接続を確立できます。サービストークンは、接続のAサイドとZサイドの両方に対して発行できます。 たとえば、aサイドのサービス・トークンで定義されたオリジンから、zサイドのサービス・トークンで定義されたデスティネーションへの接続を作成できます。 ## 前提条件[​](#前提条件 "への直接リンク前提条件") 1. 認証-ユーザー認証情報、クライアントID、クライアントシークレットを送信してOauth2認証を行います。認証情報を検証および認証するためにOAuth APIを呼び出す方法については、「[API認証」を](https://docs.equinix.com/ja/equinix-api/api-authentication.md)参照してください。 2. プロバイダからA側サービス・トークンの詳細を取得します。 3. プロバイダからサイド・サービス・トークンの詳細を取得します。 この情報は、接続作成APIを呼び出すために必要です。 ## A サイドから Z サイドへの接続を作成する サービストークン[​](#a-サイドから-z-サイドへの接続を作成する-サービストークン "への直接リンクA サイドから Z サイドへの接続を作成する サービストークン") サービストークンへの接続を作成するには、エンドポイントにリクエストを[`/fabric/v4/connections`](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/createconnection.md)送信します。`POST`リクエストの本文でAサイドとZサイドのサービストークンの詳細を指定します。 > **メモ** > > サービストークンは、複数の受信者に送信することができ、どの受信者も1回だけ使用することができます。 | | **POST/ファブリック/v4/connections** | | ------------------ | ------------------------------------------------------------------------------------- | | 方法 | `POST` | | エンドポイント | `/fabric/v4/connections` | | ヘッダー | `Authorization`、`Content-Type` | | パスパラメータ | 該当なし | | クエリーパラメータ | 該当なし | | ボディパラメータ | `type``name`、、`order`、、`redundancy`、`bandwidth``aSide`、`zSide`、`notifications` | 接続を作成せずに本番環境でこのリクエストを安全に検証するには、「[本番環境でのテスト(APIドライラン)」を](https://docs.equinix.com/ja/equinix-api/testing/testing-in-production-dry-run.md)参照してください。 サンプルcURLリクエスト: ``` curl -X POST 'https://api.equinix.com/fabric/v4/connections' -H 'content-type: application/json' -H 'authorization: Bearer ' -d '{     "type": "EVPL_VC",     "name": "AST_TO_ZST_CONNECTION",     "order": {     "purchaseOrderNumber": "1-129105284100"  },     "bandwidth": 100,     "redundancy": {     "priority": "PRIMARY"  },     "aSide": {     "serviceToken": {         "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5"    }     },     "zSide": {     "serviceToken": {         "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5"    }     },     "notifications": [     {         "type": "ALL",         "emails": [         "test@equinix.com",         "test1@equinix.com"      ]     }     ] }' ``` リクエスト本文に含まれるパラメータは、この例に固有のものです。パラメータの完全なリストとその説明については、[APIリファレンスを](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/createconnection.md)参照してください。 回答例 ``` {     "href": "https://api.equinix.com/fabric/v4/connections/b067f685-49b0-1a09-6fe0-360a5d00a",     "type": "EVPL_VC",     "uuid": "b067f685-49b0-1a09-6fe0-360a5d00a",     "name": "AST_TO_ZST_CONNECTION",     "state": "ACTIVE",     "operation": {         "providerStatus": "PROVISIONED",         "equinixStatus": "PROVISIONED"    },     "notifications": [         {             "type": "ALL",             "emails": [                 "test@equinix.com"            ]         }     ],     "account": {         "accountNumber": 201246,         "orgId": 92610,         "globalOrgId": "0017i000011X250AAC"    },     "changeLog": {         "createdBy": "testuser",         "createdDateTime": "2022-05-16T07:50:49.749Z"    },     "bandwidth": 100,     "redundancy": {         "group": "b067f685-49b0-1a09-6fe0-360a5d00afdg",         "priority": "PRIMARY"    },     "isRemote": true,     "direction": "OUTGOING",     "aSide": {         "serviceToken": {             "href": "https://api.equinix.com/fabric/v4/serviceTokens/b067f685-49b0-1a09-6fe0-360a5d00afdg",             "uuid": "b067f685-49b0-1a09-6fe0-360a5d00afdg"        },         "accessPoint": {             "location": {                 "metroHref": "https://api.equinix.com/fabric/v4/metros/SV",                 "metroCode": "SV"            },             "port": {                 "href": "https://api.equinix.com/fabric/v4/ports/b067f685-49b0-1a09-6fe0-360a5d00afdg",                 "uuid": "b067f685-49b0-1a09-6fe0-360a5d00afdg"            },             "linkProtocol": {                 "type": "DOT1Q"            }         }     },     "zSide": {         "serviceToken": {             "href": "https://api.equinix.com/fabric/v4/serviceTokens/b067f685-49b0-1a09-6fe0-360a5d00afdg",             "uuid": "b067f685-49b0-1a09-6fe0-360a5d00afdg"        },         "accessPoint": {             "location": {                 "metroHref": "https://api.equinix.com/fabric/v4/metros/SV",                 "metroCode": "SV"            },             "port": {                 "href": "https://api.equinix.com/fabric/v4/ports/b067f685-49b0-1a09-6fe0-360a5d00afdg",                 "uuid": "b067f685-49b0-1a09-6fe0-360a5d00afdg"            },             "linkProtocol": {                 "type": "DOT1Q"            }         }     },     "order": {         "purchaseOrderNumber": "1122334",         "billingTier": "Up to 50 MB"    } } ``` 応答ペイロードには、リクエスト本文で定義された構成パラメータが含まれます。使用可能なパラメータの全リストとその説明については、[APIリファレンスを](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/createconnection.md)参照してください。 ## 接続の監視[​](#接続の監視 "への直接リンク接続の監視") [指定された接続の取得](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/getconnectionbyuuid.md)エンドポイントを使用して、接続ステータスを監視します。