@databricks/sdk-tagpolicies 0.0.0-dev → 0.1.0-dev.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,57 @@
1
+ // Code generated from API definition by Databricks SDK Generator. DO NOT EDIT.
2
+ import { defaultCredentials } from '@databricks/sdk-auth/credentials';
3
+ import { newFetchHttpClient } from '@databricks/sdk-core/http';
4
+ /** Creates a new HTTP client with the given options. */
5
+ export function newHttpClient(options) {
6
+ const opts = options ?? {};
7
+ // If an HTTP client is provided, use it as-is. Throw if other options are
8
+ // also set, since they would be silently ignored.
9
+ if (opts.httpClient !== undefined) {
10
+ if (opts.credentials !== undefined || opts.timeout !== undefined) {
11
+ throw new Error('httpClient cannot be combined with credentials or timeout');
12
+ }
13
+ return opts.httpClient;
14
+ }
15
+ const credentials = opts.credentials ?? defaultCredentials();
16
+ const base = newFetchHttpClient();
17
+ let client = new AuthHttpClient(base, credentials);
18
+ if (opts.timeout !== undefined) {
19
+ client = new TimeoutHttpClient(client, opts.timeout);
20
+ }
21
+ return client;
22
+ }
23
+ /** Wraps an HttpClient and adds authentication headers to requests. */
24
+ class AuthHttpClient {
25
+ base;
26
+ credentials;
27
+ constructor(base, credentials) {
28
+ this.base = base;
29
+ this.credentials = credentials;
30
+ }
31
+ async send(request) {
32
+ const authHeaders = await this.credentials.authHeaders();
33
+ // Do not modify the original request.
34
+ const headers = new Headers(request.headers);
35
+ for (const h of authHeaders) {
36
+ headers.set(h.key, h.value);
37
+ }
38
+ return this.base.send({ ...request, headers });
39
+ }
40
+ }
41
+ /** Wraps an HttpClient and applies a default timeout to requests. */
42
+ class TimeoutHttpClient {
43
+ base;
44
+ timeout;
45
+ constructor(base, timeout) {
46
+ this.base = base;
47
+ this.timeout = timeout;
48
+ }
49
+ async send(request) {
50
+ const timeoutSignal = AbortSignal.timeout(this.timeout);
51
+ const signal = request.signal !== undefined
52
+ ? AbortSignal.any([request.signal, timeoutSignal])
53
+ : timeoutSignal;
54
+ return this.base.send({ ...request, signal });
55
+ }
56
+ }
57
+ //# sourceMappingURL=transport.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/v1/transport.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAG/E,OAAO,EAAC,kBAAkB,EAAC,MAAM,kCAAkC,CAAC;AAMpE,OAAO,EAAC,kBAAkB,EAAC,MAAM,2BAA2B,CAAC;AAG7D,wDAAwD;AACxD,MAAM,UAAU,aAAa,CAAC,OAAuB;IACnD,MAAM,IAAI,GAAG,OAAO,IAAI,EAAE,CAAC;IAE3B,0EAA0E;IAC1E,kDAAkD;IAClD,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACjE,MAAM,IAAI,KAAK,CACb,2DAA2D,CAC5D,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,kBAAkB,EAAE,CAAC;IAE7D,MAAM,IAAI,GAAG,kBAAkB,EAAE,CAAC;IAClC,IAAI,MAAM,GAAe,IAAI,cAAc,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAE/D,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,GAAG,IAAI,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,uEAAuE;AACvE,MAAM,cAAc;IAEC;IACA;IAFnB,YACmB,IAAgB,EAChB,WAAwB;QADxB,SAAI,GAAJ,IAAI,CAAY;QAChB,gBAAW,GAAX,WAAW,CAAa;IACxC,CAAC;IAEJ,KAAK,CAAC,IAAI,CAAC,OAAoB;QAC7B,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;QACzD,sCAAsC;QACtC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC7C,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAC,GAAG,OAAO,EAAE,OAAO,EAAC,CAAC,CAAC;IAC/C,CAAC;CACF;AAED,qEAAqE;AACrE,MAAM,iBAAiB;IAEF;IACA;IAFnB,YACmB,IAAgB,EAChB,OAAe;QADf,SAAI,GAAJ,IAAI,CAAY;QAChB,YAAO,GAAP,OAAO,CAAQ;IAC/B,CAAC;IAEJ,KAAK,CAAC,IAAI,CAAC,OAAoB;QAC7B,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxD,MAAM,MAAM,GACV,OAAO,CAAC,MAAM,KAAK,SAAS;YAC1B,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;YAClD,CAAC,CAAC,aAAa,CAAC;QACpB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAC,GAAG,OAAO,EAAE,MAAM,EAAC,CAAC,CAAC;IAC9C,CAAC;CACF"}
@@ -0,0 +1,22 @@
1
+ import type { Call } from '@databricks/sdk-core/api';
2
+ import type { HttpClient, HttpRequest } from '@databricks/sdk-core/http';
3
+ import type { Logger } from '@databricks/sdk-core/logger';
4
+ import type { CallOptions } from '@databricks/sdk-options/call';
5
+ import type { z } from 'zod';
6
+ export interface HttpCallOptions {
7
+ readonly request: HttpRequest;
8
+ readonly httpClient: HttpClient;
9
+ readonly logger: Logger;
10
+ }
11
+ /**
12
+ * Translates public CallOptions to the internal Options shape accepted by
13
+ * execute(). Even though the shapes match today, this isolates the public
14
+ * API from the executor's internal type so they can diverge.
15
+ */
16
+ export declare function executeCall(call: Call, options?: CallOptions): Promise<void>;
17
+ export declare function executeHttpCall(opts: HttpCallOptions): Promise<Uint8Array>;
18
+ export declare function buildHttpRequest(method: string, url: string, headers: Headers, signal?: AbortSignal, body?: string | ReadableStream<Uint8Array>): HttpRequest;
19
+ export declare function parseResponse<T>(body: Uint8Array, schema: z.ZodType<T>): T;
20
+ export declare function marshalRequest(data: unknown, schema: z.ZodType): string;
21
+ export declare function flattenQueryParams(prefix: string, value: unknown, params: URLSearchParams): void;
22
+ //# sourceMappingURL=utils.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/v1/utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,IAAI,EAAU,MAAM,0BAA0B,CAAC;AAG5D,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EAEZ,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,6BAA6B,CAAC;AACxD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,8BAA8B,CAAC;AAE9D,OAAO,KAAK,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAO3B,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,IAAI,CAAC,CASf;AA2BD,wBAAsB,eAAe,CACnC,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,UAAU,CAAC,CA2BrB;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,OAAO,EAChB,MAAM,CAAC,EAAE,WAAW,EACpB,IAAI,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC,GACzC,WAAW,CASb;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAI1E;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,MAAM,CAEvE;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,eAAe,GACtB,IAAI,CAuBN"}
@@ -0,0 +1,113 @@
1
+ // Code generated from API definition by Databricks SDK Generator. DO NOT EDIT.
2
+ import { execute } from '@databricks/sdk-core/api';
3
+ import { ApiError } from '@databricks/sdk-core/apierror';
4
+ import JSONBig from 'json-bigint';
5
+ // JSON codec that preserves int64 precision. On the way in, large integer
6
+ // literals come back as bigint instead of being rounded to JS Number. On the
7
+ // way out, bigint values are emitted as raw JSON number digits.
8
+ const jsonBigint = JSONBig({ useNativeBigInt: true });
9
+ /**
10
+ * Translates public CallOptions to the internal Options shape accepted by
11
+ * execute(). Even though the shapes match today, this isolates the public
12
+ * API from the executor's internal type so they can diverge.
13
+ */
14
+ export async function executeCall(call, options) {
15
+ const opts = {
16
+ ...(options?.retrier !== undefined && { retrier: options.retrier }),
17
+ ...(options?.rateLimiter !== undefined && {
18
+ rateLimiter: options.rateLimiter,
19
+ }),
20
+ ...(options?.timeout !== undefined && { timeout: options.timeout }),
21
+ };
22
+ return execute(options?.signal, call, opts);
23
+ }
24
+ async function readAll(body) {
25
+ if (body === null) {
26
+ return new Uint8Array(0);
27
+ }
28
+ const reader = body.getReader();
29
+ const chunks = [];
30
+ for (;;) {
31
+ const { done, value } = await reader.read();
32
+ if (done) {
33
+ break;
34
+ }
35
+ chunks.push(value);
36
+ }
37
+ const totalLength = chunks.reduce((acc, chunk) => acc + chunk.length, 0);
38
+ const result = new Uint8Array(totalLength);
39
+ let offset = 0;
40
+ for (const chunk of chunks) {
41
+ result.set(chunk, offset);
42
+ offset += chunk.length;
43
+ }
44
+ return result;
45
+ }
46
+ export async function executeHttpCall(opts) {
47
+ opts.logger.debug('HTTP request', {
48
+ method: opts.request.method,
49
+ url: opts.request.url,
50
+ });
51
+ let resp;
52
+ try {
53
+ resp = await opts.httpClient.send(opts.request);
54
+ }
55
+ catch (e) {
56
+ opts.logger.debug('HTTP request failed');
57
+ throw e;
58
+ }
59
+ const body = await readAll(resp.body);
60
+ opts.logger.debug('HTTP response', {
61
+ statusCode: resp.statusCode,
62
+ body: new TextDecoder().decode(body),
63
+ });
64
+ const apiErr = ApiError.fromHttpError(resp.statusCode, resp.headers, body);
65
+ if (apiErr !== undefined) {
66
+ throw apiErr;
67
+ }
68
+ return body;
69
+ }
70
+ export function buildHttpRequest(method, url, headers, signal, body) {
71
+ const req = { url, method, headers };
72
+ if (body !== undefined) {
73
+ req.body = body;
74
+ }
75
+ if (signal !== undefined) {
76
+ req.signal = signal;
77
+ }
78
+ return req;
79
+ }
80
+ export function parseResponse(body, schema) {
81
+ const text = new TextDecoder().decode(body);
82
+ const parsed = jsonBigint.parse(text);
83
+ return schema.parse(parsed);
84
+ }
85
+ export function marshalRequest(data, schema) {
86
+ return jsonBigint.stringify(schema.parse(data));
87
+ }
88
+ export function flattenQueryParams(prefix, value, params) {
89
+ if (value === null || value === undefined) {
90
+ return;
91
+ }
92
+ if (Array.isArray(value)) {
93
+ // arrays of objects are not yet supported
94
+ for (const item of value) {
95
+ params.append(prefix, String(item));
96
+ }
97
+ }
98
+ else if (typeof value === 'object') {
99
+ for (const [key, val] of Object.entries(value)) {
100
+ flattenQueryParams(`${prefix}.${key}`, val, params);
101
+ }
102
+ }
103
+ else if (typeof value === 'string' ||
104
+ typeof value === 'number' ||
105
+ typeof value === 'boolean' ||
106
+ typeof value === 'bigint') {
107
+ params.append(prefix, String(value));
108
+ }
109
+ else {
110
+ throw new Error(`Unsupported query parameter type: ${typeof value}`);
111
+ }
112
+ }
113
+ //# sourceMappingURL=utils.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/v1/utils.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,7 +1,41 @@
1
1
  {
2
2
  "name": "@databricks/sdk-tagpolicies",
3
- "version": "0.0.0-dev",
4
- "description": "Bootstrap placeholder; real contents in a later release.",
5
- "main": "index.js",
6
- "license": "Apache-2.0"
3
+ "version": "0.1.0-dev.1",
4
+ "description": "",
5
+ "type": "module",
6
+ "exports": {
7
+ "./v1": {
8
+ "types": "./dist/v1/index.d.ts",
9
+ "import": "./dist/v1/index.js"
10
+ }
11
+ },
12
+ "files": [
13
+ "dist",
14
+ "src",
15
+ "LICENSE"
16
+ ],
17
+ "scripts": {
18
+ "build": "tsc -b",
19
+ "lint": "eslint src --ext .ts",
20
+ "lint:fix": "eslint src --ext .ts --fix",
21
+ "format": "prettier --write \"src/**/*.ts\"",
22
+ "format:check": "prettier --check \"src/**/*.ts\"",
23
+ "typecheck": "tsc --noEmit",
24
+ "clean": "rm -rf dist tsconfig.tsbuildinfo",
25
+ "test": "echo 'no tests'",
26
+ "test:browser": "echo 'no tests'"
27
+ },
28
+ "author": "Databricks",
29
+ "license": "Apache-2.0",
30
+ "dependencies": {
31
+ "@databricks/sdk-auth": ">=0.1.0-dev.2 <1.0.0",
32
+ "@databricks/sdk-core": ">=0.1.0-dev.3 <1.0.0",
33
+ "@databricks/sdk-options": ">=0.1.0-dev.2 <1.0.0",
34
+ "@js-temporal/polyfill": "^0.5.0",
35
+ "json-bigint": "^1.0.0",
36
+ "zod": "^4.3.6"
37
+ },
38
+ "engines": {
39
+ "node": ">=22.0.0"
40
+ }
7
41
  }
@@ -0,0 +1,242 @@
1
+ // Code generated from API definition by Databricks SDK Generator. DO NOT EDIT.
2
+
3
+ import {VERSION as AUTH_VERSION} from '@databricks/sdk-auth';
4
+ import type {Call} from '@databricks/sdk-core/api';
5
+ import {createDefault} from '@databricks/sdk-core/clientinfo';
6
+ import type {Logger} from '@databricks/sdk-core/logger';
7
+ import {NoOpLogger} from '@databricks/sdk-core/logger';
8
+ import type {CallOptions} from '@databricks/sdk-options/call';
9
+ import type {ClientOptions} from '@databricks/sdk-options/client';
10
+ import type {HttpClient} from '@databricks/sdk-core/http';
11
+ import {newHttpClient} from './transport';
12
+ import {
13
+ buildHttpRequest,
14
+ executeCall,
15
+ executeHttpCall,
16
+ marshalRequest,
17
+ parseResponse,
18
+ } from './utils';
19
+ import pkgJson from '../../package.json' with {type: 'json'};
20
+ import type {
21
+ CreateTagPolicyRequest,
22
+ DeleteTagPolicyRequest,
23
+ GetTagPolicyRequest,
24
+ ListTagPoliciesRequest,
25
+ ListTagPoliciesResponse,
26
+ TagPolicy,
27
+ UpdateTagPolicyRequest,
28
+ } from './model';
29
+ import {
30
+ marshalTagPolicySchema,
31
+ unmarshalListTagPoliciesResponseSchema,
32
+ unmarshalTagPolicySchema,
33
+ } from './model';
34
+
35
+ // Package identity segment for this client to be used in the User-Agent header.
36
+ const PACKAGE_SEGMENT = {
37
+ key: 'sdk-js-' + pkgJson.name.replace(/^@[^/]+\/sdk-/, ''),
38
+ value: pkgJson.version,
39
+ };
40
+
41
+ export class TagpoliciesClient {
42
+ private readonly host: string;
43
+ // Workspace ID used to route workspace-level calls on unified hosts (SPOG).
44
+ // When set, workspace-level methods send X-Databricks-Org-Id on every
45
+ // request.
46
+ private readonly workspaceId: string | undefined;
47
+ private readonly httpClient: HttpClient;
48
+ private readonly logger: Logger;
49
+ // User-Agent header value. Composed once at construction from
50
+ // createDefault() merged with this package's identity and the active
51
+ // credential's name.
52
+ private readonly userAgent: string;
53
+
54
+ constructor(options: ClientOptions) {
55
+ if (options.host === undefined) {
56
+ throw new Error('Host is required.');
57
+ }
58
+ this.host = options.host.replace(/\/$/, '');
59
+ this.workspaceId = options.workspaceId;
60
+ this.logger = options.logger ?? new NoOpLogger();
61
+ const info = createDefault()
62
+ .with(PACKAGE_SEGMENT)
63
+ .with({key: 'sdk-js-auth', value: AUTH_VERSION})
64
+ .with({key: 'auth', value: options.credentials?.name() ?? 'default'});
65
+ this.userAgent = info.toString();
66
+ this.httpClient = newHttpClient(options);
67
+ }
68
+
69
+ /** Creates a new tag policy, making the associated tag key governed. For Terraform usage, see the [Tag Policy Terraform documentation](https://registry.terraform.io/providers/databricks/databricks/latest/docs/resources/tag_policy). To manage permissions for tag policies, use the [Account Access Control Proxy API](https://docs.databricks.com/api/workspace/accountaccesscontrolproxy). */
70
+ async createTagPolicy(
71
+ req: CreateTagPolicyRequest,
72
+ options?: CallOptions
73
+ ): Promise<TagPolicy> {
74
+ const url = `${this.host}/api/2.1/tag-policies`;
75
+ const body = marshalRequest(req.tagPolicy, marshalTagPolicySchema);
76
+ let resp: TagPolicy | undefined;
77
+ const call: Call = async (callSignal?: AbortSignal): Promise<void> => {
78
+ const headers = new Headers({'Content-Type': 'application/json'});
79
+ if (this.workspaceId !== undefined) {
80
+ headers.set('X-Databricks-Org-Id', this.workspaceId);
81
+ }
82
+ headers.set('User-Agent', this.userAgent);
83
+ const httpReq = buildHttpRequest('POST', url, headers, callSignal, body);
84
+ const respBody = await executeHttpCall({
85
+ request: httpReq,
86
+ httpClient: this.httpClient,
87
+ logger: this.logger,
88
+ });
89
+ resp = parseResponse(respBody, unmarshalTagPolicySchema);
90
+ };
91
+ await executeCall(call, options);
92
+ if (resp === undefined) {
93
+ throw new Error('API call completed without a result.');
94
+ }
95
+ return resp;
96
+ }
97
+
98
+ /** Deletes a tag policy by its associated governed tag's key, leaving that tag key ungoverned. For Terraform usage, see the [Tag Policy Terraform documentation](https://registry.terraform.io/providers/databricks/databricks/latest/docs/resources/tag_policy). */
99
+ async deleteTagPolicy(
100
+ req: DeleteTagPolicyRequest,
101
+ options?: CallOptions
102
+ ): Promise<void> {
103
+ const url = `${this.host}/api/2.1/tag-policies/${req.tagKey ?? ''}`;
104
+ const call: Call = async (callSignal?: AbortSignal): Promise<void> => {
105
+ const headers = new Headers();
106
+ if (this.workspaceId !== undefined) {
107
+ headers.set('X-Databricks-Org-Id', this.workspaceId);
108
+ }
109
+ headers.set('User-Agent', this.userAgent);
110
+ const httpReq = buildHttpRequest('DELETE', url, headers, callSignal);
111
+ await executeHttpCall({
112
+ request: httpReq,
113
+ httpClient: this.httpClient,
114
+ logger: this.logger,
115
+ });
116
+ };
117
+ await executeCall(call, options);
118
+ }
119
+
120
+ /** Gets a single tag policy by its associated governed tag's key. For Terraform usage, see the [Tag Policy Terraform documentation](https://registry.terraform.io/providers/databricks/databricks/latest/docs/data-sources/tag_policy). To list granted permissions for tag policies, use the [Account Access Control Proxy API](https://docs.databricks.com/api/workspace/accountaccesscontrolproxy). */
121
+ async getTagPolicy(
122
+ req: GetTagPolicyRequest,
123
+ options?: CallOptions
124
+ ): Promise<TagPolicy> {
125
+ const url = `${this.host}/api/2.1/tag-policies/${req.tagKey ?? ''}`;
126
+ let resp: TagPolicy | undefined;
127
+ const call: Call = async (callSignal?: AbortSignal): Promise<void> => {
128
+ const headers = new Headers();
129
+ if (this.workspaceId !== undefined) {
130
+ headers.set('X-Databricks-Org-Id', this.workspaceId);
131
+ }
132
+ headers.set('User-Agent', this.userAgent);
133
+ const httpReq = buildHttpRequest('GET', url, headers, callSignal);
134
+ const respBody = await executeHttpCall({
135
+ request: httpReq,
136
+ httpClient: this.httpClient,
137
+ logger: this.logger,
138
+ });
139
+ resp = parseResponse(respBody, unmarshalTagPolicySchema);
140
+ };
141
+ await executeCall(call, options);
142
+ if (resp === undefined) {
143
+ throw new Error('API call completed without a result.');
144
+ }
145
+ return resp;
146
+ }
147
+
148
+ /** Lists the tag policies for all governed tags in the account. For Terraform usage, see the [Tag Policy Terraform documentation](https://registry.terraform.io/providers/databricks/databricks/latest/docs/data-sources/tag_policies). To list granted permissions for tag policies, use the [Account Access Control Proxy API](https://docs.databricks.com/api/workspace/accountaccesscontrolproxy). */
149
+ async listTagPolicies(
150
+ req: ListTagPoliciesRequest,
151
+ options?: CallOptions
152
+ ): Promise<ListTagPoliciesResponse> {
153
+ const url = `${this.host}/api/2.1/tag-policies`;
154
+ const params = new URLSearchParams();
155
+ if (req.pageSize !== undefined) {
156
+ params.append('page_size', String(req.pageSize));
157
+ }
158
+ if (req.pageToken !== undefined) {
159
+ params.append('page_token', req.pageToken);
160
+ }
161
+ const query = params.toString();
162
+ const fullUrl = query !== '' ? `${url}?${query}` : url;
163
+ let resp: ListTagPoliciesResponse | undefined;
164
+ const call: Call = async (callSignal?: AbortSignal): Promise<void> => {
165
+ const headers = new Headers();
166
+ if (this.workspaceId !== undefined) {
167
+ headers.set('X-Databricks-Org-Id', this.workspaceId);
168
+ }
169
+ headers.set('User-Agent', this.userAgent);
170
+ const httpReq = buildHttpRequest('GET', fullUrl, headers, callSignal);
171
+ const respBody = await executeHttpCall({
172
+ request: httpReq,
173
+ httpClient: this.httpClient,
174
+ logger: this.logger,
175
+ });
176
+ resp = parseResponse(respBody, unmarshalListTagPoliciesResponseSchema);
177
+ };
178
+ await executeCall(call, options);
179
+ if (resp === undefined) {
180
+ throw new Error('API call completed without a result.');
181
+ }
182
+ return resp;
183
+ }
184
+
185
+ async *listTagPoliciesIter(
186
+ req: ListTagPoliciesRequest,
187
+ options?: CallOptions
188
+ ): AsyncGenerator<TagPolicy> {
189
+ const pageReq: ListTagPoliciesRequest = {...req};
190
+ for (;;) {
191
+ const resp = await this.listTagPolicies(pageReq, options);
192
+ for (const item of resp.tagPolicies ?? []) {
193
+ yield item;
194
+ }
195
+ if (resp.nextPageToken === undefined || resp.nextPageToken === '') {
196
+ return;
197
+ }
198
+ pageReq.pageToken = resp.nextPageToken;
199
+ }
200
+ }
201
+
202
+ /** Updates an existing tag policy for a single governed tag. For Terraform usage, see the [Tag Policy Terraform documentation](https://registry.terraform.io/providers/databricks/databricks/latest/docs/resources/tag_policy). To manage permissions for tag policies, use the [Account Access Control Proxy API](https://docs.databricks.com/api/workspace/accountaccesscontrolproxy). */
203
+ async updateTagPolicy(
204
+ req: UpdateTagPolicyRequest,
205
+ options?: CallOptions
206
+ ): Promise<TagPolicy> {
207
+ const url = `${this.host}/api/2.1/tag-policies/${req.tagPolicy?.tagKey ?? ''}`;
208
+ const params = new URLSearchParams();
209
+ if (req.updateMask !== undefined) {
210
+ params.append('update_mask', req.updateMask.toString());
211
+ }
212
+ const query = params.toString();
213
+ const fullUrl = query !== '' ? `${url}?${query}` : url;
214
+ const body = marshalRequest(req.tagPolicy, marshalTagPolicySchema);
215
+ let resp: TagPolicy | undefined;
216
+ const call: Call = async (callSignal?: AbortSignal): Promise<void> => {
217
+ const headers = new Headers({'Content-Type': 'application/json'});
218
+ if (this.workspaceId !== undefined) {
219
+ headers.set('X-Databricks-Org-Id', this.workspaceId);
220
+ }
221
+ headers.set('User-Agent', this.userAgent);
222
+ const httpReq = buildHttpRequest(
223
+ 'PATCH',
224
+ fullUrl,
225
+ headers,
226
+ callSignal,
227
+ body
228
+ );
229
+ const respBody = await executeHttpCall({
230
+ request: httpReq,
231
+ httpClient: this.httpClient,
232
+ logger: this.logger,
233
+ });
234
+ resp = parseResponse(respBody, unmarshalTagPolicySchema);
235
+ };
236
+ await executeCall(call, options);
237
+ if (resp === undefined) {
238
+ throw new Error('API call completed without a result.');
239
+ }
240
+ return resp;
241
+ }
242
+ }
@@ -0,0 +1,16 @@
1
+ // Code generated from API definition by Databricks SDK Generator. DO NOT EDIT.
2
+
3
+ export {TagpoliciesClient} from './client';
4
+
5
+ export type {
6
+ CreateTagPolicyRequest,
7
+ DeleteTagPolicyRequest,
8
+ GetTagPolicyRequest,
9
+ ListTagPoliciesRequest,
10
+ ListTagPoliciesResponse,
11
+ TagPolicy,
12
+ UpdateTagPolicyRequest,
13
+ Value,
14
+ } from './model';
15
+
16
+ export {tagPolicyFieldMask} from './model';
@@ -0,0 +1,142 @@
1
+ // Code generated from API definition by Databricks SDK Generator. DO NOT EDIT.
2
+
3
+ import {Temporal} from '@js-temporal/polyfill';
4
+ import {FieldMask} from '@databricks/sdk-core/wkt';
5
+ import type {FieldMaskSchema} from '@databricks/sdk-core/wkt';
6
+ import {z} from 'zod';
7
+
8
+ export interface CreateTagPolicyRequest {
9
+ tagPolicy?: TagPolicy | undefined;
10
+ }
11
+
12
+ export interface DeleteTagPolicyRequest {
13
+ tagKey?: string | undefined;
14
+ }
15
+
16
+ export interface GetTagPolicyRequest {
17
+ tagKey?: string | undefined;
18
+ }
19
+
20
+ export interface ListTagPoliciesRequest {
21
+ /**
22
+ * The maximum number of results to return in this request. Fewer results may be returned than requested. If
23
+ * unspecified or set to 0, this defaults to 1000. The maximum value is 1000; values above 1000 will be coerced down
24
+ * to 1000.
25
+ */
26
+ pageSize?: number | undefined;
27
+ /** An optional page token received from a previous list tag policies call. */
28
+ pageToken?: string | undefined;
29
+ }
30
+
31
+ export interface ListTagPoliciesResponse {
32
+ tagPolicies?: TagPolicy[] | undefined;
33
+ nextPageToken?: string | undefined;
34
+ }
35
+
36
+ export interface TagPolicy {
37
+ tagKey?: string | undefined;
38
+ id?: string | undefined;
39
+ description?: string | undefined;
40
+ values?: Value[] | undefined;
41
+ /** Timestamp when the tag policy was created */
42
+ createTime?: Temporal.Instant | undefined;
43
+ /** Timestamp when the tag policy was last updated */
44
+ updateTime?: Temporal.Instant | undefined;
45
+ }
46
+
47
+ export interface UpdateTagPolicyRequest {
48
+ tagPolicy?: TagPolicy | undefined;
49
+ updateMask?: FieldMask<TagPolicy> | undefined;
50
+ }
51
+
52
+ export interface Value {
53
+ name?: string | undefined;
54
+ }
55
+
56
+ export const unmarshalListTagPoliciesResponseSchema: z.ZodType<ListTagPoliciesResponse> =
57
+ z
58
+ .object({
59
+ tag_policies: z.array(z.lazy(() => unmarshalTagPolicySchema)).optional(),
60
+ next_page_token: z.string().optional(),
61
+ })
62
+ .transform(d => ({
63
+ tagPolicies: d.tag_policies,
64
+ nextPageToken: d.next_page_token,
65
+ }));
66
+
67
+ export const unmarshalTagPolicySchema: z.ZodType<TagPolicy> = z
68
+ .object({
69
+ tag_key: z.string().optional(),
70
+ id: z.string().optional(),
71
+ description: z.string().optional(),
72
+ values: z.array(z.lazy(() => unmarshalValueSchema)).optional(),
73
+ create_time: z
74
+ .string()
75
+ .transform(s => Temporal.Instant.from(s))
76
+ .optional(),
77
+ update_time: z
78
+ .string()
79
+ .transform(s => Temporal.Instant.from(s))
80
+ .optional(),
81
+ })
82
+ .transform(d => ({
83
+ tagKey: d.tag_key,
84
+ id: d.id,
85
+ description: d.description,
86
+ values: d.values,
87
+ createTime: d.create_time,
88
+ updateTime: d.update_time,
89
+ }));
90
+
91
+ export const unmarshalValueSchema: z.ZodType<Value> = z
92
+ .object({
93
+ name: z.string().optional(),
94
+ })
95
+ .transform(d => ({
96
+ name: d.name,
97
+ }));
98
+
99
+ export const marshalTagPolicySchema: z.ZodType = z
100
+ .object({
101
+ tagKey: z.string().optional(),
102
+ id: z.string().optional(),
103
+ description: z.string().optional(),
104
+ values: z.array(z.lazy(() => marshalValueSchema)).optional(),
105
+ createTime: z
106
+ .any()
107
+ .transform((d: Temporal.Instant) => d.toString())
108
+ .optional(),
109
+ updateTime: z
110
+ .any()
111
+ .transform((d: Temporal.Instant) => d.toString())
112
+ .optional(),
113
+ })
114
+ .transform(d => ({
115
+ tag_key: d.tagKey,
116
+ id: d.id,
117
+ description: d.description,
118
+ values: d.values,
119
+ create_time: d.createTime,
120
+ update_time: d.updateTime,
121
+ }));
122
+
123
+ export const marshalValueSchema: z.ZodType = z
124
+ .object({
125
+ name: z.string().optional(),
126
+ })
127
+ .transform(d => ({
128
+ name: d.name,
129
+ }));
130
+
131
+ const tagPolicyFieldMaskSchema: FieldMaskSchema = {
132
+ createTime: {wire: 'create_time'},
133
+ description: {wire: 'description'},
134
+ id: {wire: 'id'},
135
+ tagKey: {wire: 'tag_key'},
136
+ updateTime: {wire: 'update_time'},
137
+ values: {wire: 'values'},
138
+ };
139
+
140
+ export function tagPolicyFieldMask(...paths: string[]): FieldMask<TagPolicy> {
141
+ return FieldMask.build<TagPolicy>(paths, tagPolicyFieldMaskSchema);
142
+ }