client.scripts.patch_custom

A method of the Scripts endpoint.

patch_custom(id: int, *, name: str = None, parent_id: int = None, arguments: dict = None, remote_host_id: int = None, credential_id: int = None, schedule: dict = None, notifications: dict = None, time_zone: str = None, target_project_id: int = None, required_resources: dict = None, partition_label: str = None, running_as_id: int = None) → Response

Update some attributes of this Custom Script

API URL: PATCH /scripts/custom/{id}

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

Parameters:

idint

The ID for the script.

namestr, optional

The name of the script.

parent_idint, optional

The ID of the parent job that will trigger this script

argumentsdict, optional

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

remote_host_idint, optional

The remote host ID that this script will connect to.

credential_idint, optional

The credential that this script will use.

scheduledict, optional

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.

notificationsdict, optional

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.

time_zonestr, optional

The time zone of this script.

target_project_idint, optional

Target project to which script outputs will be added.

required_resourcesdict, optional

cpuint
The number of CPU shares to allocate for the container. Each core has 1000 shares.
memoryint
The amount of RAM to allocate for the container (in 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.

partition_labelstr, optional

The partition label used to run this object. Only applicable for jobs using Docker.

running_as_idint, optional

The ID of the runner of this script.

Returns:

civis.Response

idint
The ID for the script.
from_template_aliasesList[civis.Response]
An array of the aliases of the template script.
- idint
  The id of the Alias object.
- object_idint
  The id of the object
- aliasstr
  The alias of the object
namestr
The name of the script.
typestr
The type of the script (e.g Custom)
backing_script_typestr
The type of the script backing this template (e.g Python)
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.
category : str
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
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 script.
ui_report_urlint
The url of the custom HTML.
ui_report_idint
The id of the report with the custom HTML.
ui_report_provide_api_keybool
Whether the ui report requests an API Key from the report viewer.
template_script_namestr
The name of the template script.
template_notestr
The template’s note.
remote_host_idint
The remote host ID that this script will connect to.
credential_idint
The credential that this script will use.
code_previewstr
The code that this script will run with arguments inserted.
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.
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.
archivedstr
The archival status of the requested item(s).
target_project_idint
Target project to which script outputs will be added.
last_successful_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.
required_resourcescivis.Response
- cpuint
  The number of CPU shares to allocate for the container. Each core has 1000 shares.
- memoryint
  The amount of RAM to allocate for the container (in 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.
partition_labelstr
The partition label used to run this object. Only applicable for jobs using Docker.
running_as_idint
The ID of the runner of this script.