本文へジャンプします。

ニフクラ ユーザーガイド

クラウド トップ>API> コンピューティング> AuthorizeSecurityGroupIngress
本ページは2023/9/5をもって、新ページhttps://docs.nifcloud.com/cp/api/AuthorizeSecurityGroupIngress.htmへ移行しました。 今後は新ページをご参照ください。

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 レスポンス
requestId string リクエスト識別子
return boolean 処理ステータス
値:
  • true (成功)

リクエストサンプル

    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メニュー

  • ツイッターでフォローしてください
  • ニフクラ公式フェイスブックページ
  • ※本ページ記載の金額は、すべて税抜表示です。
  • ※本ページ記載の他社製品名および会社名などは、各社の商標または登録商標です。
  • ※本ページの内容は、2023年9月05日時点の情報です。

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