本文へジャンプします。

ニフクラ APIリファレンス

クラウド トップ>API>NAS>ModifyNASSecurityGroup

NAS:ModifyNASSecurityGroup

処理概要

NASファイアウォールグループの設定を変更します。
一度に複数のNASファイアウォールグループ設定を変更することができます。

リクエストパラメーター

要素名 説明 必須 最大値 デフォルト値 備考
NASSecurityGroupName 変更対象のNASファイアウォールグループ名 文字列  
NewNASSecurityGroupName

新しいNASファイアウォールグループ名

  • ※1〜255字のアルファベット・数字・ハイフン('-')が使用できます
  • ※最初の文字はアルファベットである必要があります
  • ※末尾にハイフンをつけたりハイフンを2個連続させたりすることはできません
  • ※すでに存在するNASファイアウォールグループの名前は指定できません
  文字列  
NASSecurityGroupDescription

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

  • ※1〜255文字の印字可能なASCII文字が使用できます。
  文字列  

レスポンス

XML

status

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

result
要素名 説明 備考
DescribeNASSecurityGroupsResponse ルート  
DescribeNASSecurityGroupsResult 結果  
NASSecurityGroup NASファイアウォールグループ  
NASSecurityGroupDescription NASファイアウォールグループの説明 文字列  
NASSecurityGroupName NASファイアウォールグループ名 文字列  
SecurityGroups ニフクラファイアウォールグループ要素リスト リスト  
SecurityGroup ニフクラファイアウォールグループ要素  
SecurityGroupName ニフクラファイアウォールグループ名 文字列  
SecurityGroupOwnerId ニフクラのファイアウォールグループを所有している @nifty ID 文字列  
Status ニフクラのファイアウォールグループのステータス
値:authorized(有効)|authorizing(追加中)|revoking(削除中)|auth-failed(追加エラー)|revoke-failed(削除エラー)|not-exists(追加エラー(グループが存在しません))
文字列  
IPRanges IP帯リスト リスト  
IPRange IP帯  
CIDRIP CIDR 文字列  
Status IP帯のステータス
値:authorized(有効)|authorizing(追加中)|revoking(削除中)|auth-failed(追加エラー)|revoke-failed(削除エラー))
文字列  
OwnerId NASファイアウォールグループを所有している @nifty ID 文字列  
AvailabilityZone NASファイアウォールグループのゾーン 文字列  
ResponseMetadata 共通メタ情報  

エラー

コード メッセージ タイプ HTTPステータスコード 説明
Client.InvalidParameter.NotFound.NASSecurityGroupName NASSecurityGroup aaaa not found. Sender 404 NASSecurityGroupNameに存在しない名前を指定した場合
Client.Resource.IncorrectState.NASSecurityGroup The state of the NAS Security Group does not allow deletion. Sender 400 指定したファイアウォールグループのステータスが有効な状態でない場合
Client.InvalidParameter.Reqiured.NASSecurityGroupName NASSecurityGroupName is required Sender 400 必須のNASSecurityGroupNameを指定しなかった場合
Client.InvalidParameter.TooLong.NASSecurityGroupName NewNASSecurityGroupName can be no longer than 255 characters Sender 400 NewNASSecurityGroupNameに255文字以上指定した場合
Client.InvalidParameter.Format.NASSecurityGroupName NewNASSecurityGroupName must not contain leading or trailing spaces Sender 400 NewNASSecurityGroupNameの最初か最後に " "(半角スペース) を入力した場合
Client.InvalidParameter.NotAllowed.NASSecurityGroupName Invalid security group: exampleSecurity Sender 400 NewNASSecurityGroupNameに無効な値(全角文字、@など)を指定した場合
Client.InvalidParameter.TooLong.NASSecurityGroupDescription NASSecurityGroupDescription can be no longer than 255 characters Sender 400 NASSecurityGroupDescriptionに255文字以上指定した場合

リクエストサンプル

https://nas.jp-east-2.api.cloud.nifty.com/
    ?Action=ModifyNASSecurityGroup
    &NASSecurityGroupName=exsample-securitygroup
    &NewNASSecurityGroupName=sample-securitygroup
    &SignatureVersion=2
    &SignatureMethod=HmacSHA256
    &Timestamp=2016-02-24T00%3A00%3A00.000Z
    &AWSAccessKeyId=<Nifty Cloud Access Key ID>
    &Signature=<Signature>

レスポンスサンプル

<ModifyNASSecurityGroupResponse>
  <ModifyNASSecurityGroupResult>
    <NASSecurityGroup>
      <NASSecurityGroupName>sample-securitygroup</NASSecurityGroupName>
      <SecurityGroups/>
      <IPRanges/>
      <OwnerId>ABC01234</OwnerId>
      <AvailabilityZone>east-21</AvailabilityZone>
    </NASSecurityGroup>
  </ModifyNASSecurityGroupResult>
  <ResponseMetadata>
    <RequestId>34f5f93c-529b-4230-96e6-9324e07394ed</RequestId>
  </ResponseMetadata>
</ModifyNASSecurityGroupResponse>

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