ListBackupJobs - AWS Backup
Request SyntaxURI요청 매개변수Request BodyResponse SyntaxResponse ElementsErrors참고

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

ListBackupJobs

지난 30일간 인증된 계정의 기존 백업 작업 목록을 반환합니다. 기간이 더 긴 경우, 이러한 모니터링 도구를 사용하는 방안을 고려해 보세요.

Request Syntax

GET /backup-jobs/?accountId=ByAccountId&backupVaultName=ByBackupVaultName&completeAfter=ByCompleteAfter&completeBefore=ByCompleteBefore&createdAfter=ByCreatedAfter&createdBefore=ByCreatedBefore&maxResults=MaxResults&messageCategory=ByMessageCategory&nextToken=NextToken&parentJobId=ByParentJobId&resourceArn=ByResourceArn&resourceType=ByResourceType&state=ByState HTTP/1.1

URI요청 매개변수

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

ByAccountId

작업을 나열할 계정 ID입니다. 지정된 계정 ID와 관련된 백업 작업만 반환합니다.

AWS Organizations 관리 계정에서 사용하는 경우 전달하면 조직 전체의 모든 작업이 * 반환됩니다.

패턴: ^[0-9]{12}$

ByBackupVaultName

지정된 백업 저장소에 저장될 백업 작업만 반환합니다. 백업 저장소는 백업 저장소가 생성된 AWS 리전 및 백업 저장소를 생성하는 데 사용된 계정에 고유 이름으로 식별됩니다.

패턴: ^[a-zA-Z0-9\-\_]{2,50}$

ByCompleteAfter

Unix 형식 및 협정 세계시 () UTC 로 표시된 날짜 이후에 완료된 백업 작업만 반환합니다.

ByCompleteBefore

Unix 형식 및 협정 세계시 () 로 표시된 날짜 이전에 완료된 백업 작업만 반환합니다. UTC

ByCreatedAfter

지정된 날짜 이후에 생성된 백업 작업만 반환합니다.

ByCreatedBefore

지정된 날짜 이전에 생성된 백업 작업만 반환합니다.

ByMessageCategory

입력한 값과 일치하는 작업을 필터링하는 데 사용할 수 MessageCategory 있는 선택적 매개 변수입니다.

예시 문자열에는 AccessDenied, SUCCESS, AGGREGATE_ALL, InvalidParameters 등이 있습니다.

모니터링 보기

와일드카드 ()는 모든 메시지 범주의 개수를 반환합니다.

AGGREGATE_ALL은 모든 메시지 범주의 작업 수를 집계하고 그 합계를 반환합니다.

ByParentJobId

상위 작업 ID를 기준으로 하위(중첩) 작업을 나열하는 필터입니다.

ByResourceArn

지정된 리소스 Amazon 리소스 이름 (ARN) 과 일치하는 백업 작업만 반환합니다.

ByResourceType

지정된 리소스에 대한 백업 작업만 반환합니다.

  • Amazon Aurora의 Aurora

  • CloudFormation( AWS CloudFormation 일 때)

  • Amazon DocumentDB(MongoDB 호환)의 DocumentDB

  • Amazon DynamoDB의 DynamoDB

  • Amazon Elastic Block Store의 EBS

  • Amazon Elastic Compute Cloud의 EC2

  • Amazon Elastic File System의 EFS

  • FSx아마존용 FSx

  • Amazon Neptune의 Neptune

  • Amazon Relational Database Service의 RDS

  • Amazon Redshift의 Redshift

  • S3아마존 심플 스토리지 서비스 (아마존 S3) 용

  • SAP HANA on Amazon EC2Amazon Elastic Compute 클라우드 인스턴스의 SAP HANA 데이터베이스용

  • Storage Gateway( AWS Storage Gateway 일 때)

  • Amazon Timestream의 Timestream

  • VirtualMachineVMware가상 머신용

패턴: ^[a-zA-Z0-9\-\_\.]{1,50}$

ByState

지정된 상태에 있는 백업 작업만 반환합니다.

Completed with issues는 AWS Backup 콘솔에서만 확인할 수 있는 상태입니다. 에서 이 상태는 상태가 COMPLETED 이고 값이 a인 MessageCategory 작업을 의미합니다SUCCESS. 즉, 상태는 완료되었지만 상태 메시지가 함께 표시됩니다. API

작업 수를 구하려면 두 개의 GET 요청을 실행하고 두 번째로 작은 수를 빼십시오. Completed with issues

GET/백업 작업/? 상태= COMPLETED

GET/백업 작업/? messageCategory= &상태= SUCCESS COMPLETED

유효 값: CREATED | PENDING | RUNNING | ABORTING | ABORTED | COMPLETED | FAILED | EXPIRED | PARTIAL

MaxResults

반환할 항목의 최대 수입니다.

유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

NextToken

반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 MaxResults 수를 반환하기 위한 요청을 한 경우, NextToken을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

Request Body

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

Response Syntax

HTTP/1.1 200
Content-type: application/json

{
   "BackupJobs": [ 
      { 
         "AccountId": "string",
         "BackupJobId": "string",
         "BackupOptions": { 
            "string" : "string" 
         },
         "BackupSizeInBytes": number,
         "BackupType": "string",
         "BackupVaultArn": "string",
         "BackupVaultName": "string",
         "BytesTransferred": number,
         "CompletionDate": number,
         "CreatedBy": { 
            "BackupPlanArn": "string",
            "BackupPlanId": "string",
            "BackupPlanVersion": "string",
            "BackupRuleId": "string"
         },
         "CreationDate": number,
         "ExpectedCompletionDate": number,
         "IamRoleArn": "string",
         "InitiationDate": number,
         "IsParent": boolean,
         "MessageCategory": "string",
         "ParentJobId": "string",
         "PercentDone": "string",
         "RecoveryPointArn": "string",
         "ResourceArn": "string",
         "ResourceName": "string",
         "ResourceType": "string",
         "StartBy": number,
         "State": "string",
         "StatusMessage": "string"
      }
   ],
   "NextToken": "string"
}

Response Elements

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

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

BackupJobs

백업 작업에 대한 메타데이터를 포함하는 구조의 배열이 JSON 형식으로 반환됩니다.

유형: BackupJob객체 어레이

NextToken

반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 MaxResults 수를 반환하기 위한 요청을 한 경우, NextToken을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

타입: 문자열

Errors

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

InvalidParameterValueException

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

HTTP상태 코드: 400

ServiceUnavailableException

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

HTTP상태 코드: 500

참고

언어별 사용 방법에 대한 자세한 내용은 AWS SDKs 다음을 참조하십시오. API