CreateFramework - AWS Backup
Request SyntaxURI 요청 파라미터요청 본문응답 구문응답 요소오류참고

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

CreateFramework

하나 이상의 컨트롤이 있는 프레임워크를 생성합니다. 프레임워크는 백업 방식을 평가하는 데 사용할 수 있는 컨트롤의 모음입니다. 사전 구축된 사용자 지정 가능한 컨트롤을 사용하여 정책을 정의하면 백업 방식이 정책을 준수하는지 여부와 아직 준수하지 않는 리소스를 평가할 수 있습니다.

Request Syntax

POST /audit/frameworks HTTP/1.1
Content-type: application/json

{
   "FrameworkControls": [ 
      { 
         "ControlInputParameters": [ 
            { 
               "ParameterName": "string",
               "ParameterValue": "string"
            }
         ],
         "ControlName": "string",
         "ControlScope": { 
            "ComplianceResourceIds": [ "string" ],
            "ComplianceResourceTypes": [ "string" ],
            "Tags": { 
               "string" : "string" 
            }
         }
      }
   ],
   "FrameworkDescription": "string",
   "FrameworkName": "string",
   "FrameworkTags": { 
      "string" : "string" 
   },
   "IdempotencyToken": "string"
}

URI 요청 파라미터

요청은 URI 파라미터를 사용하지 않습니다.

요청 본문

요청은 JSON 형식으로 다음 데이터를 받습니다.

FrameworkControls

프레임워크를 구성하는 컨트롤입니다. 목록의 각 컨트롤에는 이름, 입력 파라미터, 범위가 있습니다.

타입: FrameworkControl객체 배열

필수 여부: 예

FrameworkDescription

프레임워크에 대한 최대 1,024자의 설명(선택 사항)입니다.

유형: 문자열

길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 1024입니다.

패턴: .*\S.*

필수 여부: 아니요

FrameworkName

프레임워크의 고유 이름입니다. 이름은 문자로 시작하고 문자(a~z, A~Z), 숫자(0~9) 및 밑줄(_)로 구성된 1~256자여야 합니다.

유형: 문자열

길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다.

패턴: [a-zA-Z][_a-zA-Z0-9]*

필수 여부: 예

FrameworkTags

프레임워크에 할당할 태그입니다.

유형: 문자열 대 문자열 맵

필수 여부: 아니요

IdempotencyToken

고객이 선택한 문자열로, CreateFrameworkInput에 대한 동일한 호출을 구분하는 데 사용할 수 있습니다. 동일한 멱등성 토큰으로 성공적인 요청을 다시 시도하면 아무런 작업 없이 성공 메시지가 표시됩니다.

유형: 문자열

필수사항: 아니요

응답 구문

HTTP/1.1 200
Content-type: application/json

{
   "FrameworkArn": "string",
   "FrameworkName": "string"
}

응답 요소

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

FrameworkArn

리소스를 고유하게 식별하는 Amazon 리소스 이름(ARN)입니다. ARN의 형식은 리소스 유형에 따라 달라집니다.

유형: 문자열

FrameworkName

프레임워크의 고유 이름입니다. 이름은 문자로 시작하고 문자(a~z, A~Z), 숫자(0~9) 및 밑줄(_)로 구성된 1~256자여야 합니다.

유형: 문자열

길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다.

패턴: [a-zA-Z][_a-zA-Z0-9]*

오류

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하세요.

AlreadyExistsException

필수 리소스가 이미 존재합니다.

Arn

Context

CreatorRequestId

Type

HTTP 상태 코드: 400

InvalidParameterValueException

파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.

Context

Type

HTTP 상태 코드: 400

LimitExceededException

요청의 한도가 초과되었습니다(예: 요청에 허용되는 최대 항목 수).

Context

Type

HTTP 상태 코드: 400

MissingParameterValueException

필수 파라미터가 누락되었음을 나타냅니다.

Context

Type

HTTP 상태 코드: 400

ServiceUnavailableException

요청이 서버의 일시적 장애 때문에 실패했습니다.

Context

Type

HTTP 상태 코드: 500

참고

언어별 AWS SDKs