RevokeNASSecurityGroupIngress
処理概要
接続を許可したIP範囲またはニフクラのファイアウォールグループ名の設定を取り消します。
このAPIアクションではCIDRIP(IP帯)またはSecurityGroupName(ニフクラのファイアウォールグループ名)を必ず指定する必要があります。
指定するパラメーター
パラメーター | 型 | 説明 | 必須 |
---|---|---|---|
NASSecurityGroupName | string |
NASファイアウォールグループ名 |
○ |
SecurityGroupName | string |
取り消すニフクラのファイアウォールグループ名 |
○ (CIDRIPを指定しない場合) |
CIDRIP | string |
取り消すIP帯 |
○ (SecurityGroupNameを指定しない場合) |
応答フィールド
フィールド (項目) | 型 | 説明 |
---|---|---|
RevokeNASSecurityGroupIngressResponse | structure |
ルート |
␣RevokeNASSecurityGroupIngressResult | structure |
結果 |
␣␣NASSecurityGroup | structure |
NASファイアウォールグループ 備考: NASSecurityGroupの子要素はDescribeNASSecurityGroupsで返却される要素をすべて記載しているためAPIによっては返却されない要素もあります。実際のレスポンスはレスポンスサンプルを参照してください。 |
␣␣␣NASSecurityGroupDescription | string |
NASファイアウォールグループの説明 |
␣␣␣NASSecurityGroupName | string |
NASファイアウォールグループ名 |
␣␣␣SecurityGroups | list |
ニフクラファイアウォールグループ要素リスト |
␣␣␣␣SecurityGroup | structure |
ニフクラファイアウォールグループ要素 |
␣␣␣␣␣SecurityGroupName | string |
ニフクラファイアウォールグループ名 |
␣␣␣␣␣SecurityGroupOwnerId | string |
ニフクラのファイアウォールグループを所有している ニフクラID |
␣␣␣␣␣Status | string |
ニフクラのファイアウォールグループのステータス
|
␣␣␣IPRanges | list |
IP帯リスト |
␣␣␣␣IPRange | structure |
IP帯 |
␣␣␣␣␣CIDRIP | string |
CIDR |
␣␣␣␣␣Status | string |
IP帯のステータス
|
␣␣␣OwnerId | string |
NASファイアウォールグループを所有している ニフクラID |
␣␣␣AvailabilityZone | string |
NASファイアウォールグループのゾーン |
␣ResponseMetadata | structure |
共通メタ情報 |
␣␣RequestId | string |
リクエスト識別子 |
エラー
コード | メッセージ | タイプ | HTTPステータスコード | 説明 |
---|---|---|---|---|
Client.InvalidParameter.NotFound.SecurityGroupName | SecurityGroup aaaa hasn’t been authorized |
Sender | 404 | ファイアウォールグループに設定されていないニフクラファイアウォールグループを指定した場合 |
Client.InvalidParameter.NotFound.CIDRIP | CIDRIP xxx.xxx.xxx.xxx/xx hasn’t been authorized |
Sender | 404 | ファイアウォールグループに設定されていないCIDRIPを指定した場合 |
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.MisMatch.SecurityGroupName | If CIDRIP is specified, SecurityGroupName must be omitted. |
Sender | 400 | このAPIを使うための条件を満たすパラメータを指定していない場合 |
Client.InvalidParameter.Required.NASSecurityGroupName | The parameter NASSecurityGroupName must be provided and must not be blank. |
Sender | 400 | 必須のNASSecurityGroupNameを指定しなかった場合 |
Client.InvalidParameter.TooLong.NASSecurityGroupName | NASSecurityGroupName can be no longer than 255 characters. |
Sender | 400 | NASSecurityGroupNameに255文字以上指定した場合 |
Client.InvalidParameter.Format.NASSecurityGroupName | NASSecurityGroupName must not contain leading or trailing spaces. |
Sender | 400 | NASSecurityGroupNameの最初か最後に " "(半角スペース)を入力した場合 |
Client.InvalidParameter.NotAllowed.NASSecurityGroupName | NASSecurityGroupName can contain only lowercase ASCII letters and digits, spaces, underscores, and hyphens. |
Sender | 400 | NASSecurityGroupNameに無効な値(全角文字、@など)を指定した場合 |
Client.InvalidParameter.TooLong.SecurityGroupName | SecurityGroupName can be no longer than 15 characters. |
Sender | 400 | SecurityGroupNameに15文字を超える値を入力した場合 |
Client.Resource.IncorrectState.RevokeNASSecurityGroup | Cannot revoke the NASSecurityGroup because NASInstance using the NASSecurityGroup is {unavailable status}. |
Sender | 400 | 指定されたNASファイアウォールグループを使用しているNASのステータスが「creating」もしくは「modifying」のとき |
リクエストサンプル
https://jp-east-1.nas.api.nifcloud.com/
?Action=RevokeNASSecurityGroupIngress
&NASSecurityGroupName=exsample-securitygroup
&CIDRIP=xxx.xxx.xxx.xxx/xx
&SignatureVersion=2
&SignatureMethod=HmacSHA256
&Timestamp=2016-02-24T00:00:00.000Z
&AWSAccessKeyId=<NIFCLOUD Access Key ID>
&Signature=<Signature>
応答サンプル
<RevokeNASSecurityGroupIngressResponse>
<RevokeNASSecurityGroupIngressResult>
<NASSecurityGroup>
<NASSecurityGroupName>exsample-securitygroup</NASSecurityGroupName>
<SecurityGroups/>
<IPRanges>
<IPRange>
<CIDRIP>xxx.xxx.xxx.xxx/xx</CIDRIP>
<Status>revoking</Status>
</IPRange>
</IPRanges>
<OwnerId>ABC01234</OwnerId>
<AvailabilityZone>east-21</AvailabilityZone>
</NASSecurityGroup>
</RevokeNASSecurityGroupIngressResult>
<ResponseMetadata>
<RequestId>9f95fa37-ae66-4c24-a557-affa62797f52</RequestId>
</ResponseMetadata>
</RevokeNASSecurityGroupIngressResponse>