---
title: "GET /copy-jobs/"
method: GET
path: "/copy-jobs/"
---

# GET /copy-jobs/

`GET /copy-jobs/`

Returns metadata about your copy jobs.

## Query parameters

- `nextToken` string
- `maxResults` integer
- `resourceArn` string
- `state` 'CREATED' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'PARTIAL'
- `createdBefore` string, date-time
- `createdAfter` string, date-time
- `resourceType` string
- `destinationVaultArn` string
- `accountId` string
- `completeBefore` string, date-time
- `completeAfter` string, date-time
- `parentJobId` string
- `MaxResults` string
- `NextToken` string

## Response `200`

Success

- ListCopyJobsOutput
  - `CopyJobs` CopyJob[] — An array of structures containing metadata about your copy jobs returned in JSON format.
    - `AccountId` string — The account ID that owns the copy job.
    - `CopyJobId` string — Uniquely identifies a copy job.
    - `SourceBackupVaultArn` string — An Amazon Resource Name (ARN) that uniquely identifies a source copy vault; for example, <code>arn:aws:backup:us-east-1:123456789012:vault:aBackupVault</code>.
    - `SourceRecoveryPointArn` string — An ARN that uniquely identifies a source recovery point; for example, <code>arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45</code>.
    - `DestinationBackupVaultArn` string — An Amazon Resource Name (ARN) that uniquely identifies a destination copy vault; for example, <code>arn:aws:backup:us-east-1:123456789012:vault:aBackupVault</code>.
    - `DestinationRecoveryPointArn` string — An ARN that uniquely identifies a destination recovery point; for example, <code>arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45</code>.
    - `ResourceArn` string — The Amazon Web Services resource to be copied; for example, an Amazon Elastic Block Store (Amazon EBS) volume or an Amazon Relational Database Service (Amazon RDS) database.
    - `CreationDate` string, date-time — The date and time a copy job is created, in Unix format and Coordinated Universal Time (UTC). The value of <code>CreationDate</code> is accurate to milliseconds. For example, the value 1516925490.087 represents Friday, January 26, 2018 12:11:30.087 AM.
    - `CompletionDate` string, date-time — The date and time a copy job is completed, in Unix format and Coordinated Universal Time (UTC). The value of <code>CompletionDate</code> is accurate to milliseconds. For example, the value 1516925490.087 represents Friday, January 26, 2018 12:11:30.087 AM.
    - `State` 'CREATED' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'PARTIAL' — The current state of a copy job.
    - `StatusMessage` string — A detailed message explaining the status of the job to copy a resource.
    - `BackupSizeInBytes` integer — The size, in bytes, of a copy job.
    - `IamRoleArn` string — Specifies the IAM role ARN used to copy the target recovery point; for example, <code>arn:aws:iam::123456789012:role/S3Access</code>.
    - `CreatedBy` RecoveryPointCreator — Contains information about the backup plan and rule that Backup used to initiate the recovery point backup.
      - `BackupPlanId` string — Uniquely identifies a backup plan.
      - `BackupPlanArn` string — An Amazon Resource Name (ARN) that uniquely identifies a backup plan; for example, <code>arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50</code>.
      - `BackupPlanVersion` string — Version IDs are unique, randomly generated, Unicode, UTF-8 encoded strings that are at most 1,024 bytes long. They cannot be edited.
      - `BackupRuleId` string — Uniquely identifies a rule used to schedule the backup of a selection of resources.
    - `ResourceType` string — The type of Amazon Web Services resource to be copied; for example, an Amazon Elastic Block Store (Amazon EBS) volume or an Amazon Relational Database Service (Amazon RDS) database.
    - `ParentJobId` string — This uniquely identifies a request to Backup to copy a resource. The return will be the parent (composite) job ID.
    - `IsParent` boolean — This is a boolean value indicating this is a parent (composite) copy job.
    - `CompositeMemberIdentifier` string — This is the identifier of a resource within a composite group, such as nested (child) recovery point belonging to a composite (parent) stack. The ID is transferred from the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html#resources-section-structure-syntax"> logical ID</a> within a stack.
    - `NumberOfChildJobs` integer — This is the number of child (nested) copy jobs.
    - `ChildJobsInState` object — This returns the statistics of the included child (nested) copy jobs.
    - `ResourceName` string — This is the non-unique name of the resource that belongs to the specified backup.
  - `NextToken` string — The next item following a partial list of returned items. For example, if a request is made to return maxResults number of items, NextToken allows you to return more items in your list starting at the location pointed to by the next token.

## Other responses

- `480` — InvalidParameterValueException
- `481` — ServiceUnavailableException

---

[API](https://skmtc.net/aws/apis/backup.md) · [All operations](https://skmtc.net/aws/apis/backup/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/backup/versions/386d8a5f8871/schema)