기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
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 EC2
Amazon Elastic Compute 클라우드 인스턴스의 SAP HANA 데이터베이스용 -
Storage Gateway
( AWS Storage Gateway 일 때) -
Amazon Timestream의
Timestream
-
VirtualMachine
VMware가상 머신용
패턴:
^[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