Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Amazon EMR WAL (EMRWAL) CLI reference - Amazon EMR

Amazon EMR WAL (EMRWAL) CLI reference

The EMRWAL Command Line Interface (EMRWAL CLI) is a unified tool to manage your write-ahead log (WAL) for Amazon EMR. The EMRWAL CLI ships with EMR clusters when you enable WAL at the time that you create a cluster. For more information about enabling WAL, see Write-ahead logs (WAL) for Amazon EMR.

The EMRWAL CLI includes the following commands:

createWorkspace

The createWorkspace command creates a new Amazon EMR WAL workspace.

Usage:

emrwal createWorkspace [-tags <tags>] [-e {endpoint}] [-r {Region}] -w {workspacename} [-h]

Example:

emrwal createWorkspace -w examplews

deleteWal

The deleteWals command deletes the Amazon EMR WAL that you specify.

Usage:

emrwal deleteWal [-e {endpoint}] [-r {Region}] [-w {workspacename}] [-p <tablePrefix>] [-n <walName>] [-N <fullName>] [-R] [-m] [-h]

Example:

emrwal deleteWal -w examplews -p hbasetable -n examplewal

deleteWorkspace

The deleteWorkspace command deletes the Amazon EMR WAL workspace that you specify.

Usage:

emrwal deleteWorkspace [-e {endpoint}] [-r {Region}] -w {workspacename} [-h]

Example:

emrwal deleteWorkspace -w examplews

listTagsForResource

The listTagsForResource command lists all of the key-value pair tags for the Amazon EMR WAL workspace that you specify.

Usage:

emrwal listTagsForResource -arn {resource-arn} [-e {endpoint}] [-r {Region}] [-h]

Example:

emrwal listTagsForResource -arn arn:aws:emrwal::1234567891234:workspace/examplews

listWals

The listWals command lists all of the Amazon EMR WALs in the workspace that you specify.

Usage:

emrwal listWals [-nextToken {token-string}] [-pageSize {integer}] [-e {endpoint}] [-r {Region}] [-w {workspacename}] [-p <tablePrefix>] [-M {integer}] [-h]

Example:

emrwal listWals -w examplews

listWorkspaces

The listWorkspaces command lists all of the Amazon EMR WAL workspaces that are available to you.

Usage:

emrwal listWorkspaces [-nextToken {token-string}] [-pageSize {integer}] [-e {endpoint}] [-r {Region}] [-M {integer}] [-h]

Example:

emrwal listWorkspaces

tagResource

The tagResource command assigns one or more key-value pair tags to the Amazon EMR WAL workspace that you specify.

Usage:

emrwal tagResource -arn {resource-arn} -tags <tags> [-e {endpoint}] [-r {Region}] [-h]

Example:

emrwal tagResource -arn arn:aws:emrwal::1234567891234:workspace/examplews -tags tag_key=tag_value

untagResource

The untagResource command unassigns one or more key-value pair tags to the Amazon EMR WAL workspace that you specify.

Usage:

emrwal untagResource -arn {resource-arn} -tagKeys <tagKeys> [-e {endpoint}] [-r {Region}] [-h]

Example:

emrwal untagResource -arn arn:aws:emrwal::1234567891234:workspace/examplews -tagKeys tag_key
PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.