NAS:ModifyNASSecurityGroup
処理概要
NASファイアウォールグループの設定を変更します。
一度に複数のNASファイアウォールグループ設定を変更することができます。
リクエストパラメーター
要素名 | 説明 | 必須 | 値 | 最大値 | デフォルト値 | 備考 |
---|---|---|---|---|---|---|
NASSecurityGroupName | 変更対象のNASファイアウォールグループ名 | ○ | 文字列 | − | − | |
NewNASSecurityGroupName | 新しいNASファイアウォールグループ名
|
文字列 | − | − | ||
NASSecurityGroupDescription | NASファイアウォールグループの説明
|
文字列 | − | − |
レスポンス
XML
status
statusは共通の応答メッセージを返却します。
result
要素名 | 説明 | 値 | 備考 |
---|---|---|---|
ModifyNASSecurityGroupResponse | ルート | − | |
ModifyNASSecurityGroupResult | 結果 | − | |
NASSecurityGroup | NASファイアウォールグループ | − | |
NASSecurityGroupDescription | NASファイアウォールグループの説明 | 文字列 | |
NASSecurityGroupName | NASファイアウォールグループ名 | 文字列 | |
SecurityGroups | ニフクラファイアウォールグループ要素リスト | リスト | |
SecurityGroup | ニフクラファイアウォールグループ要素 | − | |
SecurityGroupName | ニフクラファイアウォールグループ名 | 文字列 | |
SecurityGroupOwnerId | ニフクラのファイアウォールグループを所有している ニフクラ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ファイアウォールグループを所有している ニフクラ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://jp-east-1.nas.api.nifcloud.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>