AWS CloudFormation
사용 설명서 (API 버전 2010-05-15)

Ref

Ref 내장 함수는 지정된 파라미터 또는 리소스에 대한 정보를 반환합니다.

  • 파라미터의 논리적 이름을 지정하면 파라미터의 값이 반환됩니다.

  • 리소스의 논리적 이름을 지정하면 해당 리소스를 참조하는 데 일반적으로 사용할 수 있는 값이 반환됩니다(예: 물리적 ID).

템플릿에서 리소스를 선언하는 데 이름으로 또 다른 템플릿 리소스를 지정해야 하는 경우 Ref를 사용하여 해당하는 다른 리소스를 참조할 수 있습니다. 일반적으로, Ref는 리소스의 이름을 반환합니다. 예를 들어 AWS::AutoScaling::AutoScalingGroup에 대한 참조는 Auto Scaling 그룹 리소스의 이름을 반환합니다.

일부 리소스의 경우 리소스 측면에서 또 다른 중요한 의미를 지닌 식별자가 반환됩니다. 예를 들어, AWS::EC2::EIP 리소스는 IP 주소를, AWS::EC2::Instance는 인스턴스 ID를 반환합니다.

작은 정보

또한 Ref를 사용하여 출력 메시지에 값을 추가할 수도 있습니다.

특정 리소스 또는 속성의 Ref 반환 값에 대한 자세한 내용은 리소스 및 속성 참조의 해당 리소스 또는 속성에 대한 설명서를 참조하십시오.

선언

JSON

{ "Ref" : "logicalName" }

YAML

전체 함수 이름의 구문:

Ref: logicalName

짧은 형식의 구문:

!Ref logicalName

파라미터

logicalName

역참조하려는 리소스 또는 파라미터의 논리적 이름입니다.

반환 값

리소스의 물리적 ID 또는 파라미터의 값입니다.

탄력적 IP 주소에 대한 다음 리소스 선언에는 EC2 인스턴스의 인스턴스 ID가 필요하고 이 선언에서는 Ref 함수를 사용하여 MyEC2Instance 리소스의 인스턴스 ID를 지정합니다.

JSON

"MyEIP" : { "Type" : "AWS::EC2::EIP", "Properties" : { "InstanceId" : { "Ref" : "MyEC2Instance" } } }

YAML

MyEIP: Type: "AWS::EC2::EIP" Properties: InstanceId: !Ref MyEC2Instance

지원되는 함수

Ref 함수에서는 어떠한 함수도 사용할 수 없습니다. 리소스 논리적 ID인 문자열을 지정해야 합니다.