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를 사용하여 출력 메시지에 값을 추가할 수도 있습니다.

특정 리소스 또는 속성의 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인 문자열을 지정해야 합니다.