2021-11-19
AWS – ターゲットグループ情報の取得
概要
ターゲットグループの情報を取得する方法について記載しています。
ターゲットグループ
1 つ以上の登録されているターゲットにリクエストをルーティングするために使用されます。各リスナーのルールを作成するときに、ターゲットグループと条件を指定します。ルールの条件が満たされると、トラフィックが該当するターゲットグループに転送されます。
手順
aws elbv2 describe-target-groups実行結果
TEXT
TARGETGROUPS 30 / traffic-port HTTP 5 5 80 HTTP arn:aws:elasticloadbalancing:ap-northeast-1:987654321000:targetgroup/tg-alb-ext/7624b0e9f83ad82* tg-alb-ext instance 2 vpc-8db025e*
LOADBALANCERARNS arn:aws:elasticloadbalancing:ap-northeast-1:987654321000:loadbalancer/app/alb-ext/a54953361b2ea5c*
MATCHER 200
TABLE
------------------------------------------------------------------------------------------------------------------------------------------
| DescribeTargetGroups |
+----------------------------------------------------------------------------------------------------------------------------------------+
|| TargetGroups ||
|+----------------------------+---------------------------------------------------------------------------------------------------------+|
|| HealthCheckIntervalSeconds| 30 ||
|| HealthCheckPath | / ||
|| HealthCheckPort | traffic-port ||
|| HealthCheckProtocol | HTTP ||
|| HealthCheckTimeoutSeconds | 5 ||
|| HealthyThresholdCount | 5 ||
|| Port | 80 ||
|| Protocol | HTTP ||
|| TargetGroupArn | arn:aws:elasticloadbalancing:ap-northeast-1:987654321000:targetgroup/tg-alb-ext/7624b0e9f83ad82* ||
|| TargetGroupName | tg-alb-ext ||
|| TargetType | instance ||
|| UnhealthyThresholdCount | 2 ||
|| VpcId | vpc-8db025e* ||
|+----------------------------+---------------------------------------------------------------------------------------------------------+|
||| LoadBalancerArns |||
||+------------------------------------------------------------------------------------------------------------------------------------+||
||| arn:aws:elasticloadbalancing:ap-northeast-1:987654321000:loadbalancer/app/alb-ext/a54953361b2ea5c* |||
||+------------------------------------------------------------------------------------------------------------------------------------+||
||| Matcher |||
||+-----------------------------------------------------------------------------------+------------------------------------------------+||
||| HttpCode | 200 |||
||+-----------------------------------------------------------------------------------+------------------------------------------------+||
JSON
{
"TargetGroups": [
{
"HealthCheckPath": "/",
"HealthCheckIntervalSeconds": 30,
"VpcId": "vpc-8db025e*",
"Protocol": "HTTP",
"HealthCheckTimeoutSeconds": 5,
"TargetType": "instance",
"HealthCheckProtocol": "HTTP",
"LoadBalancerArns": [
"arn:aws:elasticloadbalancing:ap-northeast-1:987654321000:loadbalancer/app/alb-ext/a54953361b2ea5c*"
],
"UnhealthyThresholdCount": 2,
"HealthyThresholdCount": 5,
"TargetGroupArn": "arn:aws:elasticloadbalancing:ap-northeast-1:987654321000:targetgroup/tg-alb-ext/7624b0e9f83ad82*",
"Matcher": {
"HttpCode": "200"
},
"HealthCheckPort": "traffic-port",
"Port": 80,
"TargetGroupName": "tg-alb-ext"
}
]
}
出力結果から以下の項目が取得できます。
| 項目 | 形式 | 説明 | 対応箇所 |
|---|---|---|---|
| TargetGroupArn | string | ターゲットグループのAmazonリソース名（ARN）。 | ARN |
| TargetGroupName | string | ターゲットグループの名前。 | 名前 |
| Protocol | string | トラフィックをターゲットにルーティングするために使用するプロトコル。 | プロトコル |
| Port | integer | ターゲットがリスンしているポート。 | ポート |
| VpcId | string | ターゲットのVPCのID。 | VPC |
| HealthCheckProtocol | string | ターゲットとの接続に使用するプロトコル。 | ヘルスチェック – プロトコル |
| HealthCheckPort | string | ターゲットとの接続に使用するポート。 | ヘルスチェック – ポート |
| HealthCheckIntervalSeconds | integer | 個々のターゲットの正常性チェックの間の概算時間（秒単位）。 | ヘルスチェック – 間隔 |
| HealthCheckTimeoutSeconds | integer | 応答が失敗したヘルスチェックを意味する時間の長さ（秒単位）。 | ヘルスチェック – タイムアウト |
| HealthyThresholdCount | integer | 健康でないターゲットを健康なものと考える前に、連続した健康チェックの成功回数が必要です。 | ヘルスチェック – 正常のしきい値 |
| UnhealthyThresholdCount | integer | ターゲットが不健康であると考える前に、連続した正常性検査失敗の回数。 | ヘルスチェック – 非正常のしきい値 |
| HealthCheckPath | string | ヘルスチェック要求の宛先。 | ヘルスチェック – パス |
| Matcher | structure | ターゲットからの正常な応答をチェックするときに使用するHTTPコード。 | – |
| HttpCode | string | HTTPコード。 | ヘルスチェック – 成功コード |
| LoadBalancerArns | list | このターゲットグループにトラフィックをルーティングするロードバランサのAmazonリソース名（ARN）。 | Load Balancer |
| TargetType | string | このターゲットグループにターゲットを登録する際に指定する必要のあるターゲットのタイプ。指定できる値は、インスタンス（ターゲットはインスタンスIDで指定）またはIP（ターゲットはIPアドレスで指定）です。 | ターゲットの種類 |
名前：TRUE's。
千葉県育ち、神奈川県在住のIT系フリーエンジニア。
IT系のナレッジサイトを不定期で更新中。
フォトグラファー兼エンジニアとして日々勤しんでいる。