Public Service - Flexible InterConnect API リファレンス (2.0.0)

Download OpenAPI specification:Download

概要

本APIでは、Flexible InterConnectが提供するリソースの参照・操作が可能です。

FIC-Port(XaaS)/FIC-Premium-Virtual Port(XaaS)【Pattern S】/FIC-Premium Virtual Port(XaaS)【Pattern X】の公開サービス情報の登録・取得・変更・廃止等の操作に関するAPIドキュメントです。

Public-Service

List Public Services

FIC-Port(XaaS)/FIC-Premium-Virtual Port(XaaS)【Pattern S】/FIC-Premium Virtual Port(XaaS)【Pattern X】の公開サービス情報の一覧を取得します。

query Parameters

id	string ^X[0-9]{12}$ Example: id=X001234567890 公開サービスID
name	string [ 1 .. 50 ] characters Example: name=YourPublicServiceName 公開サービス名半角50文字以内
area	string Enum: "JPEAST" "JPWEST" Example: area=JPEAST エリア名 'JPEAST'または'JPWEST'
isPublic	boolean Example: isPublic=true 情報公開フラグ create時は'false'(非公開)固定

header Parameters

Content-Type required	string Value: "application/json"
X-Auth-Token required	string ^[0-9a-f]{32}$ Example: dc03494823a841338430052e9ee95e07 クライアントが Keystone を利用して取得した認証 Token

Responses

200

OK 成功しました

400

Bad Request リクエストが不正

401

Unauthorized 認証エラー

409

Conflict 競合エラー

get/v1/public-services

https://api.ntt.com/fic-eri/v1/public-services

Response samples

Content type

application/json

Example

Copy

Expand all Collapse all


{"publicServices": 
[
{"id": "X001234567890",
"name": "YourPublicServiceName",
"tenantId": "db8b0e40743f460685040c46167cf19e",
"area": "JPEAST",
"operationStatus": "Completed",
"description": "PublicService-description",
"keyRequired": false,
"isPublic": false,
"enabled": true,
"seller": 
{"url": "https://seller.com",
"companyName": "Seller-companyName",
"serviceInquiryMail": "serviceInquiry@domain",
"serviceInquiryPhone": "03-1234-5678",
"customerSupportMail": "customerSupport@domain",
"customerSupportPhone": "03-8765-4321"
},
"connectionSpec": 
{"source": 
{"resourceType": 
["PremiumRouter"
]
},
"destination": 
{"resources": 
[
{"id": "F010123456789",
"publicName": "XaaS-PortName01",
"role": "primary",
"enabled": false
},
{"id": "F019876543210",
"publicName": "XaaS-PortName02",
"role": "secondary",
"enabled": false
}
],
"asn": "65530",
"resourceType": "PremiumPort"
},
"redundant": true,
"bgpCostType": "med",
"availableBandwidth": 
["100M",
"200M",
"500M",
"1G",
"2G",
"5G",
"10G"
],
"advertisedAddresses": [ ]
}
}
]
}

Create Public Service

FIC-Port(XaaS)/FIC-Premium-Virtual Port(XaaS)【Pattern S】/FIC-Premium Virtual Port(XaaS)【Pattern X】の公開サービス情報を登録します。

header Parameters

Content-Type required	string Value: "application/json"
X-Auth-Token required	string ^[0-9a-f]{32}$ Example: dc03494823a841338430052e9ee95e07 クライアントが Keystone を利用して取得した認証 Token

Request Body schema: application/json

publicService

required

object

Responses

202

Accepted 要求は受け付けられました

400

Bad Request リクエストが不正

401

Unauthorized 認証エラー

409

Conflict 競合エラー

post/v1/public-services

https://api.ntt.com/fic-eri/v1/public-services

Request samples

Payload

Content type

application/json

Example

Copy

Expand all Collapse all


{"publicService": 
{"name": "YourPublicServiceName",
"area": "JPEAST",
"description": "PublicService-description",
"keyRequired": false,
"seller": 
{"url": "https://seller.com",
"companyName": "Seller-companyName",
"serviceInquiryMail": "serviceInquiry@domain",
"serviceInquiryPhone": "03-1234-5678",
"customerSupportMail": "customerSupport@domain",
"customerSupportPhone": "03-8765-4321"
},
"connectionSpec": 
{"source": 
{"resourceType": 
["PremiumRouter"
]
},
"destination": 
{"resources": 
[
{"id": "F010123456789",
"publicName": "XaaS-PortName01",
"enabled": true
},
{"id": "F019876543210",
"publicName": "XaaS-PortName02",
"enabled": true
}
],
"asn": "65000"
},
"redundant": true,
"bgpCostType": "med",
"availableBandwidth": 
["100M",
"200M",
"500M",
"1G",
"2G",
"5G",
"10G"
]
}
}
}

Response samples

Content type

application/json

Example

Copy

Expand all Collapse all


{"publicService": 
{"id": "X001234567890",
"name": "YourPublicServiceName",
"tenantId": "db8b0e40743f460685040c46167cf19e",
"area": "JPEAST",
"operationStatus": "Processing",
"description": "PublicService-description",
"keyRequired": false,
"isPublic": false,
"enabled": true,
"seller": 
{"url": "https://seller.com",
"companyName": "Seller-companyName",
"serviceInquiryMail": "serviceInquiry@domain",
"serviceInquiryPhone": "03-1234-5678",
"customerSupportMail": "customerSupport@domain",
"customerSupportPhone": "03-8765-4321"
},
"connectionSpec": 
{"source": 
{"resourceType": 
["PremiumRouter"
]
},
"destination": 
{"resources": 
[
{"id": "F010123456789",
"publicName": "XaaS-PortName01",
"role": "primary",
"enabled": false
},
{"id": "F019876543210",
"publicName": "XaaS-PortName02",
"role": "secondary",
"enabled": false
}
],
"asn": "65530",
"resourceType": "PremiumPort"
},
"redundant": true,
"bgpCostType": "med",
"availableBandwidth": 
["100M",
"200M",
"500M",
"1G",
"2G",
"5G",
"10G"
],
"advertisedAddresses": [ ]
},
"operationId": "2fb5baa5a5834e0b952d3f0d93c3e64a"
}
}

Show Public Service

指定したFIC-Port(XaaS)/FIC-Premium-Virtual Port(XaaS)【Pattern S】/FIC-Premium Virtual Port(XaaS)【Pattern X】の公開サービス情報の詳細情報を取得します。

path Parameters

required

string ^X[0-9]{12}$

Example: X001234567890

対象公開サービスID

header Parameters

Content-Type required	string Value: "application/json"
X-Auth-Token required	string ^[0-9a-f]{32}$ Example: dc03494823a841338430052e9ee95e07 クライアントが Keystone を利用して取得した認証 Token

Responses

200

OK 成功しました

400

Bad Request リクエストが不正

401

Unauthorized 認証エラー

404

Not Found 未検出エラー

409

Conflict 競合エラー

get/v1/public-services/{id}

https://api.ntt.com/fic-eri/v1/public-services/{id}

Response samples

Content type

application/json

Example

Copy

Expand all Collapse all


{"publicService": 
{"id": "X001234567890",
"name": "YourPublicServiceName",
"tenantId": "db8b0e40743f460685040c46167cf19e",
"area": "JPEAST",
"operationStatus": "Completed",
"description": "PublicService-description",
"keyRequired": false,
"isPublic": false,
"enabled": true,
"seller": 
{"url": "https://seller.com",
"companyName": "Seller-companyName",
"serviceInquiryMail": "serviceInquiry@domain",
"serviceInquiryPhone": "03-1234-5678",
"customerSupportMail": "customerSupport@domain",
"customerSupportPhone": "03-8765-4321"
},
"connectionSpec": 
{"source": 
{"resourceType": 
["PremiumRouter"
]
},
"destination": 
{"resources": 
[
{"id": "F010123456789",
"publicName": "XaaS-PortName01",
"role": "primary",
"enabled": false
},
{"id": "F019876543210",
"publicName": "XaaS-PortName02",
"role": "secondary",
"enabled": false
}
],
"asn": "65530",
"resourceType": "PremiumPort"
},
"redundant": true,
"bgpCostType": "med",
"availableBandwidth": 
["100M",
"200M",
"500M",
"1G",
"2G",
"5G",
"10G"
],
"advertisedAddresses": [ ]
}
}
}

Update Public Service

指定したFIC-Port(XaaS)/FIC-Premium-Virtual Port(XaaS)【Pattern S】/FIC-Premium Virtual Port(XaaS)【Pattern X】のサービス情報および公開情報を変更します。

path Parameters

required

string ^X[0-9]{12}$

Example: X001234567890

対象公開サービスID

header Parameters

Content-Type required	string Value: "application/json"
X-Auth-Token required	string ^[0-9a-f]{32}$ Example: dc03494823a841338430052e9ee95e07 クライアントが Keystone を利用して取得した認証 Token

Request Body schema: application/json

publicService

required

object

Responses

202

Accepted 要求は受け付けられました

400

Bad Request リクエストが不正

401

Unauthorized 認証エラー

404

Not Found 未検出エラー

409

Conflict 競合エラー

patch/v1/public-services/{id}

https://api.ntt.com/fic-eri/v1/public-services/{id}

Request samples

Payload

Content type

application/json

Example

Copy

Expand all Collapse all


{"publicService": 
{"description": "PublicService-descriptionUpdate",
"keyRequired": true,
"isPublic": true,
"enabled": true,
"seller": 
{"url": "https://sellerUpdate.com",
"companyName": "Seller-companyNameUpdate",
"serviceInquiryMail": "serviceInquiryUpdate@domain",
"serviceInquiryPhone": "03-1234-5679",
"customerSupportMail": "customerSupportUpdate@domain",
"customerSupportPhone": "03-8765-4322"
},
"connectionSpec": 
{"source": 
{"resourceType": 
["PremiumRouter"
]
},
"destination": 
{"resources": 
[
{"id": "F010123456789",
"publicName": "XaaS-PortName01",
"enabled": true
},
{"id": "F019876543210",
"publicName": "XaaS-PortName02",
"enabled": true
}
]
},
"availableBandwidth": 
["100M",
"200M",
"500M",
"1G",
"2G",
"5G",
"10G"
]
}
}
}

Response samples

Content type

application/json

Example

Copy

Expand all Collapse all


{"publicService": 
{"id": "X001234567890",
"name": "YourPublicServiceName",
"tenantId": "db8b0e40743f460685040c46167cf19e",
"area": "JPEAST",
"operationStatus": "Processing",
"description": "PublicService-description",
"keyRequired": false,
"isPublic": false,
"enabled": true,
"seller": 
{"url": "https://seller.com",
"companyName": "Seller-companyName",
"serviceInquiryMail": "serviceInquiry@domain",
"serviceInquiryPhone": "03-1234-5678",
"customerSupportMail": "customerSupport@domain",
"customerSupportPhone": "03-8765-4321"
},
"connectionSpec": 
{"source": 
{"resourceType": 
["PremiumRouter"
]
},
"destination": 
{"resources": 
[
{"id": "F010123456789",
"publicName": "XaaS-PortName01",
"role": "primary",
"enabled": false
},
{"id": "F019876543210",
"publicName": "XaaS-PortName02",
"role": "secondary",
"enabled": false
}
],
"asn": "65530",
"resourceType": "PremiumPort"
},
"redundant": true,
"bgpCostType": "med",
"availableBandwidth": 
["100M",
"200M",
"500M",
"1G",
"2G",
"5G",
"10G"
],
"advertisedAddresses": [ ]
},
"operationId": "2fb5baa5a5834e0b952d3f0d93c3e64a"
}
}

Delete Public Service

指定したFIC-Port(XaaS)/FIC-Premium-Virtual Port(XaaS)【Pattern S】/FIC-Premium Virtual Port(XaaS)【Pattern X】の公開サービス情報を廃止します。

公開サービス情報にコネクションが紐づいている場合や、公開サービス情報の情報公開フラグおよびリソース収容可否フラグがfalseでない場合は廃止出来ません。

path Parameters

required

string ^X[0-9]{12}$

Example: X001234567890

対象公開サービスID

header Parameters

Content-Type required	string Value: "application/json"
X-Auth-Token required	string ^[0-9a-f]{32}$ Example: dc03494823a841338430052e9ee95e07 クライアントが Keystone を利用して取得した認証 Token

Responses

202

Accepted 要求は受け付けられました

400

Bad Request リクエストが不正

401

Unauthorized 認証エラー

404

Not Found 未検出エラー

409

Conflict 競合エラー

delete/v1/public-services/{id}

https://api.ntt.com/fic-eri/v1/public-services/{id}

Response samples

Content type

application/json

Example

Copy

Expand all Collapse all


{"publicService": 
{"id": "X001234567890",
"name": "YourPublicServiceName",
"tenantId": "db8b0e40743f460685040c46167cf19e",
"area": "JPEAST",
"operationStatus": "Processing",
"description": "PublicService-description",
"keyRequired": false,
"isPublic": false,
"enabled": true,
"seller": 
{"url": "https://seller.com",
"companyName": "Seller-companyName",
"serviceInquiryMail": "serviceInquiry@domain",
"serviceInquiryPhone": "03-1234-5678",
"customerSupportMail": "customerSupport@domain",
"customerSupportPhone": "03-8765-4321"
},
"connectionSpec": 
{"source": 
{"resourceType": 
["PremiumRouter"
]
},
"destination": 
{"resources": 
[
{"id": "F010123456789",
"publicName": "XaaS-PortName01",
"role": "primary",
"enabled": false
},
{"id": "F019876543210",
"publicName": "XaaS-PortName02",
"role": "secondary",
"enabled": false
}
],
"asn": "65530",
"resourceType": "PremiumPort"
},
"redundant": true,
"bgpCostType": "med",
"availableBandwidth": 
["100M",
"200M",
"500M",
"1G",
"2G",
"5G",
"10G"
],
"advertisedAddresses": [ ]
},
"operationId": "2fb5baa5a5834e0b952d3f0d93c3e64a"
}
}