cloudflare
Version:
The official TypeScript library for the Cloudflare API
233 lines • 6.99 kB
TypeScript
import { APIResource } from "../../../resource.js";
import * as Core from "../../../core.js";
import * as Shared from "../../shared.js";
import { TokensV4PagePaginationArray } from "../../shared.js";
import * as PermissionGroupsAPI from "./permission-groups.js";
import { PermissionGroupListResponse, PermissionGroupListResponsesSinglePage, PermissionGroups } from "./permission-groups.js";
import * as ValueAPI from "./value.js";
import { Value, ValueUpdateParams } from "./value.js";
import { type V4PagePaginationArrayParams } from "../../../pagination.js";
export declare class Tokens extends APIResource {
permissionGroups: PermissionGroupsAPI.PermissionGroups;
value: ValueAPI.Value;
/**
* Create a new access token.
*/
create(body: TokenCreateParams, options?: Core.RequestOptions): Core.APIPromise<TokenCreateResponse>;
/**
* Update an existing token.
*/
update(tokenId: string, body: TokenUpdateParams, options?: Core.RequestOptions): Core.APIPromise<Shared.Token>;
/**
* List all access tokens you created.
*/
list(query?: TokenListParams, options?: Core.RequestOptions): Core.PagePromise<TokensV4PagePaginationArray, Shared.Token>;
list(options?: Core.RequestOptions): Core.PagePromise<TokensV4PagePaginationArray, Shared.Token>;
/**
* Destroy a token.
*/
delete(tokenId: string, options?: Core.RequestOptions): Core.APIPromise<TokenDeleteResponse | null>;
/**
* Get information about a specific token.
*/
get(tokenId: string, options?: Core.RequestOptions): Core.APIPromise<Shared.Token>;
/**
* Test whether a token works.
*/
verify(options?: Core.RequestOptions): Core.APIPromise<TokenVerifyResponse>;
}
export interface TokenCreateResponse {
/**
* Token identifier tag.
*/
id?: string;
condition?: TokenCreateResponse.Condition;
/**
* The expiration time on or after which the JWT MUST NOT be accepted for
* processing.
*/
expires_on?: string;
/**
* The time on which the token was created.
*/
issued_on?: string;
/**
* Last time the token was used.
*/
last_used_on?: string;
/**
* Last time the token was modified.
*/
modified_on?: string;
/**
* Token name.
*/
name?: string;
/**
* The time before which the token MUST NOT be accepted for processing.
*/
not_before?: string;
/**
* List of access policies assigned to the token.
*/
policies?: Array<Shared.TokenPolicy>;
/**
* Status of the token.
*/
status?: 'active' | 'disabled' | 'expired';
/**
* The token value.
*/
value?: Shared.TokenValue;
}
export declare namespace TokenCreateResponse {
interface Condition {
/**
* Client IP restrictions.
*/
request_ip?: Condition.RequestIP;
}
namespace Condition {
/**
* Client IP restrictions.
*/
interface RequestIP {
/**
* List of IPv4/IPv6 CIDR addresses.
*/
in?: Array<Shared.TokenConditionCIDRList>;
/**
* List of IPv4/IPv6 CIDR addresses.
*/
not_in?: Array<Shared.TokenConditionCIDRList>;
}
}
}
export interface TokenDeleteResponse {
/**
* Identifier
*/
id: string;
}
export interface TokenVerifyResponse {
/**
* Token identifier tag.
*/
id: string;
/**
* Status of the token.
*/
status: 'active' | 'disabled' | 'expired';
/**
* The expiration time on or after which the JWT MUST NOT be accepted for
* processing.
*/
expires_on?: string;
/**
* The time before which the token MUST NOT be accepted for processing.
*/
not_before?: string;
}
export interface TokenCreateParams {
/**
* Token name.
*/
name: string;
/**
* List of access policies assigned to the token.
*/
policies: Array<Shared.TokenPolicyParam>;
condition?: TokenCreateParams.Condition;
/**
* The expiration time on or after which the JWT MUST NOT be accepted for
* processing.
*/
expires_on?: string;
/**
* The time before which the token MUST NOT be accepted for processing.
*/
not_before?: string;
}
export declare namespace TokenCreateParams {
interface Condition {
/**
* Client IP restrictions.
*/
request_ip?: Condition.RequestIP;
}
namespace Condition {
/**
* Client IP restrictions.
*/
interface RequestIP {
/**
* List of IPv4/IPv6 CIDR addresses.
*/
in?: Array<Shared.TokenConditionCIDRListParam>;
/**
* List of IPv4/IPv6 CIDR addresses.
*/
not_in?: Array<Shared.TokenConditionCIDRListParam>;
}
}
}
export interface TokenUpdateParams {
/**
* Token name.
*/
name: string;
/**
* List of access policies assigned to the token.
*/
policies: Array<Shared.TokenPolicyParam>;
/**
* Status of the token.
*/
status: 'active' | 'disabled' | 'expired';
condition?: TokenUpdateParams.Condition;
/**
* The expiration time on or after which the JWT MUST NOT be accepted for
* processing.
*/
expires_on?: string;
/**
* The time before which the token MUST NOT be accepted for processing.
*/
not_before?: string;
}
export declare namespace TokenUpdateParams {
interface Condition {
/**
* Client IP restrictions.
*/
request_ip?: Condition.RequestIP;
}
namespace Condition {
/**
* Client IP restrictions.
*/
interface RequestIP {
/**
* List of IPv4/IPv6 CIDR addresses.
*/
in?: Array<Shared.TokenConditionCIDRListParam>;
/**
* List of IPv4/IPv6 CIDR addresses.
*/
not_in?: Array<Shared.TokenConditionCIDRListParam>;
}
}
}
export interface TokenListParams extends V4PagePaginationArrayParams {
/**
* Direction to order results.
*/
direction?: 'asc' | 'desc';
}
export declare namespace Tokens {
export { type TokenCreateResponse as TokenCreateResponse, type TokenDeleteResponse as TokenDeleteResponse, type TokenVerifyResponse as TokenVerifyResponse, type TokenCreateParams as TokenCreateParams, type TokenUpdateParams as TokenUpdateParams, type TokenListParams as TokenListParams, };
export { PermissionGroups as PermissionGroups, type PermissionGroupListResponse as PermissionGroupListResponse, PermissionGroupListResponsesSinglePage as PermissionGroupListResponsesSinglePage, };
export { Value as Value, type ValueUpdateParams as ValueUpdateParams };
}
export { TokensV4PagePaginationArray };
//# sourceMappingURL=tokens.d.ts.map