peak-sdk
  • SDK
    • Reference
      • Sessions
        • Session
          • Session.create_download_request()
          • Session.create_generator_request()
          • Session.create_request()
      • Compression
        • compress()
        • get_files_to_include()
        • print_file_tree()
        • print_zip_content()
      • Templating
        • API Reference
          • load_template()
        • CLI Reference
          • check_file_extension()
          • format_logs()
          • get_client()
          • get_updated_artifacts()
          • parse_build_arguments()
          • parse_envs()
          • parse_params()
          • remove_unknown_args()
          • template_handler()
      • Peak Resources
        • Alert
          • get_client()
          • Alert Client
            • Alert
              • Alert.describe_email()
              • Alert.describe_template()
              • Alert.list_emails()
              • Alert.list_templates()
              • Alert.send_email()
        • Artifact
          • get_client()
          • Artifact Client
            • Artifact
              • Artifact.create_artifact()
              • Artifact.create_artifact_version()
              • Artifact.delete_artifact()
              • Artifact.delete_artifact_version()
              • Artifact.describe_artifact()
              • Artifact.download_artifact()
              • Artifact.list_artifacts()
              • Artifact.update_artifact()
        • Image
          • get_client()
          • Image Client
            • Image
              • Image.create_image()
              • Image.create_or_update_image_version()
              • Image.create_version()
              • Image.delete_image()
              • Image.delete_version()
              • Image.delete_versions()
              • Image.describe_image()
              • Image.describe_version()
              • Image.get_build_logs()
              • Image.list_image_builds()
              • Image.list_image_versions()
              • Image.list_images()
              • Image.update_version()
        • Service
          • get_client()
          • Service Client
            • Service
              • Service.create_or_update_service()
              • Service.create_service()
              • Service.delete_service()
              • Service.describe_service()
              • Service.list_services()
              • Service.test_service()
              • Service.update_service()
        • Tenant
          • get_client()
          • Tenant Client
            • Tenant
              • Tenant.get_credentials()
              • Tenant.list_instance_options()
        • User
          • get_client()
          • User Client
            • User
              • User.check_permissions()
        • Webapp
          • get_client()
          • Webapp Client
            • Webapp
              • Webapp.create_or_update_webapp()
              • Webapp.create_webapp()
              • Webapp.delete_webapp()
              • Webapp.describe_webapp()
              • Webapp.list_webapps()
              • Webapp.update_webapp()
        • Workflow
          • get_client()
          • Workflow Client
            • Workflow
              • Workflow.create_or_update_workflow()
              • Workflow.create_workflow()
              • Workflow.delete_workflow()
              • Workflow.describe_workflow()
              • Workflow.execute_workflow()
              • Workflow.get_default_resource()
              • Workflow.get_execution_details()
              • Workflow.get_execution_logs()
              • Workflow.list_executions()
              • Workflow.list_resources()
              • Workflow.list_workflows()
              • Workflow.patch_workflow()
              • Workflow.update_workflow()
      • Press
        • Press-App
          • get_client()
          • Press-App Client
            • App
              • App.create_deployment()
              • App.create_deployment_revision()
              • App.create_spec()
              • App.create_spec_release()
              • App.delete_deployment()
              • App.delete_spec()
              • App.describe_deployment()
              • App.describe_deployment_revision()
              • App.describe_spec()
              • App.describe_spec_release()
              • App.list_deployment_revisions()
              • App.list_deployments()
              • App.list_spec_releases()
              • App.list_specs()
              • App.redeploy()
              • App.update_deployment_metadata()
              • App.update_spec_metadata()
        • Press Blocks
          • get_client()
          • Press Blocks Client
            • Block
              • Block.create_deployment()
              • Block.create_deployment_revision()
              • Block.create_spec()
              • Block.create_spec_release()
              • Block.delete_deployment()
              • Block.delete_spec()
              • Block.describe_deployment()
              • Block.describe_deployment_revision()
              • Block.describe_spec()
              • Block.describe_spec_release()
              • Block.get_parameters()
              • Block.get_related_block_details()
              • Block.list_deployment_revisions()
              • Block.list_deployments()
              • Block.list_spec_releases()
              • Block.list_specs()
              • Block.patch_parameters()
              • Block.redeploy()
              • Block.update_deployment_metadata()
              • Block.update_spec_metadata()
        • Press-Spec
          • get_client()
          • Press-Spec Client
            • Spec
              • Spec.list_spec_release_deployments()
              • Spec.list_specs()
        • Press-Deployment
          • get_client()
          • Press-Deployment Client
            • Deployment
              • Deployment.execute_resources()
              • Deployment.list_deployments()
      • Tools
        • Logging
          • LogHandler
            • LogHandler.CONSOLE
            • LogHandler.FILE
          • LogLevel
            • LogLevel.DEBUG
            • LogLevel.INFO
            • LogLevel.WARN
            • LogLevel.WARNING
            • LogLevel.ERROR
            • LogLevel.EXCEPTION
            • LogLevel.CRITICAL
            • LogLevel.FATAL
          • PeakLogger
            • PeakLogger.bind()
            • PeakLogger.clone_with_context()
            • PeakLogger.set_log_level()
            • PeakLogger.unbind()
          • default_processors_factory()
          • get_logger()
          • peak_contexts_processor()
          • pii_masking_processor()
    • Usage
      • Managing Sessions with Peak-SDK
        • Sessions
          • Importing and defining a custom Session objects for use within clients
            • This custom Session object can be passed when creating new clients of any kind.
            • The main purpose of this is to allow for the use of custom Session objects when working across multiple tenants simultaneously.
            • Multi-Environment usage example with a Workflow client
            • The default behavior is to pick up arguments from the user’s environment.
      • Interacting with Peak resources
        • Alerts
          • Import the alerts resource module and instantiate the client
          • List all existing email(s) and iterate over them
          • Sending a new email
          • Describe an existing email
          • List all existing template(s) and iterate over them
          • Describe an existing template
        • Artifacts
          • Import the artifact resource module and instantiate an artifact-service client
          • Create a new artifact resource by uploading a file
          • List all existing artifact(s) and iterate over them
          • Describe an existing artifact
          • Update an artifact resource with a new version by uploading a new file
          • Update an artifact resource’s existing metadata
          • Download a versioned artifact from an existing artifact resource
          • Delete an artifact version from an existing artifact resource
          • Delete an artifact resource along with all its version(s)
        • Images
          • Import the image resource module and instantiate the client
          • Possible field values
            • Image type
            • Status
            • Build status or Last build status
          • List all existing image(s) and iterate over them
          • List all existing image version(s) and iterate over them
          • Create a new image resource
          • Create a new image version resource
          • Create or update a image version
          • Describe an existing image resource
          • Describe an existing version resource
          • Update an existing image version resource
          • List all builds in an existing image resource and iterate over them
          • Get logs for a specific build in an existing image resource
          • Delete an existing image version resource
          • Delete multiple existing image version resources
          • Delete an existing image resource
        • Services
          • Import the services module and instantiate a service client
          • Possible field values
            • Service type
            • Status
          • List all existing services(s) and iterate over them
          • Prepare the payload and submit a new Service resource for creation
          • Modify the payload and update the existing Service resource
          • Create or update a Service resource
          • Prepare the payload for testing api type Service resource
          • Delete an existing Service resource
          • Describe an existing Service resource
        • Tenants
          • Import the tenant resource module and instantiate the tenant-service client
          • List all available instance-options
            • Possible field values
              • Entity type
          • Get Credentails for a Data Store
            • Possible field values
              • Data Store Type
        • Users
          • Import the users module and instantiate a user client with a custom session
          • Check feature permissions for a user
        • Webapps
          • Import the webapps resource module and instantiate a webapps-service client
          • List all existing webapps(s) and iterate over them
          • Prepare the payload and submit a new Webapp resource for creation
          • Modify the payload and update the existing Webapp resource
          • Create or update a Webapp resource
          • Delete an existing Webapp resource
          • Describe an existing Webapp resource
        • Workflows
          • Import the workflow resource module and instantiate a workflow-service client
          • Possible field values
            • Workflow status
            • Execution status or Last execution status
          • List all existing workflow(s) and iterate over them
          • Prepare the payload and submit a new workflow resource for creation
          • Modify the payload and update the existing workflow resource
          • Modify the payload and update the existing workflow resource via patch-workflow
          • Create or update a workflow resource
          • Describe an existing workflow resource
          • Delete an existing workflow resource
          • List all executions of a workflow resource and iterate over them
          • Get Details about a workflow execution
          • Get logs for a specific execution of a workflow resource
          • Schedule an immediate execution for a workflow
          • Get all available resources for workflow
          • Get default resource values for workflow
      • Interacting with Press framework
        • Press Apps
          • Import the press app module and Instantiate a press-app client
          • Possible field values
            • Scope
            • Spec status
            • Deployment status
          • Prepare an app-spec payload and create an app-spec
          • List created app-spec(s) and iterate over them
          • Describe an already existing app-spec
          • Update an app-spec’s metadata
          • Create a new app-spec release with updated config and release
          • Describe the app-spec release
          • List all app-spec release(s) and iterate over them
          • Create a new deployment from an existing app-spec release
          • List all existing deployment(s) and iterate over them
          • Describe an existing deployment
          • Update an existing deployment’s metadata
        • Redeploy an existing app deployment
          • Create app deployment revision from a specific app-spec’s release
          • Describe an app deployment revision
          • List all revision(s) in an app deployment and iterate over them
          • Delete an existing deployment
          • Delete an existing app-spec with all its release(s)
        • Press Blocks
          • Import the press block module and Instantiate a press-block client
          • Possible field values
            • Block kind
            • Scope
            • Spec status
            • Deployment status
            • Service Type
            • Parameter Type
          • Prepare payload and create a new workflow block-spec
          • Prepare payload and create a new service block-spec
          • List created block-spec(s) and iterate over them
          • Describe an already existing block-spec
          • Update the metadata and discoverability of a block-spec
          • Create a new workflow block-spec release with updated config and release
          • Create a new service block-spec release with updated config and release
          • Describe the block-spec release
          • List all release(s) in a block-spec and iterate over them
          • Create a new deployment from a specific block-spec’s release
          • List all existing deployment(s) and iterate over them
          • Describe a block deployment
          • Update an existing deployment’s metadata
        • Redeploy an existing block deployment
          • Get block deployment parameters
          • Update block deployment parameters
          • Create block deployment revision from a specific block-spec’s release
          • Describe a block deployment revision
          • List all revision(s) in a block deployment and iterate over them
          • Delete a block deployment
          • Delete an existing block-spec with all it’s release(s)
        • Press Deployments
          • Import the press deployment module and Instantiate a press-deployment client
          • Possible field values
            • Deployment status
          • List all app deployment(s) and block deployment(s) and iterate over them
          • Execute resources of an app or block deployment
        • Press Specs
          • Import the press spec module and Instantiate a press-spec client
          • Possible field values
            • Spec kind
            • Scope
            • Spec status
            • Deployment status
          • List all app spec(s) and block spec(s) and iterate over them
          • List all deployment(s) for an existing app-spec release
      • Managing Auto-Pagination
        • Client Side Auto-Pagination
          • Import the press app module and Instantiate a press-app client
          • List created app-spec(s) and iterate over them using auto-pagination with return_iterator=True
          • List created app-spec(s) with auto-pagination disabled
      • Using Templates in Peak-SDK and Peak-CLI
        • Getting familiar with Templates
          • Using template loader along with your own code.
          • Using template loader with CLI commands.
            • Visualizing the template loading logic used within CLI commands
          • Usage Examples
            • Passing parameters in bulk.
            • Passing parameters one by one.
            • The recommended way.
            • A short guide to parameter conventions used within the CLI.
      • Using Compression for Artifacts in Peak-SDK and Peak-CLI
        • Why do we need Artifacts and Compression
          • Usage Examples
            • Basic usage with path and ignore_files
            • Usage without ignore_files
            • Compress without ignore_files and a missing .dockerignore
            • Compress without both ignore_files and .dockerignore
            • Usage with multiple ignore files
            • The recommended way
      • Creating Apps and Blocks via SDK
        • Creating Resource Dependencies with Artifacts
        • Providing Instance Type and Storage in Workflow Block Spec
        • Providing Instance Type in Service Block Spec
        • Session Stickiness in Service Block
        • Providing Build Parameters in Blocks
        • Providing Run Parameters in Blocks
        • Providing Triggers in Workflow Block Spec
        • Providing Watchers in Workflow Block Spec
        • Providing Image Details for Block Specs
        • Usage Examples
          • Block Specs
            • Creating a Block Spec
            • Creating a new Block Spec Release
          • Block Deployments
            • Creating a new Block Deployment
          • Block Deployments Revisions
            • Creating a new Block Deployment Revision
          • App Specs
            • Creating an App Spec
            • Creating a new App Spec Release
          • App Deployments
            • Creating a new App Deployment
          • App Deployments Revision
            • Creating a new App Deployment Revision
          • Fetching related Blocks within an App
          • Executing the resources of an app or block deployment
      • Creating Peak Resources via SDK
        • Creating Resource Dependencies with Artifacts
        • Providing Instance Type and Storage in Workflow
        • Providing Instance Type in Services
        • Session Stickiness in Services (Not required for API type services)
        • Images
          • Creating an image
          • Creating an image version
        • Workflows
          • Creating a workflow
          • Executing a workflow
        • Web Apps
          • Creating a Web App
        • Services
          • Creating a service
          • Launching Web App or Shiny type Service
          • Testing API type Service
      • Using Tools from Peak-SDK
        • Logging 📓
          • Importing and creating a logging instance 🧪
            • Example 1: Get a default logger
            • Example 2: Get a customized logger
          • Masking sensitive data 🧪
            • Example 1: Masking is enabled by default
            • Example 2: Disabling masking
          • Binding and unbinding contexts 🧪
            • Example 1: Bind additional context to logger
            • Example 2: Unbind key(s) from the context
          • Changing log level 🧪
            • Example 1: Change or Set the log level
          • Additional examples 🧪
            • Example 1: Using Formatting Placeholders
            • Example 2: Logging with Structured Data
            • Example 3: Logging Mixed Data Types
            • Example 4: Logging Exceptions
            • Example 5: Logging with custom / user-providable processors
            • Clone an existing logger
  • CLI
    • Getting Started
      • Getting Help
      • Enable Auto-completion
      • Dry Run
      • Paging
      • Output Format
      • Generate YAML Config
    • Reference
      • peak alerts
        • peak alerts emails
          • peak alerts emails describe
          • peak alerts emails describe-template
          • peak alerts emails list
          • peak alerts emails list-templates
          • peak alerts emails send
      • peak apps
        • peak apps deployments
          • peak apps deployments create
          • peak apps deployments create-revision
          • peak apps deployments delete
          • peak apps deployments describe
          • peak apps deployments describe-revision
          • peak apps deployments list
          • peak apps deployments list-revisions
          • peak apps deployments redeploy
          • peak apps deployments update-metadata
        • peak apps specs
          • peak apps specs create
          • peak apps specs create-release
          • peak apps specs delete
          • peak apps specs describe
          • peak apps specs describe-release
          • peak apps specs list
          • peak apps specs list-releases
          • peak apps specs update-metadata
      • peak artifacts
        • peak artifacts create
        • peak artifacts create-version
        • peak artifacts delete
        • peak artifacts delete-version
        • peak artifacts describe
        • peak artifacts download
        • peak artifacts list
        • peak artifacts update-metadata
      • peak blocks
        • peak blocks deployments
          • peak blocks deployments create
          • peak blocks deployments create-revision
          • peak blocks deployments delete
          • peak blocks deployments describe
          • peak blocks deployments describe-revision
          • peak blocks deployments get-parameters
          • peak blocks deployments get-related-block-details
          • peak blocks deployments list
          • peak blocks deployments list-revisions
          • peak blocks deployments patch-parameters
          • peak blocks deployments redeploy
          • peak blocks deployments update-metadata
        • peak blocks specs
          • peak blocks specs create
          • peak blocks specs create-release
          • peak blocks specs delete
          • peak blocks specs describe
          • peak blocks specs describe-release
          • peak blocks specs list
          • peak blocks specs list-releases
          • peak blocks specs update-metadata
      • peak deployments
        • peak deployments execute-resources
        • peak deployments list
      • peak images
        • peak images create
        • peak images create-or-update
        • peak images create-version
        • peak images delete
        • peak images delete-version
        • peak images delete-versions
        • peak images describe
        • peak images describe-version
        • peak images get-build-logs
        • peak images list
        • peak images list-builds
        • peak images list-versions
        • peak images update-version
      • peak services
        • peak services create
        • peak services create-or-update
        • peak services delete
        • peak services describe
        • peak services list
        • peak services test
        • peak services update
      • peak specs
        • peak specs list
        • peak specs list-release-deployments
      • peak tenants
        • peak tenants get-credentials
        • peak tenants list-instance-options
      • peak users
        • peak users check-permission
      • peak webapps
        • peak webapps create
        • peak webapps create-or-update
        • peak webapps delete
        • peak webapps describe
        • peak webapps list
        • peak webapps update
      • peak workflows
        • peak workflows create
        • peak workflows create-or-update
        • peak workflows delete
        • peak workflows describe
        • peak workflows execute
        • peak workflows get-execution-details
        • peak workflows get-execution-logs
        • peak workflows list
        • peak workflows list-default-resources
        • peak workflows list-executions
        • peak workflows list-resources
        • peak workflows patch
        • peak workflows update
    • Usage
      • Using Apps and Blocks
        • Defining CLI Parameters in App and Block Creation
        • Defining Markdown Content in App and Block Creation
        • Creating Resource Dependencies with Artifacts
        • Executing the resources of an app or block deployment
        • Interacting with Apps and Blocks
          • Press Apps
            • Usage Examples
              • App Specs
                • Creating an App Spec
                • Updating App Spec Metadata
                • Creating a new App Spec Release
              • App Deployments
                • Creating a new App Deployment
                • Creating a new App Deployment Revision
                • Updating App Deployment Metadata
                • Redeploying an App Deployment
          • Press Blocks
            • Providing Instance Type and Storage in Workflow Block Spec
            • Providing Instance Type in Service Block Spec
            • Session Stickiness in Service Block
            • Providing Press Parameters in Blocks
            • Providing Triggers in Workflow Block Spec
            • Providing Watchers in Workflow Block Spec
            • Providing Image Details for Block Specs
            • Usage Examples
              • Block Specs
                • Creating a Block Spec
                • Updating Block Spec Metadata
                • Creating a new Block Spec Release
              • Block Deployments
                • Creating a new Block Deployment
                • Creating a new Block Deployment Revision
                • Updating Block Deployment Metadata
                • Redeploying a Block Deployment
                • Getting Block Deployment Parameters
                • Getting Related Blocks for a Block in an App
                • Updating Block Deployment Parameters
      • Using Peak Resources
        • Defining Parameters in Resource Creation
        • Using a combination of command line options and yaml
        • Creating Resource Dependencies with Artifacts
        • Interacting with Peak resources
          • Email Notifications
            • Templates
            • Emails
              • Sending Email Notifications
          • Images
            • Creating an image
            • Creating an image version
            • Updating an image version
            • Using the create-or-update operation
            • Deleting Images and Versions
            • Retrieving Image Build Logs
          • Services
            • Providing Instance Type in Services
            • Session Stickiness in Services (Not required for API type services)
            • Creating a service
            • Updating a service
            • Using the create-or-update operation
            • Launching Web App and Shiny type Services
            • Testing API type Services
          • Tenants
            • Get allowed instance types
            • Get data store credentials
              • Data Warehouse Credentials
          • Users
            • Checking user permissions for an application or its features
          • Web Apps
            • Providing Instance Type in Web App
            • Session Stickiness in Web App
            • Creating a Web App
            • Updating a Web App
            • Using the create-or-update operation
          • Workflows
            • Providing Instance Type and Storage in Workflow
            • Creating a workflow
            • Updating a workflow
            • Using the create-or-update operation
            • Partial Workflow Update using patch workflow
            • Setting up advanced workflow configurations
              • Auto retry configuration
              • Skippable steps configuration
              • Input parameters configuration
              • Output parameters configuration
              • Execution condition configuration
            • Executing a workflow
              • Partial Workflow Execution
            • Retrieving Workflow Execution Details
            • Retrieving Workflow Step Execution Logs
  • Examples
    • Using Press Runtime Parameters
      • Using Parameters in Workflows
      • Deploying the Workflow
        • Creating the Block Spec
        • Deploying the Spec
        • Updating the Parameters
    • Using Press Build parameters
      • Using Build Parameters in Workflows
        • Creating the Block Spec
        • Deploying the Spec
        • The result
    • Checking User Permissions for an Application
      • Initializing and using the User Client
      • Integrating Permissions into your Application
    • Getting Data Warehouse Credentials
      • Getting the Credentials
        • The Response
          • Redshift
          • Snowflake (Basic Auth)
          • Snowflake (OAuth)
      • Connecting to the Warehouse
        • Snowflake OAuth Access Token
  • Migration Guide
    • Migrating from Peak SDK 0.0.6 to 1.0.0
      • Creation of Images and Webapps without YAML File
    • Migrating from Peak SDK 0.0.5 to 0.0.6
      • Changing release key format
    • Migrating to Peak SDK new CLI
      • Template Parameters
      • Changes in Image resource
      • Changes in Workflow resource
      • Changes in Workflow Specs and Deployments
      • Changes in Apps
  • FAQ
    • Getting started
      • What is Python Virtual Environment and how do I set it up for my project?
      • How do I install the Peak SDK and CLI?
      • I am facing issues with Peak SDK installation even though I am within a virtual environment. How can I resolve these installation problems?
      • How do I start using the Peak SDK and CLI?
      • Where can I find sample code and examples to learn how to use the Peak SDK and CLI?
      • Where can I find references for the available functions in the Peak SDK and commands in the CLI?
    • Managing existing resources
      • How can I manage existing resources such as workflows or block-specs?
      • How do I obtain the ID and Configuration of the resource?
  • Changelog
    • [1.9.0]
    • [1.8.0]
    • [1.7.0]
    • [1.6.0]
    • [1.5.0]
    • [1.4.0]
    • [1.3.0]
    • [1.2.1]
    • [1.2.0]
    • [1.1.0]
    • [1.0.0]
    • [0.0.6]
    • [0.0.5]
    • [0.0.4]
    • [0.0.3]
  • License
peak-sdk
  • SDK
  • Reference

Reference

  • Sessions
    • Session
  • Compression
    • compress()
    • get_files_to_include()
    • print_file_tree()
    • print_zip_content()
  • Templating
    • API Reference
    • CLI Reference
  • Peak Resources
    • Alert
    • Artifact
    • Image
    • Service
    • Tenant
    • User
    • Webapp
    • Workflow
  • Press
    • Press-App
    • Press Blocks
    • Press-Spec
    • Press-Deployment
  • Tools
    • Logging
Previous Next

© Copyright 2024, Peak AI.

Built with Sphinx using a theme provided by Read the Docs.
Other Versions v: v1.9.0
Tags
latest
v0.0.5
v0.0.6
v1.0.0
v1.1.0
v1.10.0
v1.11.0
v1.12.0
v1.13.0
v1.14.0
v1.15.0
v1.15.1
v1.16.0
v1.16.1
v1.17.0
v1.2.0
v1.2.1
v1.3.0
v1.4.0
v1.5.0
v1.6.0
v1.7.0
v1.8.0
v1.9.0