AWS CLI Command Reference

Note:

You are viewing the documentation for an older major version of the AWS CLI (version 1).

AWS CLI version 2, the latest major version of AWS CLI, is now stable and recommended for general use. To view this page for the AWS CLI version 2, click here. For more information see the AWS CLI version 2 installation instructions and migration guide.

[ aws . dataexchange ]

list-jobs

Description

This operation lists your jobs sorted by CreatedAt in descending order.

See also: AWS API Documentation

list-jobs is a paginated operation. Multiple API calls may be issued in order to retrieve the entire data set of results. You can disable pagination by providing the --no-paginate argument. When using --output text and the --query argument on a paginated response, the --query argument must extract data from the results of the following query expressions: Jobs

Synopsis

  list-jobs
[--data-set-id <value>]
[--revision-id <value>]
[--cli-input-json <value>]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]

Options

--data-set-id (string)

The unique identifier for a data set.

--revision-id (string)

The unique identifier for a revision.

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally.

--starting-token (string)

A token to specify where to start paginating. This is the NextToken from a previously truncated response.

For usage examples, see Pagination in the AWS Command Line Interface User Guide .

--page-size (integer)

The size of each page to get in the AWS service call. This does not affect the number of items returned in the command's output. Setting a smaller page size results in more calls to the AWS service, retrieving fewer items in each call. This can help prevent the AWS service calls from timing out.

For usage examples, see Pagination in the AWS Command Line Interface User Guide .

--max-items (integer)

The total number of items to return in the command's output. If the total number of items available is more than the value specified, a NextToken is provided in the command's output. To resume pagination, provide the NextToken value in the starting-token argument of a subsequent command. Do not use the NextToken response element directly outside of the AWS CLI.

For usage examples, see Pagination in the AWS Command Line Interface User Guide .

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

Global Options

--debug (boolean)

Turn on debug logging.

--endpoint-url (string)

Override command's default URL with the given URL.

--no-verify-ssl (boolean)

By default, the AWS CLI uses SSL when communicating with AWS services. For each SSL connection, the AWS CLI will verify SSL certificates. This option overrides the default behavior of verifying SSL certificates.

--no-paginate (boolean)

Disable automatic pagination.

--output (string)

The formatting style for command output.

  • json
  • text
  • table

--query (string)

A JMESPath query to use in filtering the response data.

--profile (string)

Use a specific profile from your credential file.

--region (string)

The region to use. Overrides config/env settings.

--version (string)

Display the version of this tool.

--color (string)

Turn on/off color output.

  • on
  • off
  • auto

--no-sign-request (boolean)

Do not sign requests. Credentials will not be loaded if this argument is provided.

--ca-bundle (string)

The CA certificate bundle to use when verifying SSL certificates. Overrides config/env settings.

--cli-read-timeout (int)

The maximum socket read time in seconds. If the value is set to 0, the socket read will be blocking and not timeout. The default value is 60 seconds.

--cli-connect-timeout (int)

The maximum socket connect time in seconds. If the value is set to 0, the socket connect will be blocking and not timeout. The default value is 60 seconds.

Output

Jobs -> (list)

The jobs listed by the request.

(structure)

AWS Data Exchange Jobs are asynchronous import or export operations used to create or copy assets. A data set owner can both import and export as they see fit. Someone with an entitlement to a data set can only export. Jobs are deleted 90 days after they are created.

Arn -> (string)

The ARN for the job.

CreatedAt -> (timestamp)

The date and time that the job was created, in ISO 8601 format.

Details -> (structure)

Details of the operation to be performed by the job, such as export destination details or import source details.

ExportAssetToSignedUrl -> (structure)

Details for the export to signed URL response.

AssetId -> (string)

The unique identifier for the asset associated with this export job.

DataSetId -> (string)

The unique identifier for the data set associated with this export job.

RevisionId -> (string)

The unique identifier for the revision associated with this export response.

SignedUrl -> (string)

The signed URL for the export request.

SignedUrlExpiresAt -> (timestamp)

The date and time that the signed URL expires, in ISO 8601 format.

ExportAssetsToS3 -> (structure)

Details for the export to Amazon S3 response.

AssetDestinations -> (list)

The destination in Amazon S3 where the asset is exported.

(structure)

The destination for the asset.

AssetId -> (string)

The unique identifier for the asset.

Bucket -> (string)

The Amazon S3 bucket that is the destination for the asset.

Key -> (string)

The name of the object in Amazon S3 for the asset.

DataSetId -> (string)

The unique identifier for the data set associated with this export job.

Encryption -> (structure)

Encryption configuration of the export job.

KmsKeyArn -> (string)

The Amazon Resource Name (ARN) of the AWS KMS key you want to use to encrypt the Amazon S3 objects. This parameter is required if you choose aws:kms as an encryption type.

Type -> (string)

The type of server side encryption used for encrypting the objects in Amazon S3.

RevisionId -> (string)

The unique identifier for the revision associated with this export response.

ExportRevisionsToS3 -> (structure)

Details for the export revisions to Amazon S3 response.

DataSetId -> (string)

The unique identifier for the data set associated with this export job.

Encryption -> (structure)

Encryption configuration of the export job.

KmsKeyArn -> (string)

The Amazon Resource Name (ARN) of the AWS KMS key you want to use to encrypt the Amazon S3 objects. This parameter is required if you choose aws:kms as an encryption type.

Type -> (string)

The type of server side encryption used for encrypting the objects in Amazon S3.

RevisionDestinations -> (list)

The destination in Amazon S3 where the revision is exported.

(structure)

The destination where the assets in the revision will be exported.

Bucket -> (string)

The Amazon S3 bucket that is the destination for the assets in the revision.

KeyPattern -> (string)

A string representing the pattern for generated names of the individual assets in the revision. For more information about key patterns, see Key patterns when exporting revisions .

RevisionId -> (string)

The unique identifier for the revision.

EventActionArn -> (string)

The Amazon Resource Name (ARN) of the event action.

ImportAssetFromSignedUrl -> (structure)

Details for the import from signed URL response.

AssetName -> (string)

The name for the asset associated with this import job.

DataSetId -> (string)

The unique identifier for the data set associated with this import job.

Md5Hash -> (string)

The Base64-encoded Md5 hash for the asset, used to ensure the integrity of the file at that location.

RevisionId -> (string)

The unique identifier for the revision associated with this import response.

SignedUrl -> (string)

The signed URL.

SignedUrlExpiresAt -> (timestamp)

The time and date at which the signed URL expires, in ISO 8601 format.

ImportAssetsFromS3 -> (structure)

Details for the import from Amazon S3 response.

AssetSources -> (list)

Is a list of Amazon S3 bucket and object key pairs.

(structure)

The source of the assets.

Bucket -> (string)

The Amazon S3 bucket that's part of the source of the asset.

Key -> (string)

The name of the object in Amazon S3 for the asset.

DataSetId -> (string)

The unique identifier for the data set associated with this import job.

RevisionId -> (string)

The unique identifier for the revision associated with this import response.

ImportAssetsFromRedshiftDataShares -> (structure)

Details from an import from Amazon Redshift datashare response.

AssetSources -> (list)

A list of Amazon Redshift datashare asset sources.

(structure)

The source of the Amazon Redshift datashare asset.

DataShareArn -> (string)

The Amazon Resource Name (ARN) of the datashare asset.

DataSetId -> (string)

The unique identifier for the data set associated with this import job.

RevisionId -> (string)

The unique identifier for the revision associated with this import job.

ImportAssetFromApiGatewayApi -> (structure)

The response details.

ApiDescription -> (string)

The API description.

ApiId -> (string)

The API ID.

ApiKey -> (string)

The API key.

ApiName -> (string)

The API name.

ApiSpecificationMd5Hash -> (string)

The Base64-encoded Md5 hash for the API asset, used to ensure the integrity of the API at that location.

ApiSpecificationUploadUrl -> (string)

The upload URL of the API specification.

ApiSpecificationUploadUrlExpiresAt -> (timestamp)

The date and time that the upload URL expires, in ISO 8601 format.

DataSetId -> (string)

The data set ID.

ProtocolType -> (string)

The protocol type.

RevisionId -> (string)

The revision ID.

Stage -> (string)

The API stage.

CreateS3DataAccessFromS3Bucket -> (structure)

Response details from the CreateS3DataAccessFromS3Bucket job.

AssetSource -> (structure)

Details about the asset source from an Amazon S3 bucket.

Bucket -> (string)

The Amazon S3 bucket used for hosting shared data in the Amazon S3 data access.

KeyPrefixes -> (list)

Organizes Amazon S3 asset key prefixes stored in an Amazon S3 bucket.

(string)

Keys -> (list)

The keys used to create the Amazon S3 data access.

(string)

KmsKeysToGrant -> (list)

List of AWS KMS CMKs (Key Management System Customer Managed Keys) and ARNs used to encrypt S3 objects being shared in this S3 Data Access asset.

(structure)

The Amazon Resource Name (ARN) of the AWS KMS key used to encrypt the shared S3 objects.

KmsKeyArn -> (string)

The AWS KMS CMK (Key Management System Customer Managed Key) used to encrypt S3 objects in the shared S3 Bucket. AWS Data exchange will create a KMS grant for each subscriber to allow them to access and decrypt their entitled data that is encrypted using this KMS key specified.

DataSetId -> (string)

The unique identifier for this data set.

RevisionId -> (string)

The unique identifier for the revision.

ImportAssetsFromLakeFormationTagPolicy -> (structure)

Response details from the ImportAssetsFromLakeFormationTagPolicy job.

CatalogId -> (string)

The identifier for the AWS Glue Data Catalog.

Database -> (structure)

A structure for the database object.

Expression -> (list)

A list of LF-tag conditions that apply to database resources.

(structure)

A structure that allows an LF-admin to grant permissions on certain conditions.

TagKey -> (string)

The key name for the LF-tag.

TagValues -> (list)

A list of LF-tag values.

(string)

Permissions -> (list)

The permissions granted to subscribers on database resources.

(string)

Table -> (structure)

A structure for the table object.

Expression -> (list)

A list of LF-tag conditions that apply to table resources.

(structure)

A structure that allows an LF-admin to grant permissions on certain conditions.

TagKey -> (string)

The key name for the LF-tag.

TagValues -> (list)

A list of LF-tag values.

(string)

Permissions -> (list)

The permissions granted to subscribers on table resources.

(string)

RoleArn -> (string)

The IAM role's ARN that allows AWS Data Exchange to assume the role and grant and revoke permissions to AWS Lake Formation data permissions.

DataSetId -> (string)

The unique identifier for the data set associated with this import job.

RevisionId -> (string)

The unique identifier for the revision associated with this import job.

Errors -> (list)

Errors for jobs.

(structure)

An error that occurred with the job request.

Code -> (string)

The code for the job error.

Details -> (structure)

The details about the job error.

ImportAssetFromSignedUrlJobErrorDetails -> (structure)

Information about the job error.

AssetName -> (string)

Details about the job error.

ImportAssetsFromS3JobErrorDetails -> (list)

Details about the job error.

(structure)

The source of the assets.

Bucket -> (string)

The Amazon S3 bucket that's part of the source of the asset.

Key -> (string)

The name of the object in Amazon S3 for the asset.

LimitName -> (string)

The name of the limit that was reached.

LimitValue -> (double)

The value of the exceeded limit.

Message -> (string)

The message related to the job error.

ResourceId -> (string)

The unique identifier for the resource related to the error.

ResourceType -> (string)

The type of resource related to the error.

Id -> (string)

The unique identifier for the job.

State -> (string)

The state of the job.

Type -> (string)

The job type.

UpdatedAt -> (timestamp)

The date and time that the job was last updated, in ISO 8601 format.

NextToken -> (string)

The token value retrieved from a previous call to access the next page of results.