기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Cloud Control API 리소스 유형 사용

에서 리소스 유형을 사용하려면 AWS Cloud Control API해당 리소스 유형이 에 존재하고 활성화되어 있어야 합니다 AWS 계정. 지원되는 AWS 리소스 유형은 퍼블릭이며 항상 활성화됩니다. AWS CloudFormation 확장 레지스트리를 통해 타사 게시자가 제공하는 퍼블릭 리소스 유형을 활성화하도록 선택할 수 있습니다.

확장 레지스트리는 계정에서 사용할 수 AWS CloudFormation 있는 리소스 유형에 대한 자세한 정보가 포함된 의 기능입니다. 여기에는 타사에서 게시한 리소스 유형 외에도 AWS에서 게시한 리소스 유형이 포함될 수 있습니다. 레지스트리를 사용하여 계정에서 다음과 같은 리소스 유형을 관리할 수 있습니다.

AWS CloudFormation 레지스트리를 사용하여 속성 정의 및 권한 요구 사항API과 같이 Cloud Control 에서 리소스를 사용하는 방법에 대한 중요한 정보가 포함된 리소스 유형의 스키마를 볼 수도 있습니다. 자세한 내용은 리소스 유형 스키마 보기 단원을 참조하십시오.

레지스트리는 CloudFormation 콘솔과 를 CloudFormation 통해 사용할 수 있습니다API.

리소스 유형 관리 옵션에 대한 자세한 내용은 AWS CloudFormation 사용 설명서의 CloudFormation 레지스트리 사용을 참조하세요.

를 사용하여 리소스 유형 관리 AWS CloudFormation API

AWS CloudFormation 콘솔을 통해 확장 레지스트리에 액세스하는 것 외에도 AWS CloudFormation API에 포함된 작업을 사용하여 계정의 리소스 유형을 식별하고 관리할 수 있습니다. 아래 표에는 계정에서 사용 가능한 리소스 유형을 검색, 활성화 및 구성하는 데 사용할 수 있는 API 작업이 나열되어 있습니다.

리소스 유형이 Cloud Control을 지원하는지 확인 API

기본적으로 CloudFormation 레지스트리에 게시된 리소스 유형은 Cloud Control API 리소스 작업을 자동으로 지원합니다. 여기에는 퍼블릭 타사 리소스 유형뿐 아니라 프라이빗 리소스 유형도 포함됩니다. 그러나 AWS CloudFormation 레지스트리에는 프로비저닝할 수 없는 로 분류된 레거시 리소스 유형도 포함되어 있습니다. 이러한 리소스 유형은 현재 Cloud Control 을 지원하지 API않으며 리소스 작업에 사용할 수 없습니다.

현재 Cloud Control 리소스 작업을 지원하는 AWS 퍼블릭 API 리소스 유형의 목록은 섹션을 참조하세요Cloud Control을 지원하는 리소스 유형 API.

AWS Command Line Interface (AWS CLI)를 사용하여 지원되는 리소스 유형 목록을 생성하거나 특정 리소스 유형이 Cloud Control 를 지원하는지 확인할 수도 있습니다API.

리소스 유형 스키마 보기

리소스 생성 및 업데이트 작업 중에 설정할 리소스 속성과 해당 값을 지정합니다. 리소스의 속성은 리소스 유형 스키마에 정의되어 있습니다. 여기에는 데이터 유형, 속성 필수 여부, 유효한 값 및 기타 속성 제약 조건이 포함됩니다.

CloudFormation 콘솔 또는 를 사용하여 리소스 유형의 스키마를 볼 수 있습니다 AWS CLI. 또한 AWS CloudFormation 사용 설명서에는 AWS 가 게시하는 각 사용 가능한 리소스 유형에 대한 참조 주제가 포함되어 있습니다. 사용 예와 함께 리소스 유형 속성에 대한 자세한 내용은 AWS 리소스 및 속성 유형 참조 섹션의 해당 항목을 참조하세요.

리소스 유형 스키마를 작성하는 방법을 정의하는 리소스 유형 정의 스키마CloudFormation CLI에 대한 자세한 내용은 확장 개발 사용 설명서의 리소스 유형 정의 스키마를 참조하세요.

현재 속성 값을 포함하는 기존 리소스의 현재 상태를 보는 방법에 대한 자세한 내용은 섹션을 참조하세요를 사용하여 리소스 읽기 AWS Cloud Control API.

리소스 속성 속성 보기

리소스 유형 속성은 리소스 유형 스키마의 properties 섹션에서 정의됩니다. 여기에는 속성 데이터 유형, 속성의 필수 여부, 허용 값 또는 필수 패턴과 같은 제약 조건이 포함됩니다.

또한 리소스 수준에서 설정된 특정 속성에 따라 속성을 지정할 수 있는 시기와 여부가 결정됩니다. 여기에는 다음이 포함됩니다.

지원되는 리소스 작업 보기

리소스 유형 스키마의 handlers 섹션을 참조하여 리소스 유형이 지원하는 작업을 확인할 수 있습니다. 리소스 유형이 작업을 지원하는 경우 해당 작업은 handlers 섹션에 나열되며 여기에는 처리기에 필요한 권한을 나열하는 permissions 요소가 포함됩니다.

예를 들어, 아래는 AWS::Logs::LogGroup 리소스 유형에 대한 리소스 유형 스키마의 handlers 섹션입니다. 이 섹션에서는 이 리소스 유형이 다섯 가지 리소스 작업을 모두 지원한다는 것을 보여주고 각 처리기에 필요한 권한을 나열합니다.

  "handlers": {
    "create": {
      "permissions": [
        "logs:DescribeLogGroups",
        "logs:CreateLogGroup",
        "logs:PutRetentionPolicy"
      ]
    },
    "read": {
      "permissions": [
        "logs:DescribeLogGroups"
      ]
    },
    "update": {
      "permissions": [
        "logs:DescribeLogGroups",
        "logs:AssociateKmsKey",
        "logs:DisassociateKmsKey",
        "logs:PutRetentionPolicy",
        "logs:DeleteRetentionPolicy"
      ]
    },
    "delete": {
      "permissions": [
        "logs:DescribeLogGroups",
        "logs:DeleteLogGroup"
      ]
    },
    "list": {
      "permissions": [
        "logs:DescribeLogGroups"
      ]
    }
  }