사용자 지정 리소스 요청 객체

이 주제에서는 CloudFormation 사용자 지정 리소스에 대한 요청 객체의 속성을 설명합니다.

사용자 지정 리소스의 소개와 작동 방식은 사용자 정의 리소스 섹션을 참조하세요.

템플릿 개발자 요청 속성

템플릿 개발자는 CloudFormation 리소스 AWS::CloudFormation::CustomResource를 사용하여 템플릿에서 사용자 지정 리소스를 지정합니다.

AWS::CloudFormation::CustomResource에서 모든 속성은 custom resource provider에 의해 정의됩니다. 유일한 필수 속성은 ServiceToken입니다.

ServiceTimeout

사용자 지정 리소스 작업이 유지되는 최대 시간(초)을 지정할 수 있습니다. 이 시간이 지나면 작업이 시간 초과됩니다.

값은 1 ~ 3600 사이의 정수여야 합니다. 기본값은 3600초(1시간)입니다.

필수 항목 여부: 아니요

유형: 문자열

ServiceToken

Amazon SNS 주제 ARN, Lambda 함수 ARN 등과 같은 서비스 토큰입니다. 서비스 토큰은 스택과 같은 리전에서 가져와야 합니다.

필수 항목 여부: 예

유형: 문자열

리소스 속성의 기타 모든 필드는 선택 사항으로, 요청자의 ResourceProperties 필드에 있는 custom resource provider로 있는 그대로 전송됩니다. 공급자가 이러한 필드의 이름 및 유효한 내용을 둘 다 정의합니다.

사용자 지정 리소스 공급자 요청 필드

다음 필드는 CloudFormation에서 이러한 용도로 공급자가 구성한 SNS 주제의 사용자 지정 리소스 공급자에게 JSON 요청으로 전송됩니다.

RequestType

요청 유형은 사용자 지정 리소스가 포함된 스택에 대해 템플릿 개발자에서 시작한 CloudFormation 스택 작업(create-stack, update-stack 또는 delete-stack)에 따라 설정됩니다.

Create, Update 또는 Delete 중 하나여야 합니다. 자세한 내용은 사용자 지정 리소스 요청 유형 단원을 참조하십시오.

필수 항목 여부: 예

유형: 문자열

ResponseURL

응답 URL은 사용자 지정 리소스 공급자에서 AWS CloudFormation에 보내는 응답을 수신할 미리 서명된 S3 버킷을 나타냅니다.

필수 항목 여부: 예

유형: 문자열

StackId

사용자 지정 리소스가 들어 있는 스택을 나타내는 Amazon 리소스 이름(ARN).

StackId와 RequestId를 조합하여 만든 값으로 특정한 사용자 지정 리소스에 대한 요청을 고유하게 식별할 수 있습니다.

필수 항목 여부: 예

유형: 문자열

RequestId

요청에 대한 고유 ID입니다.

StackId와 RequestId를 조합하여 만든 값으로 특정한 사용자 지정 리소스에 대한 요청을 고유하게 식별할 수 있습니다.

필수 항목 여부: 예

유형: 문자열

ResourceType

CloudFormation 템플릿에서 사용자 지정 리소스의 템플릿 개발자가 선택한 리소스 유형입니다. 사용자 지정 리소스 유형 이름은 최대 60자이고 영숫자 및 다음 문자를 포함할 수 있습니다. _@-

필수 항목 여부: 예

유형: 문자열

LogicalResourceId

AWS CloudFormation 템플릿에 있는 사용자 지정 리소스의 템플릿 개발자 선택 이름(논리적 ID). 이는 사용자 지정 리소스 공급자와 템플릿 개발자 간의 통신을 용이하게 하기 위해 제공됩니다.

필수 항목 여부: 예

유형: 문자열

PhysicalResourceId

custom resource provider에서 정의한 필수 Physical ID로, 해당 공급자에 대해 고유합니다.

PhysicalResourceId에 대해 반환된 값은 사용자 지정 리소스 업데이트 작업을 변경할 수 있습니다. 반환된 값이 같은 경우 일반 업데이트로 간주됩니다. 반환된 값이 다른 경우 AWS CloudFormation은 업데이트를 교체로 인식하고 기존 리소스에 삭제 요청을 전송합니다. 자세한 내용은 AWS::CloudFormation::CustomResource 단원을 참조하십시오.

필수: 항상 Update 및 Delete 요청과 함께 전송되며 Create와 함께 전송되지 않습니다.

유형: 문자열

ResourceProperties

이 필드에는 템플릿 개발자가 보낸 Properties 객체의 내용이 들어 있습니다. 해당 콘텐츠는 사용자 지정 리소스 공급자에 의해 정의됩니다.

필수 항목 여부: 아니요

유형: JSON 객체

OldResourceProperties

Update 요청에만 사용됩니다. 업데이트 요청 이전에 선언된 리소스 속성이 들어 있습니다.

필수 항목 여부: 예

유형: JSON 객체