client.scripts.put_python3_archive

A method of the Scripts endpoint.

put_python3_archive(id: int, status: bool) → Response

Update the archive status of this object

API URL: PUT /scripts/python3/{id}/archive

import civis
client = civis.APIClient()
response = client.scripts.put_python3_archive(...)

Parameters:

idint

The ID of the object.

statusbool

The desired archived status of the object.

Returns:

civis.Response

• idint

  The ID for the script.

• namestr

  The name of the script.

• typestr

  The type of the script (e.g SQL, Container, Python, R, JavaScript, dbt)

• created_atstr (time)

  The time this script was created.

• updated_atstr (time)

  The time the script was last updated.

• authorcivis.Response

  • idint

    The ID of this user.

  • namestr

    This user’s name.

  • usernamestr

    This user’s username.

  • initialsstr

    This user’s initials.

  • onlinebool

    Whether this user is online.

• statestr

  The status of the script’s last run.

• finished_atstr (time)

  The time that the script’s last run finished.

• categorystr

  The category of the script.

• projectsList[civis.Response]

  A list of projects containing the script.

  • idint

    The ID for the project.

  • namestr

    The name of the project.

• parent_idint

  The ID of the parent job that will trigger this script

• user_contextstr

  “runner” or “author”, who to execute the script as when run as a template.

• paramsList[civis.Response]

  A definition of the parameters this script accepts in the arguments field.

  • namestr

    The variable’s name as used within your code.

  • labelstr

    The label to present to users when asking them for the value.

  • descriptionstr

    A short sentence or fragment describing this parameter to the end user.

  • typestr

    The type of parameter. Valid options: string, multi_line_string, integer, float, bool, file, table, database, credential_aws, credential_redshift, or credential_custom

  • requiredbool

    Whether this param is required.

  • valueobject

    The value you would like to set this param to. Setting this value makes this parameter a fixed param.

  • defaultstr

    If an argument for this parameter is not defined, it will use this default value. Use true, True, t, y, yes, or 1 for true bool’s or false, False, f, n, no, or 0 for false bool’s. Cannot be used for parameters that are required or a credential type.

  • allowed_valuesList[civis.Response]

    The possible values this parameter can take, effectively making this an enumerable parameter. Allowed values is an array of hashes of the following format: {label: ‘Import’, ‘value’: ‘import’}

• argumentscivis.Response

  Parameter-value pairs to use when running this script. Only settable if this script has defined parameters.

• is_templatebool

  Whether others scripts use this one as a template.

• published_as_template_idint

  The ID of the template that this script is backing.

• from_template_idint

  The ID of the template this script uses, if any.

• template_dependents_countint

  How many other scripts use this one as a template.

• template_script_namestr

  The name of the template script.

• linkscivis.Response

  • detailsstr

    The details link to get more information about the script.

  • runsstr

    The runs link to get the run information list for this script.

• schedulecivis.Response

  • scheduledbool

    If the item is scheduled.

  • scheduled_daysList[int]

    Days of the week, based on numeric value starting at 0 for Sunday. Mutually exclusive with scheduledDaysOfMonth

  • scheduled_hoursList[int]

    Hours of the day it is scheduled on.

  • scheduled_minutesList[int]

    Minutes of the day it is scheduled on.

  • scheduled_runs_per_hourint

    Deprecated in favor of scheduled minutes.

  • scheduled_days_of_monthList[int]

    Days of the month it is scheduled on, mutually exclusive with scheduledDays.

• notificationscivis.Response

  • urlsList[str]

    URLs to receive a POST request at job completion

  • success_email_subjectstr

    Custom subject line for success e-mail.

  • success_email_bodystr

    Custom body text for success e-mail, written in Markdown.

  • success_email_addressesList[str]

    Addresses to notify by e-mail when the job completes successfully.

  • success_email_from_namestr

    Name from which success emails are sent; defaults to “Civis.”

  • success_email_reply_tostr

    Address for replies to success emails; defaults to the author of the job.

  • failure_email_addressesList[str]

    Addresses to notify by e-mail when the job fails.

  • stall_warning_minutesint

    Stall warning emails will be sent after this amount of minutes.

  • success_onbool

    If success email notifications are on. Defaults to user’s preferences.

  • failure_onbool

    If failure email notifications are on. Defaults to user’s preferences.

• running_ascivis.Response

  • idint

    The ID of this user.

  • namestr

    This user’s name.

  • usernamestr

    This user’s username.

  • initialsstr

    This user’s initials.

  • onlinebool

    Whether this user is online.

• next_run_atstr (time)

  The time of the next scheduled run.

• time_zonestr

  The time zone of this script.

• last_runcivis.Response

  • id : int

  • state : str

  • created_atstr (time)

    The time that the run was queued.

  • started_atstr (time)

    The time that the run started.

  • finished_atstr (time)

    The time that the run completed.

  • errorstr

    The error message for this run, if present.

• my_permission_levelstr

  Your permission level on the object. One of “read”, “write”, or “manage”.

• hiddenbool

  The hidden status of the item.

• target_project_idint

  Target project to which script outputs will be added.

• archivedstr

  The archival status of the requested item(s).

• required_resourcescivis.Response

  • cpuint

    The number of CPU shares to allocate for the container. Each core has 1000 shares. Must be at least 2 shares.

  • memoryint

    The amount of RAM to allocate for the container (in MB). Must be at least 4 MB.

  • disk_spacefloat (float)

    The amount of disk space, in GB, to allocate for the container. This space will be used to hold the git repo configured for the container and anything your container writes to /tmp or /data. Fractional values (e.g. 0.25) are supported.

• instance_typestr

  The EC2 instance type to deploy to. Only available for jobs running on kubernetes.

• cancel_timeoutint

  The amount of time (in seconds) to wait before forcibly terminating the script. When the script is cancelled, it is first sent a TERM signal. If the script is still running after the timeout, it is sent a KILL signal. Defaults to 0.

• docker_image_tagstr

  The tag of the docker image to pull from DockerHub.

• partition_labelstr

  The partition label used to run this object.

• running_as_idint

  The ID of the runner of this script.

• sourcestr

  The body/text of the script.