AWS::AppMesh::Mesh - AWS CloudFormation

AWS::AppMesh::Mesh

サービスメッシュを作成します。

サービスメッシュは、メッシュ内のリソースによって表されるサービス間のネットワークトラフィックの論理的な境界です。サービスメッシュを作成したら、仮想サービス、仮想ノード、仮想ルーター、およびルートを作成して、メッシュ内のアプリケーション間でトラフィックを分散させることができます。

サービスメッシュの詳細については、「サービスメッシュ」を参照してください。

構文

AWS CloudFormation テンプレートでこのエンティティを宣言するには、次の構文を使用します。

JSON

{ "Type" : "AWS::AppMesh::Mesh", "Properties" : { "MeshName" : String, "Spec" : MeshSpec, "Tags" : [ Tag, ... ] } }

YAML

Type: AWS::AppMesh::Mesh Properties: MeshName: String Spec: MeshSpec Tags: - Tag

プロパティ

MeshName

サービスメッシュに使用する名前。

必須: はい

タイプ: 文字列

Update requires: Replacement

Spec

適用するサービスメッシュの仕様。

必須: いいえ

タイプ: MeshSpec

Update requires: No interruption

Tags

サービスメッシュに適用して分類と組織化に利用できるオプションのメタデータ。タグはそれぞれ、1 つのキーとオプションの 1 つの値で構成されており、どちらもお客様側が定義します。タグキーの最大文字数は 128 文字、タグ値の最大長は 256 文字です。

必須: いいえ

タイプ: Tag のリスト

Update requires: No interruption

戻り値

参照番号

このリソースの論理 ID を組み込みの Ref 関数に渡すと、Ref は次を返します: リソース ARN。例:

{ "Ref": "myMesh" }

AWS::AppMesh::Mesh リソースの論理 ID を Ref 組み込み関数に渡すと、その関数はメッシュ ARN (arn:aws:appmesh:us-east-1:555555555555:mesh/myMesh など) を返します。

For more information about using the Ref function, see Ref.

Fn::GetAtt

Fn::GetAtt 組み込み関数は、このタイプの指定された属性の値を返します。以下には、利用可能な属性とサンプル戻り値のリストが示されます。

Fn::GetAtt 組み込み関数の使用方法の詳細については、「Fn::GetAtt」を参照してください。

Arn

メッシュの完全な Amazon リソースネーム (ARN)。

MeshName

サービスメッシュの名前。

MeshOwner

サービスメッシュ所有者の AWS IAM アカウント ID。アカウント ID が自分のものでない場合は、自分のアカウントとメッシュを共有したアカウントの ID です。メッシュ共有の詳細については、「Working with shared meshes」を参照してください。

ResourceOwner

リソース所有者の AWS IAM アカウント ID。アカウント ID が自分のものでない場合は、メッシュの所有者またはメッシュが共有されている別のアカウントの ID です。メッシュ共有の詳細については、「Working with shared meshes」を参照してください。

Uid

メッシュの一意の識別子。

サービスメッシュの作成

この例では、すべての送信トラフィックを許可するメッシュサービスを作成します。

JSON

{ "Description": "Basic Test Mesh", "Resources": { "BasicMesh": { "Type": "AWS::AppMesh::Mesh", "Properties": { "MeshName": "BasicMesh1", "Spec": { "EgressFilter": { "Type": "ALLOW_ALL" } }, "Tags": [ { "Key": "Key1", "Value": "Value1" }, { "Key": "Key2", "Value": "Value2" } ] } } }, "Outputs": { "MeshName": { "Description": "Name of the Mesh", "Value": { "Fn::GetAtt": [ "BasicMesh", "MeshName" ] } }, "Arn": { "Description": "Arn of the Mesh created", "Value": { "Fn::GetAtt": [ "BasicMesh", "Arn" ] } }, "Uid": { "Description": "Uid of the Mesh created", "Value": { "Fn::GetAtt": [ "BasicMesh", "Uid" ] } } } }

YAML

Description: "Basic Test Mesh" Resources: BasicMesh: Type: "AWS::AppMesh::Mesh" Properties: MeshName: "BasicMesh1" Spec: EgressFilter: Type: "ALLOW_ALL" Tags: - Key: "Key1" Value: "Value1" - Key: "Key2" Value: "Value2" Outputs: MeshName: Description: Name of the Mesh Value: Fn::GetAtt: - BasicMesh - MeshName Arn: Description: Arn of the Mesh created Value: Fn::GetAtt: - BasicMesh - Arn Uid: Description: Uid of the Mesh created Value: Fn::GetAtt: - BasicMesh - Uid

以下の資料も参照してください。