export BASEURL=https://<org>.vezacloud.com} \
export TOKEN=Sk9lcmEta2w2c2padklkaDhOcDVhTWdVU3FlTlpVajg=curl $BASEURL/api/v1/assessments/query_spec:nodes \
-H 'authorization: Bearer '$TOKEN \
--data-raw '{
"query_type": "SOURCE_TO_DESTINATION",
"include_nodes": true,
"source_node_types": {
"nodes": [
{
"node_type": "SnowflakeTable"
}
]
},
"destination_node_types": {
"nodes": [
{
"node_type": "OktaUser",
"condition_expression": {
"specs": [
{
"fn": "CONTAINS",
"property": "department",
"value": "Finance"
}
]
}
}
]
}
}'{
"values": [
{
"id": "dn44266.us-east-2.aws.snowflakecomputing.com/database/LOCATION/schema/COUNTRIES/table/USA",
"type": "SnowflakeTable",
"properties": {
"created_at": "2021-05-14T21:18:55Z",
"name": "USA"
},
"destination_node_count": 1,
"permissions": []
}
],
"next_page_token": "MzA=",
"has_more": false
}curl $BASEURL/api/v1/graph/nodes/veza_tags \
-H 'authorization: Bearer '$TOKEN \
--data-raw '{
"node_id": "dn44266.us-east-2.aws.snowflakecomputing.com/database/LOCATION/schema/COUNTRIES/table/USA",
"tags": [
{
"key": "department",
"value": "finance"
}
]
}' curl $BASEURL/api/v1/graph/veza_tags:remove \
-H 'authorization: Bearer '$TOKEN \
--data-raw '{
"node_id": "dn44266.us-east-2.aws.snowflakecomputing.com/database/LOCATION/schema/COUNTRIES/table/USA",
"tag_key": "department"
}'{
"tag": {
"key": "note",
"value": "tags_can_be_used_as_searchable_properties,_or_add_extended_notes"
}
}{
"node_id": "080551dc-aef9-46e4-9654-a6362d7baeee",
"tags": [
{
"key": "PII",
"value": "GRPC"
},
{
"key": "environment",
"value": "production"
}
]
}{
"node_id": "080551dc-aef9-46e4-9654-a6362d7baeee",
"tag_key": "environment"
}{
"node_id": "080551dc-aef9-46e4-9654-a6362d7baeee",
"tag_keys": ["environment", "department", "owner"]
}{
"add": [
{
"node_id": "080551dc-aef9-46e4-9654-a6362d7baeee",
"tags": [
{
"key": "environment",
"value": "production"
},
{
"key": "department",
"value": "engineering"
}
]
},
{
"node_id": "1a2b3c4d-5e6f-7890-abcd-ef1234567890",
"tags": [
{
"key": "environment",
"value": "production"
}
]
}
]
}{
"remove": [
{
"node_id": "080551dc-aef9-46e4-9654-a6362d7baeee",
"tag_keys": ["temporary", "archived"]
},
{
"node_id": "1a2b3c4d-5e6f-7890-abcd-ef1234567890",
"tag_keys": ["temporary"]
}
]
}{
"add": [
{
"node_id": "080551dc-aef9-46e4-9654-a6362d7baeee",
"tags": [
{
"key": "status",
"value": "active"
}
]
}
],
"remove": [
{
"node_id": "080551dc-aef9-46e4-9654-a6362d7baeee",
"tag_keys": ["temporary"]
},
{
"node_id": "1a2b3c4d-5e6f-7890-abcd-ef1234567890",
"tag_keys": ["archived", "deprecated"]
}
]
}Adds a promoted tag. If a promoted tag with the same tag_key and tag_type already
exists, a unique constraint error will be returned without modifying the existing
promoted tag.
Veza API key for authentication. Generate keys in Administration > API Keys.
tag_key and tag_type specify the tag to be promoted
Only one or the other makes sense to be set. include_entity_types indicates promote only for the listed type exclude_entity_type indicates promote for any type except for the listed types The types should be concrete types, and OAA types should be supplied with their native types name, ie "OAA.ApplicationName.Type".
Demotes a promoted tag
Veza API key for authentication. Generate keys in Administration > API Keys.
OK
Default error response
The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC. Each Status message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the API Design Guide.
The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
The type of the serialized message.
List promoted tags
Veza API key for authentication. Generate keys in Administration > API Keys.
OK
Only one or the other is accepted, if both are supplied the request is considered invalid. If "include_entity_types" is empty, all types will be included except any that are in "exclude_entity_types".
Default error response
The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC. Each Status message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the API Design Guide.
The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
The type of the serialized message.
OK
Default error response
The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC. Each Status message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the API Design Guide.
The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
The type of the serialized message.
POST /api/preview/graph/tag_promotions HTTP/1.1
Host: your-tenant.vezacloud.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 95
{
"tag_key": "text",
"tag_type": 1,
"include_entity_types": [
"text"
],
"exclude_entity_types": [
"text"
]
}{}{}POST /api/preview/graph/tag_promotions:demote HTTP/1.1
Host: your-tenant.vezacloud.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 31
{
"tag_key": "text",
"tag_type": 1
}GET /api/preview/graph/tag_promotions HTTP/1.1
Host: your-tenant.vezacloud.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"tag_promotions": [
{
"tag_key": "text",
"tag_type": 1,
"include_entity_types": [
"text"
],
"exclude_entity_types": [
"text"
]
}
]
}