Creating a Global Variable

Function

This API is used to create a global variable.

Global variables can only be used by the creator by default. To allow access for other users, refer to Granting Data Access Control to Users or Projects for authorization.

Authorization

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

If you are using role/policy-based authorization, see the required permissions in Introduction.

If you are using identity policy-based authorization, the following identity policy-based permissions are required.

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependency
dli:variable:create	Write	variable *	-	-	-

URI

URI format
POST /v1.0/{project_id}/variables

Parameter description

**Table 1** URI parameter
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID, which is used for resource isolation. For details about how to obtain a project ID, see Obtaining a Project ID.

Request Parameters

**Table 2** Request parameters
Parameter	Mandatory	Type	Description
var_name	Yes	String	A global variable name can contain a maximum of 128 characters, including only digits, letters, and underscores (_), but cannot start with an underscore (_) or contain only digits.
var_value	Yes	String	Global variable value.
is_sensitive	No	Boolean	Whether to set a variable as a sensitive variable. The default value is false. Sensitive variables have been deprecated. You are advised to use DEW to manage data source access credentials.

Response Parameters

**Table 3** Response parameters
Parameter	Mandatory	Type	Description
is_success	No	Boolean	Indicates whether the request is successfully executed. Value true indicates that the request is successfully executed.
message	No	String	Message content.

Example Request

Create a global variable that is sensitive.

{
    "var_name": "string",
    "var_value": "string"
}

Example Response

{
    "is_success": true,
    "message": "string"
}

Status Codes

Table 4 describes status codes.

**Table 4** Status codes
Status Code	Description
200	A variable is created successfully.
400	The input parameter is invalid.

Error Codes

If an error occurs when this API is invoked, the system does not return the result similar to the preceding example, but returns the error code and error information. For details, see Error Codes.