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 형식과 Coordinated Universal Time()으로 표시된 날짜 이후에 완료된 백업 작업만 반환합니다UTC.

ByCompleteBefore

Unix 형식 및 Coordinated Universal Time()으로 표시된 날짜 이전에 완료된 백업 작업만 반환합니다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 Amazon용 FSx

  • Amazon Neptune의 Neptune

  • Amazon Relational Database Service의 RDS

  • Amazon Redshift의 Redshift

  • S3 Amazon Simple Storage Service(Amazon S3)용

  • SAP HANA on Amazon EC2 Amazon Elastic Compute Cloud 인스턴스의 SAP HANA 데이터베이스용

  • Storage Gateway( AWS Storage Gateway 일 때)

  • Amazon Timestream의 Timestream

  • VirtualMachine VMware 가상 머신용

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

ByState

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

Completed with issues는 AWS Backup 콘솔에서만 확인할 수 있는 상태입니다. 의 경우 API이 상태는 상태가 인 작업COMPLETED과 이 아닌 값을 MessageCategory 가진 작업을 나타냅니다. SUCCESS즉, 상태가 완료되지만 상태 메시지가 함께 표시됩니다.

에 대한 작업 수를 구하려면 두 개의 GET 요청을 Completed with issues실행하고 더 작은 두 번째 숫자를 뺍니다.

GET /backup-jobs/?state=COMPLETED

GET /backup-jobs/?messageCategory=SUCCESS&state=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

참고

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