8.2 IPアドレス範囲を作成する

新しいIPアドレス範囲を作成します。

ロール

All-Resources-Admin

リクエストライン

POST http://<host>:<port>/ComputeSystemsManager/v1/objects/IPAddressRanges

リクエストボディー

リクエストボディーの構造とオブジェクトの属性を次に示します。

IPAddressRange

{
       "ipAddressRangeName":"...",
       "description":"...",
       "ipVersion":"...",
       "startIPaddress":"...",
       "endIPaddress":"...",
       "ipv6Specifiers":{
           "ipAddress":["...", ...]
       },
       "usePing":"...",
       "credential":[{
           "instanceID":"..."
       },
       :
       ]
}

属性データ型説明
ipAddressRangeNamestring0~1IPアドレス範囲の名前(1~32バイト)。
descriptionstring0~1IPアドレス範囲の説明。
  • 0-500 byte String
ipVersionstring1IPアドレスバージョン。
  • v4
  • v6
startIPaddressstring0~1探索開始IPアドレス(書式:IPv4形式)。ipVersionが'v4'の場合に使用します。ipVersionが'v6'の場合は空文字列です。
endIPaddressstring0~1探索終了IPアドレス(書式:IPv4 形式)。ipVersionが'v4'の場合に使用します。ipVersionが'v6'の場合は空文字列です。
ipv6SpecifiersIPv6Specifier0~1探索対象IPアドレス。ipVersionが'v6'の場合に使用します。ipVersionが'v4'の場合はnullです。
usePingstring0~1PINGを使用するかどうか。
  • Disable
  • Enable
credentialCredentialSpecifier0~10認証情報のリスト。

ipv6Specifiers

属性データ型説明
ipAddressstring0~1024探索対象のIPアドレス(書式:IPv6形式)。

credential

属性データ型説明
instanceIDstring0~1関連する認証情報のinstanceID。

レスポンスボディー

レスポンスボディーの構造とオブジェクトの属性を次に示します。

ApiResult

{
       "id":...
}

属性データ型説明
idinteger1作成したIPアドレス範囲のinstanceIDが返ります。

リターンコード

HTTPステータスコード結果コード詳細コード説明
20100正常終了。
40020101ipAddressRangeNameに無効な値を指定しました。
40020102descriptionに無効な値を指定しました。
400201010ipVersionを指定していません。
400201011ipVersionに無効な値を指定しました。
400201012ipVersionに'v4'を指定する場合は,startIPaddressも指定する必要があります。
400201013startIPaddressに無効な値を指定しました。
400201014ipVersionに'v4'を指定する場合は,endIPaddressも指定する必要があります。
400201015endIPaddressに無効な値を指定しました。
400201016startIPaddressとendIPaddressの間に1024個を超えるIPアドレスが含まれています。または,startIPaddressがendIPaddressよりも小さくなっています。
400201020ipVersionに'v6'を指定する場合は,ipv6Specifiersも指定する必要があります。
400201022ipVersionに'v6'を指定したのにipAddressを指定していないか,ipAddressに1024個を超えるIPアドレスが含まれています。
400201023ipAddressに無効な値を指定しました。
400201030usePingに無効な値を指定しました。
400201031credentialを指定していません。
400201033credentialのinstanceIDを指定していません。credentialのinstanceIDは10個以内で指定してください。
400201034credentialのinstanceIDに無効な値を指定しました(指定された認証情報がありません)。
400201035ipVersionに'v6'を指定する場合は,credencialのinstanceIDにはsvpCredentialの認証情報だけを指定します。
4002010100リクエストボディーが指定されていません。
4002010101リクエストボディーの書式が無効です。JSONの書式で記述してください。
40110001HTTPヘッダーのAuthorizationが指定されていません。
40110002HTTPヘッダーのAuthorizationの値が不正です(Basic認証,HSSOセッション認証のどちらでもありません)。
40110003HTTPヘッダーのAuthorizationのBasic認証の値が不正です(認証情報のフォーマットが不正です)。
40110004ログインに失敗しました。
40110021ログインセッションが切断されました。または,不正なHSSOトークンが指定されました。
40310031基本ライセンスが登録されていない,または有効期限を過ぎています。
40320171管理対象を参照する権限がありません。
405--サポートされていないメソッドです。
40620101HTTPヘッダーのAcceptの値が不正です。
41220131指定したipAddressRangeNameはCompute Systems Managerですでに使用済みです。
415--HTTPヘッダーのContent-Typeにサポートされていない形式が指定されています。
500--HTTPヘッダーのContent-Typeに不正な値が指定されている,またはそれ以外の内部エラーです。
50010001ログインに失敗しました(内部エラー)。
50320201要求の数がAPIの同時最大接続数を超えました。