DescribeFramework - AWS Backup

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

DescribeFramework

지정된 FrameworkName에 대한 프레임워크 세부 정보를 반환합니다.

Request Syntax

GET /audit/frameworks/frameworkName HTTP/1.1

URI 요청 파라미터

요청은 다음 URI 파라미터를 사용합니다.

frameworkName

프레임워크의 고유 이름입니다.

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

Pattern: [a-zA-Z][_a-zA-Z0-9]*

필수 여부: 예

Request Body

해당 요청에는 본문이 없습니다.

Response Syntax

HTTP/1.1 200 Content-type: application/json { "CreationTime": number, "DeploymentStatus": "string", "FrameworkArn": "string", "FrameworkControls": [ { "ControlInputParameters": [ { "ParameterName": "string", "ParameterValue": "string" } ], "ControlName": "string", "ControlScope": { "ComplianceResourceIds": [ "string" ], "ComplianceResourceTypes": [ "string" ], "Tags": { "string" : "string" } } } ], "FrameworkDescription": "string", "FrameworkName": "string", "FrameworkStatus": "string", "IdempotencyToken": "string" }

Response Elements

작업이 성공하면 서비스가 HTTP 200개의 응답을 다시 보냅니다.

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

CreationTime

프레임워크가 생성된 날짜 및 시간으로, ISO 8601 표현으로 표시됩니다. CreationTime의 값은 밀리초 단위로 정확합니다. 예를 들어 2020-07-10T15:00:00.000-08:00은 8시간 후 오후 3시에 2020년 7월 10일을 나타냅니다UTC.

유형: 타임스탬프

DeploymentStatus

프레임워크의 배포 상태입니다. 상태는 다음과 같습니다.

CREATE_IN_PROGRESS | UPDATE_IN_PROGRESS | DELETE_IN_PROGRESS | COMPLETED | FAILED

유형: 문자열

FrameworkArn

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

유형: 문자열

FrameworkControls

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

유형: FrameworkControl객체 어레이

FrameworkDescription

프레임워크에 대한 설명입니다(선택 사항).

유형: 문자열

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

패턴: .*\S.*

FrameworkName

프레임워크의 고유 이름입니다.

유형: 문자열

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

Pattern: [a-zA-Z][_a-zA-Z0-9]*

FrameworkStatus

프레임워크는 하나 이상의 컨트롤로 구성됩니다. 각 컨트롤은 백업 계획, 백업 선택, 백업 저장소 또는 복구 시점과 같은 리소스를 제어합니다. 또한 각 리소스에 대한 AWS Config 기록을 켜거나 끌 수 있습니다. 상태는 다음과 같습니다.

  • ACTIVE - 프레임워크가 제어하는 모든 리소스에 대해 기록이 켜진 경우입니다.

  • PARTIALLY_ACTIVE - 프레임워크가 제어하는 하나 이상의 리소스에 대해 기록이 꺼진 경우입니다.

  • INACTIVE - 프레임워크가 제어하는 모든 리소스에 대해 기록이 꺼진 경우입니다.

  • UNAVAILABLE AWS Backup 가 현재 레코딩 상태를 검증할 수 없는 경우.

유형: 문자열

IdempotencyToken

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

유형: 문자열

Errors

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

InvalidParameterValueException

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

HTTP 상태 코드: 400

MissingParameterValueException

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

HTTP 상태 코드: 400

ResourceNotFoundException

작업에 필요한 리소스가 존재하지 않습니다.

HTTP 상태 코드: 400

ServiceUnavailableException

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

HTTP 상태 코드: 500

참고

언어별 중 하나API에서 이 를 사용하는 방법에 대한 자세한 내용은 다음을 AWS SDKs참조하세요.