本文へジャンプします。

ニフティクラウド 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
ステータスコード
説明
DBSecurityGroupAlreadyExists A security group named default already exists Sender 400 DBSecurityGroupNameに "default"などすでにあるDBSecurityGroupNameを指定した場合
DBSecurityGroupNotSupported A DB security group is not allowed for this action. Sender 400 不明なエラー
DBSecurityGroupQuotaExceeded Request would result in user exceeding the allowed number of DB Security Groups. Sender 400 作成できるDBファイアウォールグループの上限に達している場合
InvalidParameterValue DBSecurityGroupName is required Sender 400 必須のDBSecurityGroupNameを指定しなかった場合
DBSecurityGroupName must not contain leading or trailing spaces Sender 400 DBSecurityGroupNameの最初か最後 に " " を入力した場合
DBSecurityGroupName can contain only ASCII letters and digits, spaces, underscores, and hyphens Sender 400 DBSecurityGroupNameに無効な(@など)値を指定した場合
DBSecurityGroupName can be no longer than 255 characters Sender 400 DBSecurityGroupNameに255文字以上指定した場合
DBSecurityGroupDescription is required Sender 400 必須のDBSecurityGroupDescriptionを指定しなかった場合
The parameter DBSecurityGroupDescription must not contain non-printable control characters. Sender 400 DBSecurityGroupDescriptionに全角文字を指定した場合
DBSecurityGroupDescription can be no longer than 255 characters Sender 400 DBSecurityGroupDescriptionに255文字以上を指定した場合
NiftyAvailabilityZone is required Sender 400 NiftyAvailabilityZoneを指定しなかった場合
aaa is not a valid availability zone. Sender 400 存在しないAvailabilityZoneをNiftyAvailabilityZoneに指定した場合

サンプル

リクエストサンプル
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 以上