Create a new global variable revision

post/globalVariables/{globalVariableId}/revisions

Internal-Use Only

Creates a new global variable revision. All global variable names must be unique.

Request Samples

application/vnd.sas.data.reference.global.variable+json
1

Response Samples

201
application/vnd.sas.data.reference.global.variable+json
1{
2  "creationTimeStamp": "2023-01-17T16:29:31.851Z",
3  "modifiedTimeStamp": "2023-01-17T16:29:31.856Z",
4  "createdBy": "userx",
5  "modifiedBy": "userx",
6  "id": "38b4d801-f744-45cf-8e97-12a109daf3af",
7  "activeVersionId": "8eb475bb-4a78-46ea-bb0b-a74206b3fc0e",
8  "majorRevision": 1,
9  "minorRevision": 1,
10  "name": "gv_string_hmeq_value",
11  "dataType": "string",
12  "defaultValue": "exampleValue",
13  "hidden": false,
14  "status": "developing",
15  "locked": false,
16  "links": [
17    {
18      "method": "GET",
19      "rel": "self",
20      "href": "/referenceData/globalVariables/38b4d801-f744-45cf-8e97-12a109daf3af",
21      "uri": "/referenceData/globalVariables/38b4d801-f744-45cf-8e97-12a109daf3af",
22      "responseType": "application/vnd.sas.data.reference.global.variable"
23    },
24    {
25      "method": "PUT",
26      "rel": "update",
27      "href": "/referenceData/globalVariables/38b4d801-f744-45cf-8e97-12a109daf3af",
28      "uri": "/referenceData/globalVariables/38b4d801-f744-45cf-8e97-12a109daf3af",
29      "type": "application/vnd.sas.data.reference.global.variable",
30      "responseType": "application/vnd.sas.data.reference.global.variable"
31    },
32    {
33      "method": "DELETE",
34      "rel": "delete",
35      "href": "/referenceData/globalVariables/38b4d801-f744-45cf-8e97-12a109daf3af",
36      "uri": "/referenceData/globalVariables/38b4d801-f744-45cf-8e97-12a109daf3af"
37    },
38    {
39      "method": "GET",
40      "rel": "revisions",
41      "href": "/referenceData/globalVariables/38b4d801-f744-45cf-8e97-12a109daf3af/revisions",
42      "uri": "/referenceData/globalVariables/38b4d801-f744-45cf-8e97-12a109daf3af/revisions",
43      "responseType": "application/vnd.sas.collection",
44      "itemType": "application/vnd.sas.data.reference.global.variable"
45    },
46    {
47      "method": "GET",
48      "rel": "currentRevision",
49      "href": "/referenceData/globalVariables/38b4d801-f744-45cf-8e97-12a109daf3af",
50      "uri": "/referenceData/globalVariables/38b4d801-f744-45cf-8e97-12a109daf3af",
51      "responseType": "application/vnd.sas.data.reference.global.variable"
52    }
53  ]
54}

Path Parameters

Name	Type	Required	Description
globalVariableId	string	true	The identifier of a global variable.

Query Parameters

Name	Type	Required	Description
revisionType	string	false	Valid values are `major` or `minor`. This value determines how the server generates the `major` and `minor` numbers. If a `major` number is provided, the next available major version number is started. For example, if the global variable has revisions 1.0, 1.1, 1.2, 2.0, and 2.1, creating a new major revision results in 3.0. If a `minor` number is provided, then the next available minor revision number is reserved based on the existing revisions. For example, if the existing revisions have `major` and `minor` numbers of 1.1, 1.2, 1.3, 2.1, 2.2, and a user requests a new minor revision, then 2.3 is assigned. This parameter defaults to `minor` if not supplied. Allowed values: majorminor Default: minor

Request Body

The global variable representation. Only the name, type and value are required.

Represents a global variable that can be defined and used across decisions and rule sets.

Name	Type	Required	Description
id	string	false	The system-assigned unique ID for this object.
name	string	true	Name of the global variable.
description	string	false	Description of the global variable
defaultValue	string	true	The value of the global variable. Applicable to all decisions and rule sets where it is referenced. It can also be overridden in a decision or rule set.
createdBy	string	false	The user who created the global variable. The value for this attribute is assigned by the system.
creationTimeStamp	string<date-time>	false	The date and time that the global variable was created. The value for this attribute is assigned by the system.
modifiedBy	string	false	The user ID of the authenticated user who last updated the global variable. The value for this attribute is assigned by the system.
modifiedTimeStamp	string<date-time>	false	The date and time that the global variable was last modified. The value for this attribute is assigned by the system.
dataType	string<enumeration>	true	The type of data that the global variable is intended to be used with. Allowed values: stringdecimalintegerdatedatetimeboolean
majorNumber	integer	false	The major version number. The value for this attribute is assigned by the system.
minorNumber	integer	false	The minor version number. The value for this attribute is assigned by the system.
status	string	false	The status of global variable. The value for this attribute is assigned by the system. Allowed values: developingproduction
locked	boolean	false	Flag that indicates whether the content of the revision being viewed is locked or editable. The value for this attribute is assigned by the system.
activeVersionId	string	false	The system-assigned unique ID for the active version.
links	array [Link]	false	Links to related resources or operations.

Responses

Status	Meaning	Description
201	Created	A new global variable revision was created.	Headers	Schema
400	Bad Request	The request was invalid.		Schema
409	Conflict	A global variable with that name already exists.		Schema