Policies

class terrasnek.policies.TFCPolicies(instance_url, org_name, headers, well_known_paths, verify, log_level)

Policies API Docs

create(payload)

POST /organizations/:organization_name/policies

Policies Create API Doc Reference

Create Sample Payload

destroy(policy_id)

DELETE /policies/:policy_id

Policies Destroy API Doc Reference

get_policy_text(policy_id, include=None)

GET /policies/:policy_id/download

This endpoint is currently not documented in the offical TFC API docs. You can find a reference to it in the sample response <https://www.terraform.io/docs/cloud/api/policies.html#sample-response-1> for the show function.

list(page=None, page_size=None, search=None, include=None)

GET /organizations/:organization_name/policies

Policies List API Doc Reference

Query Parameter(s) Details

list_all(search=None, include=None)

This function does not correlate to an endpoint in the TFC API Docs specifically, but rather is a helper function to wrap the list endpoint, which enumerates out every page so users do not have to implement the paging logic every time they just want to list every policy for an organization.

Returns an object with two arrays of objects.

required_entitlements()

Terraform Cloud Entitlements required for endpoint to work.

show(policy_id, include=None)

GET /policies/:policy_id

Policies Show API Doc Reference

terraform_cloud_only()

Return True if this endpoint is only for Terraform Cloud, else False.

terraform_enterprise_only()

Return True if this endpoint is only for Terraform Enterprise, else False.

update(policy_id, payload)

PATCH /policies/:policy_id

Policies Update API Doc Reference

Update Sample Payload

upload(policy_id, payload)

PUT /policies/:policy_id/upload

Policies Upload API Doc Reference

Upload Sample Payload