本文へジャンプします。

ニフクラ ユーザーガイド

クラウド トップ>API> コンピューティング> AuthorizeSecurityGroupIngress

AuthorizeSecurityGroupIngress

処理概要

指定したファイアウォールグループへ許可ルールを追加します。

ファイアウォールグループを指定するためには、ファイアウォールグループ名が必要です。
許可ルールの許可プロトコルがTCPかUDPの場合、許可ポートの指定が必要です。ポートを単一指定する際は、許可開始ポートのみを指定します。ポートを範囲指定する際は、許可終了ポートには許可開始ポートの値以上を指定します。
許可ルールの追加には、時間がかかることがあります。API「DescribeSecurityGroups」のレスポンス値「groupStatus」でファイアウォールグループのステータスを確認できます。
また、ファイアウォールグループのステータスが「適用済み」の場合、追加した許可ルールが正しくファイアウォールグループに反映されているかの確認が必要です。
同じくAPI「DescribeSecurityGroups」のレスポンス値「ipPermissions」または「groups」で確認できます。

指定するパラメーター

パラメーター 説明 必須
UserId string ※指定不可
GroupName string 対象のファイアウォールグループ名
IpPermissions.n.IpProtocol string 許可プロトコル名
値: ANY | TCP | UDP | ICMP | SSH | HTTP | HTTPS | RDP | GRE | ESP | AH | VRRP | L2TP | ICMPv6-all
Default: TCP
IpPermissions.n.FromPort integer 許可開始ポート
Default: ipProtocolでの指定値による
○ (ipProtocol=TCP|UDPの場合)
IpPermissions.n.ToPort integer 許可終了ポート
Default: fromPortの値
IpPermissions.n.InOut string Incoming/Outgoing指定
値: IN (Incoming) | OUT (Outgoing)
Default: IN (Incoming)
IpPermissions.n.Groups.m.UserId string ※指定不可
IpPermissions.n.Groups.m.GroupName string 許可するファイアウォールグループ名
○ (IpPermissions.n.IpRanges.m.CidrIpといずれか)
IpPermissions.n.IpRanges.m.CidrIp string 許可するIPアドレス(IPv4, IPv6)
○ (IpPermissions.n.Groups.m.GroupNameといずれか)
IpPermissions.n.Description string 許可ルールのメモ

応答フィールド

フィールド (項目) 説明
AuthorizeSecurityGroupIngressResponse - AuthorizeSecurityGroupIngress レスポンス
Ancestor: なし
Children: requestId | return
requestId string リクエスト識別子
Ancestor: AuthorizeSecurityGroupIngressResponse
Children: なし
return boolean 処理ステータス
値: true(成功)
Ancestor: AuthorizeSecurityGroupIngressResponse
Children: なし

リクエストサンプル

    https://jp-east-1.computing.api.nifcloud.com/api/
  ?Action= AuthorizeSecurityGroupIngress
  &GroupName=group01 
  &IpPermissions.1.IpProtocol=TCP
  &IpPermissions.1.FromPort=80 
  &IpPermissions.1.ToPort=81 
  &IpPermissions.1.IpRanges.1.CidrIp=0.0.0.0/0
  &IpPermissions.1.IpRanges.2.CidrIp=1:1:1:1:1:1:1:1/64
  &IpPermissions.1.Description=GroupMemoUpdate
  &CommonParams

  

応答サンプル

    <AuthorizeSecurityGroupIngressResponse xmlns="https://computing.api.nifcloud.com/api/">
  <requestId>ac501097-4c8d-475b-b06b-a90048ec181c</requestId>
  <return>true</return>
</AuthorizeSecurityGroupIngressResponse>

  

ニフクラ サイト内検索

APIメニュー

  • ツイッターでフォローしてください
  • ニフクラ公式フェイスブックページ

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