create-hbase-policy¶

Description¶

Creates a new HBase replication policy with the given name on a specific cluster.

Synopsis¶

  create-hbase-policy
--cluster-crn <value>
--policy-name <value>
--policy-definition <value>
[--cli-input-json <value>]
[--generate-cli-skeleton]

Options¶

--cluster-crn (string)

CRN of the destination cluster.

--policy-name (string)

Name of the new policy.

--policy-definition (object)

HBase policy definition.

hbasePolicyArguments -> (object)

HBase replication parameters.

tables -> (array)

List of tables to be replicated. The key should be in “namespace:tablename” format. If this list is empty, then the whole database will be replicated.

item -> (string)

cloudCredential -> (string)

Cloud credentials to use to replicate the initial snapshot if the credential location is specified as ‘EXTERNAL_ACCOUNT’.

databaseArguments -> (object)

HBase database replication arguments.

replicationStrategy -> (string)

Whether to replicate all tables or only the ones where the replication scope has been set. Defaults to ALL_TABLES.

sourceCluster -> (string)

Name of source cluster in the format: “dataCenterName$cluster name”, for example “DC-Europe$My Source 42.”

targetCluster -> (string)

Name of destination cluster in the format: “dataCenterName$cluster name”, for example “DC-US$My Destination 17”.

initialSnapshot -> (boolean)

If set to true, the current data in the table will be replicated before the HBase replication peer gets enabled. If set to false, only the data changed after the policy creation will be replicated.

description -> (string)

Description of the policy.

machineUser -> (object)

Username and password for the machine user.

user -> (string)

Username.

password -> (string)

Password.

createUser -> (boolean)

This option has no effect if the machine user already exists. Otherwise if ‘true’, a new machine user is created. If ‘false’, an error is returned indicating that the user does not exist.

queueName -> (string)

YARN queue name to use for initial snapshot if not default.

distcpMaxMaps -> (integer)

Maximum Map jobs to use for initial snapshot.

sourceRestartType -> (string)

Type of restart for a cluster.

targetRestartType -> (string)

Type of restart for a cluster.

Shorthand Syntax:

hbasePolicyArguments={tables=[string,string],cloudCredential=string,databaseArguments={replicationStrategy=string}},sourceCluster=string,targetCluster=string,initialSnapshot=boolean,description=string,machineUser={user=string,password=string,createUser=boolean},queueName=string,distcpMaxMaps=integer,sourceRestartType=string,targetRestartType=string

JSON Syntax:

{
  "hbasePolicyArguments": {
    "tables": ["string", ...],
    "cloudCredential": "string",
    "databaseArguments": {
      "replicationStrategy": "ALL_TABLES"|"TABLES_WITH_REPLICATION_SCOPE_SET"
    }
  },
  "sourceCluster": "string",
  "targetCluster": "string",
  "initialSnapshot": true|false,
  "description": "string",
  "machineUser": {
    "user": "string",
    "password": "string",
    "createUser": true|false
  },
  "queueName": "string",
  "distcpMaxMaps": integer,
  "sourceRestartType": "RESTART"|"ROLLING_RESTART",
  "targetRestartType": "RESTART"|"ROLLING_RESTART"
}

--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.

--generate-cli-skeleton (boolean)

Prints a sample input JSON to standard output. Note the specified operation is not run if this argument is specified. The sample input can be used as an argument for --cli-input-json.

Output¶

clusterCrn -> (string)

The CRN of the input cluster.

message -> (string)

The detailed description of the action taken.

status -> (string)

The status of the request.

Form Factors¶

public