AuthorizeSecurityGroup

セキュリティグループに受信ルールを追加します。このアクションは、他のデバイスから指定されたセキュリティグループ内のインスタンスへのインバウンドトラフィックを許可または拒否します。

説明

トラフィックの始点を送信元、トラフィックの終点を宛先とします。次の図を参照してください。

このインターフェイスを呼び出すときは、次の点を考慮してください。

• 1 つのセキュリティグループに最大 100 の認証ルールを追加できます。

• 許可ポリシーを acceptまたはdropに設定することができます。

• セキュリティグループの「優先度」は 1 〜 100 の範囲です。ここでは、数値が小さいほど優先度が高くなります。

• 複数の許可規則の優先順位が同じ場合、 drop規則が優先されます。

• セキュリティグループルールを追加するには、次の 2 つのパラメータセットを使用します。一つのルールがすでに 2 組のパラメータに応じて存在している場合、AuthorizeSecurityGroup は失敗します。

  • IP アドレス範囲のアクセス許可を設定するには、たとえば、リクエスト例 1：IpProtocol、PortRange、（オプション）SourcePortRange、NicType、Policy、（オプション）DestCiderIp および SourceCidrIp を指定します。

  • 別のセキュリティグループにあるインスタンスのアクセス許可を設定するには、IpProtocol、PortRange、（オプション）SourcePortRange、NicType、Policy、（オプション）DestCiderIp、SourceGroupOwnerAccount、および SourceGroupId を指定します。

リクエストパラメータ

レスポンスパラメータ

すべて共通のパラメータです。詳細は、コモンパラメーターを参照してください。

例

リクエスト例 1

指定された IP アドレス範囲にアクセス許可を与えます。インターネットまたはイントラネットへのクラシックネットワークに接続されたセキュリティグループのために NicType を設定することができます。VPC に接続されたセキュリティグループの NicType だけでイントラネットに設定することができます。

https://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroup
&SecurityGroupId=sg-F876FF7BA
&SourceCidrIp=0.0.0.0/0
&IpProtocol=tcp
&PortRange=1/65535
&NicType=intranet
&Policy=Allow
&<Common Request Parameters>

リクエスト例 2

別のセキュリティグループのアクセス許可を与えます。NicType だけでイントラネットに設定することができます。クラシックネットワーク接続のセキュリティグループ間の相互のアクセスのために、セキュリティグループにアクセスするには、同じリージョン内の別のセキュリティグループのアクセス許可を設定することができます。このセキュリティグループがご自身に属するものであるか、または他の SourceGroupOwnerAccount に属するかを設定できます。VPC に接続されたセキュリティグループ間の相互のアクセスのために、ご自身のセキュリティグループにアクセスするには、同じ VPC 内の別のセキュリティグループのアクセス許可を設定します。

https://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroup
&SecurityGroupId=sg-F876FF7BA
&SourceGroupId=sg-1651FBB64
&SourceGroupOwnerAccount=test@aliyun.com
&IpProtocol=tcp
&PortRange=1/65535
&NicType=intranet
&Policy=Drop
&<Common Request Parameters>

レスポンスの例

XML 形式

<AuthorizeSecurityGroupResponse>
    <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
</AuthorizeSecurityGroupResponse>

JSON 形式

{
    "RequestId":"CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}

エラーコード

このインタフェースに固有のエラーコードは次のとおりです。エラーコードの詳細については、API のエラー・センターを参照してください。