すべてのプロダクト
Search
ドキュメントセンター

Resource Orchestration Service:ALIYUN::ALB::AclAssociation

最終更新日:Jan 16, 2025

ALIYUN::ALB::AclAssociation は、アクセス制御リスト (ACL) をリスナーに関連付けるために使用されます。

構文

{
  "Type": "ALIYUN::ALB::AclAssociation",
  "Properties": {
    "AclType": String,
    "AclIds": List,
    "ListenerId": String
  }
}

プロパティ

プロパティ

タイプ

必須

編集可能

説明

制約

AclIds

List

はい

はい

ACL ID。

最大 3 つの ID を指定できます。

AclType

String

はい

いいえ

ACL タイプ。

有効な値:

  • White: ホワイトリスト。 ACL 内の IP アドレスまたは CIDR ブロックからのリクエストのみが転送されます。 特定の IP アドレスからのアプリケーションへのアクセスのみを許可する場合に、ホワイトリストを使用できます。

    ホワイトリストの設定が不適切だと、サービスの可用性に影響を与える可能性があります。 ホワイトリストが設定されている場合、リスナーはホワイトリストに追加されている IP アドレスからのリクエストのみを転送します。

    ホワイトリストが設定されていても、ホワイトリストに IP アドレスが追加されていない場合、リスナーはすべてのリクエストを転送します。

  • Black: ブラックリスト。 ACL 内の IP アドレスまたは CIDR ブロックからのリクエストは転送されません。 特定の IP アドレスからのアプリケーションへのアクセスを拒否する場合に、ブラックリストを使用できます。

    ブラックリストを有効にしても、ACL に IP アドレスを追加しない場合、リスナーはすべてのリクエストを転送します。

ListenerId

String

はい

いいえ

リスナー ID。

なし。

戻り値

Fn::GetAtt

ListenerId: リスナー ID。

YAML 形式

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  AclIds:
    Description: ACL の ID。一度に最大 3 つの ID を指定できます。
    MaxLength: 3
    MinLength: 1
    Type: Json
  AclType:
    AllowedValues:
    - White
    - Black
    Description: ACL のタイプ。
    Type: String
  ListenerId:
    Description: リスナーの ID。
    Type: String
Resources:
  AclAssociation:
    Properties:
      AclIds:
        Ref: AclIds
      AclType:
        Ref: AclType
      ListenerId:
        Ref: ListenerId
    Type: ALIYUN::ALB::AclAssociation
Outputs:
  ListenerId:
    Description: リスナーの ID。
    Value:
      Fn::GetAtt:
      - AclAssociation
      - ListenerId

JSON 形式

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "AclType": {
      "Type": "String",
      "Description": "ACL のタイプ。",
      "AllowedValues": [
        "White",
        "Black"
      ]
    },
    "AclIds": {
      "Type": "Json",
      "Description": "ACL の ID。一度に最大 3 つの ID を指定できます。",
      "MinLength": 1,
      "MaxLength": 3
    },
    "ListenerId": {
      "Type": "String",
      "Description": "リスナーの ID。"
    }
  },
  "Resources": {
    "AclAssociation": {
      "Type": "ALIYUN::ALB::AclAssociation",
      "Properties": {
        "AclType": {
          "Ref": "AclType"
        },
        "AclIds": {
          "Ref": "AclIds"
        },
        "ListenerId": {
          "Ref": "ListenerId"
        }
      }
    }
  },
  "Outputs": {
    "ListenerId": {
      "Description": "リスナーの ID。",
      "Value": {
        "Fn::GetAtt": [
          "AclAssociation",
          "ListenerId"
        ]
      }
    }
  }
}