VimPlug/typeshed
1
0
Fork 0
mirror of https://github.com/davidhalter/typeshed.git synced 2026-08-17 05:18:04 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

Replace Incomplete | None = None in third party stubs (#14063)

Browse Source
This commit is contained in:
Sebastian Rittau
2025-05-15 21:37:43 +02:00
committed by GitHub
parent acc51542c9
commit 126768408a
488 changed files with 2259 additions and 4044 deletions
Download Patch File Download Diff File Expand all files Collapse all files
stubs/hvac/hvac/api/auth_methods/approle.pyi
+17 -32
View File
@@ -1,25 +1,23 @@
from _typeshed import Incomplete
from hvac.api.vault_api_base import VaultApiBase
class AppRole(VaultApiBase):
def create_or_update_approle(
self,
role_name,
bind_secret_id: Incomplete | None = None,
secret_id_bound_cidrs: Incomplete | None = None,
secret_id_num_uses: Incomplete | None = None,
secret_id_ttl: Incomplete | None = None,
enable_local_secret_ids: Incomplete | None = None,
token_ttl: Incomplete | None = None,
token_max_ttl: Incomplete | None = None,
token_policies: Incomplete | None = None,
token_bound_cidrs: Incomplete | None = None,
token_explicit_max_ttl: Incomplete | None = None,
token_no_default_policy: Incomplete | None = None,
token_num_uses: Incomplete | None = None,
token_period: Incomplete | None = None,
token_type: Incomplete | None = None,
bind_secret_id=None,
secret_id_bound_cidrs=None,
secret_id_num_uses=None,
secret_id_ttl=None,
enable_local_secret_ids=None,
token_ttl=None,
token_max_ttl=None,
token_policies=None,
token_bound_cidrs=None,
token_explicit_max_ttl=None,
token_no_default_policy=None,
token_num_uses=None,
token_period=None,
token_type=None,
mount_point="approle",
): ...
def list_roles(self, mount_point="approle"): ...
@@ -28,27 +26,14 @@ class AppRole(VaultApiBase):
def read_role_id(self, role_name, mount_point="approle"): ...
def update_role_id(self, role_name, role_id, mount_point="approle"): ...
def generate_secret_id(
self,
role_name,
metadata: Incomplete | None = None,
cidr_list: Incomplete | None = None,
token_bound_cidrs: Incomplete | None = None,
mount_point="approle",
wrap_ttl: Incomplete | None = None,
self, role_name, metadata=None, cidr_list=None, token_bound_cidrs=None, mount_point="approle", wrap_ttl=None
): ...
def create_custom_secret_id(
self,
role_name,
secret_id,
metadata: Incomplete | None = None,
cidr_list: Incomplete | None = None,
token_bound_cidrs: Incomplete | None = None,
mount_point="approle",
wrap_ttl: Incomplete | None = None,
self, role_name, secret_id, metadata=None, cidr_list=None, token_bound_cidrs=None, mount_point="approle", wrap_ttl=None
): ...
def read_secret_id(self, role_name, secret_id, mount_point="approle"): ...
def destroy_secret_id(self, role_name, secret_id, mount_point="approle"): ...
def list_secret_id_accessors(self, role_name, mount_point="approle"): ...
def read_secret_id_accessor(self, role_name, secret_id_accessor, mount_point="approle"): ...
def destroy_secret_id_accessor(self, role_name, secret_id_accessor, mount_point="approle"): ...
def login(self, role_id, secret_id: Incomplete | None = None, use_token: bool = True, mount_point="approle"): ...
def login(self, role_id, secret_id=None, use_token: bool = True, mount_point="approle"): ...
stubs/hvac/hvac/api/auth_methods/aws.pyi
+41 -54
View File
@@ -7,13 +7,13 @@ logger: Incomplete
class Aws(VaultApiBase):
def configure(
self,
max_retries: Incomplete | None = None,
access_key: Incomplete | None = None,
secret_key: Incomplete | None = None,
endpoint: Incomplete | None = None,
iam_endpoint: Incomplete | None = None,
sts_endpoint: Incomplete | None = None,
iam_server_id_header_value: Incomplete | None = None,
max_retries=None,
access_key=None,
secret_key=None,
endpoint=None,
iam_endpoint=None,
sts_endpoint=None,
iam_server_id_header_value=None,
mount_point: str = "aws",
sts_region: str | None = None,
): ...
@@ -21,16 +21,14 @@ class Aws(VaultApiBase):
def delete_config(self, mount_point: str = "aws"): ...
def configure_identity_integration(
self,
iam_alias: Incomplete | None = None,
ec2_alias: Incomplete | None = None,
iam_alias=None,
ec2_alias=None,
mount_point: str = "aws",
iam_metadata: str | list[str] | None = None,
ec2_metadata: str | list[str] | None = None,
): ...
def read_identity_integration(self, mount_point: str = "aws"): ...
def create_certificate_configuration(
self, cert_name, aws_public_cert, document_type: Incomplete | None = None, mount_point: str = "aws"
): ...
def create_certificate_configuration(self, cert_name, aws_public_cert, document_type=None, mount_point: str = "aws"): ...
def read_certificate_configuration(self, cert_name, mount_point: str = "aws"): ...
def delete_certificate_configuration(self, cert_name, mount_point: str = "aws"): ...
def list_certificate_configurations(self, mount_point: str = "aws"): ...
@@ -38,39 +36,35 @@ class Aws(VaultApiBase):
def read_sts_role(self, account_id, mount_point: str = "aws"): ...
def list_sts_roles(self, mount_point: str = "aws"): ...
def delete_sts_role(self, account_id, mount_point: str = "aws"): ...
def configure_identity_whitelist_tidy(
self, safety_buffer: Incomplete | None = None, disable_periodic_tidy: Incomplete | None = None, mount_point: str = "aws"
): ...
def configure_identity_whitelist_tidy(self, safety_buffer=None, disable_periodic_tidy=None, mount_point: str = "aws"): ...
def read_identity_whitelist_tidy(self, mount_point: str = "aws"): ...
def delete_identity_whitelist_tidy(self, mount_point: str = "aws"): ...
def configure_role_tag_blacklist_tidy(
self, safety_buffer: Incomplete | None = None, disable_periodic_tidy: Incomplete | None = None, mount_point: str = "aws"
): ...
def configure_role_tag_blacklist_tidy(self, safety_buffer=None, disable_periodic_tidy=None, mount_point: str = "aws"): ...
def read_role_tag_blacklist_tidy(self, mount_point: str = "aws"): ...
def delete_role_tag_blacklist_tidy(self, mount_point: str = "aws"): ...
def create_role(
self,
role,
auth_type: Incomplete | None = None,
bound_ami_id: Incomplete | None = None,
bound_account_id: Incomplete | None = None,
bound_region: Incomplete | None = None,
bound_vpc_id: Incomplete | None = None,
bound_subnet_id: Incomplete | None = None,
bound_iam_role_arn: Incomplete | None = None,
bound_iam_instance_profile_arn: Incomplete | None = None,
bound_ec2_instance_id: Incomplete | None = None,
role_tag: Incomplete | None = None,
bound_iam_principal_arn: Incomplete | None = None,
inferred_entity_type: Incomplete | None = None,
inferred_aws_region: Incomplete | None = None,
resolve_aws_unique_ids: Incomplete | None = None,
ttl: Incomplete | None = None,
max_ttl: Incomplete | None = None,
period: Incomplete | None = None,
policies: Incomplete | None = None,
allow_instance_migration: Incomplete | None = None,
disallow_reauthentication: Incomplete | None = None,
auth_type=None,
bound_ami_id=None,
bound_account_id=None,
bound_region=None,
bound_vpc_id=None,
bound_subnet_id=None,
bound_iam_role_arn=None,
bound_iam_instance_profile_arn=None,
bound_ec2_instance_id=None,
role_tag=None,
bound_iam_principal_arn=None,
inferred_entity_type=None,
inferred_aws_region=None,
resolve_aws_unique_ids=None,
ttl=None,
max_ttl=None,
period=None,
policies=None,
allow_instance_migration=None,
disallow_reauthentication=None,
mount_point: str = "aws",
): ...
def read_role(self, role, mount_point: str = "aws"): ...
@@ -79,32 +73,25 @@ class Aws(VaultApiBase):
def create_role_tags(
self,
role,
policies: Incomplete | None = None,
max_ttl: Incomplete | None = None,
instance_id: Incomplete | None = None,
allow_instance_migration: Incomplete | None = None,
disallow_reauthentication: Incomplete | None = None,
policies=None,
max_ttl=None,
instance_id=None,
allow_instance_migration=None,
disallow_reauthentication=None,
mount_point: str = "aws",
): ...
def iam_login(
self,
access_key,
secret_key,
session_token: Incomplete | None = None,
header_value: Incomplete | None = None,
role: Incomplete | None = None,
session_token=None,
header_value=None,
role=None,
use_token: bool = True,
region: str = "us-east-1",
mount_point: str = "aws",
): ...
def ec2_login(
self,
pkcs7,
nonce: Incomplete | None = None,
role: Incomplete | None = None,
use_token: bool = True,
mount_point: str = "aws",
): ...
def ec2_login(self, pkcs7, nonce=None, role=None, use_token: bool = True, mount_point: str = "aws"): ...
def place_role_tags_in_blacklist(self, role_tag, mount_point: str = "aws"): ...
def read_role_tag_blacklist(self, role_tag, mount_point: str = "aws"): ...
def list_blacklist_tags(self, mount_point: str = "aws"): ...
stubs/hvac/hvac/api/auth_methods/azure.pyi
+16 -24
View File
@@ -6,31 +6,23 @@ DEFAULT_MOUNT_POINT: str
logger: Incomplete
class Azure(VaultApiBase):
def configure(
self,
tenant_id,
resource,
environment: Incomplete | None = None,
client_id: Incomplete | None = None,
client_secret: Incomplete | None = None,
mount_point="azure",
): ...
def configure(self, tenant_id, resource, environment=None, client_id=None, client_secret=None, mount_point="azure"): ...
def read_config(self, mount_point="azure"): ...
def delete_config(self, mount_point="azure"): ...
def create_role(
self,
name,
policies: Incomplete | None = None,
ttl: Incomplete | None = None,
max_ttl: Incomplete | None = None,
period: Incomplete | None = None,
bound_service_principal_ids: Incomplete | None = None,
bound_group_ids: Incomplete | None = None,
bound_locations: Incomplete | None = None,
bound_subscription_ids: Incomplete | None = None,
bound_resource_groups: Incomplete | None = None,
bound_scale_sets: Incomplete | None = None,
num_uses: Incomplete | None = None,
policies=None,
ttl=None,
max_ttl=None,
period=None,
bound_service_principal_ids=None,
bound_group_ids=None,
bound_locations=None,
bound_subscription_ids=None,
bound_resource_groups=None,
bound_scale_sets=None,
num_uses=None,
mount_point="azure",
): ...
def read_role(self, name, mount_point="azure"): ...
@@ -40,10 +32,10 @@ class Azure(VaultApiBase):
self,
role,
jwt,
subscription_id: Incomplete | None = None,
resource_group_name: Incomplete | None = None,
vm_name: Incomplete | None = None,
vmss_name: Incomplete | None = None,
subscription_id=None,
resource_group_name=None,
vm_name=None,
vmss_name=None,
use_token: bool = True,
mount_point="azure",
): ...
stubs/hvac/hvac/api/auth_methods/gcp.pyi
+14 -21
View File
@@ -7,10 +7,7 @@ logger: Incomplete
class Gcp(VaultApiBase):
def configure(
self,
credentials: Incomplete | None = None,
google_certs_endpoint="https://www.googleapis.com/oauth2/v3/certs",
mount_point="gcp",
self, credentials=None, google_certs_endpoint="https://www.googleapis.com/oauth2/v3/certs", mount_point="gcp"
): ...
def read_config(self, mount_point="gcp"): ...
def delete_config(self, mount_point="gcp"): ...
@@ -19,25 +16,21 @@ class Gcp(VaultApiBase):
name,
role_type,
project_id,
ttl: Incomplete | None = None,
max_ttl: Incomplete | None = None,
period: Incomplete | None = None,
policies: Incomplete | None = None,
bound_service_accounts: Incomplete | None = None,
max_jwt_exp: Incomplete | None = None,
allow_gce_inference: Incomplete | None = None,
bound_zones: Incomplete | None = None,
bound_regions: Incomplete | None = None,
bound_instance_groups: Incomplete | None = None,
bound_labels: Incomplete | None = None,
ttl=None,
max_ttl=None,
period=None,
policies=None,
bound_service_accounts=None,
max_jwt_exp=None,
allow_gce_inference=None,
bound_zones=None,
bound_regions=None,
bound_instance_groups=None,
bound_labels=None,
mount_point="gcp",
): ...
def edit_service_accounts_on_iam_role(
self, name, add: Incomplete | None = None, remove: Incomplete | None = None, mount_point="gcp"
): ...
def edit_labels_on_gce_role(
self, name, add: Incomplete | None = None, remove: Incomplete | None = None, mount_point="gcp"
): ...
def edit_service_accounts_on_iam_role(self, name, add=None, remove=None, mount_point="gcp"): ...
def edit_labels_on_gce_role(self, name, add=None, remove=None, mount_point="gcp"): ...
def read_role(self, name, mount_point="gcp"): ...
def list_roles(self, mount_point="gcp"): ...
def delete_role(self, role, mount_point="gcp"): ...
stubs/hvac/hvac/api/auth_methods/github.pyi
+3 -12
View File
@@ -1,21 +1,12 @@
from _typeshed import Incomplete
from hvac.api.vault_api_base import VaultApiBase
DEFAULT_MOUNT_POINT: str
class Github(VaultApiBase):
def configure(
self,
organization,
base_url: Incomplete | None = None,
ttl: Incomplete | None = None,
max_ttl: Incomplete | None = None,
mount_point="github",
): ...
def configure(self, organization, base_url=None, ttl=None, max_ttl=None, mount_point="github"): ...
def read_configuration(self, mount_point="github"): ...
def map_team(self, team_name, policies: Incomplete | None = None, mount_point="github"): ...
def map_team(self, team_name, policies=None, mount_point="github"): ...
def read_team_mapping(self, team_name, mount_point="github"): ...
def map_user(self, user_name, policies: Incomplete | None = None, mount_point="github"): ...
def map_user(self, user_name, policies=None, mount_point="github"): ...
def read_user_mapping(self, user_name, mount_point="github"): ...
def login(self, token, use_token: bool = True, mount_point="github"): ...
stubs/hvac/hvac/api/auth_methods/jwt.pyi
+40 -42
View File
@@ -1,5 +1,3 @@
from _typeshed import Incomplete
from hvac.api.vault_api_base import VaultApiBase
class JWT(VaultApiBase):
@@ -7,55 +5,55 @@ class JWT(VaultApiBase):
def resolve_path(self, path): ...
def configure(
self,
oidc_discovery_url: Incomplete | None = None,
oidc_discovery_ca_pem: Incomplete | None = None,
oidc_client_id: Incomplete | None = None,
oidc_client_secret: Incomplete | None = None,
oidc_response_mode: Incomplete | None = None,
oidc_response_types: Incomplete | None = None,
jwks_url: Incomplete | None = None,
jwks_ca_pem: Incomplete | None = None,
jwt_validation_pubkeys: Incomplete | None = None,
bound_issuer: Incomplete | None = None,
jwt_supported_algs: Incomplete | None = None,
default_role: Incomplete | None = None,
provider_config: Incomplete | None = None,
oidc_discovery_url=None,
oidc_discovery_ca_pem=None,
oidc_client_id=None,
oidc_client_secret=None,
oidc_response_mode=None,
oidc_response_types=None,
jwks_url=None,
jwks_ca_pem=None,
jwt_validation_pubkeys=None,
bound_issuer=None,
jwt_supported_algs=None,
default_role=None,
provider_config=None,
path: str | None = None,
namespace_in_state: bool | None = None,
): ...
def read_config(self, path: Incomplete | None = None): ...
def read_config(self, path=None): ...
def create_role(
self,
name,
user_claim,
allowed_redirect_uris,
role_type: str = "jwt",
bound_audiences: Incomplete | None = None,
clock_skew_leeway: Incomplete | None = None,
expiration_leeway: Incomplete | None = None,
not_before_leeway: Incomplete | None = None,
bound_subject: Incomplete | None = None,
bound_claims: Incomplete | None = None,
groups_claim: Incomplete | None = None,
claim_mappings: Incomplete | None = None,
oidc_scopes: Incomplete | None = None,
bound_audiences=None,
clock_skew_leeway=None,
expiration_leeway=None,
not_before_leeway=None,
bound_subject=None,
bound_claims=None,
groups_claim=None,
claim_mappings=None,
oidc_scopes=None,
bound_claims_type: str = "string",
verbose_oidc_logging: bool = False,
token_ttl: Incomplete | None = None,
token_max_ttl: Incomplete | None = None,
token_policies: Incomplete | None = None,
token_bound_cidrs: Incomplete | None = None,
token_explicit_max_ttl: Incomplete | None = None,
token_no_default_policy: Incomplete | None = None,
token_num_uses: Incomplete | None = None,
token_period: Incomplete | None = None,
token_type: Incomplete | None = None,
path: Incomplete | None = None,
user_claim_json_pointer: Incomplete | None = None,
token_ttl=None,
token_max_ttl=None,
token_policies=None,
token_bound_cidrs=None,
token_explicit_max_ttl=None,
token_no_default_policy=None,
token_num_uses=None,
token_period=None,
token_type=None,
path=None,
user_claim_json_pointer=None,
): ...
def read_role(self, name, path: Incomplete | None = None): ...
def list_roles(self, path: Incomplete | None = None): ...
def delete_role(self, name, path: Incomplete | None = None): ...
def oidc_authorization_url_request(self, role, redirect_uri, path: Incomplete | None = None): ...
def oidc_callback(self, state, nonce, code, path: Incomplete | None = None): ...
def jwt_login(self, role, jwt, use_token: bool = True, path: Incomplete | None = None): ...
def read_role(self, name, path=None): ...
def list_roles(self, path=None): ...
def delete_role(self, name, path=None): ...
def oidc_authorization_url_request(self, role, redirect_uri, path=None): ...
def oidc_callback(self, state, nonce, code, path=None): ...
def jwt_login(self, role, jwt, use_token: bool = True, path=None): ...
stubs/hvac/hvac/api/auth_methods/kubernetes.pyi
+9 -11
View File
@@ -1,5 +1,3 @@
from _typeshed import Incomplete
from hvac.api.vault_api_base import VaultApiBase
DEFAULT_MOUNT_POINT: str
@@ -8,10 +6,10 @@ class Kubernetes(VaultApiBase):
def configure(
self,
kubernetes_host,
kubernetes_ca_cert: Incomplete | None = None,
token_reviewer_jwt: Incomplete | None = None,
pem_keys: Incomplete | None = None,
issuer: Incomplete | None = None,
kubernetes_ca_cert=None,
token_reviewer_jwt=None,
pem_keys=None,
issuer=None,
mount_point="kubernetes",
disable_local_ca_jwt: bool = False,
): ...
@@ -21,13 +19,13 @@ class Kubernetes(VaultApiBase):
name,
bound_service_account_names,
bound_service_account_namespaces,
ttl: Incomplete | None = None,
max_ttl: Incomplete | None = None,
period: Incomplete | None = None,
policies: Incomplete | None = None,
ttl=None,
max_ttl=None,
period=None,
policies=None,
token_type: str = "",
mount_point="kubernetes",
alias_name_source: Incomplete | None = None,
alias_name_source=None,
): ...
def read_role(self, name, mount_point="kubernetes"): ...
def list_roles(self, mount_point="kubernetes"): ...
stubs/hvac/hvac/api/auth_methods/ldap.pyi
+37 -41
View File
@@ -1,5 +1,3 @@
from _typeshed import Incomplete
from hvac.api.vault_api_base import VaultApiBase
DEFAULT_MOUNT_POINT: str
@@ -7,53 +5,51 @@ DEFAULT_MOUNT_POINT: str
class Ldap(VaultApiBase):
def configure(
self,
userdn: Incomplete | None = None,
groupdn: Incomplete | None = None,
url: Incomplete | None = None,
case_sensitive_names: Incomplete | None = None,
starttls: Incomplete | None = None,
tls_min_version: Incomplete | None = None,
tls_max_version: Incomplete | None = None,
insecure_tls: Incomplete | None = None,
certificate: Incomplete | None = None,
binddn: Incomplete | None = None,
bindpass: Incomplete | None = None,
userattr: Incomplete | None = None,
discoverdn: Incomplete | None = None,
userdn=None,
groupdn=None,
url=None,
case_sensitive_names=None,
starttls=None,
tls_min_version=None,
tls_max_version=None,
insecure_tls=None,
certificate=None,
binddn=None,
bindpass=None,
userattr=None,
discoverdn=None,
deny_null_bind: bool = True,
upndomain: Incomplete | None = None,
groupfilter: Incomplete | None = None,
groupattr: Incomplete | None = None,
use_token_groups: Incomplete | None = None,
token_ttl: Incomplete | None = None,
token_max_ttl: Incomplete | None = None,
upndomain=None,
groupfilter=None,
groupattr=None,
use_token_groups=None,
token_ttl=None,
token_max_ttl=None,
mount_point="ldap",
*,
anonymous_group_search: Incomplete | None = None,
client_tls_cert: Incomplete | None = None,
client_tls_key: Incomplete | None = None,
connection_timeout: Incomplete | None = None,
dereference_aliases: Incomplete | None = None,
max_page_size: Incomplete | None = None,
request_timeout: Incomplete | None = None,
token_bound_cidrs: Incomplete | None = None,
token_explicit_max_ttl: Incomplete | None = None,
token_no_default_policy: Incomplete | None = None,
token_num_uses: Incomplete | None = None,
token_period: Incomplete | None = None,
token_policies: Incomplete | None = None,
token_type: Incomplete | None = None,
userfilter: Incomplete | None = None,
username_as_alias: Incomplete | None = None,
anonymous_group_search=None,
client_tls_cert=None,
client_tls_key=None,
connection_timeout=None,
dereference_aliases=None,
max_page_size=None,
request_timeout=None,
token_bound_cidrs=None,
token_explicit_max_ttl=None,
token_no_default_policy=None,
token_num_uses=None,
token_period=None,
token_policies=None,
token_type=None,
userfilter=None,
username_as_alias=None,
): ...
def read_configuration(self, mount_point="ldap"): ...
def create_or_update_group(self, name, policies: Incomplete | None = None, mount_point="ldap"): ...
def create_or_update_group(self, name, policies=None, mount_point="ldap"): ...
def list_groups(self, mount_point="ldap"): ...
def read_group(self, name, mount_point="ldap"): ...
def delete_group(self, name, mount_point="ldap"): ...
def create_or_update_user(
self, username, policies: Incomplete | None = None, groups: Incomplete | None = None, mount_point="ldap"
): ...
def create_or_update_user(self, username, policies=None, groups=None, mount_point="ldap"): ...
def list_users(self, mount_point="ldap"): ...
def read_user(self, username, mount_point="ldap"): ...
def delete_user(self, username, mount_point="ldap"): ...
stubs/hvac/hvac/api/auth_methods/legacy_mfa.pyi
+1 -3
View File
@@ -9,7 +9,5 @@ class LegacyMfa(VaultApiBase):
def configure(self, mount_point, mfa_type: str = "duo", force: bool = False): ...
def read_configuration(self, mount_point): ...
def configure_duo_access(self, mount_point, host, integration_key, secret_key): ...
def configure_duo_behavior(
self, mount_point, push_info: Incomplete | None = None, user_agent: Incomplete | None = None, username_format: str = "%s"
): ...
def configure_duo_behavior(self, mount_point, push_info=None, user_agent=None, username_format: str = "%s"): ...
def read_duo_behavior_configuration(self, mount_point): ...
stubs/hvac/hvac/api/auth_methods/oidc.pyi
+20 -22
View File
@@ -1,5 +1,3 @@
from _typeshed import Incomplete
from hvac.api.auth_methods.jwt import JWT
class OIDC(JWT):
@@ -10,26 +8,26 @@ class OIDC(JWT):
user_claim,
allowed_redirect_uris,
role_type: str = "oidc",
bound_audiences: Incomplete | None = None,
clock_skew_leeway: Incomplete | None = None,
expiration_leeway: Incomplete | None = None,
not_before_leeway: Incomplete | None = None,
bound_subject: Incomplete | None = None,
bound_claims: Incomplete | None = None,
groups_claim: Incomplete | None = None,
claim_mappings: Incomplete | None = None,
oidc_scopes: Incomplete | None = None,
bound_audiences=None,
clock_skew_leeway=None,
expiration_leeway=None,
not_before_leeway=None,
bound_subject=None,
bound_claims=None,
groups_claim=None,
claim_mappings=None,
oidc_scopes=None,
bound_claims_type: str = "string",
verbose_oidc_logging: bool = False,
token_ttl: Incomplete | None = None,
token_max_ttl: Incomplete | None = None,
token_policies: Incomplete | None = None,
token_bound_cidrs: Incomplete | None = None,
token_explicit_max_ttl: Incomplete | None = None,
token_no_default_policy: Incomplete | None = None,
token_num_uses: Incomplete | None = None,
token_period: Incomplete | None = None,
token_type: Incomplete | None = None,
path: Incomplete | None = None,
user_claim_json_pointer: Incomplete | None = None,
token_ttl=None,
token_max_ttl=None,
token_policies=None,
token_bound_cidrs=None,
token_explicit_max_ttl=None,
token_no_default_policy=None,
token_num_uses=None,
token_period=None,
token_type=None,
path=None,
user_claim_json_pointer=None,
) -> None: ...
stubs/hvac/hvac/api/auth_methods/okta.pyi
+3 -14
View File
@@ -1,29 +1,18 @@
from _typeshed import Incomplete
from hvac.api.vault_api_base import VaultApiBase
DEFAULT_MOUNT_POINT: str
class Okta(VaultApiBase):
def configure(
self,
org_name,
api_token: Incomplete | None = None,
base_url: Incomplete | None = None,
ttl: Incomplete | None = None,
max_ttl: Incomplete | None = None,
bypass_okta_mfa: Incomplete | None = None,
mount_point="okta",
self, org_name, api_token=None, base_url=None, ttl=None, max_ttl=None, bypass_okta_mfa=None, mount_point="okta"
): ...
def read_config(self, mount_point="okta"): ...
def list_users(self, mount_point="okta"): ...
def register_user(
self, username, groups: Incomplete | None = None, policies: Incomplete | None = None, mount_point="okta"
): ...
def register_user(self, username, groups=None, policies=None, mount_point="okta"): ...
def read_user(self, username, mount_point="okta"): ...
def delete_user(self, username, mount_point="okta"): ...
def list_groups(self, mount_point="okta"): ...
def register_group(self, name, policies: Incomplete | None = None, mount_point="okta"): ...
def register_group(self, name, policies=None, mount_point="okta"): ...
def read_group(self, name, mount_point="okta"): ...
def delete_group(self, name, mount_point="okta"): ...
def login(self, username, password, use_token: bool = True, mount_point="okta"): ...
stubs/hvac/hvac/api/auth_methods/radius.pyi
+2 -11
View File
@@ -1,22 +1,13 @@
from _typeshed import Incomplete
from hvac.api.vault_api_base import VaultApiBase
DEFAULT_MOUNT_POINT: str
class Radius(VaultApiBase):
def configure(
self,
host,
secret,
port: Incomplete | None = None,
unregistered_user_policies: Incomplete | None = None,
dial_timeout: Incomplete | None = None,
nas_port: Incomplete | None = None,
mount_point="radius",
self, host, secret, port=None, unregistered_user_policies=None, dial_timeout=None, nas_port=None, mount_point="radius"
): ...
def read_configuration(self, mount_point="radius"): ...
def register_user(self, username, policies: Incomplete | None = None, mount_point="radius"): ...
def register_user(self, username, policies=None, mount_point="radius"): ...
def list_users(self, mount_point="radius"): ...
def read_user(self, username, mount_point="radius"): ...
def delete_user(self, username, mount_point="radius"): ...
stubs/hvac/hvac/api/auth_methods/token.pyi
+29 -33
View File
@@ -1,5 +1,3 @@
from _typeshed import Incomplete
from hvac.api.vault_api_base import VaultApiBase
DEFAULT_MOUNT_POINT: str
@@ -7,50 +5,48 @@ DEFAULT_MOUNT_POINT: str
class Token(VaultApiBase):
def create(
self,
id: Incomplete | None = None,
role_name: Incomplete | None = None,
policies: Incomplete | None = None,
meta: Incomplete | None = None,
id=None,
role_name=None,
policies=None,
meta=None,
no_parent: bool = False,
no_default_policy: bool = False,
renewable: bool = True,
ttl: Incomplete | None = None,
type: Incomplete | None = None,
explicit_max_ttl: Incomplete | None = None,
ttl=None,
type=None,
explicit_max_ttl=None,
display_name: str = "token",
num_uses: int = 0,
period: Incomplete | None = None,
entity_alias: Incomplete | None = None,
wrap_ttl: Incomplete | None = None,
period=None,
entity_alias=None,
wrap_ttl=None,
mount_point="token",
): ...
def create_orphan(
self,
id: Incomplete | None = None,
role_name: Incomplete | None = None,
policies: Incomplete | None = None,
meta: Incomplete | None = None,
id=None,
role_name=None,
policies=None,
meta=None,
no_default_policy: bool = False,
renewable: bool = True,
ttl: Incomplete | None = None,
type: Incomplete | None = None,
explicit_max_ttl: Incomplete | None = None,
ttl=None,
type=None,
explicit_max_ttl=None,
display_name: str = "token",
num_uses: int = 0,
period: Incomplete | None = None,
entity_alias: Incomplete | None = None,
wrap_ttl: Incomplete | None = None,
period=None,
entity_alias=None,
wrap_ttl=None,
mount_point="token",
): ...
def list_accessors(self, mount_point="token"): ...
def lookup(self, token, mount_point="token"): ...
def lookup_self(self, mount_point="token"): ...
def lookup_accessor(self, accessor, mount_point="token"): ...
def renew(self, token, increment: Incomplete | None = None, wrap_ttl: Incomplete | None = None, mount_point="token"): ...
def renew_self(self, increment: Incomplete | None = None, wrap_ttl: Incomplete | None = None, mount_point="token"): ...
def renew_accessor(
self, accessor, increment: Incomplete | None = None, wrap_ttl: Incomplete | None = None, mount_point="token"
): ...
def renew(self, token, increment=None, wrap_ttl=None, mount_point="token"): ...
def renew_self(self, increment=None, wrap_ttl=None, mount_point="token"): ...
def renew_accessor(self, accessor, increment=None, wrap_ttl=None, mount_point="token"): ...
def revoke(self, token, mount_point="token"): ...
def revoke_self(self, mount_point="token"): ...
def revoke_accessor(self, accessor, mount_point="token"): ...
@@ -60,15 +56,15 @@ class Token(VaultApiBase):
def create_or_update_role(
self,
role_name,
allowed_policies: Incomplete | None = None,
disallowed_policies: Incomplete | None = None,
allowed_policies=None,
disallowed_policies=None,
orphan: bool = False,
renewable: bool = True,
path_suffix: Incomplete | None = None,
allowed_entity_aliases: Incomplete | None = None,
path_suffix=None,
allowed_entity_aliases=None,
mount_point="token",
token_period: Incomplete | None = None,
token_explicit_max_ttl: Incomplete | None = None,
token_period=None,
token_explicit_max_ttl=None,
): ...
def delete_role(self, role_name, mount_point="token"): ...
def tidy(self, mount_point="token"): ...
stubs/hvac/hvac/api/auth_methods/userpass.pyi
+1 -5
View File
@@ -1,13 +1,9 @@
from _typeshed import Incomplete
from hvac.api.vault_api_base import VaultApiBase
DEFAULT_MOUNT_POINT: str
class Userpass(VaultApiBase):
def create_or_update_user(
self, username, password: Incomplete | None = None, policies: Incomplete | None = None, mount_point="userpass", **kwargs
): ...
def create_or_update_user(self, username, password=None, policies=None, mount_point="userpass", **kwargs): ...
def list_user(self, mount_point="userpass"): ...
def read_user(self, username, mount_point="userpass"): ...
def delete_user(self, username, mount_point="userpass"): ...
stubs/hvac/hvac/api/secrets_engines/active_directory.pyi
+8 -12
View File
@@ -1,5 +1,3 @@
from _typeshed import Incomplete
from hvac.api.vault_api_base import VaultApiBase
DEFAULT_MOUNT_POINT: str
@@ -7,21 +5,19 @@ DEFAULT_MOUNT_POINT: str
class ActiveDirectory(VaultApiBase):
def configure(
self,
binddn: Incomplete | None = None,
bindpass: Incomplete | None = None,
url: Incomplete | None = None,
userdn: Incomplete | None = None,
upndomain: Incomplete | None = None,
ttl: Incomplete | None = None,
max_ttl: Incomplete | None = None,
binddn=None,
bindpass=None,
url=None,
userdn=None,
upndomain=None,
ttl=None,
max_ttl=None,
mount_point="ad",
*args,
**kwargs,
): ...
def read_config(self, mount_point="ad"): ...
def create_or_update_role(
self, name, service_account_name: Incomplete | None = None, ttl: Incomplete | None = None, mount_point="ad"
): ...
def create_or_update_role(self, name, service_account_name=None, ttl=None, mount_point="ad"): ...
def read_role(self, name, mount_point="ad"): ...
def list_roles(self, mount_point="ad"): ...
def delete_role(self, name, mount_point="ad"): ...
stubs/hvac/hvac/api/secrets_engines/aws.pyi
+8 -23
View File
@@ -1,17 +1,8 @@
from _typeshed import Incomplete
from hvac.api.vault_api_base import VaultApiBase
class Aws(VaultApiBase):
def configure_root_iam_credentials(
self,
access_key,
secret_key,
region: Incomplete | None = None,
iam_endpoint: Incomplete | None = None,
sts_endpoint: Incomplete | None = None,
max_retries: Incomplete | None = None,
mount_point="aws",
self, access_key, secret_key, region=None, iam_endpoint=None, sts_endpoint=None, max_retries=None, mount_point="aws"
): ...
def rotate_root_iam_credentials(self, mount_point="aws"): ...
def configure_lease(self, lease, lease_max, mount_point="aws"): ...
@@ -20,24 +11,18 @@ class Aws(VaultApiBase):
self,
name,
credential_type,
policy_document: Incomplete | None = None,
default_sts_ttl: Incomplete | None = None,
max_sts_ttl: Incomplete | None = None,
role_arns: Incomplete | None = None,
policy_arns: Incomplete | None = None,
policy_document=None,
default_sts_ttl=None,
max_sts_ttl=None,
role_arns=None,
policy_arns=None,
legacy_params: bool = False,
iam_tags: Incomplete | None = None,
iam_tags=None,
mount_point="aws",
): ...
def read_role(self, name, mount_point="aws"): ...
def list_roles(self, mount_point="aws"): ...
def delete_role(self, name, mount_point="aws"): ...
def generate_credentials(
self,
name,
role_arn: Incomplete | None = None,
ttl: Incomplete | None = None,
endpoint: str = "creds",
mount_point="aws",
role_session_name: Incomplete | None = None,
self, name, role_arn=None, ttl=None, endpoint: str = "creds", mount_point="aws", role_session_name=None
): ...
stubs/hvac/hvac/api/secrets_engines/azure.pyi
+2 -12
View File
@@ -1,23 +1,13 @@
from _typeshed import Incomplete
from hvac.api.vault_api_base import VaultApiBase
DEFAULT_MOUNT_POINT: str
class Azure(VaultApiBase):
def configure(
self,
subscription_id,
tenant_id,
client_id: Incomplete | None = None,
client_secret: Incomplete | None = None,
environment: Incomplete | None = None,
mount_point="azure",
self, subscription_id, tenant_id, client_id=None, client_secret=None, environment=None, mount_point="azure"
): ...
def read_config(self, mount_point="azure"): ...
def delete_config(self, mount_point="azure"): ...
def create_or_update_role(
self, name, azure_roles, ttl: Incomplete | None = None, max_ttl: Incomplete | None = None, mount_point="azure"
): ...
def create_or_update_role(self, name, azure_roles, ttl=None, max_ttl=None, mount_point="azure"): ...
def list_roles(self, mount_point="azure"): ...
def generate_credentials(self, name, mount_point="azure"): ...
stubs/hvac/hvac/api/secrets_engines/consul.pyi
+2 -12
View File
@@ -1,21 +1,11 @@
from _typeshed import Incomplete
from hvac.api.vault_api_base import VaultApiBase
DEFAULT_MOUNT_POINT: str
class Consul(VaultApiBase):
def configure_access(self, address, token, scheme: Incomplete | None = None, mount_point="consul"): ...
def configure_access(self, address, token, scheme=None, mount_point="consul"): ...
def create_or_update_role(
self,
name,
policy: Incomplete | None = None,
policies: Incomplete | None = None,
token_type: Incomplete | None = None,
local: Incomplete | None = None,
ttl: Incomplete | None = None,
max_ttl: Incomplete | None = None,
mount_point="consul",
self, name, policy=None, policies=None, token_type=None, local=None, ttl=None, max_ttl=None, mount_point="consul"
): ...
def read_role(self, name, mount_point="consul"): ...
def list_roles(self, mount_point="consul"): ...
stubs/hvac/hvac/api/secrets_engines/database.pyi
+8 -10
View File
@@ -1,5 +1,3 @@
from _typeshed import Incomplete
from hvac.api.vault_api_base import VaultApiBase
DEFAULT_MOUNT_POINT: str
@@ -9,9 +7,9 @@ class Database(VaultApiBase):
self,
name,
plugin_name,
verify_connection: Incomplete | None = None,
allowed_roles: Incomplete | None = None,
root_rotation_statements: Incomplete | None = None,
verify_connection=None,
allowed_roles=None,
root_rotation_statements=None,
mount_point="database",
*args,
**kwargs,
@@ -26,11 +24,11 @@ class Database(VaultApiBase):
name,
db_name,
creation_statements,
default_ttl: Incomplete | None = None,
max_ttl: Incomplete | None = None,
revocation_statements: Incomplete | None = None,
rollback_statements: Incomplete | None = None,
renew_statements: Incomplete | None = None,
default_ttl=None,
max_ttl=None,
revocation_statements=None,
rollback_statements=None,
renew_statements=None,
mount_point="database",
): ...
def create_static_role(
stubs/hvac/hvac/api/secrets_engines/gcp.pyi
+4 -31
View File
@@ -1,28 +1,12 @@
from _typeshed import Incomplete
from hvac.api.vault_api_base import VaultApiBase
DEFAULT_MOUNT_POINT: str
class Gcp(VaultApiBase):
def configure(
self,
credentials: Incomplete | None = None,
ttl: Incomplete | None = None,
max_ttl: Incomplete | None = None,
mount_point="gcp",
): ...
def configure(self, credentials=None, ttl=None, max_ttl=None, mount_point="gcp"): ...
def rotate_root_credentials(self, mount_point="gcp"): ...
def read_config(self, mount_point="gcp"): ...
def create_or_update_roleset(
self,
name,
project,
bindings,
secret_type: Incomplete | None = None,
token_scopes: Incomplete | None = None,
mount_point="gcp",
): ...
def create_or_update_roleset(self, name, project, bindings, secret_type=None, token_scopes=None, mount_point="gcp"): ...
def rotate_roleset_account(self, name, mount_point="gcp"): ...
def rotate_roleset_account_key(self, name, mount_point="gcp"): ...
def read_roleset(self, name, mount_point="gcp"): ...
@@ -38,13 +22,7 @@ class Gcp(VaultApiBase):
mount_point="gcp",
): ...
def create_or_update_static_account(
self,
name,
service_account_email,
bindings: Incomplete | None = None,
secret_type: Incomplete | None = None,
token_scopes: Incomplete | None = None,
mount_point="gcp",
self, name, service_account_email, bindings=None, secret_type=None, token_scopes=None, mount_point="gcp"
): ...
def rotate_static_account_key(self, name, mount_point="gcp"): ...
def read_static_account(self, name, mount_point="gcp"): ...
@@ -60,12 +38,7 @@ class Gcp(VaultApiBase):
mount_point="gcp",
): ...
def create_or_update_impersonated_account(
self,
name,
service_account_email,
token_scopes: Incomplete | None = None,
ttl: Incomplete | None = None,
mount_point="gcp",
self, name, service_account_email, token_scopes=None, ttl=None, mount_point="gcp"
): ...
def read_impersonated_account(self, name, mount_point="gcp"): ...
def list_impersonated_accounts(self, mount_point="gcp"): ...
stubs/hvac/hvac/api/secrets_engines/identity.pyi
+26 -82
View File
@@ -6,48 +6,22 @@ logger: Incomplete
class Identity(VaultApiBase):
def create_or_update_entity(
self,
name,
entity_id: Incomplete | None = None,
metadata: Incomplete | None = None,
policies: Incomplete | None = None,
disabled: Incomplete | None = None,
mount_point: str = "identity",
self, name, entity_id=None, metadata=None, policies=None, disabled=None, mount_point: str = "identity"
): ...
def create_or_update_entity_by_name(
self,
name,
metadata: Incomplete | None = None,
policies: Incomplete | None = None,
disabled: Incomplete | None = None,
mount_point: str = "identity",
self, name, metadata=None, policies=None, disabled=None, mount_point: str = "identity"
): ...
def read_entity(self, entity_id, mount_point: str = "identity"): ...
def read_entity_by_name(self, name, mount_point: str = "identity"): ...
def update_entity(
self,
entity_id,
name: Incomplete | None = None,
metadata: Incomplete | None = None,
policies: Incomplete | None = None,
disabled: Incomplete | None = None,
mount_point: str = "identity",
): ...
def update_entity(self, entity_id, name=None, metadata=None, policies=None, disabled=None, mount_point: str = "identity"): ...
def delete_entity(self, entity_id, mount_point: str = "identity"): ...
def delete_entity_by_name(self, name, mount_point: str = "identity"): ...
def list_entities(self, method: str = "LIST", mount_point: str = "identity"): ...
def list_entities_by_name(self, method: str = "LIST", mount_point: str = "identity"): ...
def merge_entities(
self,
from_entity_ids,
to_entity_id,
force: Incomplete | None = None,
mount_point: str = "identity",
conflicting_alias_ids_to_keep: Incomplete | None = None,
): ...
def create_or_update_entity_alias(
self, name, canonical_id, mount_accessor, alias_id: Incomplete | None = None, mount_point: str = "identity"
self, from_entity_ids, to_entity_id, force=None, mount_point: str = "identity", conflicting_alias_ids_to_keep=None
): ...
def create_or_update_entity_alias(self, name, canonical_id, mount_accessor, alias_id=None, mount_point: str = "identity"): ...
def read_entity_alias(self, alias_id, mount_point: str = "identity"): ...
def update_entity_alias(self, alias_id, name, canonical_id, mount_accessor, mount_point: str = "identity"): ...
def list_entity_aliases(self, method: str = "LIST", mount_point: str = "identity"): ...
@@ -57,12 +31,12 @@ class Identity(VaultApiBase):
def create_or_update_group(
self,
name,
group_id: Incomplete | None = None,
group_id=None,
group_type: str = "internal",
metadata: Incomplete | None = None,
policies: Incomplete | None = None,
member_group_ids: Incomplete | None = None,
member_entity_ids: Incomplete | None = None,
metadata=None,
policies=None,
member_group_ids=None,
member_entity_ids=None,
mount_point: str = "identity",
): ...
def read_group(self, group_id, mount_point: str = "identity"): ...
@@ -71,10 +45,10 @@ class Identity(VaultApiBase):
group_id,
name,
group_type: str = "internal",
metadata: Incomplete | None = None,
policies: Incomplete | None = None,
member_group_ids: Incomplete | None = None,
member_entity_ids: Incomplete | None = None,
metadata=None,
policies=None,
member_group_ids=None,
member_entity_ids=None,
mount_point: str = "identity",
): ...
def delete_group(self, group_id, mount_point: str = "identity"): ...
@@ -84,59 +58,35 @@ class Identity(VaultApiBase):
self,
name,
group_type: str = "internal",
metadata: Incomplete | None = None,
policies: Incomplete | None = None,
member_group_ids: Incomplete | None = None,
member_entity_ids: Incomplete | None = None,
metadata=None,
policies=None,
member_group_ids=None,
member_entity_ids=None,
mount_point: str = "identity",
): ...
def read_group_by_name(self, name, mount_point: str = "identity"): ...
def delete_group_by_name(self, name, mount_point: str = "identity"): ...
def create_or_update_group_alias(
self,
name,
alias_id: Incomplete | None = None,
mount_accessor: Incomplete | None = None,
canonical_id: Incomplete | None = None,
mount_point: str = "identity",
): ...
def update_group_alias(
self,
entity_id,
name,
mount_accessor: Incomplete | None = None,
canonical_id: Incomplete | None = None,
mount_point="identity",
self, name, alias_id=None, mount_accessor=None, canonical_id=None, mount_point: str = "identity"
): ...
def update_group_alias(self, entity_id, name, mount_accessor=None, canonical_id=None, mount_point="identity"): ...
def read_group_alias(self, alias_id, mount_point: str = "identity"): ...
def delete_group_alias(self, entity_id, mount_point: str = "identity"): ...
def list_group_aliases(self, method: str = "LIST", mount_point: str = "identity"): ...
def lookup_entity(
self,
name: Incomplete | None = None,
entity_id: Incomplete | None = None,
alias_id: Incomplete | None = None,
alias_name: Incomplete | None = None,
alias_mount_accessor: Incomplete | None = None,
mount_point: str = "identity",
self, name=None, entity_id=None, alias_id=None, alias_name=None, alias_mount_accessor=None, mount_point: str = "identity"
): ...
def lookup_group(
self,
name: Incomplete | None = None,
group_id: Incomplete | None = None,
alias_id: Incomplete | None = None,
alias_name: Incomplete | None = None,
alias_mount_accessor: Incomplete | None = None,
mount_point: str = "identity",
self, name=None, group_id=None, alias_id=None, alias_name=None, alias_mount_accessor=None, mount_point: str = "identity"
): ...
def configure_tokens_backend(self, issuer: Incomplete | None = None, mount_point: str = "identity"): ...
def configure_tokens_backend(self, issuer=None, mount_point: str = "identity"): ...
def read_tokens_backend_configuration(self, mount_point: str = "identity"): ...
def create_named_key(
self,
name,
rotation_period: str = "24h",
verification_ttl: str = "24h",
allowed_client_ids: Incomplete | None = None,
allowed_client_ids=None,
algorithm: str = "RS256",
mount_point: str = "identity",
): ...
@@ -145,18 +95,12 @@ class Identity(VaultApiBase):
def list_named_keys(self, mount_point: str = "identity"): ...
def rotate_named_key(self, name, verification_ttl, mount_point: str = "identity"): ...
def create_or_update_role(
self,
name,
key,
template: Incomplete | None = None,
client_id: Incomplete | None = None,
ttl: str = "24h",
mount_point: str = "identity",
self, name, key, template=None, client_id=None, ttl: str = "24h", mount_point: str = "identity"
): ...
def read_role(self, name, mount_point: str = "identity"): ...
def delete_role(self, name, mount_point: str = "identity"): ...
def list_roles(self, mount_point: str = "identity"): ...
def generate_signed_id_token(self, name, mount_point: str = "identity"): ...
def introspect_signed_id_token(self, token, client_id: Incomplete | None = None, mount_point: str = "identity"): ...
def introspect_signed_id_token(self, token, client_id=None, mount_point: str = "identity"): ...
def read_well_known_configurations(self, mount_point: str = "identity"): ...
def read_active_public_keys(self, mount_point: str = "identity"): ...
stubs/hvac/hvac/api/secrets_engines/kv_v1.pyi
+1 -3
View File
@@ -1,5 +1,3 @@
from _typeshed import Incomplete
from hvac.api.vault_api_base import VaultApiBase
DEFAULT_MOUNT_POINT: str
@@ -7,5 +5,5 @@ DEFAULT_MOUNT_POINT: str
class KvV1(VaultApiBase):
def read_secret(self, path, mount_point="secret"): ...
def list_secrets(self, path, mount_point="secret"): ...
def create_or_update_secret(self, path, secret, method: Incomplete | None = None, mount_point="secret"): ...
def create_or_update_secret(self, path, secret, method=None, mount_point="secret"): ...
def delete_secret(self, path, mount_point="secret"): ...
stubs/hvac/hvac/api/secrets_engines/kv_v2.pyi
+7 -17
View File
@@ -1,23 +1,13 @@
from _typeshed import Incomplete
from hvac.api.vault_api_base import VaultApiBase
DEFAULT_MOUNT_POINT: str
class KvV2(VaultApiBase):
def configure(
self,
max_versions: int = 10,
cas_required: Incomplete | None = None,
delete_version_after: str = "0s",
mount_point="secret",
): ...
def configure(self, max_versions: int = 10, cas_required=None, delete_version_after: str = "0s", mount_point="secret"): ...
def read_configuration(self, mount_point="secret"): ...
def read_secret(self, path, mount_point="secret", raise_on_deleted_version: Incomplete | None = None): ...
def read_secret_version(
self, path, version: Incomplete | None = None, mount_point="secret", raise_on_deleted_version: Incomplete | None = None
): ...
def create_or_update_secret(self, path, secret, cas: Incomplete | None = None, mount_point="secret"): ...
def read_secret(self, path, mount_point="secret", raise_on_deleted_version=None): ...
def read_secret_version(self, path, version=None, mount_point="secret", raise_on_deleted_version=None): ...
def create_or_update_secret(self, path, secret, cas=None, mount_point="secret"): ...
def patch(self, path, secret, mount_point="secret"): ...
def delete_latest_version_of_secret(self, path, mount_point="secret"): ...
def delete_secret_versions(self, path, versions, mount_point="secret"): ...
@@ -28,10 +18,10 @@ class KvV2(VaultApiBase):
def update_metadata(
self,
path,
max_versions: Incomplete | None = None,
cas_required: Incomplete | None = None,
max_versions=None,
cas_required=None,
delete_version_after: str = "0s",
mount_point="secret",
custom_metadata: Incomplete | None = None,
custom_metadata=None,
): ...
def delete_metadata_and_all_versions(self, path, mount_point="secret"): ...
stubs/hvac/hvac/api/secrets_engines/pki.pyi
+10 -24
View File
@@ -1,5 +1,3 @@
from _typeshed import Incomplete
from hvac.api.vault_api_base import VaultApiBase
DEFAULT_MOUNT_POINT: str
@@ -11,40 +9,28 @@ class Pki(VaultApiBase):
def list_certificates(self, mount_point="pki"): ...
def submit_ca_information(self, pem_bundle, mount_point="pki"): ...
def read_crl_configuration(self, mount_point="pki"): ...
def set_crl_configuration(
self,
expiry: Incomplete | None = None,
disable: Incomplete | None = None,
extra_params: Incomplete | None = None,
mount_point="pki",
): ...
def set_crl_configuration(self, expiry=None, disable=None, extra_params=None, mount_point="pki"): ...
def read_urls(self, mount_point="pki"): ...
def set_urls(self, params, mount_point="pki"): ...
def read_crl(self, mount_point="pki"): ...
def rotate_crl(self, mount_point="pki"): ...
def generate_intermediate(
self, type, common_name, extra_params: Incomplete | None = None, mount_point="pki", wrap_ttl: Incomplete | None = None
): ...
def generate_intermediate(self, type, common_name, extra_params=None, mount_point="pki", wrap_ttl=None): ...
def set_signed_intermediate(self, certificate, mount_point="pki"): ...
def generate_certificate(
self, name, common_name, extra_params: Incomplete | None = None, mount_point="pki", wrap_ttl: Incomplete | None = None
): ...
def generate_certificate(self, name, common_name, extra_params=None, mount_point="pki", wrap_ttl=None): ...
def revoke_certificate(self, serial_number, mount_point="pki"): ...
def create_or_update_role(self, name, extra_params: Incomplete | None = None, mount_point="pki"): ...
def create_or_update_role(self, name, extra_params=None, mount_point="pki"): ...
def read_role(self, name, mount_point="pki"): ...
def list_roles(self, mount_point="pki"): ...
def delete_role(self, name, mount_point="pki"): ...
def generate_root(
self, type, common_name, extra_params: Incomplete | None = None, mount_point="pki", wrap_ttl: Incomplete | None = None
): ...
def generate_root(self, type, common_name, extra_params=None, mount_point="pki", wrap_ttl=None): ...
def delete_root(self, mount_point="pki"): ...
def sign_intermediate(self, csr, common_name, extra_params: Incomplete | None = None, mount_point="pki"): ...
def sign_intermediate(self, csr, common_name, extra_params=None, mount_point="pki"): ...
def sign_self_issued(self, certificate, mount_point="pki"): ...
def sign_certificate(self, name, csr, common_name, extra_params: Incomplete | None = None, mount_point="pki"): ...
def sign_verbatim(self, csr, name: bool = False, extra_params: Incomplete | None = None, mount_point="pki"): ...
def tidy(self, extra_params: Incomplete | None = None, mount_point="pki"): ...
def sign_certificate(self, name, csr, common_name, extra_params=None, mount_point="pki"): ...
def sign_verbatim(self, csr, name: bool = False, extra_params=None, mount_point="pki"): ...
def tidy(self, extra_params=None, mount_point="pki"): ...
def read_issuer(self, issuer_ref, mount_point="pki"): ...
def list_issuers(self, mount_point="pki"): ...
def update_issuer(self, issuer_ref, extra_params: Incomplete | None = None, mount_point="pki"): ...
def update_issuer(self, issuer_ref, extra_params=None, mount_point="pki"): ...
def revoke_issuer(self, issuer_ref, mount_point="pki"): ...
def delete_issuer(self, issuer_ref, mount_point="pki"): ...
stubs/hvac/hvac/api/secrets_engines/ssh.pyi
+5 -7
View File
@@ -1,5 +1,3 @@
from _typeshed import Incomplete
from hvac.api.vault_api_base import VaultApiBase
DEFAULT_MOUNT_POINT: str
@@ -27,15 +25,15 @@ class Ssh(VaultApiBase):
max_ttl: str = "",
allowed_critical_options: str = "",
allowed_extensions: str = "",
default_critical_options: Incomplete | None = None,
default_extensions: Incomplete | None = None,
default_critical_options=None,
default_extensions=None,
allow_user_certificates: str = "",
allow_host_certificates: bool = False,
allow_bare_domains: bool = False,
allow_subdomains: bool = False,
allow_user_key_ids: bool = False,
key_id_format: str = "",
allowed_user_key_lengths: Incomplete | None = None,
allowed_user_key_lengths=None,
algorithm_signer: str = "",
mount_point="ssh",
): ...
@@ -67,7 +65,7 @@ class Ssh(VaultApiBase):
valid_principals: str = "",
cert_type: str = "user",
key_id: str = "",
critical_options: Incomplete | None = None,
extensions: Incomplete | None = None,
critical_options=None,
extensions=None,
mount_point: str = "ssh",
): ...
stubs/hvac/hvac/api/secrets_engines/transform.pyi
+13 -43
View File
@@ -1,5 +1,3 @@
from _typeshed import Incomplete
from hvac.api.vault_api_base import VaultApiBase
DEFAULT_MOUNT_POINT: str
@@ -16,32 +14,22 @@ class Transform(VaultApiBase):
template,
tweak_source: str = "supplied",
masking_character: str = "*",
allowed_roles: Incomplete | None = None,
allowed_roles=None,
mount_point: str = "transform",
): ...
def create_or_update_fpe_transformation(
self,
name,
template,
tweak_source: str = "supplied",
allowed_roles: Incomplete | None = None,
mount_point: str = "transform",
self, name, template, tweak_source: str = "supplied", allowed_roles=None, mount_point: str = "transform"
): ...
def create_or_update_masking_transformation(
self,
name,
template,
masking_character: str = "*",
allowed_roles: Incomplete | None = None,
mount_point: str = "transform",
self, name, template, masking_character: str = "*", allowed_roles=None, mount_point: str = "transform"
): ...
def create_or_update_tokenization_transformation(
self,
name,
max_ttl: int = 0,
mapping_mode: str = "default",
allowed_roles: Incomplete | None = None,
stores: Incomplete | None = None,
allowed_roles=None,
stores=None,
mount_point: str = "transform",
): ...
def read_transformation(self, name, mount_point: str = "transform"): ...
@@ -60,10 +48,10 @@ class Transform(VaultApiBase):
name,
driver,
connection_string,
username: Incomplete | None = None,
password: Incomplete | None = None,
username=None,
password=None,
type: str = "sql",
supported_transformations: Incomplete | None = None,
supported_transformations=None,
schema: str = "public",
max_open_connections: int = 4,
max_idle_connections: int = 4,
@@ -71,32 +59,14 @@ class Transform(VaultApiBase):
mount_point: str = "transform",
): ...
def encode(
self,
role_name,
value: Incomplete | None = None,
transformation: Incomplete | None = None,
tweak: Incomplete | None = None,
batch_input: Incomplete | None = None,
mount_point: str = "transform",
self, role_name, value=None, transformation=None, tweak=None, batch_input=None, mount_point: str = "transform"
): ...
def decode(
self,
role_name,
value: Incomplete | None = None,
transformation: Incomplete | None = None,
tweak: Incomplete | None = None,
batch_input: Incomplete | None = None,
mount_point: str = "transform",
): ...
def validate_token(
self, role_name, value, transformation, batch_input: Incomplete | None = None, mount_point: str = "transform"
): ...
def check_tokenization(
self, role_name, value, transformation, batch_input: Incomplete | None = None, mount_point: str = "transform"
): ...
def retrieve_token_metadata(
self, role_name, value, transformation, batch_input: Incomplete | None = None, mount_point: str = "transform"
self, role_name, value=None, transformation=None, tweak=None, batch_input=None, mount_point: str = "transform"
): ...
def validate_token(self, role_name, value, transformation, batch_input=None, mount_point: str = "transform"): ...
def check_tokenization(self, role_name, value, transformation, batch_input=None, mount_point: str = "transform"): ...
def retrieve_token_metadata(self, role_name, value, transformation, batch_input=None, mount_point: str = "transform"): ...
def snapshot_tokenization_state(self, name, limit: int = 1000, continuation: str = "", mount_point: str = "transform"): ...
def restore_tokenization_state(self, name, values, mount_point: str = "transform"): ...
def export_decoded_tokenization_state(
stubs/hvac/hvac/api/secrets_engines/transit.pyi
+47 -70
View File
@@ -1,5 +1,3 @@
from _typeshed import Incomplete
from hvac.api.vault_api_base import VaultApiBase
DEFAULT_MOUNT_POINT: str
@@ -8,13 +6,13 @@ class Transit(VaultApiBase):
def create_key(
self,
name,
convergent_encryption: Incomplete | None = None,
derived: Incomplete | None = None,
exportable: Incomplete | None = None,
allow_plaintext_backup: Incomplete | None = None,
key_type: Incomplete | None = None,
convergent_encryption=None,
derived=None,
exportable=None,
allow_plaintext_backup=None,
key_type=None,
mount_point="transit",
auto_rotate_period: Incomplete | None = None,
auto_rotate_period=None,
): ...
def read_key(self, name, mount_point="transit"): ...
def list_keys(self, mount_point="transit"): ...
@@ -22,95 +20,74 @@ class Transit(VaultApiBase):
def update_key_configuration(
self,
name,
min_decryption_version: Incomplete | None = None,
min_encryption_version: Incomplete | None = None,
deletion_allowed: Incomplete | None = None,
exportable: Incomplete | None = None,
allow_plaintext_backup: Incomplete | None = None,
min_decryption_version=None,
min_encryption_version=None,
deletion_allowed=None,
exportable=None,
allow_plaintext_backup=None,
mount_point="transit",
auto_rotate_period: Incomplete | None = None,
auto_rotate_period=None,
): ...
def rotate_key(self, name, mount_point="transit"): ...
def export_key(self, name, key_type, version: Incomplete | None = None, mount_point="transit"): ...
def export_key(self, name, key_type, version=None, mount_point="transit"): ...
def encrypt_data(
self,
name,
plaintext: Incomplete | None = None,
context: Incomplete | None = None,
key_version: Incomplete | None = None,
nonce: Incomplete | None = None,
batch_input: Incomplete | None = None,
type: Incomplete | None = None,
convergent_encryption: Incomplete | None = None,
plaintext=None,
context=None,
key_version=None,
nonce=None,
batch_input=None,
type=None,
convergent_encryption=None,
mount_point: str = "transit",
associated_data: str | None = None,
): ...
def decrypt_data(
self,
name,
ciphertext: Incomplete | None = None,
context: Incomplete | None = None,
nonce: Incomplete | None = None,
batch_input: Incomplete | None = None,
ciphertext=None,
context=None,
nonce=None,
batch_input=None,
mount_point: str = "transit",
associated_data: str | None = None,
): ...
def rewrap_data(
self,
name,
ciphertext,
context: Incomplete | None = None,
key_version: Incomplete | None = None,
nonce: Incomplete | None = None,
batch_input: Incomplete | None = None,
mount_point="transit",
): ...
def generate_data_key(
self,
name,
key_type,
context: Incomplete | None = None,
nonce: Incomplete | None = None,
bits: Incomplete | None = None,
mount_point="transit",
): ...
def generate_random_bytes(
self, n_bytes: Incomplete | None = None, output_format: Incomplete | None = None, mount_point="transit"
): ...
def hash_data(
self, hash_input, algorithm: Incomplete | None = None, output_format: Incomplete | None = None, mount_point="transit"
): ...
def generate_hmac(
self, name, hash_input, key_version: Incomplete | None = None, algorithm: Incomplete | None = None, mount_point="transit"
self, name, ciphertext, context=None, key_version=None, nonce=None, batch_input=None, mount_point="transit"
): ...
def generate_data_key(self, name, key_type, context=None, nonce=None, bits=None, mount_point="transit"): ...
def generate_random_bytes(self, n_bytes=None, output_format=None, mount_point="transit"): ...
def hash_data(self, hash_input, algorithm=None, output_format=None, mount_point="transit"): ...
def generate_hmac(self, name, hash_input, key_version=None, algorithm=None, mount_point="transit"): ...
def sign_data(
self,
name,
hash_input: Incomplete | None = None,
key_version: Incomplete | None = None,
hash_algorithm: Incomplete | None = None,
context: Incomplete | None = None,
prehashed: Incomplete | None = None,
signature_algorithm: Incomplete | None = None,
marshaling_algorithm: Incomplete | None = None,
salt_length: Incomplete | None = None,
hash_input=None,
key_version=None,
hash_algorithm=None,
context=None,
prehashed=None,
signature_algorithm=None,
marshaling_algorithm=None,
salt_length=None,
mount_point="transit",
batch_input: Incomplete | None = None,
batch_input=None,
): ...
def verify_signed_data(
self,
name,
hash_input,
signature: Incomplete | None = None,
hmac: Incomplete | None = None,
hash_algorithm: Incomplete | None = None,
context: Incomplete | None = None,
prehashed: Incomplete | None = None,
signature_algorithm: Incomplete | None = None,
salt_length: Incomplete | None = None,
marshaling_algorithm: Incomplete | None = None,
signature=None,
hmac=None,
hash_algorithm=None,
context=None,
prehashed=None,
signature_algorithm=None,
salt_length=None,
marshaling_algorithm=None,
mount_point="transit",
): ...
def backup_key(self, name, mount_point="transit"): ...
def restore_key(self, backup, name: Incomplete | None = None, force: Incomplete | None = None, mount_point="transit"): ...
def restore_key(self, backup, name=None, force=None, mount_point="transit"): ...
def trim_key(self, name, min_version, mount_point="transit"): ...
stubs/hvac/hvac/api/system_backend/audit.pyi
+1 -10
View File
@@ -1,16 +1,7 @@
from _typeshed import Incomplete
from hvac.api.system_backend.system_backend_mixin import SystemBackendMixin
class Audit(SystemBackendMixin):
def list_enabled_audit_devices(self): ...
def enable_audit_device(
self,
device_type,
description: Incomplete | None = None,
options: Incomplete | None = None,
path: Incomplete | None = None,
local: Incomplete | None = None,
): ...
def enable_audit_device(self, device_type, description=None, options=None, path=None, local=None): ...
def disable_audit_device(self, path): ...
def calculate_hash(self, path, input_to_hash): ...
stubs/hvac/hvac/api/system_backend/auth.pyi
+8 -17
View File
@@ -1,30 +1,21 @@
from _typeshed import Incomplete
from hvac.api.system_backend.system_backend_mixin import SystemBackendMixin
class Auth(SystemBackendMixin):
def list_auth_methods(self): ...
def enable_auth_method(
self,
method_type,
description: Incomplete | None = None,
config: Incomplete | None = None,
plugin_name: Incomplete | None = None,
local: bool = False,
path: Incomplete | None = None,
**kwargs,
self, method_type, description=None, config=None, plugin_name=None, local: bool = False, path=None, **kwargs
): ...
def disable_auth_method(self, path): ...
def read_auth_method_tuning(self, path): ...
def tune_auth_method(
self,
path,
default_lease_ttl: Incomplete | None = None,
max_lease_ttl: Incomplete | None = None,
description: Incomplete | None = None,
audit_non_hmac_request_keys: Incomplete | None = None,
audit_non_hmac_response_keys: Incomplete | None = None,
listing_visibility: Incomplete | None = None,
passthrough_request_headers: Incomplete | None = None,
default_lease_ttl=None,
max_lease_ttl=None,
description=None,
audit_non_hmac_request_keys=None,
audit_non_hmac_response_keys=None,
listing_visibility=None,
passthrough_request_headers=None,
**kwargs,
): ...
stubs/hvac/hvac/api/system_backend/capabilities.pyi
+1 -3
View File
@@ -1,6 +1,4 @@
from _typeshed import Incomplete
from hvac.api.system_backend.system_backend_mixin import SystemBackendMixin
class Capabilities(SystemBackendMixin):
def get_capabilities(self, paths, token: Incomplete | None = None, accessor: Incomplete | None = None): ...
def get_capabilities(self, paths, token=None, accessor=None): ...
stubs/hvac/hvac/api/system_backend/health.pyi
+7 -9
View File
@@ -1,16 +1,14 @@
from _typeshed import Incomplete
from hvac.api.system_backend.system_backend_mixin import SystemBackendMixin
class Health(SystemBackendMixin):
def read_health_status(
self,
standby_ok: Incomplete | None = None,
active_code: Incomplete | None = None,
standby_code: Incomplete | None = None,
dr_secondary_code: Incomplete | None = None,
performance_standby_code: Incomplete | None = None,
sealed_code: Incomplete | None = None,
uninit_code: Incomplete | None = None,
standby_ok=None,
active_code=None,
standby_code=None,
dr_secondary_code=None,
performance_standby_code=None,
sealed_code=None,
uninit_code=None,
method: str = "HEAD",
): ...
stubs/hvac/hvac/api/system_backend/init.pyi
+8 -10
View File
@@ -1,5 +1,3 @@
from _typeshed import Incomplete
from hvac.api.system_backend.system_backend_mixin import SystemBackendMixin
class Init(SystemBackendMixin):
@@ -7,12 +5,12 @@ class Init(SystemBackendMixin):
def is_initialized(self): ...
def initialize(
self,
secret_shares: Incomplete | None = None,
secret_threshold: Incomplete | None = None,
pgp_keys: Incomplete | None = None,
root_token_pgp_key: Incomplete | None = None,
stored_shares: Incomplete | None = None,
recovery_shares: Incomplete | None = None,
recovery_threshold: Incomplete | None = None,
recovery_pgp_keys: Incomplete | None = None,
secret_shares=None,
secret_threshold=None,
pgp_keys=None,
root_token_pgp_key=None,
stored_shares=None,
recovery_shares=None,
recovery_threshold=None,
recovery_pgp_keys=None,
): ...
stubs/hvac/hvac/api/system_backend/key.pyi
+4 -6
View File
@@ -1,10 +1,8 @@
from _typeshed import Incomplete
from hvac.api.system_backend.system_backend_mixin import SystemBackendMixin
class Key(SystemBackendMixin):
def read_root_generation_progress(self): ...
def start_root_token_generation(self, otp: Incomplete | None = None, pgp_key: Incomplete | None = None): ...
def start_root_token_generation(self, otp=None, pgp_key=None): ...
def generate_root(self, key, nonce): ...
def cancel_root_generation(self): ...
def get_encryption_key_status(self): ...
@@ -14,14 +12,14 @@ class Key(SystemBackendMixin):
self,
secret_shares: int = 5,
secret_threshold: int = 3,
pgp_keys: Incomplete | None = None,
pgp_keys=None,
backup: bool = False,
require_verification: bool = False,
recovery_key: bool = False,
): ...
def cancel_rekey(self, recovery_key: bool = False): ...
def rekey(self, key, nonce: Incomplete | None = None, recovery_key: bool = False): ...
def rekey_multi(self, keys, nonce: Incomplete | None = None, recovery_key: bool = False): ...
def rekey(self, key, nonce=None, recovery_key: bool = False): ...
def rekey_multi(self, keys, nonce=None, recovery_key: bool = False): ...
def read_backup_keys(self, recovery_key: bool = False): ...
def cancel_rekey_verify(self): ...
def rekey_verify(self, key, nonce): ...
stubs/hvac/hvac/api/system_backend/lease.pyi
+1 -3
View File
@@ -1,11 +1,9 @@
from _typeshed import Incomplete
from hvac.api.system_backend.system_backend_mixin import SystemBackendMixin
class Lease(SystemBackendMixin):
def read_lease(self, lease_id): ...
def list_leases(self, prefix): ...
def renew_lease(self, lease_id, increment: Incomplete | None = None): ...
def renew_lease(self, lease_id, increment=None): ...
def revoke_lease(self, lease_id): ...
def revoke_prefix(self, prefix): ...
def revoke_force(self, prefix): ...
stubs/hvac/hvac/api/system_backend/mount.pyi
+15 -17
View File
@@ -1,18 +1,16 @@
from _typeshed import Incomplete
from hvac.api.system_backend.system_backend_mixin import SystemBackendMixin
class Mount(SystemBackendMixin):
def list_mounted_secrets_engines(self): ...
def retrieve_mount_option(self, mount_point, option_name, default_value: Incomplete | None = None): ...
def retrieve_mount_option(self, mount_point, option_name, default_value=None): ...
def enable_secrets_engine(
self,
backend_type,
path: Incomplete | None = None,
description: Incomplete | None = None,
config: Incomplete | None = None,
plugin_name: Incomplete | None = None,
options: Incomplete | None = None,
path=None,
description=None,
config=None,
plugin_name=None,
options=None,
local: bool = False,
seal_wrap: bool = False,
**kwargs,
@@ -22,15 +20,15 @@ class Mount(SystemBackendMixin):
def tune_mount_configuration(
self,
path,
default_lease_ttl: Incomplete | None = None,
max_lease_ttl: Incomplete | None = None,
description: Incomplete | None = None,
audit_non_hmac_request_keys: Incomplete | None = None,
audit_non_hmac_response_keys: Incomplete | None = None,
listing_visibility: Incomplete | None = None,
passthrough_request_headers: Incomplete | None = None,
options: Incomplete | None = None,
force_no_cache: Incomplete | None = None,
default_lease_ttl=None,
max_lease_ttl=None,
description=None,
audit_non_hmac_request_keys=None,
audit_non_hmac_response_keys=None,
listing_visibility=None,
passthrough_request_headers=None,
options=None,
force_no_cache=None,
**kwargs,
): ...
def move_backend(self, from_path, to_path): ...
stubs/hvac/hvac/api/system_backend/quota.pyi
+1 -11
View File
@@ -1,19 +1,9 @@
from _typeshed import Incomplete
from hvac.api.system_backend.system_backend_mixin import SystemBackendMixin
class Quota(SystemBackendMixin):
def read_quota(self, name): ...
def list_quotas(self): ...
def create_or_update_quota(
self,
name,
rate,
path: Incomplete | None = None,
interval: Incomplete | None = None,
block_interval: Incomplete | None = None,
role: Incomplete | None = None,
rate_limit_type: Incomplete | None = None,
inheritable: Incomplete | None = None,
self, name, rate, path=None, interval=None, block_interval=None, role=None, rate_limit_type=None, inheritable=None
): ...
def delete_quota(self, name): ...
stubs/hvac/hvac/api/system_backend/raft.pyi
+1 -7
View File
@@ -1,4 +1,3 @@
from _typeshed import Incomplete
from typing import Any
from hvac.api.system_backend.system_backend_mixin import SystemBackendMixin
@@ -6,12 +5,7 @@ from requests import Response
class Raft(SystemBackendMixin):
def join_raft_cluster(
self,
leader_api_addr,
retry: bool = False,
leader_ca_cert: Incomplete | None = None,
leader_client_cert: Incomplete | None = None,
leader_client_key: Incomplete | None = None,
self, leader_api_addr, retry: bool = False, leader_ca_cert=None, leader_client_cert=None, leader_client_key=None
): ...
def read_raft_config(self): ...
def remove_raft_node(self, server_id): ...
stubs/hvac/hvac/api/system_backend/seal.pyi
+1 -3
View File
@@ -1,10 +1,8 @@
from _typeshed import Incomplete
from hvac.api.system_backend.system_backend_mixin import SystemBackendMixin
class Seal(SystemBackendMixin):
def is_sealed(self): ...
def read_seal_status(self): ...
def seal(self): ...
def submit_unseal_key(self, key: Incomplete | None = None, reset: bool = False, migrate: bool = False): ...
def submit_unseal_key(self, key=None, reset: bool = False, migrate: bool = False): ...
def submit_unseal_keys(self, keys, migrate: bool = False): ...
stubs/hvac/hvac/api/system_backend/wrapping.pyi
+1 -1
View File
@@ -3,5 +3,5 @@ from _typeshed import Incomplete
from hvac.api.system_backend.system_backend_mixin import SystemBackendMixin
class Wrapping(SystemBackendMixin):
def unwrap(self, token: Incomplete | None = None): ...
def unwrap(self, token=None): ...
def wrap(self, payload: dict[Incomplete, Incomplete] | None = None, ttl: int = 60): ...