本文へジャンプします。

ニフクラ APIリファレンス

クラウド トップ>API>RDB>CreateDBSecurityGroup

RDB:CreateDBSecurityGroup

処理概要

DBファイアウォールグループを作成します。

リクエストパラメーター

要素名 説明 必須 最大値 デフォルト値 備考
DBSecurityGroupDescription

DBファイアウォールグループの説明

  • ※最大255字の印字可能文字が使用できます
  • ※空文字列を指定することも可能です
文字列  
DBSecurityGroupName

DBファイアウォールグループ名

  • ※1〜255字のアルファベット・数字・ハイフン('-')が使用できます
  • ※最初の文字はアルファベットである必要があります
  • ※末尾にハイフンをつけたりハイフンを2個連続させたりすることはできません
  • ※既に存在するDBファイアウォールグループの名前は指定できません
例:mydbsecuritygroup
文字列  
NiftyAvailabilityZone 指定可能なゾーンについては、ニフクラ ゾーン別機能対応表をご参照ください。 文字列 ニフクラ独自仕様

レスポンス

XML

status

statusは共通の応答メッセージを返却します。

result
要素名 説明 備考
CreateDBSecurityGroupResponse ルート  
CreateDBSecurityGroupResult 結果  
DBSecurityGroup DBファイアウォールグループ情報  
DBSecurityGroupDescription DBファイアウォールグループの説明 文字列  
DBSecurityGroupName DBファイアウォールグループ名 文字列  
EC2SecurityGroups ニフクラのファイアウォールグループ要素リスト リスト  
OwnerId DBファイアウォールグループを所有している @nifty ID 文字列  
NiftyAvailabilityZone DBファイアウォールグループのゾーン 文字列 ニフクラ独自仕様
ResponseMetadata 共通メタ情報  

エラー

コード メッセージ タイプ HTTP
ステータスコード
説明
Client.InvalidParameterCannotSpecify.DBSecurityGroupName DBSecurityGroupName must not contain leading or trailing spaces Sender 400 DBSecurityGroupNameの最初または最後にスペースを入力した場合
Client.InvalidParameterDuplicate.DBSecurityGroupName A security group named sample-security already exists Sender 400
  • すでに存在するDBSecurityGroupNameを指定した場合
  • DBSecurityGroupNameに"default."で始まる値を指定した場合
Client.InvalidParameterFormat.DBSecurityGroupName DBSecurityGroupName can contain only ASCII letters and digits, spaces, underscores, and hyphens Sender 400 DBSecurityGroupNameに無効な値(ハイフンから始まる 等)を指定した場合
Client.InvalidParameterIllegalInput.AvailabilityZone aaa is not a valid availability zone. Sender 400 NiftyAvailabilityZoneに存在しないAvailabilityZoneを指定した場合
Client.InvalidParameterRequired.AvailabilityZone NiftyAvailabilityZone is required Sender 400 必須のNiftyAvailabilityZoneを指定しなかった場合
Client.InvalidParameterRequired.DBSecurityGroupDescription DBSecurityGroupDescription is required Sender 400 必須のDBSecurityGroupDescriptionを指定しなかった場合
Client.InvalidParameterRequired.DBSecurityGroupName DBSecurityGroupName is required Sender 400 必須のDBSecurityGroupNameを指定しなかった場合
Client.InvalidParameterTooLong.DBSecurityGroupDescription DBSecurityGroupDescription can be no longer than 255 characters Sender 400 DBSecurityGroupDescriptionに255文字を超える値を指定した場合
Client.InvalidParameterTooLong.DBSecurityGroupName DBSecurityGroupName can be no longer than 255 characters Sender 400 DBSecurityGroupNameに255文字を超える値を指定した場合
Client.LimitExceeded.NumberOfDBSecurityGroup Request would result in user exceeding the allowed number of DB Security Groups. Sender 400 作成できるDBファイアウォールグループの上限に達している場合

サンプル

リクエストサンプル
https://rdb.jp-east-1.api.cloud.nifty.com/
    ?Action=CreateDBSecurityGroup
    &DBSecurityGroupName=mydbsecuritygroup
    &DBSecurityGroupDescription=My+new+db+security+group
    &NiftyAvailabilityZone=east-13
    &SignatureVersion=2
    &SignatureMethod=HmacSHA256
    &Timestamp=2013-12-09T00%3A00%3A00.000Z
    &AWSAccessKeyId=<Nifty Cloud Access Key ID>
    &Signature=<Signature>
レスポンスサンプル
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<CreateDBSecurityGroupResponse>
<CreateDBSecurityGroupResult>
    <DBSecurityGroup>
    <DBSecurityGroupDescription>My new db security group</DBSecurityGroupDescription>
        <DBSecurityGroupName>mydbsecuritygroup</DBSecurityGroupName>
        <EC2SecurityGroups/>
        <IPRanges/>
        <OwnerId>abc01234</OwnerId>
        <NiftyAvailabilityZone>east-13</NiftyAvailabilityZone>
    </DBSecurityGroup>
</CreateDBSecurityGroupResult>
    <ResponseMetadata>
    <RequestId>4463042b-7384-4075-a1b0-c1deefb030e6</RequestId>
</ResponseMetadata>
</CreateDBSecurityGroupResponse>

推奨画面サイズ 1024×768 以上